ai-spector 0.8.39 → 0.8.41

package/dist/core/graph/index.d.ts.map

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

package/dist/core/graph/index.js

@@ -2,7 +2,7 @@ export { GraphSession } from "./session.js";
 export { ProjectSession, createProjectSession } from "./project.js";
 export { isKnowledgePayload, parseKnowledge, knowledgeHasDomainEntries, computeKnowledgeStats, knowledgeGraphCoverage, } from "./knowledge.js";
 export { parseSectionRegistry, findRegistryDocument, findRegistrySection, sectionHeading, sectionLabel, documentTemplate, registryDocuments, allRegistrySections, } from "./registry.js";
-export { parseDocflowConfig, primaryLanguage, languageCodes, } from "./config.js";
+export { parseDocflowConfig, primaryLanguage, clientLanguage, languageCodes, } from "./config.js";
 export { parseProjectState, lastIndexRunAt, lastGraphMergedAt, } from "./state.js";
 export { auditGraphLayers, BUNDLE_SOURCE_ID, BUNDLE_BUSINESS_ID, } from "./layer-audit.js";
 export { normalizePatch, parseExtractPatch, simulatePatch, } from "./patch.js";

package/dist/core/graph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAO5C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAexB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAOvB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAOpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAO1B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAmBhC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,EACV,YAAY,GACb,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAO5C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAexB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAOvB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAOpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAO1B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAmBhC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,EACV,YAAY,GACb,MAAM,wBAAwB,CAAC"}

package/dist/core/operations/check.d.ts

@@ -0,0 +1,28 @@
+export type CheckSeverity = "error" | "warning";
+export interface CheckFinding {
+    ruleId: string;
+    severity: CheckSeverity;
+    message: string;
+    /** Offending file or directory (relative to project root). */
+    path?: string;
+    /** Human-readable remediation hint. */
+    fix?: string;
+    /** True if `runCheck({ fix: true })` can repair it automatically. */
+    autoFixable?: boolean;
+    /** Set when --fix repaired the finding in this run. */
+    fixed?: boolean;
+}
+export interface CheckResult {
+    /** False when any error-severity finding remains unfixed. */
+    ok: boolean;
+    projectRoot: string;
+    findings: CheckFinding[];
+    checkedAt: string;
+}
+export interface CheckOptions {
+    root?: string;
+    /** Attempt to repair autoFixable findings. */
+    fix?: boolean;
+}
+export declare function runCheck(opts?: CheckOptions): Promise<CheckResult>;
+//# sourceMappingURL=check.d.ts.map

package/dist/core/operations/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/core/operations/check.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAoDD,wBAAsB,QAAQ,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CA+K5E"}

package/dist/core/operations/check.js

@@ -0,0 +1,211 @@
+import { mkdir, readdir } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { loadDocflowConfig } from "../config/load.js";
+import { pathExists, readJson } from "../util/fs.js";
+const DEFAULT_RULES = [
+    { id: "STRUCT-001", severity: "error" },
+    { id: "STRUCT-002", severity: "error" },
+    { id: "STRUCT-003", severity: "warning" },
+    { id: "CFG-001", severity: "error" },
+    { id: "TMPL-001", severity: "warning" },
+    { id: "CTX-001", severity: "warning" },
+    { id: "GRAPH-001", severity: "warning" },
+];
+async function loadRules(root) {
+    const cfgPath = join(root, ".ai-spector/.docflow/config/workspace.rules.json");
+    if (await pathExists(cfgPath)) {
+        try {
+            const loaded = await readJson(cfgPath);
+            if (Array.isArray(loaded.rules) && loaded.rules.length > 0) {
+                // Merge: config entries override defaults by id; defaults fill gaps.
+                const byId = new Map();
+                for (const r of DEFAULT_RULES)
+                    byId.set(r.id, { ...r });
+                for (const r of loaded.rules)
+                    byId.set(r.id, { ...byId.get(r.id), ...r });
+                return [...byId.values()];
+            }
+        }
+        catch {
+            // fall through to defaults; GRAPH/STRUCT rules still run
+        }
+    }
+    return DEFAULT_RULES;
+}
+function severityOf(rules, id, fallback) {
+    return rules.find((r) => r.id === id)?.severity ?? fallback;
+}
+function enabled(rules, id) {
+    const r = rules.find((x) => x.id === id);
+    return r ? r.enabled !== false : true;
+}
+export async function runCheck(opts = {}) {
+    const root = resolve(opts.root ?? process.cwd());
+    const rules = await loadRules(root);
+    const findings = [];
+    const add = (f) => findings.push(f);
+    const fixDir = async (rel) => {
+        if (!opts.fix)
+            return false;
+        await mkdir(join(root, rel), { recursive: true });
+        return true;
+    };
+    // Load config once for downstream rules.
+    let config;
+    let configReadable = false;
+    const configPath = ".ai-spector/docflow.config.json";
+    if (await pathExists(join(root, configPath))) {
+        try {
+            const loaded = await loadDocflowConfig(root);
+            config = loaded.config;
+            configReadable = true;
+        }
+        catch (e) {
+            if (enabled(rules, "STRUCT-002")) {
+                add({
+                    ruleId: "STRUCT-002",
+                    severity: severityOf(rules, "STRUCT-002", "error"),
+                    message: `docflow.config.json is present but not parseable: ${e instanceof Error ? e.message : String(e)}`,
+                    path: configPath,
+                });
+            }
+        }
+    }
+    else if (enabled(rules, "STRUCT-002")) {
+        add({
+            ruleId: "STRUCT-002",
+            severity: severityOf(rules, "STRUCT-002", "error"),
+            message: "docflow.config.json is missing — workspace is not initialized.",
+            path: configPath,
+            fix: "npx ai-spector init",
+        });
+    }
+    // STRUCT-001 — required directories.
+    if (enabled(rules, "STRUCT-001")) {
+        const required = ["docs/data-source", ".ai-spector/.docflow/config"];
+        for (const rel of required) {
+            if (!(await pathExists(join(root, rel)))) {
+                const fixed = await fixDir(rel);
+                add({
+                    ruleId: "STRUCT-001",
+                    severity: severityOf(rules, "STRUCT-001", "error"),
+                    message: `Required directory missing: ${rel}`,
+                    path: rel,
+                    fix: `mkdir -p ${rel}`,
+                    autoFixable: true,
+                    fixed,
+                });
+            }
+        }
+    }
+    // CFG-001 — languages configured. Read the RAW config: loadDocflowConfig
+    // silently substitutes a default language for an empty array, so we must
+    // inspect the file as written to catch a genuinely unconfigured project.
+    if (enabled(rules, "CFG-001") && configReadable) {
+        let rawLangs;
+        try {
+            const raw = await readJson(join(root, configPath));
+            rawLangs = raw.languages;
+        }
+        catch {
+            rawLangs = undefined;
+        }
+        if (!Array.isArray(rawLangs) || rawLangs.length === 0) {
+            add({
+                ruleId: "CFG-001",
+                severity: severityOf(rules, "CFG-001", "error"),
+                message: "No output languages configured (languages[] is empty or missing).",
+                path: configPath,
+                fix: "npx ai-spector lang add <code>",
+            });
+        }
+    }
+    // STRUCT-003 — language output folders for each configured language.
+    if (enabled(rules, "STRUCT-003") && configReadable) {
+        for (const lang of config?.languages ?? []) {
+            const rel = `docs/srs/${lang.code}`;
+            if (!(await pathExists(join(root, rel)))) {
+                const fixed = await fixDir(rel);
+                add({
+                    ruleId: "STRUCT-003",
+                    severity: severityOf(rules, "STRUCT-003", "warning"),
+                    message: `Output folder missing for configured language "${lang.code}": ${rel}`,
+                    path: rel,
+                    fix: `mkdir -p ${rel}`,
+                    autoFixable: true,
+                    fixed,
+                });
+            }
+        }
+    }
+    // TMPL-001 — templates dir present.
+    if (enabled(rules, "TMPL-001")) {
+        const rel = ".ai-spector/templates";
+        if (!(await pathExists(join(root, rel)))) {
+            add({
+                ruleId: "TMPL-001",
+                severity: severityOf(rules, "TMPL-001", "warning"),
+                message: "No templates directory found — generation will have no structure to follow.",
+                path: rel,
+                fix: "npx ai-spector init",
+            });
+        }
+    }
+    // CTX-001 — context store dir (created lazily; warn-only) and stale entries.
+    if (enabled(rules, "CTX-001")) {
+        const rel = ".ai-spector/.docflow/context";
+        if (!(await pathExists(join(root, rel)))) {
+            const fixed = await fixDir(rel);
+            add({
+                ruleId: "CTX-001",
+                severity: severityOf(rules, "CTX-001", "warning"),
+                message: "Context store directory does not exist yet (no clarifications recorded).",
+                path: rel,
+                autoFixable: true,
+                fixed,
+            });
+        }
+        else {
+            // Surface answers invalidated by source changes (flipped by `index`).
+            const files = (await readdir(join(root, rel)).catch(() => [])).filter((f) => f.endsWith(".json"));
+            for (const file of files) {
+                const store = await readJson(join(root, rel, file)).catch(() => undefined);
+                const stale = store?.entries?.filter((e) => e.status === "stale") ?? [];
+                if (stale.length > 0) {
+                    const docType = store?.docType ?? file.slice(0, -".json".length);
+                    add({
+                        ruleId: "CTX-001",
+                        severity: severityOf(rules, "CTX-001", "warning"),
+                        message: `${stale.length} stale clarification(s) for "${docType}" (${stale
+                            .map((e) => e.id)
+                            .join(", ")}) — source files changed since they were answered.`,
+                        path: `${rel}/${file}`,
+                        fix: `Re-confirm with the user, then: npx ai-spector context resolve ${docType} <id> --answer "..."`,
+                    });
+                }
+            }
+        }
+    }
+    // GRAPH-001 — graph.json parses (shallow; defers to `graph validate`).
+    if (enabled(rules, "GRAPH-001") && configReadable && config) {
+        const graphRel = config.paths.graph;
+        const graphAbs = join(root, graphRel);
+        if (await pathExists(graphAbs)) {
+            try {
+                await readJson(graphAbs);
+            }
+            catch (e) {
+                add({
+                    ruleId: "GRAPH-001",
+                    severity: severityOf(rules, "GRAPH-001", "warning"),
+                    message: `graph.json is present but not parseable: ${e instanceof Error ? e.message : String(e)}`,
+                    path: graphRel,
+                    fix: "Re-run analyze/merge or restore from a known-good graph.",
+                });
+            }
+        }
+    }
+    const ok = !findings.some((f) => f.severity === "error" && !f.fixed);
+    return { ok, projectRoot: root, findings, checkedAt: new Date().toISOString() };
+}
+//# sourceMappingURL=check.js.map

package/dist/core/operations/check.js.map

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

package/dist/core/operations/context.d.ts

@@ -0,0 +1,84 @@
+export type ContextEntryStatus = "open" | "answered" | "stale";
+export type ContextEntrySource = "user" | "inferred" | "data-source";
+export interface ContextEntry {
+    id: string;
+    question: string;
+    answer?: string;
+    status: ContextEntryStatus;
+    /** DAG node / section this informs, e.g. "srs.use-cases". */
+    scope?: string;
+    source: ContextEntrySource;
+    /** Files (relative to root) whose change makes this entry stale. */
+    sourceRefs?: string[];
+    createdAt: string;
+    answeredAt?: string;
+    answeredBy?: string;
+}
+export interface ContextStore {
+    version: number;
+    docType: string;
+    entries: ContextEntry[];
+}
+export interface ContextListOptions {
+    root?: string;
+    /** Doc type to list. Omit to list all stores. */
+    docType?: string;
+    status?: ContextEntryStatus;
+}
+export interface ContextListResult {
+    stores: ContextStore[];
+    total: number;
+}
+export interface ContextRecordOptions {
+    root?: string;
+    docType: string;
+    question: string;
+    /** Provide to record an already-answered clarification in one step. */
+    answer?: string;
+    scope?: string;
+    source?: ContextEntrySource;
+    sourceRefs?: string[];
+    answeredBy?: string;
+}
+export interface ContextRecordResult {
+    docType: string;
+    entry: ContextEntry;
+    storePath: string;
+}
+export interface ContextResolveOptions {
+    root?: string;
+    docType: string;
+    id: string;
+    answer: string;
+    answeredBy?: string;
+}
+export interface ContextResolveResult {
+    docType: string;
+    entry: ContextEntry;
+    storePath: string;
+}
+export interface ContextStaleScanOptions {
+    root?: string;
+    docType?: string;
+}
+export interface ContextStaleScanResult {
+    /** Doc types whose stores were scanned. */
+    docTypes: string[];
+    /** Answered entries whose sourceRefs were checked. */
+    checked: number;
+    /** Entries flipped from "answered" to "stale" in this run. */
+    markedStale: number;
+    /** Total entries currently stale (including previously stale). */
+    staleTotal: number;
+}
+export declare function contextStorePath(root: string, docType: string): string;
+export declare function runContextList(opts?: ContextListOptions): Promise<ContextListResult>;
+export declare function runContextRecord(opts: ContextRecordOptions): Promise<ContextRecordResult>;
+/**
+ * Flip answered entries to "stale" when any of their sourceRefs changed on
+ * disk after the answer was recorded (mtime > answeredAt). A missing ref also
+ * counts as stale — the answer was grounded in a file that no longer exists.
+ */
+export declare function runContextStaleScan(opts?: ContextStaleScanOptions): Promise<ContextStaleScanResult>;
+export declare function runContextResolve(opts: ContextResolveOptions): Promise<ContextResolveResult>;
+//# sourceMappingURL=context.d.ts.map

package/dist/core/operations/context.d.ts.map

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

package/dist/core/operations/context.js

@@ -0,0 +1,164 @@
+import { mkdir, readdir, stat } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { loadDocflowConfig } from "../config/load.js";
+import { pathExists, readJson, writeJson } from "../util/fs.js";
+// ── store IO ──────────────────────────────────────────────────────────────────
+function contextDir(root) {
+    return join(root, ".ai-spector/.docflow/context");
+}
+export function contextStorePath(root, docType) {
+    return join(contextDir(root), `${docType}.json`);
+}
+async function resolveRoot(root) {
+    const loaded = await loadDocflowConfig(root ? resolve(root) : undefined);
+    return loaded.root;
+}
+async function loadStore(root, docType) {
+    const path = contextStorePath(root, docType);
+    if (await pathExists(path)) {
+        return readJson(path);
+    }
+    return { version: 1, docType, entries: [] };
+}
+async function saveStore(root, store) {
+    const path = contextStorePath(root, store.docType);
+    await mkdir(dirname(path), { recursive: true });
+    await writeJson(path, store);
+    return path;
+}
+function nextId(store) {
+    let max = 0;
+    for (const e of store.entries) {
+        const m = /^Q-(\d+)$/.exec(e.id);
+        if (m)
+            max = Math.max(max, Number(m[1]));
+    }
+    return `Q-${String(max + 1).padStart(3, "0")}`;
+}
+// ── operations ────────────────────────────────────────────────────────────────
+export async function runContextList(opts = {}) {
+    const root = await resolveRoot(opts.root);
+    const dir = contextDir(root);
+    let docTypes = [];
+    if (opts.docType) {
+        docTypes = [opts.docType];
+    }
+    else if (await pathExists(dir)) {
+        docTypes = (await readdir(dir))
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => f.slice(0, -".json".length));
+    }
+    const stores = [];
+    for (const docType of docTypes) {
+        const store = await loadStore(root, docType);
+        const entries = opts.status
+            ? store.entries.filter((e) => e.status === opts.status)
+            : store.entries;
+        if (opts.docType || entries.length > 0) {
+            stores.push({ ...store, entries });
+        }
+    }
+    return { stores, total: stores.reduce((n, s) => n + s.entries.length, 0) };
+}
+export async function runContextRecord(opts) {
+    if (!opts.docType)
+        throw new Error("docType is required");
+    if (!opts.question?.trim())
+        throw new Error("question is required");
+    const root = await resolveRoot(opts.root);
+    const store = await loadStore(root, opts.docType);
+    const now = new Date().toISOString();
+    const answered = opts.answer !== undefined && opts.answer.trim() !== "";
+    const entry = {
+        id: nextId(store),
+        question: opts.question.trim(),
+        status: answered ? "answered" : "open",
+        source: opts.source ?? "user",
+        createdAt: now,
+        ...(answered ? { answer: opts.answer.trim(), answeredAt: now } : {}),
+        ...(opts.scope ? { scope: opts.scope } : {}),
+        ...(opts.sourceRefs?.length ? { sourceRefs: opts.sourceRefs } : {}),
+        ...(answered && opts.answeredBy ? { answeredBy: opts.answeredBy } : {}),
+    };
+    store.entries.push(entry);
+    const storePath = await saveStore(root, store);
+    return { docType: opts.docType, entry, storePath };
+}
+/**
+ * Flip answered entries to "stale" when any of their sourceRefs changed on
+ * disk after the answer was recorded (mtime > answeredAt). A missing ref also
+ * counts as stale — the answer was grounded in a file that no longer exists.
+ */
+export async function runContextStaleScan(opts = {}) {
+    const root = await resolveRoot(opts.root);
+    const dir = contextDir(root);
+    let docTypes = [];
+    if (opts.docType) {
+        docTypes = [opts.docType];
+    }
+    else if (await pathExists(dir)) {
+        docTypes = (await readdir(dir))
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => f.slice(0, -".json".length));
+    }
+    let checked = 0;
+    let markedStale = 0;
+    let staleTotal = 0;
+    for (const docType of docTypes) {
+        const store = await loadStore(root, docType);
+        let dirty = false;
+        for (const entry of store.entries) {
+            if (entry.status === "stale") {
+                staleTotal++;
+                continue;
+            }
+            if (entry.status !== "answered" || !entry.sourceRefs?.length || !entry.answeredAt) {
+                continue;
+            }
+            checked++;
+            const answeredAtMs = Date.parse(entry.answeredAt);
+            let stale = false;
+            for (const ref of entry.sourceRefs) {
+                try {
+                    const info = await stat(join(root, ref));
+                    if (info.mtimeMs > answeredAtMs) {
+                        stale = true;
+                        break;
+                    }
+                }
+                catch {
+                    stale = true;
+                    break;
+                }
+            }
+            if (stale) {
+                entry.status = "stale";
+                dirty = true;
+                markedStale++;
+                staleTotal++;
+            }
+        }
+        if (dirty) {
+            await saveStore(root, store);
+        }
+    }
+    return { docTypes, checked, markedStale, staleTotal };
+}
+export async function runContextResolve(opts) {
+    if (!opts.answer?.trim())
+        throw new Error("answer is required");
+    const root = await resolveRoot(opts.root);
+    const store = await loadStore(root, opts.docType);
+    const entry = store.entries.find((e) => e.id === opts.id);
+    if (!entry) {
+        throw new Error(`No context entry "${opts.id}" in store for docType "${opts.docType}"`);
+    }
+    entry.answer = opts.answer.trim();
+    entry.status = "answered";
+    entry.answeredAt = new Date().toISOString();
+    if (opts.answeredBy)
+        entry.answeredBy = opts.answeredBy;
+    const storePath = await saveStore(root, store);
+    return { docType: opts.docType, entry, storePath };
+}
+//# sourceMappingURL=context.js.map

package/dist/core/operations/context.js.map

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

package/dist/core/operations/extracted.d.ts

@@ -0,0 +1,80 @@
+import { type GraphMergeResult } from "./graph-merge.js";
+import type { ExtractPatch } from "../graph/knowledge.js";
+export type SpecStatus = "pending" | "approved" | "rejected";
+export interface ExtractedSpec {
+    id: string;
+    /** Short statement of the spec (decision, constraint, identifier, threshold). */
+    statement: string;
+    /** Generated document(s) the spec was extracted from (relative paths). */
+    extractedFrom: string[];
+    status: SpecStatus;
+    /** Graph patch to merge on approval (nodes + edges). Optional — a spec may be informational only. */
+    patch?: ExtractPatch;
+    createdAt: string;
+    reviewedAt?: string;
+    reviewedBy?: string;
+    /** Reviewer note on approve/reject. */
+    note?: string;
+}
+export interface SpecStore {
+    version: number;
+    docType: string;
+    specs: ExtractedSpec[];
+}
+export interface SpecListOptions {
+    root?: string;
+    docType?: string;
+    status?: SpecStatus;
+}
+export interface SpecListResult {
+    stores: SpecStore[];
+    total: number;
+}
+export interface SpecRecordOptions {
+    root?: string;
+    docType: string;
+    specs: Array<{
+        statement: string;
+        extractedFrom: string[];
+        patch?: ExtractPatch;
+    }>;
+}
+export interface SpecRecordResult {
+    docType: string;
+    recorded: ExtractedSpec[];
+    storePath: string;
+}
+export interface SpecApproveOptions {
+    root?: string;
+    docType: string;
+    id: string;
+    by?: string;
+    note?: string;
+    /** Skip graph merge even when the spec has a patch (record-only approval). */
+    skipMerge?: boolean;
+}
+export interface SpecApproveResult {
+    docType: string;
+    spec: ExtractedSpec;
+    storePath: string;
+    /** Present when the spec had a patch and merge ran. */
+    merge?: GraphMergeResult;
+}
+export interface SpecRejectOptions {
+    root?: string;
+    docType: string;
+    id: string;
+    by?: string;
+    note?: string;
+}
+export interface SpecRejectResult {
+    docType: string;
+    spec: ExtractedSpec;
+    storePath: string;
+}
+export declare function specStorePath(root: string, docType: string): string;
+export declare function runSpecList(opts?: SpecListOptions): Promise<SpecListResult>;
+export declare function runSpecRecord(opts: SpecRecordOptions): Promise<SpecRecordResult>;
+export declare function runSpecApprove(opts: SpecApproveOptions): Promise<SpecApproveResult>;
+export declare function runSpecReject(opts: SpecRejectOptions): Promise<SpecRejectResult>;
+//# sourceMappingURL=extracted.d.ts.map

package/dist/core/operations/extracted.d.ts.map

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