@cleocode/core 2026.9.8 → 2026.9.10

package/dist/nexus/impact.js

@@ -9,8 +9,8 @@
  */
 import { eq, notInArray } from 'drizzle-orm';
 import { engineError, engineSuccess } from '../engine-result.js';
-import { getNexusDb, getNexusNativeDb, nexusSchema } from '../store/nexus-sqlite.js';
-import { buildSymbolMissError } from './symbol-miss.js';
+import { getNexusDb, nexusSchema } from '../store/nexus-sqlite.js';
+import { assessKnowledgeCoverage, KnowledgeSymbolAmbiguityError, recordKnowledgeGap, resolveKnowledgeSymbol, } from './knowledge.js';
 /**
  * Analyse the blast radius for a named code symbol via BFS upstream traversal.
  *
@@ -19,11 +19,11 @@ import { buildSymbolMissError } from './symbol-miss.js';
  * breadth-first up to `maxDepth` levels. Returns per-depth layers with risk
  * classification.
  *
- * Throws with code `E_NOT_FOUND` when no symbol matches the query.
+ * Missing coverage returns UNKNOWN; ambiguous names return qualified candidates.
  *
  * @param symbolName - Symbol name to analyse (partial match).
  * @param projectId  - Nexus project ID.
- * @param _repoPath  - Absolute repository root path (reserved for future use).
+ * @param repoPath   - Absolute repository root path used for freshness checks.
  * @param opts       - Traversal options.
  * @returns Impact analysis result.
  *
@@ -31,58 +31,49 @@ import { buildSymbolMissError } from './symbol-miss.js';
  * const impact = await getSymbolImpact('dispatchFromCli', projectId, repoPath);
  * console.log(impact.riskLevel, impact.totalImpactedNodes);
  */
-export async function getSymbolImpact(symbolName, projectId, _repoPath, opts = {}) {
-    const maxDepth = Math.min(opts.maxDepth ?? 3, 5);
+export async function getSymbolImpact(symbolName, projectId, repoPath, opts = {}) {
+    const maxDepth = Math.max(1, Math.min(Number.isFinite(opts.maxDepth) ? (opts.maxDepth ?? 3) : 3, 5));
     const whyFlag = opts.why ?? false;
-    const { sortMatchingNodes } = await import('./symbol-ranking.js');
-    const db = await getNexusDb();
-    // Fetch only symbol nodes (exclude community/process structural nodes).
-    // ADR-090 · T11648: project-scoped DB — the former `project_id = ?` predicate
-    // is dropped; only the kind exclusion remains (indexed via idx_nexus_nodes_kind).
-    let projectSymbolNodes = [];
-    try {
-        projectSymbolNodes = db
-            .select()
-            .from(nexusSchema.nexusNodes)
-            .where(notInArray(nexusSchema.nexusNodes.kind, ['community', 'process']))
-            .all();
-    }
-    catch {
-        projectSymbolNodes = [];
-    }
-    const lowerSymbol = symbolName.toLowerCase();
-    const rawMatchingNodes = projectSymbolNodes.filter((n) => n['name'] != null && String(n['name']).toLowerCase().includes(lowerSymbol));
-    const matchingNodes = sortMatchingNodes(rawMatchingNodes, symbolName);
-    if (matchingNodes.length === 0) {
-        // T12068: distinguish "no such symbol" from "index predates the symbol".
-        throw buildSymbolMissError(symbolName, projectId, projectSymbolNodes);
-    }
-    // Fetch all relations (project-scoped DB — ADR-090 · T11648: no `project_id`
-    // predicate). T11545: plasticity `weight` lives in the sibling
-    // `nexus_relation_weights` table — LEFT JOIN it and flatten so downstream reads
-    // `r['weight']` (NULL when the edge has never been strengthened).
-    let allRelations = [];
-    try {
-        const joined = db
-            .select()
-            .from(nexusSchema.nexusRelations)
-            .leftJoin(nexusSchema.nexusRelationWeights, eq(nexusSchema.nexusRelationWeights.relationId, nexusSchema.nexusRelations.id))
-            .all();
-        allRelations = joined.map((row) => ({
-            ...row.nexus_relations,
-            weight: row.nexus_relation_weights?.['weight'] ?? null,
-        }));
-    }
-    catch {
-        allRelations = [];
-    }
-    const nodeById = new Map();
-    for (const n of projectSymbolNodes) {
-        nodeById.set(String(n['id']), n);
+    const coverage = await assessKnowledgeCoverage(repoPath, projectId);
+    const emptyResult = {
+        query: symbolName,
+        projectId,
+        coverage,
+        targetNodeId: null,
+        targetName: null,
+        targetKind: null,
+        targetFilePath: null,
+        riskLevel: 'UNKNOWN',
+        totalImpactedNodes: 0,
+        maxDepth,
+        why: whyFlag,
+        impactByDepth: [],
+    };
+    if (coverage.status === 'failed' || coverage.status === 'missing')
+        return emptyResult;
+    const db = await getNexusDb(repoPath);
+    const projectSymbolNodes = db
+        .select()
+        .from(nexusSchema.nexusNodes)
+        .where(notInArray(nexusSchema.nexusNodes.kind, ['community', 'process']))
+        .all();
+    const targetNode = resolveKnowledgeSymbol(symbolName, projectSymbolNodes);
+    if (!targetNode) {
+        recordKnowledgeGap(coverage, 'missing', `No indexed symbol matches '${symbolName}'.`);
+        return emptyResult;
     }
-    const targetNode = matchingNodes[0];
-    const targetId = String(targetNode['id']);
-    const targetLabel = String(targetNode['name'] ?? targetNode['label'] ?? targetId);
+    const joined = db
+        .select()
+        .from(nexusSchema.nexusRelations)
+        .leftJoin(nexusSchema.nexusRelationWeights, eq(nexusSchema.nexusRelationWeights.relationId, nexusSchema.nexusRelations.id))
+        .all();
+    const allRelations = joined.map((row) => ({
+        ...row.nexus_relations,
+        weight: row.nexus_relation_weights?.weight ?? null,
+    }));
+    const nodeById = new Map(projectSymbolNodes.map((node) => [node.id, node]));
+    const targetId = targetNode.id;
+    const targetLabel = targetNode.name ?? targetNode.label;
     // Build reverse adjacency: targetId → [{ sourceId, type, weight }]
     const reverseAdj = new Map();
     const incomingCount = new Map();
@@ -142,16 +133,22 @@ export async function getSymbolImpact(symbolName, projectId, _repoPath, opts = {
         }
     }
     const totalImpact = visited.size - 1;
-    const riskLevel = totalImpact === 0
-        ? 'NONE'
-        : totalImpact <= 3
-            ? 'LOW'
-            : totalImpact <= 10
-                ? 'MEDIUM'
-                : totalImpact <= 25
-                    ? 'HIGH'
-                    : 'CRITICAL';
-    const depthLabels = ['WILL BREAK (direct callers)', 'LIKELY AFFECTED', 'MAY NEED TESTING'];
+    const riskLevel = coverage.status !== 'current'
+        ? 'UNKNOWN'
+        : totalImpact === 0
+            ? 'NONE'
+            : totalImpact <= 3
+                ? 'LOW'
+                : totalImpact <= 10
+                    ? 'MEDIUM'
+                    : totalImpact <= 25
+                        ? 'HIGH'
+                        : 'CRITICAL';
+    const depthLabels = [
+        'DIRECT CALLERS (potentially affected)',
+        'LIKELY AFFECTED',
+        'MAY NEED TESTING',
+    ];
     const layers = impactByDepth.map((layer, i) => ({
         depth: i + 1,
         label: depthLabels[i] ?? `depth ${i + 1}`,
@@ -168,6 +165,7 @@ export async function getSymbolImpact(symbolName, projectId, _repoPath, opts = {
     return {
         query: symbolName,
         projectId,
+        coverage,
         targetNodeId: targetId,
         targetName: targetNode['name'],
         targetKind: targetNode['kind'],
@@ -188,142 +186,48 @@ export async function getSymbolImpact(symbolName, projectId, _repoPath, opts = {
  * Runs BFS from the target symbol to find all symbols that would be affected
  * by changes to it, optionally with detailed reasons.
  *
+ * @param projectRoot - Explicit project root whose graph and coverage are assessed.
+ * @param params - Shared impact query, project identity, reasons, and depth options.
+ * @returns Impact result or structured symbol ambiguity/error details.
+ * @remarks Project binding is explicit and never falls back to the process working directory.
+ * @example
+ * ```ts
+ * const params: NexusImpactParams = { symbol: 'entryPoint', depth: 2 };
+ * const result = await nexusImpact('/workspace/project', params);
+ * ```
  * @task T1569
  */
-// SSoT-EXEMPT:engine-migration-T1569
-export async function nexusImpact(symbol, 
-// `projectId` unused since ADR-090 · T11648 (project-scoped graph DB); retained
-// for the CLI dispatch signature.
-_projectId, why) {
+export async function nexusImpact(projectRoot, params) {
     try {
-        await getNexusDb();
-        const db = getNexusNativeDb();
-        if (!db) {
-            return engineSuccess({
-                targetNodeId: null,
-                why: why ?? false,
-                affected: [],
-                riskLevel: 'NONE',
-            });
-        }
-        // ADR-090 · T11648: project-scoped graph DB — drop the `project_id` column +
-        // predicate (one project per DB).
-        const allNodes = db
-            .prepare(`SELECT id, label, kind, file_path, name
-           FROM nexus_nodes
-          WHERE kind NOT IN ('community','process','file','folder')`)
-            .all();
-        const lowerSymbol = symbol.toLowerCase();
-        const candidates = allNodes.filter((n) => {
-            const haystack = (n.name ?? n.label ?? '').toLowerCase();
-            return haystack.length > 0 && haystack.includes(lowerSymbol);
-        });
-        candidates.sort((a, b) => {
-            const an = (a.name ?? a.label ?? '').toLowerCase();
-            const bn = (b.name ?? b.label ?? '').toLowerCase();
-            const exactA = an === lowerSymbol ? 0 : 1;
-            const exactB = bn === lowerSymbol ? 0 : 1;
-            if (exactA !== exactB)
-                return exactA - exactB;
-            return an.length - bn.length;
+        const coverage = await assessKnowledgeCoverage(projectRoot, params.projectId);
+        const impact = await getSymbolImpact(params.symbol, coverage.projectId, projectRoot, {
+            why: params.why,
+            maxDepth: params.depth,
         });
-        const target = candidates[0];
-        if (!target) {
-            return engineSuccess({
-                targetNodeId: null,
-                why: why ?? false,
-                affected: [],
-                riskLevel: 'NONE',
-            });
-        }
-        // T11545: plasticity weight lives in the sibling `nexus_relation_weights`
-        // table (LEFT JOIN — edges never strengthened have no weights row → NULL).
-        const allRelations = db
-            .prepare(`SELECT r.source_id AS source_id, r.target_id AS target_id, r.type AS type, w.weight AS weight
-           FROM nexus_relations r
-      LEFT JOIN nexus_relation_weights w ON w.relation_id = r.id
-          WHERE r.type IN ('calls','imports','accesses')`)
-            .all();
-        const reverseAdj = new Map();
-        for (const rel of allRelations) {
-            const list = reverseAdj.get(rel.target_id);
-            if (list) {
-                list.push(rel);
-            }
-            else {
-                reverseAdj.set(rel.target_id, [rel]);
-            }
-        }
-        const incomingCount = new Map();
-        for (const rel of allRelations) {
-            incomingCount.set(rel.target_id, (incomingCount.get(rel.target_id) ?? 0) + 1);
-        }
-        const nodeById = new Map();
-        for (const n of allNodes) {
-            nodeById.set(n.id, n);
-        }
-        const visited = new Set([target.id]);
-        const queue = [{ id: target.id, depth: 0 }];
-        const affected = [];
-        while (queue.length > 0) {
-            const item = queue.shift();
-            if (!item)
-                break;
-            if (item.depth >= 3)
-                continue;
-            const callers = reverseAdj.get(item.id) ?? [];
-            for (const edge of callers) {
-                if (visited.has(edge.source_id))
-                    continue;
-                visited.add(edge.source_id);
-                const depth = item.depth + 1;
-                const callerNode = nodeById.get(edge.source_id);
-                const reasons = [];
-                if (why) {
-                    const calls = incomingCount.get(edge.source_id) ?? 0;
-                    if (calls > 0) {
-                        reasons.push(`called by ${calls} place${calls === 1 ? '' : 's'}`);
-                    }
-                    if (edge.weight != null && edge.weight > 0) {
-                        reasons.push(`strength=${edge.weight.toFixed(3)} via ${edge.type}`);
-                    }
-                    else {
-                        reasons.push(`edge type ${edge.type} (weight=0 — no plasticity yet)`);
-                    }
-                    reasons.push(`depth=${depth} hop from target ${target.label ?? target.id}`);
-                }
-                affected.push({
-                    nodeId: edge.source_id,
-                    label: callerNode?.label ?? edge.source_id,
-                    kind: callerNode?.kind ?? 'unknown',
-                    reasons,
-                });
-                queue.push({ id: edge.source_id, depth });
-            }
-        }
-        let riskLevel = 'NONE';
-        if (affected.length > 0) {
-            if (affected.length > 10) {
-                riskLevel = 'CRITICAL';
-            }
-            else if (affected.length > 5) {
-                riskLevel = 'HIGH';
-            }
-            else if (affected.length > 2) {
-                riskLevel = 'MEDIUM';
-            }
-            else {
-                riskLevel = 'LOW';
-            }
-        }
         return engineSuccess({
-            targetNodeId: target.id,
-            why: why ?? false,
-            affected,
-            riskLevel,
+            query: params.symbol,
+            projectId: impact.projectId,
+            coverage: impact.coverage,
+            targetNodeId: impact.targetNodeId,
+            targetLabel: impact.targetName,
+            why: impact.why,
+            riskLevel: impact.riskLevel,
+            totalImpact: impact.totalImpactedNodes,
+            maxDepth: impact.maxDepth,
+            affected: impact.impactByDepth.flatMap((layer) => layer.nodes.map((node) => ({
+                nodeId: node.nodeId,
+                label: node.name,
+                kind: node.kind,
+                filePath: node.filePath,
+                depth: layer.depth,
+                reasons: node.reasons,
+            }))),
         });
     }
     catch (error) {
+        if (error instanceof KnowledgeSymbolAmbiguityError) {
+            return engineError(error.code, error.message, { details: { candidates: error.candidates } });
+        }
         return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
     }
 }

package/dist/nexus/impact.js.map

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

package/dist/nexus/knowledge.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Shared coverage assessment and unambiguous symbol resolution.
+ *
+ * Code placed in `packages/core/` per Package-Boundary Check — verified
+ * against AGENTS.md. These services do not invoke a language model.
+ */
+import type { GraphIndexAssessment, KnowledgeCoverage, KnowledgeCoverageStatus, KnowledgeSymbolCandidate } from '@cleocode/contracts';
+/**
+ * Read validated generation provenance without treating malformed metadata as healthy.
+ * @param projectRoot - Explicit project root, or the ambient canonical project when omitted.
+ * @returns The published assessment, or null for a legacy generation.
+ * @remarks Reads only through the canonical project store. Malformed metadata throws.
+ * @example
+ * ```ts
+ * const generation = await readKnowledgeIndexAssessment(projectRoot);
+ * ```
+ */
+export declare function readKnowledgeIndexAssessment(projectRoot?: string): Promise<GraphIndexAssessment | null>;
+/**
+ * An unresolved short name with exact identifiers the caller can choose from.
+ * @remarks Consumers preserve the candidate list in their error envelope.
+ * @example
+ * ```ts
+ * if (error instanceof KnowledgeSymbolAmbiguityError) return error.candidates;
+ * ```
+ */
+export declare class KnowledgeSymbolAmbiguityError extends Error {
+    /** Stable machine-readable failure code. */
+    readonly code = "E_AMBIGUOUS_SYMBOL";
+    /** Every best-matching candidate; no checkout is silently selected. */
+    readonly candidates: KnowledgeSymbolCandidate[];
+    /**
+     * Create an ambiguity error preserving candidates for structured envelopes.
+     * @param query - Unresolved short symbol name.
+     * @param candidates - All equally eligible qualified identifiers.
+     */
+    constructor(query: string, candidates: KnowledgeSymbolCandidate[]);
+}
+/**
+ * Resolve exact identifiers, then exact names, then partial names without choosing a tie.
+ * @param query - Qualified graph identifier or symbol name.
+ * @param nodes - Candidate symbols from the scoped graph.
+ * @returns The unique candidate, or null if none matches.
+ * @remarks Ambiguous short names throw an error carrying every eligible candidate.
+ * @example
+ * ```ts
+ * const target = resolveKnowledgeSymbol('src/api.ts::serve', candidates);
+ * ```
+ */
+export declare function resolveKnowledgeSymbol(query: string, nodes: readonly KnowledgeSymbolCandidate[]): KnowledgeSymbolCandidate | null;
+/**
+ * Add an explicit coverage limitation without hiding a prior diagnostic failure.
+ * @param coverage - Assessment to update in place.
+ * @param status - Newly observed coverage status.
+ * @param reason - Inspectable reason supporting the status.
+ * @returns Nothing; the supplied assessment retains the strongest observed defect.
+ * @remarks A partial result cannot overwrite a prior missing or failed result.
+ * @example
+ * ```ts
+ * recordKnowledgeGap(coverage, 'missing', 'No indexed symbol matches the evidence.');
+ * ```
+ */
+export declare function recordKnowledgeGap(coverage: KnowledgeCoverage, status: KnowledgeCoverageStatus, reason: string): void;
+/**
+ * Assess graph coverage within the caller's maintenance budget (two seconds by default).
+ *
+ * Deferred work is read-only and cannot apply a repair after the response. A
+ * synchronous native query cannot be preempted by JavaScript's event loop.
+ * @param projectRoot - Canonical project root whose knowledge is assessed.
+ * @param projectId - Existing project identity when supplied by the caller.
+ * @param budgetMs - Maximum asynchronous foreground assessment time.
+ * @returns Coverage with explicit reasons and a next action when deferred.
+ * @remarks This service does not invoke models or mutate derived knowledge.
+ * @example
+ * ```ts
+ * const coverage = await assessKnowledgeCoverage(projectRoot, undefined, 2000);
+ * ```
+ */
+export declare function assessKnowledgeCoverage(projectRoot: string, projectId?: string, budgetMs?: number): Promise<KnowledgeCoverage>;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/nexus/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/nexus/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EACV,oBAAoB,EAEpB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAwM7B;;;;;;;;;GASG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAsBtC;AAED;;;;;;;GAOG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,wBAAwB;IAErC,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,wBAAwB,EAAE,CAAC;IAEhD;;;;OAIG;gBACS,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,wBAAwB,EAAE;CAKlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,wBAAwB,EAAE,GACzC,wBAAwB,GAAG,IAAI,CAWjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,MAAM,GACb,IAAI,CAUN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,SAAO,GACd,OAAO,CAAC,iBAAiB,CAAC,CAS5B"}