ai-spector 0.9.21 → 0.9.24

package/dist/graph/provenance.js

@@ -1,199 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-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";
-import { knownSourceFileNodeIds, provenanceTargetId, } from "./bundles.js";
-function collectKnowledgeRefs(item) {
-    const out = [];
-    const fields = [
-        "derivedFrom",
-        "sourceRef",
-        "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;
-}
-/** 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.includes("§")) {
-        s = s.split(/\s*§/)[0].trim();
-    }
-    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, validDomainIds, knownSourceFiles) {
-    const edges = [];
-    const edgeKeys = new Set();
-    for (const [domainId, refs] of domainRefs) {
-        if (!validDomainIds.has(domainId)) {
-            continue;
-        }
-        for (const ref of refs) {
-            const normalized = normalizeDataSourcePath(ref, dataSourceRoot);
-            if (!normalized) {
-                continue;
-            }
-            const to = provenanceTargetId(normalized, knownSourceFiles);
-            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 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 knownSourceFiles = knownSourceFileNodeIds(graph);
-    const patch = buildProvenancePatch(domainRefs, dataSourceRoot, validDomainIds, knownSourceFiles);
-    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

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

package/dist/graph/query.d.ts

@@ -1,3 +0,0 @@
-export { querySubgraph, resolveDocumentForNode, projectionPathForNode, dataSourcePathsForNode, } from "ai-spector-graph";
-export type { QueryOptions, GraphQueryResult } from "ai-spector-graph";
-//# sourceMappingURL=query.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/graph/query.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/graph/query.js

@@ -1,2 +0,0 @@
-export { querySubgraph, resolveDocumentForNode, projectionPathForNode, dataSourcePathsForNode, } from "ai-spector-graph";
-//# sourceMappingURL=query.js.map

package/dist/graph/query.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/graph/query.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/graph/resolve.d.ts

@@ -1,15 +0,0 @@
-import type { InMemoryGraph } from "./InMemoryGraph.js";
-import { type ResolvedOrigin } from "ai-spector-graph";
-export { globToRegExp, findDocumentNodeIdForPath, findSectionNodeIdByAnchor, findSectionNodeIdsByHeading, findNodeIdsByText, looksLikeExplicitNodeId, resolveImpactOrigins, pickPrimaryImpactOrigin, } from "ai-spector-graph";
-export type { ResolveHints, ResolvedOrigin } from "ai-spector-graph";
-export interface GitDiffRegion {
-    file: string;
-    heading?: string;
-    sectionAnchor?: string;
-}
-/** Parse unified diff text into per-file regions with optional heading / section anchors. */
-export declare function parseGitDiffRegions(diffText: string): GitDiffRegion[];
-export declare function prioritizeGitDiffRegions(regions: GitDiffRegion[]): GitDiffRegion[];
-/** Resolve graph seeds from a unified diff (staged + unstaged combined text). */
-export declare function resolveFromGitDiff(g: InMemoryGraph, diffText: string): ResolvedOrigin[];
-//# sourceMappingURL=resolve.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/graph/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKrE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAiBD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAuDrE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAiBlF;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,aAAa,EAChB,QAAQ,EAAE,MAAM,GACf,cAAc,EAAE,CAkClB"}

package/dist/graph/resolve.js

@@ -1,117 +0,0 @@
-import { resolveImpactOrigins, } from "ai-spector-graph";
-export { globToRegExp, findDocumentNodeIdForPath, findSectionNodeIdByAnchor, findSectionNodeIdsByHeading, findNodeIdsByText, looksLikeExplicitNodeId, resolveImpactOrigins, pickPrimaryImpactOrigin, } from "ai-spector-graph";
-const SECTION_ANCHOR_IN_DIFF_RE = /<!--\s*section:\s*([^\s>]+)\s*-->/;
-const HEADING_IN_DIFF_RE = /^[+\- ]?(#{1,6})\s+(.+)$/;
-function normalizePath(relativePath) {
-    return relativePath.replace(/\\/g, "/").replace(/^\.\//, "");
-}
-function docPathPriority(relativePath) {
-    const p = normalizePath(relativePath);
-    if (p.startsWith("docs/")) {
-        return 0;
-    }
-    if (p.startsWith(".ai-spector/")) {
-        return 1;
-    }
-    return 2;
-}
-/** Parse unified diff text into per-file regions with optional heading / section anchors. */
-export function parseGitDiffRegions(diffText) {
-    const regions = [];
-    const blocks = diffText.split(/^diff --git /m).filter(Boolean);
-    const pushBlock = (raw) => {
-        const lines = raw.split("\n");
-        let filePath;
-        const headings = new Set();
-        const anchors = new Set();
-        for (const line of lines) {
-            const plus = line.match(/^\+\+\+ b\/(.+)$/);
-            if (plus) {
-                filePath = normalizePath(plus[1]);
-                continue;
-            }
-            const minus = line.match(/^--- a\/(.+)$/);
-            if (!filePath && minus) {
-                filePath = normalizePath(minus[1]);
-            }
-            const anchor = line.match(SECTION_ANCHOR_IN_DIFF_RE);
-            if (anchor) {
-                anchors.add(anchor[1]);
-            }
-            const heading = line.match(HEADING_IN_DIFF_RE);
-            if (heading) {
-                headings.add(heading[2].trim());
-            }
-        }
-        if (!filePath || filePath === "/dev/null") {
-            return;
-        }
-        if (anchors.size === 0 && headings.size === 0) {
-            regions.push({ file: filePath });
-            return;
-        }
-        for (const sectionAnchor of anchors) {
-            regions.push({ file: filePath, sectionAnchor });
-        }
-        for (const heading of headings) {
-            regions.push({ file: filePath, heading });
-        }
-    };
-    if (blocks.length > 0) {
-        for (const block of blocks) {
-            pushBlock(block);
-        }
-    }
-    else if (diffText.includes("--- ")) {
-        pushBlock(diffText);
-    }
-    return prioritizeGitDiffRegions(regions);
-}
-export function prioritizeGitDiffRegions(regions) {
-    const seen = new Set();
-    const unique = [];
-    for (const r of regions) {
-        const key = `${r.file}\0${r.sectionAnchor ?? ""}\0${r.heading ?? ""}`;
-        if (seen.has(key)) {
-            continue;
-        }
-        seen.add(key);
-        unique.push(r);
-    }
-    return unique.sort((a, b) => docPathPriority(a.file) - docPathPriority(b.file) ||
-        a.file.localeCompare(b.file) ||
-        (a.heading ?? "").localeCompare(b.heading ?? ""));
-}
-/** Resolve graph seeds from a unified diff (staged + unstaged combined text). */
-export function resolveFromGitDiff(g, diffText) {
-    const regions = parseGitDiffRegions(diffText);
-    const origins = [];
-    const push = (o) => {
-        if (!origins.some((x) => x.id === o.id)) {
-            origins.push(o);
-        }
-    };
-    for (const region of regions) {
-        for (const o of resolveImpactOrigins(g, {
-            file: region.file,
-            heading: region.heading,
-            sectionAnchor: region.sectionAnchor,
-        })) {
-            push(o);
-        }
-    }
-    const typeRank = (type) => {
-        if (type === "section") {
-            return 3;
-        }
-        if (["useCase", "feature", "requirement", "actor", "dataEntity"].includes(type)) {
-            return 2;
-        }
-        if (type === "document") {
-            return 1;
-        }
-        return 0;
-    };
-    return origins.sort((a, b) => typeRank(b.type) - typeRank(a.type) || a.id.localeCompare(b.id));
-}
-//# sourceMappingURL=resolve.js.map

package/dist/graph/resolve.js.map

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

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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,30 +0,0 @@
-/** 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

@@ -1 +0,0 @@
-{"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/graph/translation.d.ts

@@ -1,14 +0,0 @@
-import type { GraphNode } from "../types.js";
-import { InMemoryGraph } from "./InMemoryGraph.js";
-export interface TranslationLang {
-    code: string;
-    label: string;
-}
-/** Map primary output path to secondary language folder. */
-export declare function translationOutputForLang(primary: GraphNode, langCode: string): string | undefined;
-export declare function buildTranslationDocNode(primary: GraphNode, lang: TranslationLang): GraphNode;
-/** Create or refresh a translation document node and wire translationOf + contains edges. */
-export declare function wireTranslationDocNode(graph: InMemoryGraph, primary: GraphNode, lang: TranslationLang): "created" | "updated";
-export declare function isTranslationDocId(nodeId: string, langCodes: string[]): boolean;
-export declare function primaryDocumentNodes(graph: InMemoryGraph, langCodes: string[]): GraphNode[];
-//# sourceMappingURL=translation.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"translation.d.ts","sourceRoot":"","sources":["../../src/graph/translation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4DAA4D;AAC5D,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAWpB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,eAAe,GACpB,SAAS,CAkBX;AAED,6FAA6F;AAC7F,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,eAAe,GACpB,SAAS,GAAG,SAAS,CAmBvB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAE/E;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,EAAE,GAClB,SAAS,EAAE,CAIb"}

package/dist/graph/translation.js

@@ -1,65 +0,0 @@
-/** Map primary output path to secondary language folder. */
-export function translationOutputForLang(primary, langCode) {
-    const map = (p) => p
-        .replace(/^docs\/srs\//, `docs/srs/${langCode}/`)
-        .replace(/^docs\/basic-design\//, `docs/basic-design/${langCode}/`);
-    const outputPattern = typeof primary.outputPattern === "string" ? primary.outputPattern : undefined;
-    const output = typeof primary.output === "string" ? primary.output : undefined;
-    if (outputPattern)
-        return map(outputPattern);
-    if (output)
-        return map(output);
-    return undefined;
-}
-export function buildTranslationDocNode(primary, lang) {
-    const id = `doc:${lang.code}:${primary.id}`;
-    const node = {
-        id,
-        type: "document",
-        lang: lang.code,
-        label: lang.label,
-    };
-    if (typeof primary.template === "string")
-        node.template = primary.template;
-    if (typeof primary.title === "string")
-        node.title = primary.title;
-    if (typeof primary.outputPattern === "string") {
-        node.outputPattern = translationOutputForLang(primary, lang.code);
-        if (typeof primary.perDomain === "string")
-            node.perDomain = primary.perDomain;
-    }
-    else {
-        const out = translationOutputForLang(primary, lang.code);
-        if (out)
-            node.output = out;
-    }
-    return node;
-}
-/** Create or refresh a translation document node and wire translationOf + contains edges. */
-export function wireTranslationDocNode(graph, primary, lang) {
-    const translatedId = `doc:${lang.code}:${primary.id}`;
-    const built = buildTranslationDocNode(primary, lang);
-    const outcome = graph.upsertNode(built);
-    graph.addEdgeIfAbsent({
-        type: "translationOf",
-        from: translatedId,
-        to: primary.id,
-    });
-    for (const outEdge of graph.outEdges.get(primary.id) ?? []) {
-        if (outEdge.type === "contains") {
-            graph.addEdgeIfAbsent({
-                type: "contains",
-                from: translatedId,
-                to: outEdge.to,
-            });
-        }
-    }
-    return outcome;
-}
-export function isTranslationDocId(nodeId, langCodes) {
-    return langCodes.some((code) => nodeId.startsWith(`doc:${code}:`));
-}
-export function primaryDocumentNodes(graph, langCodes) {
-    return [...graph.nodesById.values()].filter((n) => n.type === "document" && !isTranslationDocId(n.id, langCodes));
-}
-//# sourceMappingURL=translation.js.map

package/dist/graph/translation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"translation.js","sourceRoot":"","sources":["../../src/graph/translation.ts"],"names":[],"mappings":"AAQA,4DAA4D;AAC5D,MAAM,UAAU,wBAAwB,CACtC,OAAkB,EAClB,QAAgB;IAEhB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CACxB,CAAC;SACE,OAAO,CAAC,cAAc,EAAE,YAAY,QAAQ,GAAG,CAAC;SAChD,OAAO,CAAC,uBAAuB,EAAE,qBAAqB,QAAQ,GAAG,CAAC,CAAC;IACxE,MAAM,aAAa,GACjB,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,IAAI,aAAa;QAAE,OAAO,GAAG,CAAC,aAAa,CAAC,CAAC;IAC7C,IAAI,MAAM;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAkB,EAClB,IAAqB;IAErB,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAc;QACtB,EAAE;QACF,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;IACF,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC3E,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;QAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAClE,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;QAC9C,IAAI,CAAC,aAAa,GAAG,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAClE,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;YAAE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAChF,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,GAAG;YAAE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,sBAAsB,CACpC,KAAoB,EACpB,OAAkB,EAClB,IAAqB;IAErB,MAAM,YAAY,GAAG,OAAO,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;IACtD,MAAM,KAAK,GAAG,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxC,KAAK,CAAC,eAAe,CAAC;QACpB,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,YAAY;QAClB,EAAE,EAAE,OAAO,CAAC,EAAE;KACf,CAAC,CAAC;IACH,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3D,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAChC,KAAK,CAAC,eAAe,CAAC;gBACpB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,YAAY;gBAClB,EAAE,EAAE,OAAO,CAAC,EAAE;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,SAAmB;IACpE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAoB,EACpB,SAAmB;IAEnB,OAAO,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CACrE,CAAC;AACJ,CAAC"}

package/dist/index/doc-semantics.d.ts

@@ -1,14 +0,0 @@
-import { type IndexDocsConfig } from "./docs-config.js";
-export interface DocSemanticMergeOptions {
-    projectRoot: string;
-    graphPath: string;
-    config?: IndexDocsConfig;
-}
-export interface DocSemanticMergeResult {
-    merged: boolean;
-    detail: string;
-    sourceHashes: Record<string, string>;
-}
-export declare function runDocSemanticMerge(opts: DocSemanticMergeOptions): Promise<DocSemanticMergeResult>;
-export declare function knowledgeStaleWarning(projectRoot: string, docHashes: Record<string, string>): Promise<string | undefined>;
-//# sourceMappingURL=doc-semantics.d.ts.map

package/dist/index/doc-semantics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"doc-semantics.d.ts","sourceRoot":"","sources":["../../src/index/doc-semantics.ts"],"names":[],"mappings":"AAcA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG7E,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CA2FjC;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwB7B"}

package/dist/index/doc-semantics.js

@@ -1,101 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { mergePatch } from "../graph/merge.js";
-import { loadInMemoryGraph } from "../graph/loadGraph.js";
-import { basicDesignAnchorStructurePatch, basicDesignListChaptersNeedSections, buildDocExtractPatch, } from "../graph/doc-extract.js";
-import { mergeStructurePatches } from "../registry/structure-patch.js";
-import { computeIndexSourceHash, discoverMarkdownFiles, } from "./docs-build.js";
-import { indexDocsConfigPath } from "./docs-config.js";
-import { pathExists, readJson, writeJson } from "../util/fs.js";
-export async function runDocSemanticMerge(opts) {
-    const configPath = indexDocsConfigPath(opts.projectRoot);
-    if (!(await pathExists(configPath))) {
-        return {
-            merged: false,
-            detail: `Missing ${configPath}`,
-            sourceHashes: {},
-        };
-    }
-    const config = opts.config ?? (await readJson(configPath));
-    const entries = [];
-    const sourceHashes = {};
-    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");
-        sourceHashes[key] = computeIndexSourceHash(files);
-        for (const f of files) {
-            const content = await readFile(join(opts.projectRoot, f.relativePath), "utf8");
-            entries.push({ relativePath: f.relativePath, content });
-        }
-    }
-    if (entries.length === 0) {
-        return {
-            merged: false,
-            detail: "No markdown under docs/srs or docs/basic-design",
-            sourceHashes,
-        };
-    }
-    const graphBefore = await loadInMemoryGraph(opts.graphPath);
-    const listChaptersNeedSections = basicDesignListChaptersNeedSections(graphBefore);
-    let { patch, stats } = await buildDocExtractPatch(entries, opts.projectRoot, {
-        includeListChapterMarkdown: listChaptersNeedSections,
-    });
-    if (listChaptersNeedSections) {
-        const structure = await basicDesignAnchorStructurePatch(opts.projectRoot);
-        patch = mergeStructurePatches([patch, structure]);
-    }
-    if (patch.nodes.length === 0 && patch.edges.length === 0) {
-        return {
-            merged: false,
-            detail: `Scanned ${stats.filesScanned} files — no UC/F/actor ids found in body text`,
-            sourceHashes,
-        };
-    }
-    const { stats: mergeStats } = mergePatch(graphBefore, patch);
-    await writeJson(opts.graphPath, graphBefore.toTraceabilityGraph());
-    const statePath = join(opts.projectRoot, ".ai-spector/.docflow/state.json");
-    const state = await readJson(statePath).catch(() => ({
-        version: 1,
-        docsSemantic: {},
-    }));
-    const docsSemantic = state.docsSemantic ?? {};
-    docsSemantic.lastRunAt = new Date().toISOString();
-    docsSemantic.sourceHashes = sourceHashes;
-    docsSemantic.lastStats = stats;
-    state.docsSemantic = docsSemantic;
-    await writeJson(statePath, state);
-    return {
-        merged: true,
-        detail: `${stats.filesScanned} files → ${stats.useCases} use cases, ${stats.features} features, ${stats.actors} actors` +
-            (stats.detailDocuments > 0
-                ? `, ${stats.detailDocuments} detail documents` +
-                    (stats.bdDetailDocuments > 0
-                        ? ` (${stats.srsDetailDocuments} SRS, ${stats.bdDetailDocuments} basic-design)`
-                        : "")
-                : "") +
-            (stats.detailSections > 0 ? `, ${stats.detailSections} detail sections` : "") +
-            ` (+${mergeStats.nodesCreated} nodes, ~${mergeStats.nodesUpdated} updated, +${mergeStats.edgesAdded} edges)`,
-        sourceHashes,
-    };
-}
-export async function knowledgeStaleWarning(projectRoot, docHashes) {
-    const knowledgePath = join(projectRoot, ".ai-spector/.docflow/analysis/knowledge.json");
-    if (!(await pathExists(knowledgePath))) {
-        return undefined;
-    }
-    const statePath = join(projectRoot, ".ai-spector/.docflow/state.json");
-    const state = await readJson(statePath).catch(() => null);
-    const indexHashes = state?.index
-        ?.sourceHashes;
-    if (!indexHashes?.srs || !docHashes.srs) {
-        return undefined;
-    }
-    if (indexHashes.srs === docHashes.srs) {
-        return undefined;
-    }
-    return ("docs/srs changed since last index — knowledge.json may be stale; run /analyze to re-extract from data source, or rely on doc semantic merge from file bodies");
-}
-//# sourceMappingURL=doc-semantics.js.map