ndrstnd 0.1.0

package/dist/server/skill.js

@@ -0,0 +1,94 @@
+import { cp, mkdir, readFile, readdir, rm, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { reviewAgents, reviewAgentById } from "./agent.js";
+function bundledSkillDirectory() {
+    return join(dirname(fileURLToPath(import.meta.url)), "../../src/skill-assets/ndrstnd");
+}
+function installedSkillDirectory(agent) {
+    return join(agent.homeDirectory(), "skills", "ndrstnd");
+}
+/** True when any installed skill differs from the bundled one in any file, meaning that agent follows outdated instructions or assets. */
+export async function installedSkillIsStale() {
+    for (const agent of reviewAgents) {
+        const destination = installedSkillDirectory(agent);
+        if (!(await exists(destination)))
+            continue;
+        try {
+            const [bundled, installed] = await Promise.all([skillFiles(bundledSkillDirectory()), skillFiles(destination)]);
+            if (bundled.size !== installed.size)
+                return true;
+            for (const [path, content] of bundled) {
+                if (installed.get(path) !== content)
+                    return true;
+            }
+        }
+        catch {
+            // An unreadable installation is reported at install time, not on every review.
+        }
+    }
+    return false;
+}
+async function skillFiles(root) {
+    const files = new Map();
+    const walk = async (relative) => {
+        for (const entry of await readdir(join(root, relative), { withFileTypes: true })) {
+            const childRelative = join(relative, entry.name);
+            if (entry.isDirectory())
+                await walk(childRelative);
+            else
+                files.set(childRelative, await readFile(join(root, childRelative), "utf8"));
+        }
+    };
+    await walk(".");
+    return files;
+}
+/**
+ * Installs the bundled skill for the requested agent, or for every agent whose
+ * configuration directory exists when none is requested explicitly.
+ */
+export async function installSkill(force = false, agentId) {
+    const source = bundledSkillDirectory();
+    const targets = agentId === undefined ? await detectedAgents() : [requireAgent(agentId)];
+    if (targets.length === 0) {
+        throw new Error(`No supported agent is set up: none of ${reviewAgents.map((agent) => agent.homeDirectory()).join(", ")} exists. Install Codex or Claude Code first, or pass --agent to choose one explicitly.`);
+    }
+    const installations = [];
+    for (const agent of targets) {
+        const destination = installedSkillDirectory(agent);
+        if (!force && await exists(destination)) {
+            installations.push({ agent, destination, status: "skipped", reason: `the ndrstnd skill already exists at ${destination}; re-run with --force to replace it` });
+            continue;
+        }
+        await mkdir(dirname(destination), { recursive: true });
+        // A merge-copy would leave files a newer release removed; replace the installation wholesale.
+        await rm(destination, { recursive: true, force: true });
+        await cp(source, destination, { recursive: true, force: true });
+        installations.push({ agent, destination, status: "installed" });
+    }
+    return installations;
+}
+function requireAgent(agentId) {
+    const agent = reviewAgentById(agentId);
+    if (agent === undefined)
+        throw new Error(`Unknown analysis agent: ${agentId}.`);
+    return agent;
+}
+async function detectedAgents() {
+    const detected = [];
+    for (const agent of reviewAgents) {
+        if (await exists(agent.homeDirectory()))
+            detected.push(agent);
+    }
+    return detected;
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=skill.js.map

package/dist/server/skill.js.map

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

package/dist/server/store.d.ts

@@ -0,0 +1,36 @@
+import type { ConversationContext } from "./conversation.js";
+import { type AnalysisDocument } from "../shared/analysis-schema.js";
+import type { CollectedReviewInput } from "./git.js";
+export interface StoredReviewSession {
+    id: string;
+    repoPath: string;
+    targetRef: string;
+    baseRef: string;
+    mergeBase: string;
+    inputHash: string;
+    input: CollectedReviewInput;
+    conversation?: ConversationContext;
+    createdAt: string;
+}
+export interface AnalysisRevision {
+    id: string;
+    sessionId: string;
+    status: "partial" | "complete" | "failed";
+    source: "fallback" | "codex" | "claude";
+    document: AnalysisDocument;
+    createdAt: string;
+}
+/** True for revisions produced by a real analysis agent, excluding legacy fallback rows. */
+export declare function isAgentRevision(revision: AnalysisRevision): boolean;
+/** A cached revision may only stand in for a new analysis when the requested agent produced it and it completed. */
+export declare function selectReusableRevision(revisions: readonly AnalysisRevision[], agentId: string): AnalysisRevision | undefined;
+export declare class ReviewStore {
+    private readonly database;
+    constructor(databasePath?: string);
+    getOrCreateSession(input: CollectedReviewInput, conversation?: ConversationContext): StoredReviewSession;
+    getSession(id: string): StoredReviewSession | undefined;
+    createRevision(sessionId: string, source: AnalysisRevision["source"], status: AnalysisRevision["status"], document: AnalysisDocument): AnalysisRevision;
+    /** Rows written for another document version, or whose stored document no longer validates, read as absent so the caller re-analyzes instead of rendering a broken artifact. */
+    listRevisions(sessionId: string): AnalysisRevision[];
+    close(): void;
+}

package/dist/server/store.js

@@ -0,0 +1,134 @@
+import { createHash, randomUUID } from "node:crypto";
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import Database from "better-sqlite3";
+import { ANALYSIS_DOCUMENT_VERSION, AnalysisDocumentSchema } from "../shared/analysis-schema.js";
+/** True for revisions produced by a real analysis agent, excluding legacy fallback rows. */
+export function isAgentRevision(revision) {
+    return revision.source !== "fallback";
+}
+/** A cached revision may only stand in for a new analysis when the requested agent produced it and it completed. */
+export function selectReusableRevision(revisions, agentId) {
+    return revisions.find((revision) => revision.source === agentId && revision.status === "complete");
+}
+export class ReviewStore {
+    database;
+    constructor(databasePath = defaultDatabasePath()) {
+        mkdirSync(dirname(databasePath), { recursive: true });
+        this.database = new Database(databasePath);
+        this.database.pragma("journal_mode = WAL");
+        this.database.exec(`
+      CREATE TABLE IF NOT EXISTS review_session (
+        id TEXT PRIMARY KEY,
+        repo_path TEXT NOT NULL,
+        target_ref TEXT NOT NULL,
+        base_ref TEXT NOT NULL,
+        merge_base TEXT NOT NULL,
+        input_hash TEXT NOT NULL UNIQUE,
+        input_json TEXT NOT NULL,
+        created_at TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS analysis_revision (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL REFERENCES review_session(id),
+        status TEXT NOT NULL,
+        source TEXT NOT NULL,
+        document_json TEXT NOT NULL,
+        created_at TEXT NOT NULL
+      );
+    `);
+        const columns = this.database.prepare("PRAGMA table_info(review_session)").all();
+        if (!columns.some((column) => column.name === "conversation_json")) {
+            this.database.exec("ALTER TABLE review_session ADD COLUMN conversation_json TEXT");
+        }
+        const revisionColumns = this.database.prepare("PRAGMA table_info(analysis_revision)").all();
+        if (!revisionColumns.some((column) => column.name === "document_version")) {
+            this.database.exec("ALTER TABLE analysis_revision ADD COLUMN document_version INTEGER");
+        }
+    }
+    getOrCreateSession(input, conversation) {
+        const inputHash = hashInput(input, conversation);
+        const session = {
+            id: randomUUID(),
+            repoPath: input.repoPath,
+            targetRef: input.targetRef,
+            baseRef: input.baseRef,
+            mergeBase: input.mergeBase,
+            inputHash,
+            input,
+            conversation,
+            createdAt: new Date().toISOString(),
+        };
+        // Insert-then-select keeps concurrent reviews of the same input from racing a separate existence check into a UNIQUE violation.
+        this.database.prepare(`
+      INSERT INTO review_session (id, repo_path, target_ref, base_ref, merge_base, input_hash, input_json, conversation_json, created_at)
+      VALUES (@id, @repoPath, @targetRef, @baseRef, @mergeBase, @inputHash, @inputJson, @conversationJson, @createdAt)
+      ON CONFLICT(input_hash) DO NOTHING
+    `).run({ ...session, inputJson: JSON.stringify(input), conversationJson: conversation === undefined ? null : JSON.stringify(conversation) });
+        const row = this.database.prepare("SELECT * FROM review_session WHERE input_hash = ?").get(inputHash);
+        return deserialize(row);
+    }
+    getSession(id) {
+        const row = this.database.prepare("SELECT * FROM review_session WHERE id = ?").get(id);
+        return row === undefined ? undefined : deserialize(row);
+    }
+    createRevision(sessionId, source, status, document) {
+        const revision = { id: randomUUID(), sessionId, source, status, document, createdAt: new Date().toISOString() };
+        this.database.prepare(`
+      INSERT INTO analysis_revision (id, session_id, status, source, document_json, document_version, created_at)
+      VALUES (@id, @sessionId, @status, @source, @documentJson, @documentVersion, @createdAt)
+    `).run({ ...revision, documentJson: JSON.stringify(document), documentVersion: ANALYSIS_DOCUMENT_VERSION });
+        return revision;
+    }
+    /** Rows written for another document version, or whose stored document no longer validates, read as absent so the caller re-analyzes instead of rendering a broken artifact. */
+    listRevisions(sessionId) {
+        const rows = this.database.prepare("SELECT * FROM analysis_revision WHERE session_id = ? ORDER BY created_at DESC").all(sessionId);
+        return rows.flatMap((row) => {
+            if (row.document_version !== null && row.document_version !== ANALYSIS_DOCUMENT_VERSION)
+                return [];
+            const document = parseStoredDocument(row.document_json);
+            if (document === undefined)
+                return [];
+            return [{ id: row.id, sessionId: row.session_id, status: row.status, source: row.source, document, createdAt: row.created_at }];
+        });
+    }
+    close() {
+        this.database.close();
+    }
+}
+function parseStoredDocument(documentJson) {
+    try {
+        const parsed = AnalysisDocumentSchema.safeParse(JSON.parse(documentJson));
+        return parsed.success ? parsed.data : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function deserialize(row) {
+    return {
+        id: row.id,
+        repoPath: row.repo_path,
+        targetRef: row.target_ref,
+        baseRef: row.base_ref,
+        mergeBase: row.merge_base,
+        inputHash: row.input_hash,
+        input: JSON.parse(row.input_json),
+        conversation: row.conversation_json === null ? undefined : JSON.parse(row.conversation_json),
+        createdAt: row.created_at,
+    };
+}
+function hashInput(input, conversation) {
+    return createHash("sha256").update(JSON.stringify({ input, conversation })).digest("hex");
+}
+function defaultDatabasePath() {
+    if (process.env.NDRSTND_DATA_DIR !== undefined)
+        return join(process.env.NDRSTND_DATA_DIR, "ndrstnd.sqlite");
+    if (process.platform === "darwin")
+        return join(homedir(), "Library", "Application Support", "ndrstnd", "ndrstnd.sqlite");
+    if (process.platform === "win32")
+        return join(process.env.LOCALAPPDATA ?? homedir(), "ndrstnd", "ndrstnd.sqlite");
+    return join(process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share"), "ndrstnd", "ndrstnd.sqlite");
+}
+//# sourceMappingURL=store.js.map

package/dist/server/store.js.map

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

package/dist/server/version.d.ts

@@ -0,0 +1,2 @@
+/** The version shipped in package.json, so --version and agent handshakes can never drift from the release. */
+export declare function packageVersion(): Promise<string>;

package/dist/server/version.js

@@ -0,0 +1,13 @@
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+let cached;
+/** The version shipped in package.json, so --version and agent handshakes can never drift from the release. */
+export async function packageVersion() {
+    if (cached === undefined) {
+        const manifest = JSON.parse(await readFile(join(dirname(fileURLToPath(import.meta.url)), "../../package.json"), "utf8"));
+        cached = manifest.version ?? "unknown";
+    }
+    return cached;
+}
+//# sourceMappingURL=version.js.map

package/dist/server/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/server/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,IAAI,MAA0B,CAAC;AAE/B,+GAA+G;AAC/G,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC,CAAyB,CAAC;QACjJ,MAAM,GAAG,QAAQ,CAAC,OAAO,IAAI,SAAS,CAAC;IACzC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/shared/analysis-schema.d.ts

@@ -0,0 +1,325 @@
+import { z } from "zod";
+export declare const RiskCategorySchema: z.ZodEnum<["formatting", "refactor", "behavior", "performance", "security"]>;
+export declare const AttentionSchema: z.ZodEnum<["low", "contained", "elevated", "high", "critical"]>;
+export declare const ChapterSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    kind: z.ZodEnum<["feature", "decision", "behavior", "non_functional", "risk", "test", "other"]>;
+    synopsis: z.ZodString;
+    before: z.ZodOptional<z.ZodString>;
+    after: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    attention: z.ZodEnum<["low", "contained", "elevated", "high", "critical"]>;
+    riskCategories: z.ZodArray<z.ZodEnum<["formatting", "refactor", "behavior", "performance", "security"]>, "many">;
+    evidenceIds: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    kind: "behavior" | "feature" | "decision" | "non_functional" | "risk" | "test" | "other";
+    synopsis: string;
+    confidence: "low" | "high" | "medium";
+    attention: "low" | "contained" | "elevated" | "high" | "critical";
+    riskCategories: ("formatting" | "refactor" | "behavior" | "performance" | "security")[];
+    evidenceIds: string[];
+    before?: string | undefined;
+    after?: string | undefined;
+}, {
+    id: string;
+    title: string;
+    kind: "behavior" | "feature" | "decision" | "non_functional" | "risk" | "test" | "other";
+    synopsis: string;
+    confidence: "low" | "high" | "medium";
+    attention: "low" | "contained" | "elevated" | "high" | "critical";
+    riskCategories: ("formatting" | "refactor" | "behavior" | "performance" | "security")[];
+    evidenceIds: string[];
+    before?: string | undefined;
+    after?: string | undefined;
+}>;
+export declare const AnalysisStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    goal: z.ZodString;
+    youNowHave: z.ZodString;
+    deferred: z.ZodArray<z.ZodObject<{
+        concern: z.ZodString;
+        resolvedByStepId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        concern: string;
+        resolvedByStepId?: string | undefined;
+    }, {
+        concern: string;
+        resolvedByStepId?: string | undefined;
+    }>, "many">;
+    dependsOn: z.ZodArray<z.ZodString, "many">;
+    forwardRefs: z.ZodRecord<z.ZodString, z.ZodString>;
+    advancesChapterIds: z.ZodArray<z.ZodString, "many">;
+    evidenceIds: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    evidenceIds: string[];
+    goal: string;
+    youNowHave: string;
+    deferred: {
+        concern: string;
+        resolvedByStepId?: string | undefined;
+    }[];
+    dependsOn: string[];
+    forwardRefs: Record<string, string>;
+    advancesChapterIds: string[];
+}, {
+    id: string;
+    title: string;
+    evidenceIds: string[];
+    goal: string;
+    youNowHave: string;
+    deferred: {
+        concern: string;
+        resolvedByStepId?: string | undefined;
+    }[];
+    dependsOn: string[];
+    forwardRefs: Record<string, string>;
+    advancesChapterIds: string[];
+}>;
+export declare const FocusRangeSchema: z.ZodObject<{
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    end: number;
+    start: number;
+}, {
+    end: number;
+    start: number;
+}>;
+export declare const TestExecutionSchema: z.ZodObject<{
+    command: z.ZodString;
+    outcome: z.ZodEnum<["passed", "failed", "mixed", "unknown"]>;
+    summary: z.ZodString;
+    source: z.ZodEnum<["conversation", "repository"]>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    outcome: "unknown" | "passed" | "failed" | "mixed";
+    summary: string;
+    source: "conversation" | "repository";
+}, {
+    command: string;
+    outcome: "unknown" | "passed" | "failed" | "mixed";
+    summary: string;
+    source: "conversation" | "repository";
+}>;
+export declare const AnalysisDocumentSchema: z.ZodObject<{
+    summary: z.ZodString;
+    chapters: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        kind: z.ZodEnum<["feature", "decision", "behavior", "non_functional", "risk", "test", "other"]>;
+        synopsis: z.ZodString;
+        before: z.ZodOptional<z.ZodString>;
+        after: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        attention: z.ZodEnum<["low", "contained", "elevated", "high", "critical"]>;
+        riskCategories: z.ZodArray<z.ZodEnum<["formatting", "refactor", "behavior", "performance", "security"]>, "many">;
+        evidenceIds: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        kind: "behavior" | "feature" | "decision" | "non_functional" | "risk" | "test" | "other";
+        synopsis: string;
+        confidence: "low" | "high" | "medium";
+        attention: "low" | "contained" | "elevated" | "high" | "critical";
+        riskCategories: ("formatting" | "refactor" | "behavior" | "performance" | "security")[];
+        evidenceIds: string[];
+        before?: string | undefined;
+        after?: string | undefined;
+    }, {
+        id: string;
+        title: string;
+        kind: "behavior" | "feature" | "decision" | "non_functional" | "risk" | "test" | "other";
+        synopsis: string;
+        confidence: "low" | "high" | "medium";
+        attention: "low" | "contained" | "elevated" | "high" | "critical";
+        riskCategories: ("formatting" | "refactor" | "behavior" | "performance" | "security")[];
+        evidenceIds: string[];
+        before?: string | undefined;
+        after?: string | undefined;
+    }>, "many">;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        goal: z.ZodString;
+        youNowHave: z.ZodString;
+        deferred: z.ZodArray<z.ZodObject<{
+            concern: z.ZodString;
+            resolvedByStepId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            concern: string;
+            resolvedByStepId?: string | undefined;
+        }, {
+            concern: string;
+            resolvedByStepId?: string | undefined;
+        }>, "many">;
+        dependsOn: z.ZodArray<z.ZodString, "many">;
+        forwardRefs: z.ZodRecord<z.ZodString, z.ZodString>;
+        advancesChapterIds: z.ZodArray<z.ZodString, "many">;
+        evidenceIds: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        evidenceIds: string[];
+        goal: string;
+        youNowHave: string;
+        deferred: {
+            concern: string;
+            resolvedByStepId?: string | undefined;
+        }[];
+        dependsOn: string[];
+        forwardRefs: Record<string, string>;
+        advancesChapterIds: string[];
+    }, {
+        id: string;
+        title: string;
+        evidenceIds: string[];
+        goal: string;
+        youNowHave: string;
+        deferred: {
+            concern: string;
+            resolvedByStepId?: string | undefined;
+        }[];
+        dependsOn: string[];
+        forwardRefs: Record<string, string>;
+        advancesChapterIds: string[];
+    }>, "many">;
+    omittedGroups: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        reason: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        reason: string;
+        title: string;
+        evidenceIds: string[];
+    }, {
+        reason: string;
+        title: string;
+        evidenceIds: string[];
+    }>, "many">;
+    unclassifiedEvidenceIds: z.ZodArray<z.ZodString, "many">;
+    /** Reviewer-critical new-file line ranges per evidence ID; they drive the focused excerpts at the Evidence zoom. */
+    focus: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        end: number;
+        start: number;
+    }, {
+        end: number;
+        start: number;
+    }>, "many">>>;
+    /** Test or build runs actually observed in the conversation or repository; never inferred. */
+    testExecution: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        outcome: z.ZodEnum<["passed", "failed", "mixed", "unknown"]>;
+        summary: z.ZodString;
+        source: z.ZodEnum<["conversation", "repository"]>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        outcome: "unknown" | "passed" | "failed" | "mixed";
+        summary: string;
+        source: "conversation" | "repository";
+    }, {
+        command: string;
+        outcome: "unknown" | "passed" | "failed" | "mixed";
+        summary: string;
+        source: "conversation" | "repository";
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    chapters: {
+        id: string;
+        title: string;
+        kind: "behavior" | "feature" | "decision" | "non_functional" | "risk" | "test" | "other";
+        synopsis: string;
+        confidence: "low" | "high" | "medium";
+        attention: "low" | "contained" | "elevated" | "high" | "critical";
+        riskCategories: ("formatting" | "refactor" | "behavior" | "performance" | "security")[];
+        evidenceIds: string[];
+        before?: string | undefined;
+        after?: string | undefined;
+    }[];
+    steps: {
+        id: string;
+        title: string;
+        evidenceIds: string[];
+        goal: string;
+        youNowHave: string;
+        deferred: {
+            concern: string;
+            resolvedByStepId?: string | undefined;
+        }[];
+        dependsOn: string[];
+        forwardRefs: Record<string, string>;
+        advancesChapterIds: string[];
+    }[];
+    omittedGroups: {
+        reason: string;
+        title: string;
+        evidenceIds: string[];
+    }[];
+    unclassifiedEvidenceIds: string[];
+    focus?: Record<string, {
+        end: number;
+        start: number;
+    }[]> | undefined;
+    testExecution?: {
+        command: string;
+        outcome: "unknown" | "passed" | "failed" | "mixed";
+        summary: string;
+        source: "conversation" | "repository";
+    }[] | undefined;
+}, {
+    summary: string;
+    chapters: {
+        id: string;
+        title: string;
+        kind: "behavior" | "feature" | "decision" | "non_functional" | "risk" | "test" | "other";
+        synopsis: string;
+        confidence: "low" | "high" | "medium";
+        attention: "low" | "contained" | "elevated" | "high" | "critical";
+        riskCategories: ("formatting" | "refactor" | "behavior" | "performance" | "security")[];
+        evidenceIds: string[];
+        before?: string | undefined;
+        after?: string | undefined;
+    }[];
+    steps: {
+        id: string;
+        title: string;
+        evidenceIds: string[];
+        goal: string;
+        youNowHave: string;
+        deferred: {
+            concern: string;
+            resolvedByStepId?: string | undefined;
+        }[];
+        dependsOn: string[];
+        forwardRefs: Record<string, string>;
+        advancesChapterIds: string[];
+    }[];
+    omittedGroups: {
+        reason: string;
+        title: string;
+        evidenceIds: string[];
+    }[];
+    unclassifiedEvidenceIds: string[];
+    focus?: Record<string, {
+        end: number;
+        start: number;
+    }[]> | undefined;
+    testExecution?: {
+        command: string;
+        outcome: "unknown" | "passed" | "failed" | "mixed";
+        summary: string;
+        source: "conversation" | "repository";
+    }[] | undefined;
+}>;
+export type AnalysisDocument = z.infer<typeof AnalysisDocumentSchema>;
+/** Bump on any incompatible change to AnalysisDocument so cached revisions from older versions are re-analyzed instead of rendered broken. */
+export declare const ANALYSIS_DOCUMENT_VERSION = 1;