@isaacriehm/cairn-core 0.1.10 → 0.3.0

package/dist/tightener/tighten.js

@@ -1,66 +0,0 @@
-import { runClaude } from "../claude/index.js";
-import { logger } from "../logger.js";
-import { buildTightenerUserPrompt, TIGHTENER_SYSTEM_PROMPT } from "./prompt.js";
-import { TIGHTENER_OUTPUT_SCHEMA } from "./schema.js";
-const log = logger("tightener");
-/** Word-count cutoff at which we auto-escalate from Haiku → Sonnet. */
-const ESCALATE_WORDS = 500;
-/** Default `spec_quality_floor` per templates/.cairn/config/workflow.md. */
-const DEFAULT_QUALITY_FLOOR = 7;
-function chooseTier(input) {
-    if (input.force_tier !== undefined)
-        return input.force_tier;
-    const wordCount = `${input.title} ${input.body}`.split(/\s+/).filter(Boolean).length;
-    return wordCount > ESCALATE_WORDS ? "sonnet" : "haiku";
-}
-function isOutput(value) {
-    if (typeof value !== "object" || value === null)
-        return false;
-    const v = value;
-    return (Array.isArray(v["ambiguities"]) &&
-        Array.isArray(v["conflicts"]) &&
-        Array.isArray(v["missing_acceptance"]) &&
-        Array.isArray(v["scope_concerns"]) &&
-        Array.isArray(v["existing_stub_overlap"]) &&
-        typeof v["spec_quality_score"] === "number" &&
-        typeof v["ready_to_execute"] === "boolean" &&
-        typeof v["tightened_spec_proposal"] === "string");
-}
-export async function tightenSpec(input) {
-    const tier = chooseTier(input);
-    const userPrompt = buildTightenerUserPrompt(input);
-    log.info({ tier, body_len: input.body.length, ship_anyway: input.ship_anyway === true }, "tightener dispatch");
-    const result = await runClaude({
-        tier,
-        prompt: userPrompt,
-        system: TIGHTENER_SYSTEM_PROMPT,
-        jsonSchema: TIGHTENER_OUTPUT_SCHEMA,
-        timeoutMs: 300_000,
-    });
-    if (!isOutput(result.parsed)) {
-        throw new Error(`tightener returned malformed output (no parsed). preview: ${result.text.slice(0, 200)}`);
-    }
-    const output = result.parsed;
-    const ready = input.ship_anyway === true ||
-        (output.ready_to_execute === true && output.spec_quality_score >= DEFAULT_QUALITY_FLOOR);
-    return {
-        output,
-        tier,
-        ready,
-        quality_floor: DEFAULT_QUALITY_FLOOR,
-        duration_ms: result.durationMs,
-        ...(result.usage !== undefined
-            ? {
-                usage: {
-                    ...(result.usage.input_tokens !== undefined
-                        ? { input_tokens: result.usage.input_tokens }
-                        : {}),
-                    ...(result.usage.output_tokens !== undefined
-                        ? { output_tokens: result.usage.output_tokens }
-                        : {}),
-                },
-            }
-            : {}),
-    };
-}
-//# sourceMappingURL=tighten.js.map

package/dist/tightener/tighten.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tighten.js","sourceRoot":"","sources":["../../src/tightener/tighten.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGtD,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAEhC,uEAAuE;AACvE,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,4EAA4E;AAC5E,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEhC,SAAS,UAAU,CAAC,KAAqB;IACvC,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,UAAU,CAAC;IAC5D,MAAM,SAAS,GAAG,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACrF,OAAO,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;AACzD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAC/B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC7B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;QACtC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAClC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC;QACzC,OAAO,CAAC,CAAC,oBAAoB,CAAC,KAAK,QAAQ;QAC3C,OAAO,CAAC,CAAC,kBAAkB,CAAC,KAAK,SAAS;QAC1C,OAAO,CAAC,CAAC,yBAAyB,CAAC,KAAK,QAAQ,CACjD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAqB;IACrD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEnD,GAAG,CAAC,IAAI,CACN,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,KAAK,IAAI,EAAE,EAC9E,oBAAoB,CACrB,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC;QAC7B,IAAI;QACJ,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,uBAAuB;QAC/B,UAAU,EAAE,uBAAiC;QAC7C,SAAS,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,6DAA6D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,KAAK,GACT,KAAK,CAAC,WAAW,KAAK,IAAI;QAC1B,CAAC,MAAM,CAAC,gBAAgB,KAAK,IAAI,IAAI,MAAM,CAAC,kBAAkB,IAAI,qBAAqB,CAAC,CAAC;IAE3F,OAAO;QACL,MAAM;QACN,IAAI;QACJ,KAAK;QACL,aAAa,EAAE,qBAAqB;QACpC,WAAW,EAAE,MAAM,CAAC,UAAU;QAC9B,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS;YAC5B,CAAC,CAAC;gBACE,KAAK,EAAE;oBACL,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS;wBACzC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE;wBAC7C,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS;wBAC1C,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE;wBAC/C,CAAC,CAAC,EAAE,CAAC;iBACR;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC"}

package/dist/tightener/types.d.ts

@@ -1,74 +0,0 @@
-/**
- * Spec tightener (Layer F) per `docs/PRIMER.md` §10. Single Tier-1 (Haiku)
- * call before any code is written.
- */
-export interface Ambiguity {
-    /** Stable id within this tightener call (e.g. "Q1"). */
-    id: string;
-    question: string;
-    /** Concrete A/B/C/D candidate resolutions; empty when caller must free-text. */
-    candidate_resolutions: string[];
-}
-export interface TightenerOutput {
-    ambiguities: Ambiguity[];
-    conflicts: string[];
-    missing_acceptance: string[];
-    scope_concerns: string[];
-    existing_stub_overlap: string[];
-    /** 0-10 integer; >= 7 AND ready_to_execute → safe to dispatch. */
-    spec_quality_score: number;
-    ready_to_execute: boolean;
-    /**
-     * The model's proposed tightened version of the spec body. Must always
-     * be set so callers have a fallback when ambiguities exist (the proposal
-     * uses the most defensible default per L44).
-     */
-    tightened_spec_proposal: string;
-}
-export interface TightenerInput {
-    title: string;
-    body: string;
-    /** Recent decisions in scope (id + summary). Loaded from MCP by caller. */
-    decisions_in_scope?: {
-        id: string;
-        title: string;
-        summary: string;
-    }[];
-    /** Invariants in scope (id + title). Loaded from MCP by caller. */
-    invariants_in_scope?: {
-        id: string;
-        title: string;
-    }[];
-    /** Ground extracts in scope (key + content snippet). */
-    ground_extracts?: {
-        key: string;
-        snippet: string;
-    }[];
-    /** Existing stubs/TODOs the agent may step on. */
-    existing_stubs?: string[];
-    /** Operator override per L24: ship even when score below threshold. */
-    ship_anyway?: boolean;
-    /**
-     * Force a specific tier instead of the body-length heuristic. Useful for
-     * smoke tests and for operators who know they want Sonnet on a touchy
-     * spec without rewriting it to trip the auto-escalate threshold.
-     */
-    force_tier?: "haiku" | "sonnet";
-}
-export interface TightenerResult {
-    /** Raw tightener output as returned by the model. */
-    output: TightenerOutput;
-    /** Tier actually used (auto-escalated if body length tripped the threshold). */
-    tier: "haiku" | "sonnet";
-    /** True when the gate passes: score >= floor AND ready_to_execute, OR ship_anyway. */
-    ready: boolean;
-    /** Quality floor used to compute `ready`. Default 7 per workflow.md `spec_quality_floor`. */
-    quality_floor: number;
-    /** Wall-clock duration of the model call. */
-    duration_ms: number;
-    /** Token usage if reported by the CLI. */
-    usage?: {
-        input_tokens?: number;
-        output_tokens?: number;
-    };
-}

package/dist/tightener/types.js

@@ -1,6 +0,0 @@
-/**
- * Spec tightener (Layer F) per `docs/PRIMER.md` §10. Single Tier-1 (Haiku)
- * call before any code is written.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/tightener/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tightener/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/templates/.claude/settings.json

@@ -1,57 +0,0 @@
-{
-  "statusLine": {
-    "type": "command",
-    "command": "cairn status-line"
-  },
-  "hooks": {
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cairn hook session-start"
-          }
-        ]
-      }
-    ],
-    "SessionEnd": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cairn hook session-end"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Read",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cairn hook read-enrich"
-          }
-        ]
-      },
-      {
-        "matcher": "Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cairn hook write-guard"
-          }
-        ]
-      },
-      {
-        "matcher": "Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cairn hook write-guard"
-          }
-        ]
-      }
-    ]
-  }
-}

package/templates/.mcp.json

@@ -1,8 +0,0 @@
-{
-  "mcpServers": {
-    "cairn": {
-      "command": "cairn",
-      "args": ["mcp", "serve"]
-    }
-  }
-}

package/templates/README.md

@@ -1,24 +0,0 @@
-# `templates/` — files the init script copies into adopted projects
-
-This directory ships with the `@isaacriehm/cairn` npm package. It is the seed for `.cairn/` and `.archive/` inside any project that runs:
-
-```sh
-npx @isaacriehm/cairn init <repo-dir>
-```
-
-Layout mirrors `docs/FILESYSTEM_LAYOUT.md`. The init script:
-
-1. Copies `templates/.cairn/config/*` into `<repo-dir>/.cairn/config/` (preserving the `<project_name>:` placeholder; the script then replaces it with the adopting project's package name).
-2. Copies `templates/.cairn/ground/manifest.yaml` (empty stub; daemon populates).
-3. Copies `templates/.archive/README.md` into `<repo-dir>/.archive/`.
-4. Creates the runtime directories (`runs/`, `inbox/`, `transcripts/`, `tasks/`, `staleness/`, `ground/{decisions,invariants,canonical-map,schema,routes,events}/`) and adds them to the project's `.gitignore` per spec §9.
-
-This directory is **NOT** Cairn's own state. The Cairn package source repo is not self-hosted; it is the source for the published npm package.
-
-## Why placeholders?
-
-The `<project_name>:` block in `templates/.cairn/config/workflow.md` is a placeholder by design. The init script reads the adopting project's `package.json name` (or directory name as fallback), normalizes it (lowercase, non-alphanumerics → underscores), and replaces every occurrence of `<project_name>` in the copied file. Cairn package code reads the project block at runtime via `Object.keys()` lookup — never by hardcoded project name (per L50, operator answer S1).
-
-## Editing templates
-
-Templates are the single source of seed configuration. Changes here flow to every freshly-adopted project on next `npx @isaacriehm/cairn init`. Existing adoptions are unaffected — they own their copies.