codymaster 4.6.0 → 4.8.0

package/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to this project will be documented in this file.
 
 Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 
+## [4.8.0] - 2026-04-10
+
+### 🚀 Improvements — Documentation site & README accuracy
+
+- **VitePress documentation** — Rebuilt `docs/` as a browsable site with sidebar IA (Getting Started, Architecture, Operations, Skills Library, API, Resources). Config: `docs/.vitepress/config.mts`. Local preview: `npm run docs:dev`; production build: `npm run docs:build`.
+- **Skills index** — Documented all **56** bundled `skills/cm-*/SKILL.md` packs with category pages under `docs/skills/`.
+- **API hub** — Added `docs/api/api-reference.md` (CLI + dashboard + browse daemon + MCP tools) aligned to `src/mcp-context-server.ts` (**13** MCP tools).
+- **README refresh (all languages)** — Version badges bumped to **4.8.0**; broken `docs/` links replaced; CLI examples updated to match `src/cli/command-registry.ts` (no fictional `cm continuity` / `cm list` commands). License callouts aligned to **ISC** (`package.json`).
+- **npm scripts** — `docs:dev`, `docs:build`, `docs:preview` for maintainers.
+
+## [4.7.0] - 2026-04-02
+
+### 🚀 Improvements — Zero-Touch Installation & Advanced Pipeline
+
+- **Zero-Touch CLI Installation** — `install.sh` and `scripts/postinstall.js` overhauled to automatically activate the `cm` CLI. The script supports `--auto` for non-interactive `npm install -g codymaster`, while NPM seamlessly executes `npm link` or global install.
+- **OpenViking Core Feature** — Integrated OpenViking installation via `pip/pip3` natively into the installation process. Both `bash install.sh --all` and `npm i codymaster` will now automatically set up the OpenViking daemon, unlocking true semantic vector graph memory out-of-the-box.
+- **Skill Chain Auto-Dispatch** — Inspired by OpenSpace orchestrations, `cm-skill-chain` received a massive upgrade. Re-introduced the missing `auto` command enabling intelligent task detection, auto-selection of tools, and 100% automated handoffs between multi-agent sequences without human intervention.
+- **Systematic Auto-healing** — Enhancements to `postinstall.js` for automatic fallbacks across different OS privileges and execution environments.
+
 ## [4.6.0] - 2026-04-02
 
 ### 🚀 Improvements — OpenViking Backend (Real Implementation)
@@ -74,7 +93,6 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
   - `cm-skill-evolution` — 3-mode evolution engine (FIX/DERIVED/CAPTURED) with version DAG and lineage tracking. Auto-patches degraded skills.
   - `cm-skill-search` — BM25 + health-score ranking for intelligent skill discovery.
   - `cm-skill-share` — Export/import skills across teams and machines with version integrity.
-- **🏢 cm-frappe-agent** — Full-stack Frappe/ERPNext development agent with 7-layer architecture: doctypes, workflows, REST APIs, permissions, fixtures, performance optimization, and production deploys.
 - **🚀 Growth Hacking Engine** — `cm-growth-hacking` generates complete conversion systems (Bottom Sheet + Calendar CTA + Tracking) with industry auto-detection.
 - **cm-auto-publisher** — Publishing automation bridge: AI agents → Content Factory Router → any Astro site.
 - **cm-clean-code** — TRIZ-powered code hygiene gate: dead code detection, duplicate elimination, naming analysis.

package/README.md

@@ -9,10 +9,10 @@
 **68+ Skills · 18 Commands · 1 Plugin · 7+ Platforms · 6 Languages**
 
 <p align="center">
-  <img alt="Version" src="https://img.shields.io/badge/version-4.6.0-blue.svg?cacheSeconds=2592000" />
+  <img alt="Version" src="https://img.shields.io/badge/version-4.8.0-blue.svg?cacheSeconds=2592000" />
   <img alt="Skills" src="https://img.shields.io/badge/skills-68+-success.svg" />
   <img alt="Platforms" src="https://img.shields.io/badge/platforms-7+-orange.svg" />
-  <img alt="Open Source" src="https://img.shields.io/badge/license-MIT-purple.svg" />
+  <img alt="Open Source" src="https://img.shields.io/badge/license-ISC-purple.svg" />
   <a href="https://github.com/tody-agent/codymaster#readme" target="_blank">
     <img alt="Documentation" src="https://img.shields.io/badge/documentation-yes-brightgreen.svg" />
   </a>
@@ -71,7 +71,7 @@ graph TD
     A --> E["🔒 DevOps Engineer<br/><i>cm-safe-deploy · cm-secret-shield · cm-security-gate · cm-identity-guard</i>"]
     A --> F["📝 Technical Writer<br/><i>cm-dockit · cm-content-factory · cm-auto-publisher</i>"]
     A --> G["📈 Growth Marketer<br/><i>cm-ads-tracker · cm-cro-methodology · cm-growth-hacking</i>"]
-    A --> H["🏭 Enterprise Dev<br/><i>cm-frappe-agent · cm-booking-calendar · cm-google-form</i>"]
+    A --> H["🏭 Enterprise Dev<br/><i>cm-booking-calendar · cm-google-form</i>"]
     style A fill:#fbc531,stroke:#e1b12c,color:#2f3640,stroke-width:3px
     classDef team fill:#2f3640,stroke:#dcdde1,stroke-width:1px,color:#fff;
     class B,C,D,E,F,G,H team;
@@ -121,13 +121,13 @@ Your AI doesn't just execute — it **understands and remembers** using a multi-
 - **cm:// URI Scheme** — Skills request context by URI, not file paths.
 - **Token Budget** — 200k window pre-allocated by category. No more silent overflow.
 - **Context Bus** — Skills share outputs in real-time within a chain.
-- **MCP Server** — 7 tools exposed to Claude Desktop and any MCP client.
-- **OpenViking Backend (optional)** — Swap SQLite for [OpenViking](https://github.com/volcengine/OpenViking): true vector semantic search, auto L0/L1/L2 generation, session compression. One config line: `storage.backend: viking`.
+- **MCP Server** — 13 tools exposed to Claude Desktop and any MCP client (`src/mcp-context-server.ts`).
+- **OpenViking Backend natively integrated** — Inspired by OpenViking's architecture, CodyMaster defaults to `openviking` auto-installation. It delivers true semantic vector graph memory, automatic session compression, and temporal context layering. (One config line change: `storage.backend: viking`).
 
 ☁️ **The Cloud Brain (`cm-notebooklm`)**
 High-value knowledge and design patterns are synced to NotebookLM, providing a universal, cross-machine "Soul" for your project. Auto-generate podcasts and flashcards to onboard human developers alongside the AI.
 
-📖 [Read the full Knowledge Architecture →](docs/architecture/knowledge-architecture.md)
+📖 [CodyMaster Brain & memory model →](docs/architecture/codymaster-brain.md)
 
 ### 🛡️ Multi-Layer Protection (Your Codebase Won't Get Destroyed)
 
@@ -175,7 +175,7 @@ Don't know what the old code does? **`cm-dockit`** reads your entire codebase an
 
 Before diving into code for complex requests, **`cm-brainstorm-idea`** evaluates your product using multi-dimensional analysis (Tech, Product, Design, Business). It generates 2-3 qualified options using the 9 Windows (TRIZ) framework and provides a visual UI Preview via **Pencil.dev** or **Google Stitch** to validate the direction before detailed planning. 
 
-📖 [Read more about the UI Preview Phase →](docs/workflows/brainstorm-ui-preview.md)
+📖 [TRIZ-parallel workflow & UI preview handoff →](docs/architecture/triz-parallel-engine.md)
 
 
 ### 🏭 AI Content Factory v2.0 & Visual Dashboard
@@ -190,15 +190,12 @@ CodyMaster doesn't just run skills — it **watches them, scores them, and heals
 
 - **`cm-skill-health`** monitors every invocation: success rate, token usage, error patterns.
 - **`cm-skill-evolution`** auto-patches degraded skills (Mode: FIX) when health scores drop below threshold.
+- **`cm-skill-chain` Auto-Dispatch** — Inspired by OpenSpace automation orchestrators, sequence dispatching is now 100% automated with intelligent task detection, zero-touch handoffs, and multi-agent coordination.
 - **`cm-skill-search`** uses BM25 ranking to find the right skill for any task.
 - **`cm-skill-share`** exports & imports skills across teams and machines.
 
 > **Think of it like an immune system for your AI toolkit.** Skills that break get healed. Skills that work well get reinforced. Dead skills get archived.
 
-### 🏢 Enterprise-Ready: Frappe/ERPNext Full-Stack
-
-Building on Frappe Framework? **`cm-frappe-agent`** is a 7-layer architecture agent covering the entire Frappe lifecycle — from `bench new-app` to production deploys. Custom doctypes, workflows, REST APIs, permissions, fixtures, and performance optimization — all battle-tested.
-
 ### 🚀 Growth Hacking Engine
 
 Need popups, booking flows, or lead capture? **`cm-growth-hacking`** generates complete conversion systems: Bottom Sheet + Calendar CTA + Tracking. Auto-detects industry, selects the right pattern, wires up **`cm-booking-calendar`** for appointments and **`cm-ads-tracker`** for pixel tracking. Zero dependencies.
@@ -253,12 +250,53 @@ One command installs all 68+ skills to your environment. Supports Claude Code, G
 bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --all
 ```
 
+#### After `install.sh --all` (verify)
+
+- **Restart** Claude Code, Cursor, or Gemini / Antigravity so they reload config and rules from disk.
+- **Cursor:** rules go to **`~/.cursor/rules`** (always under your home folder, not wherever you ran the script). In Agent chat, run **`/add-plugin cody-master`**. To install rules **only inside one git repo**, run from that repo: `bash install.sh --cursor --cursor-project`.
+- **Gemini / Antigravity:** skills live in `~/.gemini/antigravity/skills`. The installer **creates or appends** `~/.gemini/GEMINI.md` with `@~/.gemini/antigravity/skills/cm-skill-index/SKILL.md` when that hint is missing.
+- **Claude Code:** if commands like `/cm:demo` do not appear, run `claude plugin marketplace add tody-agent/codymaster` then `claude plugin install cm@codymaster --scope user` (or `--scope project`).
+- **Non-interactive:** `--all` skips the onboarding menu. For a single platform, add **`--yes`** (e.g. `bash install.sh --gemini --yes`).
+
+#### Google Antigravity / Gemini CLI / Windsurf (token budget)
+
+Antigravity and some Windsurf builds count **skills + MCP** against a customization token budget. Installing every skill globally can trigger truncation or unstable agent runs (especially if an MCP server errors and retries).
+
+- **Recommended:** install a **small global profile**, add the rest per project.
+
+```bash
+# Core only → ~/.gemini/antigravity/skills (merge more profiles later with the same command)
+bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --gemini --profile core
+
+# Optional packs (re-run to add folders alongside core)
+bash install.sh --gemini --profile growth
+bash install.sh --gemini --profile design
+bash install.sh --gemini --profile knowledge
+```
+
+- **Paths:** Antigravity / Gemini CLI skills → `~/.gemini/antigravity/skills`. This repo’s installer for **Windsurf** writes to **project** `.windsurf/rules` when you run `install.sh --windsurf` from a repo root. Some Windsurf/Codeium setups also use a **global** skills directory (e.g. under Codeium); if you copy skills there manually, use the same `--profile` flags to avoid duplicating hundreds of rules.
+- **MCP:** Disable MCP servers you are not using in the IDE settings. Flaky or rate-limited MCPs can cause “MCP Error” loops until the agent terminates.
+- **Progressive disclosure:** Add `@~/.gemini/antigravity/skills/cm-skill-index/SKILL.md` to `GEMINI.md` so the model loads the index before pulling full skills.
+
+Profiles are defined under [`skills/profiles/`](skills/profiles/README.md).
+
 *For Cursor IDE users, you can also just type `/add-plugin cody-master` in your agent chat.*
 
 ### 2. Install Mission Control Dashboard (Optional but Recommended)
 
 Visualize your progress, manage tasks, and track your 10x coding streak with Cody the Hamster 🐹.
 
+**Both are official:** install **per project** (no `-g`) or **globally**.
+
+Per project — keeps the CLI version with the repo (use `npx` so you do not need `cm` on your PATH):
+
+```bash
+npm install codymaster
+npx cm
+```
+
+Global — type `cm` from any directory:
+
 ```bash
 npm install -g codymaster
 cm
@@ -293,7 +331,7 @@ The CLI will greet you and keep you organized on your long coding sessions!
 | ⚙️ **Operations**  | `cm-safe-deploy` `cm-identity-guard` `cm-secret-shield` `cm-security-gate` `cm-git-worktrees` `cm-terminal` `cm-safe-i18n`                                             |
 | 🎨 **Product & UX**  | `cm-planning` `cm-design-system` `cm-ux-master` `cm-ui-preview` `cm-project-bootstrap` `cm-jtbd` `cm-brainstorm-idea` `cm-dockit` `cm-readit` |
 | 📈 **Growth & CRO**    | `cm-content-factory` `cm-auto-publisher` `cm-ads-tracker` `cm-cro-methodology` `cm-growth-hacking` `cm-booking-calendar` `cm-google-form`                                                                                                   |
-| 🏢 **Enterprise**  | `cm-frappe-agent` `cm-reactor` `cm-notebooklm`                                                                                                  |
+| 🏢 **Enterprise**  | `cm-reactor` `cm-notebooklm`                                                                                                  |
 | 🧬 **Self-Healing**   | `cm-skill-health` `cm-skill-evolution` `cm-skill-search` `cm-skill-share` `cm-skill-chain` `cm-skill-mastery` `cm-skill-index`             |
 | 🎯 **Orchestration** | `cm-execution` `cm-continuity` `cm-deep-search` `cm-codeintell` `cm-how-it-work`             |
 | 🖥️ **Workflow**    | `cm-start` `cm-dashboard` `cm-status`                                                                                                                     |
@@ -302,23 +340,32 @@ The CLI will greet you and keep you organized on your long coding sessions!
 
 ## 🎮 Commands
 
+Run `cm --help` (or `node dist/index.js --help` from a clone) for the **authoritative** list. Highlights from `src/cli/command-registry.ts`:
+
+```
+cm, codymaster              → CLI entry
+cm status                   → Task & project summary
+cm task <cmd> [args...]     → Task management
+cm project <cmd> [args...]  → Project management
+cm deploy <cmd> [args...]   → Deploy / rollback / history / changelog
+cm dashboard [start|stop|status|open|url] → Mission Control (default :6969)
+cm agent [status|memory|brain|learn]      → Working memory / learnings
+cm brain                    → Continuity + next actions
+cm chain <cmd> [args...]    → Skill chain execution
+cm config [key] [value]   → Config helper
+cm open                     → Open dashboard in browser
+cm browse …                 → Local Playwright browse daemon (QA)
+cm guardian …               → Destructive-command / path checks
+cm sprint …                 → Sprint pipeline + .cm/sprint
+cm design-studio [init|status]
+cm distro validate …        → Validate skill pack layout
 ```
-cm                          → Quick menu with Cody 🐹
-cm task add "..."           → Add a task
-cm task list                → View tasks
-cm status                   → Project health
-cm dashboard                → Open Mission Control
-cm list                     → Browse 68+ skills
-cm profile                  → Your stats & achievements
-cm deploy <env>             → Record deployment
-cm continuity index         → Regenerate L0 memory indexes
-cm continuity budget        → Show token budget allocation
-cm continuity bus           → View context bus state
-cm continuity mcp           → Print MCP server config
-cm continuity migrate       → Migrate JSON → SQLite
-cm continuity export        → Export SQLite → JSON
-cm resolve <uri>            → Resolve any cm:// URI
 
+**Memory, bus, budgets, `cm://` resolution:** use the **MCP context server** — see [docs/api/api-reference.md](docs/api/api-reference.md).
+
+**Engineering (browse, guardian, sprint):** [docs/workflows/engineering-pipeline.md](docs/workflows/engineering-pipeline.md) · [docs/architecture/servers-and-mcp.md](docs/architecture/servers-and-mcp.md)
+
+```bash
 # OpenViking backend (optional — semantic vector search)
 pip install openviking && openviking start
 # Then set storage.backend: viking in .cm/config.yaml
@@ -349,8 +396,9 @@ pip install openviking && openviking start
 ## 📚 Resources
 
 - 🌍 [Website](https://cody.todyle.com) — Overview & demos
-- 📖 [Documentation](https://cody.todyle.com/docs) — Full deep-dive
-- 🛠️ [Skills Reference](skills/) — Browse all 68+ SKILL.md files
+- 📖 [Documentation (site)](https://cody.todyle.com/docs) — Hosted deep-dive
+- 📘 [Documentation (repo)](docs/index.md) — Markdown source; run `npm run docs:dev` for VitePress
+- 🛠️ [Skills Reference](skills/) — Browse **56** bundled `cm-*` SKILL.md packs (profiles/installer can add more)
 - 📖 [Our Story](https://cody.todyle.com/story) — Why this exists
 
 ---
@@ -361,11 +409,13 @@ pip install openviking && openviking start
 2. Fork → Create `skills/cm-your-skill/SKILL.md`
 3. Submit a Pull Request
 
+CI runs `npm ci` and `npm run test:gate:kit` on pushes and pull requests (see `.github/workflows/ci.yml`).
+
 ---
 
 <div align="center">
 
-*MIT License — Free to use, modify, and distribute.* `<br/>`
+*ISC License — Free to use, modify, and distribute.* <br/>
 **Built with ❤️ for the vibe coding community.**
 
 *"CodyMaster" = "Code Đi" (Vietnamese: "Go code!") — just start building.*

package/dist/browse-server.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * Local HTTP browse daemon (Playwright + Express). Bearer auth.
+ * Refs: POST /refs/refresh tags interactive elements with data-cm-ref.
+ */
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowseDaemon = void 0;
+const express_1 = __importDefault(require("express"));
+function createRing(max) {
+    const buf = [];
+    return {
+        push(item) {
+            buf.push(item);
+            while (buf.length > max)
+                buf.shift();
+        },
+        snapshot: () => [...buf],
+    };
+}
+class BrowseDaemon {
+    constructor(opts) {
+        this.opts = opts;
+        this.app = (0, express_1.default)();
+        this.httpServer = null;
+        this.browser = null;
+        this.context = null;
+        this.page = null;
+        this.consoleBuf = createRing(200);
+        this.networkBuf = createRing(200);
+        this.refMap = {};
+        this.app.use(express_1.default.json({ limit: '2mb' }));
+        this.app.use(this.authMiddleware.bind(this));
+        this.routes();
+    }
+    authMiddleware(req, res, next) {
+        if (req.path === '/health')
+            return next();
+        const h = req.headers.authorization || '';
+        const want = `Bearer ${this.opts.token}`;
+        if (h !== want) {
+            res.status(401).json({ error: 'unauthorized' });
+            return;
+        }
+        next();
+    }
+    routes() {
+        this.app.get('/health', (_req, res) => {
+            res.json({ ok: true, hasPage: !!this.page });
+        });
+        this.app.post('/session/start', (req, res) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            try {
+                const headless = (_c = (_b = (_a = req.body) === null || _a === void 0 ? void 0 : _a.headless) !== null && _b !== void 0 ? _b : this.opts.headless) !== null && _c !== void 0 ? _c : true;
+                const pw = yield Promise.resolve().then(() => __importStar(require('playwright')));
+                this.browser = yield pw.chromium.launch({ headless });
+                this.context = yield this.browser.newContext();
+                this.page = yield this.context.newPage();
+                this.page.on('console', (msg) => {
+                    this.consoleBuf.push({
+                        type: msg.type(),
+                        text: msg.text(),
+                        ts: new Date().toISOString(),
+                    });
+                });
+                this.context.on('response', (response) => {
+                    try {
+                        this.networkBuf.push({
+                            url: response.url(),
+                            method: response.request().method(),
+                            status: response.status(),
+                            ts: new Date().toISOString(),
+                        });
+                    }
+                    catch (_a) {
+                        /* ignore */
+                    }
+                });
+                res.json({ ok: true });
+            }
+            catch (e) {
+                res.status(500).json({ error: e.message });
+            }
+        }));
+        this.app.post('/navigate', (req, res) => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            try {
+                const url = (_a = req.body) === null || _a === void 0 ? void 0 : _a.url;
+                if (!url || !this.page) {
+                    res.status(400).json({ error: 'url required and session must be started' });
+                    return;
+                }
+                yield this.page.goto(url, { waitUntil: 'domcontentloaded', timeout: 60000 });
+                res.json({ ok: true, url: this.page.url() });
+            }
+            catch (e) {
+                res.status(500).json({ error: e.message });
+            }
+        }));
+        this.app.post('/refs/refresh', (_req, res) => __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (!this.page) {
+                    res.status(400).json({ error: 'no session' });
+                    return;
+                }
+                const mapping = yield this.page.evaluate(() => {
+                    const sel = 'a[href],button,input,textarea,select,[role="button"],[onclick]';
+                    const nodes = Array.from(document.querySelectorAll(sel));
+                    const out = {};
+                    nodes.forEach((el, i) => {
+                        const id = `e${i + 1}`;
+                        el.setAttribute('data-cm-ref', id);
+                        const tag = el.tagName.toLowerCase();
+                        const txt = (el.textContent || '').trim().slice(0, 80);
+                        out[id] = `${tag}${txt ? `: ${txt}` : ''}`;
+                    });
+                    return out;
+                });
+                this.refMap = mapping;
+                res.json({ ok: true, refs: mapping });
+            }
+            catch (e) {
+                res.status(500).json({ error: e.message });
+            }
+        }));
+        this.app.post('/click', (req, res) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            try {
+                const ref = (_b = (_a = req.body) === null || _a === void 0 ? void 0 : _a.ref) === null || _b === void 0 ? void 0 : _b.replace(/^@/, '');
+                if (!ref || !this.page) {
+                    res.status(400).json({ error: 'ref required' });
+                    return;
+                }
+                yield this.page.click(`[data-cm-ref="${ref}"]`, { timeout: 15000 });
+                res.json({ ok: true });
+            }
+            catch (e) {
+                res.status(500).json({ error: e.message });
+            }
+        }));
+        this.app.post('/fill', (req, res) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            try {
+                const ref = (_b = (_a = req.body) === null || _a === void 0 ? void 0 : _a.ref) === null || _b === void 0 ? void 0 : _b.replace(/^@/, '');
+                const value = (_c = req.body) === null || _c === void 0 ? void 0 : _c.value;
+                if (!ref || value === undefined || !this.page) {
+                    res.status(400).json({ error: 'ref and value required' });
+                    return;
+                }
+                yield this.page.fill(`[data-cm-ref="${ref}"]`, value, { timeout: 15000 });
+                res.json({ ok: true });
+            }
+            catch (e) {
+                res.status(500).json({ error: e.message });
+            }
+        }));
+        this.app.get('/screenshot', (_req, res) => __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (!this.page) {
+                    res.status(400).json({ error: 'no session' });
+                    return;
+                }
+                const buf = yield this.page.screenshot({ type: 'png' });
+                res.setHeader('Content-Type', 'image/png');
+                res.send(buf);
+            }
+            catch (e) {
+                res.status(500).json({ error: e.message });
+            }
+        }));
+        this.app.get('/console', (_req, res) => {
+            res.json({ entries: this.consoleBuf.snapshot() });
+        });
+        this.app.get('/network', (_req, res) => {
+            res.json({ entries: this.networkBuf.snapshot() });
+        });
+    }
+    listen() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const host = this.opts.host || '127.0.0.1';
+            const port = (_a = this.opts.port) !== null && _a !== void 0 ? _a : 17395;
+            return new Promise((resolve, reject) => {
+                this.httpServer = this.app.listen(port, host, () => resolve());
+                this.httpServer.on('error', reject);
+            });
+        });
+    }
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.page)
+                yield this.page.close().catch(() => { });
+            if (this.context)
+                yield this.context.close().catch(() => { });
+            if (this.browser)
+                yield this.browser.close().catch(() => { });
+            this.page = null;
+            this.context = null;
+            this.browser = null;
+            if (this.httpServer) {
+                yield new Promise((r) => this.httpServer.close(() => r()));
+                this.httpServer = null;
+            }
+        });
+    }
+}
+exports.BrowseDaemon = BrowseDaemon;

package/dist/cli/command-registry.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAllCommands = registerAllCommands;
+const agent_1 = require("./commands/agent");
+const dashboard_1 = require("./commands/dashboard");
+const project_1 = require("./commands/project");
+const skill_chain_1 = require("./commands/skill-chain");
+const system_1 = require("./commands/system");
+const task_1 = require("./commands/task");
+const engineering_1 = require("./commands/engineering");
+const design_studio_1 = require("./commands/design-studio");
+const distro_1 = require("./commands/distro");
+/**
+ * Registers all CLI commands with the provided program instance.
+ */
+function registerAllCommands(program) {
+    (0, agent_1.registerAgentCommands)(program);
+    (0, dashboard_1.registerDashboardCommands)(program);
+    (0, project_1.registerProjectCommands)(program);
+    (0, skill_chain_1.registerSkillChainCommands)(program);
+    (0, system_1.registerSystemCommands)(program);
+    (0, task_1.registerTaskCommands)(program);
+    (0, engineering_1.registerEngineeringCommands)(program);
+    (0, design_studio_1.registerDesignStudioCommands)(program);
+    (0, distro_1.registerDistroCommands)(program);
+}

package/dist/cli/commands/agent.js

@@ -0,0 +1,120 @@
+"use strict";
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgentCommands = registerAgentCommands;
+const continuity_1 = require("../../continuity");
+const box_1 = require("../../ui/box");
+const theme_1 = require("../../ui/theme");
+const cli_utils_1 = require("../../utils/cli-utils");
+function registerAgentCommands(program) {
+    program
+        .command('agent [cmd] [args...]')
+        .alias('a')
+        .description('Agent management (status|memory|brain|learn)')
+        .action((cmd, args) => {
+        switch (cmd) {
+            case 'status':
+            case 'st':
+                agentStatus();
+                break;
+            case 'memory':
+            case 'mem':
+                agentMemory();
+                break;
+            case 'brain':
+            case 'br':
+                agentBrain();
+                break;
+            case 'learn':
+                agentLearn(args.join(' '));
+                break;
+            default: agentStatus();
+        }
+    });
+    program
+        .command('brain')
+        .alias('br')
+        .description('Show AI brain/working memory')
+        .action(() => agentBrain());
+}
+function agentStatus() {
+    const summary = (0, continuity_1.getContinuityStatus)(process.cwd());
+    if (!summary.initialized) {
+        console.log((0, box_1.renderResult)('warning', 'No active CodyMaster brain initialized in this directory.', [
+            (0, theme_1.dim)('Run `cm init` to start.')
+        ]));
+        return;
+    }
+    console.log((0, box_1.renderCommandHeader)('Agent Status: Hamster v4.6', '🐹'));
+    console.log((0, theme_1.brand)('  🧠 Memory Index:'));
+    console.log((0, theme_1.dim)(`    Iterations: ${summary.iteration}`));
+    console.log((0, theme_1.dim)(`    Current Goal: ${summary.activeGoal}`));
+    console.log((0, theme_1.dim)(`    Current Phase: ${summary.phase}`));
+    console.log((0, theme_1.dim)(`    Tasks Completed: ${summary.completedCount}`));
+    console.log((0, theme_1.dim)(`    Active Blockers: ${summary.blockerCount}`));
+    console.log(`\n  ${(0, theme_1.brand)('📊 Activity Summary:')}`);
+    console.log((0, theme_1.dim)(`    Learnings: ${summary.learningCount}`));
+    console.log((0, theme_1.dim)(`    Decisions: ${summary.decisionCount}`));
+    console.log();
+}
+function agentMemory() {
+    const learnings = (0, continuity_1.getLearnings)(process.cwd()).slice(0, 5);
+    if (learnings.length === 0) {
+        console.log((0, box_1.renderResult)('info', 'No memories stored yet.'));
+        return;
+    }
+    console.log((0, box_1.renderCommandHeader)('Agent Memory (Latest)', '🧠'));
+    learnings.forEach((l) => {
+        console.log(`  ${(0, theme_1.success)('●')} ${(0, theme_1.brand)(l.whatFailed)}`);
+        console.log((0, theme_1.dim)(`    ${l.howToPrevent} (${(0, cli_utils_1.formatTimeAgoCli)(l.timestamp)})`));
+    });
+    console.log();
+}
+function agentBrain() {
+    const state = (0, continuity_1.readContinuityState)(process.cwd());
+    if (!state) {
+        console.log((0, box_1.renderResult)('warning', 'Brain not initialized.'));
+        return;
+    }
+    console.log((0, box_1.renderCommandHeader)(`Agent Brain: ${state.project}`, '🧠'));
+    console.log((0, theme_1.brand)(`  Goal: ${state.activeGoal}`));
+    console.log((0, theme_1.dim)(`  Phase: ${state.currentPhase} (Iter ${state.currentIteration})`));
+    console.log(`\n  ${(0, theme_1.brand)('Next Actions:')}`);
+    state.nextActions.slice(0, 5).forEach((act, idx) => {
+        console.log(`    ${idx + 1}. ${act}`);
+    });
+    if (state.activeBlockers.length > 0) {
+        console.log(`\n  ${(0, theme_1.warning)('Blockers:')}`);
+        state.activeBlockers.forEach((b) => console.log(`    ⚠️ ${b}`));
+    }
+    console.log();
+}
+function agentLearn(content) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (!content) {
+            console.log((0, box_1.renderResult)('error', 'Please provide a learning to record.'));
+            return;
+        }
+        const state = (0, continuity_1.readContinuityState)(process.cwd());
+        const learning = {
+            whatFailed: content,
+            whyFailed: 'Manual entry',
+            howToPrevent: 'Recorded via CLI',
+            timestamp: new Date().toISOString(),
+            agent: 'CLI User',
+            taskId: ((_a = state === null || state === void 0 ? void 0 : state.currentTask) === null || _a === void 0 ? void 0 : _a.id) || 'manual',
+            module: 'system'
+        };
+        (0, continuity_1.addLearning)(process.cwd(), learning);
+        console.log((0, box_1.renderResult)('success', 'Learning recorded in brain.'));
+    });
+}