@ekkos/cli 1.3.5 → 1.3.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ekkOS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/commands/dashboard.js

@@ -71,7 +71,9 @@ const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12
 // ── Pricing ──
 // Pricing per MTok from https://platform.claude.com/docs/en/about-claude/pricing
 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-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 },
@@ -96,12 +98,23 @@ function calculateTurnCost(model, usage) {
         (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 +196,15 @@ 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 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)
@@ -215,6 +231,7 @@ function parseJsonlFile(jsonlPath, sessionName) {
                 const turnData = {
                     turn: turnNum,
                     contextPct,
+                    modelContextSize: modelCtxSize,
                     input: inputTokens,
                     cacheRead: cacheReadTokens,
                     cacheCreate: cacheCreationTokens,
@@ -267,7 +284,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,
@@ -1100,8 +1119,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 +1140,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 +1785,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}`;

package/dist/commands/gemini.js

@@ -154,8 +154,19 @@ async function gemini(options = {}) {
         console.log(chalk_1.default.cyan('  🧠 ekkOS_Continuum Loaded!'));
     }
     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/index.js

@@ -59,6 +59,7 @@ const scan_1 = require("./commands/scan");
 const chalk_1 = __importDefault(require("chalk"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
 // Get version from package.json (CommonJS compatible)
 const pkgPath = path.resolve(__dirname, '../package.json');
 const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
@@ -75,16 +76,12 @@ commander_1.program
     .addHelpText('after', [
     '',
     chalk_1.default.cyan.bold('Examples:'),
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos')}                              ${chalk_1.default.gray('Start Claude Code with ekkOS memory (default: run)')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos init')}                         ${chalk_1.default.gray('First-time setup — authenticate + configure your IDE')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos scan')}                         ${chalk_1.default.gray('Scan repo structure and seed system registry')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos scan --compile')}               ${chalk_1.default.gray('Scan, seed, and trigger compile pass')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos run --dashboard')}              ${chalk_1.default.gray('Launch with live usage dashboard (tmux split)')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos run -b')}                       ${chalk_1.default.gray('Launch with bypass permissions mode')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos doctor --fix')}                 ${chalk_1.default.gray('Check and auto-fix system prerequisites')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos usage daily')}                  ${chalk_1.default.gray("View today's token usage and costs")}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos gemini')}                       ${chalk_1.default.gray('Launch Gemini CLI with ekkOS memory proxy')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos swarm launch -t "build X"')}    ${chalk_1.default.gray('Launch parallel workers on a task')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos')}                              ${chalk_1.default.gray('Start Claude Code with ekkOS memory (default)')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos codex')}                        ${chalk_1.default.gray('Start Codex (OpenAI) mode')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos daemon start')}                 ${chalk_1.default.gray('Start the background mobile sync service')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos connect gemini')}               ${chalk_1.default.gray('Securely store your Gemini API key in the cloud')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos agent create --path ./repo')}   ${chalk_1.default.gray('Spawn a headless remote agent in a directory')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos run --dashboard')}              ${chalk_1.default.gray('Launch Claude with live usage dashboard')}`,
     '',
     chalk_1.default.gray('  Run ') + chalk_1.default.white('ekkos <command> --help') + chalk_1.default.gray(' for detailed options on any command.'),
     '',
@@ -152,38 +149,48 @@ commander_1.program
                 title: 'Getting Started',
                 icon: '▸',
                 commands: [
-                    { name: 'init', desc: 'Authenticate and configure your IDE (Claude, Cursor, Windsurf)' },
+                    { name: 'init', desc: 'First-time setup — authenticate and configure IDEs' },
                     { name: 'scan', desc: 'Scan repo structure and seed ekkOS system registry' },
-                    { name: 'status', desc: 'Show memory status and installation info' },
-                    { name: 'test', desc: 'Test connection to ekkOS memory API' },
-                    { name: 'doctor', desc: 'Check system prerequisites (Node, PTY, Claude, MCP)' },
+                    { name: 'status', desc: 'Show overall system status (Memory, Sync Daemon, Auth)' },
+                    { name: 'doctor', desc: 'Check system prerequisites and fix runaway processes' },
                 ],
             },
             {
-                title: 'Running',
+                title: 'Launch Agents (Local + Mobile Synced)',
                 icon: '▸',
                 commands: [
-                    { name: 'run', desc: 'Launch Claude Code with ekkOS memory', note: 'default' },
-                    { name: 'test-claude', desc: 'Launch Claude with proxy only (no PTY) for debugging' },
-                    { name: 'sessions', desc: 'List active Claude Code sessions' },
-                    { name: 'claw', desc: 'OpenClaw integration status and upgrade controls' },
+                    { name: 'run', desc: 'Launch Claude Code with memory and mobile control', note: 'default' },
+                    { name: 'codex', desc: 'Launch Codex (OpenAI) with mobile control' },
+                    { name: 'gemini', desc: 'Launch Gemini mode (ACP) with mobile control' },
+                    { name: 'acp', desc: 'Launch a generic ACP-compatible agent' },
                 ],
             },
             {
-                title: 'Monitoring & Usage',
+                title: 'Mobile Sync & Cloud (Synk)',
                 icon: '▸',
                 commands: [
-                    { name: 'usage', desc: 'Token usage and cost tracking (daily, weekly, monthly, session)' },
-                    { name: 'dashboard', desc: 'Live TUI dashboard for session monitoring' },
-                    { name: 'stream', desc: 'Stream capture status and management' },
-                    { name: 'hooks', desc: '[DEPRECATED] Hooks no longer needed — use `ekkos run`' },
+                    { name: 'daemon', desc: 'Manage background mobile sync service (start, stop, status)' },
+                    { name: 'connect', desc: 'Securely store AI vendor API keys in the cloud' },
+                    { name: 'sandbox', desc: 'Configure OS-level sandboxing for agent execution' },
+                    { name: 'notify', desc: 'Send push notifications to your Synk mobile app' },
                 ],
             },
             {
-                title: 'Swarm (Multi-Agent)',
+                title: 'Headless Agents (Remote Control)',
                 icon: '▸',
                 commands: [
-                    { name: 'swarm', desc: 'Parallel workers, Q-learning routing, swarm dashboard' },
+                    { name: 'agent', desc: 'Manage remote headless agents (create, list, stop)' },
+                    { name: 'swarm', desc: 'Parallel workers, Q-learning routing, and swarm dashboard' },
+                ],
+            },
+            {
+                title: 'Monitoring & Usage',
+                icon: '▸',
+                commands: [
+                    { name: 'auth', desc: 'Manage authentication for Memory, Agents, and Mobile App' },
+                    { name: 'usage', desc: 'Token usage and cost tracking (daily, weekly, monthly, session)' },
+                    { name: 'dashboard', desc: 'Live TUI dashboard for session monitoring' },
+                    { name: 'sessions', desc: 'List active local CLI sessions' },
                 ],
             },
         ];
@@ -501,6 +508,74 @@ swarmCmd
     (0, swarm_setup_1.swarmSetup)();
 });
 swarmCmd.addCommand(swarm_dashboard_1.swarmDashboardCommand);
+// --- Remote & Agent Wrapper Helpers ---
+function runRemoteCommand(command, ...args) {
+    const isAgent = command === 'agent';
+    const pkgName = isAgent ? 'ekkos-agent' : 'ekkos-remote';
+    const binName = isAgent ? 'ekkos-agent.mjs' : 'ekkos-synk.mjs';
+    // Try resolving local monorepo first
+    let binPath = path.resolve(__dirname, '../../' + pkgName + '/bin/' + binName);
+    // If we are installed globally (dist folder structure), resolve relatively
+    if (!fs.existsSync(binPath)) {
+        try {
+            const globalPath = require.resolve('@ekkos/' + (isAgent ? 'agent' : 'remote') + '/package.json');
+            binPath = path.join(path.dirname(globalPath), 'bin', binName);
+        }
+        catch (e) {
+            // Fallback relative to current dist
+            binPath = path.resolve(__dirname, '../../' + pkgName + '/bin/' + binName);
+        }
+    }
+    const p = (0, child_process_1.spawn)('node', [binPath, ...args], {
+        stdio: 'inherit',
+        env: process.env
+    });
+    p.on('exit', (code) => {
+        process.exit(code || 0);
+    });
+}
+// Mobile Sync & Cloud (Synk) Commands
+commander_1.program
+    .command('auth')
+    .description('Manage authentication for Memory, Agents, and Mobile App')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'auth', ...process.argv.slice(3)));
+commander_1.program
+    .command('codex')
+    .description('Launch Codex (OpenAI) with mobile control')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'codex', ...process.argv.slice(3)));
+commander_1.program
+    .command('acp')
+    .description('Launch a generic ACP-compatible agent')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'acp', ...process.argv.slice(3)));
+commander_1.program
+    .command('daemon')
+    .description('Manage background mobile sync service (start, stop, status)')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'daemon', ...process.argv.slice(3)));
+commander_1.program
+    .command('connect')
+    .description('Securely store AI vendor API keys in the cloud')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'connect', ...process.argv.slice(3)));
+commander_1.program
+    .command('sandbox')
+    .description('Configure OS-level sandboxing for agent execution')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'sandbox', ...process.argv.slice(3)));
+commander_1.program
+    .command('notify')
+    .description('Send push notifications to your Synk mobile app')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'notify', ...process.argv.slice(3)));
+// Headless Agents (Remote Control)
+commander_1.program
+    .command('agent')
+    .description('Manage remote headless agents (create, list, stop)')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('agent', ...process.argv.slice(3)));
 // Handle `-help` (single dash) — rewrite to `--help` for Commander compatibility
 const helpIdx = process.argv.indexOf('-help');
 if (helpIdx !== -1) {

package/dist/lib/usage-parser.js

@@ -485,7 +485,7 @@ function calculateContextPercentage(usage) {
  */
 async function fetchPatternMetrics(sessionId) {
     try {
-        const response = await fetch(`http://localhost:3001/api/v1/session/stats?session_id=${sessionId}`, {
+        const response = await fetch(`${process.env.EKKOS_MCP_URL || 'https://mcp.ekkos.dev'}/api/v1/session/stats?session_id=${sessionId}`, {
             method: 'GET',
             headers: {
                 'Content-Type': 'application/json',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekkos/cli",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "description": "Setup ekkOS memory for AI coding assistants (Claude Code, Cursor, Windsurf)",
   "main": "dist/index.js",
   "bin": {
@@ -8,13 +8,6 @@
     "cli": "dist/index.js",
     "ekkos-capture": "dist/cache/capture.js"
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "prepack": "node scripts/build-templates.js prepack",
-    "postpack": "node scripts/build-templates.js postpack",
-    "prepublishOnly": "npm run build"
-  },
   "keywords": [
     "ekkos",
     "ai",
@@ -28,7 +21,6 @@
   "author": "ekkOS",
   "license": "MIT",
   "dependencies": {
-    "@ekkos/prometheus": "workspace:*",
     "@supabase/supabase-js": "^2.39.8",
     "axios": "^1.7.0",
     "blessed": "^0.1.81",
@@ -56,7 +48,12 @@
   },
   "files": [
     "dist",
+    "!dist/cron",
     "templates/CLAUDE.md",
     "templates/skills"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts"
+  }
+}

package/dist/cron/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * ekkOS Cron Jobs
- * ================
- *
- * Background jobs for ekkOS maintenance and evolution.
- */
-export { evaluatePromotions, queryPatternStats, writePatchConfig, type PromoterConfig, type PromotionResult, type PromotedPatchConfig, type PromotedPattern, } from './promoter.js';

package/dist/cron/index.js

@@ -1,13 +0,0 @@
-"use strict";
-/**
- * ekkOS Cron Jobs
- * ================
- *
- * Background jobs for ekkOS maintenance and evolution.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.writePatchConfig = exports.queryPatternStats = exports.evaluatePromotions = void 0;
-var promoter_js_1 = require("./promoter.js");
-Object.defineProperty(exports, "evaluatePromotions", { enumerable: true, get: function () { return promoter_js_1.evaluatePromotions; } });
-Object.defineProperty(exports, "queryPatternStats", { enumerable: true, get: function () { return promoter_js_1.queryPatternStats; } });
-Object.defineProperty(exports, "writePatchConfig", { enumerable: true, get: function () { return promoter_js_1.writePatchConfig; } });

package/dist/cron/promoter.d.ts

@@ -1,70 +0,0 @@
-#!/usr/bin/env node
-/**
- * ekkOS PROMETHEUS Pattern Promoter
- * ==================================
- *
- * Daily cron job that evaluates patterns for promotion to constitutional memory.
- *
- * Constitutional patterns are injected into the system prompt via @ekkos/patch,
- * making them "instincts" that don't require retrieval.
- *
- * Promotion Criteria (default):
- * - Success rate ≥ 85%
- * - Applications ≥ 5
- * - Skip rate ≤ 10%
- * - Confidence ≥ 70%
- * - Used within last 30 days
- * - Used in ≥ 2 unique sessions
- *
- * Usage:
- *   npx ekkos-promote                  # Run promotion evaluation
- *   npx ekkos-promote --dry-run        # Preview without applying changes
- *   npx ekkos-promote --user <uuid>    # Promote for specific user
- *
- * Schedule via launchd (macOS) or cron:
- *   0 6 * * * /path/to/node /path/to/ekkos-promote
- */
-import { SupabaseClient } from '@supabase/supabase-js';
-import { type PatternStats } from '@ekkos/prometheus';
-interface PromoterConfig {
-    supabaseUrl: string;
-    supabaseKey: string;
-    dryRun: boolean;
-    userId?: string;
-    patchConfigPath: string;
-    verbose: boolean;
-}
-interface PromotionResult {
-    evaluated: number;
-    promoted: number;
-    demoted: number;
-    patterns: Array<{
-        patternId: string;
-        title: string;
-        action: 'promoted' | 'demoted' | 'unchanged';
-        score: number;
-        reason?: string;
-    }>;
-    patchConfig?: PromotedPatchConfig;
-}
-interface PromotedPattern {
-    id: string;
-    title: string;
-    problem: string;
-    solution: string;
-    promotedAt: string;
-    successRate: number;
-    appliedCount: number;
-    tags?: string[];
-}
-interface PromotedPatchConfig {
-    version: string;
-    generatedAt: string;
-    promotedPatterns: PromotedPattern[];
-    totalPatterns: number;
-}
-declare function queryPatternStats(supabase: SupabaseClient, userId?: string): Promise<PatternStats[]>;
-declare function evaluatePromotions(supabase: SupabaseClient, config: PromoterConfig): Promise<PromotionResult>;
-declare function writePatchConfig(config: PromotedPatchConfig, outputPath: string): void;
-export { evaluatePromotions, queryPatternStats, writePatchConfig };
-export type { PromoterConfig, PromotionResult, PromotedPatchConfig, PromotedPattern };

package/dist/cron/promoter.js

@@ -1,403 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * ekkOS PROMETHEUS Pattern Promoter
- * ==================================
- *
- * Daily cron job that evaluates patterns for promotion to constitutional memory.
- *
- * Constitutional patterns are injected into the system prompt via @ekkos/patch,
- * making them "instincts" that don't require retrieval.
- *
- * Promotion Criteria (default):
- * - Success rate ≥ 85%
- * - Applications ≥ 5
- * - Skip rate ≤ 10%
- * - Confidence ≥ 70%
- * - Used within last 30 days
- * - Used in ≥ 2 unique sessions
- *
- * Usage:
- *   npx ekkos-promote                  # Run promotion evaluation
- *   npx ekkos-promote --dry-run        # Preview without applying changes
- *   npx ekkos-promote --user <uuid>    # Promote for specific user
- *
- * Schedule via launchd (macOS) or cron:
- *   0 6 * * * /path/to/node /path/to/ekkos-promote
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.evaluatePromotions = evaluatePromotions;
-exports.queryPatternStats = queryPatternStats;
-exports.writePatchConfig = writePatchConfig;
-const supabase_js_1 = require("@supabase/supabase-js");
-const prometheus_1 = require("@ekkos/prometheus");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-// ═══════════════════════════════════════════════════════════════════════════
-// Pattern Stats Query
-// ═══════════════════════════════════════════════════════════════════════════
-async function queryPatternStats(supabase, userId) {
-    // Query patterns with their application stats
-    let query = supabase
-        .from('patterns')
-        .select(`
-      pattern_id,
-      title,
-      content,
-      success_rate,
-      applied_count,
-      confidence_score,
-      created_at,
-      updated_at,
-      tags,
-      user_id
-    `)
-        .eq('quarantined', false)
-        .gte('applied_count', 1); // Only consider applied patterns
-    if (userId) {
-        query = query.eq('user_id', userId);
-    }
-    const { data: patterns, error } = await query;
-    if (error) {
-        throw new Error(`Failed to query patterns: ${error.message}`);
-    }
-    if (!patterns || patterns.length === 0) {
-        return [];
-    }
-    // Get application details for skip rate and session count
-    const patternIds = patterns.map(p => p.pattern_id);
-    const { data: applications } = await supabase
-        .from('pattern_applications')
-        .select('pattern_id, outcome_success, created_at, user_id')
-        .in('pattern_id', patternIds);
-    const { data: skips } = await supabase
-        .from('pattern_skips')
-        .select('pattern_id')
-        .in('pattern_id', patternIds);
-    // Aggregate stats per pattern
-    const appsByPattern = new Map();
-    const skipsByPattern = new Map();
-    for (const app of applications || []) {
-        if (!appsByPattern.has(app.pattern_id)) {
-            appsByPattern.set(app.pattern_id, []);
-        }
-        appsByPattern.get(app.pattern_id).push(app);
-    }
-    for (const skip of skips || []) {
-        const count = skipsByPattern.get(skip.pattern_id) || 0;
-        skipsByPattern.set(skip.pattern_id, count + 1);
-    }
-    // Build PatternStats for each pattern
-    return patterns.map(p => {
-        const apps = appsByPattern.get(p.pattern_id) || [];
-        const skipCount = skipsByPattern.get(p.pattern_id) || 0;
-        const successCount = apps.filter(a => a.outcome_success === true).length;
-        const failureCount = apps.filter(a => a.outcome_success === false).length;
-        const totalApplications = successCount + failureCount;
-        // Count unique sessions (using created_at date as proxy)
-        const uniqueDates = new Set(apps.map(a => new Date(a.created_at).toISOString().split('T')[0]));
-        const stats = {
-            patternId: p.pattern_id,
-            title: p.title || 'Untitled',
-            successCount,
-            failureCount,
-            skipCount,
-            totalApplications: totalApplications || p.applied_count || 0,
-            uniqueSessions: uniqueDates.size,
-            firstApplied: new Date(p.created_at),
-            lastApplied: new Date(p.updated_at || p.created_at),
-            currentConfidence: p.confidence_score || p.success_rate || 0.5,
-            tags: p.tags,
-        };
-        return stats;
-    });
-}
-// ═══════════════════════════════════════════════════════════════════════════
-// Promotion Logic
-// ═══════════════════════════════════════════════════════════════════════════
-async function evaluatePromotions(supabase, config) {
-    const result = {
-        evaluated: 0,
-        promoted: 0,
-        demoted: 0,
-        patterns: [],
-    };
-    // Get pattern stats
-    const patternStats = await queryPatternStats(supabase, config.userId);
-    result.evaluated = patternStats.length;
-    if (config.verbose) {
-        console.log(`[PROMOTER] Evaluating ${patternStats.length} patterns...`);
-    }
-    // Get currently promoted patterns (from promoted_patterns table or metadata)
-    const { data: currentlyPromoted } = await supabase
-        .from('patterns')
-        .select('pattern_id')
-        .eq('evolution_stage', 'constitutional');
-    const promotedSet = new Set((currentlyPromoted || []).map(p => p.pattern_id));
-    const promotedPatterns = [];
-    // Evaluate each pattern
-    for (const stats of patternStats) {
-        const evaluation = prometheus_1.promotionEvaluator.evaluate(stats);
-        const wasPromoted = promotedSet.has(stats.patternId);
-        if (evaluation.eligible && !wasPromoted) {
-            // PROMOTE: Pattern meets criteria and wasn't promoted before
-            result.promoted++;
-            result.patterns.push({
-                patternId: stats.patternId,
-                title: stats.title,
-                action: 'promoted',
-                score: evaluation.score,
-            });
-            if (!config.dryRun) {
-                // Update pattern to constitutional
-                await supabase
-                    .from('patterns')
-                    .update({
-                    evolution_stage: 'constitutional',
-                    promoted_at: new Date().toISOString(),
-                })
-                    .eq('pattern_id', stats.patternId);
-                // Emit PATTERN_PROMOTED event
-                prometheus_1.learningEvents.emitPatternPromoted({
-                    id: stats.patternId,
-                    title: stats.title,
-                    confidenceBefore: stats.currentConfidence,
-                    confidenceAfter: 1.0,
-                    tier: 'constitutional',
-                    successRate: stats.successCount / Math.max(stats.totalApplications, 1),
-                    appliedCount: stats.totalApplications,
-                }, {
-                    daysInEpisodic: Math.floor((Date.now() - stats.firstApplied.getTime()) / (1000 * 60 * 60 * 24)),
-                    totalApplications: stats.totalApplications,
-                    finalSuccessRate: stats.successCount / Math.max(stats.totalApplications, 1),
-                });
-            }
-            // Fetch full pattern for patch config
-            const { data: fullPattern } = await supabase
-                .from('patterns')
-                .select('content, tags')
-                .eq('pattern_id', stats.patternId)
-                .single();
-            if (fullPattern) {
-                // Parse problem/solution from content
-                const content = fullPattern.content || '';
-                const problemMatch = content.match(/## Problem\n([\s\S]*?)(?=\n## Solution|$)/);
-                const solutionMatch = content.match(/## Solution\n([\s\S]*?)$/);
-                promotedPatterns.push({
-                    id: stats.patternId,
-                    title: stats.title,
-                    problem: problemMatch?.[1]?.trim() || 'N/A',
-                    solution: solutionMatch?.[1]?.trim() || content,
-                    promotedAt: new Date().toISOString(),
-                    successRate: stats.successCount / Math.max(stats.totalApplications, 1),
-                    appliedCount: stats.totalApplications,
-                    tags: fullPattern.tags,
-                });
-            }
-            if (config.verbose) {
-                console.log(`  ✓ PROMOTE: "${stats.title}" (score: ${evaluation.score.toFixed(2)})`);
-            }
-        }
-        else if (!evaluation.eligible && wasPromoted) {
-            // DEMOTE: Pattern no longer meets criteria
-            result.demoted++;
-            // Find the main blocker for demotion reason
-            const reason = evaluation.blockers[0]?.includes('success')
-                ? 'low_success_rate'
-                : evaluation.blockers[0]?.includes('skip')
-                    ? 'high_skip_rate'
-                    : 'outdated';
-            result.patterns.push({
-                patternId: stats.patternId,
-                title: stats.title,
-                action: 'demoted',
-                score: evaluation.score,
-                reason,
-            });
-            if (!config.dryRun) {
-                // Update pattern back to episodic
-                await supabase
-                    .from('patterns')
-                    .update({
-                    evolution_stage: 'episodic',
-                    demoted_at: new Date().toISOString(),
-                })
-                    .eq('pattern_id', stats.patternId);
-                // Emit PATTERN_DEMOTED event
-                prometheus_1.learningEvents.emitPatternDemoted({
-                    id: stats.patternId,
-                    title: stats.title,
-                    confidenceBefore: 1.0,
-                    confidenceAfter: stats.currentConfidence,
-                    tier: 'episodic',
-                    successRate: stats.successCount / Math.max(stats.totalApplications, 1),
-                    appliedCount: stats.totalApplications,
-                }, reason);
-            }
-            if (config.verbose) {
-                console.log(`  ✗ DEMOTE: "${stats.title}" (${reason})`);
-            }
-        }
-        else {
-            result.patterns.push({
-                patternId: stats.patternId,
-                title: stats.title,
-                action: 'unchanged',
-                score: evaluation.score,
-            });
-        }
-    }
-    // Also include patterns that are already promoted and still eligible
-    for (const stats of patternStats) {
-        const evaluation = prometheus_1.promotionEvaluator.evaluate(stats);
-        if (evaluation.eligible && promotedSet.has(stats.patternId)) {
-            // Fetch and include in patch config
-            const { data: fullPattern } = await supabase
-                .from('patterns')
-                .select('content, tags')
-                .eq('pattern_id', stats.patternId)
-                .single();
-            if (fullPattern) {
-                const content = fullPattern.content || '';
-                const problemMatch = content.match(/## Problem\n([\s\S]*?)(?=\n## Solution|$)/);
-                const solutionMatch = content.match(/## Solution\n([\s\S]*?)$/);
-                promotedPatterns.push({
-                    id: stats.patternId,
-                    title: stats.title,
-                    problem: problemMatch?.[1]?.trim() || 'N/A',
-                    solution: solutionMatch?.[1]?.trim() || content,
-                    promotedAt: new Date().toISOString(),
-                    successRate: stats.successCount / Math.max(stats.totalApplications, 1),
-                    appliedCount: stats.totalApplications,
-                    tags: fullPattern.tags,
-                });
-            }
-        }
-    }
-    // Generate patch config
-    result.patchConfig = {
-        version: '1.0.0',
-        generatedAt: new Date().toISOString(),
-        promotedPatterns,
-        totalPatterns: promotedPatterns.length,
-    };
-    return result;
-}
-// ═══════════════════════════════════════════════════════════════════════════
-// Patch Config Generation
-// ═══════════════════════════════════════════════════════════════════════════
-function writePatchConfig(config, outputPath) {
-    const dir = path.dirname(outputPath);
-    if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-    }
-    fs.writeFileSync(outputPath, JSON.stringify(config, null, 2));
-    console.log(`[PROMOTER] Wrote patch config to: ${outputPath}`);
-}
-// ═══════════════════════════════════════════════════════════════════════════
-// CLI Entry Point
-// ═══════════════════════════════════════════════════════════════════════════
-async function main() {
-    const args = process.argv.slice(2);
-    const config = {
-        supabaseUrl: process.env.SUPABASE_URL || process.env.NEXT_PUBLIC_SUPABASE_URL || '',
-        supabaseKey: process.env.SUPABASE_SECRET_KEY || process.env.SUPABASE_SERVICE_ROLE_KEY || '',
-        dryRun: args.includes('--dry-run'),
-        userId: args.includes('--user') ? args[args.indexOf('--user') + 1] : undefined,
-        patchConfigPath: path.join(os.homedir(), '.ekkos', 'promoted-patterns.json'),
-        verbose: args.includes('--verbose') || args.includes('-v'),
-    };
-    // Allow custom output path
-    if (args.includes('--output')) {
-        config.patchConfigPath = args[args.indexOf('--output') + 1];
-    }
-    console.log('═══════════════════════════════════════════════════════════════');
-    console.log('  ekkOS PROMETHEUS Pattern Promoter');
-    console.log('═══════════════════════════════════════════════════════════════');
-    console.log(`  Mode: ${config.dryRun ? 'DRY RUN (no changes)' : 'LIVE'}`);
-    console.log(`  User: ${config.userId || 'All users'}`);
-    console.log(`  Output: ${config.patchConfigPath}`);
-    console.log('═══════════════════════════════════════════════════════════════');
-    console.log('');
-    if (!config.supabaseUrl || !config.supabaseKey) {
-        console.error('[ERROR] Missing SUPABASE_URL or SUPABASE_SECRET_KEY environment variables');
-        process.exit(1);
-    }
-    const supabase = (0, supabase_js_1.createClient)(config.supabaseUrl, config.supabaseKey);
-    try {
-        const result = await evaluatePromotions(supabase, config);
-        console.log('');
-        console.log('═══════════════════════════════════════════════════════════════');
-        console.log('  Results');
-        console.log('═══════════════════════════════════════════════════════════════');
-        console.log(`  Patterns evaluated: ${result.evaluated}`);
-        console.log(`  Promoted: ${result.promoted}`);
-        console.log(`  Demoted: ${result.demoted}`);
-        console.log(`  Constitutional total: ${result.patchConfig?.totalPatterns || 0}`);
-        console.log('═══════════════════════════════════════════════════════════════');
-        // Write patch config
-        if (!config.dryRun && result.patchConfig) {
-            writePatchConfig(result.patchConfig, config.patchConfigPath);
-        }
-        else if (config.dryRun && result.patchConfig) {
-            console.log('\n[DRY RUN] Would write patch config with:');
-            console.log(`  - ${result.patchConfig.totalPatterns} promoted patterns`);
-        }
-        // Summary of changes
-        if (result.patterns.filter(p => p.action !== 'unchanged').length > 0) {
-            console.log('\nChanges:');
-            for (const p of result.patterns) {
-                if (p.action === 'promoted') {
-                    console.log(`  🎓 PROMOTED: "${p.title}" (score: ${p.score.toFixed(2)})`);
-                }
-                else if (p.action === 'demoted') {
-                    console.log(`  ⬇️  DEMOTED: "${p.title}" (${p.reason})`);
-                }
-            }
-        }
-        else {
-            console.log('\nNo promotion changes needed.');
-        }
-        console.log('\n✓ Promotion evaluation complete');
-    }
-    catch (error) {
-        console.error('[ERROR]', error);
-        process.exit(1);
-    }
-}
-// Run if executed directly
-main().catch(console.error);