grimoire

type ContextFile struct {
	Path      string // absolute
	Rel       string // relative to the git root (or the workspace)
	Content   string
	Truncated int // bytes cut by the caps; 0 when whole
}

type GitSnapshot struct {
	Branch        string
	MainBranch    string
	Status        string // short status output
	RecentCommits string // last 5 commits oneline
	UserName      string
}

type Grimoire struct {
	Sources      []string          // file paths that contributed (ordered by priority)
	Bindings     []string          // project facts (language, structure, commands)
	Rituals      []string          // behavioral rules (always/never do)
	Incantations []IncludeRef      // @path includes with resolved content
	Wards        []string          // protected areas
	Hooks        []HookEntry       // pre/post tool execution commands
	RawSections  map[string]string // unparsed section content by heading
	// StreamRules are "## Stream Rules" sections (2.0 W3), one per file, in
	// source order. They are rules for the rules package, never rendered
	// into the prompt: a rule costs no context until it fires.
	StreamRules []RuleSection
	Meta        GrimoireMetadata // embedded metadata (last updated, git hash, etc.)
}

type GrimoireMetadata struct {
	LastUpdated    time.Time
	GitHash        string
	GitBranch      string
	GitCommitCount int
}

type GrimoireSource struct {
	Path     string
	Priority int
	// contains filtered or unexported fields
}

type HookEntry struct {
	Phase    string // "PreToolUse" or "PostToolUse"
	ToolName string // tool name pattern (e.g., "bash", "write_file")
	Command  string // shell command to execute
}

type IncludeRef struct {
	Path     string // original @path from grimoire
	Resolved string // absolute path after resolution
	Content  string // file content (empty if unresolved)
	Error    string // non-empty if resolution failed
}

type ProjectInfo struct {
	Language     string
	ModulePath   string
	TestCommand  string
	LintCommand  string
	BuildCommand string
	EntryPoint   string
	Framework    string
}

type RuleSection struct {
	Source string
	Body   string
}