@slowcook-ai/cli 0.25.0 → 0.28.0

package/dist/commands/extract/as-built-cli.js

@@ -0,0 +1,67 @@
+/** CLI half of `extract --as-built` — wires the survey + dossier + LLM +
+ *  citation validator together and owns process exit semantics. Kept apart
+ *  from as-built.ts so the core stays pure for tests. */
+import { readdirSync, statSync, writeFileSync } from "node:fs";
+import { join, relative } from "node:path";
+import { createLlmClient } from "../refine/llm.js";
+import { buildDossier, generateAsBuilt, validateCitations, validateSections } from "./as-built.js";
+export const DEFAULT_MODEL = "claude-opus-4-8";
+function walk(dir, root, acc = []) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return acc;
+    }
+    for (const name of entries) {
+        if (name === "node_modules" || name === ".git" || name === "dist")
+            continue;
+        const full = join(dir, name);
+        let st;
+        try {
+            st = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (st.isDirectory())
+            walk(full, root, acc);
+        else
+            acc.push(relative(root, full).replace(/\\/g, "/"));
+    }
+    return acc;
+}
+export async function runAsBuiltCli(repoRoot, survey, opts) {
+    let llm;
+    try {
+        llm = await createLlmClient();
+    }
+    catch (err) {
+        console.error(`extract --as-built: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    const paths = walk(repoRoot, repoRoot);
+    const dossier = buildDossier(repoRoot, survey, paths);
+    console.log(`extract --as-built: dossier holds ${dossier.filesIncluded.length} files + survey (${survey.claims.length} claims); calling the model…`);
+    const { md } = await generateAsBuilt(llm, opts.model ?? DEFAULT_MODEL, dossier);
+    const missing = validateSections(md);
+    if (missing.length > 0) {
+        console.error(`extract --as-built: output is missing required section(s): ${missing.join(", ")} — not writing.`);
+        process.exit(1);
+    }
+    const cites = validateCitations(md);
+    if (cites.uncited.length > 0 && !opts.allowUncited) {
+        console.error(`extract --as-built: ${cites.uncited.length}/${cites.bullets} bullets carry NO citation — an uncited claim is a guess. Offenders:`);
+        for (const u of cites.uncited.slice(0, 10))
+            console.error(`  · ${u}`);
+        console.error(`Re-run, or accept with --allow-uncited (the doc will keep an UNCITED marker).`);
+        process.exit(1);
+    }
+    const banner = `> Generated by \`slowcook extract --as-built\` from ${survey.repo_head ?? "HEAD"} on ${survey.generated_at.slice(0, 10)}. Code-as-truth, as observed; regenerate when main moves.${cites.uncited.length > 0 ? ` ⚠ ${cites.uncited.length} UNCITED bullet(s) accepted via --allow-uncited.` : ""}\n\n`;
+    const withBanner = md.replace(/^(# .+\n)/, `$1\n${banner}`);
+    const file = join(repoRoot, ".brewing", "as-built.md");
+    writeFileSync(file, withBanner, "utf8");
+    console.log(`Wrote ${file} (${cites.bullets} cited bullets, ${md.split("\n## ").length - 1} sections).`);
+}
+//# sourceMappingURL=as-built-cli.js.map

package/dist/commands/extract/as-built-cli.js.map

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

package/dist/commands/extract/as-built.d.ts

@@ -0,0 +1,21 @@
+import type { LlmClient } from "@slowcook-ai/core";
+import type { SurveyOutput } from "./survey.js";
+export declare const AS_BUILT_SYSTEM = "You are slowcook's brownfield extraction agent. You produce AS-BUILT\ndocumentation of an EXISTING product from its repository: what IS, as\nobserved in the code \u2014 never what docs promise, never invented intent.\n\nRules, non-negotiable:\n- Output ONLY the markdown document, no preamble.\n- Structure EXACTLY: a single \"# <repo name> \u2014 as-built\" title line, then the\n  sections \"## What the product is\", \"## Map\", \"## Data model (as-built)\",\n  \"## Honesty notes\", \"## Founder questions (intake queue)\".\n- Every bullet in every section EXCEPT the questions section MUST end with a\n  citation in parentheses naming the file(s) it was observed in, e.g.\n  (src/lib/emotions/index.ts:1-14) or (supabase/migrations/00013.sql). No\n  citation = the bullet will be rejected by a validator.\n- When repo documents CONTRADICT the code, the code is truth: state the code's\n  behaviour and flag the contradiction in \"Honesty notes\" citing both sides.\n- \"Founder questions\" = numbered questions only a human can answer (unclear\n  intent, missing infra facts, dead features to rule on). No citations needed.\n- Be dense and specific. 40-70 bullets total. Never pad, never speculate \u2014\n  what you cannot see, you either omit or turn into a founder question.";
+export interface Dossier {
+    userPrompt: string;
+    filesIncluded: string[];
+}
+/** assemble the model's evidence pack: survey + key files (truncated) + route inventory. */
+export declare function buildDossier(repoRoot: string, survey: SurveyOutput, allPaths: string[]): Dossier;
+export interface CitationReport {
+    bullets: number;
+    uncited: string[];
+}
+/** deterministic post-check: bullets outside the questions section need (path…) citations. */
+export declare function validateCitations(md: string): CitationReport;
+export declare function validateSections(md: string): string[];
+export declare function generateAsBuilt(llm: LlmClient, model: string, dossier: Dossier): Promise<{
+    md: string;
+    usage: unknown;
+}>;
+//# sourceMappingURL=as-built.d.ts.map

package/dist/commands/extract/as-built.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-built.d.ts","sourceRoot":"","sources":["../../../src/commands/extract/as-built.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,eAAe,uwCAkB4C,CAAC;AAEzE,MAAM,WAAW,OAAO;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE;AAWxE,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAsBhG;AAED,MAAM,WAAW,cAAc;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE;AAEtE,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAmB5D;AAID,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAErD;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAWzC"}

package/dist/commands/extract/as-built.js

@@ -0,0 +1,113 @@
+/**
+ * `slowcook extract --as-built` — tier 1 of #262: the LLM pass that turns an
+ * existing repo into `.brewing/as-built.md`: what the product IS, as observed,
+ * every statement citing its source. Section contract mirrors the hand-made
+ * originals (dash's brownfield intake ingests these sections directly):
+ *
+ *   ## What the product is
+ *   ## Map
+ *   ## Data model (as-built)
+ *   ## Honesty notes            (docs-vs-code lies, stubs, dead features)
+ *   ## Founder questions (intake queue)
+ *
+ * CITATION DISCIPLINE is enforced deterministically after generation: every
+ * bullet outside the questions section must carry a `(path[:line…])` citation;
+ * violations are reported and the run fails without --allow-uncited. This is
+ * verify-before-spec's foundation — an uncited claim is a guess.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+export const AS_BUILT_SYSTEM = `You are slowcook's brownfield extraction agent. You produce AS-BUILT
+documentation of an EXISTING product from its repository: what IS, as
+observed in the code — never what docs promise, never invented intent.
+
+Rules, non-negotiable:
+- Output ONLY the markdown document, no preamble.
+- Structure EXACTLY: a single "# <repo name> — as-built" title line, then the
+  sections "## What the product is", "## Map", "## Data model (as-built)",
+  "## Honesty notes", "## Founder questions (intake queue)".
+- Every bullet in every section EXCEPT the questions section MUST end with a
+  citation in parentheses naming the file(s) it was observed in, e.g.
+  (src/lib/emotions/index.ts:1-14) or (supabase/migrations/00013.sql). No
+  citation = the bullet will be rejected by a validator.
+- When repo documents CONTRADICT the code, the code is truth: state the code's
+  behaviour and flag the contradiction in "Honesty notes" citing both sides.
+- "Founder questions" = numbered questions only a human can answer (unclear
+  intent, missing infra facts, dead features to rule on). No citations needed.
+- Be dense and specific. 40-70 bullets total. Never pad, never speculate —
+  what you cannot see, you either omit or turn into a founder question.`;
+const KEY_DOC = /^(readme|claude)\.md$/i;
+const INTERESTING = [
+    /^docs\/[^/]+\.md$/i,
+    /^(package|pnpm-workspace|foundry|cargo|go)\.(json|yaml|toml|mod)$/i,
+    /migrations?\/[^/]+\.(sql|ts|js)$/i,
+    /schema[^/]*\.(ts|sql|prisma)$/i,
+];
+const ROUTEISH = /(app|pages|routes|src\/app)\/.*\.(tsx?|jsx?|vue|svelte)$/i;
+/** assemble the model's evidence pack: survey + key files (truncated) + route inventory. */
+export function buildDossier(repoRoot, survey, allPaths) {
+    const parts = [];
+    const included = [];
+    parts.push(`# Deterministic survey (tier 0)\n${JSON.stringify({ repo_head: survey.repo_head, claims: survey.claims.map((c) => c.statement), skipped: survey.skipped }, null, 1)}`);
+    const read = (p, cap) => {
+        try {
+            const body = readFileSync(join(repoRoot, p), "utf8");
+            included.push(p);
+            parts.push(`\n===== FILE: ${p} =====\n${body.slice(0, cap)}${body.length > cap ? "\n…(truncated)" : ""}`);
+        }
+        catch { /* unreadable */ }
+    };
+    for (const p of allPaths)
+        if (KEY_DOC.test(p))
+            read(p, 6000);
+    for (const p of allPaths.filter((p) => INTERESTING.some((re) => re.test(p))).sort().slice(0, 25))
+        read(p, 4000);
+    const routes = allPaths.filter((p) => ROUTEISH.test(p) && !/test|spec|stories/.test(p)).sort().slice(0, 120);
+    parts.push(`\n===== ROUTE/SURFACE FILE INVENTORY (${routes.length}) =====\n${routes.join("\n")}`);
+    // a few route files in full — the product's actual behaviour lives here.
+    for (const p of routes.filter((p) => /route\.|page\.|index\./i.test(p)).slice(0, 8))
+        read(p, 3000);
+    return { userPrompt: parts.join("\n"), filesIncluded: included };
+}
+/** deterministic post-check: bullets outside the questions section need (path…) citations. */
+export function validateCitations(md) {
+    const lines = md.split("\n");
+    let inQuestions = false;
+    let bullets = 0;
+    const uncited = [];
+    for (const l of lines) {
+        if (/^##\s/.test(l))
+            inQuestions = /founder questions/i.test(l);
+        if (inQuestions)
+            continue;
+        const t = l.trim();
+        if (!/^[-*]\s/.test(t))
+            continue;
+        bullets++;
+        // a citation is a paren group naming a path or file — allowing ONE level
+        // of nested parens because real paths contain them (Next.js route groups
+        // like src/app/(landing)/page.tsx — found by the rewo dogfood).
+        const groups = t.match(/\((?:[^()]|\([^()]*\))*\)/g) ?? [];
+        const cited = groups.some((g) => /[\w)\].-]\/[\w(.-]/.test(g) || /\.(ts|tsx|js|jsx|sql|md|mdx|ya?ml|toml|json|sol|py|go|rs|css|prisma)\b/.test(g));
+        if (!cited)
+            uncited.push(t.slice(0, 110));
+    }
+    return { bullets, uncited };
+}
+const REQUIRED_SECTIONS = ["## What the product is", "## Map", "## Data model (as-built)", "## Honesty notes", "## Founder questions (intake queue)"];
+export function validateSections(md) {
+    return REQUIRED_SECTIONS.filter((s) => !md.includes(s));
+}
+export async function generateAsBuilt(llm, model, dossier) {
+    const res = await llm.complete({
+        system: AS_BUILT_SYSTEM,
+        cacheSystem: false,
+        model,
+        messages: [{ role: "user", content: dossier.userPrompt }],
+        maxTokens: 16000,
+    });
+    // strip accidental fences
+    const md = res.text.replace(/^```(?:markdown|md)?\n/, "").replace(/\n```\s*$/, "").trim() + "\n";
+    return { md, usage: res.usage };
+}
+//# sourceMappingURL=as-built.js.map

package/dist/commands/extract/as-built.js.map

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

package/dist/commands/extract/history-cli.d.ts

@@ -0,0 +1,6 @@
+import { type HistoryExcerpt } from "./history.js";
+export declare function buildHistoryPrompt(excerpts: HistoryExcerpt[]): string;
+export declare function runHistoryCli(repoRoot: string, opts: {
+    model: string | null;
+}): Promise<void>;
+//# sourceMappingURL=history-cli.d.ts.map

package/dist/commands/extract/history-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-cli.d.ts","sourceRoot":"","sources":["../../../src/commands/extract/history-cli.ts"],"names":[],"mappings":"AASA,OAAO,EAEW,KAAK,cAAc,EACpC,MAAM,cAAc,CAAC;AAEtB,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAGrE;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CnG"}

package/dist/commands/extract/history-cli.js

@@ -0,0 +1,58 @@
+/**
+ * CLI runner for `slowcook extract --history` — gather build-history excerpts
+ * via ctx, one LLM pass to distill claims (citation-enforced against real
+ * session ids), write `.brewing/extract-history.json` in the survey shape.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { createLlmClient } from "../refine/llm.js";
+import { DEFAULT_MODEL } from "./as-built-cli.js";
+import { gatherHistory, parseHistoryClaims, toSurveyShape, historyOutputPath, HISTORY_SYSTEM, } from "./history.js";
+export function buildHistoryPrompt(excerpts) {
+    return "Build-history excerpts (each: [kind-hint | session | date] text):\n\n" +
+        excerpts.map((e) => `[${e.kind} | ${e.sessionId} | ${(e.timestamp ?? "").slice(0, 10)}]\n${e.snippet}`).join("\n\n");
+}
+export async function runHistoryCli(repoRoot, opts) {
+    const { workspace, excerpts } = gatherHistory(repoRoot);
+    if (excerpts.length === 0) {
+        // honest degradation — this repo wasn't built (here) with indexed agents.
+        console.log("extract --history: no build history found for this repo in the local ctx index.");
+        console.log("  (needs ctxrs/ctx installed + `ctx setup`, and the repo built with a coding agent on THIS machine)");
+        return;
+    }
+    console.log(`extract --history: ${excerpts.length} excerpt(s) from build sessions (workspace: ${workspace}); distilling…`);
+    let llm;
+    try {
+        llm = await createLlmClient();
+    }
+    catch (err) {
+        console.error(`extract --history: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    const res = await llm.complete({
+        system: HISTORY_SYSTEM,
+        cacheSystem: false,
+        model: opts.model ?? DEFAULT_MODEL,
+        messages: [{ role: "user", content: buildHistoryPrompt(excerpts) }],
+        maxTokens: 8000,
+    });
+    const validSessions = new Set(excerpts.map((e) => e.sessionId));
+    const claims = parseHistoryClaims(res.text, validSessions);
+    if (claims.length === 0) {
+        console.log("extract --history: the model distilled no citable claims from the excerpts — nothing written.");
+        return;
+    }
+    const out = {
+        generated_by: "slowcook extract --history",
+        workspace,
+        excerpts_seen: excerpts.length,
+        claims: toSurveyShape(claims),
+    };
+    const path = historyOutputPath(repoRoot);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(out, null, 2) + "\n");
+    const byKind = claims.reduce((m, c) => ((m[c.kind] = (m[c.kind] ?? 0) + 1), m), {});
+    console.log(`extract --history: wrote ${claims.length} claim(s) → ${path}`);
+    console.log(`  ${Object.entries(byKind).map(([k, n]) => `${k}: ${n}`).join(" · ")}`);
+}
+//# sourceMappingURL=history-cli.js.map

package/dist/commands/extract/history-cli.js.map

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

package/dist/commands/extract/history.d.ts

@@ -0,0 +1,42 @@
+import { type CtxRunner } from "../recall/ctx.js";
+/** claude code stores transcripts under ~/.claude/projects/<path-with-dashes>;
+ *  ctx records THAT as the workspace. Map a repo root to candidate workspaces. */
+export declare function workspaceCandidates(repoRoot: string, home?: string): string[];
+/** themed probes — SHORT queries, several per theme: ctx's ranked match wants
+ *  most words present, so long keyword soups zero out on a workspace-filtered
+ *  subset. Short probes hit; the merge dedupes. */
+export declare const HISTORY_THEMES: {
+    kind: string;
+    probes: string[];
+}[];
+export interface HistoryExcerpt {
+    kind: string;
+    sessionId: string;
+    timestamp?: string;
+    snippet: string;
+}
+/** search the build history per theme; dedupe by (session, snippet-prefix). */
+export declare function gatherHistory(repoRoot: string, run?: CtxRunner, limitPerTheme?: number): {
+    workspace: string | null;
+    excerpts: HistoryExcerpt[];
+};
+export declare const HISTORY_SYSTEM = "You are slowcook's build-history archaeologist. The excerpts below come\nfrom the CODING-AGENT SESSIONS THAT BUILT this repository \u2014 the discussions\nwhere decisions were made, approaches were tried and abandoned, and bugs were\ndiscovered. Each excerpt is tagged with a candidate kind and its session id.\n\nExtract the durable knowledge: statements a newcomer (or a product intake)\nshould know that the CODE ITSELF does not say. For each, output:\n- kind: \"decision\" | \"rejected_approach\" | \"known_issue\" | \"constraint\"\n- statement: one clear sentence, past tense for history (\"X was tried and\n  reverted because Y\"), present for standing facts.\n- session: the session id of the excerpt(s) you drew it from (REQUIRED \u2014\n  uncited claims are dropped).\n- when: the excerpt's date (YYYY-MM-DD) if present.\n\nRules: only what the excerpts actually support \u2014 no invention, no padding.\nMerge duplicates. Skip excerpts that are just command output or pleasantries.\nOutput STRICT JSON only: {\"claims\":[{\"kind\":\"...\",\"statement\":\"...\",\"session\":\"...\",\"when\":\"...\"}]}";
+export interface HistoryClaim {
+    kind: string;
+    statement: string;
+    session: string;
+    when?: string;
+}
+/** validate + citation-enforce the model's output against real session ids. */
+export declare function parseHistoryClaims(text: string, validSessions: Set<string>): HistoryClaim[];
+/** survey-claim-shaped output, so dash's knowledge sync ingests it as-is. */
+export declare function toSurveyShape(claims: HistoryClaim[]): {
+    source: string;
+    area: string;
+    statement: string;
+    status: string;
+    evidence: Record<string, unknown>;
+}[];
+export declare function historyOutputPath(repoRoot: string): string;
+export declare function brewingDirExists(repoRoot: string): boolean;
+//# sourceMappingURL=history.d.ts.map

package/dist/commands/extract/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/commands/extract/history.ts"],"names":[],"mappings":"AAkBA,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE3F;kFACkF;AAClF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,EAAE,CAIxF;AAED;;mDAEmD;AACnD,eAAO,MAAM,cAAc,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,EAK9D,CAAC;AAEF,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAExG,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,aAAa,SAAI,GAAG;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,CAqB5I;AAED,eAAO,MAAM,cAAc,2lCAgByE,CAAC;AAErG,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAEjG,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,YAAY,EAAE,CAY3F;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG;IACrD,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpG,EAAE,CAWF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/commands/extract/history.js

@@ -0,0 +1,114 @@
+/**
+ * `slowcook extract --history` — tier 1.5 — mine the AGENT SESSIONS THAT BUILT
+ * this repo for the knowledge no other source carries: design decisions,
+ * REJECTED approaches ("tried X, it deadlocked, so Y"), known issues, and
+ * constraints. The code shows what IS; the build history shows WHY.
+ *
+ * Source: the local ctx index (ctxrs/ctx, Apache-2.0 — see `slowcook recall`),
+ * searched per theme over MESSAGE events (decisions live in messages, not
+ * command echoes). Only works where the histories live — the builder's own
+ * machine — so it's opt-in and degrades honestly: "no build history found".
+ *
+ * Output: `.brewing/extract-history.json`, survey-claim-shaped so consumers
+ * (dash's knowledge sync) ingest it exactly like `--survey` output — every
+ * claim cites its session id (inspect with `ctx show session <id>`).
+ */
+import { homedir } from "node:os";
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { ctxAvailable, ctxSearch } from "../recall/ctx.js";
+/** claude code stores transcripts under ~/.claude/projects/<path-with-dashes>;
+ *  ctx records THAT as the workspace. Map a repo root to candidate workspaces. */
+export function workspaceCandidates(repoRoot, home = homedir()) {
+    const abs = resolve(repoRoot);
+    const dashed = abs.replace(/\//g, "-"); // "/a/b" → "-a-b"
+    return [abs, join(home, ".claude", "projects", dashed)];
+}
+/** themed probes — SHORT queries, several per theme: ctx's ranked match wants
+ *  most words present, so long keyword soups zero out on a workspace-filtered
+ *  subset. Short probes hit; the merge dedupes. */
+export const HISTORY_THEMES = [
+    { kind: "decision", probes: ["decided", "chose instead", "architecture decision", "settled on"] },
+    { kind: "rejected_approach", probes: ["reverted", "abandoned", "didn't work", "failed approach", "dead end"] },
+    { kind: "known_issue", probes: ["known bug", "workaround", "flaky", "still broken"] },
+    { kind: "constraint", probes: ["invariant", "must never", "hard requirement", "by design"] },
+];
+/** search the build history per theme; dedupe by (session, snippet-prefix). */
+export function gatherHistory(repoRoot, run, limitPerTheme = 6) {
+    if (!ctxAvailable(run))
+        return { workspace: null, excerpts: [] };
+    for (const ws of workspaceCandidates(repoRoot)) {
+        // the transcript-dir candidate may exist even when ctx has nothing for the
+        // repo path itself; probe each until one yields results.
+        const all = [];
+        const seen = new Set();
+        for (const theme of HISTORY_THEMES) {
+            for (const probe of theme.probes) {
+                const results = ctxSearch({ query: probe, workspace: ws, limit: limitPerTheme }, run);
+                for (const r of results) {
+                    const key = `${r.sessionId}:${r.snippet.slice(0, 60)}`;
+                    if (seen.has(key))
+                        continue;
+                    seen.add(key);
+                    all.push({ kind: theme.kind, sessionId: r.sessionId, timestamp: r.timestamp, snippet: r.snippet });
+                }
+            }
+        }
+        if (all.length > 0)
+            return { workspace: ws, excerpts: all };
+    }
+    return { workspace: null, excerpts: [] };
+}
+export const HISTORY_SYSTEM = `You are slowcook's build-history archaeologist. The excerpts below come
+from the CODING-AGENT SESSIONS THAT BUILT this repository — the discussions
+where decisions were made, approaches were tried and abandoned, and bugs were
+discovered. Each excerpt is tagged with a candidate kind and its session id.
+
+Extract the durable knowledge: statements a newcomer (or a product intake)
+should know that the CODE ITSELF does not say. For each, output:
+- kind: "decision" | "rejected_approach" | "known_issue" | "constraint"
+- statement: one clear sentence, past tense for history ("X was tried and
+  reverted because Y"), present for standing facts.
+- session: the session id of the excerpt(s) you drew it from (REQUIRED —
+  uncited claims are dropped).
+- when: the excerpt's date (YYYY-MM-DD) if present.
+
+Rules: only what the excerpts actually support — no invention, no padding.
+Merge duplicates. Skip excerpts that are just command output or pleasantries.
+Output STRICT JSON only: {"claims":[{"kind":"...","statement":"...","session":"...","when":"..."}]}`;
+/** validate + citation-enforce the model's output against real session ids. */
+export function parseHistoryClaims(text, validSessions) {
+    const body = text.replace(/^```(?:json)?\s*/i, "").replace(/```\s*$/i, "").trim();
+    const a = body.indexOf("{"), b = body.lastIndexOf("}");
+    if (a < 0 || b < 0)
+        return [];
+    try {
+        const parsed = JSON.parse(body.slice(a, b + 1));
+        return (parsed.claims ?? []).filter((c) => typeof c.statement === "string" && c.statement.length > 10 &&
+            ["decision", "rejected_approach", "known_issue", "constraint"].includes(c.kind) &&
+            typeof c.session === "string" && validSessions.has(c.session));
+    }
+    catch {
+        return [];
+    }
+}
+/** survey-claim-shaped output, so dash's knowledge sync ingests it as-is. */
+export function toSurveyShape(claims) {
+    return claims.map((c) => ({
+        source: "build_history",
+        area: c.kind === "known_issue" ? "quality" : "architecture",
+        statement: c.statement,
+        // rejected approaches + decisions are testimony from the builder's own
+        // sessions — verified-grade provenance; known issues stay unverified
+        // (they may have been fixed since).
+        status: c.kind === "known_issue" ? "unverified" : "verified",
+        evidence: { kind: `history-${c.kind}`, session: c.session, when: c.when ?? null, inspect: `ctx show session ${c.session}` },
+    }));
+}
+export function historyOutputPath(repoRoot) {
+    return join(repoRoot, ".brewing", "extract-history.json");
+}
+export function brewingDirExists(repoRoot) {
+    return existsSync(join(repoRoot, ".brewing"));
+}
+//# sourceMappingURL=history.js.map

package/dist/commands/extract/history.js.map

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

package/dist/commands/extract/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/extract/index.ts"],"names":[],"mappings":"AA4GA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/extract/index.ts"],"names":[],"mappings":"AAsJA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDhF"}

package/dist/commands/extract/index.js

@@ -1,10 +1,18 @@
 import { emitSchemaDiagram, emitTokensCatalog, emitEntitiesDiagram, } from "../map/index.js";
+import { runSurvey, writeSurvey } from "./survey.js";
+import { runAsBuiltCli } from "./as-built-cli.js";
+import { runHistoryCli } from "./history-cli.js";
 function parseArgs(argv) {
     const args = {
         repoRoot: process.cwd(),
         schema: false,
         tokens: false,
         entities: false,
+        survey: false,
+        asBuilt: false,
+        history: false,
+        allowUncited: false,
+        model: null,
     };
     let any = false;
     for (let i = 0; i < argv.length; i++) {
@@ -26,6 +34,24 @@ function parseArgs(argv) {
             args.entities = true;
             any = true;
         }
+        else if (a === "--survey") {
+            args.survey = true;
+            any = true;
+        }
+        else if (a === "--as-built") {
+            args.asBuilt = true;
+        }
+        else if (a === "--history") {
+            args.history = true;
+            any = true;
+        }
+        else if (a === "--allow-uncited") {
+            args.allowUncited = true;
+        }
+        else if (a === "--model" && next) {
+            args.model = next;
+            i++;
+        }
         else if (a === "--help" || a === "-h") {
             printHelp();
             process.exit(0);
@@ -54,10 +80,14 @@ investigate so their proposals align with the project's existing
 schema + design tokens instead of inventing.
 
 Usage:
-  slowcook extract [--schema] [--tokens] [--cwd <path>]
+  slowcook extract [--schema] [--tokens] [--entities] [--cwd <path>]
+  slowcook extract --survey   [--cwd <path>]
+  slowcook extract --as-built [--cwd <path>] [--model <id>] [--allow-uncited]
+  slowcook extract --history  [--cwd <path>] [--model <id>]   # mine the agent sessions that BUILT this repo (via ctxrs/ctx)
 
-  No flag = extract everything (currently --schema + --tokens).
-  Outputs are gitignored; regenerate per refine run.
+  No flag = the diagram extracts (--schema + --tokens + --entities).
+  Diagram outputs are gitignored; regenerate per refine run.
+  --survey / --as-built outputs are INTAKE ARTIFACTS — commit them.
 
 Targets:
   --schema    .brewing/diagrams/schema.mmd
@@ -75,12 +105,42 @@ Targets:
               by default; the init gitignore template carves out an
               exception for this file.
 
+  --survey    .brewing/extract-survey.json (#262 tier 0 — deterministic).
+              Doc catalog dated via git (stale-honest), story-spec
+              aggregate, commit/branch evidence, issues/PRs via gh when
+              available. Entries are knowledge-claim shaped for direct
+              ingestion by §7.18-style intakes.
+  --as-built  .brewing/as-built.md (#262 tier 1 — LLM, key-less capable
+              via SLOWCOOK_LLM=claude-cli). AS-OBSERVED product truth in
+              five fixed sections; every bullet must carry a (path)
+              citation — enforced by a validator; founder questions
+              close the doc. Fails on uncited bullets unless
+              --allow-uncited.
+
 This command does NOT run the ts-morph code-map scan; for that,
 use \`slowcook map generate\`.
 `);
 }
 export async function extract(argv, _cliVersion) {
     const args = parseArgs(argv);
+    if (args.survey || args.asBuilt || args.history) {
+        if (args.survey || args.asBuilt) {
+            const survey = runSurvey(args.repoRoot);
+            if (args.survey) {
+                const file = writeSurvey(args.repoRoot, survey);
+                console.log(`Wrote ${file} (${survey.claims.length} claims${survey.skipped.length ? `; skipped: ${survey.skipped.join("; ")}` : ""}).`);
+            }
+            if (args.asBuilt) {
+                await runAsBuiltCli(args.repoRoot, survey, { model: args.model, allowUncited: args.allowUncited });
+            }
+        }
+        if (args.history) {
+            // tier 1.5 — the agent sessions that BUILT the repo (opt-in; degrades
+            // honestly when no local build history exists).
+            await runHistoryCli(args.repoRoot, { model: args.model });
+        }
+        return;
+    }
     if (args.schema) {
         const r = emitSchemaDiagram(args.repoRoot);
         if (r.written) {

package/dist/commands/extract/index.js.map

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

package/dist/commands/extract/survey.d.ts

@@ -0,0 +1,17 @@
+export interface SurveyClaim {
+    source: "doc" | "extraction";
+    area: "product" | "behaviour" | "brand" | "architecture" | "data";
+    statement: string;
+    status: "unverified" | "verified";
+    evidence: Record<string, unknown>;
+    doc_name?: string;
+}
+export interface SurveyOutput {
+    generated_at: string;
+    repo_head: string | null;
+    claims: SurveyClaim[];
+    skipped: string[];
+}
+export declare function runSurvey(repoRoot: string, now?: Date): SurveyOutput;
+export declare function writeSurvey(repoRoot: string, out: SurveyOutput): string;
+//# sourceMappingURL=survey.d.ts.map

package/dist/commands/extract/survey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"survey.d.ts","sourceRoot":"","sources":["../../../src/commands/extract/survey.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,KAAK,GAAG,YAAY,CAAC;IAC7B,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,cAAc,GAAG,MAAM,CAAC;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,GAAG,UAAU,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAmDD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,YAAY,CAmF1E;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAMvE"}