@soleri/forge 5.14.0 → 5.14.1

package/dist/templates/claude-md-template.d.ts

@@ -2,14 +2,15 @@ import type { AgentConfig } from '../types.js';
 /**
  * Generates src/activation/claude-md-content.ts for a new agent.
  *
- * Architecture:
- * 1. Agent-specific identity (persona, domains, principles)
- * 2. Session start protocol
- * 3. Curated facade table (~30 key ops, grouped by category)
- * 4. Shared behavioral rules (vault-first, planning, output formatting)
- * 5. Hook packs (conditional)
+ * Architecture (split injection):
+ * 1. Engine rules — shared, prefix-free, injected once under `<!-- soleri:engine-rules -->`
+ * 2. Agent block — lightweight, agent-specific, under `<!-- agent-id:mode -->`
+ *    - Identity (persona, domains, principles)
+ *    - Session start protocol
+ *    - Curated facade table (~30 key ops, grouped by category)
+ *    - Hook packs (conditional)
  *
- * Full op list is always available via `admin_tool_list` — no need to
- * enumerate all 145+ ops in CLAUDE.md.
+ * The facade table maps `op:name` → actual `agentId_core op:name` tool calls.
+ * Full op list is always available via `admin_tool_list`.
  */
 export declare function generateClaudeMdTemplate(config: AgentConfig): string;

package/dist/templates/claude-md-template.js

@@ -1,16 +1,17 @@
-import { getSharedRules } from './shared-rules.js';
+import { getEngineMarker, getEngineRulesContent } from './shared-rules.js';
 /**
  * Generates src/activation/claude-md-content.ts for a new agent.
  *
- * Architecture:
- * 1. Agent-specific identity (persona, domains, principles)
- * 2. Session start protocol
- * 3. Curated facade table (~30 key ops, grouped by category)
- * 4. Shared behavioral rules (vault-first, planning, output formatting)
- * 5. Hook packs (conditional)
+ * Architecture (split injection):
+ * 1. Engine rules — shared, prefix-free, injected once under `<!-- soleri:engine-rules -->`
+ * 2. Agent block — lightweight, agent-specific, under `<!-- agent-id:mode -->`
+ *    - Identity (persona, domains, principles)
+ *    - Session start protocol
+ *    - Curated facade table (~30 key ops, grouped by category)
+ *    - Hook packs (conditional)
  *
- * Full op list is always available via `admin_tool_list` — no need to
- * enumerate all 145+ ops in CLAUDE.md.
+ * The facade table maps `op:name` → actual `agentId_core op:name` tool calls.
+ * Full op list is always available via `admin_tool_list`.
  */
 export function generateClaudeMdTemplate(config) {
     const toolPrefix = config.id;
@@ -57,8 +58,6 @@ export function generateClaudeMdTemplate(config) {
     // Engine facades — compact, grouped by concern
     mdLines.push(`| ${bt}${toolPrefix}_core${bt} (vault) | ${bt}search_intelligent${bt}, ${bt}capture_knowledge${bt}, ${bt}capture_quick${bt}, ${bt}search_feedback${bt} |`, `| ${bt}${toolPrefix}_core${bt} (memory) | ${bt}memory_search${bt}, ${bt}memory_capture${bt}, ${bt}session_capture${bt} |`, `| ${bt}${toolPrefix}_core${bt} (planning) | ${bt}create_plan${bt}, ${bt}approve_plan${bt}, ${bt}plan_split${bt}, ${bt}plan_reconcile${bt}, ${bt}plan_complete_lifecycle${bt} |`, `| ${bt}${toolPrefix}_core${bt} (orchestrate) | ${bt}orchestrate_plan${bt}, ${bt}orchestrate_execute${bt}, ${bt}orchestrate_complete${bt} |`, `| ${bt}${toolPrefix}_core${bt} (brain) | ${bt}brain_stats${bt}, ${bt}brain_feedback${bt}, ${bt}rebuild_vocabulary${bt} |`, `| ${bt}${toolPrefix}_core${bt} (control) | ${bt}route_intent${bt}, ${bt}morph${bt}, ${bt}get_behavior_rules${bt} |`, `| ${bt}${toolPrefix}_core${bt} (loop) | ${bt}loop_start${bt}, ${bt}loop_iterate${bt}, ${bt}loop_status${bt}, ${bt}loop_cancel${bt} |`, `| ${bt}${toolPrefix}_core${bt} (governance) | ${bt}governance_dashboard${bt}, ${bt}governance_policy${bt}, ${bt}governance_proposals${bt} |`, `| ${bt}${toolPrefix}_core${bt} (admin) | ${bt}admin_health${bt}, ${bt}admin_tool_list${bt}, ${bt}admin_diagnostic${bt} |`);
     mdLines.push('', `> Full list: ${bt}${toolPrefix}_core op:admin_tool_list${bt}`, '');
-    // ─── Shared Behavioral Rules ───────────────────────────
-    mdLines.push(...getSharedRules(toolPrefix));
     // ─── Hook Packs (conditional) ──────────────────────────
     appendHookPacks(mdLines, config);
     // ─── Closing marker ────────────────────────────────────
@@ -68,11 +67,19 @@ export function generateClaudeMdTemplate(config) {
         const escaped = line.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
         return `    '${escaped}',`;
     });
+    // Generate engine rules as a quoted string literal
+    const engineContent = getEngineRulesContent();
+    const engineQuotedLines = engineContent.split('\n').map((line) => {
+        const escaped = line.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+        return `    '${escaped}',`;
+    });
     return [
         '/**',
         ` * CLAUDE.md content for ${config.name}.`,
         ' * Generated by Soleri — do not edit manually.',
         ' */',
+        '',
+        '/** Agent-specific block (identity + activation + facade table). */',
         'export function getClaudeMdContent(): string {',
         '  return [',
         ...quotedLines,
@@ -82,6 +89,17 @@ export function generateClaudeMdTemplate(config) {
         'export function getClaudeMdMarker(): string {',
         `  return '${marker}';`,
         '}',
+        '',
+        '/** Shared engine rules — injected once, skipped if already present. */',
+        'export function getEngineRulesContent(): string {',
+        '  return [',
+        ...engineQuotedLines,
+        "  ].join('\\n');",
+        '}',
+        '',
+        'export function getEngineRulesMarker(): string {',
+        `  return '${getEngineMarker()}';`,
+        '}',
     ].join('\n');
 }
 function appendHookPacks(mdLines, config) {

package/dist/templates/claude-md-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-md-template.js","sourceRoot":"","sources":["../../src/templates/claude-md-template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"claude-md-template.js","sourceRoot":"","sources":["../../src/templates/claude-md-template.ts"],"names":[],"mappings":"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"}

package/dist/templates/inject-claude-md.js

@@ -13,27 +13,27 @@ export function generateInjectClaudeMd(config) {
         "import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';",
         "import { homedir } from 'node:os';",
         "import { join } from 'node:path';",
-        "import { getClaudeMdContent, getClaudeMdMarker } from './claude-md-content.js';",
+        "import { getClaudeMdContent, getClaudeMdMarker, getEngineRulesContent, getEngineRulesMarker } from './claude-md-content.js';",
         '',
         'export interface InjectResult {',
         '  injected: boolean;',
         '  path: string;',
         "  action: 'created' | 'updated' | 'appended';",
+        '  engineRules?: boolean;',
         '}',
         '',
         '/**',
-        ' * Inject into a specific CLAUDE.md file path.',
-        ' * Shared logic for both project-level and global injection.',
+        ' * Inject a marker-delimited block into a file.',
+        ' * If the marker already exists, replaces the content between markers.',
+        ' * Otherwise appends (or creates the file).',
         ' */',
-        'function injectIntoFile(filePath: string): InjectResult {',
-        '  const content = getClaudeMdContent();',
-        '  const marker = getClaudeMdMarker();',
+        "function injectBlock(filePath: string, content: string, marker: string): 'created' | 'updated' | 'appended' | 'skipped' {",
         `  const startMarker = '<!-- ' + marker + ' -->';`,
         `  const endMarker = '<!-- /' + marker + ' -->';`,
         '',
         '  if (!existsSync(filePath)) {',
         "    writeFileSync(filePath, content + '\\n', 'utf-8');",
-        "    return { injected: true, path: filePath, action: 'created' };",
+        "    return 'created';",
         '  }',
         '',
         "  const existing = readFileSync(filePath, 'utf-8');",
@@ -44,30 +44,52 @@ export function generateInjectClaudeMd(config) {
         '    if (endIdx === -1) {',
         "      const updated = existing.slice(0, startIdx) + content + '\\n' + existing.slice(startIdx + startMarker.length);",
         "      writeFileSync(filePath, updated, 'utf-8');",
-        "      return { injected: true, path: filePath, action: 'updated' };",
+        "      return 'updated';",
         '    }',
         '    const updated = existing.slice(0, startIdx) + content + existing.slice(endIdx + endMarker.length);',
         "    writeFileSync(filePath, updated, 'utf-8');",
-        "    return { injected: true, path: filePath, action: 'updated' };",
+        "    return 'updated';",
         '  }',
         '',
         "  const separator = existing.endsWith('\\n') ? '\\n' : '\\n\\n';",
         "  writeFileSync(filePath, existing + separator + content + '\\n', 'utf-8');",
-        "  return { injected: true, path: filePath, action: 'appended' };",
+        "  return 'appended';",
+        '}',
+        '',
+        '/**',
+        ' * Inject engine rules + agent block into a CLAUDE.md file.',
+        ' *',
+        ' * Engine rules (shared, prefix-free) are injected ONCE under',
+        ' * `<!-- soleri:engine-rules -->`. If already present, they are updated.',
+        ' * Agent block (identity + facade table) is injected under',
+        ` * \`<!-- ${marker} -->\`.`,
+        ' */',
+        'function injectIntoFile(filePath: string): InjectResult {',
+        '  // Step 1: Engine rules — shared across all agents',
+        '  const engineAction = injectBlock(filePath, getEngineRulesContent(), getEngineRulesMarker());',
+        '',
+        '  // Step 2: Agent-specific block',
+        '  const agentAction = injectBlock(filePath, getClaudeMdContent(), getClaudeMdMarker());',
+        '',
+        '  return {',
+        '    injected: true,',
+        '    path: filePath,',
+        "    action: agentAction === 'skipped' ? 'appended' : agentAction,",
+        "    engineRules: engineAction !== 'skipped',",
+        '  };',
         '}',
         '',
         '/**',
         ' * Inject agent CLAUDE.md section into a project.',
-        ' * - If no CLAUDE.md exists: creates one',
-        ' * - If markers found: replaces content between them (update)',
-        ' * - If no markers: appends section to end',
+        ' * - Engine rules: injected once, updated if already present',
+        ' * - Agent block: created, updated, or appended',
         ' */',
         'export function injectClaudeMd(projectPath: string): InjectResult {',
         "  return injectIntoFile(join(projectPath, 'CLAUDE.md'));",
         '}',
         '',
         '/**',
-        ' * Inject agent CLAUDE.md section into the global ~/.claude/CLAUDE.md.',
+        ' * Inject into the global ~/.claude/CLAUDE.md.',
         " * Creates ~/.claude/ directory if it doesn't exist.",
         ' * This makes the activation phrase work in any project.',
         ' */',
@@ -80,39 +102,48 @@ export function generateInjectClaudeMd(config) {
         '}',
         '',
         '/**',
-        ' * Remove agent section from a specific CLAUDE.md file.',
-        ' * Returns true if the section was found and removed.',
+        ' * Remove a marker-delimited block from a file.',
         ' */',
-        'function removeFromFile(filePath: string): { removed: boolean; path: string } {',
-        '  if (!existsSync(filePath)) return { removed: false, path: filePath };',
+        'function removeBlock(filePath: string, marker: string): boolean {',
+        '  if (!existsSync(filePath)) return false;',
         "  const existing = readFileSync(filePath, 'utf-8');",
-        '  const marker = getClaudeMdMarker();',
         `  const startMarker = '<!-- ' + marker + ' -->';`,
         `  const endMarker = '<!-- /' + marker + ' -->';`,
         '  const startIdx = existing.indexOf(startMarker);',
-        '  if (startIdx === -1) return { removed: false, path: filePath };',
+        '  if (startIdx === -1) return false;',
         '  const endIdx = existing.indexOf(endMarker);',
-        '  if (endIdx === -1) return { removed: false, path: filePath };',
+        '  if (endIdx === -1) return false;',
         "  const before = existing.slice(0, startIdx).replace(/\\n+$/, '');",
         "  const after = existing.slice(endIdx + endMarker.length).replace(/^\\n+/, '');",
         "  const cleaned = before + (before && after ? '\\n\\n' : '') + after;",
         "  writeFileSync(filePath, cleaned || '', 'utf-8');",
-        '  return { removed: true, path: filePath };',
+        '  return true;',
         '}',
         '',
         '/**',
         ' * Remove agent section from the global ~/.claude/CLAUDE.md.',
-        ' * Called on deactivation to clean up after test agents.',
+        ' * Only removes the agent block, NOT the shared engine rules',
+        ' * (other agents may depend on them).',
         ' */',
         'export function removeClaudeMdGlobal(): { removed: boolean; path: string } {',
-        "  return removeFromFile(join(homedir(), '.claude', 'CLAUDE.md'));",
+        "  const filePath = join(homedir(), '.claude', 'CLAUDE.md');",
+        '  return { removed: removeBlock(filePath, getClaudeMdMarker()), path: filePath };',
         '}',
         '',
         '/**',
         ' * Remove agent section from a project CLAUDE.md.',
         ' */',
         'export function removeClaudeMd(projectPath: string): { removed: boolean; path: string } {',
-        "  return removeFromFile(join(projectPath, 'CLAUDE.md'));",
+        "  const filePath = join(projectPath, 'CLAUDE.md');",
+        '  return { removed: removeBlock(filePath, getClaudeMdMarker()), path: filePath };',
+        '}',
+        '',
+        '/**',
+        ' * Remove shared engine rules from a file.',
+        ' * Use only when NO agents remain in the file.',
+        ' */',
+        'export function removeEngineRules(filePath: string): boolean {',
+        '  return removeBlock(filePath, getEngineRulesMarker());',
         '}',
         '',
         '/**',
@@ -123,6 +154,15 @@ export function generateInjectClaudeMd(config) {
         "  const content = readFileSync(filePath, 'utf-8');",
         `  return content.includes('<!-- ${marker} -->');`,
         '}',
+        '',
+        '/**',
+        ' * Check if engine rules are already present in a CLAUDE.md file.',
+        ' */',
+        'export function hasEngineRules(filePath: string): boolean {',
+        '  if (!existsSync(filePath)) return false;',
+        "  const content = readFileSync(filePath, 'utf-8');",
+        "  return content.includes('<!-- ' + getEngineRulesMarker() + ' -->');",
+        '}',
     ].join('\n');
 }
 //# sourceMappingURL=inject-claude-md.js.map

package/dist/templates/inject-claude-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"inject-claude-md.js","sourceRoot":"","sources":["../../src/templates/inject-claude-md.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACxD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,OAAO,CAAC;IAEnC,OAAO;QACL,+EAA+E;QAC/E,oCAAoC;QACpC,mCAAmC;QACnC,iFAAiF;QACjF,EAAE;QACF,iCAAiC;QACjC,sBAAsB;QACtB,iBAAiB;QACjB,+CAA+C;QAC/C,GAAG;QACH,EAAE;QACF,KAAK;QACL,gDAAgD;QAChD,8DAA8D;QAC9D,KAAK;QACL,2DAA2D;QAC3D,yCAAyC;QACzC,uCAAuC;QACvC,kDAAkD;QAClD,iDAAiD;QACjD,EAAE;QACF,gCAAgC;QAChC,wDAAwD;QACxD,mEAAmE;QACnE,KAAK;QACL,EAAE;QACF,qDAAqD;QACrD,EAAE;QACF,yCAAyC;QACzC,qDAAqD;QACrD,iDAAiD;QACjD,0BAA0B;QAC1B,sHAAsH;QACtH,kDAAkD;QAClD,qEAAqE;QACrE,OAAO;QACP,wGAAwG;QACxG,gDAAgD;QAChD,mEAAmE;QACnE,KAAK;QACL,EAAE;QACF,kEAAkE;QAClE,6EAA6E;QAC7E,kEAAkE;QAClE,GAAG;QACH,EAAE;QACF,KAAK;QACL,mDAAmD;QACnD,0CAA0C;QAC1C,+DAA+D;QAC/D,4CAA4C;QAC5C,KAAK;QACL,qEAAqE;QACrE,0DAA0D;QAC1D,GAAG;QACH,EAAE;QACF,KAAK;QACL,wEAAwE;QACxE,sDAAsD;QACtD,0DAA0D;QAC1D,KAAK;QACL,wDAAwD;QACxD,iDAAiD;QACjD,iCAAiC;QACjC,gDAAgD;QAChD,KAAK;QACL,wDAAwD;QACxD,GAAG;QACH,EAAE;QACF,KAAK;QACL,yDAAyD;QACzD,uDAAuD;QACvD,KAAK;QACL,iFAAiF;QACjF,yEAAyE;QACzE,qDAAqD;QACrD,uCAAuC;QACvC,kDAAkD;QAClD,iDAAiD;QACjD,mDAAmD;QACnD,mEAAmE;QACnE,+CAA+C;QAC/C,iEAAiE;QACjE,oEAAoE;QACpE,iFAAiF;QACjF,uEAAuE;QACvE,oDAAoD;QACpD,6CAA6C;QAC7C,GAAG;QACH,EAAE;QACF,KAAK;QACL,8DAA8D;QAC9D,0DAA0D;QAC1D,KAAK;QACL,8EAA8E;QAC9E,mEAAmE;QACnE,GAAG;QACH,EAAE;QACF,KAAK;QACL,mDAAmD;QACnD,KAAK;QACL,2FAA2F;QAC3F,0DAA0D;QAC1D,GAAG;QACH,EAAE;QACF,KAAK;QACL,0DAA0D;QAC1D,KAAK;QACL,6DAA6D;QAC7D,4CAA4C;QAC5C,oDAAoD;QACpD,mCAAmC,MAAM,SAAS;QAClD,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"inject-claude-md.js","sourceRoot":"","sources":["../../src/templates/inject-claude-md.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACxD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,OAAO,CAAC;IAEnC,OAAO;QACL,+EAA+E;QAC/E,oCAAoC;QACpC,mCAAmC;QACnC,8HAA8H;QAC9H,EAAE;QACF,iCAAiC;QACjC,sBAAsB;QACtB,iBAAiB;QACjB,+CAA+C;QAC/C,0BAA0B;QAC1B,GAAG;QACH,EAAE;QACF,KAAK;QACL,iDAAiD;QACjD,wEAAwE;QACxE,6CAA6C;QAC7C,KAAK;QACL,2HAA2H;QAC3H,kDAAkD;QAClD,iDAAiD;QACjD,EAAE;QACF,gCAAgC;QAChC,wDAAwD;QACxD,uBAAuB;QACvB,KAAK;QACL,EAAE;QACF,qDAAqD;QACrD,EAAE;QACF,yCAAyC;QACzC,qDAAqD;QACrD,iDAAiD;QACjD,0BAA0B;QAC1B,sHAAsH;QACtH,kDAAkD;QAClD,yBAAyB;QACzB,OAAO;QACP,wGAAwG;QACxG,gDAAgD;QAChD,uBAAuB;QACvB,KAAK;QACL,EAAE;QACF,kEAAkE;QAClE,6EAA6E;QAC7E,sBAAsB;QACtB,GAAG;QACH,EAAE;QACF,KAAK;QACL,6DAA6D;QAC7D,IAAI;QACJ,+DAA+D;QAC/D,0EAA0E;QAC1E,4DAA4D;QAC5D,aAAa,MAAM,SAAS;QAC5B,KAAK;QACL,2DAA2D;QAC3D,sDAAsD;QACtD,gGAAgG;QAChG,EAAE;QACF,mCAAmC;QACnC,yFAAyF;QACzF,EAAE;QACF,YAAY;QACZ,qBAAqB;QACrB,qBAAqB;QACrB,mEAAmE;QACnE,8CAA8C;QAC9C,MAAM;QACN,GAAG;QACH,EAAE;QACF,KAAK;QACL,mDAAmD;QACnD,8DAA8D;QAC9D,iDAAiD;QACjD,KAAK;QACL,qEAAqE;QACrE,0DAA0D;QAC1D,GAAG;QACH,EAAE;QACF,KAAK;QACL,gDAAgD;QAChD,sDAAsD;QACtD,0DAA0D;QAC1D,KAAK;QACL,wDAAwD;QACxD,iDAAiD;QACjD,iCAAiC;QACjC,gDAAgD;QAChD,KAAK;QACL,wDAAwD;QACxD,GAAG;QACH,EAAE;QACF,KAAK;QACL,iDAAiD;QACjD,KAAK;QACL,mEAAmE;QACnE,4CAA4C;QAC5C,qDAAqD;QACrD,kDAAkD;QAClD,iDAAiD;QACjD,mDAAmD;QACnD,sCAAsC;QACtC,+CAA+C;QAC/C,oCAAoC;QACpC,oEAAoE;QACpE,iFAAiF;QACjF,uEAAuE;QACvE,oDAAoD;QACpD,gBAAgB;QAChB,GAAG;QACH,EAAE;QACF,KAAK;QACL,8DAA8D;QAC9D,8DAA8D;QAC9D,uCAAuC;QACvC,KAAK;QACL,8EAA8E;QAC9E,6DAA6D;QAC7D,mFAAmF;QACnF,GAAG;QACH,EAAE;QACF,KAAK;QACL,mDAAmD;QACnD,KAAK;QACL,2FAA2F;QAC3F,oDAAoD;QACpD,mFAAmF;QACnF,GAAG;QACH,EAAE;QACF,KAAK;QACL,4CAA4C;QAC5C,gDAAgD;QAChD,KAAK;QACL,gEAAgE;QAChE,yDAAyD;QACzD,GAAG;QACH,EAAE;QACF,KAAK;QACL,0DAA0D;QAC1D,KAAK;QACL,6DAA6D;QAC7D,4CAA4C;QAC5C,oDAAoD;QACpD,mCAAmC,MAAM,SAAS;QAClD,GAAG;QACH,EAAE;QACF,KAAK;QACL,mEAAmE;QACnE,KAAK;QACL,6DAA6D;QAC7D,4CAA4C;QAC5C,oDAAoD;QACpD,uEAAuE;QACvE,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/templates/shared-rules.d.ts

@@ -1,9 +1,13 @@
 /**
- * Shared behavioral rules that every Soleri agent ships with.
+ * Shared Soleri engine rules — agent-agnostic.
  *
- * Mirrors the structure and quality of Salvador's global CLAUDE.md.
- * Uses HTML comment section markers, MANDATORY keywords, compact
- * formatting, and complete lifecycle documentation.
+ * These rules are injected ONCE into global ~/.claude/CLAUDE.md under
+ * the `<!-- soleri:engine-rules -->` marker. They describe behavioral
+ * rules WITHOUT tool prefixes. The active agent's facade table (in its
+ * own `<!-- agent-id:mode -->` block) maps op names to actual tools.
+ *
+ * Uses op:name syntax — the active agent provides the tool prefix.
  */
-/** Returns markdown lines for all shared behavioral sections. */
-export declare function getSharedRules(toolPrefix: string): string[];
+export declare function getEngineMarker(): string;
+/** Returns the full engine rules markdown content (with markers). */
+export declare function getEngineRulesContent(): string;