@ekkos/cli 1.3.6 → 1.3.8

package/dist/commands/dashboard.js

@@ -69,14 +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-20250620': { 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-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])
@@ -84,24 +94,55 @@ 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 +
         (usage.cache_read_tokens / 1000000) * p.cacheRead);
 }
-function getModelCtxSize(model) {
-    if (model.includes('opus'))
+function getModelCtxSize(model, contextTierHint) {
+    const normalized = (model || '').toLowerCase();
+    if (contextTierHint === '1m')
+        return 1000000;
+    // Claude 4.6 has GA 1M context in Claude Code/API.
+    if (/^claude-(?:opus|sonnet)-4-6(?:$|-)/.test(normalized))
+        return 1000000;
+    // Keep Gemini on the 1M class in dashboard context math.
+    if (normalized.startsWith('gemini-'))
+        return 1000000;
+    if (normalized.includes('1m'))
+        return 1000000;
+    if (normalized.includes('opus'))
         return 200000;
-    if (model.includes('haiku'))
+    if (normalized.includes('haiku'))
         return 200000;
-    if (model.includes('sonnet'))
+    if (normalized.includes('sonnet'))
         return 200000;
     return 200000; // Default Anthropic context
 }
@@ -183,12 +224,18 @@ function parseJsonlFile(jsonlPath, sessionName) {
                 const evictionState = typeof entry.message._ekkos_eviction_state === 'string'
                     ? entry.message._ekkos_eviction_state
                     : (parseCacheHintValue(cacheHint, 'eviction') || 'unknown');
+                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;
                 const cacheCreationTokens = usage.cache_creation_input_tokens || 0;
                 const contextTokens = inputTokens + cacheReadTokens + cacheCreationTokens;
-                const modelCtxSize = getModelCtxSize(model);
+                const modelCtxSize = getModelCtxSize(routedModel, contextTierHint);
                 const contextPct = (contextTokens / modelCtxSize) * 100;
                 const ts = entry.timestamp || new Date().toISOString();
                 if (!startedAt)
@@ -199,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);
@@ -215,6 +270,7 @@ function parseJsonlFile(jsonlPath, sessionName) {
                 const turnData = {
                     turn: turnNum,
                     contextPct,
+                    modelContextSize: modelCtxSize,
                     input: inputTokens,
                     cacheRead: cacheReadTokens,
                     cacheCreate: cacheCreationTokens,
@@ -267,7 +323,9 @@ function parseJsonlFile(jsonlPath, sessionName) {
     const currentContextTokens = lastTurn
         ? lastTurn.input + lastTurn.cacheRead + lastTurn.cacheCreate
         : 0;
-    const modelContextSize = getModelCtxSize(model);
+    const modelContextSize = lastTurn
+        ? lastTurn.modelContextSize
+        : getModelCtxSize(model);
     return {
         sessionName,
         model,
@@ -369,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
@@ -1100,8 +1171,8 @@ async function launchDashboard(initialSessionName, initialJsonlPath, refreshMs,
         try {
             const ctxPct = Math.min(data.currentContextPct, 100);
             const ctxColor = ctxPct < 50 ? 'green' : ctxPct < 80 ? 'yellow' : 'red';
-            const tokensK = Math.round(data.currentContextTokens / 1000);
-            const maxK = Math.round(data.modelContextSize / 1000);
+            const tokensLabel = fmtK(data.currentContextTokens);
+            const maxLabel = fmtK(data.modelContextSize);
             // Visual progress bar (fills available width)
             const contextInnerWidth = Math.max(10, contextBox.width - 2);
             // Extend bar slightly closer to mascot while keeping a small visual gap.
@@ -1121,7 +1192,7 @@ async function launchDashboard(initialSessionName, initialJsonlPath, refreshMs,
             const hitColor = data.cacheHitRate >= 80 ? 'green' : data.cacheHitRate >= 50 ? 'yellow' : 'red';
             const cappedMax = Math.min(data.maxContextPct, 100);
             contextBox.setContent(` ${bar}\n` +
-                ` {${ctxColor}-fg}${ctxPct.toFixed(0)}%{/${ctxColor}-fg} ${tokensK}K/${maxK}K` +
+                ` {${ctxColor}-fg}${ctxPct.toFixed(0)}%{/${ctxColor}-fg} ${tokensLabel}/${maxLabel}` +
                 `  {white-fg}Input{/white-fg} $${breakdown.input.toFixed(2)}` +
                 `  {green-fg}Read{/green-fg} $${breakdown.read.toFixed(2)}` +
                 `  {yellow-fg}Write{/yellow-fg} $${breakdown.write.toFixed(2)}` +
@@ -1766,7 +1837,7 @@ async function launchDashboard(initialSessionName, initialJsonlPath, refreshMs,
                 const tier = cachedProfile.organization?.rate_limit_tier ?? 'unknown';
                 const status = cachedProfile.organization?.subscription_status ?? 'unknown';
                 const extraUsage = cachedProfile.organization?.has_extra_usage_enabled
-                    ? '  {green-fg}extra usage on{/green-fg}'
+                    ? '  {green-fg}extra usage on{/green-fg} {gray-fg}(legacy >200k only){/gray-fg}'
                     : '';
                 line2 =
                     ` {bold}Plan:{/bold} ${plan}  {bold}Tier:{/bold} ${tier}  {bold}Sub:{/bold} ${status}${extraUsage}`;
@@ -2146,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,11 +177,22 @@ 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
+    // We look for 'gemini' in process.argv and pass everything after it.
+    // If the user did `ekkos gemini -m gemini-3.1-pro-preview`, we want to pass `-m gemini-3.1-pro-preview`
+    let extraArgs = [];
+    const geminiIdx = process.argv.indexOf('gemini');
+    if (geminiIdx !== -1) {
+        extraArgs = process.argv.slice(geminiIdx + 1).filter(a => {
+            // Filter out ekkos wrapper options
+            return !['--skip-proxy', '-v', '--verbose'].includes(a) && !(a === '-s' || a === '--session' || process.argv[process.argv.indexOf(a) - 1] === '-s' || process.argv[process.argv.indexOf(a) - 1] === '--session');
+        });
+    }
     // Spawn Gemini CLI — stdio: inherit for full terminal passthrough
-    const child = (0, child_process_1.spawn)(geminiPath, [], {
+    const child = (0, child_process_1.spawn)(geminiPath, extraArgs, {
         stdio: 'inherit',
         env,
         cwd: process.cwd(),

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);
+    });
+}