@isaacriehm/cairn-core 0.7.0 → 0.7.1

package/dist/ground/schemas.js

@@ -1,372 +0,0 @@
-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(),
-    related_invariants: z.array(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",
-        "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`). Layer C 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). Layer C can auto-cite without Haiku
- * if the block survives.
- *
- * `tier: tier2-3` — Jaccard pre-filter survivors only; Tier 1 didn't
- * fire. Layer C 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()),
-});
-//# sourceMappingURL=schemas.js.map

package/dist/ground/schemas.js.map

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

package/dist/ground/scope-index.d.ts

@@ -1,96 +0,0 @@
-/**
- * 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-NNNN` / `§DEC-NNNN` 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>;