@soleri/forge 5.9.0 → 5.10.0

package/dist/types.js

@@ -1,4 +1,6 @@
 import { z } from 'zod';
+/** Communication tone for the agent persona */
+export const TONES = ['precise', 'mentor', 'pragmatic'];
 /** Agent configuration — everything needed to scaffold */
 export const AgentConfigSchema = z.object({
     /** Agent identifier (kebab-case, used for directory and package name) */
@@ -13,11 +15,15 @@ export const AgentConfigSchema = z.object({
     domains: z.array(z.string().min(1)).min(1).max(20),
     /** Core principles the agent follows (3-7 recommended) */
     principles: z.array(z.string()).min(1).max(10),
+    /** Communication tone: precise, mentor, or pragmatic */
+    tone: z.enum(TONES).optional().default('pragmatic'),
     /** Greeting message when agent introduces itself (auto-generated if omitted) */
     greeting: z.string().min(10).max(300).optional(),
     /** Output directory (parent — agent dir will be created inside, defaults to cwd) */
     outputDir: z.string().min(1).optional().default(process.cwd()),
     /** Hook packs to install after scaffolding (optional) */
     hookPacks: z.array(z.string()).optional(),
+    /** Skills to include (if omitted, all skills are included for backward compat) */
+    skills: z.array(z.string()).optional(),
 });
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,yEAAyE;IACzE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,gDAAgD,CAAC;IAC3F,kCAAkC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/B,gCAAgC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,iDAAiD;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACxC,0CAA0C;IAC1C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAClD,0DAA0D;IAC1D,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,gFAAgF;IAChF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAChD,oFAAoF;IACpF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9D,yDAAyD;IACzD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+CAA+C;AAC/C,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAGjE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,yEAAyE;IACzE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,gDAAgD,CAAC;IAC3F,kCAAkC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/B,gCAAgC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,iDAAiD;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACxC,0CAA0C;IAC1C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAClD,0DAA0D;IAC1D,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,wDAAwD;IACxD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IACnD,gFAAgF;IAChF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAChD,oFAAoF;IACpF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9D,yDAAyD;IACzD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,kFAAkF;IAClF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/forge",
-  "version": "5.9.0",
+  "version": "5.10.0",
   "description": "Scaffold AI agents that learn, remember, and grow with you.",
   "keywords": [
     "agent",
@@ -31,6 +31,10 @@
     "./lib": {
       "types": "./dist/lib.d.ts",
       "import": "./dist/lib.js"
+    },
+    "./templates/extensions": {
+      "types": "./dist/templates/extensions.d.ts",
+      "import": "./dist/templates/extensions.js"
     }
   },
   "publishConfig": {

package/src/__tests__/extensions-scaffold.test.ts

@@ -0,0 +1,63 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { scaffold, previewScaffold } from '../scaffolder.js';
+import { existsSync, readFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+
+describe('scaffold extensions', () => {
+  const outputDir = join(tmpdir(), 'soleri-ext-test-' + Date.now());
+  const agentId = 'ext-test-agent';
+  const agentDir = join(outputDir, agentId);
+
+  afterEach(() => {
+    rmSync(outputDir, { recursive: true, force: true });
+  });
+
+  it('should create extensions directory with index and example op', () => {
+    scaffold({
+      id: agentId,
+      name: 'Extension Test',
+      role: 'Test agent',
+      description: 'Agent for testing extensions scaffold',
+      domains: ['testing'],
+      principles: ['Test everything'],
+      tone: 'pragmatic',
+      outputDir,
+    });
+
+    // Extensions directory exists
+    expect(existsSync(join(agentDir, 'src', 'extensions', 'index.ts'))).toBe(true);
+    expect(existsSync(join(agentDir, 'src', 'extensions', 'ops', 'example.ts'))).toBe(true);
+    expect(existsSync(join(agentDir, 'src', 'extensions', 'facades'))).toBe(true);
+    expect(existsSync(join(agentDir, 'src', 'extensions', 'middleware'))).toBe(true);
+
+    // Extensions index references the agent ID
+    const indexContent = readFileSync(join(agentDir, 'src', 'extensions', 'index.ts'), 'utf-8');
+    expect(indexContent).toContain('ext-test-agent_core');
+    expect(indexContent).toContain('loadExtensions');
+    expect(indexContent).toContain('AgentExtensions');
+
+    // Entry point imports extensions
+    const entryPoint = readFileSync(join(agentDir, 'src', 'index.ts'), 'utf-8');
+    expect(entryPoint).toContain('wrapWithMiddleware');
+    expect(entryPoint).toContain('./extensions/index.js');
+    expect(entryPoint).toContain('AgentExtensions');
+  });
+
+  it('should include extensions in preview', () => {
+    const preview = previewScaffold({
+      id: agentId,
+      name: 'Extension Test',
+      role: 'Test agent',
+      description: 'Agent for testing extensions scaffold',
+      domains: ['testing'],
+      principles: ['Test everything'],
+      tone: 'pragmatic',
+      outputDir,
+    });
+
+    const extFile = preview.files.find((f) => f.path === 'src/extensions/');
+    expect(extFile).toBeDefined();
+    expect(extFile!.description).toContain('extension');
+  });
+});

package/src/__tests__/scaffolder.test.ts

@@ -56,15 +56,18 @@ describe('Scaffolder', () => {
       expect(paths).not.toContain('src/facades/data-pipelines.facade.ts');
 
       // Should have domain facades + core facade in preview
-      expect(preview.facades).toHaveLength(4); // 3 domains + core
+      expect(preview.facades).toHaveLength(14); // 3 domains + 10 semantic + 1 agent core
       expect(preview.facades[0].name).toBe('atlas_data_pipelines');
 
-      // Core facade should list all 208 ops (203 core + 5 agent-specific)
+      // Agent-specific facade has 5 ops
       const coreFacade = preview.facades.find((f) => f.name === 'atlas_core')!;
-      expect(coreFacade.ops.length).toBe(212);
-      expect(coreFacade.ops).toContain('curator_status');
+      expect(coreFacade.ops.length).toBe(5);
       expect(coreFacade.ops).toContain('health');
 
+      // Semantic facades cover the rest
+      const vaultFacade = preview.facades.find((f) => f.name === 'atlas_vault')!;
+      expect(vaultFacade).toBeDefined();
+
       // Should NOT create any files
       expect(existsSync(join(tempDir, 'atlas'))).toBe(false);
     });
@@ -138,7 +141,7 @@ describe('Scaffolder', () => {
 
       // v5.0 runtime factory pattern
       expect(entry).toContain('createAgentRuntime');
-      expect(entry).toContain('createCoreOps');
+      expect(entry).toContain('createSemanticFacades');
       expect(entry).toContain('createDomainFacades');
       expect(entry).toContain("from '@soleri/core'");
       expect(entry).toContain("agentId: 'atlas'");
@@ -221,7 +224,7 @@ describe('Scaffolder', () => {
 
       // Should use runtime factories from @soleri/core
       expect(facadesTest).toContain('createAgentRuntime');
-      expect(facadesTest).toContain('createCoreOps');
+      expect(facadesTest).toContain('createSemanticFacades');
       expect(facadesTest).toContain('createDomainFacade');
       expect(facadesTest).toContain("from '@soleri/core'");
 

package/src/lib.ts

@@ -17,3 +17,4 @@ export type {
   AddDomainResult,
 } from './types.js';
 export { AgentConfigSchema } from './types.js';
+export { generateExtensionsIndex, generateExampleOp } from './templates/extensions.js';

package/src/scaffolder.ts

@@ -23,6 +23,7 @@ import { generateActivate } from './templates/activate.js';
 import { generateReadme } from './templates/readme.js';
 import { generateSetupScript } from './templates/setup-script.js';
 import { generateSkills } from './templates/skills.js';
+import { generateExtensionsIndex, generateExampleOp } from './templates/extensions.js';
 
 /**
  * Preview what scaffold will create without writing anything.
@@ -42,7 +43,7 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
     {
       path: 'src/index.ts',
       description:
-        'Entry point — thin shell using createAgentRuntime() + createCoreOps() from @soleri/core',
+        'Entry point — thin shell using createAgentRuntime() + createSemanticFacades() from @soleri/core',
     },
     ...config.domains.map((d) => ({
       path: `src/intelligence/data/${d}.json`,
@@ -68,6 +69,10 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
       path: 'src/__tests__/facades.test.ts',
       description: `Facade integration tests — all ${config.domains.length + 1} facades`,
     },
+    {
+      path: 'src/extensions/',
+      description: 'User extension directory — custom ops, facades, middleware, hooks',
+    },
     { path: '.mcp.json', description: 'MCP client config for connecting to this agent' },
     {
       path: 'README.md',
@@ -79,8 +84,9 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
     },
     {
       path: 'skills/',
-      description:
-        '17 built-in skills — TDD, debugging, planning, vault, brain, code patrol, retrospective, onboarding',
+      description: config.skills?.length
+        ? `${config.skills.length} selected skills`
+        : '17 built-in skills — TDD, debugging, planning, vault, brain, code patrol, retrospective, onboarding',
     },
   ];
 
@@ -96,263 +102,90 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
       name: `${config.id}_${d.replace(/-/g, '_')}`,
       ops: ['get_patterns', 'search', 'get_entry', 'capture', 'remove'],
     })),
+    // 10 semantic facades from createSemanticFacades()
     {
-      name: `${config.id}_core`,
+      name: `${config.id}_vault`,
       ops: [
-        // From createCoreOps() — 150 generic ops
         'search',
         'vault_stats',
         'list_all',
-        'register',
-        'memory_search',
-        'memory_capture',
-        'memory_list',
-        'session_capture',
         'export',
+        'capture_enriched',
+        '...vault-extra',
+        '...capture',
+        '...intake',
+      ],
+    },
+    {
+      name: `${config.id}_plan`,
+      ops: [
         'create_plan',
         'get_plan',
         'approve_plan',
         'update_task',
         'complete_plan',
+        '...planning-extra',
+        '...grading',
+      ],
+    },
+    {
+      name: `${config.id}_brain`,
+      ops: [
         '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',
-        // Brain decay report (#89) — 1
-        'brain_decay_report',
-        // Cognee ops — 5
-        'cognee_status',
-        'cognee_search',
-        'cognee_add',
-        'cognee_cognify',
-        'cognee_config',
-        // LLM ops — 2
+        '...19 brain ops',
+      ],
+    },
+    {
+      name: `${config.id}_memory`,
+      ops: [
+        'memory_search',
+        'memory_capture',
+        'memory_list',
+        'session_capture',
+        '...memory-extra',
+        '...cross-project',
+      ],
+    },
+    {
+      name: `${config.id}_admin`,
+      ops: [
         'llm_rotate',
         'llm_call',
-        // Prompt ops — 2
         'render_prompt',
         'list_templates',
-        'curator_status',
-        'curator_detect_duplicates',
-        'curator_contradictions',
-        'curator_resolve_contradiction',
-        'curator_groom',
-        '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 — 22
-        'plan_iterate',
-        'plan_split',
-        'plan_reconcile',
-        'plan_complete_lifecycle',
-        'plan_dispatch',
-        'plan_review',
-        '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',
-        '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',
-        // 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',
-        // Vault archival (#86) — 3
-        'vault_archive',
-        'vault_restore',
-        'vault_optimize',
-        // Admin ops — 8
-        'admin_health',
-        'admin_tool_list',
-        'admin_config',
-        'admin_vault_size',
-        'admin_uptime',
-        'admin_version',
-        'admin_reset_cache',
-        'admin_diagnostic',
-        // 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',
-        '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',
-        // 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',
-        'admin_permissions',
-        'admin_vault_analytics',
-        'admin_search_insights',
-        'admin_module_status',
-        'admin_env',
-        'admin_gc',
-        'admin_export_config',
-        // 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',
-        // Admin persistence (#85) — 1
-        'admin_persistence_info',
-        // 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',
-        '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',
-        // Playbook ops — 5
-        'playbook_list',
-        'playbook_get',
-        'playbook_create',
-        'playbook_match',
-        'playbook_seed',
-        // Agent-specific ops — 5
-        'health',
-        'identity',
-        'activate',
-        'inject_claude_md',
-        'setup',
+        '...admin',
+        '...admin-extra',
       ],
     },
+    {
+      name: `${config.id}_curator`,
+      ops: ['curator_status', 'curator_health_audit', '...8 curator ops', '...curator-extra'],
+    },
+    {
+      name: `${config.id}_loop`,
+      ops: ['loop_start', 'loop_iterate', 'loop_cancel', '...loop ops'],
+    },
+    {
+      name: `${config.id}_orchestrate`,
+      ops: ['register', '...orchestrate', '...project', '...playbook'],
+    },
+    {
+      name: `${config.id}_control`,
+      ops: ['get_identity', 'route_intent', 'governance_policy', '...control+governance ops'],
+    },
+    {
+      name: `${config.id}_cognee`,
+      ops: ['cognee_status', 'cognee_search', '...cognee ops', '...cognee-sync'],
+    },
+    // Agent-specific facade
+    {
+      name: `${config.id}_core`,
+      ops: ['health', 'identity', 'activate', 'inject_claude_md', 'setup'],
+    },
   ];
 
   return {
@@ -399,6 +232,10 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
     'src/identity',
     'src/activation',
     'src/__tests__',
+    'src/extensions',
+    'src/extensions/ops',
+    'src/extensions/facades',
+    'src/extensions/middleware',
   ];
 
   if (config.hookPacks?.length) {
@@ -444,6 +281,8 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
     ['src/activation/activate.ts', generateActivate(config)],
     ['src/index.ts', generateEntryPoint(config)],
     ['src/__tests__/facades.test.ts', generateFacadesTest(config)],
+    ['src/extensions/index.ts', generateExtensionsIndex(config)],
+    ['src/extensions/ops/example.ts', generateExampleOp(config)],
   ];
 
   // Empty intelligence data bundles (domain facades come from @soleri/core at runtime)
@@ -465,7 +304,7 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
     filesCreated.push(path);
   }
 
-  const totalOps = config.domains.length * 5 + 61; // 5 per domain + 56 core (from createCoreOps) + 5 agent-specific
+  const totalOps = config.domains.length * 5 + 214; // 5 per domain + 209 semantic + 5 agent-specific
 
   // Auto-build: install dependencies and compile before registering MCP
   let buildSuccess = false;
@@ -500,7 +339,7 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
 
   const summaryLines = [
     `Created ${config.name} agent at ${agentDir}`,
-    `${config.domains.length + 1} facades with ${totalOps} operations`,
+    `${config.domains.length + 11} facades with ${totalOps} operations`,
     `${config.domains.length} empty knowledge domains ready for capture`,
     `Intelligence layer (Brain) — TF-IDF scoring, auto-tagging, duplicate detection`,
     `Activation system included — say "Hello, ${config.name}!" to activate`,

package/src/templates/entry-point.ts

@@ -3,7 +3,7 @@ import type { AgentConfig } from '../types.js';
 /**
  * Generate the main index.ts entry point for the agent.
  *
- * v5.0: Thin shell — delegates to createAgentRuntime(), createCoreOps(),
+ * v5.0: Thin shell — delegates to createAgentRuntime(), createSemanticFacades(),
  * and createDomainFacades() from @soleri/core. Only agent-specific code
  * (persona, activation) lives here.
  */
@@ -19,12 +19,13 @@ import { fileURLToPath } from 'node:url';
 
 import {
   createAgentRuntime,
-  createCoreOps,
+  createSemanticFacades,
   createDomainFacades,
   registerAllFacades,
   seedDefaultPlaybooks,
+  wrapWithMiddleware,
 } from '@soleri/core';
-import type { OpDefinition } from '@soleri/core';
+import type { OpDefinition, AgentExtensions } from '@soleri/core';
 import { z } from 'zod';
 import { PERSONA, getPersonaPrompt } from './identity/persona.js';
 import { activateAgent, deactivateAgent } from './activation/activate.js';
@@ -201,15 +202,51 @@ async function main(): Promise<void> {
   ];
 
   // ─── Assemble facades ──────────────────────────────────────────
-  const coreOps = createCoreOps(runtime);
-  const coreFacade = {
+  const semanticFacades = createSemanticFacades(runtime, '${config.id}');
+  const agentFacade = {
     name: '${config.id}_core',
-    description: 'Core operations — vault stats, cross-domain search, health check, identity, and activation system.',
-    ops: [...coreOps, ...agentOps],
+    description: 'Agent-specific operations — health, identity, activation, CLAUDE.md injection, setup.',
+    ops: agentOps,
   };
 
   const domainFacades = createDomainFacades(runtime, '${config.id}', ${domainsLiteral});
 
+  // ─── User extensions (auto-discovered from src/extensions/) ────
+  let extensions: AgentExtensions = {};
+  try {
+    const ext = await import('./extensions/index.js');
+    const loader = ext.default ?? (ext as Record<string, unknown>).loadExtensions;
+    if (typeof loader === 'function') {
+      extensions = loader(runtime);
+    } else if (typeof loader === 'object') {
+      extensions = loader;
+    }
+    if (extensions.ops?.length || extensions.facades?.length || extensions.middleware?.length) {
+      console.error(\`[\${tag}] Extensions loaded: \${extensions.ops?.length ?? 0} ops, \${extensions.facades?.length ?? 0} facades, \${extensions.middleware?.length ?? 0} middleware\`);
+    }
+  } catch {
+    // No extensions directory or load error — run vanilla
+  }
+
+  // Merge user ops into agent facade
+  if (extensions.ops?.length) {
+    agentFacade.ops.push(...extensions.ops);
+  }
+
+  // Collect user facades
+  const userFacades = extensions.facades ?? [];
+
+  // Apply middleware to all facades
+  const allFacades = [...semanticFacades, agentFacade, ...domainFacades, ...userFacades];
+  if (extensions.middleware?.length) {
+    wrapWithMiddleware(allFacades, extensions.middleware);
+  }
+
+  // Lifecycle: onStartup
+  if (extensions.hooks?.onStartup) {
+    await extensions.hooks.onStartup(runtime);
+  }
+
   // ─── MCP server ────────────────────────────────────────────────
   const server = new McpServer({
     name: '${config.id}-mcp',
@@ -220,11 +257,10 @@ async function main(): Promise<void> {
     messages: [{ role: 'assistant' as const, content: { type: 'text' as const, text: getPersonaPrompt() } }],
   }));
 
-  const facades = [coreFacade, ...domainFacades];
-  registerAllFacades(server, facades);
+  registerAllFacades(server, allFacades);
 
   console.error(\`[\${tag}] \${PERSONA.name} — \${PERSONA.role}\`);
-  console.error(\`[\${tag}] Registered \${facades.length} facades with \${facades.reduce((sum, f) => sum + f.ops.length, 0)} operations\`);
+  console.error(\`[\${tag}] Registered \${allFacades.length} facades with \${allFacades.reduce((sum, f) => sum + f.ops.length, 0)} operations\`);
 
   // ─── Transport + shutdown ──────────────────────────────────────
   const transport = new StdioServerTransport();
@@ -234,6 +270,13 @@ async function main(): Promise<void> {
 
   const shutdown = async (): Promise<void> => {
     console.error(\`[\${tag}] Shutting down...\`);
+    if (extensions.hooks?.onShutdown) {
+      try {
+        await extensions.hooks.onShutdown(runtime);
+      } catch (err) {
+        console.error(\`[\${tag}] Extension shutdown error:\`, err);
+      }
+    }
     runtime.close();
     process.exit(0);
   };