codymaster 5.2.0 → 7.0.1

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) {
@@ -32,13 +65,14 @@ 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();
@@ -54,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')
@@ -413,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')
@@ -585,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/install.js

@@ -0,0 +1,160 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInstallCommands = registerInstallCommands;
+const chalk_1 = __importDefault(require("chalk"));
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const engine_1 = require("../../install/engine");
+const profiles_1 = require("../../install/profiles");
+const repoRoot = path_1.default.join(__dirname, '..', '..', '..');
+function registerInstallCommands(program) {
+    program
+        .command('install [platform]')
+        .description('Install CodyMaster skills to an AI coding platform')
+        .option('-p, --profile <name>', 'Skill profile: core | growth | design | knowledge | full', 'full')
+        .option('-s, --scope <scope>', 'Install scope for platforms that support it: user | project', 'user')
+        .option('--all', 'Install to every detected platform')
+        .option('--list', 'List supported platforms and exit')
+        .option('--sync', 'Sync skills to all platforms after install')
+        .option('--dry-run', 'Show what would change without writing any files')
+        .action((platform, opts) => __awaiter(this, void 0, void 0, function* () {
+        if (opts.list)
+            return printPlatforms();
+        const profile = String(opts.profile);
+        if (!(0, profiles_1.isValidProfile)(profile)) {
+            console.error(chalk_1.default.red(`Invalid profile: ${profile}`));
+            console.error(chalk_1.default.dim('Valid: core, growth, design, knowledge, full'));
+            process.exit(1);
+        }
+        if (opts.scope !== 'user' && opts.scope !== 'project') {
+            console.error(chalk_1.default.red(`Invalid scope: ${opts.scope} (expected user|project)`));
+            process.exit(1);
+        }
+        const installOpts = {
+            profile: profile,
+            scope: opts.scope,
+            dryRun: !!opts.dryRun,
+        };
+        let targets;
+        if (opts.all) {
+            targets = (0, engine_1.detectPlatforms)()
+                .filter((p) => p.installed)
+                .map((p) => p.platform.id);
+            if (targets.length === 0) {
+                console.error(chalk_1.default.red('No installed AI platforms detected.'));
+                console.error(chalk_1.default.dim("Pass a platform id explicitly: cm install claude-code"));
+                process.exit(1);
+            }
+        }
+        else if (platform) {
+            targets = [platform];
+        }
+        else {
+            printPlatforms();
+            console.log(chalk_1.default.dim('\nUsage: cm install <platform> [--profile core] [--scope user|project]'));
+            return;
+        }
+        console.log(chalk_1.default.bold(`\nInstalling profile=${profile} scope=${opts.scope}${opts.dryRun ? ' (dry-run)' : ''}`));
+        const results = yield (0, engine_1.installToMany)(targets, installOpts);
+        for (const r of results) {
+            console.log('');
+            console.log(chalk_1.default.bold.magenta(`  ${r.platform}`));
+            console.log(chalk_1.default.dim(`  → ${r.targetPath}`));
+            console.log(chalk_1.default.green(`  ✓ ${r.installed.length} skills installed`) + chalk_1.default.dim(` (${r.skipped.length} skipped)`));
+            for (const h of r.postInstallHints)
+                console.log(chalk_1.default.cyan(`  ℹ  ${h}`));
+        }
+        // Auto-sync if --sync flag or --all flag
+        if ((opts.sync || opts.all) && !opts.dryRun) {
+            console.log(chalk_1.default.bold('\n  Syncing skills to all platforms...'));
+            try {
+                (0, child_process_1.execSync)('node scripts/build-skills.mjs --all-platforms', {
+                    stdio: 'inherit',
+                    cwd: repoRoot,
+                    timeout: 60000,
+                });
+                console.log(chalk_1.default.green('  ✅ Skills synced to all platforms'));
+            }
+            catch (error) {
+                console.log(chalk_1.default.yellow('  ⚠️  Sync failed (run `cm update --sync` manually)'));
+            }
+        }
+        console.log('');
+    }));
+    // ─── Doctor Command ─────────────────────────────────────────
+    program
+        .command('doctor')
+        .description('Check which AI platforms are installed and which have CodyMaster skills')
+        .option('--sync-check', 'Check skill sync status across platforms')
+        .action((opts) => {
+        console.log(chalk_1.default.bold('\nDetected platforms:\n'));
+        for (const d of (0, engine_1.detectPlatforms)()) {
+            const mark = d.installed ? chalk_1.default.green('●') : chalk_1.default.dim('○');
+            const detail = d.detail ? chalk_1.default.dim(`  (${d.detail})`) : '';
+            console.log(`  ${mark} ${d.platform.emoji}  ${d.platform.name}${detail}`);
+        }
+        // Sync check
+        if (opts.syncCheck) {
+            console.log(chalk_1.default.bold('\n  Sync Status:\n'));
+            checkSyncStatus();
+        }
+        console.log('');
+    });
+}
+function checkSyncStatus() {
+    const platforms = [
+        { name: 'claude-code', dir: '.claude/skills' },
+        { name: 'claude-desktop', dir: '.claude-desktop/skills' },
+        { name: 'cursor', dir: '.cursor-plugin/skills' },
+        { name: 'windsurf', dir: '.windsurf/skills' },
+        { name: 'antigravity', dir: '.gemini/skills' },
+        { name: 'codex', dir: '.codex/skills' },
+        { name: 'opencode', dir: '.opencode/skills' },
+        { name: 'cline', dir: '.cline/skills' },
+        { name: 'kiro', dir: '.kiro/skills' },
+        { name: 'copilot', dir: '.copilot/skills' },
+        { name: 'aider', dir: '.aider/skills' },
+        { name: 'continue', dir: '.continue/skills' },
+        { name: 'amazon-q', dir: '.amazonq/skills' },
+        { name: 'amp', dir: '.amp/skills' },
+    ];
+    let synced = 0;
+    let missing = 0;
+    for (const p of platforms) {
+        const fullPath = path_1.default.join(repoRoot, p.dir);
+        const hasShared = fs_1.default.existsSync(path_1.default.join(fullPath, '_shared', 'helpers.md'));
+        if (hasShared) {
+            synced++;
+        }
+        else {
+            missing++;
+            console.log(chalk_1.default.yellow(`    ⚠ ${p.name}: _shared/helpers.md missing`));
+        }
+    }
+    if (missing === 0) {
+        console.log(chalk_1.default.green(`    ✅ All ${synced} platforms synced`));
+    }
+    else {
+        console.log(chalk_1.default.dim(`    ${synced} synced, ${missing} missing`));
+        console.log(chalk_1.default.dim('    Run `cm update --sync` to fix.'));
+    }
+}
+function printPlatforms() {
+    console.log(chalk_1.default.bold('\nSupported platforms:\n'));
+    for (const p of (0, engine_1.listPlatforms)()) {
+        console.log(`  ${p.emoji}  ${chalk_1.default.cyan(p.id.padEnd(16))} ${chalk_1.default.dim(p.name)}`);
+    }
+}

package/dist/cli/commands/learn.js

@@ -0,0 +1,181 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncLearnings = syncLearnings;
+exports.registerLearnCommands = registerLearnCommands;
+const chalk_1 = __importDefault(require("chalk"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const fs_1 = __importDefault(require("fs"));
+const child_process_1 = require("child_process");
+const learnings_1 = require("../../learnings");
+const VALID_TYPES = ['pitfall', 'preference', 'pattern', 'fact'];
+function resolveProject(opts) {
+    var _a;
+    return path_1.default.resolve((_a = opts.project) !== null && _a !== void 0 ? _a : process.cwd());
+}
+function git(cwd, args) {
+    return (0, child_process_1.execFileSync)('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+}
+function syncLearnings(projectPath, opts) {
+    var _a;
+    const syncDir = (_a = opts.syncDir) !== null && _a !== void 0 ? _a : path_1.default.join(os_1.default.homedir(), '.cm', 'learnings-sync');
+    const remoteFile = path_1.default.join(syncDir, 'learnings.jsonl');
+    if (!fs_1.default.existsSync(path_1.default.join(syncDir, '.git'))) {
+        fs_1.default.mkdirSync(path_1.default.dirname(syncDir), { recursive: true });
+        if (fs_1.default.existsSync(syncDir)) {
+            // Existing non-git dir — abort rather than wipe.
+            throw new Error(`${syncDir} exists but is not a git checkout`);
+        }
+        git(path_1.default.dirname(syncDir), ['clone', opts.remote, path_1.default.basename(syncDir)]);
+        // Ensure a local identity exists so commits succeed even when the host
+        // has no global git config (CI runners, fresh containers).
+        try {
+            git(syncDir, ['config', 'user.email', 'cm-learn-sync@codymaster.local']);
+        }
+        catch (_b) { }
+        try {
+            git(syncDir, ['config', 'user.name', 'cm-learn-sync']);
+        }
+        catch (_c) { }
+    }
+    else {
+        // Make sure we point at the requested remote, then refresh.
+        try {
+            git(syncDir, ['remote', 'set-url', 'origin', opts.remote]);
+        }
+        catch (_d) {
+            git(syncDir, ['remote', 'add', 'origin', opts.remote]);
+        }
+        try {
+            git(syncDir, ['pull', '--ff-only', 'origin', 'HEAD']);
+        }
+        catch (_e) {
+            // Empty repo / unborn HEAD — ignore; nothing to pull.
+        }
+    }
+    const localFile = (0, learnings_1.learningsPath)(projectPath);
+    const localBefore = (0, learnings_1.readLearningsFile)(localFile);
+    const remoteBefore = (0, learnings_1.readLearningsFile)(remoteFile);
+    const merged = (0, learnings_1.mergeLearnings)(localBefore, remoteBefore);
+    // Local: write merged set verbatim (keeps full fidelity for the user).
+    (0, learnings_1.writeLearningsFile)(localFile, merged);
+    const pulled = merged.length - localBefore.length;
+    if (opts.pullOnly) {
+        return { pulled, pushed: 0, localTotal: merged.length };
+    }
+    // Remote: write anonymized merge.
+    const anonMerged = (0, learnings_1.mergeLearnings)(remoteBefore, localBefore.map(learnings_1.anonymize));
+    (0, learnings_1.writeLearningsFile)(remoteFile, anonMerged);
+    const pushed = anonMerged.length - remoteBefore.length;
+    if (pushed > 0) {
+        git(syncDir, ['add', 'learnings.jsonl']);
+        try {
+            git(syncDir, ['commit', '-m', `learn: +${pushed} from ${path_1.default.basename(projectPath)}`]);
+            git(syncDir, ['push', 'origin', 'HEAD']);
+        }
+        catch (e) {
+            // Bubble up so the caller can decide; non-zero pushes left in local mirror are fine.
+            throw new Error(`git push failed: ${e.message}`);
+        }
+    }
+    return { pulled, pushed, localTotal: merged.length };
+}
+function registerLearnCommands(program) {
+    program
+        .command('learn <cmd> [args...]')
+        .description('Per-project learnings log (.cm/learnings.jsonl) — gstack-style notes')
+        .option('-p, --project <path>', 'Project path (default: cwd)')
+        .option('-t, --type <type>', 'pitfall | preference | pattern | fact', 'fact')
+        .option('-s, --scope <scope>', 'Scope tag (deploy, ui, test, ...)', 'general')
+        .option('--source <source>', 'Origin label (e.g. cm-retro-cli)', 'manual')
+        .option('--days <n>', 'For prune: max age in days', '180')
+        .option('--limit <n>', 'For list: max rows', '20')
+        .option('--filter-type <type>', 'For list: filter by type')
+        .option('--filter-scope <scope>', 'For list: filter by scope')
+        .option('--remote <url>', 'For sync: git remote URL of the shared learnings repo')
+        .option('--pull-only', 'For sync: pull + merge only, do not push back')
+        .option('--sync-dir <path>', 'For sync: working dir (default: ~/.cm/learnings-sync)')
+        .action((cmd, args, opts) => {
+        const project = resolveProject(opts);
+        switch (cmd) {
+            case 'add': {
+                const note = args.join(' ').trim();
+                if (!note) {
+                    console.error(chalk_1.default.red('Usage: cm learn add "<note>"  [--type ... --scope ...]'));
+                    process.exitCode = 1;
+                    return;
+                }
+                if (!VALID_TYPES.includes(opts.type)) {
+                    console.error(chalk_1.default.red(`Invalid --type. Use one of: ${VALID_TYPES.join(', ')}`));
+                    process.exitCode = 1;
+                    return;
+                }
+                try {
+                    const l = (0, learnings_1.addLearning)(project, {
+                        type: opts.type,
+                        scope: opts.scope,
+                        note,
+                        source: opts.source,
+                    });
+                    console.log(chalk_1.default.green(`✓ Learned [${l.type}/${l.scope}]: ${l.note}`));
+                }
+                catch (e) {
+                    console.error(chalk_1.default.red(`✗ ${e.message}`));
+                    process.exitCode = 1;
+                }
+                return;
+            }
+            case 'list':
+            case 'ls': {
+                const items = (0, learnings_1.listLearnings)(project, {
+                    limit: parseInt(opts.limit, 10),
+                    type: opts.filterType,
+                    scope: opts.filterScope,
+                });
+                if (items.length === 0) {
+                    console.log(chalk_1.default.dim('(no learnings yet)'));
+                    return;
+                }
+                for (const l of items) {
+                    const date = l.ts.slice(0, 10);
+                    console.log(`${chalk_1.default.gray(date)} ${chalk_1.default.cyan(l.type.padEnd(10))} ${chalk_1.default.yellow(l.scope.padEnd(12))} ${l.note}`);
+                }
+                console.log(chalk_1.default.dim(`\n${items.length} learning(s)`));
+                return;
+            }
+            case 'prune': {
+                const days = parseInt(opts.days, 10);
+                const n = (0, learnings_1.pruneLearnings)(project, days);
+                console.log(chalk_1.default.green(`✓ Pruned ${n} learning(s) older than ${days} days`));
+                return;
+            }
+            case 'sync': {
+                if (!opts.remote) {
+                    console.error(chalk_1.default.red('Usage: cm learn sync --remote <git-url> [--pull-only]'));
+                    process.exitCode = 1;
+                    return;
+                }
+                try {
+                    const result = syncLearnings(project, {
+                        remote: opts.remote,
+                        pullOnly: !!opts.pullOnly,
+                        syncDir: opts.syncDir,
+                    });
+                    console.log(chalk_1.default.green(`✓ sync ok — pulled=${result.pulled} pushed=${result.pushed} local=${result.localTotal}`));
+                }
+                catch (e) {
+                    console.error(chalk_1.default.red(`✗ sync failed: ${e.message}`));
+                    process.exitCode = 1;
+                }
+                return;
+            }
+            default:
+                console.error(chalk_1.default.red(`Unknown subcommand: ${cmd}`));
+                console.log(chalk_1.default.dim('Available: add, list, prune, sync'));
+                process.exitCode = 1;
+        }
+    });
+}