@isaacriehm/cairn-core 0.8.0 → 0.9.2

package/dist/init/phases/source-comments-output-io.d.ts

@@ -1,89 +0,0 @@
-/**
- * Side-file persistence for the heavy Phase 9 output.
- *
- * `IngestSourceCommentsResult` carries the full walk (every comment block's
- * raw text + prose) and the matching classifications. On a busy monorepo
- * this crosses ~1.7 MB — far above what the MCP transport can echo back
- * in a tool result. Mirrors the v0.3.5 mapper-output spillover: write the
- * full payload to `.cairn/init/source-comments-walk.json` and persist a
- * lightweight projection (counts, paths, ledger-relevant lists) into
- * `init-state.json`.
- *
- * Downstream phases consume only the lightweight projection — the
- * heavy walk + per-block classifications already live in
- * `.cairn/baseline/source-comments-<ISO>.yaml` (the audit YAML), which
- * the strip-replace stage and any later debug tools already read.
- */
-import type { IngestSourceCommentsResult } from "../source-comments/index.js";
-import type { CommentClassKind } from "../source-comments/classify.js";
-/** Filename relative to repoRoot. */
-export declare const SOURCE_COMMENTS_WALK_PATH: string;
-export declare function sourceCommentsWalkAbsPath(repoRoot: string): string;
-/**
- * Atomically write the full Phase 9 result. Creates `.cairn/init/`
- * if needed.
- */
-export declare function writeSourceCommentsWalkFile(repoRoot: string, full: IngestSourceCommentsResult): string;
-/**
- * Read the full Phase 9 result from `.cairn/init/source-comments-walk.json`.
- * Returns null if missing or unreadable. Available for debug tooling and
- * post-hoc inspection — phase consumers prefer the lightweight projection
- * stored on state.
- */
-export declare function readSourceCommentsWalkFile(repoRoot: string): IngestSourceCommentsResult | null;
-/** Phase was skipped because the repo is the Cairn source repo itself. */
-export interface IngestSourceCommentsSkippedResult {
-    readonly skipped: "self-adopt";
-}
-/**
- * Lightweight projection persisted into `init-state.json` outputs. Drops
- * `walk.blocks` and `classifications` (the heavy fields); keeps ledger /
- * triage references that downstream phases + the cairn-adopt summary
- * skill query directly.
- */
-export interface IngestSourceCommentsRunResult {
-    /** Repo-relative path to the spilled full result, or null when not written. */
-    walkPath: string;
-    walkSummary: {
-        files: number;
-        blocks: number;
-        bytesScanned: number;
-        fileCountByLang: Record<string, number>;
-        filesAvailable: number;
-        truncatedAtFileCap: boolean;
-    };
-    decsWritten: {
-        id: string;
-        path: string;
-        sourceFile: string;
-        slug: string;
-        status: "accepted";
-    }[];
-    invsWritten: {
-        id: string;
-        path: string;
-        sourceFile: string;
-        slug: string;
-        status: "accepted";
-    }[];
-    citesEmitted: {
-        id: string;
-        sourceFile: string;
-        lineRange: [number, number];
-        slug: string;
-    }[];
-    stripFilesModified: number;
-    stripItemsApplied: number;
-    stripItemsSkipped: number;
-    stripError: string | null;
-    auditPath: string;
-    auditRelPath: string;
-    inputTokens: number;
-    outputTokens: number;
-    batchesRun: number;
-    batchesFailed: number;
-    kindCounts: Record<CommentClassKind, number>;
-}
-export type IngestSourceCommentsResultPersisted = IngestSourceCommentsRunResult | IngestSourceCommentsSkippedResult;
-/** Strip the heavy fields from a fresh ingest result for state persistence. */
-export declare function to7bResultPersisted(full: IngestSourceCommentsResult): IngestSourceCommentsRunResult;

package/dist/init/phases/source-comments-output-io.js

@@ -1,81 +0,0 @@
-/**
- * Side-file persistence for the heavy Phase 9 output.
- *
- * `IngestSourceCommentsResult` carries the full walk (every comment block's
- * raw text + prose) and the matching classifications. On a busy monorepo
- * this crosses ~1.7 MB — far above what the MCP transport can echo back
- * in a tool result. Mirrors the v0.3.5 mapper-output spillover: write the
- * full payload to `.cairn/init/source-comments-walk.json` and persist a
- * lightweight projection (counts, paths, ledger-relevant lists) into
- * `init-state.json`.
- *
- * Downstream phases consume only the lightweight projection — the
- * heavy walk + per-block classifications already live in
- * `.cairn/baseline/source-comments-<ISO>.yaml` (the audit YAML), which
- * the strip-replace stage and any later debug tools already read.
- */
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
-import { dirname, join } from "node:path";
-/** Filename relative to repoRoot. */
-export const SOURCE_COMMENTS_WALK_PATH = join(".cairn", "init", "source-comments-walk.json");
-export function sourceCommentsWalkAbsPath(repoRoot) {
-    return join(repoRoot, SOURCE_COMMENTS_WALK_PATH);
-}
-/**
- * Atomically write the full Phase 9 result. Creates `.cairn/init/`
- * if needed.
- */
-export function writeSourceCommentsWalkFile(repoRoot, full) {
-    const abs = sourceCommentsWalkAbsPath(repoRoot);
-    mkdirSync(dirname(abs), { recursive: true });
-    const tmp = `${abs}.tmp`;
-    writeFileSync(tmp, JSON.stringify(full, null, 2), "utf8");
-    renameSync(tmp, abs);
-    return abs;
-}
-/**
- * Read the full Phase 9 result from `.cairn/init/source-comments-walk.json`.
- * Returns null if missing or unreadable. Available for debug tooling and
- * post-hoc inspection — phase consumers prefer the lightweight projection
- * stored on state.
- */
-export function readSourceCommentsWalkFile(repoRoot) {
-    const abs = sourceCommentsWalkAbsPath(repoRoot);
-    if (!existsSync(abs))
-        return null;
-    try {
-        return JSON.parse(readFileSync(abs, "utf8"));
-    }
-    catch {
-        return null;
-    }
-}
-/** Strip the heavy fields from a fresh ingest result for state persistence. */
-export function to7bResultPersisted(full) {
-    return {
-        walkPath: SOURCE_COMMENTS_WALK_PATH,
-        walkSummary: {
-            files: full.walk.files.length,
-            blocks: full.walk.blocks.length,
-            bytesScanned: full.walk.bytesScanned,
-            fileCountByLang: full.walk.fileCountByLang,
-            filesAvailable: full.walk.filesAvailable,
-            truncatedAtFileCap: full.walk.truncatedAtFileCap,
-        },
-        decsWritten: full.decsWritten,
-        invsWritten: full.invsWritten,
-        citesEmitted: full.citesEmitted,
-        stripFilesModified: full.stripFilesModified,
-        stripItemsApplied: full.stripItemsApplied,
-        stripItemsSkipped: full.stripItemsSkipped,
-        stripError: full.stripError,
-        auditPath: full.auditPath,
-        auditRelPath: full.auditRelPath,
-        inputTokens: full.inputTokens,
-        outputTokens: full.outputTokens,
-        batchesRun: full.batchesRun,
-        batchesFailed: full.batchesFailed,
-        kindCounts: full.kindCounts,
-    };
-}
-//# sourceMappingURL=source-comments-output-io.js.map

package/dist/init/phases/source-comments-output-io.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"source-comments-output-io.js","sourceRoot":"","sources":["../../../src/init/phases/source-comments-output-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAI1C,qCAAqC;AACrC,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAC3C,QAAQ,EACR,MAAM,EACN,2BAA2B,CAC5B,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,OAAO,IAAI,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAAgB,EAChB,IAAgC;IAEhC,MAAM,GAAG,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAChD,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;IACzB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1D,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAAgB;IAEhB,MAAM,GAAG,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAA+B,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AA6DD,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CACjC,IAAgC;IAEhC,OAAO;QACL,QAAQ,EAAE,yBAAyB;QACnC,WAAW,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YAC7B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;YAC/B,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY;YACpC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe;YAC1C,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc;YACxC,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB;SACjD;QACD,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC"}

package/templates/.cairn/ground/capabilities/mcp-tools.yaml

@@ -1,29 +0,0 @@
-# MCP servers registered alongside Cairn in .mcp.json.
-#
-# WHAT THIS FILE IS
-#
-# Inventory of the OTHER MCP servers this project uses (not cairn
-# itself — cairn auto-registers via the plugin bundle). Includes
-# server name + one-line capability summary. Read at SessionStart
-# so the agent knows what tools it can reach without re-listing
-# every tool exhaustively.
-#
-# WHEN TO FILL IT IN
-#
-# Operator-paced. Add an entry every time you wire up a new MCP
-# server (Notion, Stripe, internal tools, etc.). Flip an entry's
-# status when the server's capabilities shift.
-#
-# FORMAT
-#
-# Two examples to anchor on:
-#
-#   mcp_tools:
-#     - name: stripe
-#       description: Stripe payments + customers + subscriptions. Use when the agent needs to look up a charge by id or check a customer's billing state.
-#       status: accepted
-#     - name: notion
-#       description: Read-only Notion workspace query. Use for cross-referencing PRDs that live in Notion, never for writes.
-#       status: accepted
-
-mcp_tools: []

package/templates/.cairn/ground/capabilities/skills.yaml

@@ -1,25 +0,0 @@
-# Installed skill packs available in this session.
-#
-# WHAT THIS FILE IS
-#
-# Inventory of project-level skills the agent can invoke (the
-# `.claude/skills/` directory of the host project). Each entry is
-# name + one-line trigger description. Adoption seeds entries from
-# whatever's already in `.claude/skills/`; operator extends.
-#
-# WHEN TO FILL IT IN
-#
-# Auto-populated at adoption + on `cairn fix` re-scans. Edit by
-# hand only when adding a new project-local skill or removing one.
-#
-# FORMAT
-#
-# Two examples to anchor on:
-#
-#   skills:
-#     - name: deploy-staging
-#       description: Push current branch to the staging GKE cluster + run smoke tests. Auto-invoke on "deploy", "ship", "push to staging".
-#     - name: db-migrate
-#       description: Generate + apply a Drizzle migration with backup snapshot. Auto-invoke when schema changes are mentioned.
-
-skills: []

package/templates/.cairn/ground/capabilities/snippets.yaml

@@ -1,29 +0,0 @@
-# Blessed implementations for security-sensitive patterns.
-#
-# WHAT THIS FILE IS
-#
-# A catalog of pattern → canonical-implementation pointers for code
-# the operator wants Claude to NEVER reinvent. Each entry says "if
-# you need to do X, copy from this exact location". Read at
-# SessionStart so the agent skips improvising auth / signing /
-# input-validation / etc.
-#
-# WHEN TO FILL IT IN
-#
-# Operator-paced. Add an entry every time you catch the agent
-# hand-rolling something that has an existing blessed implementation
-# in your codebase.
-#
-# FORMAT
-#
-# Two examples to anchor on:
-#
-#   snippets:
-#     - pattern: jwt-signing
-#       canonical: src/auth/sign.ts:signSession
-#       why: Single source of HS256 secret + iat. Hand-rolled JWT signing has historically leaked the secret in test fixtures.
-#     - pattern: html-escape
-#       canonical: src/util/escape.ts:escape
-#       why: Uses the project's content-security-policy-aware escape; ad-hoc replace() chains miss attribute-context cases.
-
-snippets: []