ideapromote

type BackLink struct {
	// RepoRoot is the absolute root of the repo containing the entry.
	RepoRoot string
	// RelPath is the repo-relative path of the file containing the entry.
	RelPath string
	// Line is the 0-based index of the entry line within the file.
	Line int
	// Target is the raw markdown link target (the URL between the
	// parentheses).
	Target string
	// CrossRepo is true when the target is `<repo-slug>:`-qualified
	// (per sidekick-capture's cross-repo back-link format); false when
	// it is a bare relative path (same-repo).
	CrossRepo bool
}

type Paths struct {
	// SeedRel is the source seed path: spec/ideas/seeds/<slug>.md.
	SeedRel string
	// IdeaRel is the destination Idea path: spec/ideas/<slug>.md.
	IdeaRel string
	// ArchivedSeedRel is the cross-repo archive destination:
	// spec/ideas/archived/<slug>.md.
	ArchivedSeedRel string
}

type ReconcileResult struct {
	RepoRoot string
	RelPath  string
}

type RepoRef struct {
	Path string
}

type Result struct {
	// Slug is the promoted slug.
	Slug string `json:"slug" yaml:"slug"`
	// IdeaPath is the absolute path of the created Idea.
	IdeaPath string `json:"idea_path" yaml:"idea_path"`
	// SeedFate is "moved" (same-repo) or "archived" (cross-repo).
	SeedFate SeedFate `json:"seed_fate" yaml:"seed_fate"`
	// SeedPath is the absolute path the seed ended up at: the Idea path
	// (moved) or the archived path (archived).
	SeedPath string `json:"seed_path" yaml:"seed_path"`
	// ReconciledBackLinks lists the repo-relative paths of same-repo
	// back-link files rewritten from the seeds path to the Idea path.
	// Empty in the cross-repo path. Always non-nil for stable JSON output.
	ReconciledBackLinks []string `json:"reconciled_back_links" yaml:"reconciled_back_links"`
}

type SeedContent struct {
	// Frontmatter holds the YAML frontmatter key→raw-value lines (in
	// encounter order) when the seed opens with a `---` fence. Empty when
	// the seed has no frontmatter.
	Frontmatter map[string]string
	// FrontmatterOrder preserves the key order of Frontmatter.
	FrontmatterOrder []string
	// Title is the text after the first `# ` H1 line (the seed's title).
	// Empty when the seed has no H1.
	Title string
	// Body is the prose between the title and the first `## ` H2 section
	// (or end of file), trimmed of surrounding blank lines. This is what
	// folds into the Idea's ## Context.
	Body string
	// Verdict is the full `## Consilium Verdict` section (heading line
	// included) when present, else empty.
	Verdict string
}

type SeedFate string

type TransformOptions struct {
	Slug string
	// Owner defaults to the seed's captured_by / unknown when empty.
	Owner string
	// Date defaults to today (UTC) when empty.
	Date string
	// VerdictMode selects how the seed verdict is carried forward.
	VerdictMode VerdictMode
	// SeedRefForPointer is the provenance reference written by the
	// pointer mode (e.g. the seed's repo-relative path). When empty the
	// pointer falls back to the seed filename.
	SeedRefForPointer string
}

type VerdictMode string