ai-spector 0.7.0 → 0.7.2

package/dist/core/graph/impact.js

@@ -1,6 +1,203 @@
 import { readJson } from "../util/fs.js";
-import { parseImpactRules, } from "ai-spector-graph";
-export { computeImpact, mergeImpactResults, parseImpactRules, DEFAULT_IMPACT_RULES, } from "ai-spector-graph";
+import { projectionPathForNode } from "./query.js";
+import { createRequire } from "module";
+const _require = createRequire(import.meta.url);
+const defaultImpactRules = _require("./rules/default-impact.json");
+function maxDepth(d) {
+    return d === "unbounded" ? 10_000 : d;
+}
+function runBfs(g, seeds, rules, globalSeen, maxNodes) {
+    const provenance = new Map();
+    const queue = seeds.map((id) => ({ id, depth: 0 }));
+    const cap = maxNodes;
+    let capped = false;
+    while (queue.length > 0) {
+        const { id: current, depth } = queue.shift();
+        if (depth >= cap) {
+            capped = true;
+            continue;
+        }
+        for (const [edgeType, rule] of Object.entries(rules)) {
+            const limit = maxDepth(rule.depth);
+            if (depth >= limit)
+                continue;
+            if (rule.direction === "out") {
+                for (const e of g.outEdges.get(current) ?? []) {
+                    if (e.type !== edgeType || globalSeen.has(e.to))
+                        continue;
+                    globalSeen.add(e.to);
+                    provenance.set(e.to, { fromId: current, edgeType });
+                    queue.push({ id: e.to, depth: depth + 1 });
+                }
+            }
+            else {
+                for (const e of g.inEdges.get(current) ?? []) {
+                    if (e.type !== edgeType || globalSeen.has(e.from))
+                        continue;
+                    globalSeen.add(e.from);
+                    provenance.set(e.from, { fromId: current, edgeType });
+                    queue.push({ id: e.from, depth: depth + 1 });
+                }
+            }
+        }
+    }
+    return { provenance, capped };
+}
+function makeEntry(g, id, prov) {
+    const node = g.nodesById.get(id);
+    return {
+        id,
+        type: node.type,
+        reason: `${prov.edgeType} from ${prov.fromId}`,
+        projectionPath: projectionPathForNode(g, id),
+    };
+}
+export function parseImpactRules(json) {
+    const raw = json;
+    if (raw.version !== 2) {
+        throw new Error(`rules.impact.json version ${raw.version ?? "unknown"} is not supported. Expected version 2.`);
+    }
+    return json;
+}
+export const DEFAULT_IMPACT_RULES = parseImpactRules(defaultImpactRules);
+export function computeImpact(g, originId, change, rules) {
+    const origin = g.nodesById.get(originId);
+    if (!origin)
+        throw new Error(`Unknown node: ${originId}`);
+    const result = {
+        origin: { id: originId, type: origin.type, change },
+        regenerate: [],
+        review: [],
+        affectedOutputPaths: [],
+    };
+    const regenerateTypes = new Set(rules.buckets.regenerate);
+    const reviewTypes = new Set(rules.buckets.review);
+    const globalSeen = new Set([originId]);
+    let truncated = false;
+    const maxNodes = rules.maxNodes ?? 500;
+    const { provenance: p1, capped: c1 } = runBfs(g, [originId], rules.pass1_expand, globalSeen, maxNodes);
+    if (c1)
+        truncated = true;
+    const domainSeeds = [];
+    for (const [id, prov] of p1) {
+        const node = g.nodesById.get(id);
+        if (!node)
+            continue;
+        if (regenerateTypes.has(node.type)) {
+            result.regenerate.push(makeEntry(g, id, prov));
+        }
+        else if (reviewTypes.has(node.type)) {
+            result.review.push(makeEntry(g, id, prov));
+            domainSeeds.push(id);
+        }
+    }
+    if (reviewTypes.has(origin.type)) {
+        domainSeeds.push(originId);
+    }
+    if (domainSeeds.length > 0) {
+        const { provenance: p2, capped: c2 } = runBfs(g, domainSeeds, rules.pass2_downstream, globalSeen, maxNodes);
+        if (c2)
+            truncated = true;
+        for (const [id, prov] of p2) {
+            const node = g.nodesById.get(id);
+            if (!node)
+                continue;
+            if (regenerateTypes.has(node.type)) {
+                result.regenerate.push(makeEntry(g, id, prov));
+            }
+            else if (reviewTypes.has(node.type)) {
+                result.review.push(makeEntry(g, id, prov));
+            }
+        }
+    }
+    if (truncated)
+        result.truncated = true;
+    result.regenerate.sort((a, b) => a.id.localeCompare(b.id));
+    result.review.sort((a, b) => a.id.localeCompare(b.id));
+    for (const entry of result.regenerate) {
+        for (const e of g.outEdges.get(entry.id) ?? []) {
+            if (e.type === "rendersTo")
+                result.affectedOutputPaths.push(e.to);
+        }
+    }
+    result.affectedOutputPaths.sort();
+    const affectedDocIds = new Set(result.regenerate.filter((e) => g.nodesById.get(e.id)?.type === "document").map((e) => e.id));
+    if (origin.type === "document")
+        affectedDocIds.add(originId);
+    const staleTranslations = [];
+    for (const docId of affectedDocIds) {
+        for (const e of g.inEdges.get(docId) ?? []) {
+            if (e.type !== "translationOf")
+                continue;
+            const n = g.nodesById.get(e.from);
+            if (!n)
+                continue;
+            staleTranslations.push({
+                id: e.from,
+                type: n.type,
+                reason: `translationOf ${docId}`,
+                projectionPath: projectionPathForNode(g, e.from),
+            });
+        }
+    }
+    if (staleTranslations.length > 0) {
+        staleTranslations.sort((a, b) => a.id.localeCompare(b.id));
+        result.staleTranslations = staleTranslations;
+    }
+    return result;
+}
+export function mergeImpactResults(results, gitSeeds) {
+    if (results.length === 0)
+        throw new Error("mergeImpactResults requires at least one result");
+    if (results.length === 1) {
+        const single = { ...results[0] };
+        if (gitSeeds?.length)
+            single.gitSeeds = gitSeeds;
+        return single;
+    }
+    const merged = {
+        origin: {
+            id: results.map((r) => r.origin.id).join(","),
+            type: "multi",
+            change: results[0].origin.change,
+        },
+        regenerate: [],
+        review: [],
+        affectedOutputPaths: [],
+        gitSeeds: gitSeeds ??
+            results.map((r) => ({
+                id: r.origin.id,
+                type: r.origin.type,
+                reason: r.resolvedFrom?.reason ?? "git diff seed",
+            })),
+    };
+    if (results.some((r) => r.truncated))
+        merged.truncated = true;
+    const seen = new Set();
+    for (const key of ["regenerate", "review"]) {
+        for (const r of results) {
+            for (const e of r[key]) {
+                const dk = `${key}:${e.id}`;
+                if (seen.has(dk))
+                    continue;
+                seen.add(dk);
+                merged[key].push(e);
+            }
+        }
+        merged[key].sort((a, b) => a.id.localeCompare(b.id));
+    }
+    const pathSeen = new Set();
+    for (const r of results) {
+        for (const p of r.affectedOutputPaths) {
+            if (!pathSeen.has(p)) {
+                pathSeen.add(p);
+                merged.affectedOutputPaths.push(p);
+            }
+        }
+    }
+    merged.affectedOutputPaths.sort();
+    return merged;
+}
 export async function loadImpactRules(path) {
     return parseImpactRules(await readJson(path));
 }

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

@@ -1 +1 @@
-{"version":3,"file":"impact.js","sourceRoot":"","sources":["../../../src/core/graph/impact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,OAAO,gBAAgB,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"impact.js","sourceRoot":"","sources":["../../../src/core/graph/impact.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,34 @@
+export { GraphSession } from "./session.js";
+export type { GraphSessionOptions, ResolveOriginsHints, ImpactOptions, } from "./session.js";
+export { ProjectSession } from "./project.js";
+export type { ProjectBundle, ProjectSessionOptions } from "./project.js";
+export { isKnowledgePayload, parseKnowledge, knowledgeHasDomainEntries, computeKnowledgeStats, knowledgeGraphCoverage, } from "./knowledge.js";
+export type { AnalysisKnowledge, KnowledgeActor, KnowledgeUseCase, KnowledgeFeature, KnowledgeRequirement, KnowledgeEntity, KnowledgeStats, KnowledgeCategory, KnowledgeCoverageRow, KnowledgeCoverageCategory, KnowledgeCoverageReport, } from "./knowledge.js";
+export { parseSectionRegistry, findRegistryDocument, findRegistrySection, sectionHeading, sectionLabel, documentTemplate, registryDocuments, allRegistrySections, } from "./registry.js";
+export type { RegistrySection, RegistryDocument, SectionRegistry, } from "./registry.js";
+export { parseDocflowConfig, primaryLanguage, languageCodes, } from "./config.js";
+export type { DocflowConfig, DocflowProjectPaths, LanguageConfig, } from "./config.js";
+export { parseProjectState, lastIndexRunAt, lastGraphMergedAt, } from "./state.js";
+export type { ProjectState, ProjectAnalysisState, ProjectIndexState, } from "./state.js";
+export { auditGraphLayers, BUNDLE_SOURCE_ID, BUNDLE_BUSINESS_ID, } from "./layer-audit.js";
+export type { LayerAuditLayers, LayerAuditReport, LayerAuditOptions, } from "./layer-audit.js";
+export { normalizePatch, parseExtractPatch, simulatePatch, } from "./patch.js";
+export type { ExtractPatch, PatchSimulationResult } from "./patch.js";
+export { parseDocFilePath, resolveDocPath, jobGroupKey, parsePendingQueue, parseFailedJobs, parseResolvedJobs, parseFingerprints, parseTranslationQueueBundle, computeTranslationQueueStats, jobsForProjectionPath, linkStaleTranslationsToQueue, pendingTargetLangs, } from "./translation-queue.js";
+export type { SyncDirection, FailReason, DocType, FileChangeRecord, TranslationTarget, TranslationJob, PendingQueueFile, ResolvedTranslationJob, FailedTranslationJob, FileFingerprint, FingerprintsFile, TranslationQueueBundleInput, TranslationQueueData, TranslationQueueStats, StaleTranslationLink, } from "./translation-queue.js";
+export { summarizeValidation, layersNeedingWork, graphHealthSummary, } from "./health.js";
+export type { GraphHealthSummary } from "./health.js";
+export { InMemoryGraph } from "./InMemoryGraph.js";
+export { PATH_TARGET_EDGE_TYPES, isPathTargetEdge, } from "./path-target-edges.js";
+export { querySubgraph, resolveDocumentForNode, projectionPathForNode, dataSourcePathsForNode, } from "./query.js";
+export type { QueryOptions, GraphQueryResult } from "./query.js";
+export { computeImpact, mergeImpactResults, parseImpactRules, DEFAULT_IMPACT_RULES, } from "./impact.js";
+export type { ImpactRulesFile, ImpactEntry, ImpactResult, } from "./impact.js";
+export { resolveImpactOrigins, pickPrimaryImpactOrigin, findDocumentNodeIdForPath, findSectionNodeIdByAnchor, findSectionNodeIdsByHeading, findNodeIdsByText, looksLikeExplicitNodeId, globToRegExp, } from "./resolve.js";
+export type { ResolveHints, ResolvedOrigin } from "./resolve.js";
+export { computeGraphStats } from "./stats.js";
+export type { GraphStats } from "./stats.js";
+export { expandPathTargetNodes, nodesForVisualization, fileNodeId, sourceNodeId, } from "./expand-path-nodes.js";
+export type { SyntheticPathNode, SyntheticNodeType, ExpandPathTargetOptions, ExpandedPathTargets, } from "./expand-path-nodes.js";
+export type { NodeType, EdgeType, GraphNode, GraphEdge, TraceabilityGraph, ValidationIssue, } from "../../types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,GACxB,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;AACvB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEtE,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;AAChC,YAAY,EACV,aAAa,EACb,UAAU,EACV,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,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;AACpB,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,EACV,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/core/graph/index.js

@@ -0,0 +1,18 @@
+export { GraphSession } from "./session.js";
+export { ProjectSession } 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 { 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";
+export { parseDocFilePath, resolveDocPath, jobGroupKey, parsePendingQueue, parseFailedJobs, parseResolvedJobs, parseFingerprints, parseTranslationQueueBundle, computeTranslationQueueStats, jobsForProjectionPath, linkStaleTranslationsToQueue, pendingTargetLangs, } from "./translation-queue.js";
+export { summarizeValidation, layersNeedingWork, graphHealthSummary, } from "./health.js";
+export { InMemoryGraph } from "./InMemoryGraph.js";
+export { PATH_TARGET_EDGE_TYPES, isPathTargetEdge, } from "./path-target-edges.js";
+export { querySubgraph, resolveDocumentForNode, projectionPathForNode, dataSourcePathsForNode, } from "./query.js";
+export { computeImpact, mergeImpactResults, parseImpactRules, DEFAULT_IMPACT_RULES, } from "./impact.js";
+export { resolveImpactOrigins, pickPrimaryImpactOrigin, findDocumentNodeIdForPath, findSectionNodeIdByAnchor, findSectionNodeIdsByHeading, findNodeIdsByText, looksLikeExplicitNodeId, globToRegExp, } from "./resolve.js";
+export { computeGraphStats } from "./stats.js";
+export { expandPathTargetNodes, nodesForVisualization, fileNodeId, sourceNodeId, } from "./expand-path-nodes.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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,MAAM,cAAc,CAAC;AAG9C,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"}

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

@@ -1,11 +1,88 @@
-import type { AnalysisKnowledge } from "ai-spector-graph";
 import type { GraphEdge, GraphNode } from "../../types.js";
-export type { AnalysisKnowledge, KnowledgeActor, KnowledgeUseCase, KnowledgeFeature, KnowledgeRequirement, KnowledgeEntity, } from "ai-spector-graph";
-export { isKnowledgePayload, knowledgeHasDomainEntries, } from "ai-spector-graph";
+import type { InMemoryGraph } from "./InMemoryGraph.js";
+import type { NodeType } from "../../types.js";
+export interface AnalysisKnowledge {
+    knowledgeVersion?: number;
+    actors?: KnowledgeActor[];
+    useCases?: KnowledgeUseCase[];
+    features?: KnowledgeFeature[];
+    functionalRequirements?: KnowledgeRequirement[];
+    nfrs?: KnowledgeRequirement[];
+    entities?: KnowledgeEntity[];
+}
+export interface KnowledgeActor {
+    id: string;
+    name?: string;
+    title?: string;
+    description?: string;
+    listedInSection?: string;
+}
+export interface KnowledgeUseCase {
+    id: string;
+    title: string;
+    priority?: string;
+    description?: string;
+    listedInSection?: string;
+}
+export interface KnowledgeFeature {
+    id: string;
+    title: string;
+    description?: string;
+    listedInSection?: string;
+    satisfies?: string[];
+}
+export interface KnowledgeRequirement {
+    id: string;
+    title: string;
+    description?: string;
+    listedInSection?: string;
+    tracesTo?: string[];
+}
+export interface KnowledgeEntity {
+    id: string;
+    name: string;
+    description?: string;
+    listedInSection?: string;
+}
+export interface KnowledgeStats {
+    present: boolean;
+    actors: number;
+    useCases: number;
+    features: number;
+    functionalRequirements: number;
+    nfrs: number;
+    entities: number;
+}
+export type KnowledgeCategory = "actor" | "useCase" | "feature" | "requirement" | "nfr" | "dataEntity";
+export interface KnowledgeCoverageRow {
+    id: string;
+    category: KnowledgeCategory;
+    inGraph: boolean;
+    graphNodeType?: NodeType;
+    /** Raw knowledge fields for UI display (title, name, priority, satisfies, tracesTo, …). */
+    data: Record<string, unknown>;
+}
+export interface KnowledgeCoverageCategory {
+    category: KnowledgeCategory;
+    label: string;
+    total: number;
+    inGraph: number;
+    rows: KnowledgeCoverageRow[];
+}
+export interface KnowledgeCoverageReport {
+    present: boolean;
+    categories: KnowledgeCoverageCategory[];
+}
 export interface ExtractPatch {
     version: 1;
     nodes: GraphNode[];
     edges: GraphEdge[];
 }
+export declare function isKnowledgePayload(data: unknown): data is AnalysisKnowledge;
+export declare function parseKnowledge(json: unknown): AnalysisKnowledge | null;
+export declare function knowledgeHasDomainEntries(knowledge: AnalysisKnowledge): boolean;
+export declare function computeKnowledgeStats(knowledge: AnalysisKnowledge | null): KnowledgeStats;
+/** Compare knowledge.json entries against merged graph nodes (parity with graph visualize Knowledge tab). */
+export declare function knowledgeGraphCoverage(knowledge: AnalysisKnowledge | null, g: InMemoryGraph): KnowledgeCoverageReport;
 export declare function knowledgeToPatch(knowledge: AnalysisKnowledge): ExtractPatch;
 //# sourceMappingURL=knowledge.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../src/core/graph/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAMlB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3D,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAsBD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,GAAG,YAAY,CA8D3E"}
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../src/core/graph/knowledge.ts"],"names":[],"mappings":"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"}

package/dist/core/graph/knowledge.js

@@ -1,5 +1,88 @@
 import { DEFAULT_LISTED_IN } from "./defaults.js";
-export { isKnowledgePayload, knowledgeHasDomainEntries, } from "ai-spector-graph";
+const CATEGORY_META = [
+    { key: "actors", category: "actor", label: "Actors" },
+    { key: "useCases", category: "useCase", label: "Use cases" },
+    { key: "features", category: "feature", label: "Features" },
+    { key: "functionalRequirements", category: "requirement", label: "Functional requirements" },
+    { key: "nfrs", category: "nfr", label: "NFRs" },
+    { key: "entities", category: "dataEntity", label: "Data entities" },
+];
+export function isKnowledgePayload(data) {
+    if (!data || typeof data !== "object") {
+        return false;
+    }
+    const k = data;
+    return ("knowledgeVersion" in k ||
+        Array.isArray(k.useCases) ||
+        Array.isArray(k.features) ||
+        Array.isArray(k.actors));
+}
+export function parseKnowledge(json) {
+    return isKnowledgePayload(json) ? json : null;
+}
+export function knowledgeHasDomainEntries(knowledge) {
+    return ((knowledge.useCases?.length ?? 0) > 0 ||
+        (knowledge.features?.length ?? 0) > 0 ||
+        (knowledge.actors?.length ?? 0) > 0 ||
+        (knowledge.functionalRequirements?.length ?? 0) > 0 ||
+        (knowledge.nfrs?.length ?? 0) > 0 ||
+        (knowledge.entities?.length ?? 0) > 0);
+}
+export function computeKnowledgeStats(knowledge) {
+    if (!knowledge) {
+        return {
+            present: false,
+            actors: 0,
+            useCases: 0,
+            features: 0,
+            functionalRequirements: 0,
+            nfrs: 0,
+            entities: 0,
+        };
+    }
+    return {
+        present: knowledgeHasDomainEntries(knowledge),
+        actors: knowledge.actors?.length ?? 0,
+        useCases: knowledge.useCases?.length ?? 0,
+        features: knowledge.features?.length ?? 0,
+        functionalRequirements: knowledge.functionalRequirements?.length ?? 0,
+        nfrs: knowledge.nfrs?.length ?? 0,
+        entities: knowledge.entities?.length ?? 0,
+    };
+}
+function rowData(item) {
+    const { id: _id, ...rest } = item;
+    return rest;
+}
+function coverageCategory(g, label, category, items) {
+    const rows = (items ?? []).map((item) => {
+        const node = g.nodesById.get(item.id);
+        return {
+            id: item.id,
+            category,
+            inGraph: Boolean(node),
+            graphNodeType: node?.type,
+            data: rowData(item),
+        };
+    });
+    const inGraph = rows.filter((r) => r.inGraph).length;
+    return { category, label, total: rows.length, inGraph, rows };
+}
+/** Compare knowledge.json entries against merged graph nodes (parity with graph visualize Knowledge tab). */
+export function knowledgeGraphCoverage(knowledge, g) {
+    if (!knowledge || !knowledgeHasDomainEntries(knowledge)) {
+        return { present: false, categories: [] };
+    }
+    const categories = [];
+    for (const { key, category, label } of CATEGORY_META) {
+        const items = knowledge[key];
+        if (!items?.length) {
+            continue;
+        }
+        categories.push(coverageCategory(g, label, category, items));
+    }
+    return { present: true, categories };
+}
 function pickNodeFields(item, id, type) {
     const node = { id, type };
     for (const [key, value] of Object.entries(item)) {

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

@@ -1 +1 @@
-{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../../src/core/graph/knowledge.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAWlD,OAAO,EACL,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAQ1B,SAAS,cAAc,CACrB,IAA6B,EAC7B,EAAU,EACV,IAAuB;IAEvB,MAAM,IAAI,GAAc,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,iBAAiB,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YAC3F,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACtD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAA4B;IAC3D,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,IAAI,iBAAiB,CAAC,KAAK,CAAC;QACjE,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,KAA2C,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAC/E,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,EAAE,CAAC,eAAe,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAChE,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,EAAwC,EAAE,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAC3E,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,CAAC,CAAC,eAAe,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAC/D,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,CAAuC,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CACzE,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,sBAAsB,IAAI,EAAE,EAAE,CAAC;QACzD,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,IAAI,iBAAiB,CAAC,qBAAqB,CAAC;QAC/E,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,GAAyC,EAAE,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC,CACjF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5D,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,IAAI,iBAAiB,CAAC,GAAG,CAAC;QAC7D,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,GAAyC,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CACzE,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/D,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,IAAI,iBAAiB,CAAC,UAAU,CAAC;QACpE,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,GAAyC,EAAE,GAAG,CAAC,EAAE,EAAE,YAAY,CAAC,CAChF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC"}
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../../src/core/graph/knowledge.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAiGlD,MAAM,aAAa,GAAmF;IACpG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE;IACrD,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE;IAC5D,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE;IAC3D,EAAE,GAAG,EAAE,wBAAwB,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,yBAAyB,EAAE;IAC5F,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;IAC/C,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE;CACpE,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,GAAG,IAA+B,CAAC;IAC1C,OAAO,CACL,kBAAkB,IAAI,CAAC;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,SAA4B;IACpE,OAAO,CACL,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QACrC,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QACrC,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QACnC,CAAC,SAAS,CAAC,sBAAsB,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QACnD,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QACjC,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,SAAmC;IAEnC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,CAAC;YACT,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;YACX,sBAAsB,EAAE,CAAC;YACzB,IAAI,EAAE,CAAC;YACP,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,yBAAyB,CAAC,SAAS,CAAC;QAC7C,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;QACrC,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;QACzC,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;QACzC,sBAAsB,EAAE,SAAS,CAAC,sBAAsB,EAAE,MAAM,IAAI,CAAC;QACrE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;QACjC,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,IAA6B;IAC5C,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CACvB,CAAgB,EAChB,KAAa,EACb,QAA2B,EAC3B,KAAkE;IAElE,MAAM,IAAI,GAA2B,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9D,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,QAAQ;YACR,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC;YACtB,aAAa,EAAE,IAAI,EAAE,IAAI;YACzB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;SACpB,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACrD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAChE,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,sBAAsB,CACpC,SAAmC,EACnC,CAAgB;IAEhB,IAAI,CAAC,SAAS,IAAI,CAAC,yBAAyB,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,UAAU,GAAgC,EAAE,CAAC;IACnD,KAAK,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,aAAa,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAgE,CAAC;QAC5F,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YACnB,SAAS;QACX,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,cAAc,CACrB,IAA6B,EAC7B,EAAU,EACV,IAAuB;IAEvB,MAAM,IAAI,GAAc,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,iBAAiB,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YAC3F,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACtD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAA4B;IAC3D,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,IAAI,iBAAiB,CAAC,KAAK,CAAC;QACjE,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,KAA2C,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAC/E,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,EAAE,CAAC,eAAe,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAChE,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,EAAwC,EAAE,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAC3E,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,CAAC,CAAC,eAAe,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAC/D,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,CAAuC,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CACzE,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,sBAAsB,IAAI,EAAE,EAAE,CAAC;QACzD,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,IAAI,iBAAiB,CAAC,qBAAqB,CAAC;QAC/E,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,GAAyC,EAAE,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC,CACjF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5D,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,IAAI,iBAAiB,CAAC,GAAG,CAAC;QAC7D,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,GAAyC,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CACzE,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/D,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,IAAI,iBAAiB,CAAC,UAAU,CAAC;QACpE,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,GAAyC,EAAE,GAAG,CAAC,EAAE,EAAE,YAAY,CAAC,CAChF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC"}

package/dist/core/graph/layer-audit.d.ts

@@ -1,5 +1,64 @@
-import { type LayerAuditReport } from "ai-spector-graph";
 import type { InMemoryGraph } from "./InMemoryGraph.js";
-export type { LayerAuditLayers, LayerAuditReport } from "ai-spector-graph";
-export declare function auditGraphLayers(graph: InMemoryGraph, projectRoot?: string): Promise<LayerAuditReport>;
+export declare const BUNDLE_SOURCE_ID = "bundle.source";
+export declare const BUNDLE_BUSINESS_ID = "bundle.business";
+export interface LayerAuditLayers {
+    structure: {
+        documents: number;
+        sections: number;
+        ok: boolean;
+    };
+    specInstances: {
+        useCaseDocs: number;
+        featureDocs: number;
+        sections: number;
+        ok: boolean;
+        missingOnDisk: string[];
+    };
+    domain: {
+        useCases: number;
+        features: number;
+        actors: number;
+        ok: boolean;
+    };
+    sourceHub: {
+        bundlePresent: boolean;
+        sourceFiles: number;
+        ok: boolean;
+    };
+    businessHub: {
+        bundlePresent: boolean;
+        domainMembers: number;
+        ok: boolean;
+    };
+    provenance: {
+        derivedFrom: number;
+        domainsWithoutSource: string[];
+        ok: boolean;
+    };
+    semanticLinks: {
+        relatesTo: number;
+        domainsWithoutSemanticLinks: string[];
+        ok: boolean;
+    };
+}
+export interface LayerAuditReport {
+    layers: LayerAuditLayers;
+    suggestedCommand?: string;
+    suggestedAgentCommand?: string;
+}
+export interface LayerAuditOptions {
+    /**
+     * Repo-relative paths known to exist on disk (from your backend).
+     * Used to populate specInstances.missingOnDisk — UC detail files on disk but not in graph.
+     */
+    existingPaths?: Iterable<string>;
+    /**
+     * Override the regex used to identify UC detail files on disk.
+     * Defaults to /docs\/srs\/.*\/uc-\d+.*\.md$/i — projects with a different
+     * folder structure should supply their own pattern here.
+     */
+    ucDetailPathPattern?: RegExp;
+}
+/** Tri-layer health report (parity with `ai-spector graph report`). Sync, browser-safe. */
+export declare function auditGraphLayers(graph: InMemoryGraph, options?: LayerAuditOptions): LayerAuditReport;
 //# sourceMappingURL=layer-audit.d.ts.map

package/dist/core/graph/layer-audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layer-audit.d.ts","sourceRoot":"","sources":["../../../src/core/graph/layer-audit.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAkB3E,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,aAAa,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAQ3B"}
+{"version":3,"file":"layer-audit.d.ts","sourceRoot":"","sources":["../../../src/core/graph/layer-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAChD,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AAapD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,OAAO,CAAC;KACb,CAAC;IACF,aAAa,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,OAAO,CAAC;QACZ,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,EAAE,EAAE,OAAO,CAAC;KACb,CAAC;IACF,SAAS,EAAE;QACT,aAAa,EAAE,OAAO,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC;KACb,CAAC;IACF,WAAW,EAAE;QACX,aAAa,EAAE,OAAO,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,EAAE,EAAE,OAAO,CAAC;KACb,CAAC;IACF,UAAU,EAAE;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,EAAE,EAAE,OAAO,CAAC;KACb,CAAC;IACF,aAAa,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,2BAA2B,EAAE,MAAM,EAAE,CAAC;QACtC,EAAE,EAAE,OAAO,CAAC;KACb,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AA0LD,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAmFlB"}