@soleri/forge 5.5.0 → 5.7.0

package/dist/templates/entry-point.js

@@ -19,6 +19,7 @@ import {
   createCoreOps,
   createDomainFacades,
   registerAllFacades,
+  seedDefaultPlaybooks,
 } from '@soleri/core';
 import type { OpDefinition } from '@soleri/core';
 import { z } from 'zod';
@@ -36,6 +37,13 @@ async function main(): Promise<void> {
   });
 
   const tag = PERSONA.name.toLowerCase();
+
+  // Seed built-in playbooks (idempotent)
+  const seedResult = seedDefaultPlaybooks(runtime.vault);
+  if (seedResult.seeded > 0) {
+    console.error(\`[\${tag}] Seeded \${seedResult.seeded} built-in playbooks\`);
+  }
+
   const stats = runtime.vault.stats();
   console.error(\`[\${tag}] Vault: \${stats.totalEntries} entries, Brain: \${runtime.brain.getVocabularySize()} terms\`);
 

package/dist/templates/entry-point.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry-point.js","sourceRoot":"","sources":["../../src/templates/entry-point.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEtD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;gBAwBO,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEA+BuC,MAAM,CAAC,EAAE;;;;;;;qGAO4B,MAAM,CAAC,IAAI;;;;;;;;;;;oDAW5D,MAAM,CAAC,EAAE;iDACZ,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCA2FxB,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;aAoBhC,MAAM,CAAC,EAAE;;;;;wDAKkC,MAAM,CAAC,EAAE,MAAM,cAAc;;;;aAIxE,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA8BF,MAAM,CAAC,EAAE;;;CAG5B,CAAC;AACF,CAAC"}
+{"version":3,"file":"entry-point.js","sourceRoot":"","sources":["../../src/templates/entry-point.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEtD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;gBAyBO,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAsCuC,MAAM,CAAC,EAAE;;;;;;;qGAO4B,MAAM,CAAC,IAAI;;;;;;;;;;;oDAW5D,MAAM,CAAC,EAAE;iDACZ,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCA2FxB,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;aAoBhC,MAAM,CAAC,EAAE;;;;;wDAKkC,MAAM,CAAC,EAAE,MAAM,cAAc;;;;aAIxE,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA8BF,MAAM,CAAC,EAAE;;;CAG5B,CAAC;AACF,CAAC"}

package/dist/templates/test-facades.js

@@ -197,6 +197,8 @@ ${domainDescribes}
       expect(opNames).toContain('brain_feedback');
       expect(opNames).toContain('brain_feedback_stats');
       expect(opNames).toContain('brain_reset_extracted');
+      // Brain decay report (#89)
+      expect(opNames).toContain('brain_decay_report');
       // Agent-specific ops (5)
       expect(opNames).toContain('health');
       expect(opNames).toContain('identity');
@@ -227,7 +229,7 @@ ${domainDescribes}
       expect(opNames).toContain('governance_stats');
       expect(opNames).toContain('governance_expire');
       expect(opNames).toContain('governance_dashboard');
-      // Planning Extra ops (9)
+      // Planning Extra ops (13)
       expect(opNames).toContain('plan_iterate');
       expect(opNames).toContain('plan_split');
       expect(opNames).toContain('plan_reconcile');
@@ -237,6 +239,10 @@ ${domainDescribes}
       expect(opNames).toContain('plan_archive');
       expect(opNames).toContain('plan_list_tasks');
       expect(opNames).toContain('plan_stats');
+      expect(opNames).toContain('plan_execution_metrics');
+      expect(opNames).toContain('plan_record_task_metrics');
+      expect(opNames).toContain('plan_submit_deliverable');
+      expect(opNames).toContain('plan_verify_deliverables');
       // Memory Extra ops (8)
       expect(opNames).toContain('memory_delete');
       expect(opNames).toContain('memory_stats');
@@ -259,6 +265,10 @@ ${domainDescribes}
       expect(opNames).toContain('vault_seed');
       expect(opNames).toContain('vault_backup');
       expect(opNames).toContain('vault_age_report');
+      // #89: Bi-temporal
+      expect(opNames).toContain('vault_set_temporal');
+      expect(opNames).toContain('vault_find_expiring');
+      expect(opNames).toContain('vault_find_expired');
       // Admin ops (8)
       expect(opNames).toContain('admin_health');
       expect(opNames).toContain('admin_tool_list');
@@ -268,7 +278,7 @@ ${domainDescribes}
       expect(opNames).toContain('admin_version');
       expect(opNames).toContain('admin_reset_cache');
       expect(opNames).toContain('admin_diagnostic');
-      // Loop ops (7)
+      // Loop ops (8)
       expect(opNames).toContain('loop_start');
       expect(opNames).toContain('loop_iterate');
       expect(opNames).toContain('loop_status');
@@ -276,6 +286,7 @@ ${domainDescribes}
       expect(opNames).toContain('loop_history');
       expect(opNames).toContain('loop_is_active');
       expect(opNames).toContain('loop_complete');
+      expect(opNames).toContain('loop_anomaly_check');
       // Orchestrate ops (5)
       expect(opNames).toContain('orchestrate_plan');
       expect(opNames).toContain('orchestrate_execute');
@@ -293,7 +304,7 @@ ${domainDescribes}
       expect(opNames).toContain('plan_latest_check');
       expect(opNames).toContain('plan_meets_grade');
       expect(opNames).toContain('plan_auto_improve');
-      // Admin Extra ops (10)
+      // Admin Extra ops (11)
       expect(opNames).toContain('admin_telemetry');
       expect(opNames).toContain('admin_telemetry_recent');
       expect(opNames).toContain('admin_telemetry_reset');
@@ -304,11 +315,14 @@ ${domainDescribes}
       expect(opNames).toContain('admin_env');
       expect(opNames).toContain('admin_gc');
       expect(opNames).toContain('admin_export_config');
-      // Curator Extra ops (4)
+      expect(opNames).toContain('admin_hot_reload');
+      // Curator Extra ops (4 + 1 hybrid)
       expect(opNames).toContain('curator_entry_history');
       expect(opNames).toContain('curator_record_snapshot');
       expect(opNames).toContain('curator_queue_stats');
       expect(opNames).toContain('curator_enrich');
+      // #36: Hybrid contradiction detection
+      expect(opNames).toContain('curator_hybrid_contradictions');
       // Project ops (12)
       expect(opNames).toContain('project_get');
       expect(opNames).toContain('project_list');
@@ -326,8 +340,23 @@ ${domainDescribes}
       expect(opNames).toContain('memory_promote_to_global');
       expect(opNames).toContain('memory_configure');
       expect(opNames).toContain('memory_cross_project_search');
-      // Total: 152 (147 core + 5 agent-specific)
-      expect(facade.ops.length).toBe(152);
+      // Playbook ops (5)
+      expect(opNames).toContain('playbook_list');
+      expect(opNames).toContain('playbook_get');
+      expect(opNames).toContain('playbook_create');
+      expect(opNames).toContain('playbook_match');
+      expect(opNames).toContain('playbook_seed');
+      // Cognee Sync ops (3)
+      expect(opNames).toContain('cognee_sync_status');
+      expect(opNames).toContain('cognee_sync_drain');
+      expect(opNames).toContain('cognee_sync_reconcile');
+      // Intake ops (4)
+      expect(opNames).toContain('intake_ingest_book');
+      expect(opNames).toContain('intake_process');
+      expect(opNames).toContain('intake_status');
+      expect(opNames).toContain('intake_preview');
+      // Total: 208 (203 core + 5 agent-specific)
+      expect(facade.ops.length).toBe(208);
     });
 
     it('search should query across all domains with ranked results', async () => {

package/dist/templates/test-facades.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-facades.js","sourceRoot":"","sources":["../../src/templates/test-facades.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;SAChD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmCS,MAAM,CAAC,EAAE;;;;;;;;;;;EAWzB,eAAe;;cAEH,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA6Fe,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;iBAgBhC,MAAM,CAAC,EAAE;;;;;;;;kCAQQ,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAoKM,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAmCvB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;mCACzB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;0CAWlB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;qCA0B9B,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;wCAgBN,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EhE,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe,EAAE,MAAc;IAC7D,MAAM,UAAU,GAAG,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;IAE7D,OAAO,eAAe,UAAU;;4CAEU,OAAO,OAAO,MAAM;;;;;kCAK9B,UAAU;;;;;;;;;iDASK,MAAM;;2BAE5B,MAAM,mBAAmB,MAAM;;;;;;kDAMR,MAAM;;;iCAGvB,MAAM;;2BAEZ,MAAM,kBAAkB,MAAM;;;;;;;wDAOD,MAAM;;;wCAGtB,MAAM;;;;eAI/B,MAAM;;;;;;;;yCAQoB,MAAM;;oCAEX,MAAM;;;;6CAIG,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;gCACtB,MAAM;;;;6CAIO,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;;kCAEpB,MAAM;;MAElC,CAAC;AACP,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"test-facades.js","sourceRoot":"","sources":["../../src/templates/test-facades.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;SAChD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmCS,MAAM,CAAC,EAAE;;;;;;;;;;;EAWzB,eAAe;;cAEH,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA6Fe,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;iBAgBhC,MAAM,CAAC,EAAE;;;;;;;;kCAQQ,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAiMM,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAmCvB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;mCACzB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;0CAWlB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;qCA0B9B,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;wCAgBN,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EhE,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe,EAAE,MAAc;IAC7D,MAAM,UAAU,GAAG,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;IAE7D,OAAO,eAAe,UAAU;;4CAEU,OAAO,OAAO,MAAM;;;;;kCAK9B,UAAU;;;;;;;;;iDASK,MAAM;;2BAE5B,MAAM,mBAAmB,MAAM;;;;;;kDAMR,MAAM;;;iCAGvB,MAAM;;2BAEZ,MAAM,kBAAkB,MAAM;;;;;;;wDAOD,MAAM;;;wCAGtB,MAAM;;;;eAI/B,MAAM;;;;;;;;yCAQoB,MAAM;;oCAEX,MAAM;;;;6CAIG,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;gCACtB,MAAM;;;;6CAIO,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;;kCAEpB,MAAM;;MAElC,CAAC;AACP,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/forge",
-  "version": "5.5.0",
+  "version": "5.7.0",
   "description": "Scaffold AI agents that learn, remember, and grow with you.",
   "keywords": [
     "agent",

package/src/__tests__/scaffolder.test.ts

@@ -59,9 +59,9 @@ describe('Scaffolder', () => {
       expect(preview.facades).toHaveLength(4); // 3 domains + core
       expect(preview.facades[0].name).toBe('atlas_data_pipelines');
 
-      // Core facade should list all 152 ops (147 core + 5 agent-specific)
+      // Core facade should list all 208 ops (203 core + 5 agent-specific)
       const coreFacade = preview.facades.find((f) => f.name === 'atlas_core')!;
-      expect(coreFacade.ops.length).toBe(152);
+      expect(coreFacade.ops.length).toBe(208);
       expect(coreFacade.ops).toContain('curator_status');
       expect(coreFacade.ops).toContain('health');
 

package/src/facades/forge.facade.ts

@@ -28,8 +28,9 @@ export const forgeOps: OpDef[] = [
     name: 'create',
     description:
       'Scaffold a complete MCP agent project with activation system. ' +
-      'This creates the full directory structure, source files, config, and activation module. ' +
-      'After creation: npm install && npm run build, then say "Hello, {Name}!" to activate.',
+      'This creates the full directory structure, source files, config, and activation module, ' +
+      'then auto-builds (npm install + npm run build) and registers the MCP server. ' +
+      'After creation: restart Claude Code and say "Hello, {Name}!" to activate.',
     schema: AgentConfigSchema,
     handler: async (params) => {
       const config = AgentConfigSchema.parse(params);
@@ -111,7 +112,7 @@ export const forgeOps: OpDef[] = [
           {
             step: 6,
             action: 'Create the agent',
-            ask: 'Call create with the confirmed config. Then guide the user through npm install and npm run build. The MCP server is automatically registered in ~/.claude.json.',
+            ask: 'Call create with the confirmed config. The agent is auto-built (npm install + build) and MCP server is registered in ~/.claude.json automatically.',
           },
           {
             step: 7,

package/src/scaffolder.ts

@@ -8,6 +8,7 @@ import {
 } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
+import { execFileSync } from 'node:child_process';
 import type { AgentConfig, ScaffoldResult, ScaffoldPreview, AgentInfo } from './types.js';
 
 import { generatePackageJson } from './templates/package-json.js';
@@ -98,7 +99,7 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
     {
       name: `${config.id}_core`,
       ops: [
-        // From createCoreOps() — 144 generic ops
+        // From createCoreOps() — 150 generic ops
         'search',
         'vault_stats',
         'list_all',
@@ -131,6 +132,8 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'brain_promote_proposals',
         'brain_lifecycle',
         'brain_reset_extracted',
+        // Brain decay report (#89) — 1
+        'brain_decay_report',
         // Cognee ops — 5
         'cognee_status',
         'cognee_search',
@@ -140,6 +143,9 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         // LLM ops — 2
         'llm_rotate',
         'llm_call',
+        // Prompt ops — 2
+        'render_prompt',
+        'list_templates',
         'curator_status',
         'curator_detect_duplicates',
         'curator_contradictions',
@@ -162,7 +168,7 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'governance_stats',
         'governance_expire',
         'governance_dashboard',
-        // Planning Extra ops — 9
+        // Planning Extra ops — 22
         'plan_iterate',
         'plan_split',
         'plan_reconcile',
@@ -172,6 +178,25 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'plan_archive',
         'plan_list_tasks',
         'plan_stats',
+        // Planning evidence (#148)
+        'plan_submit_evidence',
+        'plan_verify_task',
+        'plan_verify_plan',
+        // Subagent dispatch (#149)
+        'plan_review_spec',
+        'plan_review_quality',
+        'plan_review_outcome',
+        // Brainstorm (#150)
+        'plan_brainstorm',
+        // Auto-reconcile (#151)
+        'plan_auto_reconcile',
+        // Validate plan (#152)
+        'plan_validate',
+        // Execution metrics + deliverables (#80, #83)
+        'plan_execution_metrics',
+        'plan_record_task_metrics',
+        'plan_submit_deliverable',
+        'plan_verify_deliverables',
         // Memory Extra ops — 8
         'memory_delete',
         'memory_stats',
@@ -194,6 +219,16 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'vault_seed',
         'vault_backup',
         'vault_age_report',
+        // Vault extra — seed canonical + knowledge lifecycle (5)
+        'vault_seed_canonical',
+        'knowledge_audit',
+        'knowledge_health',
+        'knowledge_merge',
+        'knowledge_reorganize',
+        // Bi-temporal vault ops (#89) — 3
+        'vault_set_temporal',
+        'vault_find_expiring',
+        'vault_find_expired',
         // Admin ops — 8
         'admin_health',
         'admin_tool_list',
@@ -203,14 +238,16 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'admin_version',
         'admin_reset_cache',
         'admin_diagnostic',
-        // Loop ops — 7
+        // Loop ops — 9
         'loop_start',
         'loop_iterate',
+        'loop_iterate_gate',
         'loop_status',
         'loop_cancel',
         'loop_history',
         'loop_is_active',
         'loop_complete',
+        'loop_anomaly_check',
         // Orchestrate ops — 5
         'orchestrate_plan',
         'orchestrate_execute',
@@ -228,7 +265,22 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'capture_quick',
         'search_intelligent',
         'search_feedback',
-        // Admin Extra ops — 10
+        // Enriched capture (#154) — 1
+        'capture_enriched',
+        // Cognee graph (#156) — 3
+        'cognee_get_node',
+        'cognee_graph_stats',
+        'cognee_export_status',
+        // Cognee Sync ops — 3
+        'cognee_sync_status',
+        'cognee_sync_drain',
+        'cognee_sync_reconcile',
+        // Intake ops — 4
+        'intake_ingest_book',
+        'intake_process',
+        'intake_status',
+        'intake_preview',
+        // Admin Extra ops — 23
         'admin_telemetry',
         'admin_telemetry_recent',
         'admin_telemetry_reset',
@@ -239,11 +291,31 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'admin_env',
         'admin_gc',
         'admin_export_config',
-        // Curator Extra ops — 4
+        // Admin key pool (#157)
+        'admin_key_pool_status',
+        'admin_create_token',
+        'admin_revoke_token',
+        'admin_list_tokens',
+        // Admin accounts (#158)
+        'admin_add_account',
+        'admin_remove_account',
+        'admin_rotate_account',
+        'admin_list_accounts',
+        'admin_account_status',
+        // Admin plugins (#159)
+        'admin_list_plugins',
+        'admin_plugin_status',
+        // Admin instruction validation (#160)
+        'admin_validate_instructions',
+        // Hot reload (#63)
+        'admin_hot_reload',
+        // Curator Extra ops — 5
         'curator_entry_history',
         'curator_record_snapshot',
         'curator_queue_stats',
         'curator_enrich',
+        // Hybrid contradiction detection (#36) — 1
+        'curator_hybrid_contradictions',
         // Project ops — 12
         'project_get',
         'project_list',
@@ -261,6 +333,12 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'memory_promote_to_global',
         'memory_configure',
         'memory_cross_project_search',
+        // Playbook ops — 5
+        'playbook_list',
+        'playbook_get',
+        'playbook_create',
+        'playbook_match',
+        'playbook_seed',
         // Agent-specific ops — 5
         'health',
         'identity',
@@ -376,8 +454,36 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
 
   const totalOps = config.domains.length * 5 + 61; // 5 per domain + 56 core (from createCoreOps) + 5 agent-specific
 
-  // Register the agent as an MCP server in ~/.claude.json
-  const mcpReg = registerMcpServer(config.id, agentDir);
+  // Auto-build: install dependencies and compile before registering MCP
+  let buildSuccess = false;
+  let buildError: string | undefined;
+  try {
+    execFileSync('npm', ['install', '--no-fund', '--no-audit'], {
+      cwd: agentDir,
+      stdio: 'pipe',
+      timeout: 120_000,
+    });
+    execFileSync('npm', ['run', 'build'], {
+      cwd: agentDir,
+      stdio: 'pipe',
+      timeout: 60_000,
+    });
+    buildSuccess = true;
+  } catch (err) {
+    buildError = err instanceof Error ? err.message : String(err);
+  }
+
+  // Register the agent as an MCP server in ~/.claude.json (only if build succeeded)
+  let mcpReg: { registered: boolean; path: string; error?: string };
+  if (buildSuccess) {
+    mcpReg = registerMcpServer(config.id, agentDir);
+  } else {
+    mcpReg = {
+      registered: false,
+      path: join(homedir(), '.claude.json'),
+      error: 'Skipped — build failed',
+    };
+  }
 
   const summaryLines = [
     `Created ${config.name} agent at ${agentDir}`,
@@ -389,6 +495,13 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
     `${skillFiles.length} built-in skills (TDD, debugging, planning, vault, brain debrief)`,
   ];
 
+  if (buildSuccess) {
+    summaryLines.push('Built successfully (npm install + npm run build)');
+  } else {
+    summaryLines.push(`Warning: Auto-build failed: ${buildError}`);
+    summaryLines.push(`  Run manually: cd ${agentDir} && npm install && npm run build`);
+  }
+
   if (config.hookPacks?.length) {
     summaryLines.push(`${config.hookPacks.length} hook pack(s) bundled in .claude/`);
   }
@@ -402,9 +515,6 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
   summaryLines.push(
     '',
     'Next steps:',
-    `  cd ${agentDir}`,
-    '  npm install && npm run build',
-    '  npm test              # verify all tests pass',
     '  Restart Claude Code',
     `  Say "Hello, ${config.name}!" to activate the persona`,
   );

package/src/skills/brain-debrief.md

@@ -16,33 +16,43 @@ When the user wants to understand what patterns have proven valuable, what anti-
 ### "What have I learned?" (General debrief)
 
 1. Get the big picture:
+
    ```
    YOUR_AGENT_core op:brain_stats
    ```
+
    Total sessions, patterns captured, quality scores, coverage gaps.
 
 2. Get patterns ranked by proven strength:
+
    ```
    YOUR_AGENT_core op:brain_strengths
    ```
+
    Focus on strength >= 70 and successRate >= 0.7.
 
 3. Check memory landscape:
+
    ```
    YOUR_AGENT_core op:memory_topics
    ```
+
    Shows how knowledge clusters by topic.
 
 4. Check for stale knowledge:
+
    ```
    YOUR_AGENT_core op:vault_age_report
    ```
+
    Find entries that haven't been updated recently — candidates for review.
 
 5. Run a curator health audit:
+
    ```
    YOUR_AGENT_core op:curator_health_audit
    ```
+
    Vault quality score, tag normalization status, duplicate density.
 
 6. Present: top 5 strongest patterns, top 3 recurring anti-patterns, stale entries needing refresh, and coverage gaps.
@@ -50,22 +60,26 @@ When the user wants to understand what patterns have proven valuable, what anti-
 ### "What's working across projects?" (Cross-project intelligence)
 
 1. Get patterns promoted to the global pool:
+
    ```
    YOUR_AGENT_core op:brain_global_patterns
    ```
 
 2. Get recommendations based on project similarity:
+
    ```
    YOUR_AGENT_core op:brain_recommend
      params: { projectName: "<current project>" }
    ```
 
 3. Check linked projects:
+
    ```
    YOUR_AGENT_core op:project_linked_projects
    ```
 
 4. Search across all projects for relevant patterns:
+
    ```
    YOUR_AGENT_core op:memory_cross_project_search
      params: { query: "<topic>", crossProject: true }
@@ -76,28 +90,33 @@ When the user wants to understand what patterns have proven valuable, what anti-
 ### "Am I getting smarter?" (Learning velocity)
 
 1. Recent stats:
+
    ```
    YOUR_AGENT_core op:brain_stats
      params: { since: "<7 days ago>" }
    ```
 
 2. Longer period for comparison:
+
    ```
    YOUR_AGENT_core op:brain_stats
      params: { since: "<30 days ago>" }
    ```
 
 3. Memory stats:
+
    ```
    YOUR_AGENT_core op:memory_stats
    ```
 
 4. Vault analytics:
+
    ```
    YOUR_AGENT_core op:admin_vault_analytics
    ```
 
 5. Search insights — what queries are people running, what's missing:
+
    ```
    YOUR_AGENT_core op:admin_search_insights
    ```
@@ -107,17 +126,21 @@ When the user wants to understand what patterns have proven valuable, what anti-
 ### "Build fresh intelligence" (Rebuild)
 
 1. Run the full pipeline:
+
    ```
    YOUR_AGENT_core op:brain_build_intelligence
    ```
+
    Compute strengths, update global registry, refresh project profiles.
 
 2. Consolidate vault (curator cleanup):
+
    ```
    YOUR_AGENT_core op:curator_consolidate
    ```
 
 3. Show updated metrics:
+
    ```
    YOUR_AGENT_core op:brain_stats
    ```
@@ -127,21 +150,25 @@ When the user wants to understand what patterns have proven valuable, what anti-
 ### "Export what I know" (Portability)
 
 Export brain intelligence:
+
 ```
 YOUR_AGENT_core op:brain_export
 ```
 
 Export memory:
+
 ```
 YOUR_AGENT_core op:memory_export
 ```
 
 Export vault as backup:
+
 ```
 YOUR_AGENT_core op:vault_backup
 ```
 
 These can be imported into another vault:
+
 ```
 YOUR_AGENT_core op:brain_import
 YOUR_AGENT_core op:memory_import
@@ -151,6 +178,7 @@ YOUR_AGENT_core op:vault_import
 ## Presenting Intelligence
 
 Format as a report:
+
 - **Strengths**: Top patterns with strength scores and domains
 - **Risks**: Recurring anti-patterns that keep appearing
 - **Gaps**: Domains with low coverage or stale knowledge
@@ -165,22 +193,22 @@ Debrief is complete when the user's specific question has been answered with dat
 
 ## Agent Tools Reference
 
-| Op | When to Use |
-|----|-------------|
-| `brain_stats` | Aggregate metrics — sessions, patterns, quality |
-| `brain_strengths` | Patterns ranked by proven strength |
-| `brain_global_patterns` | Cross-project promoted patterns |
-| `brain_recommend` | Project-similarity recommendations |
-| `brain_build_intelligence` | Rebuild full intelligence pipeline |
-| `brain_export` / `brain_import` | Portable intelligence transfer |
-| `memory_topics` | Knowledge clusters by topic |
-| `memory_stats` | Memory statistics |
-| `memory_export` / `memory_import` | Memory portability |
-| `memory_cross_project_search` | Search across linked projects |
-| `vault_age_report` | Find stale entries needing refresh |
-| `vault_backup` / `vault_import` | Vault backup and restore |
-| `curator_health_audit` | Vault quality score and status |
-| `curator_consolidate` | Full vault cleanup pipeline |
-| `admin_vault_analytics` | Overall knowledge quality metrics |
-| `admin_search_insights` | Search miss analysis — what's not found |
-| `project_linked_projects` | See connected projects |
+| Op                                | When to Use                                     |
+| --------------------------------- | ----------------------------------------------- |
+| `brain_stats`                     | Aggregate metrics — sessions, patterns, quality |
+| `brain_strengths`                 | Patterns ranked by proven strength              |
+| `brain_global_patterns`           | Cross-project promoted patterns                 |
+| `brain_recommend`                 | Project-similarity recommendations              |
+| `brain_build_intelligence`        | Rebuild full intelligence pipeline              |
+| `brain_export` / `brain_import`   | Portable intelligence transfer                  |
+| `memory_topics`                   | Knowledge clusters by topic                     |
+| `memory_stats`                    | Memory statistics                               |
+| `memory_export` / `memory_import` | Memory portability                              |
+| `memory_cross_project_search`     | Search across linked projects                   |
+| `vault_age_report`                | Find stale entries needing refresh              |
+| `vault_backup` / `vault_import`   | Vault backup and restore                        |
+| `curator_health_audit`            | Vault quality score and status                  |
+| `curator_consolidate`             | Full vault cleanup pipeline                     |
+| `admin_vault_analytics`           | Overall knowledge quality metrics               |
+| `admin_search_insights`           | Search miss analysis — what's not found         |
+| `project_linked_projects`         | See connected projects                          |