ai-spector 0.1.0

package/dist/graph/query.d.ts

@@ -0,0 +1,18 @@
+import type { EdgeType, GraphEdge, GraphNode, NodeType } from "../types.js";
+import type { InMemoryGraph } from "./InMemoryGraph.js";
+export interface QueryOptions {
+    direction?: "out" | "in" | "both";
+    depth?: number;
+    edgeTypes?: EdgeType[];
+    nodeTypes?: NodeType[];
+}
+export interface GraphQueryResult {
+    seed: string;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    projectionPaths: string[];
+}
+export declare function resolveDocumentForNode(g: InMemoryGraph, nodeId: string): GraphNode | undefined;
+export declare function projectionPathForNode(g: InMemoryGraph, nodeId: string): string | undefined;
+export declare function querySubgraph(g: InMemoryGraph, seedId: string, opts?: QueryOptions): GraphQueryResult;
+//# sourceMappingURL=query.d.ts.map

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

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

package/dist/graph/query.js

@@ -0,0 +1,132 @@
+const DEFAULT_GENERATE_EDGES = [
+    "partOf",
+    "contains",
+    "follows",
+    "listedIn",
+    "definedIn",
+    "describedIn",
+    "satisfies",
+    "dependsOn",
+    "references",
+    "rendersTo",
+];
+export function resolveDocumentForNode(g, nodeId) {
+    const node = g.nodesById.get(nodeId);
+    if (!node) {
+        return undefined;
+    }
+    if (node.type === "document") {
+        return node;
+    }
+    if (node.type === "section") {
+        const partOf = (g.outEdges.get(nodeId) ?? []).find((e) => e.type === "partOf");
+        if (!partOf) {
+            return undefined;
+        }
+        return resolveDocumentForNode(g, partOf.to);
+    }
+    for (const e of g.outEdges.get(nodeId) ?? []) {
+        if (["listedIn", "definedIn", "describedIn"].includes(e.type)) {
+            const doc = resolveDocumentForNode(g, e.to);
+            if (doc) {
+                return doc;
+            }
+        }
+    }
+    for (const e of g.inEdges.get(nodeId) ?? []) {
+        if (e.type === "definedIn" && e.from === nodeId) {
+            const doc = resolveDocumentForNode(g, e.to);
+            if (doc) {
+                return doc;
+            }
+        }
+    }
+    return undefined;
+}
+export function projectionPathForNode(g, nodeId) {
+    const node = g.nodesById.get(nodeId);
+    if (!node) {
+        return undefined;
+    }
+    if (node.type === "document") {
+        const out = node.output;
+        return out || undefined;
+    }
+    if (node.type === "section") {
+        const doc = resolveDocumentForNode(g, nodeId);
+        if (!doc) {
+            return undefined;
+        }
+        const pattern = doc.outputPattern;
+        if (pattern) {
+            return pattern;
+        }
+        return doc.output;
+    }
+    const doc = resolveDocumentForNode(g, nodeId);
+    if (doc?.output) {
+        return doc.output;
+    }
+    if (doc?.outputPattern) {
+        return doc.outputPattern;
+    }
+    for (const e of g.outEdges.get(nodeId) ?? []) {
+        if (e.type === "rendersTo") {
+            return e.to;
+        }
+    }
+    return undefined;
+}
+export function querySubgraph(g, seedId, opts = {}) {
+    if (!g.nodesById.has(seedId)) {
+        throw new Error(`Unknown node id: ${seedId}`);
+    }
+    const direction = opts.direction ?? "both";
+    const depth = opts.depth ?? 2;
+    const edgeTypeSet = new Set(opts.edgeTypes ?? DEFAULT_GENERATE_EDGES);
+    const nodeTypeFilter = opts.nodeTypes ? new Set(opts.nodeTypes) : null;
+    const visitedNodes = new Set();
+    const visitedEdges = new Map();
+    const queue = [{ id: seedId, d: 0 }];
+    while (queue.length > 0) {
+        const { id: current, d } = queue.shift();
+        if (d > 0) {
+            visitedNodes.add(current);
+        }
+        if (d >= depth) {
+            continue;
+        }
+        const visitEdge = (e, next) => {
+            if (!edgeTypeSet.has(e.type)) {
+                return;
+            }
+            const key = `${e.type}\0${e.from}\0${e.to}`;
+            visitedEdges.set(key, e);
+            if (!visitedNodes.has(next) && next !== seedId) {
+                queue.push({ id: next, d: d + 1 });
+            }
+        };
+        if (direction === "out" || direction === "both") {
+            for (const e of g.outEdges.get(current) ?? []) {
+                visitEdge(e, e.to);
+            }
+        }
+        if (direction === "in" || direction === "both") {
+            for (const e of g.inEdges.get(current) ?? []) {
+                visitEdge(e, e.from);
+            }
+        }
+    }
+    visitedNodes.add(seedId);
+    const nodes = [...visitedNodes]
+        .map((id) => g.nodesById.get(id))
+        .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("{")))),
+    ];
+    return { seed: seedId, nodes, edges, projectionPaths };
+}
+//# sourceMappingURL=query.js.map

package/dist/graph/query.js.map

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

package/dist/registry/build.d.ts

@@ -0,0 +1,3 @@
+import type { SectionRegistry } from "../types.js";
+export declare function buildSectionRegistry(root?: string): Promise<SectionRegistry>;
+//# sourceMappingURL=build.d.ts.map

package/dist/registry/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/registry/build.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqC,eAAe,EAAE,MAAM,aAAa,CAAC;AA4CtF,wBAAsB,oBAAoB,CACxC,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CAe1B"}

package/dist/registry/build.js

@@ -0,0 +1,53 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { loadDocflowConfig, loadDocumentsManifest } from "../config/load.js";
+import { sectionIdFromHeading } from "./slug.js";
+const HEADING_RE = /^(#{2,4})\s+(.+)$/;
+function parseSections(content) {
+    const sections = [];
+    let order = 0;
+    for (const line of content.split("\n")) {
+        if (line.startsWith(">")) {
+            continue;
+        }
+        const m = HEADING_RE.exec(line.trim());
+        if (!m) {
+            continue;
+        }
+        const level = m[1].length;
+        const heading = m[2].trim();
+        order += 1;
+        sections.push({
+            id: "",
+            heading,
+            level,
+            order,
+        });
+    }
+    return sections;
+}
+async function scanTemplate(templatesDir, doc) {
+    const path = join(templatesDir, doc.template);
+    const content = await readFile(path, "utf8");
+    const raw = parseSections(content);
+    const sections = raw.map((s) => ({
+        ...s,
+        id: sectionIdFromHeading(doc.documentId, s.heading, s.level, s.order ?? 0),
+    }));
+    return { ...doc, sections };
+}
+export async function buildSectionRegistry(root) {
+    const { root: projectRoot } = await loadDocflowConfig(root);
+    const { bundleRoot, manifest } = await loadDocumentsManifest();
+    const templatesDir = join(bundleRoot, manifest.templatesDir);
+    const documents = [];
+    for (const doc of manifest.documents) {
+        documents.push(await scanTemplate(templatesDir, doc));
+    }
+    return {
+        version: 1,
+        root: projectRoot,
+        documents,
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/registry/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/registry/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1B,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,CAAC;QACX,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,EAAE;YACN,OAAO;YACP,KAAK;YACL,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,YAAoB,EACpB,GAAuC;IAEvC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/B,GAAG,CAAC;QACJ,EAAE,EAAE,oBAAoB,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;KAC3E,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAa;IAEb,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAuB,EAAE,CAAC;IAEzC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACrC,SAAS,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,WAAW;QACjB,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/registry/slug.d.ts

@@ -0,0 +1,4 @@
+/** Stable slug from heading text for section id suffix. */
+export declare function headingSlug(heading: string): string;
+export declare function sectionIdFromHeading(documentId: string, heading: string, level: number, order: number): string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/registry/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/registry/slug.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR"}

package/dist/registry/slug.js

@@ -0,0 +1,16 @@
+/** Stable slug from heading text for section id suffix. */
+export function headingSlug(heading) {
+    return heading
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}\s-]/gu, "")
+        .trim()
+        .replace(/\s+/g, "-")
+        .replace(/-+/g, "-")
+        .slice(0, 80);
+}
+export function sectionIdFromHeading(documentId, heading, level, order) {
+    const slug = headingSlug(heading);
+    const docKey = documentId.replace(/^doc\./, "");
+    return `sec.${docKey}.l${level}.${order}.${slug}`;
+}
+//# sourceMappingURL=slug.js.map

package/dist/registry/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/registry/slug.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,OAAO;SACX,WAAW,EAAE;SACb,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;SACjC,IAAI,EAAE;SACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,OAAe,EACf,KAAa,EACb,KAAa;IAEb,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChD,OAAO,OAAO,MAAM,KAAK,KAAK,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;AACpD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,45 @@
+export type NodeType = "document" | "section" | "table" | "diagram" | "actor" | "useCase" | "feature" | "requirement" | "dataEntity";
+export type EdgeType = "partOf" | "contains" | "follows" | "references" | "listedIn" | "definedIn" | "describedIn" | "satisfies" | "dependsOn" | "requires" | "tracesTo" | "derivedFrom" | "rendersTo";
+export interface GraphNode {
+    id: string;
+    type: NodeType;
+    [key: string]: unknown;
+}
+export interface GraphEdge {
+    type: EdgeType;
+    from: string;
+    to: string;
+    role?: string;
+}
+export interface TraceabilityGraph {
+    version: number;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+export interface RegistrySection {
+    id: string;
+    heading: string;
+    level: number;
+    order?: number;
+}
+export interface RegistryDocument {
+    documentId: string;
+    template: string;
+    output?: string;
+    outputPattern?: string;
+    perDomain?: "useCase" | "feature";
+    sections: RegistrySection[];
+}
+export interface SectionRegistry {
+    version: number;
+    root: string;
+    documents: RegistryDocument[];
+}
+export interface ValidationIssue {
+    ruleId: string;
+    severity: "error" | "warn";
+    message: string;
+    nodeId?: string;
+    edge?: GraphEdge;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,SAAS,GACT,OAAO,GACP,SAAS,GACT,OAAO,GACP,SAAS,GACT,SAAS,GACT,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,UAAU,GACV,SAAS,GACT,YAAY,GACZ,UAAU,GACV,WAAW,GACX,aAAa,GACb,WAAW,GACX,WAAW,GACX,UAAU,GACV,UAAU,GACV,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/util/fs.d.ts

@@ -0,0 +1,6 @@
+export declare function readJson<T>(path: string): Promise<T>;
+export declare function writeJson(path: string, data: unknown): Promise<void>;
+export declare function pathExists(path: string): Promise<boolean>;
+/** Recursive copy (Node 16+). */
+export declare function copyTree(src: string, dest: string): Promise<void>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/util/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/util/fs.ts"],"names":[],"mappings":"AAGA,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAG1D;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,iCAAiC;AACjC,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE"}

package/dist/util/fs.js

@@ -0,0 +1,24 @@
+import { cp, readFile, writeFile, mkdir, access } from "node:fs/promises";
+import { dirname } from "node:path";
+export async function readJson(path) {
+    const raw = await readFile(path, "utf8");
+    return JSON.parse(raw);
+}
+export async function writeJson(path, data) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(data, null, 2)}\n`, "utf8");
+}
+export async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Recursive copy (Node 16+). */
+export async function copyTree(src, dest) {
+    await cp(src, dest, { recursive: true });
+}
+//# sourceMappingURL=fs.js.map

package/dist/util/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/util/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,IAAY;IAC5C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,IAAa;IACzD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAY;IACtD,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/util/paths.d.ts

@@ -0,0 +1,16 @@
+import type { DocflowConfig } from "../config/types.js";
+import { findProjectRoot, packageBundleRoot } from "../config/load.js";
+export { findProjectRoot, packageBundleRoot };
+export declare const findRepoRoot: typeof findProjectRoot;
+export interface ResolvedPaths {
+    root: string;
+    config: DocflowConfig;
+    graph: string;
+    registry: string;
+    schema: string;
+    rulesTraceability: string;
+    rulesImpact: string;
+    bundleRoot: string;
+}
+export declare function resolveProjectPaths(root?: string): Promise<ResolvedPaths>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/util/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/util/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAIL,eAAe,EAGf,iBAAiB,EAElB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAC;AAE9C,eAAO,MAAM,YAAY,wBAAkB,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC,CAcxB"}

package/dist/util/paths.js

@@ -0,0 +1,19 @@
+import { bundledRulesImpactPath, bundledRulesTraceabilityPath, bundledSchemaPath, findProjectRoot, loadDocflowConfig, loadDocumentsManifest, packageBundleRoot, resolveFromRoot, } from "../config/load.js";
+export { findProjectRoot, packageBundleRoot };
+export const findRepoRoot = findProjectRoot;
+export async function resolveProjectPaths(root) {
+    const loaded = await loadDocflowConfig(root);
+    const { bundleRoot } = await loadDocumentsManifest();
+    const p = loaded.config.paths;
+    return {
+        root: loaded.root,
+        config: loaded.config,
+        graph: resolveFromRoot(loaded.root, p.graph),
+        registry: resolveFromRoot(loaded.root, p.registry),
+        schema: bundledSchemaPath(),
+        rulesTraceability: bundledRulesTraceabilityPath(),
+        rulesImpact: bundledRulesImpactPath(),
+        bundleRoot,
+    };
+}
+//# sourceMappingURL=paths.js.map

package/dist/util/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/util/paths.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAC;AAE9C,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;AAa5C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAa;IAEb,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,qBAAqB,EAAE,CAAC;IACrD,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;IAC9B,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC;QAC5C,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC;QAClD,MAAM,EAAE,iBAAiB,EAAE;QAC3B,iBAAiB,EAAE,4BAA4B,EAAE;QACjD,WAAW,EAAE,sBAAsB,EAAE;QACrC,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/visualize/html.d.ts

@@ -0,0 +1,13 @@
+import type { TraceabilityGraph } from "../types.js";
+import type { AnalysisKnowledge } from "../graph/knowledge.js";
+import type { GraphStats, KnowledgeStats } from "./stats.js";
+export interface VisualizePayload {
+    generatedAt: string;
+    projectRoot: string;
+    graph: TraceabilityGraph;
+    knowledge: AnalysisKnowledge | null;
+    graphStats: GraphStats;
+    knowledgeStats: KnowledgeStats;
+}
+export declare function buildVisualizationHtml(payload: VisualizePayload): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/visualize/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/visualize/html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,cAAc,CAAC;CAChC;AAMD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAkXxE"}