compact-agent 1.10.0 → 1.11.0

package/dist/index.js

@@ -28,7 +28,7 @@ import { detectPackageManager, detectTestRunner, detectBuildTool } from './packa
 import { buildCoveragePrompt } from './coverage.js';
 import { buildRefactorPrompt, buildCleanupPrompt } from './refactor.js';
 import { buildDocsUpdatePrompt } from './docs-sync.js';
-import { printSkillList, evolveInstinctsToSkills } from './skills.js';
+import { listSkills, printSkillList, evolveInstinctsToSkills } from './skills.js';
 import { onSessionStart, onSessionEnd, printMemoryStatus } from './memory.js';
 import { incrementCounter, decrementCounter, resetCounter, getCounter } from './counter.js';
 import { createUser, setActiveUser, deleteUser, setUserMetadata, getUserMetadata, printUserList, } from './users.js';
@@ -50,7 +50,7 @@ import { printHookControlStatus } from './hook-controls.js';
 // PM2 manager
 import { buildPM2Prompt, isPM2Available, listPM2Services } from './pm2-manager.js';
 // ECC (everything-claude-code) integration
-import { installEcc, getEccCommandPrompt, loadEccState, eccResourcesAvailable, reseedEccHooks, } from './ecc.js';
+import { installEcc, getEccCommandPrompt, loadEccState, eccResourcesAvailable, reseedEccHooks, BUNDLE_VERSION as ECC_BUNDLE_VERSION, } from './ecc.js';
 // Walkthrough — agent-led tour of Crowcoder (/walkthrough, /tour, /guide)
 import { buildWalkthroughPrompt } from './walkthrough.js';
 // Stitch (Google's AI UI/UX design tool) — /stitch, /stitch-config, /stitch-tools
@@ -105,6 +105,16 @@ async function setupWizard(rl) {
     console.log(chalk.dim('  3. yolo  — approve everything (fastest)\n'));
     const permChoice = await rl.question(chalk.yellow('  Permission mode [1]: '));
     const permMode = ['ask', 'auto', 'yolo'][parseInt(permChoice || '1', 10) - 1] || 'ask';
+    // ── MemPalace memory setup ──────────────────────────────
+    // Featured capability, opt-out at setup time. Explain briefly so the
+    // user can make an informed choice — most users want this on.
+    console.log(chalk.white('\n  MemPalace persistent memory'));
+    console.log(chalk.dim('  Lets the agent remember your preferences, codebase landmarks, and lessons across sessions.'));
+    console.log(chalk.dim('  Two stores: global (~/.crowcoder/memory) for cross-project facts, project (.crowcoder/memory'));
+    console.log(chalk.dim('  in each repo) for codebase-specific knowledge. Searchable via /memory or by the agent itself.'));
+    console.log(chalk.dim('  Zero external dependencies; storage is local JSON files. Can be toggled anytime via /memory disable.'));
+    const memoryChoice = await rl.question(chalk.yellow('  Enable MemPalace memory? [Y/n]: '));
+    const memoryEnabled = !(memoryChoice.trim().toLowerCase().startsWith('n'));
     const config = {
         apiKey,
         baseURL,
@@ -113,9 +123,21 @@ async function setupWizard(rl) {
         maxTokens: 8192,
         temperature: 0.3,
         permissionMode: permMode,
+        memory: {
+            enabled: memoryEnabled,
+            globalScope: true,
+            projectScope: true,
+        },
     };
     saveConfig(config);
-    console.log(chalk.green(`\n  Config saved to ${getConfigDir()}/config.json\n`));
+    console.log(chalk.green(`\n  Config saved to ${getConfigDir()}/config.json`));
+    if (memoryEnabled) {
+        console.log(chalk.dim(`  MemPalace: ENABLED — 7 memory_* tools available to the agent. Storage created on first write.`));
+    }
+    else {
+        console.log(chalk.dim(`  MemPalace: disabled. Re-enable anytime with /memory enable.`));
+    }
+    console.log();
     return config;
 }
 /**
@@ -251,8 +273,9 @@ export function handleSlashCommand(input, config, messages, session, mode) {
             console.log(d('  ') + c('/instinct-import') + d('  — import instincts from JSON file'));
             console.log(d('  ') + c('/evolve') + d('           — cluster instincts into reusable skills'));
             console.log(d('  ') + c('/prune') + d('            — delete expired instincts'));
-            console.log(d('  ') + c('/skills') + d('           — list learned skills'));
-            console.log(d('  ') + c('/memory [sub]') + d('     — MemPalace memory: status (default), wings, rooms, ls, search <q>, get <id>, rm <id>'));
+            console.log(d('  ') + c('/skills') + d('           — list learned skills (and bundled ECC skills)'));
+            console.log(d('  ') + c('/skill-show <name>') + d(' — print the full prompt text of a specific skill'));
+            console.log(d('  ') + c('/memory [sub]') + d('     — MemPalace: status, enable/disable, wings, rooms, ls, search <q>, get <id>, rm <id>'));
             console.log(d('  ') + c('/users') + d('           — manage users table'));
             console.log(d('  ') + c('/count [inc|dec|reset]') + d(' — increment/decrement/reset counter'));
             console.log(d('  ') + c('/detect') + d('           — detect package manager, test runner, build tool'));
@@ -788,6 +811,39 @@ export function handleSlashCommand(input, config, messages, session, mode) {
         case '/skills':
             printSkillList();
             return { handled: true };
+        // /skill-show <name>  — print the full skill prompt text. Used to
+        // inspect what an auto-matched ECC skill would inject, or to learn
+        // why /tdd or /review produced a particular shape of response. The
+        // bundled ECC corpus has 228 skills as of v1.11 — most users won't
+        // know they exist unless they can browse them.
+        case '/skill-show': {
+            const name = args.trim();
+            if (!name) {
+                console.log(chalk.yellow('  Usage: /skill-show <skill-name>'));
+                console.log(chalk.dim('  Run /skills to list available skills.'));
+                return { handled: true };
+            }
+            const target = name.toLowerCase();
+            // Try exact name match first, then fall back to substring match.
+            const all = listSkills();
+            let hit = all.find((s) => s.name.toLowerCase() === target);
+            if (!hit)
+                hit = all.find((s) => s.name.toLowerCase().includes(target));
+            if (!hit) {
+                console.log(chalk.yellow(`  No skill matches "${name}".`));
+                const close = all.filter((s) => s.name.toLowerCase().includes(target.slice(0, 4))).slice(0, 5);
+                if (close.length > 0) {
+                    console.log(chalk.dim('  Did you mean: ') + close.map((s) => s.name).join(', '));
+                }
+                return { handled: true };
+            }
+            console.log(chalk.cyan(`\n  Skill: ${hit.name}`));
+            console.log(chalk.dim(`  Category: ${hit.category}  ·  Triggers: ${hit.triggers.slice(0, 6).join(', ')}${hit.triggers.length > 6 ? '…' : ''}`));
+            console.log(chalk.dim(`  Description: ${hit.description}\n`));
+            console.log(hit.prompt);
+            console.log();
+            return { handled: true };
+        }
         // /memory <sub> — MemPalace inventory & inspection.
         //   /memory               status + counts (legacy + new combined)
         //   /memory wings         list wings in both stores
@@ -801,9 +857,28 @@ export function handleSlashCommand(input, config, messages, session, mode) {
             const parts = args.trim().split(/\s+/).filter(Boolean);
             const sub = (parts[0] || '').toLowerCase();
             try {
+                // Enable / disable — affects whether the memory_* tools are
+                // registered for the model on next REPL boot. Existing data is
+                // preserved either way; toggling never deletes anything.
+                if (sub === 'enable' || sub === 'on') {
+                    config.memory = { ...(config.memory || {}), enabled: true };
+                    saveConfig(config);
+                    console.log(chalk.green('  MemPalace: ENABLED.'));
+                    console.log(chalk.dim('  Restart the REPL for the memory_* tools to appear in the agent\'s registry.'));
+                    return { handled: true };
+                }
+                if (sub === 'disable' || sub === 'off') {
+                    config.memory = { ...(config.memory || {}), enabled: false };
+                    saveConfig(config);
+                    console.log(chalk.green('  MemPalace: disabled.'));
+                    console.log(chalk.dim('  Existing drawers/tunnels/triples preserved. Restart the REPL to remove memory_* tools from the agent.'));
+                    return { handled: true };
+                }
+                const enabled = config.memory?.enabled !== false;
                 if (!sub || sub === 'status' || sub === 'stats') {
                     const s = mempalace.stats(process.cwd());
                     console.log(chalk.cyan('\n  MemPalace status'));
+                    console.log(chalk.dim(`    enabled: ${enabled ? '✓ yes' : '✗ no (toggle with /memory enable)'}`));
                     console.log(chalk.dim(`    global  ${s.globalPath}`));
                     console.log(chalk.dim(`      ${s.global.drawers} drawer(s) · ${s.global.wings} wing(s) · ${s.global.rooms} room(s) · ${s.global.tunnels} tunnel(s) · ${s.global.triples} fact(s)`));
                     console.log(chalk.dim(`    project ${s.projectPath}${s.projectExists ? '' : '  (not yet created)'}`));
@@ -1568,18 +1643,24 @@ async function main() {
     const rl = readline.createInterface({ input: stdin, output: stdout });
     // Initialize subsystems
     initHooksDir();
-    // First-run ECC install — silent if already installed, silent if resources missing
-    if (eccResourcesAvailable() && !loadEccState()) {
+    // First-run ECC install — silent if already installed, silent if resources missing.
+    // Also re-installs when the saved state's version is older than the bundle's
+    // BUNDLE_VERSION (so an `npm i -g compact-agent@latest` upgrade picks up the
+    // refreshed corpus without manual /reset-hooks).
+    const eccState = loadEccState();
+    const needsReimport = eccState && eccState.version !== ECC_BUNDLE_VERSION;
+    if (eccResourcesAvailable() && (!eccState || needsReimport)) {
         try {
             const report = installEcc({ verbose: false });
-            console.log(chalk.dim(`  ECC ready: ${report.skills} skills, ${report.agents} agents, ${report.commands + report.prompts} commands, ${report.rules} rule sets.`));
+            const verb = needsReimport ? `refreshed to v${ECC_BUNDLE_VERSION}` : 'ready';
+            console.log(chalk.dim(`  ECC ${verb}: ${report.skills} skills, ${report.agents} agents, ${report.commands + report.prompts} commands, ${report.rules} rule sets.`));
         }
         catch (err) {
             // Never block startup on ECC failures
             console.log(chalk.dim(`  ECC install skipped: ${err instanceof Error ? err.message : err}`));
         }
     }
-    else if (eccResourcesAvailable() && loadEccState()) {
+    else if (eccResourcesAvailable() && eccState) {
         // Self-heal stale ECC hook paths on every startup. seedHooks() writes
         // absolute paths derived from __dirname; after a global npm install
         // (or moving the dev tree, or any path change), those paths become