@soleri/forge 5.2.0 → 5.4.0

package/dist/templates/test-facades.js

@@ -123,6 +123,29 @@ ${domainDescribes}
             if (stats.totalEntries === 0) {
               recommendations.push('Vault is empty');
             }
+            // Check hook status
+            const { readdirSync } = await import('node:fs');
+            const agentClaudeDir = joinPath(__dirname, '..', '.claude');
+            const globalClaudeDir = joinPath(homedir(), '.claude');
+            const hookStatus = { agent: [] as string[], global: [] as string[], missing: [] as string[] };
+            if (exists(agentClaudeDir)) {
+              try {
+                const agentHooks = readdirSync(agentClaudeDir)
+                  .filter((f: string) => f.startsWith('hookify.') && f.endsWith('.local.md'))
+                  .map((f: string) => f.replace('hookify.', '').replace('.local.md', ''));
+                hookStatus.agent = agentHooks;
+                for (const hook of agentHooks) {
+                  if (exists(joinPath(globalClaudeDir, \`hookify.\${hook}.local.md\`))) {
+                    hookStatus.global.push(hook);
+                  } else {
+                    hookStatus.missing.push(hook);
+                  }
+                }
+              } catch { /* ignore */ }
+            }
+            if (hookStatus.missing.length > 0) {
+              recommendations.push(\`\${hookStatus.missing.length} hook(s) not installed globally — run scripts/setup.sh\`);
+            }
             if (recommendations.length === 0) {
               recommendations.push('${config.name} is fully set up and ready!');
             }
@@ -133,6 +156,7 @@ ${domainDescribes}
                 global: { exists: exists(globalClaudeMd), has_agent_section: hasAgentMarker(globalClaudeMd) },
               },
               vault: { entries: stats.totalEntries, domains: Object.keys(stats.byDomain) },
+              hooks: hookStatus,
               recommendations,
             };
           },
@@ -169,6 +193,10 @@ ${domainDescribes}
       expect(opNames).toContain('brain_archive_sessions');
       expect(opNames).toContain('brain_promote_proposals');
       expect(opNames).toContain('brain_lifecycle');
+      // Enhanced brain ops (3)
+      expect(opNames).toContain('brain_feedback');
+      expect(opNames).toContain('brain_feedback_stats');
+      expect(opNames).toContain('brain_reset_extracted');
       // Agent-specific ops (5)
       expect(opNames).toContain('health');
       expect(opNames).toContain('identity');
@@ -184,8 +212,122 @@ ${domainDescribes}
       expect(opNames).toContain('route_intent');
       expect(opNames).toContain('morph');
       expect(opNames).toContain('get_behavior_rules');
-      // Total: 50
-      expect(facade.ops.length).toBe(50);
+      // Cognee ops (5)
+      expect(opNames).toContain('cognee_status');
+      expect(opNames).toContain('cognee_search');
+      expect(opNames).toContain('cognee_add');
+      expect(opNames).toContain('cognee_cognify');
+      expect(opNames).toContain('cognee_config');
+      // LLM ops (2)
+      expect(opNames).toContain('llm_rotate');
+      expect(opNames).toContain('llm_call');
+      // Governance ops (5)
+      expect(opNames).toContain('governance_policy');
+      expect(opNames).toContain('governance_proposals');
+      expect(opNames).toContain('governance_stats');
+      expect(opNames).toContain('governance_expire');
+      expect(opNames).toContain('governance_dashboard');
+      // Planning Extra ops (9)
+      expect(opNames).toContain('plan_iterate');
+      expect(opNames).toContain('plan_split');
+      expect(opNames).toContain('plan_reconcile');
+      expect(opNames).toContain('plan_complete_lifecycle');
+      expect(opNames).toContain('plan_dispatch');
+      expect(opNames).toContain('plan_review');
+      expect(opNames).toContain('plan_archive');
+      expect(opNames).toContain('plan_list_tasks');
+      expect(opNames).toContain('plan_stats');
+      // Memory Extra ops (8)
+      expect(opNames).toContain('memory_delete');
+      expect(opNames).toContain('memory_stats');
+      expect(opNames).toContain('memory_export');
+      expect(opNames).toContain('memory_import');
+      expect(opNames).toContain('memory_prune');
+      expect(opNames).toContain('memory_deduplicate');
+      expect(opNames).toContain('memory_topics');
+      expect(opNames).toContain('memory_by_project');
+      // Vault Extra ops (12)
+      expect(opNames).toContain('vault_get');
+      expect(opNames).toContain('vault_update');
+      expect(opNames).toContain('vault_remove');
+      expect(opNames).toContain('vault_bulk_add');
+      expect(opNames).toContain('vault_bulk_remove');
+      expect(opNames).toContain('vault_tags');
+      expect(opNames).toContain('vault_domains');
+      expect(opNames).toContain('vault_recent');
+      expect(opNames).toContain('vault_import');
+      expect(opNames).toContain('vault_seed');
+      expect(opNames).toContain('vault_backup');
+      expect(opNames).toContain('vault_age_report');
+      // Admin ops (8)
+      expect(opNames).toContain('admin_health');
+      expect(opNames).toContain('admin_tool_list');
+      expect(opNames).toContain('admin_config');
+      expect(opNames).toContain('admin_vault_size');
+      expect(opNames).toContain('admin_uptime');
+      expect(opNames).toContain('admin_version');
+      expect(opNames).toContain('admin_reset_cache');
+      expect(opNames).toContain('admin_diagnostic');
+      // Loop ops (7)
+      expect(opNames).toContain('loop_start');
+      expect(opNames).toContain('loop_iterate');
+      expect(opNames).toContain('loop_status');
+      expect(opNames).toContain('loop_cancel');
+      expect(opNames).toContain('loop_history');
+      expect(opNames).toContain('loop_is_active');
+      expect(opNames).toContain('loop_complete');
+      // Orchestrate ops (5)
+      expect(opNames).toContain('orchestrate_plan');
+      expect(opNames).toContain('orchestrate_execute');
+      expect(opNames).toContain('orchestrate_complete');
+      expect(opNames).toContain('orchestrate_status');
+      expect(opNames).toContain('orchestrate_quick_capture');
+      // Capture ops (4)
+      expect(opNames).toContain('capture_knowledge');
+      expect(opNames).toContain('capture_quick');
+      expect(opNames).toContain('search_intelligent');
+      expect(opNames).toContain('search_feedback');
+      // Grading ops (5)
+      expect(opNames).toContain('plan_grade');
+      expect(opNames).toContain('plan_check_history');
+      expect(opNames).toContain('plan_latest_check');
+      expect(opNames).toContain('plan_meets_grade');
+      expect(opNames).toContain('plan_auto_improve');
+      // Admin Extra ops (10)
+      expect(opNames).toContain('admin_telemetry');
+      expect(opNames).toContain('admin_telemetry_recent');
+      expect(opNames).toContain('admin_telemetry_reset');
+      expect(opNames).toContain('admin_permissions');
+      expect(opNames).toContain('admin_vault_analytics');
+      expect(opNames).toContain('admin_search_insights');
+      expect(opNames).toContain('admin_module_status');
+      expect(opNames).toContain('admin_env');
+      expect(opNames).toContain('admin_gc');
+      expect(opNames).toContain('admin_export_config');
+      // Curator Extra ops (4)
+      expect(opNames).toContain('curator_entry_history');
+      expect(opNames).toContain('curator_record_snapshot');
+      expect(opNames).toContain('curator_queue_stats');
+      expect(opNames).toContain('curator_enrich');
+      // Project ops (12)
+      expect(opNames).toContain('project_get');
+      expect(opNames).toContain('project_list');
+      expect(opNames).toContain('project_unregister');
+      expect(opNames).toContain('project_get_rules');
+      expect(opNames).toContain('project_list_rules');
+      expect(opNames).toContain('project_add_rule');
+      expect(opNames).toContain('project_remove_rule');
+      expect(opNames).toContain('project_link');
+      expect(opNames).toContain('project_unlink');
+      expect(opNames).toContain('project_get_links');
+      expect(opNames).toContain('project_linked_projects');
+      expect(opNames).toContain('project_touch');
+      // Cross-project memory ops (3)
+      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);
     });
 
     it('search should query across all domains with ranked results', async () => {
@@ -277,7 +419,9 @@ ${domainDescribes}
       const setupOp = facade.ops.find((o) => o.name === 'setup')!;
       const result = (await setupOp.handler({ projectPath: '/tmp/nonexistent-test' })) as {
         agent: { name: string };
+        claude_md: { project: { exists: boolean; has_agent_section: boolean }; global: { exists: boolean; has_agent_section: boolean } };
         vault: { entries: number };
+        hooks: { agent: string[]; global: string[]; missing: string[] };
         recommendations: string[];
       };
       expect(result.agent.name).toBe('${escapeQuotes(config.name)}');
@@ -327,6 +471,32 @@ ${domainDescribes}
       const result = (await healthOp.handler({})) as { score: number };
       expect(result.score).toBeGreaterThan(0);
     });
+
+    it('governance_policy get should return default policy', async () => {
+      const facade = buildCoreFacade();
+      const policyOp = facade.ops.find((o) => o.name === 'governance_policy')!;
+      const result = (await policyOp.handler({ action: 'get', projectPath: '/test' })) as {
+        projectPath: string;
+        quotas: { maxEntriesTotal: number };
+        autoCapture: { enabled: boolean };
+      };
+      expect(result.projectPath).toBe('/test');
+      expect(result.quotas.maxEntriesTotal).toBe(500);
+      expect(result.autoCapture.enabled).toBe(true);
+    });
+
+    it('governance_dashboard should return combined view', async () => {
+      const facade = buildCoreFacade();
+      const dashOp = facade.ops.find((o) => o.name === 'governance_dashboard')!;
+      const result = (await dashOp.handler({ projectPath: '/test' })) as {
+        vaultSize: number;
+        quotaPercent: number;
+        pendingProposals: number;
+      };
+      expect(typeof result.vaultSize).toBe('number');
+      expect(typeof result.quotaPercent).toBe('number');
+      expect(result.pendingProposals).toBe(0);
+    });
   });
 });
 `;
@@ -382,7 +552,7 @@ function generateDomainDescribe(agentId, domain) {
         severity: 'warning',
         description: 'A captured pattern.',
         tags: ['captured'],
-      })) as { captured: boolean };
+      })) as { captured: boolean; governance?: { action: string } };
       expect(result.captured).toBe(true);
       const entry = runtime.vault.get('${domain}-cap1');
       expect(entry).not.toBeNull();

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCAsEe,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;iBAehC,MAAM,CAAC,EAAE;;;;;;;;kCAQQ,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDA8CM,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;;;;;;;;;;;;;;wCAcN,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDhE,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/forge",
-  "version": "5.2.0",
+  "version": "5.4.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 31 ops
+      // Core facade should list all 152 ops (147 core + 5 agent-specific)
       const coreFacade = preview.facades.find((f) => f.name === 'atlas_core')!;
-      expect(coreFacade.ops.length).toBe(31);
+      expect(coreFacade.ops.length).toBe(152);
       expect(coreFacade.ops).toContain('curator_status');
       expect(coreFacade.ops).toContain('health');
 

package/src/scaffolder.ts

@@ -77,6 +77,13 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
     },
   ];
 
+  if (config.hookPacks?.length) {
+    files.push({
+      path: '.claude/',
+      description: `Hook pack files (${config.hookPacks.join(', ')})`,
+    });
+  }
+
   const facades = [
     ...config.domains.map((d) => ({
       name: `${config.id}_${d.replace(/-/g, '_')}`,
@@ -85,7 +92,7 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
     {
       name: `${config.id}_core`,
       ops: [
-        // From createCoreOps() — 26 generic ops
+        // From createCoreOps() — 144 generic ops
         'search',
         'vault_stats',
         'list_all',
@@ -101,9 +108,32 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'update_task',
         'complete_plan',
         'record_feedback',
+        'brain_feedback',
+        'brain_feedback_stats',
         'rebuild_vocabulary',
         'brain_stats',
         'llm_status',
+        'brain_session_context',
+        'brain_strengths',
+        'brain_global_patterns',
+        'brain_recommend',
+        'brain_build_intelligence',
+        'brain_export',
+        'brain_import',
+        'brain_extract_knowledge',
+        'brain_archive_sessions',
+        'brain_promote_proposals',
+        'brain_lifecycle',
+        'brain_reset_extracted',
+        // Cognee ops — 5
+        'cognee_status',
+        'cognee_search',
+        'cognee_add',
+        'cognee_cognify',
+        'cognee_config',
+        // LLM ops — 2
+        'llm_rotate',
+        'llm_call',
         'curator_status',
         'curator_detect_duplicates',
         'curator_contradictions',
@@ -112,6 +142,119 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'curator_groom_all',
         'curator_consolidate',
         'curator_health_audit',
+        'get_identity',
+        'update_identity',
+        'add_guideline',
+        'remove_guideline',
+        'rollback_identity',
+        'route_intent',
+        'morph',
+        'get_behavior_rules',
+        // Governance ops — 5
+        'governance_policy',
+        'governance_proposals',
+        'governance_stats',
+        'governance_expire',
+        'governance_dashboard',
+        // Planning Extra ops — 9
+        'plan_iterate',
+        'plan_split',
+        'plan_reconcile',
+        'plan_complete_lifecycle',
+        'plan_dispatch',
+        'plan_review',
+        'plan_archive',
+        'plan_list_tasks',
+        'plan_stats',
+        // Memory Extra ops — 8
+        'memory_delete',
+        'memory_stats',
+        'memory_export',
+        'memory_import',
+        'memory_prune',
+        'memory_deduplicate',
+        'memory_topics',
+        'memory_by_project',
+        // Vault Extra ops — 12
+        'vault_get',
+        'vault_update',
+        'vault_remove',
+        'vault_bulk_add',
+        'vault_bulk_remove',
+        'vault_tags',
+        'vault_domains',
+        'vault_recent',
+        'vault_import',
+        'vault_seed',
+        'vault_backup',
+        'vault_age_report',
+        // Admin ops — 8
+        'admin_health',
+        'admin_tool_list',
+        'admin_config',
+        'admin_vault_size',
+        'admin_uptime',
+        'admin_version',
+        'admin_reset_cache',
+        'admin_diagnostic',
+        // Loop ops — 7
+        'loop_start',
+        'loop_iterate',
+        'loop_status',
+        'loop_cancel',
+        'loop_history',
+        'loop_is_active',
+        'loop_complete',
+        // Orchestrate ops — 5
+        'orchestrate_plan',
+        'orchestrate_execute',
+        'orchestrate_complete',
+        'orchestrate_status',
+        'orchestrate_quick_capture',
+        // Grading ops — 5
+        'plan_grade',
+        'plan_check_history',
+        'plan_latest_check',
+        'plan_meets_grade',
+        'plan_auto_improve',
+        // Capture ops — 4
+        'capture_knowledge',
+        'capture_quick',
+        'search_intelligent',
+        'search_feedback',
+        // Admin Extra ops — 10
+        'admin_telemetry',
+        'admin_telemetry_recent',
+        'admin_telemetry_reset',
+        'admin_permissions',
+        'admin_vault_analytics',
+        'admin_search_insights',
+        'admin_module_status',
+        'admin_env',
+        'admin_gc',
+        'admin_export_config',
+        // Curator Extra ops — 4
+        'curator_entry_history',
+        'curator_record_snapshot',
+        'curator_queue_stats',
+        'curator_enrich',
+        // Project ops — 12
+        'project_get',
+        'project_list',
+        'project_unregister',
+        'project_get_rules',
+        'project_list_rules',
+        'project_add_rule',
+        'project_remove_rule',
+        'project_link',
+        'project_unlink',
+        'project_get_links',
+        'project_linked_projects',
+        'project_touch',
+        // Cross-project memory ops — 3
+        'memory_promote_to_global',
+        'memory_configure',
+        'memory_cross_project_search',
         // Agent-specific ops — 5
         'health',
         'identity',
@@ -160,6 +303,10 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
     'src/__tests__',
   ];
 
+  if (config.hookPacks?.length) {
+    dirs.push('.claude');
+  }
+
   for (const dir of dirs) {
     mkdirSync(join(agentDir, dir), { recursive: true });
   }
@@ -211,7 +358,7 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
     filesCreated.push(path);
   }
 
-  const totalOps = config.domains.length * 5 + 31; // 5 per domain + 26 core (from createCoreOps) + 5 agent-specific
+  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);
@@ -225,6 +372,10 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
     `1 test suite — facades (vault, brain, planner, llm tests provided by @soleri/core)`,
   ];
 
+  if (config.hookPacks?.length) {
+    summaryLines.push(`${config.hookPacks.length} hook pack(s) bundled in .claude/`);
+  }
+
   if (mcpReg.registered) {
     summaryLines.push(`MCP server registered in ${mcpReg.path}`);
   } else {

package/src/templates/claude-md-template.ts

@@ -57,6 +57,9 @@ export function generateClaudeMdTemplate(config: AgentConfig): string {
     `| Session capture | ${bt}${toolPrefix}_core${bt} | ${bt}session_capture${bt} |`,
     `| Export knowledge | ${bt}${toolPrefix}_core${bt} | ${bt}export${bt} |`,
     `| Record feedback | ${bt}${toolPrefix}_core${bt} | ${bt}record_feedback${bt} |`,
+    `| Enhanced feedback | ${bt}${toolPrefix}_core${bt} | ${bt}brain_feedback${bt} |`,
+    `| Feedback stats | ${bt}${toolPrefix}_core${bt} | ${bt}brain_feedback_stats${bt} |`,
+    `| Reset extracted | ${bt}${toolPrefix}_core${bt} | ${bt}brain_reset_extracted${bt} |`,
     `| Rebuild vocabulary | ${bt}${toolPrefix}_core${bt} | ${bt}rebuild_vocabulary${bt} |`,
     `| Brain stats | ${bt}${toolPrefix}_core${bt} | ${bt}brain_stats${bt} |`,
     `| LLM status | ${bt}${toolPrefix}_core${bt} | ${bt}llm_status${bt} |`,
@@ -73,6 +76,117 @@ export function generateClaudeMdTemplate(config: AgentConfig): string {
     `| Add guideline | ${bt}${toolPrefix}_core${bt} | ${bt}add_guideline${bt} |`,
     `| Remove guideline | ${bt}${toolPrefix}_core${bt} | ${bt}remove_guideline${bt} |`,
     `| Rollback identity | ${bt}${toolPrefix}_core${bt} | ${bt}rollback_identity${bt} |`,
+    `| Cognee status | ${bt}${toolPrefix}_core${bt} | ${bt}cognee_status${bt} |`,
+    `| Cognee search | ${bt}${toolPrefix}_core${bt} | ${bt}cognee_search${bt} |`,
+    `| Cognee add | ${bt}${toolPrefix}_core${bt} | ${bt}cognee_add${bt} |`,
+    `| Cognee cognify | ${bt}${toolPrefix}_core${bt} | ${bt}cognee_cognify${bt} |`,
+    `| Cognee config | ${bt}${toolPrefix}_core${bt} | ${bt}cognee_config${bt} |`,
+    `| LLM rotate key | ${bt}${toolPrefix}_core${bt} | ${bt}llm_rotate${bt} |`,
+    `| LLM call | ${bt}${toolPrefix}_core${bt} | ${bt}llm_call${bt} |`,
+    `| Governance policy | ${bt}${toolPrefix}_core${bt} | ${bt}governance_policy${bt} |`,
+    `| Governance proposals | ${bt}${toolPrefix}_core${bt} | ${bt}governance_proposals${bt} |`,
+    `| Governance stats | ${bt}${toolPrefix}_core${bt} | ${bt}governance_stats${bt} |`,
+    `| Expire proposals | ${bt}${toolPrefix}_core${bt} | ${bt}governance_expire${bt} |`,
+    `| Governance dashboard | ${bt}${toolPrefix}_core${bt} | ${bt}governance_dashboard${bt} |`,
+    // Planning Extra ops
+    `| Iterate plan | ${bt}${toolPrefix}_core${bt} | ${bt}plan_iterate${bt} |`,
+    `| Split plan tasks | ${bt}${toolPrefix}_core${bt} | ${bt}plan_split${bt} |`,
+    `| Reconcile plan | ${bt}${toolPrefix}_core${bt} | ${bt}plan_reconcile${bt} |`,
+    `| Complete lifecycle | ${bt}${toolPrefix}_core${bt} | ${bt}plan_complete_lifecycle${bt} |`,
+    `| Dispatch tasks | ${bt}${toolPrefix}_core${bt} | ${bt}plan_dispatch${bt} |`,
+    `| Review plan | ${bt}${toolPrefix}_core${bt} | ${bt}plan_review${bt} |`,
+    `| Archive plan | ${bt}${toolPrefix}_core${bt} | ${bt}plan_archive${bt} |`,
+    `| List plan tasks | ${bt}${toolPrefix}_core${bt} | ${bt}plan_list_tasks${bt} |`,
+    `| Plan stats | ${bt}${toolPrefix}_core${bt} | ${bt}plan_stats${bt} |`,
+    // Memory Extra ops
+    `| Delete memory | ${bt}${toolPrefix}_core${bt} | ${bt}memory_delete${bt} |`,
+    `| Memory stats | ${bt}${toolPrefix}_core${bt} | ${bt}memory_stats${bt} |`,
+    `| Export memories | ${bt}${toolPrefix}_core${bt} | ${bt}memory_export${bt} |`,
+    `| Import memories | ${bt}${toolPrefix}_core${bt} | ${bt}memory_import${bt} |`,
+    `| Prune memories | ${bt}${toolPrefix}_core${bt} | ${bt}memory_prune${bt} |`,
+    `| Deduplicate memories | ${bt}${toolPrefix}_core${bt} | ${bt}memory_deduplicate${bt} |`,
+    `| Memory topics | ${bt}${toolPrefix}_core${bt} | ${bt}memory_topics${bt} |`,
+    `| Memories by project | ${bt}${toolPrefix}_core${bt} | ${bt}memory_by_project${bt} |`,
+    // Vault Extra ops
+    `| Get vault entry | ${bt}${toolPrefix}_core${bt} | ${bt}vault_get${bt} |`,
+    `| Update entry | ${bt}${toolPrefix}_core${bt} | ${bt}vault_update${bt} |`,
+    `| Remove entry | ${bt}${toolPrefix}_core${bt} | ${bt}vault_remove${bt} |`,
+    `| Bulk add | ${bt}${toolPrefix}_core${bt} | ${bt}vault_bulk_add${bt} |`,
+    `| Bulk remove | ${bt}${toolPrefix}_core${bt} | ${bt}vault_bulk_remove${bt} |`,
+    `| Vault tags | ${bt}${toolPrefix}_core${bt} | ${bt}vault_tags${bt} |`,
+    `| Vault domains | ${bt}${toolPrefix}_core${bt} | ${bt}vault_domains${bt} |`,
+    `| Recent entries | ${bt}${toolPrefix}_core${bt} | ${bt}vault_recent${bt} |`,
+    `| Import entries | ${bt}${toolPrefix}_core${bt} | ${bt}vault_import${bt} |`,
+    `| Seed entries | ${bt}${toolPrefix}_core${bt} | ${bt}vault_seed${bt} |`,
+    `| Backup vault | ${bt}${toolPrefix}_core${bt} | ${bt}vault_backup${bt} |`,
+    `| Vault age report | ${bt}${toolPrefix}_core${bt} | ${bt}vault_age_report${bt} |`,
+    // Admin ops
+    `| Admin health | ${bt}${toolPrefix}_core${bt} | ${bt}admin_health${bt} |`,
+    `| Tool list | ${bt}${toolPrefix}_core${bt} | ${bt}admin_tool_list${bt} |`,
+    `| Config | ${bt}${toolPrefix}_core${bt} | ${bt}admin_config${bt} |`,
+    `| Vault size | ${bt}${toolPrefix}_core${bt} | ${bt}admin_vault_size${bt} |`,
+    `| Uptime | ${bt}${toolPrefix}_core${bt} | ${bt}admin_uptime${bt} |`,
+    `| Version | ${bt}${toolPrefix}_core${bt} | ${bt}admin_version${bt} |`,
+    `| Reset cache | ${bt}${toolPrefix}_core${bt} | ${bt}admin_reset_cache${bt} |`,
+    `| Diagnostic | ${bt}${toolPrefix}_core${bt} | ${bt}admin_diagnostic${bt} |`,
+    // Loop ops
+    `| Start loop | ${bt}${toolPrefix}_core${bt} | ${bt}loop_start${bt} |`,
+    `| Loop iterate | ${bt}${toolPrefix}_core${bt} | ${bt}loop_iterate${bt} |`,
+    `| Loop status | ${bt}${toolPrefix}_core${bt} | ${bt}loop_status${bt} |`,
+    `| Cancel loop | ${bt}${toolPrefix}_core${bt} | ${bt}loop_cancel${bt} |`,
+    `| Loop history | ${bt}${toolPrefix}_core${bt} | ${bt}loop_history${bt} |`,
+    `| Loop active | ${bt}${toolPrefix}_core${bt} | ${bt}loop_is_active${bt} |`,
+    `| Complete loop | ${bt}${toolPrefix}_core${bt} | ${bt}loop_complete${bt} |`,
+    // Orchestrate ops
+    `| Orchestrate plan | ${bt}${toolPrefix}_core${bt} | ${bt}orchestrate_plan${bt} |`,
+    `| Orchestrate execute | ${bt}${toolPrefix}_core${bt} | ${bt}orchestrate_execute${bt} |`,
+    `| Orchestrate complete | ${bt}${toolPrefix}_core${bt} | ${bt}orchestrate_complete${bt} |`,
+    `| Orchestrate status | ${bt}${toolPrefix}_core${bt} | ${bt}orchestrate_status${bt} |`,
+    `| Quick capture | ${bt}${toolPrefix}_core${bt} | ${bt}orchestrate_quick_capture${bt} |`,
+    // Capture ops
+    `| Capture knowledge | ${bt}${toolPrefix}_core${bt} | ${bt}capture_knowledge${bt} |`,
+    `| Quick capture entry | ${bt}${toolPrefix}_core${bt} | ${bt}capture_quick${bt} |`,
+    `| Intelligent search | ${bt}${toolPrefix}_core${bt} | ${bt}search_intelligent${bt} |`,
+    `| Search feedback | ${bt}${toolPrefix}_core${bt} | ${bt}search_feedback${bt} |`,
+    // Grading ops
+    `| Grade plan | ${bt}${toolPrefix}_core${bt} | ${bt}plan_grade${bt} |`,
+    `| Check history | ${bt}${toolPrefix}_core${bt} | ${bt}plan_check_history${bt} |`,
+    `| Latest check | ${bt}${toolPrefix}_core${bt} | ${bt}plan_latest_check${bt} |`,
+    `| Meets grade | ${bt}${toolPrefix}_core${bt} | ${bt}plan_meets_grade${bt} |`,
+    `| Auto improve plan | ${bt}${toolPrefix}_core${bt} | ${bt}plan_auto_improve${bt} |`,
+    // Admin Extra ops
+    `| Telemetry stats | ${bt}${toolPrefix}_core${bt} | ${bt}admin_telemetry${bt} |`,
+    `| Recent calls | ${bt}${toolPrefix}_core${bt} | ${bt}admin_telemetry_recent${bt} |`,
+    `| Reset telemetry | ${bt}${toolPrefix}_core${bt} | ${bt}admin_telemetry_reset${bt} |`,
+    `| Permissions | ${bt}${toolPrefix}_core${bt} | ${bt}admin_permissions${bt} |`,
+    `| Vault analytics | ${bt}${toolPrefix}_core${bt} | ${bt}admin_vault_analytics${bt} |`,
+    `| Search insights | ${bt}${toolPrefix}_core${bt} | ${bt}admin_search_insights${bt} |`,
+    `| Module status | ${bt}${toolPrefix}_core${bt} | ${bt}admin_module_status${bt} |`,
+    `| Environment | ${bt}${toolPrefix}_core${bt} | ${bt}admin_env${bt} |`,
+    `| Garbage collect | ${bt}${toolPrefix}_core${bt} | ${bt}admin_gc${bt} |`,
+    `| Export config | ${bt}${toolPrefix}_core${bt} | ${bt}admin_export_config${bt} |`,
+    // Curator Extra ops
+    `| Entry history | ${bt}${toolPrefix}_core${bt} | ${bt}curator_entry_history${bt} |`,
+    `| Record snapshot | ${bt}${toolPrefix}_core${bt} | ${bt}curator_record_snapshot${bt} |`,
+    `| Queue stats | ${bt}${toolPrefix}_core${bt} | ${bt}curator_queue_stats${bt} |`,
+    `| Enrich metadata | ${bt}${toolPrefix}_core${bt} | ${bt}curator_enrich${bt} |`,
+    // Project ops
+    `| Get project | ${bt}${toolPrefix}_core${bt} | ${bt}project_get${bt} |`,
+    `| List projects | ${bt}${toolPrefix}_core${bt} | ${bt}project_list${bt} |`,
+    `| Unregister project | ${bt}${toolPrefix}_core${bt} | ${bt}project_unregister${bt} |`,
+    `| Project rules | ${bt}${toolPrefix}_core${bt} | ${bt}project_get_rules${bt} |`,
+    `| All project rules | ${bt}${toolPrefix}_core${bt} | ${bt}project_list_rules${bt} |`,
+    `| Add rule | ${bt}${toolPrefix}_core${bt} | ${bt}project_add_rule${bt} |`,
+    `| Remove rule | ${bt}${toolPrefix}_core${bt} | ${bt}project_remove_rule${bt} |`,
+    `| Link projects | ${bt}${toolPrefix}_core${bt} | ${bt}project_link${bt} |`,
+    `| Unlink projects | ${bt}${toolPrefix}_core${bt} | ${bt}project_unlink${bt} |`,
+    `| Project links | ${bt}${toolPrefix}_core${bt} | ${bt}project_get_links${bt} |`,
+    `| Linked projects | ${bt}${toolPrefix}_core${bt} | ${bt}project_linked_projects${bt} |`,
+    `| Touch project | ${bt}${toolPrefix}_core${bt} | ${bt}project_touch${bt} |`,
+    // Cross-project memory ops
+    `| Promote to global | ${bt}${toolPrefix}_core${bt} | ${bt}memory_promote_to_global${bt} |`,
+    `| Configure memory | ${bt}${toolPrefix}_core${bt} | ${bt}memory_configure${bt} |`,
+    `| Cross-project search | ${bt}${toolPrefix}_core${bt} | ${bt}memory_cross_project_search${bt} |`,
   );
 
   mdLines.push(
@@ -130,6 +244,73 @@ export function generateClaudeMdTemplate(config: AgentConfig): string {
     `<!-- /${marker} -->`,
   );
 
+  // ─── Hook Packs section (when configured) ─────────────────────
+  if (config.hookPacks?.length) {
+    const PACK_INFO: Record<string, { description: string; hooks: Record<string, string> }> = {
+      'typescript-safety': {
+        description: 'Block unsafe TypeScript patterns',
+        hooks: {
+          'no-any-types': '`:any`, `as any`, `<any>`, `Record<string, any>`',
+          'no-console-log': '`console.log` in committed code',
+        },
+      },
+      a11y: {
+        description: 'Accessibility enforcement',
+        hooks: {
+          'semantic-html': 'Generic divs where semantic HTML should be used',
+          'focus-ring-required': 'Missing visible focus indicators',
+          'ux-touch-targets': 'Touch targets smaller than 44px',
+        },
+      },
+      'css-discipline': {
+        description: 'CSS best practices',
+        hooks: {
+          'no-important': '`!important` in CSS',
+          'no-inline-styles': 'Inline style attributes',
+        },
+      },
+      'clean-commits': {
+        description: 'Clean git history',
+        hooks: {
+          'no-ai-attribution': 'AI attribution in commits',
+        },
+      },
+    };
+
+    // Build rows — expand 'full' to constituent packs
+    const rows: Array<{ pack: string; hook: string; blocks: string }> = [];
+    for (const packName of config.hookPacks) {
+      if (packName === 'full') {
+        // Composed pack — expand all constituent packs
+        for (const [subPack, info] of Object.entries(PACK_INFO)) {
+          for (const [hook, blocks] of Object.entries(info.hooks)) {
+            rows.push({ pack: subPack, hook, blocks });
+          }
+        }
+      } else if (PACK_INFO[packName]) {
+        for (const [hook, blocks] of Object.entries(PACK_INFO[packName].hooks)) {
+          rows.push({ pack: packName, hook, blocks });
+        }
+      }
+    }
+
+    if (rows.length > 0) {
+      // Insert before the closing marker
+      const closingMarkerIndex = mdLines.length - 1;
+      const hookLines = [
+        '',
+        '## Hook Packs',
+        '',
+        'Quality gates installed in `.claude/`. Run `scripts/setup.sh` to install globally.',
+        '',
+        '| Pack | Hook | Blocks |',
+        '|------|------|--------|',
+        ...rows.map((r) => `| ${r.pack} | ${r.hook} | ${r.blocks} |`),
+      ];
+      mdLines.splice(closingMarkerIndex, 0, ...hookLines);
+    }
+  }
+
   // Escape each markdown line for use in a single-quoted TS string literal
   const quotedLines = mdLines.map((line) => {
     const escaped = line.replace(/\\/g, '\\\\').replace(/'/g, "\\'");