graph

type Builder struct {
	// contains filtered or unexported fields
}

type BuilderConfig struct {
	// Token is the GitHub personal access token.
	Token string

	// MaxRetries is the maximum number of retry attempts for API calls.
	// Default is 3.
	MaxRetries int

	// InitialBackoff is the initial backoff duration for retries.
	// Default is 1 second.
	InitialBackoff time.Duration

	// Cache is an optional cache for API responses.
	Cache *Cache
}

type Cache struct {
	// contains filtered or unexported fields
}

type CacheConfig struct {
	// Dir is the directory for file-based cache. If empty, uses temp dir.
	Dir string

	// TTL is the time-to-live for cached entries. Default is 1 hour.
	TTL time.Duration

	// MemoryOnly disables file-based caching.
	MemoryOnly bool
}

type CacheStats struct {
	MemoryEntries int   `json:"memoryEntries"`
	FileEntries   int   `json:"fileEntries"`
	TotalSizeKB   int64 `json:"totalSizeKB"`
}

type CachedBuilder struct {
	// contains filtered or unexported fields
}

type CallbackProgress struct {
	// contains filtered or unexported fields
}

type Cycle struct {
	Modules []string `json:"modules"`
}

type DOTConfig struct {
	// Title is the graph title.
	Title string

	// RankDir is the direction of graph layout: "TB" (top-bottom), "LR" (left-right).
	RankDir string

	// ShowExternal includes external (non-managed) dependencies.
	ShowExternal bool

	// ShowVersions includes version labels on edges.
	ShowVersions bool

	// ClusterByOrg groups nodes by organization.
	ClusterByOrg bool

	// ColorManaged is the color for managed modules.
	ColorManaged string

	// ColorExternal is the color for external modules.
	ColorExternal string
}

type DependencyGraph struct {
	// contains filtered or unexported fields
}

type GoModCache struct {
	// contains filtered or unexported fields
}

type GoModInfo struct {
	Module  string          `json:"module"`
	Go      string          `json:"go"`
	Require []ModuleVersion `json:"require,omitempty"`
	Replace []ModuleReplace `json:"replace,omitempty"`
	Exclude []ModuleVersion `json:"exclude,omitempty"`
}

type Graph interface {
	// Build constructs the graph from the portfolio configuration.
	Build(ctx context.Context, portfolio Portfolio) error

	// AddModule adds a module to the graph.
	AddModule(module Module)

	// GetModule returns a module by ID.
	GetModule(id string) (*Module, bool)

	// Dependents returns all modules that depend on the given module.
	Dependents(moduleID string) []Module

	// Dependencies returns all modules that the given module depends on.
	Dependencies(moduleID string) []Module

	// UpgradeOrder returns modules in topological order for upgrades.
	// Only includes managed modules.
	UpgradeOrder() (*UpgradeOrder, error)

	// StaleModules finds managed modules using outdated versions of a dependency.
	StaleModules(dependency string, minVersion string) []StaleModule

	// FilterByOrg returns a new graph containing only modules from the specified org.
	FilterByOrg(org string) Graph

	// FilterByLanguage returns a new graph containing only modules of the specified language.
	FilterByLanguage(lang Language) Graph

	// AllModules returns all modules in the graph.
	AllModules() []Module

	// ManagedModules returns only managed modules (those in the portfolio).
	ManagedModules() []Module

	// Snapshot creates a point-in-time snapshot of the graph.
	Snapshot() *GraphSnapshot
}

type GraphSnapshot struct {
	Portfolio Portfolio         `json:"portfolio"`
	Timestamp string            `json:"timestamp"`
	Modules   map[string]Module `json:"modules"` // keyed by module ID
}

type GraphStats struct {
	TotalModules    int              `json:"totalModules"`
	ManagedModules  int              `json:"managedModules"`
	ExternalModules int              `json:"externalModules"`
	TotalEdges      int              `json:"totalEdges"`
	ByLanguage      map[Language]int `json:"byLanguage"`
	ByOrg           map[string]int   `json:"byOrg"`
}

type Language string

type MermaidConfig struct {
	// Direction is "TB", "BT", "LR", or "RL".
	Direction string

	// ShowExternal includes external dependencies.
	ShowExternal bool
}

type Module struct {
	// ID is a universal identifier: "go:github.com/grokify/mogo" or "npm:@agentplexus/core"
	ID string `json:"id"`

	// Language of this module
	Language Language `json:"language"`

	// Name is the module name (e.g., "github.com/grokify/mogo")
	Name string `json:"name"`

	// Org is the GitHub org (e.g., "github.com/grokify")
	Org string `json:"org"`

	// Version is the current version tag
	Version string `json:"version"`

	// Repo is the GitHub repository info (nil for external modules)
	Repo *model.Repo `json:"repo,omitempty"`

	// IsManaged is true if this module is in the portfolio
	IsManaged bool `json:"isManaged"`

	// Dependencies are modules this module depends on
	Dependencies []ModuleRef `json:"dependencies,omitempty"`

	// Dependents are modules that depend on this module
	Dependents []ModuleRef `json:"dependents,omitempty"`
}

type ModuleRef struct {
	ID        string `json:"id"`
	Version   string `json:"version"`
	IsManaged bool   `json:"isManaged"`
}

type ModuleReplace struct {
	Old ModuleVersion `json:"old"`
	New ModuleVersion `json:"new"`
}

type ModuleVersion struct {
	Path     string `json:"path"`
	Version  string `json:"version"`
	Indirect bool   `json:"indirect,omitempty"`
}

type Portfolio struct {
	Name      string   `json:"name" yaml:"name"`
	Orgs      []string `json:"orgs" yaml:"orgs"`            // ["github.com/grokify", "github.com/agentplexus"]
	GraphRepo string   `json:"graphRepo" yaml:"graph_repo"` // Where to persist the graph
	Languages []string `json:"languages" yaml:"languages"`  // ["go", "typescript"]
}

type Progress struct {
	// contains filtered or unexported fields
}

type ProgressCallback func(event ProgressEvent)

type ProgressConfig struct {
	// Writer is where progress is written. Default is os.Stderr.
	Writer io.Writer

	// Enabled controls whether progress is reported.
	Enabled bool

	// MinInterval is the minimum time between progress updates.
	// Default is 100ms.
	MinInterval time.Duration
}

type ProgressEvent struct {
	Type    ProgressEventType `json:"type"`
	Org     string            `json:"org,omitempty"`
	Repo    string            `json:"repo,omitempty"`
	Module  string            `json:"module,omitempty"`
	Current int               `json:"current,omitempty"`
	Total   int               `json:"total,omitempty"`
	Error   error             `json:"error,omitempty"`
}

type ProgressEventType string

type RepoListCache struct {
	// contains filtered or unexported fields
}

type StaleModule struct {
	Module     Module `json:"module"`
	Dependency string `json:"dependency"`
	Current    string `json:"current"`
	Latest     string `json:"latest"`
}

type UpgradeOrder struct {
	Modules []Module `json:"modules"`
	Cycles  []Cycle  `json:"cycles,omitempty"`
}

type ValidationIssue struct {
	Type    string `json:"type"`
	Module  string `json:"module"`
	Message string `json:"message"`
}