codymaster 7.0.1 → 7.0.3

package/CHANGELOG.md

@@ -6,6 +6,70 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 
 ---
 
+## [7.0.3] - 2026-05-13
+
+### 🚀 Improvements — Codex Runtime + Token-Efficient Handoffs
+
+Focused compatibility and cleanup release. Align CodyMaster with the current Codex CLI, reduce agent handoff noise, and remove dead references to deprecated skills across docs, profiles, and runtime hints.
+
+### 🚀 Improvements — Skill Token Auditing + Progressive Disclosure
+
+Added first-class skill token footprint auditing and used it to refactor the heaviest always-on skills into lazy-loaded `references/` packs.
+
+**Skill Token Auditing:**
+- Added `cm token skill <skillName>` under the existing `cm token` namespace
+- New `--project`, `--json`, and `--baseline` options for repo-scoped reports, machine-readable output, and before/after comparisons
+- New `src/skill-token-report.ts` analyzer for `SKILL.md`, direct `references/`, `progressive_min`, `progressive_max`, and baseline deltas
+- Added `test/skill-token-report.test.ts` and `test/brain-token-skill.test.ts`
+
+**Progressive Disclosure Refactors:**
+- Split `skills/cm-execution/` into a short router `SKILL.md` plus mode-specific references
+- Split `skills/cm-codeintell/` by intelligence layer: skeleton, codegraph, architecture, context builder, integration workflows
+- Split `skills/cm-safe-deploy/` by deploy path: individual gates, setup, and rollback
+- Split `skills/cm-continuity/` by concern: session protocol, template, memory model, MCP bridge, URI scheme, storage, audit
+- Split `skills/cm-tdd/` by workflow/support: red-green-refactor, test quality, rationalizations, bugfix example, stuck/debugging
+- Preserved existing skill names, compressed frontmatter style, and distribution compatibility with flat `references/`
+
+**Measured Token Wins (`progressive_min`):**
+- `cm-execution`: `3990 → 963` tokens
+- `cm-codeintell`: `4981 → 685` tokens
+- `cm-safe-deploy`: `4268 → 780` tokens
+- `cm-continuity`: `4157 → 652` tokens
+- `cm-tdd`: `2953 → 554` tokens
+
+**Codex Compatibility:**
+- Updated `src/agent/codex.ts` to use `codex exec --json`
+- Added proper `codex exec resume` support for resumed sessions
+- Parse real Codex JSONL events (`thread.started`, `item.completed`, `turn.completed`)
+- Preserve `sessionId` and token `usage` from Codex runtime output
+
+**Token Efficiency + Runtime Reuse:**
+- Refactored `src/agent-dispatch.ts` to emit compact structured JSON task envelopes instead of verbose Markdown task files
+- Fixed generated CLI handoff commands for Codex and Claude Code to match current CLIs
+- Wired `SkillExecutionCache` into `src/skill-chain.ts` for real cached skill-chain reuse during execution
+- Wired successful execution write-back into `src/execution-analyzer.ts`
+- Added `compressMaybe()` helper in `src/utils/output-compress.ts` for safer runtime log compression
+
+**Docs, Profiles, and Naming Cleanup:**
+- Synced skill install manifests in `skills/profiles/{core,design,growth,full}.txt` and `skills/profiles/top35.json`
+- Updated skill library docs under `docs/skills/` to remove broken links to deleted/deprecated skill folders
+- Cleaned workflow and operations docs to point at current skills like `cm-safe-deploy`, `cm-design-system`, `cm-quality-gate`, `cm-execution`, and `cm-skill-index`
+- Reduced deprecation-heavy copywriting in user-facing docs so new users see the current path first
+- Kept migration-specific references only where they still serve version-upgrade guidance (`docs/migration-v2.md`) or advisory protocol compatibility
+
+**Tests Added:**
+- `test/codex-backend.test.ts`
+- `test/agent-dispatch.test.ts`
+- `test/skill-chain-cache.test.ts`
+- `test/skill-token-report.test.ts`
+- `test/brain-token-skill.test.ts`
+
+**Verification:**
+- `npm run test:gate:kit`
+- Result: 54 test files passed, 422 tests passed
+
+---
+
 ## [7.0.0] - 2026-05-11
 
 ### 🚀 Improvements — Browse Hybrid Bridge

package/README.md

@@ -6,7 +6,7 @@
 
 **50+ skills. One install. Your AI coding agent becomes a full team.**
 
-**v7.0 — Browse Hybrid Bridge:** AI-native browser automation with a11y snapshots, error collection, video recording.
+**v7.0.2 — Browse Hybrid Bridge:** AI-native browser automation with a11y snapshots, error collection, video recording.
 
 ```
     ( . \ --- / . )
@@ -17,7 +17,9 @@
        Meet Cody 🐹
 ```
 
-[![Discord](https://img.shields.io/badge/Discord-Join-7289da?logo=discord&logoColor=white)](https://discord.gg/codymaster)
+[![npm version](https://img.shields.io/npm/v/codymaster.svg)](https://www.npmjs.com/package/codymaster)
+[![npm downloads](https://img.shields.io/npm/dm/codymaster.svg)](https://www.npmjs.com/package/codymaster)
+[![license](https://img.shields.io/npm/l/codymaster.svg)](https://github.com/tody-agent/codymaster/blob/main/LICENSE)
 
 ---
 
@@ -243,12 +245,58 @@ cm status          # See your tasks and progress
 cm dashboard       # Open the visual dashboard
 ```
 
+### For OpenCode users
+
+OpenCode supports both skills and plugins:
+
+```bash
+git clone https://github.com/tody-agent/codymaster.git ~/.cody-master
+
+# Skills (auto-load)
+ln -s ~/.cody-master/.opencode/skills ~/.opencode/skills
+
+# Plugins (optional — adds custom tools)
+mkdir -p ~/.opencode/plugins
+ln -s ~/.cody-master/.opencode/plugins/cm-brainstorm-idea.ts ~/.opencode/plugins/
+```
+
+Restart OpenCode to activate. The `cm-brainstorm-idea` plugin adds a strategic analysis tool with auto-detection for brainstorm keywords.
+
+📖 [Full OpenCode installation guide →](.opencode/INSTALL.md)
+
+### For Codex users
+
+Fastest path:
+
+```bash
+git clone https://github.com/tody-agent/codymaster.git ~/.cody-master
+cd ~/.cody-master
+npm ci
+npm run build:platforms
+```
+
+Then tell Codex:
+
+```text
+Fetch and follow instructions from https://raw.githubusercontent.com/tody-agent/codymaster/main/.codex/INSTALL.md
+```
+
+Or use the local Codex skill tree directly at `.codex/skills/`.
+
 ### No Node.js?
 
 ```bash
 bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --all --profile core
 ```
 
+### What's in the package
+
+- **50+ skills** — ready-to-use SKILL.md files for every major AI coding agent
+- **CLI (`cm`)** — install wizard, doctor, dashboard, MCP server, browse daemon
+- **Skill profiles** — curated bundles: `core`, `growth`, `full`, `knowledge`
+- **Multi-platform** — installs to Claude Code, Cursor, Gemini, Codex, OpenCode, Windsurf, Cline, Aider, Continue, Kiro, Amazon Q, Amp, Copilot, Claude Desktop
+- **Zero config** — detects your tools, installs skills, you're done
+
 ---
 
 ## The Dashboard
@@ -315,6 +363,71 @@ cm mcp-serve --print-config  # Paste into Goose config
 
 ---
 
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `cm` | Launch interactive wizard (auto-detect AI tools) |
+| `cm doctor` | Check installation health across all platforms |
+| `cm status` | View current tasks and progress |
+| `cm dashboard` | Open visual mission control |
+| `cm install <platform> --profile <name>` | Install skills to a specific platform |
+| `cm update --full` | Update all skills to latest |
+| `cm upgrade` | Upgrade CodyMaster itself |
+| `cm mcp-serve` | Run as MCP server for Claude Desktop |
+| `cm browse` | Open a URL in the browse daemon |
+| `cm browse screenshot <url>` | Capture a screenshot |
+| `cm browse snapshot <url>` | Get accessibility tree snapshot |
+
+### Skill Profiles
+
+| Profile | Skills | Best For |
+|---------|--------|----------|
+| `core` | 15 | Daily coding — planning, TDD, debug, review, deploy |
+| `growth` | 25 | + design system, i18n, content factory |
+| `full` | 50+ | Everything — full senior team |
+| `knowledge` | 10 | Docs, code intelligence, retros |
+
+```bash
+cm install claude-code --profile core
+cm install cursor --profile growth
+cm install gemini --profile full
+```
+
+---
+
+## Troubleshooting
+
+### `cm: command not found`
+
+```bash
+# Make sure global npm bin is in PATH
+npm config get prefix
+# Add the output bin/ folder to your PATH
+```
+
+### Skills not showing in AI agent
+
+```bash
+cm doctor          # Check what's installed where
+cm install --all   # Re-install to all detected platforms
+```
+
+### Build fails
+
+```bash
+npm run build      # Rebuild TypeScript
+npm run test:gate:kit  # Run full quality gate
+```
+
+### Permission errors (macOS/Linux)
+
+```bash
+sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
+```
+
+---
+
 ## Contributing
 
 1. ⭐ **Star the repo** — helps more builders find this
@@ -335,6 +448,8 @@ CI runs `npm run test:gate:kit` on every push and PR.
 | 🎨 Design Pipeline | [docs/design-pipeline.md](docs/design-pipeline.md) |
 | 🛠️ Skills | [skills/](skills/) |
 | 📖 Our Story | [cody.todyle.com/story](https://cody.todyle.com/story) |
+| 📋 Changelog | [CHANGELOG.md](CHANGELOG.md) |
+| 🐛 Issues | [GitHub Issues](https://github.com/tody-agent/codymaster/issues) |
 
 ---
 

package/dist/agent/codex.js

@@ -30,32 +30,79 @@ var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _ar
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CodexBackend = void 0;
+exports.buildCodexPrompt = buildCodexPrompt;
+exports.buildCodexArgs = buildCodexArgs;
 const spawn_helper_1 = require("./spawn-helper");
+function buildCodexPrompt(prompt, opts) {
+    var _a;
+    if (!((_a = opts.systemPrompt) === null || _a === void 0 ? void 0 : _a.trim()))
+        return prompt;
+    return [
+        '<system_prompt>',
+        opts.systemPrompt.trim(),
+        '</system_prompt>',
+        '',
+        prompt,
+    ].join('\n');
+}
+function buildCodexArgs(prompt, opts) {
+    const baseArgs = ['--json', '--skip-git-repo-check'];
+    if (opts.model)
+        baseArgs.push('--model', opts.model);
+    if (opts.customArgs)
+        baseArgs.push(...opts.customArgs);
+    const finalPrompt = buildCodexPrompt(prompt, opts);
+    if (opts.resumeSessionId) {
+        return ['exec', 'resume', ...baseArgs, opts.resumeSessionId, finalPrompt];
+    }
+    return ['exec', ...baseArgs, finalPrompt];
+}
 class AgentMessageTransformer {
     constructor() {
         this.output = [];
     }
     transform(msg) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
+        const codexEvent = msg;
+        if (codexEvent.thread_id) {
+            this.lastThreadId = codexEvent.thread_id;
+        }
+        if (codexEvent.type === 'item.completed' && ((_a = codexEvent.item) === null || _a === void 0 ? void 0 : _a.type) === 'agent_message') {
+            const content = (_b = codexEvent.item.text) !== null && _b !== void 0 ? _b : '';
+            if (content) {
+                this.output.push(content);
+                return [{ type: 'text', content, sessionId: this.lastThreadId }];
+            }
+        }
+        if (codexEvent.type === 'turn.completed' && codexEvent.usage) {
+            this.usage = {
+                codex: {
+                    input: (_c = codexEvent.usage.input_tokens) !== null && _c !== void 0 ? _c : 0,
+                    output: (_d = codexEvent.usage.output_tokens) !== null && _d !== void 0 ? _d : 0,
+                    cacheRead: (_e = codexEvent.usage.cached_input_tokens) !== null && _e !== void 0 ? _e : 0,
+                },
+            };
+            return [];
+        }
         const t = msg.type;
         if (t === 'message' || t === 'text' || t === 'assistant') {
-            const content = (_b = (_a = msg.content) !== null && _a !== void 0 ? _a : msg.text) !== null && _b !== void 0 ? _b : '';
+            const content = (_g = (_f = msg.content) !== null && _f !== void 0 ? _f : msg.text) !== null && _g !== void 0 ? _g : '';
             if (content) {
                 this.output.push(content);
-                return [{ type: 'text', content }];
+                return [{ type: 'text', content, sessionId: this.lastThreadId }];
             }
         }
         if (t === 'thinking') {
-            return [{ type: 'thinking', content: (_c = msg.content) !== null && _c !== void 0 ? _c : '' }];
+            return [{ type: 'thinking', content: (_h = msg.content) !== null && _h !== void 0 ? _h : '' }];
         }
         if (t === 'tool_use' || t === 'tool-use') {
             return [
                 {
                     type: 'tool-use',
-                    tool: (_e = (_d = msg.tool) !== null && _d !== void 0 ? _d : msg.name) !== null && _e !== void 0 ? _e : 'unknown',
-                    callId: (_g = (_f = msg.callId) !== null && _f !== void 0 ? _f : msg.id) !== null && _g !== void 0 ? _g : '',
-                    input: (_j = (_h = msg.input) !== null && _h !== void 0 ? _h : msg.arguments) !== null && _j !== void 0 ? _j : {},
-                    attempt: (_k = msg.attempt) !== null && _k !== void 0 ? _k : 1,
+                    tool: (_k = (_j = msg.tool) !== null && _j !== void 0 ? _j : msg.name) !== null && _k !== void 0 ? _k : 'unknown',
+                    callId: (_m = (_l = msg.callId) !== null && _l !== void 0 ? _l : msg.id) !== null && _m !== void 0 ? _m : '',
+                    input: (_p = (_o = msg.input) !== null && _o !== void 0 ? _o : msg.arguments) !== null && _p !== void 0 ? _p : {},
+                    attempt: (_q = msg.attempt) !== null && _q !== void 0 ? _q : 1,
                     parentCallId: msg.parentCallId,
                 },
             ];
@@ -64,26 +111,26 @@ class AgentMessageTransformer {
             return [
                 {
                     type: 'tool-result',
-                    callId: (_m = (_l = msg.callId) !== null && _l !== void 0 ? _l : msg.id) !== null && _m !== void 0 ? _m : '',
-                    output: (_p = (_o = msg.output) !== null && _o !== void 0 ? _o : msg.content) !== null && _p !== void 0 ? _p : '',
-                    isError: (_q = msg.isError) !== null && _q !== void 0 ? _q : false,
+                    callId: (_s = (_r = msg.callId) !== null && _r !== void 0 ? _r : msg.id) !== null && _s !== void 0 ? _s : '',
+                    output: (_u = (_t = msg.output) !== null && _t !== void 0 ? _t : msg.content) !== null && _u !== void 0 ? _u : '',
+                    isError: (_v = msg.isError) !== null && _v !== void 0 ? _v : false,
                 },
             ];
         }
         if (t === 'status') {
-            return [{ type: 'status', status: (_r = msg.status) !== null && _r !== void 0 ? _r : '' }];
+            return [{ type: 'status', status: (_w = msg.status) !== null && _w !== void 0 ? _w : '' }];
         }
         if (t === 'log') {
             return [
                 {
                     type: 'log',
-                    level: (_s = msg.level) !== null && _s !== void 0 ? _s : 'info',
-                    content: (_t = msg.content) !== null && _t !== void 0 ? _t : '',
+                    level: (_x = msg.level) !== null && _x !== void 0 ? _x : 'info',
+                    content: (_y = msg.content) !== null && _y !== void 0 ? _y : '',
                 },
             ];
         }
         if (t === 'error') {
-            return [{ type: 'error', content: (_v = (_u = msg.content) !== null && _u !== void 0 ? _u : msg.message) !== null && _v !== void 0 ? _v : '' }];
+            return [{ type: 'error', content: (_0 = (_z = msg.content) !== null && _z !== void 0 ? _z : msg.message) !== null && _0 !== void 0 ? _0 : '' }];
         }
         // Unknown message types are surfaced as status
         return [{ type: 'status', status: JSON.stringify(msg) }];
@@ -91,6 +138,12 @@ class AgentMessageTransformer {
     getOutput() {
         return this.output.join('');
     }
+    getSessionId() {
+        return this.lastThreadId;
+    }
+    getUsage() {
+        return this.usage;
+    }
 }
 function transformMessages(raw, transformer) {
     return __asyncGenerator(this, arguments, function* transformMessages_1() {
@@ -134,6 +187,8 @@ function collectResult(proc, transformer, startTime) {
                 output: transformer.getOutput(),
                 durationMs,
                 failureReason,
+                sessionId: transformer.getSessionId(),
+                usage: transformer.getUsage(),
             });
         });
         proc.child.on('error', (err) => {
@@ -144,6 +199,8 @@ function collectResult(proc, transformer, startTime) {
                 error: err instanceof Error ? err.message : String(err),
                 failureReason: 'agent_crash',
                 durationMs,
+                sessionId: transformer.getSessionId(),
+                usage: transformer.getUsage(),
             });
         });
     });
@@ -177,12 +234,7 @@ class CodexBackend {
     }
     execute(prompt, opts) {
         return __awaiter(this, void 0, void 0, function* () {
-            const args = ['--full-auto'];
-            if (opts.model)
-                args.push('--model', opts.model);
-            if (opts.customArgs)
-                args.push(...opts.customArgs);
-            args.push(prompt);
+            const args = buildCodexArgs(prompt, opts);
             const proc = (0, spawn_helper_1.spawnProcess)({
                 command: 'codex',
                 args,

package/dist/agent-dispatch.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateDispatch = validateDispatch;
+exports.generateTaskEnvelope = generateTaskEnvelope;
 exports.dispatchTaskToAgent = dispatchTaskToAgent;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -11,6 +12,8 @@ const path_1 = __importDefault(require("path"));
 const AGENT_SKILL_PREFIX = {
     'antigravity': '@[/',
     'claude-code': '/',
+    'codex': '/',
+    'opencode': '/',
     'cursor': '@',
     'gemini-cli': '@[/',
     'windsurf': '@',
@@ -20,6 +23,8 @@ const AGENT_SKILL_PREFIX = {
 const AGENT_DISPLAY = {
     'antigravity': 'Google Antigravity',
     'claude-code': 'Claude Code',
+    'codex': 'OpenAI Codex',
+    'opencode': 'OpenCode',
     'cursor': 'Cursor',
     'gemini-cli': 'Gemini CLI',
     'windsurf': 'Windsurf',
@@ -56,58 +61,60 @@ function validateDispatch(task, project, force = false) {
     return null; // All validations passed
 }
 // ─── Task File Generation ───────────────────────────────────────────────────
-function generateTaskFileContent(task, project, dashboardPort = 6969) {
+function buildDoneCriteria(task) {
+    const criteria = [
+        'Complete the requested scope only.',
+        'Preserve unrelated existing changes.',
+        'Report verification evidence before claiming completion.',
+    ];
+    if (task.skill) {
+        criteria.unshift(`Follow the workflow guidance from skill "${task.skill}" when it applies.`);
+    }
+    return criteria;
+}
+function generateTaskEnvelope(task, project, dashboardPort = 6969) {
     const agentName = AGENT_DISPLAY[task.agent] || task.agent;
     const skillPrefix = AGENT_SKILL_PREFIX[task.agent] || '';
     const skillSuffix = task.agent === 'antigravity' || task.agent === 'gemini-cli' ? ']' : '';
     const skillRef = task.skill ? `${skillPrefix}${task.skill}${skillSuffix}` : 'None';
-    const now = new Date().toISOString();
-    const priorityEmoji = {
-        'low': '🟢', 'medium': '🟡', 'high': '🟠', 'urgent': '🔴',
+    return {
+        schema: 'codymaster-task@2',
+        task: {
+            id: task.id,
+            title: task.title,
+            description: task.description || '',
+            priority: task.priority,
+            createdAt: task.createdAt,
+            dispatchedAt: new Date().toISOString(),
+        },
+        execution: {
+            agent: agentName,
+            workspace: project.path,
+            skill: task.skill || null,
+            skillInvocation: task.skill ? skillRef : null,
+            doneCriteria: buildDoneCriteria(task),
+        },
+        project: {
+            id: project.id,
+            name: project.name,
+        },
+        progressReporting: {
+            baseUrl: `http://localhost:${dashboardPort}`,
+            inProgress: {
+                method: 'PUT',
+                path: `/api/tasks/${task.id}/move`,
+                body: { column: 'in-progress' },
+            },
+            done: {
+                method: 'PUT',
+                path: `/api/tasks/${task.id}/move`,
+                body: { column: 'done' },
+            },
+        },
     };
-    let content = `# Task: ${task.title}
-
-| Field | Value |
-|-------|-------|
-| Agent | ${agentName} |
-| Skill | ${skillRef} |
-| Priority | ${priorityEmoji[task.priority] || '🟡'} ${task.priority} |
-| Project | ${project.name} |
-| Created | ${task.createdAt} |
-| Dispatched | ${now} |
-| Task ID | ${task.id} |
-
-## Description
-
-${task.description || 'No additional description provided.'}
-
-## Instructions
-
-Execute this task in the project workspace at: \`${project.path}\`
-`;
-    if (task.skill) {
-        content += `
-Use the skill \`${task.skill}\` to guide execution. Invoke it with: ${skillRef}
-`;
-    }
-    content += `
-## Progress Reporting
-
-After completing the task, update the status via CodyMaster API:
-
-\`\`\`bash
-# Mark as in-progress
-curl -s -X PUT http://localhost:${dashboardPort}/api/tasks/${task.id}/move \\
-  -H "Content-Type: application/json" \\
-  -d '{"column": "in-progress"}'
-
-# Mark as done when complete
-curl -s -X PUT http://localhost:${dashboardPort}/api/tasks/${task.id}/move \\
-  -H "Content-Type: application/json" \\
-  -d '{"column": "done"}'
-\`\`\`
-`;
-    return content;
+}
+function generateTaskFileContent(task, project, dashboardPort = 6969) {
+    return JSON.stringify(generateTaskEnvelope(task, project, dashboardPort), null, 2);
 }
 // ─── Dispatcher ─────────────────────────────────────────────────────────────
 function dispatchTaskToAgent(task, project, force = false) {
@@ -156,6 +163,14 @@ function dispatchTaskToAgent(task, project, force = false) {
     }
     // Generate CLI command
     const relativePath = path_1.default.relative(project.path, filePath);
-    const cliCommand = `gemini run --task "${relativePath}"`;
+    const AGENT_CLI = {
+        'antigravity': `antigravity -p "$(cat \\"${relativePath}\\")"`,
+        'codex': `codex exec "$(cat \\"${relativePath}\\")"`,
+        'opencode': `opencode --task "${relativePath}"`,
+        'cursor': `cursor --task "${relativePath}"`,
+        'gemini-cli': `gemini run --task "${relativePath}"`,
+        'claude-code': `claude -p "$(cat \\"${relativePath}\\")"`,
+    };
+    const cliCommand = AGENT_CLI[task.agent] || `# Open and run: ${relativePath}`;
     return { success: true, filePath, prompt: content, cliCommand };
 }

package/dist/cli/commands/brain.js

@@ -3,6 +3,7 @@ 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 skill_token_report_1 = require("../../skill-token-report");
 const token_budget_1 = require("../../token-budget");
 // ─── Brain & Token CLI Commands ──────────────────────────────────────────────
 function registerBrainCommands(program) {
@@ -27,6 +28,23 @@ function registerBrainCommands(program) {
     const token = program
         .command('token')
         .description('Token usage analysis and savings tracking');
+    token
+        .command('skill <skillName>')
+        .description('Show token footprint for a skill SKILL.md and direct references/')
+        .option('-p, --project <path>', 'Project path', process.cwd())
+        .option('--json', 'Emit stable JSON output', false)
+        .option('--baseline <file>', 'Compare against a legacy monolithic file')
+        .action((skillName, opts) => {
+        const report = (0, skill_token_report_1.analyzeSkillTokenFootprint)(skillName, {
+            projectPath: opts.project,
+            baselinePath: opts.baseline,
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        console.log((0, skill_token_report_1.formatSkillTokenReport)(report));
+    });
     token
         .command('report')
         .description('Show current token budget allocation')

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

@@ -44,7 +44,7 @@ Implement the chosen variant using existing design system tokens. …
 `;
 const README = `# .cm/design-studio
 
-Local artifact folder for **cm-design-studio**: variants, checklist, handoff.
+Local artifact folder for the **design-studio** flow: variants, checklist, handoff.
 
 Happy path:
 

package/dist/cm-suggest.js

@@ -50,13 +50,13 @@ function suggestFromContext(projectPath) {
         out.push({ skill: 'cm-dockit', reason: 'Markdown/docs paths changed.' });
     }
     if (/(package\.json|package-lock\.json|pnpm-lock|yarn\.lock)/m.test(joined)) {
-        out.push({ skill: 'cm-test-gate', reason: 'Dependency lockfiles changed; run the test gate.' });
+        out.push({ skill: 'cm-quality-gate', reason: 'Dependency lockfiles changed; run the verification gate.' });
     }
     if (/(\.github\/workflows\/|Dockerfile|fly\.toml|wrangler)/m.test(joined)) {
         out.push({ skill: 'cm-safe-deploy', reason: 'CI or deploy config changed.' });
     }
     if (lines.length > 8) {
-        out.push({ skill: 'cm-git-worktrees', reason: 'Many working-tree changes; consider an isolated worktree.' });
+        out.push({ skill: 'cm-execution', reason: 'Many working-tree changes; consider isolated execution or a clean workspace.' });
     }
     const sprint = (0, sprint_pipeline_1.readSprintState)(root);
     if (sprint && sprint.current_index >= 0 && sprint.current_index < sprint.pipeline.length) {
@@ -69,7 +69,7 @@ function suggestFromContext(projectPath) {
     }
     if (fs_1.default.existsSync(path_1.default.join(root, '.cm', 'config.yaml'))) {
         out.push({
-            skill: 'cm-engineering-meta',
+            skill: 'cm-mcp-engineering',
             reason: '`.cm/config.yaml` present; engineering commands honor shared config.',
         });
     }

package/dist/dashboard-project-summary.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjectActiveAgents = getProjectActiveAgents;
+function getProjectActiveAgents(project, tasks) {
+    return [...new Set([
+            ...(Array.isArray(project.agents) ? project.agents : []),
+            ...tasks.map(t => t.agent).filter(Boolean),
+        ])];
+}