adapter

type Adapter struct {
	ID              string       `yaml:"id"`
	Name            string       `yaml:"name"`
	Type            string       `yaml:"type"` // file-inject | clipboard-export | mcp-wire
	Targets         []Target     `yaml:"targets"`
	Format          string       `yaml:"format,omitempty"` // "markdown" (default) | "plain-prose"
	Template        string       `yaml:"template"`
	Instructions    string       `yaml:"instructions"`
	MaxTokens       int          `yaml:"max_tokens,omitempty"`  // 0 = unconstrained
	MaxBytes        int          `yaml:"max_bytes,omitempty"`   // hard byte ceiling; 0 = unconstrained
	Verbosity       string       `yaml:"verbosity,omitempty"`   // "minimal" | "standard" | "full"; default "full"
	ExportPath      string       `yaml:"export_path,omitempty"` // file-export: path to write full context
	MCPConfig       *MCPConfig   `yaml:"mcp_config,omitempty"`
	ExtraMCPConfigs []MCPConfig  `yaml:"extra_mcp_configs,omitempty"`
	HookConfig      *HookConfig  `yaml:"hook_config,omitempty"`
	SkillConfig     *SkillConfig `yaml:"skill_config,omitempty"`
	Detect          []DetectRule `yaml:"detect"`
}

type DetectRule struct {
	Command string `yaml:"command,omitempty"`
	Path    string `yaml:"path,omitempty"`
}

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

type HookConfig struct {
	Path   string `yaml:"path"`
	Format string `yaml:"format"` // "json" only for now
	Key    string `yaml:"key"`    // dot-separated JSON path, e.g. "hooks.SessionStart"
}

type MCPConfig struct {
	Path   string `yaml:"path"`
	Format string `yaml:"format"`
	Key    string `yaml:"key"`
}

type Options struct {
	Scope      string // "global" | "project"
	ToolFilter string // if non-empty, only run this adapter ID
	DryRun     bool
	Stats      bool
	Out        io.Writer               // for stats/warning output; nil → io.Discard
	Dynamic    *content.DynamicContext // nil = no dynamic section
	Uninstall  bool
	// Lang is the active language for i18n. Always use e.opts.Lang inside engine code.
	Lang      string
	Verbosity string // CLI override; empty = use adapter default
}

type RunResult struct {
	Found    int // sections/files removed in live mode
	DryFound int // sections/files that would be removed in dry-run mode
	Err      error
}

type SectionInfo struct {
	Name   string `json:"name"`
	Tokens int    `json:"tokens"`
}

type SkillConfig struct {
	Path string `yaml:"path"` // base directory, e.g. "~/.claude/skills"
}

type StatusRow struct {
	AdapterName string `json:"name"`
	AdapterID   string `json:"adapter"`
	Scope       string `json:"scope"`
	TargetPath  string `json:"path"` // unexpanded (~-form)

	FileExists bool `json:"file_exists"`
	Injected   bool `json:"injected"` // sap-devs section present and well-formed
	Orphaned   bool `json:"orphaned"` // markers found but mismatched/reversed

	// Stale is true when the on-disk section content differs from what inject would write today.
	// Always false when FileExists=false, Injected=false, or engine has no packs loaded.
	Stale bool `json:"stale"`

	// Stretch-goal fields — always populated when FileExists=true.
	FileSizeBytes int           `json:"file_size_bytes"`
	FileTokenEst  int           `json:"file_token_est"`  // word count × 1.3
	SapDevsTokens int           `json:"sap_devs_tokens"` // token estimate for sap-devs section only
	OtherSections []SectionInfo `json:"other_sections"`  // non-sap-devs fenced blocks
}

type Target struct {
	Scope    string `yaml:"scope"` // global | project
	Path     string `yaml:"path"`
	Mode     string `yaml:"mode"` // replace-section | append | replace-file
	Section  string `yaml:"section"`
	Preamble string `yaml:"preamble,omitempty"` // prepended before content; replace-file only
}