@ekkos/cli 1.3.7 → 1.3.8

package/dist/commands/dashboard.js

@@ -69,16 +69,24 @@ const usage_parser_js_1 = require("../lib/usage-parser.js");
 const state_js_1 = require("../utils/state.js");
 const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 // ── Pricing ──
-// Pricing per MTok from https://platform.claude.com/docs/en/about-claude/pricing
+// Pricing per MTok from https://docs.anthropic.com/en/docs/about-claude/pricing
+// Includes prompt caching rates (5m cache write=1.25x input, cache read=0.1x input).
 const MODEL_PRICING = {
     'claude-opus-4-6-20260514': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
     'claude-opus-4-6': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
+    'claude-opus-4-5-20251101': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
+    'claude-opus-4-5': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
+    'claude-opus-4-20250514': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
+    'claude-opus-4': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
     'claude-sonnet-4-6-20260514': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
-    'claude-opus-4-5-20250620': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
     'claude-sonnet-4-6': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
     'claude-sonnet-4-5-20250929': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
+    'claude-sonnet-4-5': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
     'claude-sonnet-4-5-20250514': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
+    'claude-sonnet-4-20250514': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
+    'claude-sonnet-4': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
     'claude-haiku-4-5-20251001': { input: 1, output: 5, cacheWrite: 1.25, cacheRead: 0.10 },
+    'claude-haiku-4-5': { input: 1, output: 5, cacheWrite: 1.25, cacheRead: 0.10 },
 };
 function getModelPricing(modelId) {
     if (MODEL_PRICING[modelId])
@@ -86,13 +94,33 @@ function getModelPricing(modelId) {
     if (modelId.includes('opus'))
         return MODEL_PRICING['claude-opus-4-6'];
     if (modelId.includes('sonnet'))
-        return MODEL_PRICING['claude-sonnet-4-5-20250929'];
+        return MODEL_PRICING['claude-sonnet-4-6'];
     if (modelId.includes('haiku'))
         return MODEL_PRICING['claude-haiku-4-5-20251001'];
-    return MODEL_PRICING['claude-sonnet-4-5-20250929'];
+    return MODEL_PRICING['claude-sonnet-4-6'];
 }
-function calculateTurnCost(model, usage) {
-    const p = getModelPricing(model);
+// Claude Sonnet 4/4.5 has legacy long-context premium rates when context-1m
+// is enabled and input exceeds 200k. Sonnet/Opus 4.6 is GA 1M at standard rates.
+function isLegacyLongContextPremiumModel(modelId) {
+    const normalized = (modelId || '').toLowerCase();
+    if (/^claude-sonnet-4-6(?:$|-)/.test(normalized))
+        return false;
+    return /^claude-sonnet-4(?:$|-)/.test(normalized);
+}
+function calculateTurnCost(model, usage, options) {
+    const base = getModelPricing(model);
+    const longContextPremium = options?.longContextPremium === true
+        && isLegacyLongContextPremiumModel(model);
+    const p = longContextPremium
+        ? {
+            // Long context pricing modifiers:
+            // Input/cache bucket = 2x, output = 1.5x.
+            input: base.input * 2,
+            output: base.output * 1.5,
+            cacheWrite: base.cacheWrite * 2,
+            cacheRead: base.cacheRead * 2,
+        }
+        : base;
     return ((usage.input_tokens / 1000000) * p.input +
         (usage.output_tokens / 1000000) * p.output +
         (usage.cache_creation_tokens / 1000000) * p.cacheWrite +
@@ -199,6 +227,9 @@ function parseJsonlFile(jsonlPath, sessionName) {
                 const contextTierHint = typeof entry.message._ekkos_context_tier === 'string'
                     ? entry.message._ekkos_context_tier.trim().toLowerCase()
                     : undefined;
+                const explicitExtraUsage = entry.message._ekkos_extra_usage === true
+                    || entry.message._ekkos_extra_usage === '1'
+                    || entry.message._ekkos_extra_usage === 'true';
                 const inputTokens = usage.input_tokens || 0;
                 const outputTokens = usage.output_tokens || 0;
                 const cacheReadTokens = usage.cache_read_input_tokens || 0;
@@ -215,11 +246,19 @@ function parseJsonlFile(jsonlPath, sessionName) {
                     cache_read_tokens: cacheReadTokens,
                     cache_creation_tokens: cacheCreationTokens,
                 };
+                const legacyLongContextPremium = isLegacyLongContextPremiumModel(routedModel) && (explicitExtraUsage
+                    || (contextTierHint === '1m' && contextTokens > 200000));
                 // Cost at actual model pricing (Haiku if routed)
-                const turnCost = calculateTurnCost(routedModel, usageData);
+                const turnCost = calculateTurnCost(routedModel, usageData, {
+                    longContextPremium: legacyLongContextPremium,
+                });
                 // Cost if it had been Opus (for savings calculation)
+                const requestedModelPremium = isLegacyLongContextPremiumModel(model) && (explicitExtraUsage
+                    || (contextTierHint === '1m' && contextTokens > 200000));
                 const opusCost = routedModel !== model
-                    ? calculateTurnCost(model, usageData)
+                    ? calculateTurnCost(model, usageData, {
+                        longContextPremium: requestedModelPremium,
+                    })
                     : turnCost;
                 const savings = opusCost - turnCost;
                 const msgTools = toolsByMessage.get(msgId);
@@ -388,7 +427,20 @@ function resolveJsonlPath(sessionName, createdAfterMs) {
     if (fs.existsSync(activeSessionsPath)) {
         try {
             const sessions = JSON.parse(fs.readFileSync(activeSessionsPath, 'utf-8'));
-            const match = sessions.find((s) => s.sessionName === sessionName);
+            // Skip stale entries whose PID is dead (prevents cross-binding after restart)
+            const match = sessions.find((s) => {
+                if (s.sessionName !== sessionName)
+                    return false;
+                if (s.pid && s.pid > 1) {
+                    try {
+                        process.kill(s.pid, 0);
+                    }
+                    catch {
+                        return false;
+                    }
+                }
+                return true;
+            });
             if (match?.projectPath) {
                 if (isStableSessionId(match.sessionId)) {
                     // Prefer exact sessionId lookup, but if that file does not exist yet
@@ -2165,10 +2217,14 @@ exports.dashboardCommand = new commander_1.Command('dashboard')
         if (!sessionName)
             process.exit(0);
     }
-    const jsonlPath = resolveJsonlPath(sessionName);
+    // Use launch timestamp as lower bound so initial resolution never picks up
+    // stale JSONL files from previous sessions (the lazy resolution already does
+    // this correctly — this ensures the INITIAL resolve matches).
+    const launchTs = Date.now();
+    const jsonlPath = resolveJsonlPath(sessionName, launchTs);
     if (!jsonlPath) {
         // JSONL may not exist yet (session just started) — launch with lazy resolution
         console.log(chalk_1.default.gray(`Waiting for JSONL for "${sessionName}"...`));
     }
-    await launchDashboard(sessionName, jsonlPath || null, refreshMs, null, Date.now());
+    await launchDashboard(sessionName, jsonlPath || null, refreshMs, null, launchTs);
 });

package/dist/commands/gemini.js

@@ -59,6 +59,39 @@ const proxy_url_1 = require("../utils/proxy-url");
 let cliSessionName = null;
 let cliSessionId = null;
 const isWindows = process.platform === 'win32';
+const PULSE_LOADED_TEXT = '  🧠 ekkOS_Pulse  Loaded!';
+const PULSE_SHINE_FRAME_MS = 50;
+const PULSE_SHINE_SWEEPS = 2;
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function renderPulseShineFrame(text, shineIndex) {
+    const chars = Array.from(text);
+    return chars.map((ch, i) => {
+        const dist = Math.abs(i - shineIndex);
+        if (dist === 0)
+            return chalk_1.default.whiteBright.bold(ch);
+        if (dist === 1)
+            return chalk_1.default.yellowBright.bold(ch);
+        if (dist === 2)
+            return chalk_1.default.yellowBright(ch);
+        return chalk_1.default.yellow(ch);
+    }).join('');
+}
+async function showPulseLoadedBanner() {
+    if (!process.stdout.isTTY) {
+        console.log(chalk_1.default.cyan(PULSE_LOADED_TEXT));
+        return;
+    }
+    const charCount = Array.from(PULSE_LOADED_TEXT).length;
+    for (let sweep = 0; sweep < PULSE_SHINE_SWEEPS; sweep++) {
+        for (let shineIndex = -3; shineIndex < charCount + 3; shineIndex++) {
+            process.stdout.write(`\r${renderPulseShineFrame(PULSE_LOADED_TEXT, shineIndex)}`);
+            await sleep(PULSE_SHINE_FRAME_MS);
+        }
+    }
+    process.stdout.write(`\r${chalk_1.default.yellow(PULSE_LOADED_TEXT)}\n`);
+}
 /**
  * Resolve Gemini CLI binary path.
  * Checks common locations then falls back to PATH lookup.
@@ -118,13 +151,6 @@ function buildGeminiEnv(options) {
     const proxyUrl = (0, proxy_url_1.buildGeminiProxyUrl)(userId, cliSessionName, process.cwd(), cliSessionId);
     env.GOOGLE_GEMINI_BASE_URL = proxyUrl;
     env.GOOGLE_VERTEX_BASE_URL = proxyUrl;
-    // User must bring their own Gemini API key — ekkOS just proxies the traffic
-    // for IPC compression and pattern injection (same model as Claude).
-    if (!env.GEMINI_API_KEY && !env.GOOGLE_API_KEY) {
-        console.warn(chalk_1.default.yellow('  ⚠ GEMINI_API_KEY not set.'));
-        console.warn(chalk_1.default.gray('    Get one at: https://aistudio.google.com/apikey'));
-        console.warn(chalk_1.default.gray('    Then: export GEMINI_API_KEY=your_key'));
-    }
     if (options.verbose) {
         // Redact userId from log
         const safeUrl = proxyUrl.replace(/\/proxy\/[^/]+\//, '/proxy/[user]/');
@@ -151,7 +177,7 @@ async function gemini(options = {}) {
     const sessionName = cliSessionName || 'gemini-session';
     (0, state_1.registerActiveSession)(sessionId, sessionName, process.cwd());
     if (!options.noProxy) {
-        console.log(chalk_1.default.cyan('  🧠 ekkOS_Continuum Loaded!'));
+        await showPulseLoadedBanner();
     }
     console.log('');
     // Extract any trailing arguments meant for the inner CLI

package/dist/commands/init.js

@@ -5,6 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.init = init;
 const fs_1 = require("fs");
+const child_process_1 = require("child_process");
+const path_1 = require("path");
 const chalk_1 = __importDefault(require("chalk"));
 const inquirer_1 = __importDefault(require("inquirer"));
 const ora_1 = __importDefault(require("ora"));
@@ -15,6 +17,7 @@ const settings_1 = require("../deploy/settings");
 // DEPRECATED: Hooks removed in hookless architecture migration
 // import { deployHooks } from '../deploy/hooks';
 const skills_1 = require("../deploy/skills");
+const agents_1 = require("../deploy/agents");
 const instructions_1 = require("../deploy/instructions");
 const templates_1 = require("../utils/templates");
 // ═══════════════════════════════════════════════════════════════════════════
@@ -34,15 +37,20 @@ async function pollForApproval(code, expiresIn) {
     const pollInterval = 3000; // 3 seconds
     const maxAttempts = Math.floor((expiresIn * 1000) / pollInterval);
     for (let attempt = 0; attempt < maxAttempts; attempt++) {
-        const response = await fetch(`${platform_1.PLATFORM_URL}/api/device-auth/codes/${code}/status`, { method: 'GET' });
-        if (response.status === 410) {
-            return { status: 'expired' };
-        }
-        if (response.ok) {
-            const data = await response.json();
-            if (data.status !== 'pending') {
-                return data;
+        try {
+            const response = await fetch(`${platform_1.PLATFORM_URL}/api/device-auth/codes/${code}/status`, { method: 'GET' });
+            if (response.status === 410) {
+                return { status: 'expired' };
             }
+            if (response.ok) {
+                const data = await response.json();
+                if (data.status !== 'pending') {
+                    return data;
+                }
+            }
+        }
+        catch {
+            // Network error — silently retry instead of killing the flow
         }
         // Wait before next poll
         await new Promise(resolve => setTimeout(resolve, pollInterval));
@@ -77,17 +85,33 @@ async function deviceAuth() {
         throw error;
     }
     console.log('');
-    console.log(chalk_1.default.white.bold(`Your code: ${chalk_1.default.cyan.bold(deviceCode.code)}`));
+    console.log(chalk_1.default.white.bold(`  Your code: ${chalk_1.default.cyan.bold(deviceCode.code)}`));
+    // Auto-copy code to clipboard
+    try {
+        if (process.platform === 'darwin') {
+            (0, child_process_1.execSync)(`echo -n "${deviceCode.code}" | pbcopy`, { stdio: 'ignore' });
+        }
+        else if (process.platform === 'win32') {
+            (0, child_process_1.execSync)(`echo|set /p="${deviceCode.code}" | clip`, { stdio: 'ignore' });
+        }
+        else {
+            (0, child_process_1.execSync)(`echo -n "${deviceCode.code}" | xclip -selection clipboard`, { stdio: 'ignore' });
+        }
+        console.log(chalk_1.default.green('  ✓ Copied to clipboard'));
+    }
+    catch {
+        // Clipboard not available — no problem, code is displayed
+    }
     console.log('');
     // Open browser
     const verificationUrl = deviceCode.verificationUrl || `${platform_1.PLATFORM_URL}/activate`;
-    console.log(chalk_1.default.gray(`Opening browser to: ${verificationUrl}`));
+    console.log(chalk_1.default.gray(`  Opening browser → ${verificationUrl}`));
     try {
         await (0, open_1.default)(verificationUrl);
     }
     catch {
-        console.log(chalk_1.default.yellow('Could not open browser automatically.'));
-        console.log(chalk_1.default.gray(`Please visit: ${verificationUrl}`));
+        console.log(chalk_1.default.yellow('  Could not open browser automatically.'));
+        console.log(chalk_1.default.gray(`  Please visit: ${verificationUrl}`));
     }
     console.log('');
     // Poll for approval
@@ -217,13 +241,13 @@ async function selectIDEs(autoSelect = false) {
         }
         console.log('');
     }
-    // Auto-select when exactly one IDE is detected or autoSelect flag is set
+    // Auto-select: configure ALL detected IDEs (no prompt)
     if (autoSelect || detectedList.length === 1) {
-        const autoIDE = detectedList.length === 1 ? detectedList[0] : (current ?? detectedList[0] ?? 'claude');
-        const ideName = autoIDE === 'claude' ? 'Claude Code' : autoIDE === 'cursor' ? 'Cursor' : 'Windsurf';
-        console.log(chalk_1.default.green(`✓ Auto-detected: ${chalk_1.default.bold(ideName)}`));
+        const toSetup = detectedList.length > 0 ? detectedList : [current ?? 'claude'];
+        const names = toSetup.map(id => id === 'claude' ? 'Claude Code' : id === 'cursor' ? 'Cursor' : 'Windsurf');
+        console.log(chalk_1.default.green(`✓ Auto-detected: ${chalk_1.default.bold(names.join(', '))}`));
         console.log('');
-        return [autoIDE];
+        return toSetup;
     }
     const ideChoices = [
         { name: 'Claude Code', value: 'claude', checked: detectedList.includes('claude') || current === 'claude' },
@@ -249,6 +273,7 @@ async function deployForClaude(apiKey, userId, options) {
         mcp: false,
         settings: false,
         skills: { count: 0, skills: [] },
+        agents: { count: 0, agents: [] },
         instructions: false
     };
     // MCP configuration
@@ -283,12 +308,21 @@ async function deployForClaude(apiKey, userId, options) {
             spinner.fail('Skills deployment failed');
         }
     }
-    // CLAUDE.md
+    // Agents (prune, rewind, scout, trace)
+    spinner = (0, ora_1.default)('Deploying ekkOS agents...').start();
+    try {
+        result.agents = (0, agents_1.deployAgents)();
+        spinner.succeed(`Agents (${result.agents.agents.join(', ')})`);
+    }
+    catch (error) {
+        spinner.fail('Agent deployment failed');
+    }
+    // CLAUDE.md (merge — never overwrites existing user content)
     spinner = (0, ora_1.default)('Deploying global instructions...').start();
     try {
         (0, instructions_1.deployInstructions)();
         result.instructions = true;
-        spinner.succeed('Global instructions (CLAUDE.md)');
+        spinner.succeed('Global instructions (CLAUDE.md — merged)');
     }
     catch (error) {
         spinner.fail('Global instructions failed');
@@ -461,6 +495,40 @@ async function init(options) {
     catch {
         verifySpinner.warn('Could not reach ekkOS API — check your network');
     }
+    // Phase: Scaffold ekkos.yml if not present in the current directory or git root
+    const cwd = process.cwd();
+    let projectRoot = cwd;
+    try {
+        projectRoot = (0, child_process_1.execSync)('git rev-parse --show-toplevel', { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+    }
+    catch { /* not a git repo — use cwd */ }
+    const ekkosYmlPath = (0, path_1.join)(projectRoot, 'ekkos.yml');
+    if (!(0, fs_1.existsSync)(ekkosYmlPath)) {
+        const projectName = (0, path_1.basename)(projectRoot);
+        const hasPackageJson = (0, fs_1.existsSync)((0, path_1.join)(projectRoot, 'package.json'));
+        const hasCargo = (0, fs_1.existsSync)((0, path_1.join)(projectRoot, 'Cargo.toml'));
+        const buildCmd = hasPackageJson ? 'npm run build' : hasCargo ? 'cargo build' : '';
+        const testCmd = hasPackageJson ? 'npm test' : hasCargo ? 'cargo test' : '';
+        const lintCmd = hasPackageJson ? 'npm run lint' : hasCargo ? 'cargo clippy' : '';
+        const ymlLines = [
+            'version: 1',
+            `project: "${projectName}"`,
+            '',
+            'ans:',
+            '  tier: "R1"',
+        ];
+        if (buildCmd)
+            ymlLines.push(`  build: "${buildCmd}"`);
+        if (testCmd)
+            ymlLines.push(`  test: "${testCmd}"`);
+        if (lintCmd)
+            ymlLines.push(`  lint: "${lintCmd}"`);
+        ymlLines.push('');
+        (0, fs_1.writeFileSync)(ekkosYmlPath, ymlLines.join('\n'), 'utf-8');
+        console.log('');
+        console.log(chalk_1.default.green(`  Created ${chalk_1.default.bold('ekkos.yml')} in ${projectRoot}`));
+        console.log(chalk_1.default.gray(`  Customize: ${chalk_1.default.cyan('https://platform.ekkos.dev/dashboard/settings/project')}`));
+    }
     // Summary with prominent next step
     const ideNames = installedIDEs.map(id => id === 'claude' ? 'Claude Code' : id === 'cursor' ? 'Cursor' : 'Windsurf');
     const mcpPaths = {
@@ -488,8 +556,11 @@ async function init(options) {
     console.log(chalk_1.default.yellow.bold('  NEXT STEPS:'));
     console.log('');
     console.log(chalk_1.default.white(`  1. Restart ${ideNames.join(' / ')}`));
-    console.log(chalk_1.default.white('  2. Run ') + chalk_1.default.cyan.bold('ekkos') + chalk_1.default.white(' to start coding with memory'));
+    console.log(chalk_1.default.white('  2. Run ') + chalk_1.default.cyan.bold('ekkos scan') + chalk_1.default.white(' to map your project systems'));
+    console.log(chalk_1.default.white('  3. Run ') + chalk_1.default.cyan.bold('ekkos') + chalk_1.default.white(' to start coding with memory'));
     console.log('');
-    console.log(chalk_1.default.gray(`  Dashboard: https://platform.ekkos.dev/dashboard`));
+    console.log(chalk_1.default.gray(`  Dashboard:      https://platform.ekkos.dev/dashboard`));
+    console.log(chalk_1.default.gray(`  Configure ANS:  https://platform.ekkos.dev/dashboard/settings/project`));
+    console.log(chalk_1.default.gray(`  Connect vitals: https://platform.ekkos.dev/dashboard/settings/vitals`));
     console.log('');
 }

package/dist/commands/living-docs.d.ts

@@ -0,0 +1,8 @@
+export interface WatchLivingDocsOptions {
+    path?: string;
+    timeZone?: string;
+    pollIntervalMs?: number;
+    debounceMs?: number;
+    noSeed?: boolean;
+}
+export declare function watchLivingDocs(options: WatchLivingDocsOptions): Promise<void>;

package/dist/commands/living-docs.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watchLivingDocs = watchLivingDocs;
+const chalk_1 = __importDefault(require("chalk"));
+const path_1 = require("path");
+const living_docs_manager_js_1 = require("../local/living-docs-manager.js");
+const state_1 = require("../utils/state");
+const platform_js_1 = require("../utils/platform.js");
+function printStartupSummary(options) {
+    console.log('');
+    console.log(chalk_1.default.cyan.bold('  ekkOS Living Docs Watch'));
+    console.log(chalk_1.default.gray('  ─────────────────────────'));
+    console.log(chalk_1.default.gray(`  Path: ${options.targetPath}`));
+    console.log(chalk_1.default.gray(`  Timezone: ${options.timeZone}`));
+    console.log(chalk_1.default.gray(`  Registry seed: ${options.seedingEnabled ? 'enabled' : 'disabled'}`));
+    console.log('');
+    console.log(chalk_1.default.gray('  Watching local files and rewriting ekkOS_CONTEXT.md on change.'));
+    console.log(chalk_1.default.gray('  Press Ctrl+C to stop.'));
+    console.log('');
+}
+async function watchLivingDocs(options) {
+    const targetPath = (0, path_1.resolve)(options.path || process.cwd());
+    const timeZone = options.timeZone || process.env.EKKOS_USER_TIMEZONE || Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const apiKey = options.noSeed ? null : (0, state_1.getAuthToken)();
+    const apiUrl = options.noSeed ? undefined : (process.env.EKKOS_API_URL || platform_js_1.MCP_API_URL);
+    const manager = new living_docs_manager_js_1.LocalLivingDocsManager({
+        targetPath,
+        apiUrl,
+        apiKey,
+        timeZone,
+        pollIntervalMs: options.pollIntervalMs,
+        flushDebounceMs: options.debounceMs,
+        onLog: message => console.log(chalk_1.default.gray(`  ${message}`)),
+    });
+    printStartupSummary({
+        targetPath,
+        timeZone,
+        seedingEnabled: !!(apiUrl && apiKey),
+    });
+    manager.start();
+    await new Promise((resolvePromise) => {
+        let stopped = false;
+        const stop = () => {
+            if (stopped)
+                return;
+            stopped = true;
+            manager.stop();
+            process.off('SIGINT', handleSigInt);
+            process.off('SIGTERM', handleSigTerm);
+            resolvePromise();
+        };
+        const handleSigInt = () => {
+            console.log('');
+            console.log(chalk_1.default.gray('  Stopping living docs watcher...'));
+            stop();
+        };
+        const handleSigTerm = () => {
+            stop();
+        };
+        process.on('SIGINT', handleSigInt);
+        process.on('SIGTERM', handleSigTerm);
+    });
+}

package/dist/commands/run.js

@@ -49,6 +49,7 @@ const doctor_1 = require("./doctor");
 const stream_tailer_1 = require("../capture/stream-tailer");
 const jsonl_rewriter_1 = require("../capture/jsonl-rewriter");
 const transcript_repair_1 = require("../capture/transcript-repair");
+const living_docs_manager_js_1 = require("../local/living-docs-manager.js");
 // Try to load node-pty (may fail on Node 24+)
 // IMPORTANT: This must be awaited in run() to avoid racey false fallbacks.
 let pty = null;
@@ -291,10 +292,12 @@ const isWindows = os.platform() === 'win32';
 // Cosmetic patches may fail on newer versions but don't affect functionality
 const PINNED_CLAUDE_VERSION = 'latest';
 // Max output tokens for Claude responses
-// Default: 16384 (safe for Sonnet 4.5)
-// Opus 4.5 supports up to 64k - set EKKOS_MAX_OUTPUT_TOKENS=32768 or =65536 to use higher limits
-// Configurable via environment variable
-const EKKOS_MAX_OUTPUT_TOKENS = process.env.EKKOS_MAX_OUTPUT_TOKENS || '16384';
+// Default: 128000 (Opus 4.6 / Sonnet 4.6 max output)
+// Override via EKKOS_MAX_OUTPUT_TOKENS env var if needed
+// Note: Claude Code has a known bug where CLAUDE_CODE_MAX_OUTPUT_TOKENS is ignored on Opus 4.6
+// (see github.com/anthropics/claude-code/issues/24159). We set it anyway + the proxy also
+// enforces this via max_tokens override on the API request.
+const EKKOS_MAX_OUTPUT_TOKENS = process.env.EKKOS_MAX_OUTPUT_TOKENS || '128000';
 const proxy_url_1 = require("../utils/proxy-url");
 // Track proxy mode for getEkkosEnv (set by run() based on options)
 let proxyModeEnabled = true;
@@ -315,7 +318,7 @@ let cliSessionName = null;
 let cliSessionId = null;
 /**
  * Get environment with ekkOS enhancements
- * - Sets CLAUDE_CODE_MAX_OUTPUT_TOKENS to 32k for longer responses
+ * - Sets CLAUDE_CODE_MAX_OUTPUT_TOKENS to 128K (API max for Opus/Sonnet 4.6)
  * - Routes API through ekkOS proxy for seamless context eviction (when enabled)
  * - Sets EKKOS_PROXY_MODE to signal JSONL rewriter to disable eviction
  * - Passes session headers for eviction/retrieval context tracking
@@ -332,6 +335,11 @@ function getEkkosEnv() {
         // Native autocompact would compact without ekkOS saving state first, causing knowledge loss.
         // Only ekkOS-wrapped sessions get this; vanilla `claude` keeps autocompact on.
         DISABLE_AUTO_COMPACT: 'true',
+        // Set max output tokens to 128K (Opus 4.6 / Sonnet 4.6 API max).
+        // Note: Claude Code has a known bug where this env var is ignored on Opus 4.6
+        // (github.com/anthropics/claude-code/issues/24159). The proxy also enforces
+        // this by overriding max_tokens on the API request as a fallback.
+        CLAUDE_CODE_MAX_OUTPUT_TOKENS: EKKOS_MAX_OUTPUT_TOKENS,
     };
     /* eslint-enable no-restricted-syntax */
     // Check if proxy is disabled via env var or options
@@ -504,7 +512,9 @@ function resolveClaudePath() {
         // No system Claude found — fall through to ekkOS-managed install
     }
     // ekkOS-managed installation (for pinned versions or no system Claude)
-    if (fs.existsSync(EKKOS_CLAUDE_BIN) && checkClaudeVersion(EKKOS_CLAUDE_BIN)) {
+    // When 'latest', skip the slow `claude --version` subprocess — any version is fine.
+    const ekkosClaudeExists = fs.existsSync(EKKOS_CLAUDE_BIN);
+    if (ekkosClaudeExists && (PINNED_CLAUDE_VERSION === 'latest' || checkClaudeVersion(EKKOS_CLAUDE_BIN))) {
         return EKKOS_CLAUDE_BIN;
     }
     // Auto-install to ekkOS-managed directory
@@ -811,6 +821,9 @@ function writeSessionFiles(sessionId, sessionName) {
  * Launch ekkos run + dashboard in isolated tmux panes (60/40 split)
  */
 function launchWithDashboard(options) {
+    // Prune dead-PID entries from active-sessions.json so the dashboard
+    // (and resolveSessionName) never cross-bind to stale sessions after restart.
+    (0, state_1.getActiveSessions)();
     const tmuxSession = `ekkos-${Date.now().toString(36)}`;
     const launchTime = Date.now();
     // Pre-generate session name so dashboard can start immediately (no polling).
@@ -1043,6 +1056,24 @@ async function run(options) {
     // ══════════════════════════════════════════════════════════════════════════
     (0, state_1.ensureEkkosDir)();
     (0, state_1.clearAutoClearFlag)();
+    // Construct manager early but defer .start() until Claude's first idle prompt
+    // (filesystem scans run only after Claude is fully loaded and waiting for input)
+    let localLivingDocsManager = null;
+    if (process.env.EKKOS_LOCAL_LIVING_DOCS !== '0') {
+        try {
+            localLivingDocsManager = new living_docs_manager_js_1.LocalLivingDocsManager({
+                targetPath: process.cwd(),
+                apiUrl: process.env.EKKOS_API_URL || MEMORY_API_URL,
+                apiKey: (0, state_1.getAuthToken)(),
+                timeZone: process.env.EKKOS_USER_TIMEZONE || Intl.DateTimeFormat().resolvedOptions().timeZone,
+                onLog: message => dlog(message),
+            });
+            // .start() deferred to first idle prompt — see idle detection below (~line 2685)
+        }
+        catch (err) {
+            dlog(`[LivingDocs:Local] Failed to start: ${err.message}`);
+        }
+    }
     // Resolve Claude path
     const rawClaudePath = resolveClaudePath();
     const isNpxMode = rawClaudePath.startsWith('npx:');
@@ -1321,6 +1352,7 @@ async function run(options) {
     // Clear terminal to prevent startup banner artifacts bleeding into Claude Code's Ink TUI
     process.stdout.write('\x1B[2J\x1B[H');
     dlog(`Animation complete. shellReady=${shellReady}, buffered=${bufferedOutput.length} chunks`);
+    // Living docs .start() is deferred further — triggers on first idle prompt (Claude fully loaded)
     // Show loading indicator if Claude is still initializing
     if (shellReady && bufferedOutput.length === 0) {
         process.stdout.write(chalk_1.default.gray('  Connecting to Claude...'));
@@ -1367,6 +1399,7 @@ async function run(options) {
     // Tracks idle→active transitions to print the session banner once per turn
     // ══════════════════════════════════════════════════════════════════════════
     let wasIdle = false; // Start as NOT idle — first idle→active fires after startup
+    let livingDocsStarted = false; // Deferred until Claude's first idle prompt
     let turnCount = 0; // Incremented each time a new turn banner prints
     let lastBannerTime = Date.now(); // Grace period so startup output doesn't trigger banner
     // Stream tailer for mid-turn context capture (must be declared before polling code)
@@ -2324,6 +2357,20 @@ async function run(options) {
         // We check the raw outputBuffer (stripped) so the idle regex fires reliably.
         if (IDLE_PROMPT_REGEX.test(stripAnsi(outputBuffer))) {
             wasIdle = true;
+            // Start living docs on first idle prompt — Claude is fully loaded, won't compete for I/O
+            if (!livingDocsStarted && localLivingDocsManager) {
+                livingDocsStarted = true;
+                // Use setImmediate so the current data handler returns first
+                setImmediate(() => {
+                    try {
+                        localLivingDocsManager.start();
+                        dlog('[LivingDocs:Local] Manager started (first idle prompt)');
+                    }
+                    catch (err) {
+                        dlog(`[LivingDocs:Local] Failed to start: ${err.message}`);
+                    }
+                });
+            }
         }
         // ══════════════════════════════════════════════════════════════════════════
         // ORPHAN TOOL_RESULT DETECTION (LOCAL MODE ONLY)
@@ -2711,6 +2758,7 @@ Use Perplexity for deep research. Be thorough but efficient. Start now.`;
     // Handle PTY exit
     shell.onExit(async ({ exitCode }) => {
         (0, state_1.clearAutoClearFlag)();
+        localLivingDocsManager?.stop();
         stopStreamTailer(); // Stop stream capture
         (0, state_1.unregisterActiveSession)(); // Remove from active sessions registry
         cleanupInstanceFile(instanceId); // Clean up instance file
@@ -2730,6 +2778,7 @@ Use Perplexity for deep research. Be thorough but efficient. Start now.`;
     // Cleanup on exit signals
     const cleanup = () => {
         (0, state_1.clearAutoClearFlag)();
+        localLivingDocsManager?.stop();
         stopStreamTailer(); // Stop stream capture
         (0, state_1.unregisterActiveSession)(); // Remove from active sessions registry
         cleanupInstanceFile(instanceId); // Clean up instance file