ai-spector 0.1.0

package/dist/commands/graph-merge.js

@@ -0,0 +1,88 @@
+import { join } from "node:path";
+import { loadInMemoryGraph } from "../graph/loadGraph.js";
+import { isKnowledgePayload, knowledgeHasDomainEntries, knowledgeToPatch, } from "../graph/knowledge.js";
+import { mergePatch, normalizePatch } from "../graph/merge.js";
+import { resolveProjectPaths } from "../util/paths.js";
+import { pathExists, readJson, writeJson } from "../util/fs.js";
+import { validateGraph, formatIssues } from "./validate.js";
+export async function runGraphMerge(opts) {
+    const paths = await resolveProjectPaths(opts.root);
+    const graphPath = opts.graphPath ?? paths.graph;
+    const knowledgePath = join(paths.root, ".ai-spector/.docflow/analysis/knowledge.json");
+    const defaultPatchPath = join(paths.root, ".ai-spector/.docflow/extract/patch.json");
+    let inputPath = opts.inputPath;
+    if (opts.fromKnowledge) {
+        inputPath = knowledgePath;
+    }
+    else if (!inputPath) {
+        if (await pathExists(defaultPatchPath)) {
+            inputPath = defaultPatchPath;
+        }
+        else {
+            inputPath = knowledgePath;
+        }
+    }
+    const raw = await readJson(inputPath);
+    const patch = await resolvePatch(raw, inputPath);
+    if (opts.writePatch) {
+        await writeJson(opts.writePatch, patch);
+        console.log(`Wrote patch → ${opts.writePatch}`);
+    }
+    const graph = await loadInMemoryGraph(graphPath);
+    const { stats } = mergePatch(graph, patch);
+    console.log(`Merge: +${stats.nodesCreated} nodes, ~${stats.nodesUpdated} updated, +${stats.edgesAdded} edges` +
+        (stats.nodesSkipped ? `, ${stats.nodesSkipped} structure nodes skipped` : ""));
+    if (opts.dryRun) {
+        console.log("(dry-run: graph not saved)");
+        return;
+    }
+    await writeJson(graphPath, graph.toTraceabilityGraph());
+    const statePath = join(paths.root, ".ai-spector/.docflow/state.json");
+    const state = await readJson(statePath).catch(() => ({
+        version: 1,
+        analysis: {},
+    }));
+    const analysis = state.analysis ?? {};
+    analysis.graphMergedAt = new Date().toISOString();
+    analysis.lastMergeSource = inputPath;
+    state.analysis = analysis;
+    await writeJson(statePath, state);
+    if (opts.validate !== false) {
+        const issues = await validateGraph({
+            graphPath,
+            schemaPath: paths.schema,
+            registryPath: paths.registry,
+            rulesPath: paths.rulesTraceability,
+        });
+        const errors = issues.filter((i) => i.severity === "error");
+        if (errors.length > 0) {
+            console.log(formatIssues(issues));
+            console.error("");
+            console.error("Merge rolled back nothing — graph was saved but validation failed.");
+            console.error("Fix the issues above, then re-run: ai-spector graph merge --from-knowledge");
+            console.error("Or run /analyze in Cursor (agent should show these errors and help fix).");
+            throw new Error("Graph validation failed after merge");
+        }
+        const warns = issues.filter((i) => i.severity === "warn");
+        if (warns.length > 0) {
+            console.log(formatIssues(warns));
+        }
+        console.log("Graph validate: OK");
+    }
+    console.log(`Wrote ${graphPath}`);
+}
+async function resolvePatch(raw, sourcePath) {
+    if (isKnowledgePayload(raw)) {
+        const knowledge = raw;
+        if (!knowledgeHasDomainEntries(knowledge)) {
+            throw new Error(`No domain entries in ${sourcePath} (useCases, features, actors, …). Run /analyze in Cursor first.`);
+        }
+        return knowledgeToPatch(knowledge);
+    }
+    const patch = normalizePatch(raw);
+    if (patch.nodes.length === 0 && patch.edges.length === 0) {
+        throw new Error(`Empty patch in ${sourcePath}`);
+    }
+    return patch;
+}
+//# sourceMappingURL=graph-merge.js.map

package/dist/commands/graph-merge.js.map

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

package/dist/commands/graph-query.d.ts

@@ -0,0 +1,10 @@
+export interface GraphQueryCliOptions {
+    graphPath: string;
+    seedId: string;
+    direction?: "out" | "in" | "both";
+    depth?: number;
+    edges?: string;
+    json?: boolean;
+}
+export declare function runGraphQuery(opts: GraphQueryCliOptions): Promise<void>;
+//# sourceMappingURL=graph-query.d.ts.map

package/dist/commands/graph-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-query.d.ts","sourceRoot":"","sources":["../../src/commands/graph-query.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B7E"}

package/dist/commands/graph-query.js

@@ -0,0 +1,31 @@
+import { loadInMemoryGraph } from "../graph/loadGraph.js";
+import { querySubgraph } from "../graph/query.js";
+export async function runGraphQuery(opts) {
+    const g = await loadInMemoryGraph(opts.graphPath);
+    const queryOpts = {
+        direction: opts.direction,
+        depth: opts.depth,
+    };
+    if (opts.edges) {
+        queryOpts.edgeTypes = opts.edges.split(",").map((s) => s.trim());
+    }
+    const result = querySubgraph(g, opts.seedId, queryOpts);
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`Seed: ${result.seed}`);
+    console.log(`Nodes (${result.nodes.length}):`);
+    for (const n of result.nodes) {
+        console.log(`  - ${n.id} (${n.type})`);
+    }
+    console.log(`Edges (${result.edges.length}):`);
+    for (const e of result.edges) {
+        console.log(`  - ${e.from} --${e.type}--> ${e.to}`);
+    }
+    console.log(`Projection paths (${result.projectionPaths.length}):`);
+    for (const p of result.projectionPaths) {
+        console.log(`  - ${p}`);
+    }
+}
+//# sourceMappingURL=graph-query.js.map

package/dist/commands/graph-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-query.js","sourceRoot":"","sources":["../../src/commands/graph-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAqB,MAAM,mBAAmB,CAAC;AAYrE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA0B;IAC5D,MAAM,CAAC,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,SAAS,GAAiB;QAC9B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAe,CAAC;IACjF,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAExD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,eAAe,CAAC,MAAM,IAAI,CAAC,CAAC;IACpE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/commands/graph-visualize.d.ts

@@ -0,0 +1,10 @@
+export interface GraphVisualizeOptions {
+    root?: string;
+    graphPath?: string;
+    knowledgePath?: string;
+    output?: string;
+    open?: boolean;
+    skipKnowledge?: boolean;
+}
+export declare function runGraphVisualize(opts: GraphVisualizeOptions): Promise<string>;
+//# sourceMappingURL=graph-visualize.d.ts.map

package/dist/commands/graph-visualize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-visualize.d.ts","sourceRoot":"","sources":["../../src/commands/graph-visualize.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDpF"}

package/dist/commands/graph-visualize.js

@@ -0,0 +1,72 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { join } from "node:path";
+import { writeFile, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { pathExists, readJson } from "../util/fs.js";
+import { resolveProjectPaths } from "../util/paths.js";
+import { isKnowledgePayload, } from "../graph/knowledge.js";
+import { buildVisualizationHtml } from "../visualize/html.js";
+import { computeGraphStats, computeKnowledgeStats } from "../visualize/stats.js";
+const execAsync = promisify(exec);
+export async function runGraphVisualize(opts) {
+    const paths = await resolveProjectPaths(opts.root);
+    const graphPath = opts.graphPath ?? paths.graph;
+    const knowledgePath = opts.knowledgePath ??
+        join(paths.root, ".ai-spector/.docflow/analysis/knowledge.json");
+    const outputPath = opts.output ?? join(paths.root, ".ai-spector/views/graph-knowledge.html");
+    const graph = await readJson(graphPath);
+    let knowledge = null;
+    if (!opts.skipKnowledge && (await pathExists(knowledgePath))) {
+        const raw = await readJson(knowledgePath);
+        if (isKnowledgePayload(raw)) {
+            knowledge = raw;
+        }
+    }
+    const html = buildVisualizationHtml({
+        generatedAt: new Date().toISOString(),
+        projectRoot: paths.root,
+        graph,
+        knowledge,
+        graphStats: computeGraphStats(graph),
+        knowledgeStats: computeKnowledgeStats(knowledge),
+    });
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, html, "utf8");
+    console.log(`Wrote ${outputPath}`);
+    console.log(`  ${graph.nodes.length} nodes, ${graph.edges.length} edges`);
+    if (knowledge) {
+        const k = computeKnowledgeStats(knowledge);
+        console.log(`  knowledge: ${k.useCases} use cases, ${k.features} features, ${k.actors} actors`);
+    }
+    else {
+        console.log("  knowledge: (not loaded)");
+    }
+    console.log("");
+    console.log("Open in a browser:");
+    console.log(`  file://${outputPath}`);
+    if (opts.open) {
+        await openInBrowser(outputPath);
+    }
+    return outputPath;
+}
+async function openInBrowser(filePath) {
+    const url = `file://${filePath}`;
+    const platform = process.platform;
+    try {
+        if (platform === "darwin") {
+            await execAsync(`open "${filePath}"`);
+        }
+        else if (platform === "win32") {
+            await execAsync(`start "" "${filePath}"`, { shell: "cmd.exe" });
+        }
+        else {
+            await execAsync(`xdg-open "${filePath}"`);
+        }
+        console.log(`Opened ${url}`);
+    }
+    catch (e) {
+        console.warn(`Could not open browser automatically: ${e instanceof Error ? e.message : e}`);
+    }
+}
+//# sourceMappingURL=graph-visualize.js.map

package/dist/commands/graph-visualize.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,6 @@
+export interface InitOptions {
+    targetDir: string;
+    force?: boolean;
+}
+export declare function runInit(opts: InitOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD9D"}

package/dist/commands/init.js

@@ -0,0 +1,47 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { scaffoldBundleRoot } from "../config/load.js";
+import { copyTree, pathExists, writeJson } from "../util/fs.js";
+export async function runInit(opts) {
+    const root = resolve(opts.targetDir);
+    const marker = join(root, ".ai-spector", "docflow.config.json");
+    if (await pathExists(marker) && !opts.force) {
+        throw new Error(`Project already initialized (${marker}). Use --force to overwrite scaffold files.`);
+    }
+    const scaffold = scaffoldBundleRoot();
+    await copyTree(scaffold, root);
+    const dirs = [
+        ".ai-spector/graph",
+        ".ai-spector/registry",
+        ".ai-spector/.docflow/analysis",
+        ".ai-spector/.docflow/extract",
+        ".ai-spector/views",
+        "docs/srs",
+        "docs/basic-design",
+        "docs/detail-design",
+    ];
+    for (const d of dirs) {
+        await mkdir(join(root, d), { recursive: true });
+    }
+    const statePath = join(root, ".ai-spector/.docflow/state.json");
+    await writeJson(statePath, {
+        version: 1,
+        initializedAt: new Date().toISOString(),
+        analysis: { lastRunAt: null, graphPreparedAt: null },
+        index: { lastRunAt: null },
+    });
+    const gitkeep = join(root, "docs/srs/.gitkeep");
+    if (!(await pathExists(gitkeep))) {
+        await writeFile(gitkeep, "");
+    }
+    console.log(`Initialized AI Spector project at ${root}`);
+    console.log("");
+    console.log("Next steps (Cursor):");
+    console.log("  1. Open this folder in Cursor");
+    console.log("  2. Enable the ai-spector skill (.cursor/skills/ai-spector/)");
+    console.log("  3. Add files under docs/data-source/");
+    console.log("  4. Run /analyze  →  /validate-graph  →  /generate-srs");
+    console.log("");
+    console.log("See .cursor/commands/_workflow.md — you do not need other CLI commands.");
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAOhE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,qBAAqB,CAAC,CAAC;IAEhE,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,6CAA6C,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IACtC,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE/B,MAAM,IAAI,GAAG;QACX,mBAAmB;QACnB,sBAAsB;QACtB,+BAA+B;QAC/B,8BAA8B;QAC9B,mBAAmB;QACnB,UAAU;QACV,mBAAmB;QACnB,oBAAoB;KACrB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;IAChE,MAAM,SAAS,CAAC,SAAS,EAAE;QACzB,OAAO,EAAE,CAAC;QACV,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACvC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;QACpD,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;KAC3B,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACjC,MAAM,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC;AACzF,CAAC"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,10 @@
+import type { ValidationIssue } from "../types.js";
+export interface ValidateOptions {
+    graphPath: string;
+    schemaPath: string;
+    registryPath?: string;
+    rulesPath?: string;
+}
+export declare function validateGraph(opts: ValidateOptions): Promise<ValidationIssue[]>;
+export declare function formatIssues(issues: ValidationIssue[]): string;
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,eAAe,EAAE,MAAM,aAAa,CAAC;AAStE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CA6E5B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAiB9D"}

package/dist/commands/validate.js

@@ -0,0 +1,89 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const Ajv = require("ajv/dist/2020.js");
+const addFormats = require("ajv-formats");
+import { InMemoryGraph } from "../graph/InMemoryGraph.js";
+import { readJson } from "../util/fs.js";
+export async function validateGraph(opts) {
+    const issues = [];
+    const graph = await readJson(opts.graphPath);
+    const schema = await readJson(opts.schemaPath);
+    const ajv = new Ajv({ allErrors: true, strict: false });
+    addFormats(ajv);
+    const validate = ajv.compile(schema);
+    if (!validate(graph)) {
+        for (const err of validate.errors ?? []) {
+            issues.push({
+                ruleId: "SCHEMA",
+                severity: "error",
+                message: `${err.instancePath || "/"} ${err.message}`,
+            });
+        }
+    }
+    let mem;
+    try {
+        mem = InMemoryGraph.from(graph);
+    }
+    catch (e) {
+        issues.push({
+            ruleId: "GRAPH-LOAD",
+            severity: "error",
+            message: e instanceof Error ? e.message : String(e),
+        });
+        return issues;
+    }
+    issues.push(...mem.validateStructure());
+    if (opts.registryPath) {
+        const registry = await readJson(opts.registryPath);
+        const graphSectionIds = new Set([...mem.nodesById.values()]
+            .filter((n) => n.type === "section")
+            .map((n) => n.id));
+        for (const doc of registry.documents) {
+            for (const sec of doc.sections) {
+                if (!graphSectionIds.has(sec.id)) {
+                    issues.push({
+                        ruleId: "REGISTRY-COMPLETE",
+                        severity: "error",
+                        message: `Registry section missing from graph: ${sec.id} (${doc.documentId})`,
+                        nodeId: sec.id,
+                    });
+                }
+            }
+            if (!mem.nodesById.has(doc.documentId)) {
+                issues.push({
+                    ruleId: "REGISTRY-COMPLETE",
+                    severity: "error",
+                    message: `Registry document missing from graph: ${doc.documentId}`,
+                    nodeId: doc.documentId,
+                });
+            }
+        }
+    }
+    if (opts.rulesPath) {
+        const rules = await readJson(opts.rulesPath);
+        for (const r of rules.rules ?? []) {
+            if (r.id === "REGISTRY-COMPLETE" && !opts.registryPath) {
+                issues.push({
+                    ruleId: r.id,
+                    severity: "warn",
+                    message: `Rule ${r.id} skipped: no registry path provided`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+export function formatIssues(issues) {
+    if (issues.length === 0) {
+        return "OK — no validation issues";
+    }
+    const lines = issues.map((i) => `[${i.severity.toUpperCase()}] ${i.ruleId}: ${i.message}${i.nodeId ? ` (${i.nodeId})` : ""}`);
+    const errors = issues.filter((i) => i.severity === "error");
+    if (errors.length > 0) {
+        lines.push("");
+        lines.push("Fix each ERROR above, then re-run: ai-spector graph validate (or /validate-graph in Cursor).");
+        lines.push("Do not generate docs until validate passes. See .cursor/commands/_cli-failures.md");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

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

package/dist/config/load.d.ts

@@ -0,0 +1,21 @@
+import type { DocflowConfig, DocumentsManifest } from "./types.js";
+/** Installed package root (schemas, templates, documents.json). */
+export declare function packageBundleRoot(): string;
+/** Bundled project scaffold for `ai-spector init`. */
+export declare function scaffoldBundleRoot(): string;
+export declare function findProjectRoot(start?: string): string;
+export declare function loadDocflowConfig(root?: string): Promise<{
+    root: string;
+    config: DocflowConfig;
+    configFile: string;
+}>;
+export declare function resolveFromRoot(root: string, relativePath: string): string;
+export declare function bundledSchemaPath(): string;
+export declare function bundledRulesTraceabilityPath(): string;
+export declare function bundledRulesImpactPath(): string;
+export declare function bundledTemplatesDir(subdir: string): string;
+export declare function loadDocumentsManifest(): Promise<{
+    bundleRoot: string;
+    manifest: DocumentsManifest;
+}>;
+//# sourceMappingURL=load.d.ts.map

package/dist/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKnE,mEAAmE;AACnE,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,eAAe,CAAC,KAAK,SAAgB,GAAG,MAAM,CAkB7D;AAeD,wBAAsB,iBAAiB,CACrC,IAAI,SAAoB,GACvB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAWtE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B,CAAC,CASD"}

package/dist/config/load.js

@@ -0,0 +1,77 @@
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readJson } from "../util/fs.js";
+const CONFIG_NAME = "docflow.config.json";
+/** Installed package root (schemas, templates, documents.json). */
+export function packageBundleRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+}
+/** Bundled project scaffold for `ai-spector init`. */
+export function scaffoldBundleRoot() {
+    return join(packageBundleRoot(), "scaffold");
+}
+export function findProjectRoot(start = process.cwd()) {
+    let dir = resolve(start);
+    for (;;) {
+        if (existsSync(join(dir, ".ai-spector", CONFIG_NAME))) {
+            return dir;
+        }
+        if (existsSync(join(dir, CONFIG_NAME))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    throw new Error(`Could not find project root (expected .ai-spector/${CONFIG_NAME} or ${CONFIG_NAME})`);
+}
+function configPath(root) {
+    const nested = join(root, ".ai-spector", CONFIG_NAME);
+    if (existsSync(nested)) {
+        return nested;
+    }
+    return join(root, CONFIG_NAME);
+}
+const DEFAULT_PATHS = {
+    graph: ".ai-spector/graph/traceability.graph.json",
+    registry: ".ai-spector/registry/section-registry.json",
+};
+export async function loadDocflowConfig(root = findProjectRoot()) {
+    const configFile = configPath(root);
+    const raw = await readJson(configFile);
+    const config = {
+        version: raw.version ?? 1,
+        paths: {
+            graph: raw.paths?.graph ?? DEFAULT_PATHS.graph,
+            registry: raw.paths?.registry ?? DEFAULT_PATHS.registry,
+        },
+    };
+    return { root, config, configFile };
+}
+export function resolveFromRoot(root, relativePath) {
+    return resolve(root, relativePath);
+}
+export function bundledSchemaPath() {
+    return join(packageBundleRoot(), "schemas/schema.graph.json");
+}
+export function bundledRulesTraceabilityPath() {
+    return join(packageBundleRoot(), "schemas/rules.traceability.json");
+}
+export function bundledRulesImpactPath() {
+    return join(packageBundleRoot(), "schemas/rules.impact.json");
+}
+export function bundledTemplatesDir(subdir) {
+    return join(packageBundleRoot(), "templates", subdir);
+}
+export async function loadDocumentsManifest() {
+    const bundleRoot = packageBundleRoot();
+    const manifest = await readJson(join(bundleRoot, "documents.json"));
+    if (!manifest.templatesDir || !Array.isArray(manifest.documents)) {
+        throw new Error(`Invalid documents.json in ${bundleRoot}`);
+    }
+    return { bundleRoot, manifest };
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,22 @@
+export interface DocflowProjectPaths {
+    graph: string;
+    registry: string;
+}
+export interface DocflowConfig {
+    version: number;
+    paths: DocflowProjectPaths;
+}
+export interface DocumentsManifest {
+    version: number;
+    name: string;
+    templatesDir: string;
+    documents: ManifestDocument[];
+}
+export interface ManifestDocument {
+    documentId: string;
+    template: string;
+    output?: string;
+    outputPattern?: string;
+    perDomain?: "useCase" | "feature";
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACnC"}

package/dist/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

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

package/dist/graph/InMemoryGraph.d.ts

@@ -0,0 +1,20 @@
+import type { GraphEdge, GraphNode, TraceabilityGraph, ValidationIssue } from "../types.js";
+export declare class InMemoryGraph {
+    readonly nodesById: Map<string, GraphNode>;
+    readonly outEdges: Map<string, GraphEdge[]>;
+    readonly inEdges: Map<string, GraphEdge[]>;
+    static from(data: TraceabilityGraph): InMemoryGraph;
+    toJSON(): TraceabilityGraph;
+    /** Dedupe edges when exporting (each edge stored once in outEdges). */
+    toTraceabilityGraph(): TraceabilityGraph;
+    addNode(node: GraphNode): void;
+    /** Update an existing node or insert. Same `type` required when updating. */
+    upsertNode(node: GraphNode): "created" | "updated";
+    edgeKey(edge: GraphEdge): string;
+    hasEdge(edge: GraphEdge): boolean;
+    addEdge(edge: GraphEdge): void;
+    addEdgeIfAbsent(edge: GraphEdge): boolean;
+    neighbors(id: string, direction: "out" | "in" | "both", edgeTypes?: Set<string>, depth?: number): Set<string>;
+    validateStructure(): ValidationIssue[];
+}
+//# sourceMappingURL=InMemoryGraph.d.ts.map

package/dist/graph/InMemoryGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryGraph.d.ts","sourceRoot":"","sources":["../../src/graph/InMemoryGraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE5F,qBAAa,aAAa;IACxB,QAAQ,CAAC,SAAS,yBAAgC;IAClD,QAAQ,CAAC,QAAQ,2BAAkC;IACnD,QAAQ,CAAC,OAAO,2BAAkC;IAElD,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa;IAcnD,MAAM,IAAI,iBAAiB;IAQ3B,uEAAuE;IACvE,mBAAmB,IAAI,iBAAiB;IAmBxC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAS9B,6EAA6E;IAC7E,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS;IAelD,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAIhC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IAYjC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAK9B,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IAWzC,SAAS,CACP,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,EAChC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,KAAK,SAAI,GACR,GAAG,CAAC,MAAM,CAAC;IAsCd,iBAAiB,IAAI,eAAe,EAAE;CA+DvC"}