ai-spector 0.7.0 → 0.7.2

package/dist/core/graph/layer-audit.js

@@ -1,29 +1,247 @@
-import { readdir } from "node:fs/promises";
-import { join } from "node:path";
-import { auditGraphLayers as auditGraphLayersCore, } from "ai-spector-graph";
-async function listUseCaseDetailPathsOnDisk(projectRoot) {
-    const base = join(projectRoot, "docs/srs/03-use-cases");
-    const paths = [];
-    try {
-        const entries = await readdir(base, { withFileTypes: true });
-        for (const ent of entries) {
-            if (ent.isFile() && /^uc-\d+.*\.md$/i.test(ent.name)) {
-                paths.push(`docs/srs/03-use-cases/${ent.name}`);
-            }
+export const BUNDLE_SOURCE_ID = "bundle.source";
+export const BUNDLE_BUSINESS_ID = "bundle.business";
+const DOMAIN_TYPES = new Set([
+    "actor",
+    "useCase",
+    "feature",
+    "requirement",
+    "nfr",
+    "dataEntity",
+]);
+const UC_DETAIL_PATH_RE_DEFAULT = /docs\/srs\/.*\/uc-\d+.*\.md$/i;
+function isPerDomainInstanceDocument(node) {
+    if (node.type !== "document" || node.outputPattern) {
+        return false;
+    }
+    const output = typeof node.output === "string" ? node.output : "";
+    if (!output) {
+        return false;
+    }
+    if (node.perDomain === "useCase" || node.perDomain === "feature") {
+        return true;
+    }
+    if (node.perDomain === "apiDetail" ||
+        node.perDomain === "screenDetail" ||
+        /docs\/basic-design\/(?:api\/|screens\/)/i.test(output.replace(/\\/g, "/"))) {
+        return true;
+    }
+    return false;
+}
+function countType(graph, type) {
+    let n = 0;
+    for (const node of graph.nodesById.values()) {
+        if (node.type === type) {
+            n++;
         }
     }
-    catch {
+    return n;
+}
+function perDomainSpecDocs(graph) {
+    let useCaseDocs = 0;
+    let featureDocs = 0;
+    for (const node of graph.nodesById.values()) {
+        if (node.type !== "document" || !isPerDomainInstanceDocument(node)) {
+            continue;
+        }
+        if (node.perDomain === "useCase") {
+            useCaseDocs++;
+        }
+        else if (node.perDomain === "feature") {
+            featureDocs++;
+        }
+    }
+    return { useCaseDocs, featureDocs };
+}
+function detailSectionCount(graph) {
+    let n = 0;
+    for (const node of graph.nodesById.values()) {
+        if (node.type !== "section") {
+            continue;
+        }
+        const docId = String(node.documentId ?? "");
+        if (!docId.startsWith("doc.srs.uc-") && !docId.startsWith("doc.srs.f-")) {
+            continue;
+        }
+        n++;
+    }
+    return n;
+}
+function edgeCount(graph, type) {
+    return graph.toTraceabilityGraph().edges.filter((e) => e.type === type).length;
+}
+function domainsWithDerivedFrom(graph) {
+    const out = new Set();
+    for (const e of graph.toTraceabilityGraph().edges) {
+        if (e.type !== "derivedFrom") {
+            continue;
+        }
+        const from = graph.nodesById.get(e.from);
+        if (from && DOMAIN_TYPES.has(from.type)) {
+            out.add(e.from);
+        }
+    }
+    return out;
+}
+function domainsWithRelatesTo(graph) {
+    const out = new Set();
+    for (const e of graph.toTraceabilityGraph().edges) {
+        if (e.type !== "relatesTo") {
+            continue;
+        }
+        const from = graph.nodesById.get(e.from);
+        const to = graph.nodesById.get(e.to);
+        if (from && DOMAIN_TYPES.has(from.type)) {
+            out.add(e.from);
+        }
+        if (to && DOMAIN_TYPES.has(to.type)) {
+            out.add(e.to);
+        }
+    }
+    return out;
+}
+function listDomainsMissingProvenance(graph) {
+    const withDerived = domainsWithDerivedFrom(graph);
+    const missing = [];
+    for (const node of graph.nodesById.values()) {
+        if (DOMAIN_TYPES.has(node.type) && !withDerived.has(node.id)) {
+            missing.push(node.id);
+        }
+    }
+    return missing.sort();
+}
+function listDomainsNeedingSemanticLinks(graph) {
+    const withDerived = domainsWithDerivedFrom(graph);
+    const withRelates = domainsWithRelatesTo(graph);
+    const out = [];
+    for (const id of withDerived) {
+        if (!withRelates.has(id)) {
+            out.push(id);
+        }
+    }
+    return out.sort();
+}
+function graphOutputPathsForUseCaseDocs(graph) {
+    const out = new Set();
+    for (const node of graph.nodesById.values()) {
+        if (node.type === "document" &&
+            node.perDomain === "useCase" &&
+            typeof node.output === "string") {
+            out.add(node.output.replace(/\\/g, "/"));
+        }
+    }
+    return out;
+}
+function missingUseCasePathsOnDisk(graph, existingPaths, ucDetailPathPattern) {
+    if (!existingPaths) {
         return [];
     }
-    return paths.sort();
+    const re = ucDetailPathPattern ?? UC_DETAIL_PATH_RE_DEFAULT;
+    const graphPaths = graphOutputPathsForUseCaseDocs(graph);
+    const missing = [];
+    for (const raw of existingPaths) {
+        const p = raw.replace(/\\/g, "/");
+        if (!re.test(p)) {
+            continue;
+        }
+        if (!graphPaths.has(p)) {
+            missing.push(p);
+        }
+    }
+    return missing.sort();
 }
-export async function auditGraphLayers(graph, projectRoot) {
-    let existingPaths;
-    if (projectRoot) {
-        existingPaths = await listUseCaseDetailPathsOnDisk(projectRoot);
+function suggestCommands(layers) {
+    let suggestedCommand;
+    let suggestedAgentCommand;
+    if (layers.semanticLinks.domainsWithoutSemanticLinks.length > 0) {
+        const seed = layers.semanticLinks.domainsWithoutSemanticLinks[0];
+        suggestedAgentCommand = seed ? `/link-graph ${seed}` : "/link-graph";
+    }
+    if (!layers.specInstances.ok && layers.domain.useCases > 0) {
+        suggestedCommand = "npx ai-spector index";
+    }
+    else if (!layers.sourceHub.ok && layers.domain.ok) {
+        suggestedCommand = "npx ai-spector index";
+    }
+    else if (layers.provenance.domainsWithoutSource.length > 0) {
+        suggestedAgentCommand = suggestedAgentCommand ?? "/analyze";
+        suggestedCommand = "npx ai-spector index";
+    }
+    return { suggestedCommand, suggestedAgentCommand };
+}
+/** Tri-layer health report (parity with `ai-spector graph report`). Sync, browser-safe. */
+export function auditGraphLayers(graph, options = {}) {
+    const documents = countType(graph, "document");
+    const sections = countType(graph, "section");
+    const { useCaseDocs, featureDocs } = perDomainSpecDocs(graph);
+    const detailSections = detailSectionCount(graph);
+    const useCases = countType(graph, "useCase");
+    const features = countType(graph, "feature");
+    const actors = countType(graph, "actor");
+    const requirements = countType(graph, "requirement");
+    const nfrs = countType(graph, "nfr");
+    const dataEntities = countType(graph, "dataEntity");
+    const bundleSource = graph.nodesById.has(BUNDLE_SOURCE_ID);
+    const sourceFiles = countType(graph, "sourceFile");
+    const bundleBusiness = graph.nodesById.has(BUNDLE_BUSINESS_ID);
+    let domainMembers = 0;
+    if (bundleBusiness) {
+        for (const e of graph.toTraceabilityGraph().edges) {
+            if (e.type === "contains" && e.from === BUNDLE_BUSINESS_ID) {
+                domainMembers++;
+            }
+        }
     }
-    return auditGraphLayersCore(graph, {
-        existingPaths: existingPaths ? new Set(existingPaths) : undefined,
-    });
+    const derivedFrom = edgeCount(graph, "derivedFrom");
+    const domainsWithoutSource = listDomainsMissingProvenance(graph);
+    const relatesTo = edgeCount(graph, "relatesTo");
+    const domainsWithoutSemanticLinks = listDomainsNeedingSemanticLinks(graph);
+    const missingOnDisk = missingUseCasePathsOnDisk(graph, options.existingPaths, options.ucDetailPathPattern);
+    const diskCheck = options.existingPaths !== undefined;
+    const specInstancesOk = useCaseDocs > 0 &&
+        detailSections > 0 &&
+        (!diskCheck || missingOnDisk.length === 0);
+    const layers = {
+        structure: {
+            documents,
+            sections,
+            ok: documents > 0 && sections > 0,
+        },
+        specInstances: {
+            useCaseDocs,
+            featureDocs,
+            sections: detailSections,
+            ok: specInstancesOk,
+            missingOnDisk,
+        },
+        domain: {
+            useCases,
+            features,
+            actors,
+            ok: useCases > 0 || features > 0,
+        },
+        sourceHub: {
+            bundlePresent: bundleSource,
+            sourceFiles,
+            ok: bundleSource,
+        },
+        businessHub: {
+            bundlePresent: bundleBusiness,
+            domainMembers,
+            ok: bundleBusiness &&
+                domainMembers >= useCases + features + actors + requirements + nfrs + dataEntities,
+        },
+        provenance: {
+            derivedFrom,
+            domainsWithoutSource,
+            ok: domainsWithoutSource.length === 0,
+        },
+        semanticLinks: {
+            relatesTo,
+            domainsWithoutSemanticLinks,
+            ok: domainsWithoutSemanticLinks.length === 0 || derivedFrom === 0,
+        },
+    };
+    const suggestions = suggestCommands(layers);
+    return { layers, ...suggestions };
 }
 //# sourceMappingURL=layer-audit.js.map

package/dist/core/graph/layer-audit.js.map

@@ -1 +1 @@
-{"version":3,"file":"layer-audit.js","sourceRoot":"","sources":["../../../src/core/graph/layer-audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,gBAAgB,IAAI,oBAAoB,GAGzC,MAAM,kBAAkB,CAAC;AAK1B,KAAK,UAAU,4BAA4B,CAAC,WAAmB;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;IACxD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrD,KAAK,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAoB,EACpB,WAAoB;IAEpB,IAAI,aAAmC,CAAC;IACxC,IAAI,WAAW,EAAE,CAAC;QAChB,aAAa,GAAG,MAAM,4BAA4B,CAAC,WAAW,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,oBAAoB,CAAC,KAAK,EAAE;QACjC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS;KAClE,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"layer-audit.js","sourceRoot":"","sources":["../../../src/core/graph/layer-audit.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,22 @@
+import type { InMemoryGraph } from "./InMemoryGraph.js";
+import type { GraphEdge, GraphNode } from "../../types.js";
+export interface ExtractPatch {
+    version: 1;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+export declare function normalizePatch(input: ExtractPatch | Partial<ExtractPatch>): ExtractPatch;
+export declare function parseExtractPatch(json: unknown): ExtractPatch;
+export interface PatchSimulationResult {
+    nodesToCreate: GraphNode[];
+    nodesToUpdate: GraphNode[];
+    edgesToAdd: GraphEdge[];
+    edgesSkipped: GraphEdge[];
+    nodesSkipped: GraphNode[];
+}
+/**
+ * Read-only preview of what merge would add (does not mutate the graph).
+ * Simplified vs CLI merge — no semanticOnly / structure guards.
+ */
+export declare function simulatePatch(graph: InMemoryGraph, patchInput: ExtractPatch | Partial<ExtractPatch>): PatchSimulationResult;
+//# sourceMappingURL=patch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../../src/core/graph/patch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAMxF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAK7D;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,YAAY,EAAE,SAAS,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,GAC/C,qBAAqB,CA+CvB"}

package/dist/core/graph/patch.js

@@ -0,0 +1,62 @@
+import { isPathTargetEdge } from "./path-target-edges.js";
+export function normalizePatch(input) {
+    return {
+        version: 1,
+        nodes: input.nodes ?? [],
+        edges: input.edges ?? [],
+    };
+}
+export function parseExtractPatch(json) {
+    if (!json || typeof json !== "object") {
+        throw new Error("patch.json must be an object");
+    }
+    return normalizePatch(json);
+}
+/**
+ * Read-only preview of what merge would add (does not mutate the graph).
+ * Simplified vs CLI merge — no semanticOnly / structure guards.
+ */
+export function simulatePatch(graph, patchInput) {
+    const patch = normalizePatch(patchInput);
+    const nodesToCreate = [];
+    const nodesToUpdate = [];
+    const nodesSkipped = [];
+    const edgesToAdd = [];
+    const edgesSkipped = [];
+    for (const node of patch.nodes) {
+        const existing = graph.nodesById.get(node.id);
+        if (!existing) {
+            nodesToCreate.push(node);
+            continue;
+        }
+        if (existing.type !== node.type) {
+            nodesSkipped.push(node);
+            continue;
+        }
+        nodesToUpdate.push(node);
+    }
+    const patchNodeIds = new Set(patch.nodes.map((n) => n.id));
+    const hasEndpoint = (id) => graph.nodesById.has(id) || patchNodeIds.has(id);
+    for (const edge of patch.edges) {
+        if (graph.hasEdge(edge)) {
+            continue;
+        }
+        if (!hasEndpoint(edge.from)) {
+            edgesSkipped.push(edge);
+            continue;
+        }
+        if (!isPathTargetEdge(edge.type) && !hasEndpoint(edge.to)) {
+            edgesSkipped.push(edge);
+            continue;
+        }
+        edgesToAdd.push(edge);
+    }
+    return {
+        nodesToCreate,
+        nodesToUpdate,
+        edgesToAdd,
+        edgesSkipped,
+        nodesSkipped,
+    };
+}
+//# sourceMappingURL=patch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../../src/core/graph/patch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAS1D,MAAM,UAAU,cAAc,CAAC,KAA2C;IACxE,OAAO;QACL,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,cAAc,CAAC,IAA6B,CAAC,CAAC;AACvD,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAoB,EACpB,UAAgD;IAEhD,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,aAAa,GAAgB,EAAE,CAAC;IACtC,MAAM,aAAa,GAAgB,EAAE,CAAC;IACtC,MAAM,YAAY,GAAgB,EAAE,CAAC;IACrC,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,YAAY,GAAgB,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QACD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,CAAC,EAAU,EAAW,EAAE,CAC1C,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAElD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1D,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,OAAO;QACL,aAAa;QACb,aAAa;QACb,UAAU;QACV,YAAY;QACZ,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/core/graph/path-target-edges.d.ts

@@ -1,2 +1,5 @@
-export { PATH_TARGET_EDGE_TYPES, isPathTargetEdge, } from "ai-spector-graph";
+import type { EdgeType } from "../../types.js";
+/** Edges whose `to` is a repo-relative path or external id, not a graph node id. */
+export declare const PATH_TARGET_EDGE_TYPES: ReadonlySet<EdgeType>;
+export declare function isPathTargetEdge(type: EdgeType): boolean;
 //# sourceMappingURL=path-target-edges.d.ts.map

package/dist/core/graph/path-target-edges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-target-edges.d.ts","sourceRoot":"","sources":["../../../src/core/graph/path-target-edges.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"path-target-edges.d.ts","sourceRoot":"","sources":["../../../src/core/graph/path-target-edges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,QAAQ,CAGvD,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAExD"}

package/dist/core/graph/path-target-edges.js

@@ -1,2 +1,9 @@
-export { PATH_TARGET_EDGE_TYPES, isPathTargetEdge, } from "ai-spector-graph";
+/** Edges whose `to` is a repo-relative path or external id, not a graph node id. */
+export const PATH_TARGET_EDGE_TYPES = new Set([
+    "rendersTo",
+    "derivedFrom",
+]);
+export function isPathTargetEdge(type) {
+    return PATH_TARGET_EDGE_TYPES.has(type);
+}
 //# sourceMappingURL=path-target-edges.js.map

package/dist/core/graph/path-target-edges.js.map

@@ -1 +1 @@
-{"version":3,"file":"path-target-edges.js","sourceRoot":"","sources":["../../../src/core/graph/path-target-edges.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"path-target-edges.js","sourceRoot":"","sources":["../../../src/core/graph/path-target-edges.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,MAAM,CAAC,MAAM,sBAAsB,GAA0B,IAAI,GAAG,CAAC;IACnE,WAAW;IACX,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,OAAO,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,77 @@
+import { type DocflowConfig, type LanguageConfig } from "./config.js";
+import { type GraphHealthSummary } from "./health.js";
+import type { ImpactResult, ImpactRulesFile } from "./impact.js";
+import { type LayerAuditOptions, type LayerAuditReport } from "./layer-audit.js";
+import { type AnalysisKnowledge, type KnowledgeCoverageReport, type KnowledgeStats } from "./knowledge.js";
+import { type ExtractPatch, type PatchSimulationResult } from "./patch.js";
+import { type RegistryDocument, type SectionRegistry } from "./registry.js";
+import { GraphSession, type GraphSessionOptions } from "./session.js";
+import { type ProjectState } from "./state.js";
+import { type StaleTranslationLink, type TranslationJob, type TranslationQueueBundleInput, type TranslationQueueData, type TranslationQueueStats } from "./translation-queue.js";
+import type { TraceabilityGraph, ValidationIssue } from "../../types.js";
+export interface ProjectBundle {
+    graph: TraceabilityGraph;
+    impactRules?: ImpactRulesFile;
+    /** Parsed or raw knowledge.json */
+    knowledge?: unknown;
+    /** Parsed or raw section-registry.json */
+    registry?: unknown;
+    /** Parsed or raw docflow.config.json */
+    config?: unknown;
+    /** Parsed or raw .ai-spector/.docflow/state.json */
+    state?: unknown;
+    /** Translation queue JSON from `.ai-spector/.docflow/translation-queue/` */
+    translationQueue?: TranslationQueueBundleInput;
+}
+export interface ProjectSessionOptions extends GraphSessionOptions {
+    knowledge?: AnalysisKnowledge | null;
+    registry?: SectionRegistry | null;
+    config?: DocflowConfig | null;
+    state?: ProjectState | null;
+    translationQueue?: TranslationQueueData | null;
+}
+/**
+ * Multi-file project facade: graph + optional knowledge + section registry.
+ * Pass JSON your API fetched; no HTTP inside this class.
+ */
+export declare class ProjectSession {
+    readonly graph: GraphSession;
+    private readonly knowledge;
+    private readonly registry;
+    private readonly config;
+    private readonly state;
+    private readonly translationQueue;
+    private constructor();
+    static fromBundle(bundle: ProjectBundle): ProjectSession;
+    static create(graph: TraceabilityGraph, options?: ProjectSessionOptions): ProjectSession;
+    hasKnowledge(): boolean;
+    hasRegistry(): boolean;
+    hasConfig(): boolean;
+    hasState(): boolean;
+    hasTranslationQueue(): boolean;
+    getKnowledge(): AnalysisKnowledge | null;
+    getRegistry(): SectionRegistry | null;
+    getConfig(): DocflowConfig | null;
+    getState(): ProjectState | null;
+    getTranslationQueue(): TranslationQueueData | null;
+    knowledgeStats(): KnowledgeStats;
+    knowledgeCoverage(): KnowledgeCoverageReport;
+    sectionLabel(sectionId: string): string | undefined;
+    registryDocuments(): RegistryDocument[];
+    languages(): LanguageConfig[];
+    primaryLanguage(): LanguageConfig | undefined;
+    languageCodes(): string[];
+    graphFilePath(): string | undefined;
+    lastIndexRunAt(): string | undefined;
+    lastGraphMergedAt(): string | undefined;
+    layerAudit(options?: LayerAuditOptions): LayerAuditReport;
+    simulatePatch(patch: ExtractPatch | Partial<ExtractPatch>): PatchSimulationResult;
+    validationIssues(): ValidationIssue[];
+    healthSummary(options?: LayerAuditOptions): GraphHealthSummary;
+    translationQueueStats(): TranslationQueueStats;
+    pendingTranslationJobs(): TranslationJob[];
+    failedTranslationJobs(): import("./translation-queue.js").FailedTranslationJob[];
+    jobsForProjectionPath(projectionPath: string): TranslationJob[];
+    linkStaleTranslations(impact: ImpactResult): StaleTranslationLink[];
+}
+//# sourceMappingURL=project.d.ts.map

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

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

package/dist/core/graph/project.js

@@ -0,0 +1,147 @@
+import { languageCodes, parseDocflowConfig, primaryLanguage, } from "./config.js";
+import { graphHealthSummary } from "./health.js";
+import { auditGraphLayers, } from "./layer-audit.js";
+import { computeKnowledgeStats, knowledgeGraphCoverage, parseKnowledge, } from "./knowledge.js";
+import { simulatePatch } from "./patch.js";
+import { parseSectionRegistry, registryDocuments, sectionLabel, } from "./registry.js";
+import { GraphSession } from "./session.js";
+import { lastGraphMergedAt, lastIndexRunAt, parseProjectState, } from "./state.js";
+import { computeTranslationQueueStats, linkStaleTranslationsToQueue, jobsForProjectionPath, parseTranslationQueueBundle, } from "./translation-queue.js";
+/**
+ * Multi-file project facade: graph + optional knowledge + section registry.
+ * Pass JSON your API fetched; no HTTP inside this class.
+ */
+export class ProjectSession {
+    graph;
+    knowledge;
+    registry;
+    config;
+    state;
+    translationQueue;
+    constructor(graph, knowledge, registry, config, state, translationQueue) {
+        this.graph = graph;
+        this.knowledge = knowledge;
+        this.registry = registry;
+        this.config = config;
+        this.state = state;
+        this.translationQueue = translationQueue;
+    }
+    static fromBundle(bundle) {
+        const knowledge = bundle.knowledge === undefined ? null : parseKnowledge(bundle.knowledge);
+        const registry = bundle.registry === undefined ? null : parseSectionRegistry(bundle.registry);
+        const config = bundle.config === undefined ? null : parseDocflowConfig(bundle.config);
+        const state = bundle.state === undefined ? null : parseProjectState(bundle.state);
+        const translationQueue = bundle.translationQueue === undefined
+            ? null
+            : parseTranslationQueueBundle(bundle.translationQueue);
+        const graph = GraphSession.fromJson(bundle.graph, {
+            impactRules: bundle.impactRules,
+        });
+        return new ProjectSession(graph, knowledge, registry, config, state, translationQueue);
+    }
+    static create(graph, options) {
+        const graphSession = GraphSession.fromJson(graph, {
+            impactRules: options?.impactRules,
+        });
+        return new ProjectSession(graphSession, options?.knowledge ?? null, options?.registry ?? null, options?.config ?? null, options?.state ?? null, options?.translationQueue ?? null);
+    }
+    hasKnowledge() {
+        return this.knowledge !== null;
+    }
+    hasRegistry() {
+        return this.registry !== null;
+    }
+    hasConfig() {
+        return this.config !== null;
+    }
+    hasState() {
+        return this.state !== null;
+    }
+    hasTranslationQueue() {
+        return this.translationQueue !== null;
+    }
+    getKnowledge() {
+        return this.knowledge;
+    }
+    getRegistry() {
+        return this.registry;
+    }
+    getConfig() {
+        return this.config;
+    }
+    getState() {
+        return this.state;
+    }
+    getTranslationQueue() {
+        return this.translationQueue;
+    }
+    knowledgeStats() {
+        return computeKnowledgeStats(this.knowledge);
+    }
+    knowledgeCoverage() {
+        return knowledgeGraphCoverage(this.knowledge, this.graph.graph);
+    }
+    sectionLabel(sectionId) {
+        if (!this.registry) {
+            return undefined;
+        }
+        return sectionLabel(this.registry, sectionId);
+    }
+    registryDocuments() {
+        if (!this.registry) {
+            return [];
+        }
+        return registryDocuments(this.registry);
+    }
+    languages() {
+        return this.config?.languages ?? [];
+    }
+    primaryLanguage() {
+        return this.config ? primaryLanguage(this.config) : undefined;
+    }
+    languageCodes() {
+        return this.config ? languageCodes(this.config) : [];
+    }
+    graphFilePath() {
+        return this.config?.paths.graph;
+    }
+    lastIndexRunAt() {
+        return this.state ? lastIndexRunAt(this.state) : undefined;
+    }
+    lastGraphMergedAt() {
+        return this.state ? lastGraphMergedAt(this.state) : undefined;
+    }
+    layerAudit(options) {
+        return auditGraphLayers(this.graph.graph, options);
+    }
+    simulatePatch(patch) {
+        return simulatePatch(this.graph.graph, patch);
+    }
+    validationIssues() {
+        return this.graph.graph.validateStructure();
+    }
+    healthSummary(options) {
+        return graphHealthSummary(this.graph.graph, auditGraphLayers(this.graph.graph, options));
+    }
+    translationQueueStats() {
+        return computeTranslationQueueStats(this.translationQueue ?? {
+            pending: [],
+            failed: [],
+            resolved: [],
+            fingerprints: null,
+        });
+    }
+    pendingTranslationJobs() {
+        return this.translationQueue?.pending ?? [];
+    }
+    failedTranslationJobs() {
+        return this.translationQueue?.failed ?? [];
+    }
+    jobsForProjectionPath(projectionPath) {
+        return jobsForProjectionPath(this.pendingTranslationJobs(), projectionPath);
+    }
+    linkStaleTranslations(impact) {
+        return linkStaleTranslationsToQueue(impact, this.pendingTranslationJobs());
+    }
+}
+//# sourceMappingURL=project.js.map