codymaster 4.6.0 → 5.2.0

package/dist/cli/commands/brain.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerBrainCommands = registerBrainCommands;
+const smart_brain_router_1 = require("../../smart-brain-router");
+const skill_execution_cache_1 = require("../../skill-execution-cache");
+const token_budget_1 = require("../../token-budget");
+// ─── Brain & Token CLI Commands ──────────────────────────────────────────────
+function registerBrainCommands(program) {
+    const smart = program
+        .command('smart')
+        .description('Smart Brain Router — inspect brain layer selection for tasks');
+    smart
+        .command('plan <task>')
+        .description('Preview which brain layers would load for a task description')
+        .action((task) => {
+        const plan = (0, smart_brain_router_1.routeTask)(task);
+        const output = (0, smart_brain_router_1.formatBrainPlan)(plan);
+        console.log(output);
+    });
+    smart
+        .command('tiers')
+        .description('Show per-tier token budget allocations')
+        .action(() => {
+        const tierBudgets = (0, token_budget_1.getDefaultTierBudgets)();
+        console.log((0, token_budget_1.generateTierReport)(tierBudgets));
+    });
+    const token = program
+        .command('token')
+        .description('Token usage analysis and savings tracking');
+    token
+        .command('report')
+        .description('Show current token budget allocation')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .action((opts) => {
+        const budget = (0, token_budget_1.loadBudget)(opts.project);
+        console.log((0, token_budget_1.generateBudgetReport)(budget));
+        console.log('');
+        const tierBudgets = (0, token_budget_1.getDefaultTierBudgets)();
+        console.log((0, token_budget_1.generateTierReport)(tierBudgets));
+    });
+    token
+        .command('savings')
+        .description('Show estimated token savings from smart routing and caching')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .action((opts) => {
+        const cache = new skill_execution_cache_1.SkillExecutionCache(opts.project);
+        try {
+            cache.initialize();
+            const stats = cache.getStats();
+            console.log((0, skill_execution_cache_1.formatCacheStats)(stats));
+            console.log('');
+            // Compute savings summary
+            const savings = {
+                brainRoutingSaved: 0, // Tracked per-session (not persistent yet)
+                cacheHitsSaved: stats.estimatedTokensSaved,
+                progressiveLoadSaved: 0,
+                totalSaved: stats.estimatedTokensSaved,
+                sessionTasks: stats.totalHits,
+            };
+            console.log((0, token_budget_1.formatSavingsReport)(savings));
+        }
+        finally {
+            cache.close();
+        }
+    });
+    token
+        .command('cache')
+        .description('Show skill execution cache entries')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .option('-n, --limit <n>', 'Max entries to show', '20')
+        .action((opts) => {
+        const cache = new skill_execution_cache_1.SkillExecutionCache(opts.project);
+        try {
+            cache.initialize();
+            const entries = cache.listCachedChains(parseInt(opts.limit));
+            if (entries.length === 0) {
+                console.log('📦 No cached skill chains yet. Complete some tasks to build the cache.');
+                return;
+            }
+            console.log(`📦 Skill Execution Cache (${entries.length} entries)`);
+            console.log('─'.repeat(70));
+            for (const entry of entries) {
+                const skills = entry.skillChain.join(' → ');
+                const eff = (entry.effectiveness * 100).toFixed(0);
+                console.log(`  ${entry.taskPattern.slice(0, 45).padEnd(45)} │ ${skills}`);
+                console.log(`  ${''.padEnd(45)} │ ${eff}% eff · ${entry.hitCount} hits · ${entry.tokenUsed} tok`);
+            }
+        }
+        finally {
+            cache.close();
+        }
+    });
+    token
+        .command('cache-clear')
+        .description('Clear the skill execution cache')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .action((opts) => {
+        const cache = new skill_execution_cache_1.SkillExecutionCache(opts.project);
+        try {
+            cache.initialize();
+            const cleared = cache.clearCache();
+            console.log(`🗑️ Cleared ${cleared} cached entries.`);
+        }
+        finally {
+            cache.close();
+        }
+    });
+}

package/dist/cli/commands/dashboard.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDashboardCommands = registerDashboardCommands;
+const fs_1 = __importDefault(require("fs"));
+const dashboard_1 = require("../../dashboard");
+const data_1 = require("../../data");
+const theme_1 = require("../../ui/theme");
+const box_1 = require("../../ui/box");
+const cli_utils_1 = require("../../utils/cli-utils");
+function registerDashboardCommands(program) {
+    program
+        .command('dashboard [cmd]')
+        .alias('dash')
+        .description('Dashboard server (start|stop|status|open)')
+        .option('-p, --port <port>', 'Port number', String(data_1.DEFAULT_PORT))
+        .action((cmd, opts) => {
+        const port = parseInt(opts.port) || data_1.DEFAULT_PORT;
+        switch (cmd) {
+            case 'start':
+            case undefined:
+                if (isDashboardRunning()) {
+                    console.log((0, box_1.renderResult)('warning', 'Dashboard already running.', [`${(0, theme_1.dim)('URL:')} ${(0, theme_1.brand)(`http://localhost:${port}`)}`]));
+                    return;
+                }
+                (0, dashboard_1.launchDashboard)(port);
+                break;
+            case 'stop':
+                stopDashboard();
+                break;
+            case 'status':
+                dashboardStatus(port);
+                break;
+            case 'open':
+                console.log((0, box_1.renderResult)('info', `Opening http://localhost:${port} ...`));
+                (0, cli_utils_1.openUrl)(`http://localhost:${port}`);
+                break;
+            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')]));
+        }
+    });
+}
+function isDashboardRunning() {
+    try {
+        if (!fs_1.default.existsSync(data_1.PID_FILE))
+            return false;
+        const pid = parseInt(fs_1.default.readFileSync(data_1.PID_FILE, 'utf-8').trim());
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (_a) {
+        try {
+            fs_1.default.unlinkSync(data_1.PID_FILE);
+        }
+        catch (_b) { }
+        return false;
+    }
+}
+function stopDashboard() {
+    try {
+        if (!fs_1.default.existsSync(data_1.PID_FILE)) {
+            console.log((0, box_1.renderResult)('warning', 'No dashboard running.'));
+            return;
+        }
+        const pid = parseInt(fs_1.default.readFileSync(data_1.PID_FILE, 'utf-8').trim());
+        process.kill(pid, 'SIGTERM');
+        try {
+            fs_1.default.unlinkSync(data_1.PID_FILE);
+        }
+        catch (_a) { }
+        console.log((0, box_1.renderResult)('success', `Dashboard stopped (PID ${pid}).`));
+    }
+    catch (err) {
+        console.log((0, box_1.renderResult)('error', `Failed to stop: ${err.message}`));
+        try {
+            fs_1.default.unlinkSync(data_1.PID_FILE);
+        }
+        catch (_b) { }
+    }
+}
+function dashboardStatus(port) {
+    if (isDashboardRunning()) {
+        const pid = fs_1.default.readFileSync(data_1.PID_FILE, 'utf-8').trim();
+        console.log((0, box_1.renderResult)('success', 'Dashboard RUNNING', [`${(0, theme_1.dim)('PID:')} ${(0, theme_1.brand)(pid)}`, `${(0, theme_1.dim)('URL:')} ${(0, theme_1.brand)(`http://localhost:${port}`)}`]));
+    }
+    else {
+        console.log((0, box_1.renderResult)('warning', 'Dashboard NOT running', [(0, theme_1.dim)('Start with: cm dashboard start')]));
+    }
+}

package/dist/cli/commands/design-studio.js

@@ -0,0 +1,111 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initDesignStudioArtifacts = initDesignStudioArtifacts;
+exports.registerDesignStudioCommands = registerDesignStudioCommands;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+function projectPath(opt) {
+    return path_1.default.resolve(opt || process.cwd());
+}
+const CHECKLIST = `# Design studio — checklist
+
+- [ ] Problem / JTBD one-liner
+- [ ] 2–3 UI variants named (A/B/C)
+- [ ] Chosen variant + rationale
+- [ ] Handoff block filled in HANDOFF.md
+`;
+const VARIANTS = `# Variants
+
+| Id | Name | Notes |
+|----|------|-------|
+| A  |      |       |
+| B  |      |       |
+| C  |      |       |
+`;
+const HANDOFF = `# Handoff to implementation
+
+**Chosen variant:** (A/B/C)
+
+**Screens / flows:**
+
+**Tokens / components to reuse:**
+
+**Out of scope:**
+
+**Agent prompt stub:**
+
+\`\`\`
+Implement the chosen variant using existing design system tokens. …
+\`\`\`
+`;
+const README = `# .cm/design-studio
+
+Local artifact folder for **cm-design-studio**: variants, checklist, handoff.
+
+Happy path:
+
+1. \`cm design-studio init\`
+2. Edit CHECKLIST.md + VARIANTS.md
+3. Fill HANDOFF.md, then run your build skill (e.g. cm-execution) with that stub.
+`;
+/** Writes default artifact files; skips paths that already exist. Returns created + skipped counts. */
+function initDesignStudioArtifacts(root) {
+    const base = path_1.default.join(root, '.cm', 'design-studio');
+    fs_1.default.mkdirSync(base, { recursive: true });
+    const files = [
+        ['README.md', README],
+        ['CHECKLIST.md', CHECKLIST],
+        ['VARIANTS.md', VARIANTS],
+        ['HANDOFF.md', HANDOFF],
+    ];
+    let created = 0;
+    let skipped = 0;
+    for (const [name, body] of files) {
+        const p = path_1.default.join(base, name);
+        if (fs_1.default.existsSync(p)) {
+            skipped++;
+        }
+        else {
+            fs_1.default.writeFileSync(p, body, 'utf8');
+            created++;
+        }
+    }
+    return { created, skipped };
+}
+function registerDesignStudioCommands(program) {
+    const ds = program
+        .command('design-studio')
+        .description('Design variant workspace under .cm/design-studio');
+    ds.command('init')
+        .description('Create .cm/design-studio with checklist and handoff templates')
+        .option('--project <dir>', 'project root', process.cwd())
+        .action((opts) => {
+        const root = projectPath(opts.project);
+        const { created, skipped } = initDesignStudioArtifacts(root);
+        const base = path_1.default.join(root, '.cm', 'design-studio');
+        if (created)
+            console.log(chalk_1.default.green(`wrote ${created} file(s) under`), base);
+        if (skipped)
+            console.log(chalk_1.default.yellow(`skipped ${skipped} existing`));
+    });
+    ds.command('status')
+        .description('List design-studio artifact files if present')
+        .option('--project <dir>', 'project root', process.cwd())
+        .action((opts) => {
+        const root = projectPath(opts.project);
+        const base = path_1.default.join(root, '.cm', 'design-studio');
+        if (!fs_1.default.existsSync(base)) {
+            console.log(chalk_1.default.yellow('Not initialized. Run:'), chalk_1.default.cyan('cm design-studio init'));
+            return;
+        }
+        for (const f of fs_1.default.readdirSync(base)) {
+            const p = path_1.default.join(base, f);
+            const st = fs_1.default.statSync(p);
+            console.log(st.isDirectory() ? `${f}/` : f);
+        }
+    });
+}

package/dist/cli/commands/distro.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDistroCommands = registerDistroCommands;
+const chalk_1 = __importDefault(require("chalk"));
+const distro_validate_1 = require("../../distro-validate");
+function registerDistroCommands(program) {
+    const distro = program.command('distro').description('Skill pack validation (ecosystem roadmap)');
+    distro
+        .command('validate')
+        .description('Validate a skill directory (SKILL.md / tmpl + optional meta.json)')
+        .argument('<dir>', 'path to skill folder')
+        .action((dir) => {
+        const r = (0, distro_validate_1.validateSkillPackDir)(dir);
+        for (const w of r.warnings)
+            console.log(chalk_1.default.yellow('warning:'), w);
+        for (const e of r.errors)
+            console.error(chalk_1.default.red('error:'), e);
+        if (!r.ok)
+            process.exit(1);
+        console.log(chalk_1.default.green('OK'), dir);
+    });
+}