discovery

type ClassificationRule struct {
	Pattern *regexp.Regexp
	Class   provenance.CommandClass
	Reason  string
}

type CompositionRoot struct {
	Path   string `json:"path"`
	Reason string `json:"reason"`
}

type GoModule struct {
	Path       string `json:"path"`
	ModulePath string `json:"module_path"`
}

type IndexStatus struct {
	Name    string `json:"name"`
	Present bool   `json:"present"`
}

type InstructionFile struct {
	Path string `json:"path"`
	Name string `json:"name"`
}

type Repository struct {
	// Root is the absolute path Discover resolved the given root to.
	Root string `json:"root"`
	// IsGitRepo is true if Root contains a .git entry (directory or file,
	// the latter covering git worktrees). It does not imply Dirty is
	// meaningful in the same run if the entry turns out not to be a usable
	// git repository (see Discover's doc comment).
	IsGitRepo bool `json:"is_git_repo"`
	// Dirty is true if `git status --porcelain` reported any uncommitted
	// changes. Always false when IsGitRepo is false; this is the
	// "not a git repository" case, not an error.
	Dirty bool `json:"dirty"`

	// Modules lists every Go module found under Root, including Root's own
	// module if it has a go.mod. Walking stops descending into a directory
	// once a go.mod is found there: a nested module's own subdirectories
	// belong to it, not to the parent scan, mirroring how `go list ./...`
	// treats module boundaries.
	Modules []GoModule `json:"modules"`
	// CompositionRoots lists directories identified as candidate
	// composition roots: every direct child directory of examples/ (if
	// present), plus any directory anywhere under Root containing a Go
	// file with a package-level func main().
	CompositionRoots []CompositionRoot `json:"composition_roots"`
	// InstructionFiles lists every well-known agent-instruction file found
	// anywhere under Root (AGENTS.md, CLAUDE.md, .cursorrules,
	// copilot-instructions.md).
	InstructionFiles []InstructionFile `json:"instruction_files"`
	// MakeTargets lists target names parsed from a Makefile at Root, if
	// present, both from .PHONY: lines and plain "target:" lines at column
	// zero. Empty (never nil) if there is no Makefile at Root.
	MakeTargets []string `json:"make_targets"`
	// CIWorkflows lists *.yml/*.yaml file names under .github/workflows/ at
	// Root, if present.
	CIWorkflows []string `json:"ci_workflows"`
	// Indexes reports presence/absence of well-known semantic-index
	// directories at Root (.codegraph, .git, .tokensave).
	Indexes []IndexStatus `json:"indexes"`
	// Tools reports presence/absence on PATH of commonly-needed binaries
	// (go, git, golangci-lint, gofmt, docker). Discover never executes any
	// of them.
	Tools []ToolStatus `json:"tools"`
}

type ToolStatus struct {
	Name    string `json:"name"`
	Present bool   `json:"present"`
	// Path is the resolved absolute path from exec.LookPath, empty when
	// Present is false.
	Path string `json:"path,omitempty"`
}