@contorium/mcp 0.8.1

package/node_modules/@contora/state-core/dist/understanding/impactAnalyzer.d.ts

@@ -0,0 +1,5 @@
+import type { ProjectGraph } from './types.js';
+import type { ChangeArtifact } from './types.js';
+import type { ImpactAnalysis } from './types.js';
+export declare function analyzeImpact(graph: ProjectGraph, change: ChangeArtifact): ImpactAnalysis;
+//# sourceMappingURL=impactAnalyzer.d.ts.map

package/node_modules/@contora/state-core/dist/understanding/impactAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impactAnalyzer.d.ts","sourceRoot":"","sources":["../../src/understanding/impactAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyBjD,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,GAAG,cAAc,CA2CzF"}

package/node_modules/@contora/state-core/dist/understanding/impactAnalyzer.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeImpact = analyzeImpact;
+const SENSITIVE_HINTS = /auth|password|token|secret|payment|security|credential|login|session/i;
+function moduleOfSymbol(ref) {
+    const idx = ref.indexOf('::');
+    return idx >= 0 ? ref.slice(0, idx) : ref;
+}
+function fnNameOfSymbol(ref) {
+    const parts = ref.split('::');
+    return parts.length >= 2 ? parts[parts.length - 1] : ref;
+}
+function inferRisk(affectedCount, names) {
+    const sensitive = names.some((n) => SENSITIVE_HINTS.test(n));
+    if (sensitive || affectedCount >= 4) {
+        return 'high';
+    }
+    if (affectedCount >= 2) {
+        return 'medium';
+    }
+    return 'low';
+}
+function analyzeImpact(graph, change) {
+    const changedFnNames = new Set(change.key_changes.filter((k) => k.kind === 'function').map((k) => fnNameOfSymbol(k.symbol)));
+    const changedFnIds = new Set(graph.nodes
+        .filter((n) => n.kind === 'function' && changedFnNames.has(n.name))
+        .map((n) => n.id));
+    const callers = new Set();
+    for (const edge of graph.edges) {
+        if (edge.kind !== 'calls' || !changedFnIds.has(edge.to)) {
+            continue;
+        }
+        const node = graph.nodes.find((n) => n.id === edge.from);
+        if (node?.kind === 'function') {
+            callers.add(`${node.file}::${node.name}`);
+        }
+    }
+    const fnChanges = change.key_changes.filter((k) => k.kind === 'function').map((k) => k.symbol);
+    const affected_modules = [
+        ...new Set([
+            ...change.changed_files.map((f) => f.replace(/\\/g, '/')),
+            ...[...callers].map(moduleOfSymbol),
+        ]),
+    ];
+    const affected_functions = [...callers];
+    const risk = inferRisk(affected_functions.length, [...fnChanges, ...affected_functions]);
+    const details = [];
+    if (fnChanges.length) {
+        details.push(`Changed functions: ${fnChanges.slice(0, 8).join(', ')}`);
+    }
+    if (affected_functions.length) {
+        details.push(`Direct callers: ${affected_functions.slice(0, 8).join(', ')}`);
+    }
+    else if (fnChanges.length) {
+        details.push('No direct callers detected in change neighborhood (MVP static scan).');
+    }
+    return { affected_functions, affected_modules, risk, details };
+}

package/node_modules/@contora/state-core/dist/understanding/intentFusion.d.ts

@@ -0,0 +1,9 @@
+import type { BootstrapStateJson } from '../types.js';
+import type { ChangeArtifact, IntentFusion } from './types.js';
+import type { ProjectBuiltState } from '../state-builder/types.js';
+export declare function fuseIntent(args: {
+    state: BootstrapStateJson;
+    change: ChangeArtifact;
+    built?: ProjectBuiltState | null;
+}): IntentFusion;
+//# sourceMappingURL=intentFusion.d.ts.map

package/node_modules/@contora/state-core/dist/understanding/intentFusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intentFusion.d.ts","sourceRoot":"","sources":["../../src/understanding/intentFusion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAuBnE,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAClC,GAAG,YAAY,CAiCf"}

package/node_modules/@contora/state-core/dist/understanding/intentFusion.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fuseIntent = fuseIntent;
+const DOMAIN_HINTS = [
+    { re: /packages\/mcp|\/mcp\//i, label: 'MCP server integration' },
+    { re: /packages\/cli|\/cli\//i, label: 'CLI tooling' },
+    { re: /packages\/state-core|state-builder|state-core/i, label: 'shared state engine' },
+    { re: /extension|sidebar|vscode/i, label: 'IDE extension UI' },
+    { re: /test|spec/i, label: 'testing' },
+    { re: /docs?\//i, label: 'documentation' },
+];
+function inferDomainSignals(changedFiles) {
+    const signals = [];
+    for (const file of changedFiles) {
+        for (const hint of DOMAIN_HINTS) {
+            if (hint.re.test(file) && !signals.includes(hint.label)) {
+                signals.push(hint.label);
+            }
+        }
+    }
+    return signals;
+}
+function fuseIntent(args) {
+    const signals = inferDomainSignals(args.change.changed_files);
+    const goal = args.built?.project_goal?.trim() || args.state.currentTask.trim();
+    const stage = args.built?.current_stage?.trim();
+    let focus = goal || 'Continue current workspace task';
+    if (signals.length) {
+        focus = `${focus} — focus: ${signals.slice(0, 3).join(', ')}`;
+    }
+    else if (args.change.changed_files.length) {
+        const top = args.change.changed_files[0].split('/').pop() ?? args.change.changed_files[0];
+        focus = `${focus} — editing ${top}`;
+    }
+    if (stage) {
+        signals.push(`stage: ${stage}`);
+    }
+    let confidence = 0.45;
+    if (goal) {
+        confidence += 0.2;
+    }
+    if (signals.length) {
+        confidence += Math.min(0.25, signals.length * 0.08);
+    }
+    if (args.change.key_changes.length) {
+        confidence += 0.1;
+    }
+    confidence = Math.min(0.92, confidence);
+    return {
+        focus,
+        confidence: Math.round(confidence * 100) / 100,
+        signals,
+    };
+}

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/closureConstants.d.ts

@@ -0,0 +1,24 @@
+/** V3.1 Final Engineering Closure — frozen thresholds (do not drift). */
+export declare const CLOSURE_VERSION = "1";
+/** Canonical graph: mappings/edges below this stay in inferenceMappings only. */
+export declare const GRAPH_CANONICAL_MIN_CONFIDENCE = 0.7;
+/** Unified confidence formula weights (semantic + temporal + git). */
+export declare const CONFIDENCE_WEIGHT_SEMANTIC = 0.5;
+export declare const CONFIDENCE_WEIGHT_TEMPORAL = 0.3;
+export declare const CONFIDENCE_WEIGHT_GIT = 0.2;
+/** Snapshot Top-N (compression projection from knowledge.json). */
+export declare const SNAPSHOT_TOP_INTENTS = 5;
+export declare const SNAPSHOT_TOP_HOTSPOTS = 10;
+export declare const SNAPSHOT_TOP_FUNCTIONS = 10;
+export declare const SNAPSHOT_TOP_NEXT_ACTIONS = 6;
+/** Hotspot lifecycle score bands. */
+export declare const HOTSPOT_SCORE_ACTIVE = 0.5;
+export declare const HOTSPOT_SCORE_COOLING = 0.3;
+/** Knowledge graph rebuild triggers. */
+export declare const REBUILD_IDLE_MS = 60000;
+export declare const REBUILD_FILE_THRESHOLD = 5;
+/** Minimum raw mapping score before inference consideration. */
+export declare const MAPPING_DISCOVERY_MIN_SCORE = 0.12;
+/** Allowed L1/L2 sources for graph intents — L3 paths must never feed the builder. */
+export declare const GRAPH_INTENT_SOURCE_ALLOWLIST: readonly ["state.currentTask", "built.project_goal", "built.active_modules", "built.next_actions", "change.changed_files", "intentFusion.focus"];
+//# sourceMappingURL=closureConstants.d.ts.map

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/closureConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closureConstants.d.ts","sourceRoot":"","sources":["../../../src/understanding/knowledgeGraph/closureConstants.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,iFAAiF;AACjF,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,sEAAsE;AACtE,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,qCAAqC;AACrC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,wCAAwC;AACxC,eAAO,MAAM,eAAe,QAAS,CAAC;AACtC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,gEAAgE;AAChE,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD,sFAAsF;AACtF,eAAO,MAAM,6BAA6B,kJAOhC,CAAC"}

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/closureConstants.js

@@ -0,0 +1,33 @@
+"use strict";
+/** V3.1 Final Engineering Closure — frozen thresholds (do not drift). */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GRAPH_INTENT_SOURCE_ALLOWLIST = exports.MAPPING_DISCOVERY_MIN_SCORE = exports.REBUILD_FILE_THRESHOLD = exports.REBUILD_IDLE_MS = exports.HOTSPOT_SCORE_COOLING = exports.HOTSPOT_SCORE_ACTIVE = exports.SNAPSHOT_TOP_NEXT_ACTIONS = exports.SNAPSHOT_TOP_FUNCTIONS = exports.SNAPSHOT_TOP_HOTSPOTS = exports.SNAPSHOT_TOP_INTENTS = exports.CONFIDENCE_WEIGHT_GIT = exports.CONFIDENCE_WEIGHT_TEMPORAL = exports.CONFIDENCE_WEIGHT_SEMANTIC = exports.GRAPH_CANONICAL_MIN_CONFIDENCE = exports.CLOSURE_VERSION = void 0;
+exports.CLOSURE_VERSION = '1';
+/** Canonical graph: mappings/edges below this stay in inferenceMappings only. */
+exports.GRAPH_CANONICAL_MIN_CONFIDENCE = 0.7;
+/** Unified confidence formula weights (semantic + temporal + git). */
+exports.CONFIDENCE_WEIGHT_SEMANTIC = 0.5;
+exports.CONFIDENCE_WEIGHT_TEMPORAL = 0.3;
+exports.CONFIDENCE_WEIGHT_GIT = 0.2;
+/** Snapshot Top-N (compression projection from knowledge.json). */
+exports.SNAPSHOT_TOP_INTENTS = 5;
+exports.SNAPSHOT_TOP_HOTSPOTS = 10;
+exports.SNAPSHOT_TOP_FUNCTIONS = 10;
+exports.SNAPSHOT_TOP_NEXT_ACTIONS = 6;
+/** Hotspot lifecycle score bands. */
+exports.HOTSPOT_SCORE_ACTIVE = 0.5;
+exports.HOTSPOT_SCORE_COOLING = 0.3;
+/** Knowledge graph rebuild triggers. */
+exports.REBUILD_IDLE_MS = 60_000;
+exports.REBUILD_FILE_THRESHOLD = 5;
+/** Minimum raw mapping score before inference consideration. */
+exports.MAPPING_DISCOVERY_MIN_SCORE = 0.12;
+/** Allowed L1/L2 sources for graph intents — L3 paths must never feed the builder. */
+exports.GRAPH_INTENT_SOURCE_ALLOWLIST = [
+    'state.currentTask',
+    'built.project_goal',
+    'built.active_modules',
+    'built.next_actions',
+    'change.changed_files',
+    'intentFusion.focus',
+];

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/confidence.d.ts

@@ -0,0 +1,20 @@
+import type { IntentFunctionMapping, KnowledgeEdge } from './types.js';
+export declare function clampConfidence(value: number): number;
+/**
+ * Unified confidence (V3.1 Closure):
+ * clamp(0.5 * semantic + 0.3 * temporal + 0.2 * git, 0, 1)
+ */
+export declare function computeUnifiedConfidence(args: {
+    semanticSimilarity: number;
+    temporalRecency: number;
+    gitActivity: number;
+}): number;
+export declare function isCanonicalConfidence(confidence: number): boolean;
+export declare function splitMappingsByCanonicalThreshold(mappings: IntentFunctionMapping[]): {
+    canonical: IntentFunctionMapping[];
+    inference: IntentFunctionMapping[];
+};
+/** Drop supports_intent edges whose confidence is below canonical threshold. */
+export declare function filterCanonicalEdges(edges: KnowledgeEdge[]): KnowledgeEdge[];
+export declare function confidenceBandLabel(confidence: number): string;
+//# sourceMappingURL=confidence.d.ts.map

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../../src/understanding/knowledgeGraph/confidence.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAMT;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,qBAAqB,EAAE,GAChC;IAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC;IAAC,SAAS,EAAE,qBAAqB,EAAE,CAAA;CAAE,CAW5E;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAI5E;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAW9D"}

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/confidence.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clampConfidence = clampConfidence;
+exports.computeUnifiedConfidence = computeUnifiedConfidence;
+exports.isCanonicalConfidence = isCanonicalConfidence;
+exports.splitMappingsByCanonicalThreshold = splitMappingsByCanonicalThreshold;
+exports.filterCanonicalEdges = filterCanonicalEdges;
+exports.confidenceBandLabel = confidenceBandLabel;
+const closureConstants_js_1 = require("./closureConstants.js");
+function clampConfidence(value) {
+    return Math.round(Math.max(0, Math.min(1, value)) * 1000) / 1000;
+}
+/**
+ * Unified confidence (V3.1 Closure):
+ * clamp(0.5 * semantic + 0.3 * temporal + 0.2 * git, 0, 1)
+ */
+function computeUnifiedConfidence(args) {
+    return clampConfidence(closureConstants_js_1.CONFIDENCE_WEIGHT_SEMANTIC * args.semanticSimilarity +
+        closureConstants_js_1.CONFIDENCE_WEIGHT_TEMPORAL * args.temporalRecency +
+        closureConstants_js_1.CONFIDENCE_WEIGHT_GIT * args.gitActivity);
+}
+function isCanonicalConfidence(confidence) {
+    return confidence >= closureConstants_js_1.GRAPH_CANONICAL_MIN_CONFIDENCE;
+}
+function splitMappingsByCanonicalThreshold(mappings) {
+    const canonical = [];
+    const inference = [];
+    for (const m of mappings) {
+        if (isCanonicalConfidence(m.confidence)) {
+            canonical.push(m);
+        }
+        else {
+            inference.push(m);
+        }
+    }
+    return { canonical, inference };
+}
+/** Drop supports_intent edges whose confidence is below canonical threshold. */
+function filterCanonicalEdges(edges) {
+    return edges.filter((e) => e.type !== 'supports_intent' || isCanonicalConfidence(e.confidence));
+}
+function confidenceBandLabel(confidence) {
+    if (confidence >= 0.9) {
+        return 'strong';
+    }
+    if (confidence >= 0.7) {
+        return 'high';
+    }
+    if (confidence >= 0.5) {
+        return 'weak';
+    }
+    return 'excluded';
+}

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/gitFrequency.d.ts

@@ -0,0 +1,5 @@
+import type { BootstrapStateJson } from '../../types.js';
+import type { ProjectTimeline } from '../types.js';
+/** Git activity weights for Hotspot Layer — from timeline + state.json git paths. */
+export declare function buildGitFrequency(timeline: ProjectTimeline | undefined, state: BootstrapStateJson): Map<string, number>;
+//# sourceMappingURL=gitFrequency.d.ts.map

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/gitFrequency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitFrequency.d.ts","sourceRoot":"","sources":["../../../src/understanding/knowledgeGraph/gitFrequency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAMnD,qFAAqF;AACrF,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,eAAe,GAAG,SAAS,EACrC,KAAK,EAAE,kBAAkB,GACxB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWrB"}

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/gitFrequency.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildGitFrequency = buildGitFrequency;
+function norm(p) {
+    return p.replace(/\\/g, '/');
+}
+/** Git activity weights for Hotspot Layer — from timeline + state.json git paths. */
+function buildGitFrequency(timeline, state) {
+    const freq = new Map();
+    for (const e of timeline?.recent ?? []) {
+        const f = norm(e.file);
+        freq.set(f, (freq.get(f) ?? 0) + 1);
+    }
+    for (const p of [...state.gitStaged, ...state.gitWorking]) {
+        const f = norm(p);
+        freq.set(f, (freq.get(f) ?? 0) + 2);
+    }
+    return freq;
+}

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/hotspotBuilder.d.ts

@@ -0,0 +1,13 @@
+import type { HotspotNode, IntentFunctionMapping, KnowledgeEdge, KnowledgeNode } from './types.js';
+export interface HotspotBuildInput {
+    nodes: KnowledgeNode[];
+    edges: KnowledgeEdge[];
+    intentMappings: IntentFunctionMapping[];
+    editCounts: Map<string, number>;
+    gitFrequency: Map<string, number>;
+    now: number;
+    max?: number;
+}
+/** Hotspot Layer — activity scoring; AND gate + lifecycle (Closure §8). */
+export declare function buildHotspots(input: HotspotBuildInput): HotspotNode[];
+//# sourceMappingURL=hotspotBuilder.d.ts.map

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/hotspotBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspotBuilder.d.ts","sourceRoot":"","sources":["../../../src/understanding/knowledgeGraph/hotspotBuilder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,WAAW,EACX,qBAAqB,EACrB,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC;AA6BpB,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,EAAE,CAqGrE"}

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/hotspotBuilder.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHotspots = buildHotspots;
+const closureConstants_js_1 = require("./closureConstants.js");
+function basename(p) {
+    return p.replace(/\\/g, '/').split('/').filter(Boolean).pop() ?? p;
+}
+function hotspotLifecycle(score) {
+    if (score >= closureConstants_js_1.HOTSPOT_SCORE_ACTIVE) {
+        return 'active';
+    }
+    if (score >= closureConstants_js_1.HOTSPOT_SCORE_COOLING) {
+        return 'cooling';
+    }
+    return 'stale';
+}
+/** Closure §8.2 — edit AND git AND intent (git waived when no git data). */
+function hotspotQualifies(args) {
+    const hasEdit = args.editCount > 0;
+    const hasGit = !args.gitDataAvailable || args.gitCount > 0;
+    const hasIntent = args.intentLinks > 0;
+    return hasEdit && hasGit && hasIntent;
+}
+/** Hotspot Layer — activity scoring; AND gate + lifecycle (Closure §8). */
+function buildHotspots(input) {
+    const gitDataAvailable = input.gitFrequency.size > 0;
+    const maxGit = Math.max(1, ...input.gitFrequency.values(), 1);
+    const maxEdits = Math.max(1, ...input.editCounts.values(), 1);
+    const fnNodes = input.nodes.filter((n) => n.type === 'function');
+    const fileNodes = input.nodes.filter((n) => n.type === 'file');
+    const intentLinksByFn = new Map();
+    for (const m of input.intentMappings) {
+        intentLinksByFn.set(m.functionId, (intentLinksByFn.get(m.functionId) ?? 0) + 1);
+    }
+    const depCount = (id) => input.edges.filter((e) => e.target === id && e.type === 'calls').length +
+        input.edges.filter((e) => e.source === id && e.type === 'calls').length;
+    const hotspots = [];
+    const consider = (args) => {
+        const editCount = input.editCounts.get(args.path) ?? 0;
+        const gitCount = input.gitFrequency.get(args.path) ?? 0;
+        if (!hotspotQualifies({
+            editCount,
+            gitCount,
+            intentLinks: args.intentLinks,
+            gitDataAvailable,
+        })) {
+            return;
+        }
+        const editFrequency = editCount / maxEdits;
+        const gitActivity = gitCount / maxGit;
+        const intentWeight = Math.min(1, args.intentLinks / 2);
+        const dependencyCount = args.fn ? depCount(args.fn.id) : 0;
+        const depNorm = Math.min(1, dependencyCount / 8);
+        const score = Math.round((editFrequency * 0.4 + gitActivity * 0.2 + intentWeight * 0.3 + depNorm * 0.1) * 1000) / 1000;
+        if (score < closureConstants_js_1.HOTSPOT_SCORE_COOLING) {
+            return;
+        }
+        hotspots.push({
+            id: `hotspot_${args.targetKind}_${args.targetId}`,
+            type: 'hotspot',
+            targetId: args.targetId,
+            targetName: args.targetName,
+            targetKind: args.targetKind,
+            score,
+            lifecycle: hotspotLifecycle(score),
+            editFrequency: editCount,
+            gitActivity: gitCount,
+            intentLinks: args.intentLinks,
+            dependencyCount,
+        });
+    };
+    for (const file of fileNodes) {
+        const path = file.path ?? file.name;
+        const linkedFns = fnNodes.filter((f) => f.path === path);
+        const intentLinks = linkedFns.reduce((n, f) => n + (intentLinksByFn.get(f.id) ?? 0), 0);
+        consider({
+            file,
+            fn: undefined,
+            path,
+            targetId: file.id,
+            targetName: basename(path),
+            targetKind: 'file',
+            intentLinks,
+        });
+    }
+    for (const fn of fnNodes.slice(0, 60)) {
+        const path = fn.path ?? '';
+        consider({
+            file: undefined,
+            fn,
+            path,
+            targetId: fn.id,
+            targetName: fn.name,
+            targetKind: 'function',
+            intentLinks: intentLinksByFn.get(fn.id) ?? 0,
+        });
+    }
+    return hotspots
+        .sort((a, b) => b.score - a.score)
+        .slice(0, input.max ?? closureConstants_js_1.SNAPSHOT_TOP_HOTSPOTS);
+}

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/intentFunctionMapper.d.ts

@@ -0,0 +1,22 @@
+import type { IntentFunctionMapping } from './types.js';
+declare function tokenize(text: string): string[];
+declare function cosineSimilarity(a: string[], b: string[]): number;
+export interface FunctionDescriptor {
+    id: string;
+    name: string;
+    file: string;
+    moduleHint?: string;
+    callTargets?: string[];
+}
+export interface IntentDescriptor {
+    id: string;
+    text: string;
+}
+export interface MappingContext {
+    recentEditFiles?: Set<string>;
+    gitFrequency?: Map<string, number>;
+}
+/** Intent ↔ Function mapping — token similarity + recency + git frequency (V3.1). */
+export declare function mapIntentsToFunctions(intents: IntentDescriptor[], functions: FunctionDescriptor[], ctx?: MappingContext): IntentFunctionMapping[];
+export { tokenize, cosineSimilarity };
+//# sourceMappingURL=intentFunctionMapper.d.ts.map

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/intentFunctionMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intentFunctionMapper.d.ts","sourceRoot":"","sources":["../../../src/understanding/knowledgeGraph/intentFunctionMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AASxD,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMxC;AAED,iBAAS,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CA6B1D;AAWD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,SAAS,EAAE,kBAAkB,EAAE,EAC/B,GAAG,GAAE,cAAmB,GACvB,qBAAqB,EAAE,CAmDzB;AAED,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC"}

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/intentFunctionMapper.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapIntentsToFunctions = mapIntentsToFunctions;
+exports.tokenize = tokenize;
+exports.cosineSimilarity = cosineSimilarity;
+const closureConstants_js_1 = require("./closureConstants.js");
+const confidence_js_1 = require("./confidence.js");
+const STOP = new Set([
+    'a', 'an', 'the', 'and', 'or', 'to', 'in', 'on', 'for', 'of', 'with', 'from',
+    'continue', 'current', 'workspace', 'task', 'focus', 'editing', 'stage',
+]);
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9_\u4e00-\u9fff]+/gi, ' ')
+        .split(/\s+/)
+        .filter((t) => t.length > 1 && !STOP.has(t));
+}
+function cosineSimilarity(a, b) {
+    if (!a.length || !b.length) {
+        return 0;
+    }
+    const freqA = new Map();
+    const freqB = new Map();
+    for (const t of a) {
+        freqA.set(t, (freqA.get(t) ?? 0) + 1);
+    }
+    for (const t of b) {
+        freqB.set(t, (freqB.get(t) ?? 0) + 1);
+    }
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (const [, v] of freqA) {
+        normA += v * v;
+    }
+    for (const [, v] of freqB) {
+        normB += v * v;
+    }
+    for (const [k, v] of freqA) {
+        const w = freqB.get(k) ?? 0;
+        dot += v * w;
+    }
+    if (!normA || !normB) {
+        return 0;
+    }
+    return dot / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+function camelTokens(name) {
+    return name
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/_/g, ' ')
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((t) => t.length > 1);
+}
+/** Intent ↔ Function mapping — token similarity + recency + git frequency (V3.1). */
+function mapIntentsToFunctions(intents, functions, ctx = {}) {
+    const recent = ctx.recentEditFiles ?? new Set();
+    const gitFreq = ctx.gitFrequency ?? new Map();
+    const maxGit = Math.max(1, ...gitFreq.values(), 1);
+    const out = [];
+    for (const intent of intents) {
+        const intentTokens = tokenize(intent.text);
+        for (const fn of functions) {
+            const fnTokens = [
+                ...tokenize(fn.name),
+                ...camelTokens(fn.name),
+                ...tokenize(fn.file.split('/').pop() ?? fn.file),
+                ...(fn.moduleHint ? tokenize(fn.moduleHint) : []),
+                ...(fn.callTargets ?? []).flatMap((c) => [...tokenize(c), ...camelTokens(c)]),
+            ];
+            const similarity = cosineSimilarity(intentTokens, fnTokens);
+            const fileNorm = fn.file.replace(/\\/g, '/');
+            const recentEdit = recent.has(fileNorm) ? 1 : 0;
+            const gitScore = (gitFreq.get(fileNorm) ?? 0) / maxGit;
+            const confidence = (0, confidence_js_1.computeUnifiedConfidence)({
+                semanticSimilarity: similarity,
+                temporalRecency: recentEdit,
+                gitActivity: gitScore,
+            });
+            const score = confidence;
+            if (score < closureConstants_js_1.MAPPING_DISCOVERY_MIN_SCORE) {
+                continue;
+            }
+            const signals = [];
+            if (similarity >= 0.2) {
+                signals.push(`token match ${Math.round(similarity * 100)}%`);
+            }
+            if (recentEdit) {
+                signals.push('recent edit');
+            }
+            if (gitScore > 0.1) {
+                signals.push('git activity');
+            }
+            out.push({
+                intentId: intent.id,
+                functionId: fn.id,
+                score,
+                confidence,
+                signals,
+            });
+        }
+    }
+    return out.sort((a, b) => b.score - a.score).slice(0, 48);
+}

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/knowledgeGraphBuilder.d.ts

@@ -0,0 +1,23 @@
+import type { ProjectBuiltState } from '../../state-builder/types.js';
+import type { ChangeArtifact, IntentFusion, ProjectGraph } from '../types.js';
+import type { ProjectKnowledgeGraph } from './types.js';
+export interface KnowledgeGraphBuildInput {
+    graph: ProjectGraph;
+    change: ChangeArtifact;
+    intent: IntentFusion;
+    built?: ProjectBuiltState | null;
+    goal: string;
+    workspaceRoot?: string;
+    sourceVersion?: string;
+    now?: number;
+    editCounts?: Map<string, number>;
+    gitFrequency?: Map<string, number>;
+    rebuildTrigger?: string;
+    lastCommitHash?: string;
+}
+/**
+ * Build Project Knowledge Graph from L1/L2 sources only.
+ * L3 (intelligence / intent-graph / AI speculation) must never feed this builder.
+ */
+export declare function buildProjectKnowledgeGraph(input: KnowledgeGraphBuildInput): ProjectKnowledgeGraph;
+//# sourceMappingURL=knowledgeGraphBuilder.d.ts.map

package/node_modules/@contora/state-core/dist/understanding/knowledgeGraph/knowledgeGraphBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeGraphBuilder.d.ts","sourceRoot":"","sources":["../../../src/understanding/knowledgeGraph/knowledgeGraphBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW9E,OAAO,KAAK,EAKV,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAwQpB,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,wBAAwB,GAAG,qBAAqB,CA4MjG"}