grimoire

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
	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
}

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
}