signal

type CollectorOpts struct {
	// MinConfidence filters signals below this threshold.
	MinConfidence float64

	// IncludePatterns limits collection to files matching these globs.
	IncludePatterns []string

	// ExcludePatterns skips files matching these globs.
	ExcludePatterns []string

	// ErrorMode controls how errors from this collector are handled.
	// Default (zero value or empty string) is treated as ErrorModeWarn.
	ErrorMode ErrorMode

	// LargeFileThreshold overrides the default large-file line count.
	// If zero, the default (1000 lines) is used.
	LargeFileThreshold int

	// GitRoot is the path to the .git directory root, which may differ
	// from RepoPath when scanning a subdirectory.
	GitRoot string

	// GitDepth caps the number of commits walked. 0 uses default (1000).
	GitDepth int

	// GitSince limits commit walking to commits after this duration (e.g., "90d", "6m", "1y").
	GitSince string

	// ProgressFunc is called periodically with status messages during long operations.
	ProgressFunc func(msg string)

	// IncludeClosed includes closed/merged issues and PRs in the GitHub collector.
	IncludeClosed bool

	// HistoryDepth filters out closed items older than this duration (e.g., "6m", "90d").
	HistoryDepth string

	// Anonymize controls author name anonymization: "auto", "always", or "never".
	Anonymize string

	// IncludeDemoPaths disables the default suppression of noise-prone signals
	// (missing-tests, low-test-ratio, low-lottery-risk) in demo/example/tutorial paths.
	IncludeDemoPaths bool

	// MaxIssues caps the number of issues/PRs fetched by the GitHub collector.
	// 0 uses the collector default.
	MaxIssues int

	// Timeout is the per-collector timeout. 0 means no timeout.
	Timeout time.Duration

	// StalenessThreshold overrides the default staleness threshold for
	// dependency health checks (e.g., "2y", "18m"). If empty, the default
	// (2 years) is used.
	StalenessThreshold string

	// MinFunctionLines is the minimum function body lines to analyze for
	// complexity. Functions shorter than this are skipped. 0 uses default (5).
	MinFunctionLines int

	// MinComplexityScore is the minimum composite complexity score to emit a
	// signal. 0 uses default (6.0).
	MinComplexityScore float64

	// DuplicationWindowSize overrides the sliding window size for duplication
	// detection. 0 uses default (6).
	DuplicationWindowSize int

	// DuplicationSignalCap overrides the maximum number of duplication signals
	// emitted. 0 uses default (200).
	DuplicationSignalCap int

	// DuplicationMaxFiles overrides the file cap for the duplication collector.
	// 0 uses default (10000).
	DuplicationMaxFiles int

	// DeadcodeMaxFiles overrides the file cap for the dead code collector.
	// 0 uses default (10000).
	DeadcodeMaxFiles int

	// CouplingFanOutThreshold overrides the fan-out threshold for high-coupling
	// signals. 0 uses default (10).
	CouplingFanOutThreshold int

	// CouplingMaxFiles overrides the file cap for the coupling collector.
	// 0 uses default (10000).
	CouplingMaxFiles int

	// DocStaleDays overrides the minimum age gap in days between source and doc
	// last-commit to flag a stale-doc signal. 0 uses default (180).
	DocStaleDays int

	// DocDriftMinCommits overrides the minimum source commits required before
	// flagging doc-code-drift. 0 uses default (10).
	DocDriftMinCommits int

	// LargeBinaryThreshold overrides the minimum file size in bytes to flag a
	// binary file as large. 0 uses default (1000000).
	LargeBinaryThreshold int

	// SecretPatterns holds user-defined secret patterns to register alongside
	// built-in patterns.
	SecretPatterns []SecretPatternConfig

	// SecretAllowlist holds regex patterns. Lines matching any allowlist
	// pattern have their secret matches suppressed.
	SecretAllowlist []string

	// EntropyDetection enables Shannon entropy-based secret detection.
	// Default false (opt-in).
	EntropyDetection bool

	// TestRatioThreshold overrides the minimum test-to-source file ratio.
	// 0 uses default (0.10).
	TestRatioThreshold float64

	// TestRatioMinFiles overrides the minimum number of source files a directory
	// must contain before reporting a low-test-ratio signal. 0 uses default (3).
	TestRatioMinFiles int
}

type CollectorResult struct {
	// Collector is the name of the collector that produced these signals.
	Collector string

	// Signals are the raw signals extracted.
	Signals []RawSignal

	// Duration is how long the collector took.
	Duration time.Duration

	// Err is any error encountered during collection.
	Err error

	// Metrics holds optional structured data from collectors that implement
	// the MetricsProvider interface. Nil if the collector does not provide metrics.
	Metrics any
}

type ErrorMode string

type RawSignal struct {
	Source      string    // Collector name: "todos", "gitlog", etc.
	Kind        string    // Signal kind: "todo", "fixme", "revert", "churn", etc.
	FilePath    string    // Path within the repo where this was found.
	Line        int       // Line number (0 if not applicable).
	Title       string    // Short description (used as bead title).
	Description string    // Longer context (used as bead description).
	Author      string    // Git blame author or commit author.
	Timestamp   time.Time // When this signal was created.
	Confidence  float64   // 0.0-1.0, how certain we are this is real work.
	Tags        []string  // Free-form tags for clustering hints.
	ClosedAt    time.Time // When this signal was closed/resolved (zero if open).
	Priority    *int      // LLM-inferred priority (1-4). Nil = use confidence mapping.
	Blocks      []string  // Bead IDs this signal blocks (downstream depends on this).
	DependsOn   []string  // Bead IDs this signal depends on (upstream blockers).
	Workspace   string    `json:"workspace,omitempty"` // Monorepo workspace name (empty for non-monorepo).
}

type ScanConfig struct {
	// RepoPath is the path to the repository to scan.
	RepoPath string

	// Collectors lists the collector names to run. Empty means all registered.
	Collectors []string

	// OutputFormat specifies the output format (e.g., "beads", "json", "markdown").
	OutputFormat string

	// NoLLM disables the LLM clustering pass.
	NoLLM bool

	// CollectorOpts provides per-collector options keyed by collector name.
	CollectorOpts map[string]CollectorOpts

	// ExcludePatterns holds global exclude globs applied to all collectors.
	ExcludePatterns []string

	// MaxIssues caps the number of output issues (0 = unlimited).
	MaxIssues int
}

type ScanResult struct {
	// Signals is the combined list of signals from all collectors.
	Signals []RawSignal

	// Results is the per-collector breakdown.
	Results []CollectorResult

	// Duration is the total scan duration.
	Duration time.Duration

	// Metrics maps collector names to their structured metrics. Only populated
	// for collectors that implement the MetricsProvider interface.
	Metrics map[string]any
}

type SecretPatternConfig struct {
	ID         string
	Name       string
	Pattern    string
	Confidence float64
	Keywords   []string
}