@nxuss/lemma 1.18.0 → 1.18.1

package/dist/cjs/mcp/utils.d.ts

@@ -1,3 +1,4 @@
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
 export declare function getProxyPort(): string;
 export declare function clearProxyPortCache(): void;
 export declare function safeResolvePath(workspaceRoot: string, filePath: string): {
@@ -8,6 +9,38 @@ export declare function sanitizeArgsForLogging(args: Record<string, any>): Recor
 export declare function estimateTokensFromResult(result: any): number;
 export declare function logError(context: string, error: unknown): void;
 export declare function logWarn(context: string, message: string): void;
+export declare function setMcpServerRef(server: Server): void;
+/**
+ * The default similarity floor a memory must clear before search_memory/smarter_cache
+ * treat it as a real hit rather than noise. Shared so both paths agree on what counts.
+ */
+export declare const DEFAULT_MEMORY_SIMILARITY_FLOOR = 0.75;
+/**
+ * Ask the client to confirm a destructive action before it happens.
+ *
+ * Mirrors the defensive shape of trySamplingContext() in src/mcp/index.ts: most clients
+ * today don't support elicitation, so any failure (unsupported capability, timeout,
+ * malformed response) must fall back to "proceed without confirmation" rather than block
+ * or error out the tool. This is a courtesy prompt for clients that support it, not a
+ * security boundary — the allowlist/path-safety checks each handler already does are that.
+ */
+export declare function tryElicitConfirmation(summary: string): Promise<{
+    supported: boolean;
+    confirmed: boolean;
+}>;
+/**
+ * Ask the client to pick one of several candidates via a typed (oneOf) elicitation form,
+ * instead of the plain confirm/deny shape tryElicitConfirmation uses. Same defensive
+ * contract: no support, a decline, or a malformed response all just mean "couldn't
+ * resolve it this way" — the caller falls back to its own error/default behavior, never
+ * blocks or throws.
+ */
+export declare function tryElicitChoice(message: string, options: Array<{
+    title: string;
+}>): Promise<{
+    supported: boolean;
+    index: number | null;
+}>;
 /**
  * Loads allowed command prefixes by merging the hardcoded defaults with
  * any user-defined extensions in lemma.config.json under `mcp.allowedCommandPrefixes`.

package/dist/cjs/mcp/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/mcp/utils.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,IAAI,MAAM,CAYrC;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAmCnH;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAcrF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAK5D;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAG9D;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9D;AAuCD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAgB9C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAUvF"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/mcp/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAIxE,wBAAgB,YAAY,IAAI,MAAM,CAYrC;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAmCnH;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAcrF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAK5D;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAG9D;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9D;AASD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;GAGG;AACH,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CA2BhH;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CA6B/I;AAuCD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAgB9C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAUvF"}

package/dist/cjs/mcp/utils.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MEMORY_SIMILARITY_FLOOR = void 0;
 exports.getProxyPort = getProxyPort;
 exports.clearProxyPortCache = clearProxyPortCache;
 exports.safeResolvePath = safeResolvePath;
@@ -10,6 +11,9 @@ exports.sanitizeArgsForLogging = sanitizeArgsForLogging;
 exports.estimateTokensFromResult = estimateTokensFromResult;
 exports.logError = logError;
 exports.logWarn = logWarn;
+exports.setMcpServerRef = setMcpServerRef;
+exports.tryElicitConfirmation = tryElicitConfirmation;
+exports.tryElicitChoice = tryElicitChoice;
 exports.loadAllowedCommands = loadAllowedCommands;
 exports.isCommandAllowed = isCommandAllowed;
 const fs_1 = __importDefault(require("fs"));
@@ -103,6 +107,98 @@ function logError(context, error) {
 function logWarn(context, message) {
     console.warn(`[Lemma MCP:${context}] ${message}`);
 }
+// ── Elicitation (spec 2026-07-28's recommended pattern for destructive actions) ────
+//
+// Set once by setupToolsHandlers so the standalone handler functions in tools.ts — which
+// don't otherwise see the Server instance — can ask the connected client to confirm before
+// a mutating tool runs.
+let mcpServerRef = null;
+function setMcpServerRef(server) {
+    mcpServerRef = server;
+}
+/**
+ * The default similarity floor a memory must clear before search_memory/smarter_cache
+ * treat it as a real hit rather than noise. Shared so both paths agree on what counts.
+ */
+exports.DEFAULT_MEMORY_SIMILARITY_FLOOR = 0.75;
+/**
+ * Ask the client to confirm a destructive action before it happens.
+ *
+ * Mirrors the defensive shape of trySamplingContext() in src/mcp/index.ts: most clients
+ * today don't support elicitation, so any failure (unsupported capability, timeout,
+ * malformed response) must fall back to "proceed without confirmation" rather than block
+ * or error out the tool. This is a courtesy prompt for clients that support it, not a
+ * security boundary — the allowlist/path-safety checks each handler already does are that.
+ */
+async function tryElicitConfirmation(summary) {
+    if (!mcpServerRef)
+        return { supported: false, confirmed: true };
+    try {
+        const result = await mcpServerRef.elicitInput({
+            message: summary,
+            requestedSchema: {
+                type: "object",
+                properties: {
+                    confirm: {
+                        type: "boolean",
+                        title: "Proceed?",
+                        description: "Confirm this action should be applied.",
+                    },
+                },
+                required: ["confirm"],
+            },
+        });
+        if (result.action !== "accept") {
+            // "decline" or "cancel" — the user (or client policy) said no.
+            return { supported: true, confirmed: false };
+        }
+        const confirmed = result.content?.confirm !== false;
+        return { supported: true, confirmed };
+    }
+    catch (err) {
+        logWarn("elicitation", "Client does not support elicitation (or the request failed) — proceeding without confirmation");
+        return { supported: false, confirmed: true };
+    }
+}
+/**
+ * Ask the client to pick one of several candidates via a typed (oneOf) elicitation form,
+ * instead of the plain confirm/deny shape tryElicitConfirmation uses. Same defensive
+ * contract: no support, a decline, or a malformed response all just mean "couldn't
+ * resolve it this way" — the caller falls back to its own error/default behavior, never
+ * blocks or throws.
+ */
+async function tryElicitChoice(message, options) {
+    if (!mcpServerRef || options.length === 0)
+        return { supported: false, index: null };
+    try {
+        const result = await mcpServerRef.elicitInput({
+            message,
+            requestedSchema: {
+                type: "object",
+                properties: {
+                    choice: {
+                        type: "string",
+                        title: "Which one?",
+                        oneOf: options.map((opt, i) => ({ const: String(i), title: opt.title })),
+                    },
+                },
+                required: ["choice"],
+            },
+        });
+        if (result.action !== "accept" || !result.content) {
+            return { supported: true, index: null };
+        }
+        const idx = Number(result.content.choice);
+        if (!Number.isInteger(idx) || idx < 0 || idx >= options.length) {
+            return { supported: true, index: null };
+        }
+        return { supported: true, index: idx };
+    }
+    catch (err) {
+        logWarn("elicitation", "Client does not support elicitation (or the request failed) — no choice made");
+        return { supported: false, index: null };
+    }
+}
 // ─── Command Allowlist ────────────────────────────────────────────────────────
 /**
  * Safe command prefixes allowed by run_workspace_command by default.

package/dist/cjs/mcp/utils.js.map

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

package/dist/cjs/mcp/workspaceShared.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared workspace-navigation helpers used by both the workspace CRUD tools
+ * (./tools/workspace.ts) and several other tools elsewhere in tools.ts
+ * (get_symbol_surgical_context, smart_file_slice, get_ast_hologram, ...). Split out
+ * to avoid duplicating them (or a tools.ts <-> tools/workspace.ts import cycle).
+ */
+import { type BlastRadiusResult } from "../subconscious/TheBrainV2";
+export declare function listDirRecursive(currentDir: string, relativePath: string, depth: number, maxDepth: number): string[];
+/**
+ * Fase E — blast radius. Purely advisory text appended to a write tool's success response:
+ * which Brain memories (direct or derived via Fase B's derivedFrom) depend on the
+ * file/symbol just written, and which of those document a documented FAILED attempt. Never
+ * blocks the write and never mutates anything — the next search_memory/verify_memory call
+ * already re-checks freshness lazily; this only surfaces the same signal earlier, at the
+ * moment it's cheapest to act on.
+ */
+export declare function formatBlastRadiusNote(result: BlastRadiusResult): string;
+export declare function formatRecallNote(filePath: string, symbolName?: string): string;
+//# sourceMappingURL=workspaceShared.d.ts.map

package/dist/cjs/mcp/workspaceShared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceShared.d.ts","sourceRoot":"","sources":["../../../src/mcp/workspaceShared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE9E,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CAoBV;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAOvE;AAmBD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAqB9E"}

package/dist/cjs/mcp/workspaceShared.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Shared workspace-navigation helpers used by both the workspace CRUD tools
+ * (./tools/workspace.ts) and several other tools elsewhere in tools.ts
+ * (get_symbol_surgical_context, smart_file_slice, get_ast_hologram, ...). Split out
+ * to avoid duplicating them (or a tools.ts <-> tools/workspace.ts import cycle).
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listDirRecursive = listDirRecursive;
+exports.formatBlastRadiusNote = formatBlastRadiusNote;
+exports.formatRecallNote = formatRecallNote;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const TheBrainV2_1 = require("../subconscious/TheBrainV2");
+function listDirRecursive(currentDir, relativePath, depth, maxDepth) {
+    if (depth > maxDepth)
+        return [];
+    try {
+        const entries = fs_1.default.readdirSync(currentDir, { withFileTypes: true });
+        let result = [];
+        for (const entry of entries) {
+            if (["node_modules", ".git", "dist", "chroma_data", ".lemma"].includes(entry.name))
+                continue;
+            const rel = relativePath ? path_1.default.join(relativePath, entry.name) : entry.name;
+            const full = path_1.default.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                result.push(`${rel}/`);
+                result.push(...listDirRecursive(full, rel, depth + 1, maxDepth));
+            }
+            else {
+                result.push(rel);
+            }
+        }
+        return result;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Fase E — blast radius. Purely advisory text appended to a write tool's success response:
+ * which Brain memories (direct or derived via Fase B's derivedFrom) depend on the
+ * file/symbol just written, and which of those document a documented FAILED attempt. Never
+ * blocks the write and never mutates anything — the next search_memory/verify_memory call
+ * already re-checks freshness lazily; this only surfaces the same signal earlier, at the
+ * moment it's cheapest to act on.
+ */
+function formatBlastRadiusNote(result) {
+    if (result.hits.length === 0)
+        return "";
+    const ids = result.hits.map((h) => h.id).join(", ");
+    const base = `\n📎 ${result.hits.length} memor${result.hits.length === 1 ? "y" : "ies"} in the Brain depend on this and will go stale: ${ids}. They'll re-verify next time they're searched.`;
+    if (result.failedHits.length === 0)
+        return base;
+    const failedIds = result.failedHits.map((h) => h.id).join(", ");
+    return `${base}\n⚠️ ${result.failedHits.length} of those document a PRIOR ATTEMPT THAT FAILED on related code: ${failedIds}. Review before continuing down this path.`;
+}
+/**
+ * The read-side counterpart to formatBlastRadiusNote.
+ *
+ * Fase E made the write path proactive: a tool that stales memories says so on the spot.
+ * The read path stayed entirely opt-in — the Brain only spoke when the agent remembered to
+ * call search_memory, which is exactly the moment an agent that doesn't know a memory exists
+ * has no reason to. This closes that asymmetry: reading code the Brain already has notes on
+ * surfaces them, including any documented dead end, before the investigation restarts from
+ * scratch.
+ *
+ * Same rules as the write-side note: advisory only, never blocks, never mutates, and adds no
+ * tool schema (it enriches an existing response), so it costs nothing per turn. It reports
+ * ids rather than content — pulling whole memories into every file read would spend far more
+ * context than it saves; search_memory or verify_memory fetches the ones that matter.
+ */
+const _recallNoted = new Set();
+function formatRecallNote(filePath, symbolName) {
+    try {
+        const result = (0, TheBrainV2_1.getBrain)().findBlastRadius(filePath, symbolName);
+        if (result.hits.length === 0)
+            return "";
+        // Repeating the identical note on every read of the same file is nagging, not signal.
+        // Keyed by the memory set, so a note reappears when the set genuinely changes.
+        const ids = result.hits.map((h) => h.id).sort();
+        const key = `${path_1.default.resolve(filePath)}::${symbolName || ""}::${ids.join(",")}`;
+        if (_recallNoted.has(key))
+            return "";
+        _recallNoted.add(key);
+        const subject = symbolName ? `\`${symbolName}\`` : "this file";
+        const base = `\n\n🧠 The Brain already has ${result.hits.length} memor${result.hits.length === 1 ? "y" : "ies"} about ${subject}: ${ids.join(", ")}. Call verify_memory on them before investigating from scratch.`;
+        if (result.failedHits.length === 0)
+            return base;
+        const failedIds = result.failedHits.map((h) => h.id).join(", ");
+        return `${base}\n⚠️ ${result.failedHits.length} of those document an approach that was tried here and FAILED: ${failedIds}. Read those first so you don't repeat it.`;
+    }
+    catch {
+        // A recall note must never be the reason a file read fails.
+        return "";
+    }
+}
+//# sourceMappingURL=workspaceShared.js.map

package/dist/cjs/mcp/workspaceShared.js.map

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

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/esm/api/dashboardRoutes.d.ts

@@ -13,9 +13,9 @@
  *   POST /api/debugger/rewind - Rewind to event state
  */
 import { Router } from 'express';
-import { OrchestrationEngine } from '../core/OrchestrationEngine';
-import { AgentRegistry } from '../core/AgentRegistry';
-import { SubconsciousEngine } from '../core/SubconsciousEngine';
+import { OrchestrationEngine } from '../core/OrchestrationEngine.js';
+import { AgentRegistry } from '../core/AgentRegistry.js';
+import { SubconsciousEngine } from '../core/SubconsciousEngine.js';
 interface DashboardAPIContext {
     eventLog: any[];
     orchestrationEngine: OrchestrationEngine;

package/dist/esm/api/dashboardRoutes.js

@@ -13,7 +13,7 @@
  *   POST /api/debugger/rewind - Rewind to event state
  */
 import { Router } from 'express';
-import { createLogger } from '../utils/logger';
+import { createLogger } from '../utils/logger.js';
 const logger = createLogger('DashboardAPI');
 export function createDashboardRouter(context) {
     const router = Router();

package/dist/esm/api/server.d.ts

@@ -3,10 +3,10 @@
  * Express server for dashboard metrics and analytics endpoints
  * Runs on port 3001 by default
  */
-import { DashboardWebSocketServer } from '../core/DashboardWebSocketServer';
-import { OrchestrationEngine } from '../core/OrchestrationEngine';
-import { AgentRegistry } from '../core/AgentRegistry';
-import { SubconsciousEngine } from '../core/SubconsciousEngine';
+import { DashboardWebSocketServer } from '../core/DashboardWebSocketServer.js';
+import { OrchestrationEngine } from '../core/OrchestrationEngine.js';
+import { AgentRegistry } from '../core/AgentRegistry.js';
+import { SubconsciousEngine } from '../core/SubconsciousEngine.js';
 export interface ServerConfig {
     port?: number;
     host?: string;

package/dist/esm/api/server.js

@@ -6,9 +6,9 @@
 import express from 'express';
 import cors from 'cors';
 import http from 'http';
-import { createDashboardRouter } from './dashboardRoutes';
-import { DashboardWebSocketServer } from '../core/DashboardWebSocketServer';
-import { createLogger } from '../utils/logger';
+import { createDashboardRouter } from './dashboardRoutes.js';
+import { DashboardWebSocketServer } from '../core/DashboardWebSocketServer.js';
+import { createLogger } from '../utils/logger.js';
 const logger = createLogger('DashboardServer');
 export class DashboardAPIServer {
     constructor(config = {}) {

package/dist/esm/autopilot/AutopilotWatcher.js

@@ -1,9 +1,9 @@
 import fs from 'fs';
 import path from 'path';
 import { exec } from 'child_process';
-import { performAutoHeal } from '../cli/lemma-proxy';
-import { savePatch, countPending } from './PatchStore';
-import { notifyPatch } from './Notifier';
+import { performAutoHeal } from '../cli/lemma-proxy.js';
+import { savePatch, countPending } from './PatchStore.js';
+import { notifyPatch } from './Notifier.js';
 export class AutopilotWatcher {
     constructor(watchDir = 'src', nonInvasive = true) {
         this.isRunning = false;

package/dist/esm/autopilot/Notifier.d.ts

@@ -1,4 +1,4 @@
-import type { Patch } from './PatchStore';
+import type { Patch } from './PatchStore.js';
 export declare function sendNotification(title: string, subtitle: string, message: string): void;
 export declare function notifyPatch(patch: Patch): void;
 export declare function notifyClear(): void;

package/dist/esm/cli/lemma-proxy.js

@@ -33,21 +33,21 @@ function ask(query) {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     return new Promise(resolve => rl.question(query, ans => { rl.close(); resolve(ans); }));
 }
-import ComplexityRouter from '../proxy/ComplexityRouter';
-import SemanticScrubber from '../security/SemanticScrubber';
-import CloudSyncClient from '../cloud/CloudSyncClient';
-import { runPRReview } from '../pr-review/reviewRunner';
-import { registerInfraCommands } from '../infra/cli';
-import { pruneHistoryMessages, squeezePrompt } from '../utils/ContextSqueezer';
-import { AgentMultiplexer } from '../proxy/AgentMultiplexer';
-import { SseRelay } from '../proxy/SseRelay';
-import { KeyManager } from '../proxy/KeyManager';
-import { Gatekeeper } from '../proxy/Gatekeeper';
-import { detectProjectName, isProjectMismatch } from '../utils/ProjectIdentity';
-import { ProjectRegistry } from '../proxy/ProjectRegistry';
-import { shouldInject, buildMinimalContext, buildDeepContext, sniffProjectFromMessages } from '../proxy/ContextInjector';
-import { savingsLedger } from '../utils/SavingsLedger';
-import { CACHE_DIR, PID_FILE, PORT_FILE, STATS_FILE, USAGE_FILE, LICENSE_FILE, CLIPBOARD_PID_FILE, FREE_TIER_LIMIT } from '../proxy/ProjectStore';
+import ComplexityRouter from '../proxy/ComplexityRouter.js';
+import SemanticScrubber from '../security/SemanticScrubber.js';
+import CloudSyncClient from '../cloud/CloudSyncClient.js';
+import { runPRReview } from '../pr-review/reviewRunner.js';
+import { registerInfraCommands } from '../infra/cli.js';
+import { pruneHistoryMessages, squeezePrompt } from '../utils/ContextSqueezer.js';
+import { AgentMultiplexer } from '../proxy/AgentMultiplexer.js';
+import { SseRelay } from '../proxy/SseRelay.js';
+import { KeyManager } from '../proxy/KeyManager.js';
+import { Gatekeeper } from '../proxy/Gatekeeper.js';
+import { detectProjectName, isProjectMismatch } from '../utils/ProjectIdentity.js';
+import { ProjectRegistry } from '../proxy/ProjectRegistry.js';
+import { shouldInject, buildMinimalContext, buildDeepContext, sniffProjectFromMessages } from '../proxy/ContextInjector.js';
+import { savingsLedger } from '../utils/SavingsLedger.js';
+import { CACHE_DIR, PID_FILE, PORT_FILE, STATS_FILE, USAGE_FILE, LICENSE_FILE, CLIPBOARD_PID_FILE, FREE_TIER_LIMIT } from '../proxy/ProjectStore.js';
 const chroma = new ChromaClient({ host: 'localhost', port: 8000 });
 const dummyEmbeddingFunction = { generate: (texts) => Promise.resolve([]) };
 const complexityRouter = new ComplexityRouter();

package/dist/esm/cli/stack.d.ts

@@ -1,7 +1,7 @@
-import { WebSocketServer } from '../core/WebSocketServer';
-import { OrchestrationEngine } from '../core/OrchestrationEngine';
-import { SubconsciousEngine } from '../core/SubconsciousEngine';
-import { DashboardAPIServer } from '../api/server';
+import { WebSocketServer } from '../core/WebSocketServer.js';
+import { OrchestrationEngine } from '../core/OrchestrationEngine.js';
+import { SubconsciousEngine } from '../core/SubconsciousEngine.js';
+import { DashboardAPIServer } from '../api/server.js';
 /**
  * Lemma Stack Orchestrator
  * Starts the Router, Subconscious Engine, and Dashboard API

package/dist/esm/cli/stack.js

@@ -1,8 +1,8 @@
-import { WebSocketServer } from '../core/WebSocketServer';
-import { OrchestrationEngine } from '../core/OrchestrationEngine';
-import { SubconsciousEngine } from '../core/SubconsciousEngine';
-import { DashboardBroadcaster } from '../core/DashboardBroadcaster';
-import { DashboardAPIServer } from '../api/server';
+import { WebSocketServer } from '../core/WebSocketServer.js';
+import { OrchestrationEngine } from '../core/OrchestrationEngine.js';
+import { SubconsciousEngine } from '../core/SubconsciousEngine.js';
+import { DashboardBroadcaster } from '../core/DashboardBroadcaster.js';
+import { DashboardAPIServer } from '../api/server.js';
 /**
  * Lemma Stack Orchestrator
  * Starts the Router, Subconscious Engine, and Dashboard API

package/dist/esm/cloud/KeyManager.d.ts

@@ -4,7 +4,7 @@
  * Handles key generation, validation, usage tracking, and plan enforcement.
  * Uses a JSON file as storage (swap for Redis/Postgres in production).
  */
-import { ApiKey } from './types';
+import { ApiKey } from './types.js';
 export declare class KeyManager {
     private keys;
     private storePath;

package/dist/esm/cloud/KeyManager.js

@@ -7,7 +7,7 @@
 import crypto from 'crypto';
 import fs from 'fs';
 import path from 'path';
-import { PLAN_LIMITS } from './types';
+import { PLAN_LIMITS } from './types.js';
 export class KeyManager {
     constructor(storePath = './data/keys.json') {
         this.keys = new Map();

package/dist/esm/cloud/TenantCache.d.ts

@@ -4,7 +4,7 @@
  * Each tenant gets an isolated ChromaDB collection + usage stats.
  * Handles semantic search via Ollama embeddings.
  */
-import { TenantStats } from './types';
+import { TenantStats } from './types.js';
 export declare class TenantCache {
     private tenantId;
     private chromaUrl;

package/dist/esm/cloud/identity/ApiKey.d.ts

@@ -1,4 +1,4 @@
-import type { IdentityStore, NewKeyInput } from './identityStore';
+import type { IdentityStore, NewKeyInput } from './identityStore.js';
 export type KeyPrefix = 'lk_live_' | 'lk_test_';
 export declare const KEY_PREFIX_LIVE: KeyPrefix;
 export declare const KEY_PREFIX_TEST: KeyPrefix;

package/dist/esm/cloud/identity/TenantResolver.d.ts

@@ -1,4 +1,4 @@
-import type { IdentityStore } from './identityStore';
+import type { IdentityStore } from './identityStore.js';
 export interface Tenant {
     id: string;
     plan: 'free' | 'pro' | 'scale';

package/dist/esm/cloud/identity/TenantResolver.js

@@ -7,7 +7,7 @@
  * request hashes the presented token and hits the store, so a revoked key fails
  * on the very next request — there is no 24h (or any) positive cache.
  */
-import { isWellFormedKey, hashApiKey } from './ApiKey';
+import { isWellFormedKey, hashApiKey } from './ApiKey.js';
 export class TenantResolver {
     constructor(store) {
         this.store = store;

package/dist/esm/cloud/identity/authenticateV2.d.ts

@@ -13,9 +13,9 @@
  * `Retry-After` header and an actionable body.
  */
 import type { Request, RequestHandler } from 'express';
-import { PlanPolicy, RATE_LIMIT_WINDOW_MS } from './PlanPolicy';
-import type { RateLimiter } from './RateLimiter';
-import type { Tenant, TenantResolver } from './TenantResolver';
+import { PlanPolicy, RATE_LIMIT_WINDOW_MS } from './PlanPolicy.js';
+import type { RateLimiter } from './RateLimiter.js';
+import type { Tenant, TenantResolver } from './TenantResolver.js';
 declare global {
     namespace Express {
         interface Request {

package/dist/esm/cloud/identity/authenticateV2.js

@@ -1,6 +1,6 @@
-import { LemmaApiError } from '../../contracts/errors';
-import { PlanPolicy, RATE_LIMIT_WINDOW_MS } from './PlanPolicy';
-import { rateLimitErrorBody } from './RateLimiter';
+import { LemmaApiError } from '../../contracts/errors.js';
+import { PlanPolicy, RATE_LIMIT_WINDOW_MS } from './PlanPolicy.js';
+import { rateLimitErrorBody } from './RateLimiter.js';
 function parseBearer(header) {
     if (!header)
         return null;

package/dist/esm/cloud/identity/identityStore.d.ts

@@ -9,8 +9,8 @@
  * `PostgresIdentityStore` is the production implementation over `pg`.
  */
 import type { Pool } from 'pg';
-import type { KeyPrefix } from './ApiKey';
-import type { PlanId } from './PlanPolicy';
+import type { KeyPrefix } from './ApiKey.js';
+import type { PlanId } from './PlanPolicy.js';
 export interface NewKeyInput {
     tenantId: string;
     name: string;

package/dist/esm/cloud/identity/index.d.ts

@@ -5,10 +5,10 @@
  * per-plan ceilings without Infinity, and per-tenant rate limiting with
  * Retry-After.
  */
-export * from './ApiKey';
-export * from './identityStore';
-export * from './PlanPolicy';
-export * from './RateLimiter';
-export * from './TenantResolver';
-export * from './authenticateV2';
+export * from './ApiKey.js';
+export * from './identityStore.js';
+export * from './PlanPolicy.js';
+export * from './RateLimiter.js';
+export * from './TenantResolver.js';
+export * from './authenticateV2.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/cloud/identity/index.js

@@ -5,10 +5,10 @@
  * per-plan ceilings without Infinity, and per-tenant rate limiting with
  * Retry-After.
  */
-export * from './ApiKey';
-export * from './identityStore';
-export * from './PlanPolicy';
-export * from './RateLimiter';
-export * from './TenantResolver';
-export * from './authenticateV2';
+export * from './ApiKey.js';
+export * from './identityStore.js';
+export * from './PlanPolicy.js';
+export * from './RateLimiter.js';
+export * from './TenantResolver.js';
+export * from './authenticateV2.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/cloud/index.d.ts

@@ -1,4 +1,4 @@
-export { KeyManager } from './KeyManager';
-export { TenantCache } from './TenantCache';
-export * from './types';
+export { KeyManager } from './KeyManager.js';
+export { TenantCache } from './TenantCache.js';
+export * from './types.js';
 //# sourceMappingURL=index.d.ts.map