@devflow-tools/context-engine 0.17.1 → 0.17.2

package/dist/artifact-inventory.d.ts

@@ -0,0 +1,37 @@
+import type { CodeGraph } from '@colbymchenry/codegraph';
+import type { ArtifactContextRole, RetrievalTaskAction } from '@devflow-tools/sdk';
+import type { IndexedFileFreshness, IndexerAdapter } from './indexer-adapter.js';
+export type ArtifactMatchMode = 'explicit_path' | 'artifact_name' | 'exported_symbol' | 'route_registration' | 'lexical_support' | 'missing_explicit_path';
+export interface ArtifactInventoryEntry {
+    path: string;
+    artifactRole: ArtifactContextRole;
+    score: number;
+    matchMode: ArtifactMatchMode;
+    artifactKind: 'component' | 'page' | 'route' | 'module' | 'test' | 'config' | 'resource' | 'source';
+    symbols: string[];
+    evidence: string[];
+    freshness: IndexedFileFreshness;
+}
+export interface ArtifactInventoryResult {
+    entries: ArtifactInventoryEntry[];
+    operationTargets: ArtifactInventoryEntry[];
+    missingExplicitTargets: ArtifactInventoryEntry[];
+    ambiguous: boolean;
+}
+export declare function buildArtifactInventory(input: {
+    codegraph: CodeGraph;
+    indexer: IndexerAdapter;
+    query: string;
+    explicitTargetAnchors: string[];
+    action: RetrievalTaskAction;
+    identity?: {
+        projectRoot: string;
+        sessionId?: string;
+        turnId?: string;
+        requestId?: string;
+        executionId?: string;
+        intentArtifactHash?: string;
+        queryPlanHash?: string;
+    };
+}): ArtifactInventoryResult;
+//# sourceMappingURL=artifact-inventory.d.ts.map

package/dist/artifact-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-inventory.d.ts","sourceRoot":"","sources":["../src/artifact-inventory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEjF,MAAM,MAAM,iBAAiB,GACzB,eAAe,GACf,eAAe,GACf,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,mBAAmB,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,iBAAiB,CAAC;IAC7B,YAAY,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACpG,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,oBAAoB,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,gBAAgB,EAAE,sBAAsB,EAAE,CAAC;IAC3C,sBAAsB,EAAE,sBAAsB,EAAE,CAAC;IACjD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,CAAC,EAAE;QACT,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH,GAAG,uBAAuB,CA+G1B"}

package/dist/artifact-inventory.js

@@ -0,0 +1,211 @@
+import { extname, normalize } from 'node:path';
+import { emitSemanticControlLog } from '@devflow-tools/telemetry';
+export function buildArtifactInventory(input) {
+    const files = input.codegraph.getFiles().map(file => normalizeProjectPath(file.path));
+    const indexedFiles = new Set(files);
+    const explicitAnchors = [...new Set(input.explicitTargetAnchors.map(normalizeProjectPath).filter(Boolean))];
+    const terms = artifactTerms(input.query, explicitAnchors);
+    const requestedKinds = inferRequestedArtifactKinds(input.query);
+    const candidates = new Map();
+    for (const anchor of explicitAnchors) {
+        const exact = resolveExplicitAnchor(anchor, files);
+        if (exact) {
+            setCandidate(candidates, inventoryEntry(input, exact, 'operation_target', 1, 'explicit_path', [
+                `explicit target anchor resolved to ${exact}`,
+            ]));
+            continue;
+        }
+        const freshness = input.indexer.getFileFreshness(anchor);
+        setCandidate(candidates, {
+            path: anchor,
+            artifactRole: 'operation_target',
+            score: 1,
+            matchMode: 'missing_explicit_path',
+            artifactKind: artifactKind(anchor),
+            symbols: [],
+            evidence: [`explicit target anchor ${anchor} does not resolve to a current project file`],
+            freshness,
+        });
+    }
+    for (const path of files) {
+        if (!isInventoryFile(path))
+            continue;
+        const nodes = input.codegraph.getNodesInFile(path)
+            .filter(node => node.kind !== 'file' && node.kind !== 'import');
+        const symbols = [...new Set(nodes.map(node => String(node.name)).filter(Boolean))];
+        const normalizedBase = normalizeIdentity(path.split('/').at(-1)?.replace(/\.[^.]+$/u, '') ?? '');
+        const normalizedPath = normalizeIdentity(path);
+        const symbolIdentities = symbols.map(normalizeIdentity);
+        const exactName = terms.find(term => normalizedBase === term || symbolIdentities.includes(term));
+        const partialName = terms.find(term => term.length >= 4
+            && (normalizedBase.includes(term) || symbolIdentities.some(symbol => symbol.includes(term))));
+        const routeMatch = artifactKind(path) === 'route' && terms.some(term => normalizedPath.includes(term));
+        if (!exactName && !partialName && !routeMatch)
+            continue;
+        const kind = artifactKind(path);
+        const kindAdjustment = requestedKinds.size === 0
+            ? 0
+            : requestedKinds.has(kind) ? 0.08
+                : kind === 'route' || kind === 'source' || kind === 'module' ? -0.12 : -0.04;
+        const score = clampScore((exactName ? 0.97 : routeMatch ? 0.91 : 0.88) + kindAdjustment);
+        const mode = exactName
+            ? symbolIdentities.includes(exactName) ? 'exported_symbol' : 'artifact_name'
+            : routeMatch ? 'route_registration' : 'artifact_name';
+        const strongArtifactMatch = score >= 0.88 && !isSupportOnlyPath(path)
+            && (requestedKinds.size === 0 || requestedKinds.has(kind));
+        const artifactRole = strongArtifactMatch
+            ? 'operation_target'
+            : 'supporting_file';
+        setCandidate(candidates, inventoryEntry(input, path, artifactRole, score, mode, [
+            `${mode} matched ${exactName ?? partialName ?? 'route'} in ${path}`,
+        ], symbols));
+    }
+    const entries = [...candidates.values()]
+        .filter(entry => entry.matchMode === 'missing_explicit_path' || entry.freshness.exists)
+        .sort((left, right) => right.score - left.score || left.path.localeCompare(right.path));
+    const explicitTargets = entries.filter(entry => entry.matchMode === 'explicit_path'
+        || entry.matchMode === 'missing_explicit_path');
+    let operationTargets = explicitTargets.length > 0
+        ? explicitTargets
+        : entries.filter(entry => entry.artifactRole === 'operation_target' && entry.score >= 0.88);
+    if (operationTargets.length > 1 && explicitTargets.length === 0) {
+        const top = operationTargets[0].score;
+        operationTargets = operationTargets.filter(entry => top - entry.score <= 0.03).slice(0, 5);
+    }
+    else {
+        operationTargets = operationTargets.slice(0, explicitTargets.length > 0 ? 16 : 3);
+    }
+    const operationPaths = new Set(operationTargets.map(entry => entry.path));
+    for (const entry of entries) {
+        if (!operationPaths.has(entry.path) && entry.artifactRole === 'operation_target') {
+            entry.artifactRole = input.action === 'create' ? 'reference_pattern' : 'supporting_file';
+        }
+    }
+    const ambiguous = explicitTargets.length === 0 && operationTargets.length > 1;
+    const result = {
+        entries: entries.slice(0, 40),
+        operationTargets,
+        missingExplicitTargets: entries.filter(entry => entry.matchMode === 'missing_explicit_path'),
+        ambiguous,
+    };
+    if (input.identity) {
+        try {
+            emitSemanticControlLog({
+                event: 'artifact.inventory.completed',
+                identity: input.identity,
+                level: result.missingExplicitTargets.length > 0 || ambiguous ? 'warn' : 'info',
+                timestamp: Date.now(),
+                data: {
+                    action: input.action,
+                    explicitAnchorCount: explicitAnchors.length,
+                    candidateCount: result.entries.length,
+                    operationTargets: operationTargets.map(entry => entry.path),
+                    missingExplicitTargets: result.missingExplicitTargets.map(entry => entry.path),
+                    ambiguous,
+                },
+            });
+        }
+        catch {
+            // Inventory observability cannot alter context selection.
+        }
+    }
+    return result;
+}
+function inventoryEntry(input, path, artifactRole, score, matchMode, evidence, symbols = []) {
+    return {
+        path,
+        artifactRole,
+        score,
+        matchMode,
+        artifactKind: artifactKind(path),
+        symbols,
+        evidence,
+        freshness: input.indexer.getFileFreshness(path),
+    };
+}
+function setCandidate(candidates, candidate) {
+    const existing = candidates.get(candidate.path);
+    if (!existing || candidate.score > existing.score
+        || candidate.matchMode === 'explicit_path' || candidate.matchMode === 'missing_explicit_path') {
+        candidates.set(candidate.path, candidate);
+    }
+}
+function resolveExplicitAnchor(anchor, files) {
+    if (files.includes(anchor))
+        return anchor;
+    const caseInsensitive = files.filter(path => path.toLocaleLowerCase('en-US') === anchor.toLocaleLowerCase('en-US'));
+    if (caseInsensitive.length === 1)
+        return caseInsensitive[0];
+    const withoutExtension = anchor.replace(/\.[^.]+$/u, '');
+    const candidates = files.filter(path => path.replace(/\.[^.]+$/u, '') === withoutExtension
+        || path.startsWith(`${withoutExtension}/index.`));
+    return candidates.length === 1 ? candidates[0] : undefined;
+}
+function inferRequestedArtifactKinds(query) {
+    const kinds = new Set();
+    if (/component|组件/iu.test(query)) {
+        kinds.add('component');
+        kinds.add('page');
+    }
+    if (/\bpage\b|页面/iu.test(query)) {
+        kinds.add('page');
+        kinds.add('component');
+    }
+    if (/\broute\b|routing|路由/iu.test(query))
+        kinds.add('route');
+    if (/\bmodule\b|模块/iu.test(query))
+        kinds.add('module');
+    if (/\btests?\b|测试/iu.test(query))
+        kinds.add('test');
+    if (/\bconfig\b|配置/iu.test(query))
+        kinds.add('config');
+    return kinds;
+}
+function clampScore(value) {
+    return Math.max(0, Math.min(1, value));
+}
+function artifactTerms(query, anchors) {
+    const normalized = query.normalize('NFKC').replace(/([a-z0-9])([A-Z])/gu, '$1 $2').toLocaleLowerCase('en-US');
+    const raw = [
+        ...(normalized.match(/[a-z_$][a-z0-9_$-]{2,}/gu) ?? []),
+        ...anchors.flatMap(anchor => anchor.split(/[/.\\_-]+/u)),
+    ];
+    const stop = new Set([
+        'component', 'components', 'page', 'pages', 'module', 'file', 'files', 'src',
+        'create', 'modify', 'update', 'build', 'review', 'analyze', 'performance',
+        'add', 'new', 'feature', 'implement', 'props', 'jsx', 'react', 'tsx',
+        'typescript', 'javascript', 'help', 'please', 'using', 'current', 'project',
+    ]);
+    return [...new Set(raw.map(normalizeIdentity).filter(term => term.length >= 3 && !stop.has(term)))];
+}
+function normalizeIdentity(value) {
+    return value.normalize('NFKC').toLocaleLowerCase('en-US').replace(/[^a-z0-9_$]+/gu, '');
+}
+function artifactKind(path) {
+    if (/(?:^|\/)routes?(?:\/|\.)|\.route\.[cm]?[jt]sx?$/iu.test(path))
+        return 'route';
+    if (/(?:^|\/)pages?(?:\/|\.)|page\.[cm]?[jt]sx?$/iu.test(path))
+        return 'page';
+    if (/(?:^|\/)components?(?:\/|\.)|\.[jt]sx$/iu.test(path))
+        return 'component';
+    if (/\.(?:test|spec)\.[cm]?[jt]sx?$/iu.test(path))
+        return 'test';
+    if (/(?:^|\/)config|\.config\.[cm]?[jt]s$/iu.test(path))
+        return 'config';
+    if (/\.(?:css|scss|sass|less|svg|png|jpe?g|webp)$/iu.test(path))
+        return 'resource';
+    if (/(?:^|\/)modules?(?:\/|\.)/iu.test(path))
+        return 'module';
+    return 'source';
+}
+function isSupportOnlyPath(path) {
+    return artifactKind(path) === 'test' || artifactKind(path) === 'config'
+        || artifactKind(path) === 'resource';
+}
+function isInventoryFile(path) {
+    return ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.mts', '.cts'].includes(extname(path).toLocaleLowerCase('en-US'));
+}
+function normalizeProjectPath(value) {
+    return normalize(value).replaceAll('\\', '/').replace(/^\.\//u, '');
+}
+//# sourceMappingURL=artifact-inventory.js.map

package/dist/artifact-inventory.js.map

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

package/dist/context-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-engine.d.ts","sourceRoot":"","sources":["../src/context-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEb,WAAW,EACX,aAAa,EAOb,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAA0B,MAAM,iCAAiC,CAAC;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAwB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAQzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAU3D,OAAO,KAAK,EAKV,kBAAkB,EAClB,+BAA+B,EAChC,MAAM,YAAY,CAAC;AA0SpB,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,SAAS,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAoCD,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,CAAoB;IACrC,OAAO,CAAC,WAAW,CAAC,CAAoB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAE5B,IAAI,EAAE,iBAAiB;IAYnC,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,UAAU,CAAkD;IAE9D,gCAAgC,CAAC,KAAK,EAAE;QAC5C,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAClC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIX,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,OAAO,CAAC,yBAAyB;YAoCnB,yBAAyB;IAiCvC,OAAO,CAAC,eAAe;IAKjB,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAkRtD,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,+BAA+B,CAAC;YA8nB/F,sBAAsB;IAsWpC,OAAO,CAAC,yBAAyB;YAgBnB,2BAA2B;YA4B3B,6BAA6B;IAkB3C,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,2BAA2B;IAOnC,SAAS,IAAI,WAAW;CASzB"}
+{"version":3,"file":"context-engine.d.ts","sourceRoot":"","sources":["../src/context-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEb,WAAW,EACX,aAAa,EAOb,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAA0B,MAAM,iCAAiC,CAAC;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAwB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAQzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAU3D,OAAO,KAAK,EAKV,kBAAkB,EAClB,+BAA+B,EAChC,MAAM,YAAY,CAAC;AA2SpB,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,SAAS,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAoCD,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,CAAoB;IACrC,OAAO,CAAC,WAAW,CAAC,CAAoB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAE5B,IAAI,EAAE,iBAAiB;IAYnC,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,UAAU,CAAkD;IAE9D,gCAAgC,CAAC,KAAK,EAAE;QAC5C,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAClC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIX,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,OAAO,CAAC,yBAAyB;YAqCnB,yBAAyB;IAiCvC,OAAO,CAAC,eAAe;IAKjB,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAkRtD,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,+BAA+B,CAAC;YAutB/F,sBAAsB;IAsWpC,OAAO,CAAC,yBAAyB;YAgBnB,2BAA2B;YA4B3B,6BAA6B;IAkB3C,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,2BAA2B;IAOnC,SAAS,IAAI,WAAW;CASzB"}

package/dist/context-engine.js

@@ -9,6 +9,7 @@ import { rankOptionalContextFiles, } from "./ranker.js";
 import { describeLayerEvidence, detectLanguageFromPath, } from "./layer-rules.js";
 import { reachableCodeGraphNodeIds, sanitizeCodeGraphEdges, } from './graph-edge-quality.js';
 import { assembleContextFileRoles } from './context-file-roles.js';
+import { buildArtifactInventory } from './artifact-inventory.js';
 import { buildTaskContextEnvelope } from './task-retrieval-orchestrator.js';
 import { recordTaskEnvelopeLedger } from './retrieval-ledger.js';
 import { selectGraphEvidence } from './graph-evidence-selector.js';
@@ -315,6 +316,7 @@ export class ContextEngine {
         const languages = Object.keys(stats.filesByLanguage ?? {});
         return {
             limit,
+            retrievalIntent: 'automatic_context',
             budgetTokens: Math.max(0, Math.floor(totalBudget * 0.25)),
             activeSkill: options.activeSkill,
             relevantFiles: options.relevantFiles,
@@ -633,11 +635,11 @@ export class ContextEngine {
         const taskType = intent.intent;
         const combinedQuery = options?.queryPlan?.code[0]?.query
             ?? mergeQueries(query, expandQuery(query), options?.expandedTerms);
-        const targetAnchors = options?.intentArtifact?.targetAnchors ?? extractTargetAnchors(query);
-        const retrievalTaskPlan = buildRetrievalTaskPlan({
+        const explicitTargetAnchors = options?.intentArtifact?.targetAnchors ?? extractTargetAnchors(query);
+        const initialTaskPlan = buildRetrievalTaskPlan({
             query,
             parsedIntent: intent,
-            targetAnchors,
+            targetAnchors: explicitTargetAnchors,
             activeSkill: options?.activeSkill,
             command: options?.command,
             authoritativeArtifact: options?.intentArtifact,
@@ -652,6 +654,49 @@ export class ContextEngine {
             intentArtifactHash: options?.intentArtifact?.artifactHash,
             queryPlanHash: options?.queryPlan?.planHash,
         };
+        let artifactInventory = this.indexer
+            ? buildArtifactInventory({
+                codegraph: this.cg,
+                indexer: this.indexer,
+                query: combinedQuery,
+                explicitTargetAnchors,
+                action: initialTaskPlan.action,
+                identity: logIdentity,
+            })
+            : { entries: [], operationTargets: [], missingExplicitTargets: [], ambiguous: false };
+        const staleInventoryTargets = artifactInventory.operationTargets
+            .filter(entry => entry.freshness.exists && !entry.freshness.current)
+            .map(entry => entry.path);
+        if (this.indexer && staleInventoryTargets.length > 0) {
+            await this.indexer.ensureFilesCurrent(staleInventoryTargets, { refresh: true, timeoutMs: 5_000 });
+            artifactInventory = buildArtifactInventory({
+                codegraph: this.cg,
+                indexer: this.indexer,
+                query: combinedQuery,
+                explicitTargetAnchors,
+                action: initialTaskPlan.action,
+                identity: logIdentity,
+            });
+        }
+        const targetAnchors = [...new Set([
+                ...explicitTargetAnchors,
+                ...artifactInventory.operationTargets
+                    .filter(entry => entry.freshness.current)
+                    .map(entry => entry.path),
+            ])];
+        const retrievalTaskPlan = buildRetrievalTaskPlan({
+            query,
+            parsedIntent: intent,
+            targetAnchors,
+            activeSkill: options?.activeSkill,
+            command: options?.command,
+            authoritativeArtifact: options?.intentArtifact,
+        });
+        if (artifactInventory.missingExplicitTargets.length > 0) {
+            warnings.push(`explicit-target-missing:${artifactInventory.missingExplicitTargets.length}`);
+        }
+        if (artifactInventory.ambiguous)
+            warnings.push('artifact-target-ambiguous');
         const timing = {};
         const t0 = Date.now();
         const [cgResult, knowledgeResult, memoryHits] = await Promise.all([
@@ -735,6 +780,20 @@ export class ContextEngine {
         }
         ctx.nodes = Array.isArray(ctx.nodes) ? ctx.nodes : [];
         ctx.entryPoints = Array.isArray(ctx.entryPoints) ? ctx.entryPoints : [];
+        const inventoryNodeIds = new Set(ctx.nodes.map((node) => String(node.id ?? '')));
+        for (const target of artifactInventory.operationTargets.filter(entry => entry.freshness.current)) {
+            const nodes = this.cg.getNodesInFile(target.path)
+                .filter(node => node.kind !== 'file' && node.kind !== 'import');
+            for (const node of nodes) {
+                if (!inventoryNodeIds.has(node.id)) {
+                    ctx.nodes.push(node);
+                    inventoryNodeIds.add(node.id);
+                }
+            }
+            const root = nodes.find(node => target.symbols.includes(node.name)) ?? nodes[0];
+            if (root && !ctx.entryPoints.some((entry) => entry.id === root.id))
+                ctx.entryPoints.unshift(root);
+        }
         await this.applyTaskSymbolVectorRecall(ctx, combinedQuery, warnings);
         this.clearRecoveredSymbolWarning(warnings);
         // Fallback: direct searchNodes for query terms that buildContext may have missed
@@ -797,6 +856,22 @@ export class ContextEngine {
         ctx.edges = edgeQuality.accepted;
         if (edgeQuality.rejected.length > 0) {
             warnings.push(`codegraph-relations-rejected:${edgeQuality.rejected.length}`);
+            emitSemanticControlLog({
+                event: 'codegraph.edge.rejected',
+                identity: logIdentity,
+                level: 'warn',
+                timestamp: Date.now(),
+                data: {
+                    rejectedCount: edgeQuality.rejected.length,
+                    reasons: countValues(edgeQuality.rejected.map(edge => edge.reason)),
+                    examples: edgeQuality.rejected.slice(0, 8).map(edge => ({
+                        kind: edge.kind,
+                        sourceFile: edge.sourceFile,
+                        targetFile: edge.targetFile,
+                        reason: edge.reason,
+                    })),
+                },
+            });
         }
         const tSnippet = Date.now();
         let allNodes = ctx.nodes ?? [];
@@ -845,6 +920,10 @@ export class ContextEngine {
         const optionalCandidates = new Map();
         const graphOptionalPaths = new Set();
         const queryTerms = combinedQuery.split(/\s+/).map(term => term.toLowerCase()).filter(term => term.length >= 3);
+        for (const target of artifactInventory.operationTargets) {
+            if (target.freshness.current)
+                requiredFileSet.add(target.path);
+        }
         for (const node of allNodes) {
             // Skip file wrappers and import edges — they're not actionable symbols
             if (node.kind === "file" || node.kind === "import")
@@ -899,6 +978,16 @@ export class ContextEngine {
             }
         }
         const fileRoleByPath = new Map();
+        for (const artifact of artifactInventory.entries.filter(entry => entry.freshness.current)) {
+            fileRoleByPath.set(artifact.path, {
+                path: artifact.path,
+                role: artifact.artifactRole === 'operation_target' ? 'target' : 'dependency',
+                artifactRole: artifact.artifactRole,
+                score: artifact.score,
+                evidence: artifact.evidence,
+            });
+            fileFreshnessByPath.set(artifact.path, artifact.freshness);
+        }
         const roleCandidates = this.indexer
             ? assembleContextFileRoles({
                 codegraph: this.cg,
@@ -911,7 +1000,10 @@ export class ContextEngine {
             if (this.indexer?.getFileFreshness) {
                 fileFreshnessByPath.set(candidate.path, this.indexer.getFileFreshness(candidate.path));
             }
-            fileRoleByPath.set(candidate.path, candidate);
+            const inventoryRole = fileRoleByPath.get(candidate.path);
+            fileRoleByPath.set(candidate.path, inventoryRole && inventoryRole.score >= candidate.score
+                ? inventoryRole
+                : candidate);
             if (candidate.role === 'target') {
                 requiredFileSet.add(candidate.path);
                 continue;
@@ -1639,4 +1731,10 @@ function getGroupFilePaths(group) {
         return group;
     return group?.files ?? [];
 }
+function countValues(values) {
+    const counts = {};
+    for (const value of values)
+        counts[value] = (counts[value] ?? 0) + 1;
+    return counts;
+}
 //# sourceMappingURL=context-engine.js.map