ai-spector 0.2.0 → 0.2.2

package/dist/graph/provenance.js

@@ -0,0 +1,221 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { defaultGraphifyJsonPath, graphifyNodeTargetId, isGraphifyNodeTarget, loadGraphifyIndex, } from "../graphify/graph-index.js";
+import { isKnowledgePayload, knowledgeHasDomainEntries } from "./knowledge.js";
+import { mergePatch } from "./merge.js";
+import { loadInMemoryGraph } from "./loadGraph.js";
+import { pathExists, readJson, writeJson } from "../util/fs.js";
+import { discoverMarkdownFiles } from "../index/docs-build.js";
+import { indexDocsConfigPath } from "../index/docs-config.js";
+import { extractSourceRefsFromMarkdown } from "./source-refs.js";
+function collectKnowledgeRefs(item) {
+    const out = [];
+    const fields = ["derivedFrom", "sourceRefs", "sources", "sourceFiles", "source"];
+    for (const key of fields) {
+        const v = item[key];
+        if (typeof v === "string" && v.trim()) {
+            out.push(v.trim());
+        }
+        else if (Array.isArray(v)) {
+            for (const x of v) {
+                if (typeof x === "string" && x.trim()) {
+                    out.push(x.trim());
+                }
+            }
+        }
+    }
+    return out;
+}
+function resolveRefToTargets(ref, dataSourceRoot, graphify) {
+    const targets = new Set();
+    if (ref.startsWith("graphify:") && graphify) {
+        const id = ref.slice("graphify:".length);
+        if (graphify.nodes.some((n) => n.id === id)) {
+            targets.add(ref);
+        }
+        return [...targets];
+    }
+    const normalized = normalizeDataSourcePath(ref, dataSourceRoot);
+    if (normalized) {
+        targets.add(normalized);
+        const nodeIds = graphify?.byRepoPath.get(normalized);
+        if (nodeIds?.length === 1) {
+            targets.add(graphifyNodeTargetId(nodeIds[0]));
+        }
+        return [...targets];
+    }
+    if (graphify && !ref.includes("/")) {
+        const key = ref.trim().toLowerCase();
+        const byLabel = graphify.byLabel.get(key);
+        if (byLabel?.length === 1) {
+            targets.add(graphifyNodeTargetId(byLabel[0]));
+        }
+        const idMatch = graphify.nodes.find((n) => n.id === ref);
+        if (idMatch) {
+            targets.add(graphifyNodeTargetId(idMatch.id));
+        }
+    }
+    return [...targets];
+}
+/** Normalize to repo-relative path under docs/data-source when possible. */
+export function normalizeDataSourcePath(ref, dataSourceRoot) {
+    let s = ref
+        .trim()
+        .replace(/^[`'"]+|[`'"]+$/g, "")
+        .replace(/\\/g, "/");
+    if (!s || s.includes("://")) {
+        return undefined;
+    }
+    const root = dataSourceRoot.replace(/\\/g, "/").replace(/\/$/, "");
+    if (s.startsWith(root + "/")) {
+        return s;
+    }
+    if (s.startsWith("docs/data-source/")) {
+        return s.replace(/\/+/g, "/");
+    }
+    if (!s.includes("/") && /\.[a-z0-9]{1,8}$/i.test(s)) {
+        return `${root}/${s}`;
+    }
+    if (!s.startsWith("docs/") && !s.startsWith("/")) {
+        const candidate = `${root}/${s.replace(/^\.\//, "")}`;
+        if (candidate.startsWith(root)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+function domainIdFromDetailContent(content, kind) {
+    if (kind === "useCase") {
+        const m = content.match(/\*\*Use Case ID:\*\*\s*(UC-\d+)/i);
+        return m?.[1] ? m[1].replace(/(UC-)(\d+)/i, (_, p, n) => `${p}${n.padStart(2, "0")}`) : null;
+    }
+    const m = content.match(/\*\*Feature ID:\*\*\s*(F-\d+)/i);
+    return m?.[1] ? m[1].replace(/(F-)(\d+)/i, (_, p, n) => `${p}${n.padStart(2, "0")}`) : null;
+}
+function buildProvenancePatch(domainRefs, dataSourceRoot, graphify, validDomainIds) {
+    const edges = [];
+    const edgeKeys = new Set();
+    for (const [domainId, refs] of domainRefs) {
+        if (!validDomainIds.has(domainId)) {
+            continue;
+        }
+        for (const ref of refs) {
+            for (const to of resolveRefToTargets(ref, dataSourceRoot, graphify)) {
+                if (isGraphifyNodeTarget(to) && !graphify) {
+                    continue;
+                }
+                const key = `${domainId}|derivedFrom|${to}`;
+                if (edgeKeys.has(key)) {
+                    continue;
+                }
+                edgeKeys.add(key);
+                edges.push({ type: "derivedFrom", from: domainId, to });
+            }
+        }
+    }
+    return { version: 1, nodes: [], edges };
+}
+export async function collectDomainProvenanceRefs(opts) {
+    const domainRefs = new Map();
+    const addRef = (domainId, ref) => {
+        if (!domainId || !ref.trim()) {
+            return;
+        }
+        const set = domainRefs.get(domainId) ?? new Set();
+        set.add(ref.trim());
+        domainRefs.set(domainId, set);
+    };
+    const knowledgePath = opts.knowledgePath ??
+        join(opts.projectRoot, ".ai-spector/.docflow/analysis/knowledge.json");
+    if (await pathExists(knowledgePath)) {
+        const raw = await readJson(knowledgePath);
+        if (isKnowledgePayload(raw) && knowledgeHasDomainEntries(raw)) {
+            const k = raw;
+            const lists = [
+                { items: k.useCases },
+                { items: k.features },
+                { items: k.actors },
+                { items: k.functionalRequirements },
+                { items: k.nfrs },
+                { items: k.entities },
+            ];
+            for (const { items } of lists) {
+                for (const item of items ?? []) {
+                    const id = String(item.id ?? "");
+                    for (const ref of collectKnowledgeRefs(item)) {
+                        addRef(id, ref);
+                    }
+                }
+            }
+        }
+    }
+    const configPath = indexDocsConfigPath(opts.projectRoot);
+    if (await pathExists(configPath)) {
+        const config = await readJson(configPath);
+        const entries = [];
+        for (const key of ["srs", "basicDesign"]) {
+            const source = config.sources[key];
+            if (!source?.root) {
+                continue;
+            }
+            const files = await discoverMarkdownFiles(opts.projectRoot, source.root, source.glob ?? "**/*.md");
+            for (const f of files) {
+                const content = await readFile(join(opts.projectRoot, f.relativePath), "utf8");
+                entries.push({ relativePath: f.relativePath, content });
+            }
+        }
+        for (const e of entries) {
+            const refs = extractSourceRefsFromMarkdown(e.content);
+            if (refs.length === 0) {
+                continue;
+            }
+            let domainId = null;
+            if (/\/03-use-cases\//i.test(e.relativePath) || /\/uc-\d+/i.test(e.relativePath)) {
+                domainId = domainIdFromDetailContent(e.content, "useCase");
+            }
+            else if (/\/04-system-features\/f-\d+/i.test(e.relativePath)) {
+                domainId = domainIdFromDetailContent(e.content, "feature");
+            }
+            if (!domainId) {
+                continue;
+            }
+            for (const ref of refs) {
+                addRef(domainId, ref);
+            }
+        }
+    }
+    return domainRefs;
+}
+export async function runProvenanceLink(opts) {
+    const dataSourceRoot = opts.dataSourceRoot ?? "docs/data-source";
+    const graphifyPath = opts.graphifyJsonPath ?? defaultGraphifyJsonPath(opts.projectRoot);
+    const graphify = await loadGraphifyIndex(graphifyPath, dataSourceRoot);
+    const domainRefs = await collectDomainProvenanceRefs({
+        ...opts,
+        dataSourceRoot,
+    });
+    const graph = await loadInMemoryGraph(opts.graphPath);
+    const validDomainIds = new Set([...graph.nodesById.values()]
+        .filter((n) => ["actor", "useCase", "feature", "requirement", "dataEntity"].includes(n.type))
+        .map((n) => n.id));
+    const patch = buildProvenancePatch(domainRefs, dataSourceRoot, graphify, validDomainIds);
+    if (patch.edges.length === 0) {
+        return {
+            merged: false,
+            detail: "No provenance evidence found (derivedFrom not added)",
+            edgesAdded: 0,
+            domainNodesLinked: 0,
+        };
+    }
+    const linkedDomains = new Set(patch.edges.map((e) => e.from));
+    const { stats } = mergePatch(graph, patch);
+    await writeJson(opts.graphPath, graph.toTraceabilityGraph());
+    const existing = [...linkedDomains].filter((id) => graph.nodesById.has(id));
+    return {
+        merged: true,
+        detail: `linked ${existing.length} domain node(s), +${stats.edgesAdded} derivedFrom edge(s)`,
+        edgesAdded: stats.edgesAdded,
+        domainNodesLinked: existing.length,
+    };
+}
+//# sourceMappingURL=provenance.js.map

package/dist/graph/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../../src/graph/provenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAElB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAwB,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAiBjE,SAAS,oBAAoB,CAC3B,IAA6B;IAE7B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,CAAC,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;IACjF,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5B,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;oBACtC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,mBAAmB,CAC1B,GAAW,EACX,cAAsB,EACtB,QAA8B;IAE9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,UAAU,GAAG,uBAAuB,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAChE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxB,MAAM,OAAO,GAAG,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,OAAO,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;QACzD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACtB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB,CACrC,GAAW,EACX,cAAsB;IAEtB,IAAI,CAAC,GAAG,GAAG;SACR,IAAI,EAAE;SACN,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;QACtD,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,yBAAyB,CAChC,OAAe,EACf,IAA2B;IAE3B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC5D,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/F,CAAC;IACD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9F,CAAC;AAED,SAAS,oBAAoB,CAC3B,UAAoC,EACpC,cAAsB,EACtB,QAA8B,EAC9B,cAA2B;IAE3B,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,UAAU,EAAE,CAAC;QAC1C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,SAAS;QACX,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,KAAK,MAAM,EAAE,IAAI,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACpE,IAAI,oBAAoB,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAC1C,SAAS;gBACX,CAAC;gBACD,MAAM,GAAG,GAAG,GAAG,QAAQ,gBAAgB,EAAE,EAAE,CAAC;gBAC5C,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACtB,SAAS;gBACX,CAAC;gBACD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,IAAwD;IAExD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;IAClD,MAAM,MAAM,GAAG,CAAC,QAAgB,EAAE,GAAW,EAAE,EAAE;QAC/C,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;QAC1D,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACpB,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC;IAEF,MAAM,aAAa,GACjB,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,8CAA8C,CAAC,CAAC;IACzE,IAAI,MAAM,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAU,aAAa,CAAC,CAAC;QACnD,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,yBAAyB,CAAC,GAAwB,CAAC,EAAE,CAAC;YACnF,MAAM,CAAC,GAAG,GAAwB,CAAC;YACnC,MAAM,KAAK,GAAsD;gBAC/D,EAAE,KAAK,EAAE,CAAC,CAAC,QAAsD,EAAE;gBACnE,EAAE,KAAK,EAAE,CAAC,CAAC,QAAsD,EAAE;gBACnE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAoD,EAAE;gBACjE,EAAE,KAAK,EAAE,CAAC,CAAC,sBAAoE,EAAE;gBACjF,EAAE,KAAK,EAAE,CAAC,CAAC,IAAkD,EAAE;gBAC/D,EAAE,KAAK,EAAE,CAAC,CAAC,QAAsD,EAAE;aACpE,CAAC;YACF,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,CAAC;gBAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;oBAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;oBACjC,KAAK,MAAM,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC7C,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;oBAClB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzD,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAkB,UAAU,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAqD,EAAE,CAAC;QACrE,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,aAAa,CAAU,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;gBAClB,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,qBAAqB,CACvC,IAAI,CAAC,WAAW,EAChB,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,IAAI,IAAI,SAAS,CACzB,CAAC;YACF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAC5B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,EACtC,MAAM,CACP,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,6BAA6B,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACtD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,SAAS;YACX,CAAC;YACD,IAAI,QAAQ,GAAkB,IAAI,CAAC;YACnC,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;gBACjF,QAAQ,GAAG,yBAAyB,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC7D,CAAC;iBAAM,IAAI,8BAA8B,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC/D,QAAQ,GAAG,yBAAyB,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YACD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAA2B;IAE3B,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,kBAAkB,CAAC;IACjE,MAAM,YAAY,GAChB,IAAI,CAAC,gBAAgB,IAAI,uBAAuB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAG,MAAM,2BAA2B,CAAC;QACnD,GAAG,IAAI;QACP,cAAc;KACf,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,IAAI,GAAG,CAC5B,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACZ,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC,QAAQ,CACnE,CAAC,CAAC,IAAI,CACP,CACF;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACpB,CAAC;IAEF,MAAM,KAAK,GAAG,oBAAoB,CAChC,UAAU,EACV,cAAc,EACd,QAAQ,EACR,cAAc,CACf,CAAC;IACF,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,sDAAsD;YAC9D,UAAU,EAAE,CAAC;YACb,iBAAiB,EAAE,CAAC;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5E,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,UAAU,QAAQ,CAAC,MAAM,qBAAqB,KAAK,CAAC,UAAU,sBAAsB;QAC5F,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,iBAAiB,EAAE,QAAQ,CAAC,MAAM;KACnC,CAAC;AACJ,CAAC"}

package/dist/graph/query.d.ts

@@ -14,5 +14,6 @@ export interface GraphQueryResult {
 }
 export declare function resolveDocumentForNode(g: InMemoryGraph, nodeId: string): GraphNode | undefined;
 export declare function projectionPathForNode(g: InMemoryGraph, nodeId: string): string | undefined;
+export declare function dataSourcePathsForNode(g: InMemoryGraph, nodeId: string): string[];
 export declare function querySubgraph(g: InMemoryGraph, seedId: string, opts?: QueryOptions): GraphQueryResult;
 //# sourceMappingURL=query.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/graph/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAeD,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,aAAa,EAChB,MAAM,EAAE,MAAM,GACb,SAAS,GAAG,SAAS,CAgCvB;AAED,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,aAAa,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAiCpB;AAED,wBAAgB,aAAa,CAC3B,CAAC,EAAE,aAAa,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,YAAiB,GACtB,gBAAgB,CA+DlB"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/graph/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAgBD,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,aAAa,EAChB,MAAM,EAAE,MAAM,GACb,SAAS,GAAG,SAAS,CAgCvB;AAED,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,aAAa,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAiCpB;AAED,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,aAAa,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,EAAE,CAQV;AAED,wBAAgB,aAAa,CAC3B,CAAC,EAAE,aAAa,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,YAAiB,GACtB,gBAAgB,CAkElB"}

package/dist/graph/query.js

@@ -9,6 +9,7 @@ const DEFAULT_GENERATE_EDGES = [
     "dependsOn",
     "references",
     "rendersTo",
+    "derivedFrom",
 ];
 export function resolveDocumentForNode(g, nodeId) {
     const node = g.nodesById.get(nodeId);
@@ -77,6 +78,15 @@ export function projectionPathForNode(g, nodeId) {
     }
     return undefined;
 }
+export function dataSourcePathsForNode(g, nodeId) {
+    const paths = [];
+    for (const e of g.outEdges.get(nodeId) ?? []) {
+        if (e.type === "derivedFrom" && !e.to.startsWith("graphify:")) {
+            paths.push(e.to);
+        }
+    }
+    return paths;
+}
 export function querySubgraph(g, seedId, opts = {}) {
     if (!g.nodesById.has(seedId)) {
         throw new Error(`Unknown node id: ${seedId}`);
@@ -123,9 +133,12 @@ export function querySubgraph(g, seedId, opts = {}) {
         .filter((n) => !nodeTypeFilter || nodeTypeFilter.has(n.type));
     const edges = [...visitedEdges.values()];
     const projectionPaths = [
-        ...new Set([...visitedNodes]
-            .map((id) => projectionPathForNode(g, id))
-            .filter((p) => Boolean(p && !p.includes("{")))),
+        ...new Set([
+            ...[...visitedNodes]
+                .map((id) => projectionPathForNode(g, id))
+                .filter((p) => Boolean(p && !p.includes("{"))),
+            ...[...visitedNodes].flatMap((id) => dataSourcePathsForNode(g, id)),
+        ]),
     ];
     return { seed: seedId, nodes, edges, projectionPaths };
 }

package/dist/graph/query.js.map

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

package/dist/graph/source-refs.d.ts

@@ -0,0 +1,2 @@
+export declare function extractSourceRefsFromMarkdown(content: string): string[];
+//# sourceMappingURL=source-refs.d.ts.map

package/dist/graph/source-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-refs.d.ts","sourceRoot":"","sources":["../../src/graph/source-refs.ts"],"names":[],"mappings":"AASA,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA4BvE"}

package/dist/graph/source-refs.js

@@ -0,0 +1,30 @@
+/** Repo-relative paths under docs/data-source mentioned in markdown. */
+const DATA_SOURCE_PATH_RE = /(?:^|[\s`(\[])(docs\/data-source\/[^\s`)\]>]+)/gi;
+const SOURCE_LINE_RE = /^\s*(?:\*\*)?(?:Source|Data\s+source|Provenance|Origin)(?:\*\*)?\s*:\s*(.+)$/gim;
+const BACKTICK_PATH_RE = /`([^`]+\.(?:md|ts|tsx|js|py|go|rs|json|yaml|yml))`/gi;
+export function extractSourceRefsFromMarkdown(content) {
+    const refs = new Set();
+    for (const m of content.matchAll(DATA_SOURCE_PATH_RE)) {
+        const p = (m[1] ?? m[0]).replace(/^[(\[`\s]+/, "").trim();
+        if (p.startsWith("docs/data-source/")) {
+            refs.add(p);
+        }
+    }
+    for (const m of content.matchAll(SOURCE_LINE_RE)) {
+        const line = m[1].trim();
+        for (const part of line.split(/[,;]/)) {
+            const t = part.trim().replace(/^[`'"]+|[`'"]+$/g, "");
+            if (t) {
+                refs.add(t);
+            }
+        }
+    }
+    for (const m of content.matchAll(BACKTICK_PATH_RE)) {
+        const t = m[1].trim();
+        if (t.includes("data-source") || t.startsWith("docs/")) {
+            refs.add(t);
+        }
+    }
+    return [...refs];
+}
+//# sourceMappingURL=source-refs.js.map

package/dist/graph/source-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-refs.js","sourceRoot":"","sources":["../../src/graph/source-refs.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,mBAAmB,GACvB,kDAAkD,CAAC;AAErD,MAAM,cAAc,GAClB,iFAAiF,CAAC;AAEpF,MAAM,gBAAgB,GAAG,sDAAsD,CAAC;AAEhF,MAAM,UAAU,6BAA6B,CAAC,OAAe;IAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACtD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,IAAI,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;YACtD,IAAI,CAAC,EAAE,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC"}

package/dist/graphify/graph-index.d.ts

@@ -0,0 +1,28 @@
+export interface GraphifyGraphNode {
+    id: string;
+    label?: string;
+    norm_label?: string;
+    source_file?: string;
+    file_type?: string;
+    community?: number;
+}
+export interface GraphifyGraphFile {
+    nodes: GraphifyGraphNode[];
+    links?: Array<{
+        source: string;
+        target: string;
+    }>;
+}
+export interface GraphifyIndex {
+    nodes: GraphifyGraphNode[];
+    /** Repo-relative path (under data-source root) → graphify node ids in that file */
+    byRepoPath: Map<string, string[]>;
+    /** Lowercased label / norm_label → graphify node ids */
+    byLabel: Map<string, string[]>;
+}
+export declare function graphifyNodeTargetId(nodeId: string): string;
+export declare function isGraphifyNodeTarget(to: string): boolean;
+export declare function repoPathForGraphifyNode(node: GraphifyGraphNode, dataSourceRoot: string): string | undefined;
+export declare function loadGraphifyIndex(graphJsonPath: string, dataSourceRoot: string): Promise<GraphifyIndex | null>;
+export declare function defaultGraphifyJsonPath(projectRoot: string): string;
+//# sourceMappingURL=graph-index.d.ts.map

package/dist/graphify/graph-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-index.d.ts","sourceRoot":"","sources":["../../src/graphify/graph-index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,mFAAmF;IACnF,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,wDAAwD;IACxD,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAChC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,iBAAiB,EACvB,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,SAAS,CAUpB;AAED,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA8B/B;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKnE"}

package/dist/graphify/graph-index.js

@@ -0,0 +1,52 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { pathExists } from "../util/fs.js";
+export function graphifyNodeTargetId(nodeId) {
+    return `graphify:${nodeId}`;
+}
+export function isGraphifyNodeTarget(to) {
+    return to.startsWith("graphify:");
+}
+export function repoPathForGraphifyNode(node, dataSourceRoot) {
+    const sf = node.source_file?.replace(/\\/g, "/").trim();
+    if (!sf) {
+        return undefined;
+    }
+    const root = dataSourceRoot.replace(/\\/g, "/").replace(/\/$/, "");
+    if (sf.startsWith("docs/")) {
+        return sf;
+    }
+    return `${root}/${sf.replace(/^\.\//, "")}`;
+}
+export async function loadGraphifyIndex(graphJsonPath, dataSourceRoot) {
+    if (!(await pathExists(graphJsonPath))) {
+        return null;
+    }
+    const raw = JSON.parse(await readFile(graphJsonPath, "utf8"));
+    const nodes = raw.nodes ?? [];
+    const byRepoPath = new Map();
+    const byLabel = new Map();
+    const addToMap = (map, key, id) => {
+        const list = map.get(key) ?? [];
+        if (!list.includes(id)) {
+            list.push(id);
+            map.set(key, list);
+        }
+    };
+    for (const node of nodes) {
+        const path = repoPathForGraphifyNode(node, dataSourceRoot);
+        if (path) {
+            addToMap(byRepoPath, path, node.id);
+        }
+        for (const label of [node.label, node.norm_label]) {
+            if (label?.trim()) {
+                addToMap(byLabel, label.trim().toLowerCase(), node.id);
+            }
+        }
+    }
+    return { nodes, byRepoPath, byLabel };
+}
+export function defaultGraphifyJsonPath(projectRoot) {
+    return join(projectRoot, ".ai-spector/.docflow/graph/graphify-out/graph.json");
+}
+//# sourceMappingURL=graph-index.js.map

package/dist/graphify/graph-index.js.map

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

package/dist/graphify/sources.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Extensions Graphify `update` / `watch` index via AST (graphify.detect.CODE_EXTENSIONS).
+ * Markdown-only doc trees (docs/srs, docs/basic-design) have no matches → skip before spawn.
+ */
+export declare const GRAPHIFY_CODE_EXTENSIONS: Set<string>;
+export type GraphifySourceSkipReason = "empty" | "no-code-files";
 export interface SourceFileFingerprint {
     relativePath: string;
     contentHash: string;
@@ -14,6 +20,26 @@ export interface GraphifySourcesConfig {
     include?: string[];
     docSources?: string[];
 }
+/** Central graphify-out under project root (absolute path for GRAPHIFY_OUT). */
+export declare function resolveGraphifyOutputPath(projectRoot: string, outputPathRel?: string): string;
+/** True when the source dir exists but has no files to fingerprint (empty tree). */
+export declare function isGraphifySourceEmpty(projectRoot: string, sourceRel: string): Promise<boolean>;
+/** True when Graphify `update` would find no AST-indexable code files under the source. */
+export declare function hasGraphifyCodeFiles(projectRoot: string, sourceRel: string): Promise<boolean>;
+/**
+ * Why a source should not run `graphify update` (empty dir or markdown/docs only).
+ * Returns null when the path is missing, not a directory, or has code files to index.
+ */
+export declare function getGraphifySourceSkipReason(projectRoot: string, sourceRel: string): Promise<GraphifySourceSkipReason | null>;
+/** Pre-check before spawning Graphify CLI (empty tree or no code extensions). */
+export declare function isGraphifySourceSkippable(projectRoot: string, sourceRel: string): Promise<{
+    skip: true;
+    reason: GraphifySourceSkipReason;
+} | {
+    skip: false;
+}>;
+/** Graphify watch/update exit 1 when the tree has nothing to rebuild. */
+export declare function isGraphifyNoCodeFilesOutput(stdout: string, stderr: string, exitCode: number): boolean;
 export declare function resolveGraphifySources(config: GraphifySourcesConfig): GraphifySourceSpec[];
 export declare function computeSourceContentHash(projectRoot: string, sourceRel: string): Promise<string | undefined>;
 export declare function filterSourcesByHashChange(projectRoot: string, specs: GraphifySourceSpec[], storedHashes: Record<string, string> | undefined, force: boolean): Promise<{

package/dist/graphify/sources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/graphify/sources.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAiClC;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,qBAAqB,GAC5B,kBAAkB,EAAE,CAwBtB;AAED,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;AAED,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,kBAAkB,EAAE,EAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAChD,KAAK,EAAE,OAAO,GACb,OAAO,CAAC;IAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAgB1E"}
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/graphify/sources.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,eAAO,MAAM,wBAAwB,aAkEnC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,eAAe,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAiClC;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAIR;AAED,oFAAoF;AACpF,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,2FAA2F;AAC3F,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAiB1C;AAED,iFAAiF;AACjF,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,CAM7E;AAID,yEAAyE;AACzE,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAET;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,qBAAqB,GAC5B,kBAAkB,EAAE,CAwBtB;AAED,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;AAED,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,kBAAkB,EAAE,EAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAChD,KAAK,EAAE,OAAO,GACb,OAAO,CAAC;IAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAgB1E"}

package/dist/graphify/sources.js

@@ -1,8 +1,79 @@
 import { createHash } from "node:crypto";
-import { readdir, readFile } from "node:fs/promises";
-import { join, relative, resolve } from "node:path";
+import { readdir, readFile, stat } from "node:fs/promises";
+import { extname, join, relative, resolve } from "node:path";
 import { pathExists } from "../util/fs.js";
 const SKIP_DIRS = new Set(["node_modules", ".git", "graphify-out", ".ai-spector"]);
+/**
+ * Extensions Graphify `update` / `watch` index via AST (graphify.detect.CODE_EXTENSIONS).
+ * Markdown-only doc trees (docs/srs, docs/basic-design) have no matches → skip before spawn.
+ */
+export const GRAPHIFY_CODE_EXTENSIONS = new Set([
+    ".py",
+    ".ts",
+    ".js",
+    ".jsx",
+    ".tsx",
+    ".mjs",
+    ".ejs",
+    ".go",
+    ".rs",
+    ".java",
+    ".groovy",
+    ".gradle",
+    ".cpp",
+    ".cc",
+    ".cxx",
+    ".c",
+    ".h",
+    ".hpp",
+    ".rb",
+    ".swift",
+    ".kt",
+    ".kts",
+    ".cs",
+    ".scala",
+    ".php",
+    ".lua",
+    ".luau",
+    ".toc",
+    ".zig",
+    ".ps1",
+    ".ex",
+    ".exs",
+    ".m",
+    ".mm",
+    ".jl",
+    ".vue",
+    ".svelte",
+    ".astro",
+    ".dart",
+    ".v",
+    ".sv",
+    ".sql",
+    ".r",
+    ".f",
+    ".F",
+    ".f90",
+    ".F90",
+    ".f95",
+    ".F95",
+    ".f03",
+    ".F03",
+    ".f08",
+    ".F08",
+    ".pas",
+    ".pp",
+    ".dpr",
+    ".dpk",
+    ".lpr",
+    ".inc",
+    ".dfm",
+    ".lfm",
+    ".lpk",
+    ".sh",
+    ".bash",
+    ".json",
+]);
 export async function discoverSourceFingerprints(projectRoot, sourceRoot) {
     const rootAbs = resolve(projectRoot, sourceRoot);
     const files = [];
@@ -36,6 +107,53 @@ export async function discoverSourceFingerprints(projectRoot, sourceRoot) {
     files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
     return files;
 }
+/** Central graphify-out under project root (absolute path for GRAPHIFY_OUT). */
+export function resolveGraphifyOutputPath(projectRoot, outputPathRel) {
+    const rel = outputPathRel ?? ".ai-spector/.docflow/graph/graphify-out";
+    return resolve(projectRoot, rel);
+}
+/** True when the source dir exists but has no files to fingerprint (empty tree). */
+export async function isGraphifySourceEmpty(projectRoot, sourceRel) {
+    return (await getGraphifySourceSkipReason(projectRoot, sourceRel)) === "empty";
+}
+/** True when Graphify `update` would find no AST-indexable code files under the source. */
+export async function hasGraphifyCodeFiles(projectRoot, sourceRel) {
+    const files = await discoverSourceFingerprints(projectRoot, sourceRel);
+    return files.some((f) => GRAPHIFY_CODE_EXTENSIONS.has(extname(f.relativePath).toLowerCase()));
+}
+/**
+ * Why a source should not run `graphify update` (empty dir or markdown/docs only).
+ * Returns null when the path is missing, not a directory, or has code files to index.
+ */
+export async function getGraphifySourceSkipReason(projectRoot, sourceRel) {
+    const abs = resolve(projectRoot, sourceRel);
+    if (!(await pathExists(abs))) {
+        return null;
+    }
+    const st = await stat(abs).catch(() => null);
+    if (!st?.isDirectory()) {
+        return null;
+    }
+    const files = await discoverSourceFingerprints(projectRoot, sourceRel);
+    if (files.length === 0) {
+        return "empty";
+    }
+    const hasCode = files.some((f) => GRAPHIFY_CODE_EXTENSIONS.has(extname(f.relativePath).toLowerCase()));
+    return hasCode ? null : "no-code-files";
+}
+/** Pre-check before spawning Graphify CLI (empty tree or no code extensions). */
+export async function isGraphifySourceSkippable(projectRoot, sourceRel) {
+    const reason = await getGraphifySourceSkipReason(projectRoot, sourceRel);
+    if (reason) {
+        return { skip: true, reason };
+    }
+    return { skip: false };
+}
+const GRAPHIFY_NO_CODE_FILES_RE = /no code files found/i;
+/** Graphify watch/update exit 1 when the tree has nothing to rebuild. */
+export function isGraphifyNoCodeFilesOutput(stdout, stderr, exitCode) {
+    return exitCode !== 0 && GRAPHIFY_NO_CODE_FILES_RE.test(`${stdout}\n${stderr}`);
+}
 export function resolveGraphifySources(config) {
     const seen = new Set();
     const out = [];