codymaster 4.8.0 → 7.0.0

package/dist/cli/commands/dashboard.js

@@ -14,7 +14,7 @@ function registerDashboardCommands(program) {
     program
         .command('dashboard [cmd]')
         .alias('dash')
-        .description('Dashboard server (start|stop|status|open)')
+        .description('Dashboard server (start|stop|status|open|tail)')
         .option('-p, --port <port>', 'Port number', String(data_1.DEFAULT_PORT))
         .action((cmd, opts) => {
         const port = parseInt(opts.port) || data_1.DEFAULT_PORT;
@@ -40,10 +40,84 @@ function registerDashboardCommands(program) {
             case 'url':
                 console.log(`http://localhost:${port}`);
                 break;
-            default: console.log((0, box_1.renderResult)('error', `Unknown: ${cmd}`, [(0, theme_1.dim)('Available: start, stop, status, open, url')]));
+            case 'tail':
+                tailDashboard(port);
+                break;
+            default: console.log((0, box_1.renderResult)('error', `Unknown: ${cmd}`, [(0, theme_1.dim)('Available: start, stop, status, open, url, tail')]));
         }
     });
 }
+function tailDashboard(port) {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const chalk = require('chalk');
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const WebSocket = require('ws');
+    const url = `ws://127.0.0.1:${port}/ws`;
+    console.log((0, theme_1.dim)(`Connecting to ${url} ...`));
+    let ws;
+    try {
+        ws = new WebSocket(url);
+    }
+    catch (err) {
+        console.log((0, box_1.renderResult)('error', `Cannot connect: ${err.message}`, [(0, theme_1.dim)('Is the dashboard running? cm dashboard start')]));
+        process.exit(1);
+    }
+    ws.on('open', () => {
+        console.log((0, theme_1.brand)('✓ Connected — listening for all events. Ctrl+C to stop.\n'));
+        // Subscribe to all projects (no filter)
+        ws.send(JSON.stringify({ action: 'unsubscribe' }));
+    });
+    ws.on('message', (raw) => {
+        var _a, _b;
+        try {
+            const msg = JSON.parse(raw.toString());
+            if (msg.type === 'subscribed' || msg.type === 'unsubscribed')
+                return;
+            const ts = new Date().toLocaleTimeString();
+            const prefix = chalk.gray(`[${ts}]`);
+            if (msg.type && msg.type.startsWith('task.')) {
+                const typeColor = msg.type === 'task.created' ? chalk.green
+                    : msg.type === 'task.deleted' ? chalk.red
+                        : msg.type === 'task.transitioned' ? chalk.yellow
+                            : chalk.cyan;
+                console.log(`${prefix} ${typeColor(msg.type.padEnd(20))} task=${chalk.white(((_a = msg.taskId) === null || _a === void 0 ? void 0 : _a.substring(0, 8)) || '?')} project=${chalk.gray(((_b = msg.projectId) === null || _b === void 0 ? void 0 : _b.substring(0, 8)) || '?')}`);
+                if (msg.data) {
+                    if (msg.data.from && msg.data.to) {
+                        console.log(`${chalk.gray('  └─')} ${msg.data.from} → ${msg.data.to}`);
+                    }
+                    else if (msg.data.title) {
+                        console.log(`${chalk.gray('  └─')} ${msg.data.title}`);
+                    }
+                }
+            }
+            else if (msg.type === 'activity.added') {
+                const a = msg.activity || {};
+                console.log(`${prefix} ${chalk.magenta('activity.added'.padEnd(20))} ${a.type || '?'}: ${chalk.white(a.message || '')}`);
+            }
+            else if (msg.type === 'agent.heartbeat') {
+                console.log(`${prefix} ${chalk.blue('agent.heartbeat'.padEnd(20))} tasks=${(msg.runningTaskIds || []).length}`);
+            }
+            else {
+                console.log(`${prefix} ${chalk.gray(JSON.stringify(msg).substring(0, 120))}`);
+            }
+        }
+        catch (_c) {
+            // ignore parse errors
+        }
+    });
+    ws.on('error', (err) => {
+        console.log((0, box_1.renderResult)('error', `WebSocket error: ${err.message}`));
+    });
+    ws.on('close', () => {
+        console.log((0, box_1.renderResult)('warning', 'Connection closed.'));
+        process.exit(0);
+    });
+    process.on('SIGINT', () => {
+        console.log((0, theme_1.dim)('\nStopped.'));
+        ws.close();
+        process.exit(0);
+    });
+}
 function isDashboardRunning() {
     try {
         if (!fs_1.default.existsSync(data_1.PID_FILE))

package/dist/cli/commands/engineering.js

@@ -1,4 +1,37 @@
 "use strict";
+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;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -25,17 +58,21 @@ const second_opinion_providers_1 = require("../../second-opinion-providers");
 const sprint_pipeline_1 = require("../../sprint-pipeline");
 const retro_summary_1 = require("../../retro-summary");
 const cm_suggest_1 = require("../../cm-suggest");
+const storage_backend_1 = require("../../storage-backend");
+const advisory_report_1 = require("../../advisory-report");
+const advisory_handoff_1 = require("../../advisory-handoff");
 function projectPath(opt) {
     return path_1.default.resolve(opt || process.cwd());
 }
 function registerEngineeringCommands(program) {
-    const browse = program.command('browse').description('Playwright browse daemon (local QA / screenshots)');
+    const browse = program.command('browse').description('Browse daemon (Hybrid Bridge: agent-browser + Playwright)');
     browse
         .command('start')
         .option('-p, --port <n>', 'port (default: .cm/config.yaml browse.port or 17395)')
         .option('-H, --host <h>', 'bind host (default: config or 127.0.0.1)')
         .option('--token <t>', 'bearer token (or env CM_BROWSE_TOKEN or config browse.token)')
         .option('--headed', 'headed browser', false)
+        .option('--engine <e>', 'browser engine: auto (default), agent-browser, playwright', 'auto')
         .action((opts) => __awaiter(this, void 0, void 0, function* () {
         var _a, _b, _c, _d, _e, _f, _g;
         const root = process.cwd();
@@ -51,16 +88,168 @@ function registerEngineeringCommands(program) {
             port,
             token,
             headless: !opts.headed,
+            engine: opts.engine,
         });
         yield daemon.listen();
         console.log(chalk_1.default.green(`cm-browse listening http://${host}:${port}`));
         console.log(chalk_1.default.dim(`Authorization: Bearer ${token.slice(0, 8)}…`));
-        console.log(chalk_1.default.dim('POST /session/start, /navigate, /refs/refresh, /click, /fill, GET /screenshot'));
+        console.log(chalk_1.default.dim(`Engine: ${opts.engine}`));
+        console.log(chalk_1.default.dim('Endpoints: POST /session/start, /navigate, /refs/refresh, /click, /fill'));
+        console.log(chalk_1.default.dim('           GET /screenshot, /console, /network, /errors, /a11y-snapshot, /engine'));
+        console.log(chalk_1.default.dim('           POST /record/start, /record/stop'));
         process.on('SIGINT', () => __awaiter(this, void 0, void 0, function* () {
             yield daemon.close();
             process.exit(0);
         }));
     }));
+    browse
+        .command('doctor')
+        .description('Check browser engine availability')
+        .action(() => __awaiter(this, void 0, void 0, function* () {
+        const { checkEngines } = yield Promise.resolve().then(() => __importStar(require('../../browse/adapter-factory')));
+        const engines = yield checkEngines();
+        console.log(chalk_1.default.bold('Browser engine status:'));
+        console.log(`  agent-browser: ${engines['agent-browser'] ? chalk_1.default.green('available') : chalk_1.default.red('not found')}`);
+        console.log(`  playwright:    ${engines.playwright ? chalk_1.default.green('available') : chalk_1.default.red('not found')}`);
+        if (!engines['agent-browser'] && !engines.playwright) {
+            console.log(chalk_1.default.yellow('\nInstall one:'));
+            console.log('  npm i -g agent-browser && agent-browser install');
+            console.log('  npx playwright install chromium');
+        }
+        else if (!engines['agent-browser']) {
+            console.log(chalk_1.default.dim('\nTip: Install agent-browser for better performance + a11y tree:'));
+            console.log('  npm i -g agent-browser && agent-browser install');
+        }
+    }));
+    browse
+        .command('errors')
+        .description('List collected browser errors')
+        .option('--port <n>', 'browse daemon port (default: config or 17395)')
+        .option('--token <t>', 'or env CM_BROWSE_TOKEN or config browse.token')
+        .option('--type <t>', 'filter by type: js-error, network-fail, console-error, timeout, crash')
+        .option('--severity <s>', 'filter by severity: critical, error, warning, info')
+        .action((opts) => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const cfg = (0, cm_config_1.loadCmConfig)(process.cwd());
+        const token = opts.token || process.env.CM_BROWSE_TOKEN || ((_a = cfg.browse) === null || _a === void 0 ? void 0 : _a.token) || 'dev-token-change-me';
+        const port = parseInt(String((_d = (_b = opts.port) !== null && _b !== void 0 ? _b : (_c = cfg.browse) === null || _c === void 0 ? void 0 : _c.port) !== null && _d !== void 0 ? _d : 17395), 10);
+        const auth = `Bearer ${token}`;
+        try {
+            let path = '/errors';
+            const params = new URLSearchParams();
+            if (opts.type)
+                params.set('type', opts.type);
+            if (opts.severity)
+                params.set('severity', opts.severity);
+            if (params.toString())
+                path += `?${params.toString()}`;
+            const raw = yield browseRaw(port, path, auth);
+            const data = JSON.parse(raw);
+            if (data.errors.length === 0) {
+                console.log(chalk_1.default.green('No errors collected'));
+            }
+            else {
+                console.log(chalk_1.default.bold(`Found ${data.errors.length} errors (total: ${data.total}):`));
+                for (const e of data.errors) {
+                    const icon = e.severity === 'critical' ? '🔴' : e.severity === 'error' ? '🟠' : '🟡';
+                    console.log(`  ${icon} [${e.type}] ${e.message.slice(0, 120)}`);
+                }
+            }
+        }
+        catch (e) {
+            console.error(chalk_1.default.red(e.message));
+            process.exit(1);
+        }
+    }));
+    browse
+        .command('snapshot')
+        .description('Get a11y tree snapshot with @eN refs')
+        .option('--port <n>', 'browse daemon port')
+        .option('--token <t>', 'or env CM_BROWSE_TOKEN or config')
+        .action((opts) => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const cfg = (0, cm_config_1.loadCmConfig)(process.cwd());
+        const token = opts.token || process.env.CM_BROWSE_TOKEN || ((_a = cfg.browse) === null || _a === void 0 ? void 0 : _a.token) || 'dev-token-change-me';
+        const port = parseInt(String((_d = (_b = opts.port) !== null && _b !== void 0 ? _b : (_c = cfg.browse) === null || _c === void 0 ? void 0 : _c.port) !== null && _d !== void 0 ? _d : 17395), 10);
+        const auth = `Bearer ${token}`;
+        try {
+            const raw = yield browseRaw(port, '/a11y-snapshot', auth);
+            const snap = JSON.parse(raw);
+            console.log(chalk_1.default.bold('A11y Snapshot:'));
+            console.log(chalk_1.default.dim(`  Timestamp: ${snap.timestamp}`));
+            console.log(chalk_1.default.dim(`  Refs: ${Object.keys(snap.refs).length} elements`));
+            for (const [ref, desc] of Object.entries(snap.refs)) {
+                console.log(`  @${ref}: ${desc}`);
+            }
+        }
+        catch (e) {
+            console.error(chalk_1.default.red(e.message));
+            process.exit(1);
+        }
+    }));
+    browse
+        .command('engine')
+        .description('Show current browser engine info')
+        .option('--port <n>', 'browse daemon port')
+        .option('--token <t>', 'or env CM_BROWSE_TOKEN or config')
+        .action((opts) => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const cfg = (0, cm_config_1.loadCmConfig)(process.cwd());
+        const token = opts.token || process.env.CM_BROWSE_TOKEN || ((_a = cfg.browse) === null || _a === void 0 ? void 0 : _a.token) || 'dev-token-change-me';
+        const port = parseInt(String((_d = (_b = opts.port) !== null && _b !== void 0 ? _b : (_c = cfg.browse) === null || _c === void 0 ? void 0 : _c.port) !== null && _d !== void 0 ? _d : 17395), 10);
+        const auth = `Bearer ${token}`;
+        try {
+            const raw = yield browseRaw(port, '/engine', auth);
+            const info = JSON.parse(raw);
+            console.log(chalk_1.default.bold('Engine:'), info.name);
+            console.log(chalk_1.default.dim(`  Version: ${info.version}`));
+            console.log(chalk_1.default.dim(`  Active: ${info.active}`));
+            if (info.capabilities) {
+                console.log(chalk_1.default.dim('  Capabilities:'));
+                for (const [k, v] of Object.entries(info.capabilities)) {
+                    console.log(`    ${k}: ${v ? '✅' : '❌'}`);
+                }
+            }
+        }
+        catch (e) {
+            console.error(chalk_1.default.red(e.message));
+            process.exit(1);
+        }
+    }));
+    browse
+        .command('record')
+        .description('Video recording control')
+        .argument('<action>', 'start or stop')
+        .option('--port <n>', 'browse daemon port')
+        .option('--token <t>', 'or env CM_BROWSE_TOKEN or config')
+        .action((action, opts) => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const cfg = (0, cm_config_1.loadCmConfig)(process.cwd());
+        const token = opts.token || process.env.CM_BROWSE_TOKEN || ((_a = cfg.browse) === null || _a === void 0 ? void 0 : _a.token) || 'dev-token-change-me';
+        const port = parseInt(String((_d = (_b = opts.port) !== null && _b !== void 0 ? _b : (_c = cfg.browse) === null || _c === void 0 ? void 0 : _c.port) !== null && _d !== void 0 ? _d : 17395), 10);
+        const auth = `Bearer ${token}`;
+        try {
+            if (action === 'start') {
+                yield browseRequest(port, '/record/start', 'POST', auth, {});
+                console.log(chalk_1.default.green('Recording started'));
+            }
+            else if (action === 'stop') {
+                const raw = yield browseRequestRaw(port, '/record/stop', 'POST', auth);
+                const data = JSON.parse(raw);
+                console.log(chalk_1.default.green('Recording stopped'));
+                if (data.path)
+                    console.log(chalk_1.default.dim(`  Video: ${data.path}`));
+            }
+            else {
+                console.error(chalk_1.default.red('Usage: cm browse record <start|stop>'));
+                process.exit(1);
+            }
+        }
+        catch (e) {
+            console.error(chalk_1.default.red(e.message));
+            process.exit(1);
+        }
+    }));
     const guardian = program.command('guardian').description('Runtime safety: destructive command patterns + path freeze');
     guardian
         .command('check')
@@ -100,6 +289,83 @@ function registerEngineeringCommands(program) {
         }
         console.log(chalk_1.default.green('OK'), opts.file);
     });
+    const advisory = program
+        .command('advisory')
+        .description('Operator-facing execution analysis and skill quality reports');
+    advisory
+        .command('report')
+        .description('Show recent execution analyses with recommended actions')
+        .option('--project <dir>')
+        .option('--limit <n>', 'number of analyses to show', '10')
+        .action((opts) => {
+        var _a;
+        const root = projectPath(opts.project);
+        const backend = (0, storage_backend_1.getBackend)(root);
+        backend.initialize();
+        try {
+            const limit = Math.max(1, parseInt(String((_a = opts.limit) !== null && _a !== void 0 ? _a : '10'), 10) || 10);
+            console.log((0, advisory_report_1.formatAdvisoryReport)(backend, { limit }));
+        }
+        finally {
+            backend.close();
+        }
+    });
+    advisory
+        .command('metrics')
+        .description('Show aggregated skill metrics with quality weights')
+        .option('--project <dir>')
+        .option('--limit <n>', 'number of skills to show', '10')
+        .action((opts) => {
+        var _a;
+        const root = projectPath(opts.project);
+        const backend = (0, storage_backend_1.getBackend)(root);
+        backend.initialize();
+        try {
+            const limit = Math.max(1, parseInt(String((_a = opts.limit) !== null && _a !== void 0 ? _a : '10'), 10) || 10);
+            console.log((0, advisory_report_1.formatAdvisoryMetrics)(backend, { limit }));
+        }
+        finally {
+            backend.close();
+        }
+    });
+    advisory
+        .command('handoff')
+        .description('Build a structured advisory handoff for cm-skill-health or cm-skill-evolution')
+        .requiredOption('--for <consumer>', 'cm-skill-health | cm-skill-evolution')
+        .option('--analysis <id>', 'analysis id prefix (default: latest)')
+        .option('--skill <name>', 'override target skill')
+        .option('--format <f>', 'md | json', 'md')
+        .option('--project <dir>')
+        .action((opts) => {
+        var _a;
+        const consumer = String(opts.for);
+        if (consumer !== 'cm-skill-health' && consumer !== 'cm-skill-evolution') {
+            console.error(chalk_1.default.red('Invalid --for value. Use cm-skill-health or cm-skill-evolution.'));
+            process.exit(1);
+        }
+        const root = projectPath(opts.project);
+        const backend = (0, storage_backend_1.getBackend)(root);
+        backend.initialize();
+        try {
+            const handoff = (0, advisory_handoff_1.buildAdvisoryHandoff)(backend, {
+                consumer,
+                analysisId: opts.analysis,
+                skill: opts.skill,
+            });
+            const format = String((_a = opts.format) !== null && _a !== void 0 ? _a : 'md').toLowerCase();
+            if (format === 'json')
+                console.log(JSON.stringify(handoff, null, 2));
+            else
+                console.log((0, advisory_handoff_1.formatAdvisoryHandoffMarkdown)(handoff));
+        }
+        catch (error) {
+            console.error(chalk_1.default.red(error.message));
+            process.exit(1);
+        }
+        finally {
+            backend.close();
+        }
+    });
     const sprint = program.command('sprint').description('Opinionated pipeline + .cm/sprint Context Bus');
     sprint
         .command('init')
@@ -333,14 +599,14 @@ function registerEngineeringCommands(program) {
         .requiredOption('--branch <b>', 'branch name')
         .option('--base <b>', 'start from branch', 'main')
         .action((opts) => {
-        (0, child_process_1.execSync)(`git worktree add -b ${opts.branch} ${opts.at} ${opts.base}`, {
+        (0, child_process_1.execFileSync)('git', ['worktree', 'add', '-b', opts.branch, opts.at, opts.base], {
             stdio: 'inherit',
             cwd: process.cwd(),
         });
         console.log(chalk_1.default.green('Worktree created'));
     });
     conductor.command('list').action(() => {
-        (0, child_process_1.execSync)('git worktree list', { stdio: 'inherit', cwd: process.cwd() });
+        (0, child_process_1.execFileSync)('git', ['worktree', 'list'], { stdio: 'inherit', cwd: process.cwd() });
     });
     const retro = program
         .command('retro')
@@ -413,6 +679,34 @@ function registerEngineeringCommands(program) {
             console.log(chalk_1.default.dim(`  ${s.reason}`));
         }
     });
+    const indexer = program.command('index').description('Project intelligence indexing');
+    indexer
+        .command('skills')
+        .description('Detect tech stack and build .cm/project-skills.md')
+        .option('--project <dir>')
+        .action((opts) => {
+        const root = projectPath(opts.project);
+        // Lazy load to avoid module compilation issues at boot if not used
+        const { generateProjectSkillsIndex } = require('../../indexer/skills');
+        const idx = generateProjectSkillsIndex(root);
+        const dotCm = path_1.default.join(root, '.cm');
+        if (!fs_1.default.existsSync(dotCm)) {
+            fs_1.default.mkdirSync(dotCm, { recursive: true });
+        }
+        const out = path_1.default.join(dotCm, 'project-skills.md');
+        const md = [
+            '# Local Project Skills Index',
+            '',
+            `Detected Technologies: **${idx.detectedTechnologies.join(', ') || 'None'}**`,
+            '',
+            '## Recommended Community Skills',
+            ...idx.recommendedSkills.map((s) => `- \`${s}\``),
+            '',
+            '> Autogenerated by `cm index skills`. Agents should run `npx skills add <skill>` if needed.'
+        ].join('\n');
+        fs_1.default.writeFileSync(out, md, 'utf-8');
+        console.log(chalk_1.default.green(`Indexed ${idx.detectedTechnologies.length} technologies and ${idx.recommendedSkills.length} skills to ${out}`));
+    });
 }
 function browseRequest(port, pathname, method, auth, body) {
     return new Promise((resolve, reject) => {
@@ -477,6 +771,34 @@ function browseRaw(port, pathname, auth) {
         }).on('error', reject);
     });
 }
+function browseRequestRaw(port, pathname, method, auth, body = {}) {
+    return new Promise((resolve, reject) => {
+        const data = Buffer.from(JSON.stringify(body));
+        const req = http_1.default.request({
+            hostname: '127.0.0.1',
+            port,
+            path: pathname,
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': data.length,
+                Authorization: auth,
+            },
+        }, (res) => {
+            let s = '';
+            res.on('data', (c) => (s += c));
+            res.on('end', () => {
+                if (res.statusCode && res.statusCode >= 400)
+                    reject(new Error(`HTTP ${res.statusCode}: ${s}`));
+                else
+                    resolve(s);
+            });
+        });
+        req.on('error', reject);
+        req.write(data);
+        req.end();
+    });
+}
 function httpProbeUrl(url) {
     return __awaiter(this, void 0, void 0, function* () {
         const t0 = performance.now();

package/dist/cli/commands/evolve.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerEvolveCommands = registerEvolveCommands;
+const skill_evolver_1 = require("../../skill-evolver");
+const learning_promoter_1 = require("../../learning-promoter");
+const advisory_handoff_1 = require("../../advisory-handoff");
+const storage_backend_1 = require("../../storage-backend");
+// ─── Evolution CLI Commands ─────────────────────────────────────────────────
+function registerEvolveCommands(program) {
+    const evolve = program
+        .command('evolve')
+        .description('Skill Evolution Engine — self-improving skills via FIX/DERIVED/CAPTURED modes');
+    evolve
+        .command('status')
+        .description('Show skill evolution status and records')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .action((opts) => {
+        var _a;
+        const evolver = new skill_evolver_1.SkillEvolver(opts.project);
+        const records = evolver.listSkillRecords();
+        if (records.length === 0) {
+            console.log('🧬 No skill evolution records yet. Skills will begin evolving after task executions.');
+            return;
+        }
+        console.log('🧬 Skill Evolution Records');
+        console.log('─'.repeat(70));
+        console.log(`${'Skill'.padEnd(30)} ${'Origin'.padEnd(10)} ${'Gen'.padEnd(5)} ${'Evolutions'.padEnd(12)} Last Mode`);
+        console.log('─'.repeat(70));
+        for (const record of records) {
+            console.log(`${record.skill_name.padEnd(30)} ${record.origin.padEnd(10)} ${String(record.generation).padEnd(5)} ${String(record.evolution_count).padEnd(12)} ${(_a = record.last_evolution_mode) !== null && _a !== void 0 ? _a : '-'}`);
+        }
+    });
+    evolve
+        .command('run <mode> <skill>')
+        .description('Execute evolution on a skill (modes: FIX, DERIVED, CAPTURED)')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .option('-c, --confidence <n>', 'Override confidence threshold', '0.85')
+        .action((mode, skill, opts) => {
+        const upperMode = mode.toUpperCase();
+        if (!['FIX', 'DERIVED', 'CAPTURED'].includes(upperMode)) {
+            console.error(`❌ Invalid mode: ${mode}. Must be FIX, DERIVED, or CAPTURED.`);
+            process.exit(1);
+        }
+        const evolver = new skill_evolver_1.SkillEvolver(opts.project);
+        const result = evolver.evolve(upperMode, skill, parseFloat(opts.confidence));
+        console.log((0, skill_evolver_1.formatEvolutionResult)(result));
+    });
+    evolve
+        .command('auto')
+        .description('Auto-evolve based on latest advisory handoff')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .action((opts) => {
+        try {
+            const backend = (0, storage_backend_1.getBackend)(opts.project);
+            backend.initialize();
+            const handoff = (0, advisory_handoff_1.buildAdvisoryHandoff)(backend, { consumer: 'cm-skill-evolution' });
+            const evolver = new skill_evolver_1.SkillEvolver(opts.project, backend);
+            const result = evolver.evolveFromAdvisory(handoff);
+            console.log((0, skill_evolver_1.formatEvolutionResult)(result));
+        }
+        catch (err) {
+            console.error(`❌ Auto-evolve failed: ${err instanceof Error ? err.message : err}`);
+        }
+    });
+    evolve
+        .command('history')
+        .description('Show evolution history')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .option('-s, --skill <name>', 'Filter by skill name')
+        .option('-n, --limit <n>', 'Max entries', '20')
+        .action((opts) => {
+        const evolver = new skill_evolver_1.SkillEvolver(opts.project);
+        const history = evolver.getHistory(opts.skill, parseInt(opts.limit));
+        console.log((0, skill_evolver_1.formatEvolutionHistory)(history));
+    });
+    evolve
+        .command('rollback <skill>')
+        .description('Rollback a skill to its pre-evolution backup')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .action((skill, opts) => {
+        const evolver = new skill_evolver_1.SkillEvolver(opts.project);
+        const result = evolver.rollback(skill);
+        console.log((0, skill_evolver_1.formatEvolutionResult)(result));
+    });
+    // ─── Learning Promotion ─────────────────────────────────────────────────
+    evolve
+        .command('candidates')
+        .description('Show learnings that qualify for promotion to skills')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .action((opts) => {
+        const promoter = new learning_promoter_1.LearningPromoter(opts.project);
+        const candidates = promoter.findCandidates();
+        console.log((0, learning_promoter_1.formatPromotionCandidates)(candidates));
+    });
+    evolve
+        .command('promote <learningId>')
+        .description('Promote a specific learning to a reusable skill')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .action((learningId, opts) => {
+        const promoter = new learning_promoter_1.LearningPromoter(opts.project);
+        const result = promoter.promote(learningId);
+        const icon = result.promoted ? '✅' : '❌';
+        console.log(`${icon} ${result.reason}`);
+        if (result.promoted) {
+            console.log(`   Skill: ${result.skillName}`);
+            console.log(`   Path:  ${result.skillPath}`);
+        }
+    });
+    evolve
+        .command('auto-promote')
+        .description('Auto-promote the top learning candidate to a skill')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .action((opts) => {
+        const promoter = new learning_promoter_1.LearningPromoter(opts.project);
+        const result = promoter.autoPromote();
+        if (!result) {
+            console.log('📚 No learnings qualify for auto-promotion yet.');
+            return;
+        }
+        const icon = result.promoted ? '✅' : '❌';
+        console.log(`${icon} ${result.reason}`);
+    });
+}