manifest

type BindingManifest struct {
	SchemaVersion    int               `json:"schema_version"`
	Name             string            `json:"name"`
	Host             string            `json:"host"`
	Loop             string            `json:"loop"`
	ProjectionPath   string            `json:"projection_path"`
	RuntimeSurface   string            `json:"runtime_surface"`
	LifecycleMapping map[string]string `json:"lifecycle_mapping"`
	Reconcile        []string          `json:"reconcile"`
}

type EnvVar struct {
	Name  string `json:"name"`
	Value string `json:"value"`
}

type HookOptions struct {
	Remind  bool `json:"remind"`
	Nudge   bool `json:"nudge"`
	Compact bool `json:"compact"`
}

type LoopAssets struct {
	Guide        string   `json:"guide"`
	Env          string   `json:"env"`
	RuntimeFiles []string `json:"runtime_files,omitempty"`
	Skills       []string `json:"skills"`
	Subagents    []string `json:"subagents"`
}

type LoopManifest struct {
	SchemaVersion int        `json:"schema_version"`
	Name          string     `json:"name"`
	Version       string     `json:"version,omitempty"`
	Description   string     `json:"description,omitempty"`
	Surfaces      Surfaces   `json:"surfaces"`
	Assets        LoopAssets `json:"assets"`
	// Store, when present and Native, declares that the loop is backed by a native `mnemon` store
	// (the projector ensures it via the mnemon CLI when --store is set). Declarative replacement for
	// the hardcoded loop.Name == "memory" gate (PD4); absent = not store-backed.
	Store *LoopStore `json:"store,omitempty"`
	// StateDirs are loop state directories the projector creates under the loop's state dir at
	// install (declarative replacement for the hardcoded skill-loop scaffolding; PD4). Each is a
	// safe relative path (no absolute, no "..").
	StateDirs []string `json:"state_dirs,omitempty"`
	// Env are the loop's extra runtime env vars, rendered into the runtime env.sh as
	// `export NAME="VALUE"` (declarative replacement for the hardcoded per-loop env switch; PD4).
	// Names are namespaced (^MNEMON_...) and values use a CLOSED shell-safe grammar — closed
	// projector variables (${state_dir}, ${host_skills_dir}) the projector substitutes, runtime bash
	// refs ${VAR} / ${VAR:-default}, and safe literals — so an external package can never inject
	// shell into a sourced file (the env injection lock).
	Env []EnvVar `json:"env,omitempty"`
	// HookOptions declares the loop's per-loop hook timing intent (declarative replacement for the
	// hardcoded codex/claude hookOptions switch; PD4). A host applies it per its own semantics:
	// codex uses all three bits directly; claude uses Remind as the default (operator --remind
	// overrides) and keeps nudge/compact operator-flag-driven. Absent = the loop has no hooks.
	HookOptions *HookOptions `json:"hook_options,omitempty"`
}

type LoopStore struct {
	Native bool `json:"native"`
}

type Surfaces struct {
	Projection  []string `json:"projection"`
	Observation []string `json:"observation"`
}

type ValidationResult struct {
	Lines []string
}