@isaacriehm/cairn-state 0.22.5

package/dist/schemas.js

@@ -0,0 +1,506 @@
+import { z } from "zod";
+export const Audience = z.enum(["ai-only", "dual", "human-only"]);
+export const ProvenanceFrontmatter = z
+    .object({
+    type: z.string().optional(),
+    status: z.string().optional(),
+    audience: Audience.optional(),
+    generated: z.string().optional(),
+    "verified-at": z.string().optional(),
+    "source-commits": z.array(z.string()).optional(),
+    supersedes: z.string().nullish(),
+})
+    .passthrough();
+export const ManifestEntry = z.object({
+    path: z.string(),
+    sha256: z.string().length(64),
+    classification: z.string(),
+    audience: z.string().optional(),
+    verified_at: z.string().optional(),
+    generator: z.string().optional(),
+    source: z.string().optional(),
+});
+export const Manifest = z.object({
+    version: z.literal(1),
+    generated: z.string(),
+    generator: z.string().optional(),
+    files: z.array(ManifestEntry),
+});
+export const DecisionAssertion = z.discriminatedUnion("kind", [
+    z.object({
+        id: z.string(),
+        kind: z.literal("schema_must_contain"),
+        table: z.string(),
+        column: z.string(),
+        column_type: z.string().optional(),
+        nullable: z.boolean().optional(),
+    }),
+    z.object({
+        id: z.string(),
+        kind: z.literal("text_must_match"),
+        pattern: z.string(),
+        in_globs: z.array(z.string()),
+    }),
+    z.object({
+        id: z.string(),
+        kind: z.literal("text_must_not_match"),
+        pattern: z.string(),
+        in_globs: z.array(z.string()),
+    }),
+    z.object({
+        id: z.string(),
+        kind: z.literal("index_must_exist"),
+        table: z.string(),
+        columns: z.array(z.string()),
+        where: z.string().optional(),
+    }),
+    z.object({
+        id: z.string(),
+        kind: z.literal("ast_pattern"),
+        language: z.string(),
+        pattern: z.string(),
+        in_globs: z.array(z.string()),
+    }),
+    z.object({
+        id: z.string(),
+        kind: z.literal("file_must_not_be_modified"),
+        path: z.string(),
+    }),
+    z.object({
+        id: z.string(),
+        kind: z.literal("query_must_filter_by"),
+        orm: z.string(),
+        in_globs: z.array(z.string()),
+        table: z.string(),
+        columns: z.array(z.string()),
+        operator: z.enum(["eq", "in", "between", "is_not_null"]),
+        require_combination: z.enum(["and", "or"]),
+    }),
+    z.object({
+        id: z.string(),
+        kind: z.literal("route_must_have_guard"),
+        in_globs: z.array(z.string()),
+        guard: z.string(),
+        require_on: z.array(z.string()),
+    }),
+    z.object({
+        id: z.string(),
+        kind: z.literal("event_must_emit"),
+        in_globs: z.array(z.string()),
+        after_method: z.string(),
+        event_key: z.string(),
+        payload_must_include: z.array(z.string()).optional(),
+    }),
+    z.object({
+        id: z.string(),
+        kind: z.literal("service_method_must_call"),
+        in_globs: z.array(z.string()),
+        in_method: z.string(),
+        must_call: z.string(),
+        before_returning: z.boolean().optional(),
+    }),
+    z.object({
+        id: z.string(),
+        kind: z.literal("human_review_hint"),
+        description: z.string(),
+    }),
+]);
+/**
+ * sot_kind = where the canonical prose lives for this DEC.
+ *   "ledger" — body in this DEC file is canonical (source-comment essay,
+ *              operator-recorded). Lens renders body verbatim.
+ *   "path"   — sot_path points at the canonical location (doc paragraph,
+ *              CLAUDE.md section). Lens renders live content from there.
+ */
+export const SotKind = z.enum(["ledger", "path"]);
+export const DecisionFrontmatter = z
+    .object({
+    id: z.string().regex(/^DEC-[0-9a-f]{7,}$/, "decision id must match DEC-<hash7>"),
+    title: z.string(),
+    type: z.literal("adr").optional(),
+    status: z
+        .string()
+        .refine((s) => s === "accepted" ||
+        s === "superseded" ||
+        s === "archived" ||
+        /^draft(?:-from-[a-z-]+)?$/.test(s), "decision status must be draft | draft-from-<source> | accepted | superseded | archived"),
+    audience: Audience.optional(),
+    generated: z.string().optional(),
+    "verified-at": z.string().optional(),
+    "source-commits": z.array(z.string()).optional(),
+    decided_at: z.string().optional(),
+    decided_by: z.string().optional(),
+    scope_globs: z.array(z.string()).optional(),
+    supersedes: z.string().nullish(),
+    superseded_by: z.string().nullish(),
+    assertions: z.array(DecisionAssertion).optional(),
+    human_review_hint: z.string().optional(),
+    related_invariants: z.array(z.string()).optional(),
+    sot_kind: SotKind,
+    sot_path: z.string().min(1),
+    sot_content_hash: z.string().length(64),
+    related: z.string().nullish(),
+    derived_from: z.string().nullish(),
+})
+    .passthrough();
+export const InvariantFrontmatter = z
+    .object({
+    id: z.string().regex(/^INV-[0-9a-f]{7,}$/, "invariant id must match INV-<hash7>"),
+    title: z.string(),
+    type: z.literal("invariant").optional(),
+    status: z.enum(["active", "superseded", "archived"]).optional(),
+    audience: Audience.optional(),
+    generated: z.string().optional(),
+    "verified-at": z.string().optional(),
+    source_run: z.string().optional(),
+    source_decision: z.string().nullish(),
+    introduced_for_bug: z.string().optional(),
+    sensor: z.string().optional(),
+    e2e: z.string().optional(),
+    naming_convention: z.string().optional(),
+    superseded_by: z.string().nullish(),
+    sot_kind: SotKind,
+    sot_path: z.string().min(1),
+    sot_content_hash: z.string().length(64),
+    related: z.string().nullish(),
+    derived_from: z.string().nullish(),
+})
+    .passthrough();
+export const DecisionLedgerEntry = z.object({
+    id: z.string(),
+    title: z.string(),
+    status: z.string(),
+    scope_globs: z.array(z.string()).optional(),
+    supersedes: z.string().nullish(),
+    superseded_by: z.string().nullish(),
+});
+export const InvariantLedgerEntry = z.object({
+    id: z.string(),
+    title: z.string(),
+    status: z.string(),
+    source_decision: z.string().nullish(),
+    superseded_by: z.string().nullish(),
+});
+export const QualityGrade = z.object({
+    module: z.string(),
+    score: z.number().min(0).max(100),
+    pass_rate: z.number().min(0).max(1),
+    drift_count: z.number().int().nonnegative(),
+    last_updated: z.string(),
+    recent_run_count: z.number().int().nonnegative(),
+});
+export const QualityGrades = z.object({
+    version: z.literal(1),
+    generated: z.string(),
+    modules: z.array(QualityGrade),
+});
+/**
+ * Topic-index entry — one row per content-fingerprint slug across all
+ * scanned sources. `sot_source` is the canonical source path picked by
+ * priority order (docs/* > CLAUDE.md > AGENTS.md > source comments).
+ * `candidates` lists every place the same prose appears (one becomes the
+ * SoT, the rest become §DEC-<id> cites).
+ *
+ * `marker_kind` is stamped at walk-time when the SoT block sits under a
+ * `cairn:` frontmatter key (file-level) or has a `<!-- cairn:decision -->`
+ * / `<!-- cairn:rule -->` HTML comment within 3 lines of its heading
+ * (block-level). Phase 6 Stage 3 reads this field directly off the
+ * topic-index and bypasses Stages 1+2 (file-purpose + section batch
+ * classifiers) for marked entries — the operator has already declared
+ * the block authoritative, so Haiku adds no signal.
+ *
+ * `content_hash` mirrors the SoT block's body hash at walk-time. Used by
+ * `cairn_propose_decision` (PR 2) and the alignment hooks to detect
+ * source drift before promoting a candidate to a draft.
+ */
+export const TopicIndexEntry = z.object({
+    slug: z.string(),
+    dec_id: z.string().optional(),
+    sot_source: z.string(),
+    candidates: z.array(z.object({
+        file: z.string(),
+        kind: z.enum(["doc", "claudemd", "agentsmd", "rule", "source-comment"]),
+        anchor: z.string().optional(),
+        line_range: z.tuple([z.number().int(), z.number().int()]).optional(),
+    })),
+    created_at: z.string(),
+    marker_kind: z.enum(["decision", "rule"]).optional(),
+    content_hash: z.string().length(64).optional(),
+});
+export const TopicIndex = z.object({
+    version: z.literal(1),
+    generated: z.string(),
+    topics: z.record(z.string(), TopicIndexEntry),
+});
+/**
+ * SoT bindings — bidirectional map between DEC ids and their canonical
+ * source paths. Forward index is one-to-one. Reverse index is one-to-many
+ * because supersedes chains keep the same sot_path across multiple DEC
+ * ids.
+ */
+export const SotBindings = z.object({
+    version: z.literal(1),
+    generated: z.string(),
+    forward: z.record(z.string(), z.string()),
+    reverse: z.record(z.string(), z.array(z.string())),
+});
+/**
+ * Sot-cache — tokenized DEC body shingles for Jaccard pre-filter in the
+ * Layer A alignment hook. Mtime-keyed so the cache rebuilds incrementally
+ * on PostToolUse Write events.
+ */
+export const SotCacheEntry = z.object({
+    dec_id: z.string(),
+    sot_path: z.string(),
+    body_hash: z.string().length(64),
+    tokens: z.array(z.string()),
+    shingles: z.array(z.string()),
+    mtime_ms: z.number(),
+});
+export const SotCache = z.object({
+    version: z.literal(1),
+    generated: z.string(),
+    entries: z.record(z.string(), SotCacheEntry),
+});
+/**
+ * Anchor-map — external map from topic slug to its current location in
+ * source. Allows operator's docs to stay pristine (no `<!-- cairn-anchor -->`
+ * injected) while drift detection reconciles via content_hash.
+ */
+export const AnchorMapEntry = z.object({
+    file: z.string(),
+    current_anchor: z.string().optional(),
+    content_hash: z.string().length(64),
+    line_range: z.tuple([z.number().int(), z.number().int()]).optional(),
+    kind: z.enum(["doc", "claudemd", "agentsmd", "rule", "source-comment"]),
+});
+export const AnchorMap = z.object({
+    version: z.literal(1),
+    generated: z.string(),
+    anchors: z.record(z.string(), AnchorMapEntry),
+});
+export const DriftEvent = z.object({
+    ts: z.string(),
+    kind: z.enum([
+        "frontmatter_stale",
+        "generator_drift",
+        "broken_link",
+        "orphan_path",
+        "orphan_entity",
+        "manifest_hash_changed",
+        "doc-drift",
+        "paragraph-deleted",
+        "pre-commit-drift",
+    ]),
+    path: z.string(),
+    detail: z.string().optional(),
+    severity: z.enum(["soft", "hard"]).default("soft"),
+    dec_id: z.string().optional(),
+});
+/**
+ * Layer B pre-commit-drift log entry written by the git pre-commit
+ * hook (`cairn hook pre-commit-align`). SessionStart Drain SessionStart drain
+ * consumes this file, re-checks each entry against the (possibly
+ * changed) source location, and runs the Haiku judge for ambiguous
+ * candidates.
+ *
+ * Path: `.cairn/staleness/pre-commit-deferred.jsonl`.
+ *
+ * `tier: tier1` — deterministic match passed (Jaccard ≥ 0.85, shingle
+ * ≥ 0.6, length ratio 0.5–2.0). SessionStart Drain can auto-cite without Haiku
+ * if the block survives.
+ *
+ * `tier: tier2-3` — Jaccard pre-filter survivors only; Tier 1 didn't
+ * fire. SessionStart Drain invokes Haiku dedup judge.
+ */
+export const PreCommitDriftCandidate = z.object({
+    id: z.string(),
+    similarity: z.number(),
+    body_hash: z.string(),
+    sot_path: z.string(),
+});
+export const PreCommitDriftLogEntry = z.object({
+    ts: z.string(),
+    file: z.string(),
+    block_start_line: z.number(),
+    block_end_line: z.number(),
+    block_content_hash: z.string(),
+    block_prose: z.string(),
+    tier: z.enum(["tier1", "tier2-3"]),
+    candidates: z.array(PreCommitDriftCandidate),
+});
+/**
+ * Rejected-candidate ledger entry (`.cairn/ground/_rejected.yaml`).
+ *
+ * Records topic-index slugs the operator (or `ai-curator`) decided are
+ * *not* canonical — false positives, research notes, planning prose,
+ * etc. The drift sensor reads this file and suppresses any candidate
+ * whose slug appears here; phase 6 / `cairn ingest` skip rejected slugs
+ * on the next pass instead of re-proposing them.
+ *
+ * Dedup is by slug. First writer wins the `reason` string; subsequent
+ * writes only refresh `rejected_at`. Phase 5b GC drops entries whose
+ * slug is no longer present in the freshly-built topic-index.
+ */
+export const RejectedEntry = z.object({
+    slug: z.string(),
+    rejected_at: z.string(),
+    rejected_by: z.enum(["operator", "ai-curator", "cairn-init"]),
+    reason: z.string(),
+    sot_source: z.string(),
+    line_range: z.tuple([z.number().int(), z.number().int()]).optional(),
+});
+export const RejectedYaml = z.object({
+    version: z.literal(1),
+    generated: z.string(),
+    rejected: z.array(RejectedEntry),
+});
+/**
+ * `.cairn/ground/file-candidates-map.yaml` — per-file count of
+ * topic-index entries with `dec_id IS NULL`. Built at the end of phase
+ * 5b (and refreshed whenever `dec_id` is stamped — phase 6, the PR 2
+ * `cairn_propose_decision` tool, etc.). The read-enrich hook consults
+ * this map to inject a candidate-count warning when an AI agent reads a
+ * file with unpromoted candidates, without scanning the whole topic
+ * index per Read.
+ */
+export const FileCandidatesMap = z.object({
+    version: z.literal(1),
+    generated: z.string(),
+    file_candidates: z.record(z.string(), z.number().int().nonnegative()),
+});
+/* -------------------------------------------------------------------------- */
+/* Mission system — supra-task layer                                          */
+/* -------------------------------------------------------------------------- */
+/**
+ * Per-mission default exit gate, with optional per-phase override in
+ * roadmap.md frontmatter.
+ *   - `prompt` — Stop hook surfaces inline AskUserQuestion on phase complete.
+ *   - `auto`   — cursor advances silently when last phase task graduates.
+ *   - `manual` — operator advances explicitly via cairn_mission_advance.
+ */
+export const MissionExitGate = z.enum(["prompt", "auto", "manual"]);
+export const MissionPhase = z.object({
+    id: z
+        .string()
+        .min(1)
+        .regex(/^[a-z0-9][a-z0-9-]*$/, "phase id must be kebab-case ([a-z0-9-]+)"),
+    title: z.string().min(1),
+    depends_on: z.array(z.string()).default([]),
+    exit_criteria: z.string().min(1),
+    exit_gate: MissionExitGate.optional(),
+});
+/**
+ * Roadmap frontmatter — `.cairn/ground/missions/<id>/roadmap.md`. Lives
+ * in committed ground state; multi-dev visible. Phase YAML is canonical;
+ * any prose body is operator notes ignored by Cairn parsing.
+ */
+export const MissionRoadmapFrontmatter = z
+    .object({
+    mission_id: z.string().regex(/^MIS-[a-z0-9-]+-[0-9a-f]{7}$/, "mission id must match MIS-<slug>-<hash7>"),
+    title: z.string().min(1),
+    spec_path: z.string().min(1),
+    created_at: z.string(),
+    exit_gate: MissionExitGate,
+    phases: z.array(MissionPhase).min(1),
+})
+    .passthrough();
+export const MissionPhaseState = z.enum(["pending", "in_progress", "done"]);
+export const MissionPhaseProgressEntry = z.object({
+    state: MissionPhaseState,
+    task_ids: z.array(z.string()).default([]),
+    graduated_at: z.string().optional(),
+    /**
+     * True once a `phase-ready-to-exit` invalidation event has been
+     * emitted for this phase. Suppresses re-emission on subsequent task
+     * completions within the same phase (prevents the prompt storm where
+     * every late task completion re-fires the operator-facing
+     * "phase ready to exit" surface). Cleared when the cursor advances
+     * past the phase or the phase is reopened.
+     */
+    ready_emitted: z.boolean().optional(),
+    /**
+     * Per-phase tightening state. Unset while the phase still needs a
+     * just-in-time brief; `drafted` once `cairn_mission_plan_phase` has
+     * written a brief the operator hasn't confirmed; `accepted` once the
+     * brief is locked and tasks may inherit it. The cursor landing on a
+     * phase with `brief_status` unset is the "brief-pending" signal the
+     * direction skill reads before creating phase-anchored tasks.
+     */
+    brief_status: z.enum(["drafted", "accepted"]).optional(),
+});
+/**
+ * One resolved fork captured during per-phase tightening — the question
+ * the brief closed plus the operator's (or, in autonomous mode, the
+ * model's) choice. Mirrors a lightweight DEC without graduating to the
+ * decision graph; phase-scoped and archived with the mission.
+ */
+export const MissionPhaseBriefDecision = z.object({
+    question: z.string().min(1),
+    choice: z.string().min(1),
+    rationale: z.string().optional(),
+});
+/**
+ * Per-phase brief — `.cairn/ground/missions/<id>/briefs/<phase-id>.md`.
+ * The just-in-time tightening artifact for a single phase: the forks the
+ * operator resolved, the constraints tasks in this phase must honour,
+ * the phase acceptance bar, and the in-scope ground-state cites that
+ * pre-answered the rest. Committed alongside the roadmap (multi-dev
+ * visible). Frontmatter is canonical; prose body is operator notes.
+ */
+export const MissionPhaseBrief = z
+    .object({
+    phase_id: z.string().min(1),
+    drafted_at: z.string(),
+    status: z.enum(["drafted", "accepted"]).default("drafted"),
+    autonomous: z.boolean().optional(),
+    decisions: z.array(MissionPhaseBriefDecision).default([]),
+    constraints: z.array(z.string()).default([]),
+    acceptance: z.array(z.string()).default([]),
+    cite_decisions: z.array(z.string()).default([]),
+    cite_invariants: z.array(z.string()).default([]),
+})
+    .passthrough();
+export const MissionCursor = z.object({
+    active_phase: z.string().nullable(),
+    active_phase_started_at: z.string().nullable(),
+});
+export const MissionOutcome = z.enum(["active", "done", "aborted"]);
+/**
+ * Per-clone mission state — `.cairn/missions/<id>/state.json`.
+ * Tracks the cursor + phase progress. Never committed (gitignored under
+ * `.cairn/missions/`).
+ */
+export const MissionState = z.object({
+    mission_id: z.string(),
+    started_at: z.string(),
+    cursor: MissionCursor,
+    phase_progress: z.record(z.string(), MissionPhaseProgressEntry),
+    outcome: MissionOutcome.default("active"),
+    closed_at: z.string().optional(),
+    abort_reason: z.string().optional(),
+});
+/**
+ * Mission journal entry — `.cairn/missions/<id>/journal.jsonl`. One
+ * record per mission-level event (start, advance, resync, close).
+ */
+export const MissionJournalEntry = z.object({
+    ts: z.string(),
+    kind: z.enum([
+        "started",
+        "phase-advanced",
+        "phase-deferred",
+        "phase-brief-set",
+        "task-attached",
+        "resync-pending",
+        "resync-applied",
+        "drift-detected",
+        "closed",
+        "reopened",
+        "exit-gate-changed",
+    ]),
+    phase_id: z.string().optional(),
+    task_id: z.string().optional(),
+    detail: z.string().optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/scope-index.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Scope index — forward map from every file path in the repo to the decisions
+ * and invariants that apply to that file.
+ *
+ * Built at init by the Tier-2 mapper LLM, maintained by the GC sweep + the
+ * MCP record-decision tool when scope edits land. Read by the read-enricher
+ * / write-guardian hooks (via cached accessor in
+ * `hooks/post-tool-use/ledger-cache.ts`) and by the GC scope-coverage pass.
+ *
+ * Spec: docs/FILESYSTEM_LAYOUT.md §2.1.
+ */
+export interface ScopeIndexEntry {
+    decisions: string[];
+    invariants: string[];
+    unscoped?: true;
+}
+/**
+ * Mapper LLMs occasionally emit ledger-entry PROSE ("HTTP layer is the only
+ * public surface…") into `decisions[]` / `invariants[]` instead of bare IDs,
+ * because the user prompt lists them as `${id} — ${title}` and the JSON-mode
+ * schema only constrains the type to `string`. This coercer extracts the
+ * first ID-shaped token from each string and silently drops anything that
+ * doesn't match — IDs only, deduplicated, order preserved.
+ */
+export declare function coerceDecisionIds(raw: readonly unknown[]): string[];
+export declare function coerceInvariantIds(raw: readonly unknown[]): string[];
+export interface ScopeIndex {
+    generated: string;
+    files: Record<string, ScopeIndexEntry>;
+}
+export declare function scopeIndexPath(repoRoot: string): string;
+export declare function readScopeIndex(repoRoot: string): ScopeIndex | null;
+export declare function lookupScope(index: ScopeIndex, repoRelativePath: string): ScopeIndexEntry | null;
+export declare function writeScopeIndex(repoRoot: string, index: ScopeIndex): void;
+export interface RescanScopeIndexResult {
+    filesScanned: number;
+    entriesAdded: number;
+    entriesUpdated: number;
+    entriesUnchanged: number;
+    /** True when scope-index.yaml was rewritten. */
+    dirty: boolean;
+}
+/**
+ * Deterministic regex sweep — walk every git-tracked source file, parse
+ * `§INV-<hash>` / `§DEC-<hash>` cite tokens, and sync the scope-index so the
+ * in-scope tools never lag behind source-cite reality. No LLM, no
+ * incremental tracking complexity. Cheap enough to run on every
+ * SessionStart (~100ms on 50k files).
+ *
+ * Honors `unscoped: true` entries — never touches them. Skips files with
+ * no citations and no prior entry to avoid polluting the index. When a
+ * file's cite set differs from its scope-index entry (added, removed, or
+ * stale ids), the entry is rewritten with the deterministically-sorted
+ * current set.
+ */
+export declare function rescanScopeIndex(repoRoot: string): RescanScopeIndexResult;
+/**
+ * Single-file scope-index sync from in-memory content. Called by the
+ * PostToolUse(Write/Edit) hook so an agent's writes don't leave the
+ * scope-index stale until the next SessionStart rescan. Same regex
+ * parser as `rescanScopeIndex`, but bounded to one file — O(1) cost,
+ * no walker.
+ *
+ * Honors `unscoped: true` entries (skips them). Honors the same skip
+ * rule the rescan does: file with no citations and no prior entry is
+ * a no-op so we don't pollute the index with empty rows.
+ */
+export declare function syncFileScopeFromContent(repoRoot: string, repoRelPath: string, content: string): {
+    dirty: boolean;
+};
+export interface RebuildScopeIndexOptions {
+    repoRoot: string;
+    /** Hard timeout for the mapper LLM call (ms). Default 300000. */
+    timeoutMs?: number;
+}
+export interface RebuildScopeIndexResult {
+    /** Absolute path to the file written. */
+    path: string;
+    /** Total scope-index entries after the rescan (added + updated + unchanged). */
+    filesClassified: number;
+    /** Wall-clock ms for the rescan. */
+    durationMs: number;
+}
+/**
+ * `cairn scope rebuild` — full deterministic resync of `.cairn/ground/
+ * scope-index.yaml` from current source-cite reality. Used to be a
+ * Sonnet call (`runMapper`-style) that re-classified files via the
+ * Tier-2 mapper, but classification was always the wrong abstraction
+ * — bare-symbol citations in source are the canonical source of truth,
+ * `rescanScopeIndex` parses them deterministically, and the result
+ * matches what the read-enricher legend actually shows.
+ *
+ * No LLM. No tokens. No mapper. Just a regex sweep over git-tracked
+ * source files and an atomic write.
+ */
+export declare function rebuildScopeIndex(opts: RebuildScopeIndexOptions): Promise<RebuildScopeIndexResult>;