From 5f59911e52446e81e43f0980a75508a80980583a Mon Sep 17 00:00:00 2001
From: Virgil <virgil@lethean.io>
Date: Thu, 2 Apr 2026 08:29:59 +0000
Subject: [PATCH] ax(agentic): align provider manager comments with ax

Co-Authored-By: Virgil <virgil@lethean.io>
---
 pkg/agentic/provider_manager.go | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/pkg/agentic/provider_manager.go b/pkg/agentic/provider_manager.go
index d2dfae8..7bb18bc 100644
--- a/pkg/agentic/provider_manager.go
+++ b/pkg/agentic/provider_manager.go
@@ -26,10 +26,8 @@ type ProviderManager struct {
 	providers map[string]AgenticProviderInterface
 }
 
-// providerManager returns the lazily initialised provider registry for content generation.
-//
-//	manager := s.providerManager()
-//	core.Println(manager.Names())
+// manager := s.providerManager()
+// core.Println(manager.Names()) // ["claude", "gemini", "openai"]
 func (s *PrepSubsystem) providerManager() *ProviderManager {
 	if s == nil {
 		return NewProviderManager(nil)
@@ -67,11 +65,11 @@ func (s *PrepSubsystem) providerManager() *ProviderManager {
 	return s.providers
 }
 
-// NewProviderManager registers the built-in content providers.
-//
 //	manager := agentic.NewProviderManager(func(ctx context.Context, prompt string, options map[string]any) (string, error) {
 //	    return "Draft ready", nil
 //	})
+//
+// core.Println(manager.Names()) // ["claude", "gemini", "openai"]
 func NewProviderManager(generate ProviderGenerateFunc) *ProviderManager {
 	manager := &ProviderManager{
 		providers: make(map[string]AgenticProviderInterface),
@@ -84,10 +82,8 @@ func NewProviderManager(generate ProviderGenerateFunc) *ProviderManager {
 	return manager
 }
 
-// Generate returns the generated text from a registered provider.
-//
-//	provider, _ := manager.Provider("claude")
-//	text, _ := provider.Generate(ctx, "Draft a release note", map[string]any{"temperature": 0.2})
+// provider, _ := manager.Provider("claude")
+// text, _ := provider.Generate(ctx, "Draft a release note", map[string]any{"temperature": 0.2})
 type ProviderGenerateFunc func(context.Context, string, map[string]any) (string, error)
 
 // Stream sends provider output to the callback as it arrives.