ai-spector 0.7.0 → 0.7.1

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

@@ -1,2 +1,21 @@
-export { InMemoryGraph } from "ai-spector-graph";
+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[]>;
+    private readonly edgeKeys;
+    static from(data: TraceabilityGraph): InMemoryGraph;
+    /** 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>;
+    detectCycles(edgeTypes?: Set<string>): string[][];
+    validateStructure(): ValidationIssue[];
+}
 //# sourceMappingURL=InMemoryGraph.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"InMemoryGraph.d.ts","sourceRoot":"","sources":["../../../src/core/graph/InMemoryGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"InMemoryGraph.d.ts","sourceRoot":"","sources":["../../../src/core/graph/InMemoryGraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG/F,qBAAa,aAAa;IACxB,QAAQ,CAAC,SAAS,yBAAgC;IAClD,QAAQ,CAAC,QAAQ,2BAAkC;IACnD,QAAQ,CAAC,OAAO,2BAAkC;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa;IAiBnD,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;IAIjC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAW9B,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IAczC,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;IAqCd,YAAY,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,EAAE;IAuCjD,iBAAiB,IAAI,eAAe,EAAE;CAqFvC"}

package/dist/core/graph/InMemoryGraph.js

@@ -1,2 +1,239 @@
-export { InMemoryGraph } from "ai-spector-graph";
+import { isPathTargetEdge } from "./path-target-edges.js";
+export class InMemoryGraph {
+    nodesById = new Map();
+    outEdges = new Map();
+    inEdges = new Map();
+    edgeKeys = new Set();
+    static from(data) {
+        const g = new InMemoryGraph();
+        for (const node of data.nodes) {
+            g.addNode(node);
+        }
+        for (const edge of data.edges) {
+            if (!g.nodesById.has(edge.from)) {
+                throw new Error(`Edge references missing node: ${edge.from} -> ${edge.to}`);
+            }
+            if (!isPathTargetEdge(edge.type) && !g.nodesById.has(edge.to)) {
+                throw new Error(`Edge references missing node: ${edge.from} -> ${edge.to}`);
+            }
+            g.addEdge(edge);
+        }
+        return g;
+    }
+    /** Dedupe edges when exporting (each edge stored once in outEdges). */
+    toTraceabilityGraph() {
+        const edgeSet = new Set();
+        const edges = [];
+        for (const list of this.outEdges.values()) {
+            for (const e of list) {
+                const key = `${e.type}|${e.from}|${e.to}|${e.role ?? ""}`;
+                if (!edgeSet.has(key)) {
+                    edgeSet.add(key);
+                    edges.push(e);
+                }
+            }
+        }
+        return {
+            version: 1,
+            nodes: [...this.nodesById.values()],
+            edges,
+        };
+    }
+    addNode(node) {
+        if (this.nodesById.has(node.id)) {
+            throw new Error(`Duplicate node id: ${node.id}`);
+        }
+        this.nodesById.set(node.id, node);
+        this.outEdges.set(node.id, []);
+        this.inEdges.set(node.id, []);
+    }
+    /** Update an existing node or insert. Same `type` required when updating. */
+    upsertNode(node) {
+        const existing = this.nodesById.get(node.id);
+        if (existing) {
+            if (existing.type !== node.type) {
+                throw new Error(`Cannot change node type for ${node.id}: ${existing.type} → ${node.type}`);
+            }
+            this.nodesById.set(node.id, { ...existing, ...node });
+            return "updated";
+        }
+        this.addNode(node);
+        return "created";
+    }
+    edgeKey(edge) {
+        return `${edge.type}|${edge.from}|${edge.to}|${edge.role ?? ""}`;
+    }
+    hasEdge(edge) {
+        return this.edgeKeys.has(this.edgeKey(edge));
+    }
+    addEdge(edge) {
+        this.edgeKeys.add(this.edgeKey(edge));
+        this.outEdges.get(edge.from).push(edge);
+        const inbound = this.inEdges.get(edge.to);
+        if (inbound) {
+            inbound.push(edge);
+        }
+        else if (!isPathTargetEdge(edge.type)) {
+            throw new Error(`Edge references missing target node: ${edge.from} -> ${edge.to}`);
+        }
+    }
+    addEdgeIfAbsent(edge) {
+        if (this.hasEdge(edge)) {
+            return false;
+        }
+        if (!this.nodesById.has(edge.from)) {
+            throw new Error(`Edge references missing source node: ${edge.from}`);
+        }
+        if (!isPathTargetEdge(edge.type) && !this.nodesById.has(edge.to)) {
+            throw new Error(`Edge references missing target node: ${edge.from} -> ${edge.to}`);
+        }
+        this.addEdge(edge);
+        return true;
+    }
+    neighbors(id, direction, edgeTypes, depth = 1) {
+        const seen = new Set();
+        const queued = new Set([id]);
+        const queue = [{ id, d: 0 }];
+        while (queue.length > 0) {
+            const { id: current, d } = queue.shift();
+            if (d > 0) {
+                seen.add(current);
+            }
+            if (d === depth) {
+                continue;
+            }
+            const expand = (next) => {
+                if (!queued.has(next)) {
+                    queued.add(next);
+                    queue.push({ id: next, d: d + 1 });
+                }
+            };
+            if (direction === "out" || direction === "both") {
+                for (const e of this.outEdges.get(current) ?? []) {
+                    if (!edgeTypes || edgeTypes.has(e.type)) {
+                        expand(e.to);
+                    }
+                }
+            }
+            if (direction === "in" || direction === "both") {
+                for (const e of this.inEdges.get(current) ?? []) {
+                    if (!edgeTypes || edgeTypes.has(e.type)) {
+                        expand(e.from);
+                    }
+                }
+            }
+        }
+        seen.delete(id);
+        return seen;
+    }
+    detectCycles(edgeTypes) {
+        const cycles = [];
+        const WHITE = 0, GRAY = 1, BLACK = 2;
+        const color = new Map();
+        const parent = new Map();
+        for (const id of this.nodesById.keys()) {
+            color.set(id, WHITE);
+        }
+        const dfs = (id) => {
+            color.set(id, GRAY);
+            for (const e of this.outEdges.get(id) ?? []) {
+                if (edgeTypes && !edgeTypes.has(e.type))
+                    continue;
+                const next = e.to;
+                if (!color.has(next))
+                    continue;
+                if (color.get(next) === GRAY) {
+                    const cycle = [next];
+                    let cur = id;
+                    while (cur && cur !== next) {
+                        cycle.unshift(cur);
+                        cur = parent.get(cur);
+                    }
+                    cycle.unshift(next);
+                    cycles.push(cycle);
+                }
+                else if (color.get(next) === WHITE) {
+                    parent.set(next, id);
+                    dfs(next);
+                }
+            }
+            color.set(id, BLACK);
+        };
+        for (const id of this.nodesById.keys()) {
+            if (color.get(id) === WHITE)
+                dfs(id);
+        }
+        return cycles;
+    }
+    validateStructure() {
+        const issues = [];
+        const domainTypes = new Set([
+            "actor",
+            "useCase",
+            "feature",
+            "requirement",
+            "nfr",
+            "dataEntity",
+        ]);
+        for (const node of this.nodesById.values()) {
+            if (node.type === "section") {
+                const partOf = (this.outEdges.get(node.id) ?? []).filter((e) => e.type === "partOf");
+                if (partOf.length !== 1) {
+                    issues.push({
+                        ruleId: "SECTION-TREE",
+                        severity: "error",
+                        message: `Section ${node.id} must have exactly one partOf parent (found ${partOf.length})`,
+                        nodeId: node.id,
+                    });
+                }
+            }
+            if (domainTypes.has(node.type)) {
+                const anchored = (this.outEdges.get(node.id) ?? []).some((e) => ["listedIn", "definedIn", "describedIn"].includes(e.type));
+                const anchoredIn = (this.inEdges.get(node.id) ?? []).some((e) => ["listedIn", "definedIn", "describedIn"].includes(e.type));
+                if (!anchored && !anchoredIn) {
+                    issues.push({
+                        ruleId: "DOMAIN-ANCHORED",
+                        severity: "error",
+                        message: `Domain node ${node.id} has no listedIn, definedIn, or describedIn edge`,
+                        nodeId: node.id,
+                    });
+                }
+            }
+        }
+        for (const node of this.nodesById.values()) {
+            if (node.type === "document") {
+                if (node.outputPattern) {
+                    continue;
+                }
+                const isPerDomainInstance = typeof node.output === "string" &&
+                    (node.perDomain === "useCase" ||
+                        node.perDomain === "feature" ||
+                        node.perDomain === "apiDetail" ||
+                        node.perDomain === "screenDetail");
+                if (isPerDomainInstance) {
+                    continue;
+                }
+                const hasSection = [...this.outEdges.get(node.id) ?? []].some((e) => e.type === "contains" &&
+                    this.nodesById.get(e.to)?.type === "section");
+                if (!hasSection) {
+                    issues.push({
+                        ruleId: "DOC-SECTION-COVERAGE",
+                        severity: "error",
+                        message: `Document ${node.id} has no child sections`,
+                        nodeId: node.id,
+                    });
+                }
+            }
+        }
+        const cycleEdgeTypes = new Set(["dependsOn", "requires", "partOf"]);
+        for (const cycle of this.detectCycles(cycleEdgeTypes)) {
+            issues.push({
+                ruleId: "NO-CYCLE",
+                severity: "error",
+                message: `Cycle detected: ${cycle.join(" → ")}`,
+            });
+        }
+        return issues;
+    }
+}
 //# sourceMappingURL=InMemoryGraph.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"InMemoryGraph.js","sourceRoot":"","sources":["../../../src/core/graph/InMemoryGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"InMemoryGraph.js","sourceRoot":"","sources":["../../../src/core/graph/InMemoryGraph.ts"],"names":[],"mappings":"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"}

package/dist/core/graph/config.d.ts

@@ -0,0 +1,18 @@
+export interface DocflowProjectPaths {
+    graph: string;
+    registry: string;
+    templates?: string;
+}
+export interface LanguageConfig {
+    code: string;
+    label: string;
+}
+export interface DocflowConfig {
+    version: number;
+    languages: LanguageConfig[];
+    paths: DocflowProjectPaths;
+}
+export declare function parseDocflowConfig(json: unknown): DocflowConfig;
+export declare function primaryLanguage(config: DocflowConfig): LanguageConfig;
+export declare function languageCodes(config: DocflowConfig): string[];
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/graph/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAUD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAiB/D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAErE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAE7D"}

package/dist/core/graph/config.js

@@ -0,0 +1,30 @@
+const DEFAULT_PATHS = {
+    graph: ".ai-spector/graph/traceability.graph.json",
+    registry: ".ai-spector/registry/section-registry.json",
+    templates: ".ai-spector/templates",
+};
+const DEFAULT_LANGUAGE = { code: "en", label: "English" };
+export function parseDocflowConfig(json) {
+    if (!json || typeof json !== "object") {
+        throw new Error("docflow.config.json must be an object");
+    }
+    const raw = json;
+    return {
+        version: raw.version ?? 1,
+        languages: Array.isArray(raw.languages) && raw.languages.length > 0
+            ? raw.languages
+            : [DEFAULT_LANGUAGE],
+        paths: {
+            graph: raw.paths?.graph ?? DEFAULT_PATHS.graph,
+            registry: raw.paths?.registry ?? DEFAULT_PATHS.registry,
+            templates: raw.paths?.templates ?? DEFAULT_PATHS.templates,
+        },
+    };
+}
+export function primaryLanguage(config) {
+    return config.languages[0] ?? DEFAULT_LANGUAGE;
+}
+export function languageCodes(config) {
+    return config.languages.map((l) => l.code);
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/graph/config.ts"],"names":[],"mappings":"AAiBA,MAAM,aAAa,GAAwB;IACzC,KAAK,EAAE,2CAA2C;IAClD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,uBAAuB;CACnC,CAAC;AAEF,MAAM,gBAAgB,GAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAE1E,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,GAAG,GAAG,IAA8B,CAAC;IAC3C,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,CAAC;QACzB,SAAS,EACP,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YACtD,CAAC,CAAC,GAAG,CAAC,SAAS;YACf,CAAC,CAAC,CAAC,gBAAgB,CAAC;QACxB,KAAK,EAAE;YACL,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,IAAI,aAAa,CAAC,KAAK;YAC9C,QAAQ,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,IAAI,aAAa,CAAC,QAAQ;YACvD,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,IAAI,aAAa,CAAC,SAAS;SAC3D;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/core/graph/expand-path-nodes.d.ts

@@ -0,0 +1,28 @@
+import type { GraphEdge, GraphNode } from "../../types.js";
+import type { InMemoryGraph } from "./InMemoryGraph.js";
+export type SyntheticNodeType = "file" | "source";
+export interface SyntheticPathNode {
+    id: string;
+    type: SyntheticNodeType;
+    path: string;
+    label: string;
+}
+export interface ExpandPathTargetOptions {
+    /** Only expand for these graph node ids (e.g. visible subgraph). */
+    nodeIds?: ReadonlySet<string>;
+}
+export interface ExpandedPathTargets {
+    syntheticNodes: SyntheticPathNode[];
+    /** Edges from graph nodes to synthetic node ids (resolved `to` targets). */
+    resolvedEdges: GraphEdge[];
+}
+export declare function fileNodeId(path: string): string;
+export declare function sourceNodeId(path: string): string;
+/**
+ * Create synthetic file/source nodes for path-target edges (`rendersTo`, `derivedFrom`).
+ * Use when building a canvas graph where targets are repo paths, not node ids.
+ */
+export declare function expandPathTargetNodes(g: InMemoryGraph, options?: ExpandPathTargetOptions): ExpandedPathTargets;
+/** Merge graph nodes with synthetic path nodes for visualization. */
+export declare function nodesForVisualization(graphNodes: GraphNode[], expanded: ExpandedPathTargets): Array<GraphNode | SyntheticPathNode>;
+//# sourceMappingURL=expand-path-nodes.d.ts.map

package/dist/core/graph/expand-path-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-path-nodes.d.ts","sourceRoot":"","sources":["../../../src/core/graph/expand-path-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,4EAA4E;IAC5E,aAAa,EAAE,SAAS,EAAE,CAAC;CAC5B;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,aAAa,EAChB,OAAO,GAAE,uBAA4B,GACpC,mBAAmB,CAqErB;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,EAAE,EACvB,QAAQ,EAAE,mBAAmB,GAC5B,KAAK,CAAC,SAAS,GAAG,iBAAiB,CAAC,CAEtC"}

package/dist/core/graph/expand-path-nodes.js

@@ -0,0 +1,84 @@
+export function fileNodeId(path) {
+    return `file:${path}`;
+}
+export function sourceNodeId(path) {
+    return `source:${path}`;
+}
+function basename(path) {
+    return path.split("/").pop() || path;
+}
+/**
+ * Create synthetic file/source nodes for path-target edges (`rendersTo`, `derivedFrom`).
+ * Use when building a canvas graph where targets are repo paths, not node ids.
+ */
+export function expandPathTargetNodes(g, options = {}) {
+    const activeIds = options.nodeIds;
+    const pathsWithDocument = new Set();
+    for (const n of g.nodesById.values()) {
+        if (n.type === "document" && typeof n.output === "string") {
+            pathsWithDocument.add(n.output);
+        }
+    }
+    const pathToDocId = new Map();
+    for (const n of g.nodesById.values()) {
+        if (n.type === "document" && typeof n.output === "string") {
+            pathToDocId.set(n.output, n.id);
+        }
+    }
+    const fileNodes = new Map();
+    const sourceNodes = new Map();
+    const resolvedEdges = [];
+    for (const [fromId, edges] of g.outEdges) {
+        if (activeIds && !activeIds.has(fromId)) {
+            continue;
+        }
+        for (const e of edges) {
+            if (e.type === "derivedFrom") {
+                const sid = sourceNodeId(e.to);
+                if (!sourceNodes.has(sid)) {
+                    sourceNodes.set(sid, {
+                        id: sid,
+                        type: "source",
+                        path: e.to,
+                        label: basename(e.to),
+                    });
+                }
+                resolvedEdges.push({ type: e.type, from: fromId, to: sid, role: e.role });
+                continue;
+            }
+            if (e.type !== "rendersTo") {
+                continue;
+            }
+            if (g.nodesById.has(e.to)) {
+                resolvedEdges.push(e);
+                continue;
+            }
+            if (pathsWithDocument.has(e.to)) {
+                const docId = pathToDocId.get(e.to);
+                if (docId) {
+                    resolvedEdges.push({ type: e.type, from: fromId, to: docId, role: e.role });
+                }
+                continue;
+            }
+            const fid = fileNodeId(e.to);
+            if (!fileNodes.has(fid)) {
+                fileNodes.set(fid, {
+                    id: fid,
+                    type: "file",
+                    path: e.to,
+                    label: basename(e.to),
+                });
+            }
+            resolvedEdges.push({ type: e.type, from: fromId, to: fid, role: e.role });
+        }
+    }
+    return {
+        syntheticNodes: [...fileNodes.values(), ...sourceNodes.values()],
+        resolvedEdges,
+    };
+}
+/** Merge graph nodes with synthetic path nodes for visualization. */
+export function nodesForVisualization(graphNodes, expanded) {
+    return [...graphNodes, ...expanded.syntheticNodes];
+}
+//# sourceMappingURL=expand-path-nodes.js.map

package/dist/core/graph/expand-path-nodes.js.map

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

package/dist/core/graph/health.d.ts

@@ -0,0 +1,18 @@
+import type { LayerAuditReport } from "./layer-audit.js";
+import type { InMemoryGraph } from "./InMemoryGraph.js";
+import type { ValidationIssue } from "../../types.js";
+export interface GraphHealthSummary {
+    structureErrors: number;
+    structureWarnings: number;
+    layerOk: boolean;
+    layersNeedingWork: string[];
+    suggestedCommand?: string;
+    suggestedAgentCommand?: string;
+}
+export declare function summarizeValidation(issues: ValidationIssue[]): {
+    errors: number;
+    warnings: number;
+};
+export declare function layersNeedingWork(report: LayerAuditReport): string[];
+export declare function graphHealthSummary(graph: InMemoryGraph, layerReport: LayerAuditReport): GraphHealthSummary;
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/core/graph/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAWA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAWpE;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,gBAAgB,GAC5B,kBAAkB,CAWpB"}

package/dist/core/graph/health.js

@@ -0,0 +1,45 @@
+export function summarizeValidation(issues) {
+    let errors = 0;
+    let warnings = 0;
+    for (const i of issues) {
+        if (i.severity === "error") {
+            errors++;
+        }
+        else {
+            warnings++;
+        }
+    }
+    return { errors, warnings };
+}
+export function layersNeedingWork(report) {
+    const L = report.layers;
+    const out = [];
+    if (!L.structure.ok)
+        out.push("structure");
+    if (!L.specInstances.ok)
+        out.push("specInstances");
+    if (!L.domain.ok)
+        out.push("domain");
+    if (!L.sourceHub.ok)
+        out.push("sourceHub");
+    if (!L.businessHub.ok)
+        out.push("businessHub");
+    if (!L.provenance.ok)
+        out.push("provenance");
+    if (!L.semanticLinks.ok)
+        out.push("semanticLinks");
+    return out;
+}
+export function graphHealthSummary(graph, layerReport) {
+    const validation = summarizeValidation(graph.validateStructure());
+    const needing = layersNeedingWork(layerReport);
+    return {
+        structureErrors: validation.errors,
+        structureWarnings: validation.warnings,
+        layerOk: needing.length === 0,
+        layersNeedingWork: needing,
+        suggestedCommand: layerReport.suggestedCommand,
+        suggestedAgentCommand: layerReport.suggestedAgentCommand,
+    };
+}
+//# sourceMappingURL=health.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/core/graph/health.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,mBAAmB,CAAC,MAAyB;IAI3D,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC3B,MAAM,EAAE,CAAC;QACX,CAAC;aAAM,CAAC;YACN,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/C,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAoB,EACpB,WAA6B;IAE7B,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO;QACL,eAAe,EAAE,UAAU,CAAC,MAAM;QAClC,iBAAiB,EAAE,UAAU,CAAC,QAAQ;QACtC,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QAC7B,iBAAiB,EAAE,OAAO;QAC1B,gBAAgB,EAAE,WAAW,CAAC,gBAAgB;QAC9C,qBAAqB,EAAE,WAAW,CAAC,qBAAqB;KACzD,CAAC;AACJ,CAAC"}

package/dist/core/graph/impact.d.ts

@@ -1,5 +1,54 @@
-import { type ImpactRulesFile } from "ai-spector-graph";
-export { computeImpact, mergeImpactResults, parseImpactRules, DEFAULT_IMPACT_RULES, } from "ai-spector-graph";
-export type { ImpactRulesFile, ImpactEntry, ImpactResult } from "ai-spector-graph";
+import type { NodeType } from "../../types.js";
+import { InMemoryGraph } from "./InMemoryGraph.js";
+type EdgeRule = {
+    direction: "in" | "out";
+    depth: number | "unbounded";
+};
+export interface ImpactRulesFile {
+    version: 2;
+    pass1_expand: Record<string, EdgeRule>;
+    pass2_downstream: Record<string, EdgeRule>;
+    buckets: {
+        regenerate: NodeType[];
+        review: NodeType[];
+    };
+    maxNodes?: number;
+}
+export interface ImpactEntry {
+    id: string;
+    type: string;
+    reason: string;
+    projectionPath?: string;
+}
+export interface ImpactResult {
+    origin: {
+        id: string;
+        type: string;
+        change: string;
+    };
+    regenerate: ImpactEntry[];
+    review: ImpactEntry[];
+    affectedOutputPaths: string[];
+    staleTranslations?: ImpactEntry[];
+    resolvedFrom?: {
+        id: string;
+        type: string;
+        reason: string;
+    };
+    truncated?: boolean;
+    noTraceabilityImpact?: boolean;
+    gitSeeds?: Array<{
+        id: string;
+        type: string;
+        reason: string;
+        file?: string;
+        heading?: string;
+    }>;
+}
+export declare function parseImpactRules(json: unknown): ImpactRulesFile;
+export declare const DEFAULT_IMPACT_RULES: ImpactRulesFile;
+export declare function computeImpact(g: InMemoryGraph, originId: string, change: string, rules: ImpactRulesFile): ImpactResult;
+export declare function mergeImpactResults(results: ImpactResult[], gitSeeds?: ImpactResult["gitSeeds"]): ImpactResult;
 export declare function loadImpactRules(path: string): Promise<ImpactRulesFile>;
+export {};
 //# sourceMappingURL=impact.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../../../src/core/graph/impact.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEnF,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAE5E"}
+{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../../../src/core/graph/impact.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,KAAK,QAAQ,GAAG;IAAE,SAAS,EAAE,IAAI,GAAG,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,OAAO,EAAE;QAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;QAAC,MAAM,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE,WAAW,EAAE,CAAC;IAClC,YAAY,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAiED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CAQ/D;AAED,eAAO,MAAM,oBAAoB,EAAE,eAAsD,CAAC;AAE1F,wBAAgB,aAAa,CAC3B,CAAC,EAAE,aAAa,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,eAAe,GACrB,YAAY,CAuGd;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,GAClC,YAAY,CAqDd;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAE5E"}