coalesce-transform-mcp 0.3.0 → 0.4.2

package/dist/services/config/schema-resolver.js

@@ -1,9 +1,8 @@
-import { CoalesceApiError } from "../../client.js";
 import { getRepoNodeTypeDefinition } from "../repo/operations.js";
 import { loadNodeTypeCorpusSnapshot } from "../corpus/loader.js";
 import { searchNodeTypeCorpusVariants } from "../corpus/search.js";
 import { resolveOptionalRepoPathInput } from "../repo/path.js";
-import { isPlainObject } from "../../utils.js";
+import { isPlainObject, rethrowNonRecoverableApiError } from "../../utils.js";
 function normalizeNodeTypeFamily(nodeType) {
     return nodeType.trim().toLowerCase().replace(/[^a-z0-9]/g, "");
 }
@@ -51,9 +50,7 @@ export async function resolveNodeTypeSchema(nodeType, repoPath) {
         }
         catch (error) {
             // Auth and network errors indicate a broken session — let them propagate
-            if (error instanceof CoalesceApiError && [401, 403, 503].includes(error.status)) {
-                throw error;
-            }
+            rethrowNonRecoverableApiError(error);
             const reason = error instanceof Error ? error.message : String(error);
             process.stderr.write(`[schema-resolver] Repo resolution failed for "${nodeType}": ${reason}. Falling back to corpus.\n`);
             // Fall through to corpus
@@ -82,7 +79,7 @@ export async function resolveNodeTypeSchema(nodeType, repoPath) {
     }
     catch (error) {
         throw new Error(`Cannot resolve node type schema for '${nodeType}'. ` +
-            `Repo resolution failed${resolvedRepoPath ? "" : " (no repoPath provided, COALESCE_REPO_PATH not set)"} and corpus lookup failed: ${error instanceof Error ? error.message : String(error)}`);
+            `Repo resolution failed${resolvedRepoPath ? "" : " (no repoPath provided, COALESCE_REPO_PATH not set)"} and corpus lookup failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
     }
 }
 //# sourceMappingURL=schema-resolver.js.map

package/dist/services/config/schema-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-resolver.js","sourceRoot":"","sources":["../../../src/services/config/schema-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAqB/C,SAAS,uBAAuB,CAAC,QAAgB;IAC/C,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,mBAAmB,CAC1B,cAAuB,EACvB,WAAmB;IAEnB,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,GAAG,WAAW,kDAAkD,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACrD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACzC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1D,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,OAAO,CAAC;oBACN,aAAa,EACX,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;oBACzE,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,UAAU,EACR,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;wBACzE,CAAC,CAAC,IAAI,CAAC,UAAU;wBACjB,CAAC,CAAC,SAAS;oBACf,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,QAAQ,EAAE,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;oBACvE,WAAW,EACT,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;iBACtE,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC;gBACN,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;gBAC3E,KAAK;aACN,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAgB,EAChB,QAAiB;IAEjB,4DAA4D;IAC5D,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAEhE,kCAAkC;IAClC,IAAI,gBAAgB,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,yBAAyB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;YACxE,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC;aACxD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yEAAyE;YACzE,IAAI,KAAK,YAAY,gBAAgB,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChF,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iDAAiD,QAAQ,MAAM,MAAM,6BAA6B,CACnG,CAAC;YACF,yBAAyB;QAC3B,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,0BAA0B,EAAE,CAAC;QAC9C,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,4BAA4B,CAAC,QAAQ,EAAE;YACpD,gBAAgB;YAChB,aAAa,EAAE,WAAW;YAC1B,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,4DAA4D,gBAAgB,GAAG,CAChF,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CACrD,CAAC;QAEF,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,8BAA8B,CAC7E,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC;SAC9D,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,wCAAwC,QAAQ,KAAK;YACrD,yBAAyB,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,qDAAqD,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7L,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"schema-resolver.js","sourceRoot":"","sources":["../../../src/services/config/schema-resolver.ts"],"names":[],"mappings":"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"}

package/dist/services/lineage/lineage-cache.d.ts

@@ -0,0 +1,53 @@
+import type { CoalesceClient } from "../../client.js";
+import type { WorkflowProgressReporter } from "../../workflows/progress.js";
+export type LineageNode = {
+    id: string;
+    name: string;
+    nodeType: string;
+    columns: LineageColumn[];
+    raw: Record<string, unknown>;
+};
+export type LineageColumn = {
+    id: string;
+    name: string;
+    dataType?: string;
+    sourceColumnRefs: ColumnRef[];
+};
+export type ColumnRef = {
+    sourceNodeID: string;
+    sourceColumnID: string;
+};
+export type LineageCacheEntry = {
+    workspaceID: string;
+    nodes: Map<string, LineageNode>;
+    upstreamNodes: Map<string, Set<string>>;
+    downstreamNodes: Map<string, Set<string>>;
+    columnUpstream: Map<string, Set<string>>;
+    columnDownstream: Map<string, Set<string>>;
+    cachedAt: number;
+    ttlMs: number;
+};
+export declare function getLineageTtlMs(): number;
+export declare function columnKey(nodeID: string, columnID: string): string;
+export declare function parseColumnKey(key: string): {
+    nodeID: string;
+    columnID: string;
+};
+export type BuildLineageCacheOptions = {
+    baseDir?: string;
+    ttlMs?: number;
+    reportProgress?: WorkflowProgressReporter;
+    forceRefresh?: boolean;
+};
+export declare function buildLineageCache(client: CoalesceClient, workspaceID: string, options?: BuildLineageCacheOptions): Promise<LineageCacheEntry>;
+export declare function invalidateLineageCache(workspaceID?: string): void;
+export declare function getLineageCacheEntry(workspaceID: string): LineageCacheEntry | undefined;
+export { walkUpstream, walkDownstream, walkColumnLineage, analyzeNodeImpact } from "./lineage-traversal.js";
+export type { LineageGraphNode, ColumnLineageEntry, ImpactResult } from "./lineage-traversal.js";
+export { searchWorkspaceContent } from "./lineage-search.js";
+export type { SearchField, WorkspaceSearchParams, SearchMatch, WorkspaceSearchResult } from "./lineage-search.js";
+export { propagateColumnChange } from "./lineage-propagation.js";
+export type { PropagationChange, PropagationResult, PreMutationSnapshotEntry, PreMutationSnapshotSummary } from "./lineage-propagation.js";
+export { auditDocumentationCoverage } from "./lineage-documentation.js";
+export type { DocumentationAuditResult } from "./lineage-documentation.js";
+//# sourceMappingURL=lineage-cache.d.ts.map

package/dist/services/lineage/lineage-cache.d.ts.map

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

package/dist/services/lineage/lineage-cache.js

@@ -0,0 +1,335 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { listWorkspaceNodes } from "../../coalesce/api/nodes.js";
+import { validatePathSegment } from "../../coalesce/types.js";
+import { isPlainObject } from "../../utils.js";
+import { CACHE_DIR_NAME } from "../../cache-dir.js";
+import { DEFAULT_PAGE_SIZE, DETAIL_FETCH_TIMEOUT_MS } from "../../constants.js";
+const DEFAULT_TTL_MS = 30 * 60 * 1000; // 30 minutes
+const MAX_CACHE_ENTRIES = 50;
+const PROGRESS_INTERVAL = 500;
+const cacheStore = new Map();
+export function getLineageTtlMs() {
+    const raw = process.env.COALESCE_MCP_LINEAGE_TTL_MS;
+    if (raw === undefined)
+        return DEFAULT_TTL_MS;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed < 0)
+        return DEFAULT_TTL_MS;
+    return parsed;
+}
+export function columnKey(nodeID, columnID) {
+    return `${nodeID}:${columnID}`;
+}
+export function parseColumnKey(key) {
+    const sepIndex = key.indexOf(":");
+    if (sepIndex < 1 || sepIndex === key.length - 1) {
+        throw new Error(`Malformed column key: expected "nodeID:columnID" but got "${key}"`);
+    }
+    return {
+        nodeID: key.slice(0, sepIndex),
+        columnID: key.slice(sepIndex + 1),
+    };
+}
+function extractColumns(metadata) {
+    const rawColumns = metadata.columns;
+    if (!Array.isArray(rawColumns))
+        return [];
+    const columns = [];
+    for (const col of rawColumns) {
+        if (!isPlainObject(col))
+            continue;
+        const id = typeof col.columnID === "string" ? col.columnID : typeof col.id === "string" ? col.id : undefined;
+        const name = typeof col.name === "string" ? col.name : undefined;
+        if (!id || !name)
+            continue;
+        const refs = [];
+        const sources = Array.isArray(col.sources) ? col.sources : [];
+        for (const source of sources) {
+            if (!isPlainObject(source))
+                continue;
+            const colRefs = Array.isArray(source.columnReferences) ? source.columnReferences : [];
+            for (const ref of colRefs) {
+                if (!isPlainObject(ref))
+                    continue;
+                const srcNodeID = typeof ref.nodeID === "string" ? ref.nodeID : typeof ref.sourceNodeID === "string" ? ref.sourceNodeID : undefined;
+                const srcColumnID = typeof ref.columnID === "string" ? ref.columnID : typeof ref.sourceColumnID === "string" ? ref.sourceColumnID : undefined;
+                if (srcNodeID && srcColumnID) {
+                    refs.push({ sourceNodeID: srcNodeID, sourceColumnID: srcColumnID });
+                }
+            }
+        }
+        columns.push({
+            id,
+            name,
+            dataType: typeof col.dataType === "string" ? col.dataType : undefined,
+            sourceColumnRefs: refs,
+        });
+    }
+    return columns;
+}
+function extractUpstreamNodeIDs(metadata) {
+    const sourceMapping = metadata.sourceMapping;
+    if (!Array.isArray(sourceMapping))
+        return [];
+    const ids = [];
+    for (const mapping of sourceMapping) {
+        if (!isPlainObject(mapping))
+            continue;
+        // Primary: extract node IDs from aliases map (most reliable — contains resolved UUIDs)
+        const aliases = isPlainObject(mapping.aliases) ? mapping.aliases : {};
+        for (const value of Object.values(aliases)) {
+            if (typeof value === "string") {
+                ids.push(value);
+            }
+        }
+        // Fallback: extract from dependencies if they contain nodeID directly
+        const deps = Array.isArray(mapping.dependencies) ? mapping.dependencies : [];
+        for (const dep of deps) {
+            if (typeof dep === "string") {
+                ids.push(dep);
+            }
+            else if (isPlainObject(dep) && typeof dep.nodeID === "string") {
+                ids.push(dep.nodeID);
+            }
+        }
+    }
+    // Deduplicate — aliases and dependencies may reference the same nodes
+    return [...new Set(ids)];
+}
+function buildLineageNode(raw) {
+    const id = typeof raw.id === "string" ? raw.id : undefined;
+    const name = typeof raw.name === "string" ? raw.name : undefined;
+    const nodeType = typeof raw.nodeType === "string" ? raw.nodeType : undefined;
+    if (!id || !name || !nodeType)
+        return null;
+    const metadata = isPlainObject(raw.metadata) ? raw.metadata : {};
+    return {
+        id,
+        name,
+        nodeType,
+        columns: extractColumns(metadata),
+        raw,
+    };
+}
+function buildIndexes(nodes) {
+    const upstreamNodes = new Map();
+    const downstreamNodes = new Map();
+    const columnUpstream = new Map();
+    const columnDownstream = new Map();
+    for (const node of nodes.values()) {
+        if (!upstreamNodes.has(node.id)) {
+            upstreamNodes.set(node.id, new Set());
+        }
+        if (!downstreamNodes.has(node.id)) {
+            downstreamNodes.set(node.id, new Set());
+        }
+        // Node-level upstream from sourceMapping
+        const metadata = isPlainObject(node.raw.metadata) ? node.raw.metadata : {};
+        const upstreamIDs = extractUpstreamNodeIDs(metadata);
+        for (const upID of upstreamIDs) {
+            if (!nodes.has(upID))
+                continue; // skip references to nodes outside workspace
+            upstreamNodes.get(node.id).add(upID);
+            if (!downstreamNodes.has(upID)) {
+                downstreamNodes.set(upID, new Set());
+            }
+            downstreamNodes.get(upID).add(node.id);
+        }
+        // Column-level lineage from columnReferences
+        for (const col of node.columns) {
+            const key = columnKey(node.id, col.id);
+            if (!columnUpstream.has(key)) {
+                columnUpstream.set(key, new Set());
+            }
+            for (const ref of col.sourceColumnRefs) {
+                const srcKey = columnKey(ref.sourceNodeID, ref.sourceColumnID);
+                columnUpstream.get(key).add(srcKey);
+                if (!columnDownstream.has(srcKey)) {
+                    columnDownstream.set(srcKey, new Set());
+                }
+                columnDownstream.get(srcKey).add(key);
+            }
+        }
+    }
+    return { upstreamNodes, downstreamNodes, columnUpstream, columnDownstream };
+}
+function tryLoadFromSnapshot(workspaceID, baseDir) {
+    const safeID = validatePathSegment(workspaceID, "workspaceID");
+    const ndjsonPath = join(baseDir, CACHE_DIR_NAME, "nodes", `workspace-${safeID}-nodes.ndjson`);
+    const metaPath = join(baseDir, CACHE_DIR_NAME, "nodes", `workspace-${safeID}-nodes.meta.json`);
+    if (!existsSync(ndjsonPath) || !existsSync(metaPath))
+        return null;
+    try {
+        const meta = JSON.parse(readFileSync(metaPath, "utf8"));
+        if (!isPlainObject(meta) || typeof meta.cachedAt !== "string")
+            return null;
+        // Check if snapshot is within TTL
+        const cachedAt = new Date(meta.cachedAt).getTime();
+        if (Date.now() - cachedAt > getLineageTtlMs())
+            return null;
+        const lines = readFileSync(ndjsonPath, "utf8").trimEnd().split("\n");
+        const items = [];
+        for (const line of lines) {
+            if (line.trim().length === 0)
+                continue;
+            const parsed = JSON.parse(line);
+            if (isPlainObject(parsed))
+                items.push(parsed);
+        }
+        // Verify the snapshot was fetched with detail=true by checking the first
+        // node has metadata — summary snapshots lack the metadata.columns field
+        // needed for column lineage indexes.
+        if (items.length > 0 && !isPlainObject(items[0].metadata))
+            return null;
+        return items;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`[tryLoadFromSnapshot] Failed to load snapshot for workspace ${workspaceID}: ${reason}\n`);
+        return null;
+    }
+}
+function parsePage(response) {
+    if (!isPlainObject(response)) {
+        throw new Error("Paginated collection response was not an object");
+    }
+    if ("data" in response && !Array.isArray(response.data)) {
+        throw new Error(`Paginated collection response.data was ${typeof response.data}, expected array`);
+    }
+    return {
+        data: Array.isArray(response.data) ? response.data : [],
+        next: typeof response.next === "string" && response.next.trim().length > 0
+            ? response.next
+            : typeof response.next === "number"
+                ? String(response.next)
+                : undefined,
+    };
+}
+async function fetchAllNodes(client, workspaceID, reportProgress) {
+    const safeID = validatePathSegment(workspaceID, "workspaceID");
+    const items = [];
+    const seenCursors = new Set();
+    let next;
+    let isFirstPage = true;
+    while (isFirstPage || next) {
+        const response = await listWorkspaceNodes(client, {
+            workspaceID: safeID,
+            detail: true,
+            limit: DEFAULT_PAGE_SIZE,
+            orderBy: "id",
+            ...(next ? { startingFrom: next } : {}),
+        }, { timeoutMs: DETAIL_FETCH_TIMEOUT_MS });
+        const page = parsePage(response);
+        for (const item of page.data) {
+            if (isPlainObject(item)) {
+                items.push(item);
+            }
+        }
+        if (reportProgress && items.length % PROGRESS_INTERVAL < DEFAULT_PAGE_SIZE) {
+            await reportProgress(`Fetched ${items.length} nodes`, undefined);
+        }
+        if (page.next) {
+            if (seenCursors.has(page.next)) {
+                throw new Error(`Pagination repeated cursor ${page.next}`);
+            }
+            seenCursors.add(page.next);
+        }
+        next = page.next;
+        isFirstPage = false;
+    }
+    return items;
+}
+export async function buildLineageCache(client, workspaceID, options = {}) {
+    const safeID = validatePathSegment(workspaceID, "workspaceID");
+    const ttlMs = options.ttlMs ?? getLineageTtlMs();
+    // Check in-memory cache first
+    if (!options.forceRefresh) {
+        const cached = cacheStore.get(safeID);
+        if (cached && Date.now() - cached.cachedAt < cached.ttlMs) {
+            return cached;
+        }
+    }
+    const baseDir = options.baseDir ?? process.cwd();
+    // Try loading from disk snapshot
+    let rawNodes = null;
+    if (!options.forceRefresh) {
+        rawNodes = tryLoadFromSnapshot(safeID, baseDir);
+        if (rawNodes && options.reportProgress) {
+            await options.reportProgress(`Loaded ${rawNodes.length} nodes from snapshot cache`);
+        }
+    }
+    // Fetch from API if no snapshot available
+    if (!rawNodes) {
+        if (options.reportProgress) {
+            await options.reportProgress("Fetching all workspace nodes with detail=true");
+        }
+        rawNodes = await fetchAllNodes(client, safeID, options.reportProgress);
+    }
+    // Build node map
+    const nodes = new Map();
+    for (const raw of rawNodes) {
+        const node = buildLineageNode(raw);
+        if (node) {
+            nodes.set(node.id, node);
+        }
+    }
+    if (options.reportProgress) {
+        await options.reportProgress(`Building lineage indexes for ${nodes.size} nodes`);
+    }
+    // Build indexes
+    const indexes = buildIndexes(nodes);
+    const entry = {
+        workspaceID: safeID,
+        nodes,
+        ...indexes,
+        cachedAt: Date.now(),
+        ttlMs,
+    };
+    // Evict expired entries and enforce max cache size
+    const now = Date.now();
+    for (const [key, cached] of cacheStore) {
+        if (now - cached.cachedAt > cached.ttlMs) {
+            cacheStore.delete(key);
+        }
+    }
+    if (cacheStore.size >= MAX_CACHE_ENTRIES) {
+        // Evict the oldest entry by cachedAt
+        let oldestKey;
+        let oldestTime = Infinity;
+        for (const [key, cached] of cacheStore) {
+            if (cached.cachedAt < oldestTime) {
+                oldestTime = cached.cachedAt;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey)
+            cacheStore.delete(oldestKey);
+    }
+    cacheStore.set(safeID, entry);
+    return entry;
+}
+export function invalidateLineageCache(workspaceID) {
+    if (workspaceID) {
+        cacheStore.delete(workspaceID);
+    }
+    else {
+        cacheStore.clear();
+    }
+}
+export function getLineageCacheEntry(workspaceID) {
+    const entry = cacheStore.get(workspaceID);
+    if (!entry)
+        return undefined;
+    if (Date.now() - entry.cachedAt >= entry.ttlMs) {
+        cacheStore.delete(workspaceID);
+        return undefined;
+    }
+    return entry;
+}
+// Re-export traversal, search, and propagation modules so existing imports continue to work
+export { walkUpstream, walkDownstream, walkColumnLineage, analyzeNodeImpact } from "./lineage-traversal.js";
+export { searchWorkspaceContent } from "./lineage-search.js";
+export { propagateColumnChange } from "./lineage-propagation.js";
+export { auditDocumentationCoverage } from "./lineage-documentation.js";
+//# sourceMappingURL=lineage-cache.js.map

package/dist/services/lineage/lineage-cache.js.map

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

package/dist/services/lineage/lineage-documentation.d.ts

@@ -0,0 +1,29 @@
+import type { LineageCacheEntry } from "./lineage-cache.js";
+export type UndocumentedNode = {
+    nodeID: string;
+    nodeName: string;
+    nodeType: string;
+};
+export type UndocumentedColumn = {
+    nodeID: string;
+    nodeName: string;
+    columnID: string;
+    columnName: string;
+};
+export type DocumentationAuditResult = {
+    workspaceID: string;
+    auditedAt: string;
+    totalNodes: number;
+    documentedNodes: number;
+    undocumentedNodes: number;
+    nodeDocumentationPercent: number;
+    totalColumns: number;
+    documentedColumns: number;
+    undocumentedColumns: number;
+    columnDocumentationPercent: number;
+    undocumentedNodeList: UndocumentedNode[];
+    undocumentedColumnList: UndocumentedColumn[];
+    truncatedColumns: boolean;
+};
+export declare function auditDocumentationCoverage(cache: LineageCacheEntry): DocumentationAuditResult;
+//# sourceMappingURL=lineage-documentation.d.ts.map

package/dist/services/lineage/lineage-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage-documentation.d.ts","sourceRoot":"","sources":["../../../src/services/lineage/lineage-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAK5D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,EAAE,MAAM,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0BAA0B,EAAE,MAAM,CAAC;IACnC,oBAAoB,EAAE,gBAAgB,EAAE,CAAC;IACzC,sBAAsB,EAAE,kBAAkB,EAAE,CAAC;IAC7C,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAMF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,iBAAiB,GACvB,wBAAwB,CAiF1B"}

package/dist/services/lineage/lineage-documentation.js

@@ -0,0 +1,80 @@
+import { isPlainObject } from "../../utils.js";
+const MAX_UNDOCUMENTED_COLUMNS = 200;
+function hasNonEmptyDescription(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+export function auditDocumentationCoverage(cache) {
+    let totalNodes = 0;
+    let documentedNodes = 0;
+    let totalColumns = 0;
+    let documentedColumns = 0;
+    const undocumentedNodeList = [];
+    const undocumentedColumnList = [];
+    for (const node of cache.nodes.values()) {
+        totalNodes++;
+        // Check node-level description (raw.description OR raw.metadata.description,
+        // matching lineage-search.ts extractDescription logic)
+        const metaObj = isPlainObject(node.raw.metadata) ? node.raw.metadata : {};
+        if (hasNonEmptyDescription(node.raw.description) || hasNonEmptyDescription(metaObj.description)) {
+            documentedNodes++;
+        }
+        else {
+            undocumentedNodeList.push({
+                nodeID: node.id,
+                nodeName: node.name,
+                nodeType: node.nodeType,
+            });
+        }
+        // Check column-level descriptions via raw metadata
+        const rawColumns = Array.isArray(metaObj.columns)
+            ? metaObj.columns
+            : [];
+        for (const col of node.columns) {
+            totalColumns++;
+            // Find the matching raw column to check its description
+            const rawCol = rawColumns.find((rc) => {
+                if (!isPlainObject(rc))
+                    return false;
+                const rcId = typeof rc.columnID === "string"
+                    ? rc.columnID
+                    : typeof rc.id === "string"
+                        ? rc.id
+                        : undefined;
+                return rcId === col.id;
+            });
+            if (rawCol && isPlainObject(rawCol) && hasNonEmptyDescription(rawCol.description)) {
+                documentedColumns++;
+            }
+            else if (undocumentedColumnList.length < MAX_UNDOCUMENTED_COLUMNS) {
+                undocumentedColumnList.push({
+                    nodeID: node.id,
+                    nodeName: node.name,
+                    columnID: col.id,
+                    columnName: col.name,
+                });
+            }
+        }
+    }
+    const undocumentedNodes = totalNodes - documentedNodes;
+    const undocumentedColumnsCount = totalColumns - documentedColumns;
+    return {
+        workspaceID: cache.workspaceID,
+        auditedAt: new Date().toISOString(),
+        totalNodes,
+        documentedNodes,
+        undocumentedNodes,
+        nodeDocumentationPercent: totalNodes > 0
+            ? Math.round((documentedNodes / totalNodes) * 10000) / 100
+            : 0,
+        totalColumns,
+        documentedColumns,
+        undocumentedColumns: undocumentedColumnsCount,
+        columnDocumentationPercent: totalColumns > 0
+            ? Math.round((documentedColumns / totalColumns) * 10000) / 100
+            : 0,
+        undocumentedNodeList,
+        undocumentedColumnList,
+        truncatedColumns: undocumentedColumnsCount > MAX_UNDOCUMENTED_COLUMNS,
+    };
+}
+//# sourceMappingURL=lineage-documentation.js.map

package/dist/services/lineage/lineage-documentation.js.map

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

package/dist/services/lineage/lineage-propagation.d.ts

@@ -0,0 +1,47 @@
+import type { CoalesceClient } from "../../client.js";
+import type { LineageCacheEntry } from "./lineage-cache.js";
+import type { WorkflowProgressReporter } from "../../workflows/progress.js";
+export type PropagationChange = {
+    columnName?: string;
+    dataType?: string;
+};
+type ColumnUpdateInfo = {
+    nodeID: string;
+    nodeName: string;
+    columnID: string;
+    columnName: string;
+    previousName?: string;
+    previousDataType?: string;
+};
+export type PreMutationSnapshotEntry = {
+    nodeID: string;
+    nodeName: string;
+    columnID: string;
+    previousColumnName: string;
+    previousDataType: string;
+    capturedAt: string;
+    nodeBody: Record<string, unknown>;
+};
+/** Inline summary returned in the tool response (no nodeBody — LLM-friendly). */
+export type PreMutationSnapshotSummary = Omit<PreMutationSnapshotEntry, "nodeBody">;
+export type PropagationResult = {
+    sourceNodeID: string;
+    sourceColumnID: string;
+    changes: PropagationChange;
+    /** Inline summary without nodeBody — safe for LLM context windows. */
+    preMutationSnapshot: PreMutationSnapshotSummary[];
+    /** Path to the disk snapshot file containing full nodeBody for reversal. */
+    snapshotPath?: string;
+    updatedNodes: ColumnUpdateInfo[];
+    totalUpdated: number;
+    errors: Array<{
+        nodeID: string;
+        columnID: string;
+        message: string;
+    }>;
+    partialFailure?: boolean;
+    skippedNodes?: ColumnUpdateInfo[];
+};
+export declare function propagateColumnChange(client: CoalesceClient, cache: LineageCacheEntry, workspaceID: string, nodeID: string, columnID: string, changes: PropagationChange, reportProgress?: WorkflowProgressReporter, baseDir?: string): Promise<PropagationResult>;
+export {};
+//# sourceMappingURL=lineage-propagation.d.ts.map

package/dist/services/lineage/lineage-propagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage-propagation.d.ts","sourceRoot":"","sources":["../../../src/services/lineage/lineage-propagation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAO5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAE5E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,wBAAwB,EAAE,UAAU,CAAC,CAAC;AAEpF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,sEAAsE;IACtE,mBAAmB,EAAE,0BAA0B,EAAE,CAAC;IAClD,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC,CAAC;AAMF,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,EAC1B,cAAc,CAAC,EAAE,wBAAwB,EACzC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC,CAkM5B"}