proposals

type ApproveRequest struct {
	Reason           string
	Evidence         []string
	ApprovedBy       string
	ApprovedBySource string
}

type CreateRequest struct {
	Kind           string     `json:"kind"`
	Target         string     `json:"target"`
	BaseHash       string     `json:"base_hash"`
	Diff           string     `json:"diff"`
	Classification string     `json:"classification"`
	Prevalence     Prevalence `json:"prevalence"`
	Evidence       []string   `json:"evidence"`
	Reason         string     `json:"reason"`
	Source         string     `json:"source"`
	CreatedBy      string     `json:"created_by"`
	Principal      string     `json:"-"`
}

type FilePatch struct {
	Path  string
	New   bool
	Hunks []Hunk
}

type Filter struct {
	Status string
	Kind   string
}

type Hunk struct {
	OldStart, OldLines int
	NewStart, NewLines int
	Lines              []HunkLine
}

type HunkLine struct {
	Op        byte
	Text      string
	NoNewline bool
}

type ListResult struct {
	Proposals []*Proposal
	Skipped   []Skipped
	Truncated bool
}

type Prevalence struct {
	Sessions int `json:"sessions"`
	Runs     int `json:"runs"`
}

type Proposal struct {
	ID              string         `json:"id"`
	Version         string         `json:"version"`
	Kind            string         `json:"kind"`
	Target          string         `json:"target"`
	BaseHash        string         `json:"base_hash"`
	BaseCurrent     bool           `json:"base_current"`
	Diff            string         `json:"diff"`
	Classification  string         `json:"classification"`
	Prevalence      Prevalence     `json:"prevalence"`
	Evidence        []string       `json:"evidence"`
	Reason          string         `json:"reason,omitempty"`
	Source          string         `json:"source,omitempty"`
	CreatedAt       time.Time      `json:"created_at"`
	CreatedBy       string         `json:"created_by,omitempty"`
	CreatedBySource string         `json:"created_by_source,omitempty"`
	Status          string         `json:"status"`
	Path            string         `json:"path"`
	Provenance      Provenance     `json:"provenance"`
	Findings        []pins.Finding `json:"findings"`
	Verdict         *Verdict       `json:"verdict"`
	Files           []string       `json:"files"`
	PinStatus       string         `json:"pin_status,omitempty"`
}

type Provenance struct {
	Kind      string `json:"kind"`
	Pack      string `json:"pack,omitempty"`
	SourceDir string `json:"source_dir,omitempty"`
}

type RejectRequest struct {
	Reason           string
	ApprovedBy       string
	ApprovedBySource string
}

type RepinRequest struct {
	ExpectedHash     string
	Reason           string
	Evidence         []string
	ApprovedBy       string
	ApprovedBySource string
}

type Resolver interface {
	Resolve(ctx context.Context, kind, name string) (Target, error)
}

type Skipped struct {
	Path     string `json:"path"`
	Category string `json:"category"`
}

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

type Target interface {
	Kind() string
	Name() string
	// Stack is the skill pin stack, or empty for stackless kinds.
	Stack() string
	// CurrentHash is the composite hash of the current content, in the
	// form the kind's pin store produces.
	CurrentHash(ctx context.Context) (string, error)
	// PinStatus is pinned, drift, or unpinned.
	PinStatus(ctx context.Context) (string, error)
	// ReadFiles validates each path against the kind's rules and returns
	// the current bytes of those that exist. A missing key is an absent
	// file. A refused path wraps ErrDiffUnsupported.
	ReadFiles(ctx context.Context, paths []string) (map[string][]byte, error)
	Provenance(ctx context.Context) (Provenance, error)
	// Scan returns advisory findings for the post-apply content.
	Scan(ctx context.Context, applied map[string][]byte, enabled bool, ignore []string) ([]pins.Finding, error)
	// PostApplyHash parses the post-apply content and returns the
	// composite hash the pin store will compute after Write, including
	// any render normalization the write performs. A parse or validation
	// failure wraps ErrApplyFailed.
	PostApplyHash(ctx context.Context, applied map[string][]byte) (string, error)
	// Write writes the applied files in order. On failure the returned
	// restore puts back every file it touched and reports which files
	// were restored and which are still changed.
	Write(ctx context.Context, applied map[string][]byte) (restore func() (restored, stillChanged []string), err error)
	// Repin re-pins the target and appends the approvals log entry
	// through the kind's pin store.
	Repin(ctx context.Context, req RepinRequest) error
}

type Targets struct {
	Registry    *registry.Store
	SkillPins   *skillpins.Store
	Stack       string
	LockPath    string
	Context     *contexts.Manager
	ContextPins *ctxpins.Store
	HookPins    *hookpins.Store
}

type Verdict struct {
	At           time.Time `json:"at"`
	By           string    `json:"by,omitempty"`
	BySource     string    `json:"by_source,omitempty"`
	Reason       string    `json:"reason,omitempty"`
	Evidence     []string  `json:"evidence,omitempty"`
	Applied      bool      `json:"applied"`
	ApprovedHash string    `json:"approved_hash,omitempty"`
	NewHash      string    `json:"new_hash,omitempty"`
	Stack        string    `json:"stack,omitempty"`
	PinError     string    `json:"pin_error,omitempty"`
}

type WriteError struct {
	ID           string
	File         string
	Err          error
	Restored     []string
	StillChanged []string
}