importer

type ApplyResult struct {
	Applied   []string // now live in knowledge/
	Conflicts []string // destination exists with different content; kept staged
	Residual  []string // residual CLAUDE.md files left for manual placement
}

type ClaudeMDInput struct {
	Repo    string
	Content string
}

type Cluster struct {
	Key             string  `json:"key"`  // "<kind>/<name>"
	Kind            string  `json:"kind"` // agent | skill
	Name            string  `json:"name"`
	Class           string  `json:"class"`     // identical | superset | diverged | unique
	Canonical       string  `json:"canonical"` // repo whose copy merge stages (LLM output for diverged)
	Similarity      float64 `json:"similarity,omitempty"`
	AttachmentDrift bool    `json:"attachment_drift,omitempty"`
	Items           []Item  `json:"items"`
}

type ClusterInput struct {
	Kind   string
	Name   string
	Copies []Copy
}

type ClusterMerge struct {
	CanonicalBody string
	Residues      []Residue // repo-specific guidance that must not go global
	Notes         string
	Usage         Usage
}

type Copy struct {
	Repo string
	Body string
}

type DecomposedCard struct {
	Slug     string
	Type     string // rule | style | pattern
	Title    string
	Summary  string
	Keywords []string
	Scope    string // global | lang:<x> | repo:<name>
	Body     string
}

type Decomposition struct {
	Cards    []DecomposedCard
	Residual string
	Notes    string
	Usage    Usage
}

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

type Item struct {
	Repo        string   `json:"repo"`      // repo name (unique across the scan)
	RepoPath    string   `json:"repo_path"` // absolute repo root
	Kind        string   `json:"kind"`      // agent | skill | claudemd
	Name        string   `json:"name"`      // identity within kind
	Path        string   `json:"path"`      // absolute file path (SKILL.md for skills)
	Hash        string   `json:"hash"`      // sha256 of raw content
	NormHash    string   `json:"norm_hash"` // sha256 of normalized content
	Lines       int      `json:"lines"`
	Description string   `json:"description,omitempty"` // from the artifact's own frontmatter
	Attachments []string `json:"attachments,omitempty"` // skill sibling files, dir-relative
}

type MergeOpts struct {
	Force  bool // wipe staged output and progress, start over
	Resume bool // keep staged output, skip units already recorded as done
}

type MergeResult struct {
	Staged  []string // paths relative to .import/staged/
	Skipped []string // human-readable reasons
	Notes   []string // LLM notes worth surfacing at review time
	Usage   Usage
}

type Merger interface {
	MergeCluster(ctx context.Context, in ClusterInput) (ClusterMerge, error)
	DecomposeClaudeMD(ctx context.Context, in ClaudeMDInput) (Decomposition, error)
}

type RepoInfo struct {
	Name     string `json:"name"`
	Path     string `json:"path"`
	Agents   int    `json:"agents"`
	Skills   int    `json:"skills"`
	ClaudeMD bool   `json:"claude_md"`
}

type Report struct {
	GeneratedAt time.Time  `json:"generated_at"`
	Repos       []RepoInfo `json:"repos"`
	Clusters    []Cluster  `json:"clusters"`
	ClaudeMD    []Item     `json:"claude_md"` // root CLAUDE.md files, decomposed at merge
}

type Residue struct {
	Repo    string
	Title   string
	Summary string
	Body    string
}

type Usage struct {
	Prompt     int
	Completion int
}