@soleri/forge 0.0.1 → 4.0.0

package/dist/scaffolder.js

@@ -0,0 +1,330 @@
+import { mkdirSync, writeFileSync, chmodSync, existsSync, readdirSync, readFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { generatePackageJson } from './templates/package-json.js';
+import { generateTsconfig } from './templates/tsconfig.js';
+import { generateVitestConfig } from './templates/vitest-config.js';
+import { generatePersona } from './templates/persona.js';
+import { generateDomainFacade } from './templates/domain-facade.js';
+import { generateCoreFacade } from './templates/core-facade.js';
+import { generateEntryPoint } from './templates/entry-point.js';
+import { generateFacadesTest } from './templates/test-facades.js';
+import { generateClaudeMdTemplate } from './templates/claude-md-template.js';
+import { generateInjectClaudeMd } from './templates/inject-claude-md.js';
+import { generateActivate } from './templates/activate.js';
+import { generateReadme } from './templates/readme.js';
+import { generateSetupScript } from './templates/setup-script.js';
+import { generateLLMClient } from './templates/llm-client.js';
+/**
+ * Preview what scaffold will create without writing anything.
+ */
+export function previewScaffold(config) {
+    const agentDir = join(config.outputDir, config.id);
+    const files = [
+        { path: 'package.json', description: 'NPM package with MCP SDK, SQLite, Zod dependencies' },
+        { path: 'tsconfig.json', description: 'TypeScript config (ES2022, NodeNext, strict)' },
+        { path: 'vitest.config.ts', description: 'Test config (vitest, forks pool, coverage)' },
+        { path: '.gitignore', description: 'Git ignore (node_modules, dist, coverage)' },
+        {
+            path: 'scripts/copy-assets.js',
+            description: 'Build script to copy intelligence data to dist',
+        },
+        {
+            path: 'src/index.ts',
+            description: 'Entry point — initializes vault, planner, brain, registers facades, starts stdio',
+        },
+        {
+            path: 'src/llm/llm-client.ts',
+            description: 'LLM client — unified OpenAI/Anthropic caller with model routing (optional, needs API keys)',
+        },
+        {
+            path: 'src/facades/core.facade.ts',
+            description: 'Core facade — search, vault stats, health, identity',
+        },
+        ...config.domains.map((d) => ({
+            path: `src/facades/${d}.facade.ts`,
+            description: `${d} facade — search, get_patterns, capture, remove`,
+        })),
+        ...config.domains.map((d) => ({
+            path: `src/intelligence/data/${d}.json`,
+            description: `Empty ${d} intelligence bundle — ready for knowledge capture`,
+        })),
+        {
+            path: 'src/identity/persona.ts',
+            description: `${config.name} persona — name, role, principles, greeting`,
+        },
+        {
+            path: 'src/activation/claude-md-content.ts',
+            description: `${config.name} CLAUDE.md content with activation triggers and facades table`,
+        },
+        {
+            path: 'src/activation/inject-claude-md.ts',
+            description: 'Idempotent CLAUDE.md injection — project-level or global (~/.claude/CLAUDE.md)',
+        },
+        {
+            path: 'src/activation/activate.ts',
+            description: `${config.name} activation system — persona adoption, setup status, tool recommendations`,
+        },
+        {
+            path: 'src/__tests__/facades.test.ts',
+            description: `Facade integration tests — all ${config.domains.length + 1} facades`,
+        },
+        { path: '.mcp.json', description: 'MCP client config for connecting to this agent' },
+        {
+            path: 'README.md',
+            description: `${config.name} documentation — quick start, domains, principles, commands`,
+        },
+        {
+            path: 'scripts/setup.sh',
+            description: 'Automated setup — Node.js check, build, Claude Code MCP registration',
+        },
+    ];
+    const facades = [
+        ...config.domains.map((d) => ({
+            name: `${config.id}_${d.replace(/-/g, '_')}`,
+            ops: ['get_patterns', 'search', 'get_entry', 'capture', 'remove'],
+        })),
+        {
+            name: `${config.id}_core`,
+            ops: [
+                'search',
+                'vault_stats',
+                'list_all',
+                'health',
+                'identity',
+                'activate',
+                'inject_claude_md',
+                'setup',
+                'register',
+                'memory_search',
+                'memory_capture',
+                'memory_list',
+                'session_capture',
+                'export',
+                'create_plan',
+                'get_plan',
+                'approve_plan',
+                'update_task',
+                'complete_plan',
+                'record_feedback',
+                'rebuild_vocabulary',
+                'brain_stats',
+                'llm_status',
+            ],
+        },
+    ];
+    return {
+        agentDir,
+        files,
+        facades,
+        domains: config.domains,
+        persona: { name: config.name, role: config.role },
+    };
+}
+/**
+ * Scaffold a complete MCP agent project.
+ */
+export function scaffold(config) {
+    const agentDir = join(config.outputDir, config.id);
+    const filesCreated = [];
+    if (existsSync(agentDir)) {
+        return {
+            success: false,
+            agentDir,
+            filesCreated: [],
+            domains: config.domains,
+            summary: `Directory already exists: ${agentDir}. Choose a different ID or remove the existing directory.`,
+        };
+    }
+    // Create directory structure
+    const dirs = [
+        '',
+        'scripts',
+        'src',
+        'src/facades',
+        'src/intelligence',
+        'src/intelligence/data',
+        'src/identity',
+        'src/activation',
+        'src/llm',
+        'src/__tests__',
+    ];
+    for (const dir of dirs) {
+        mkdirSync(join(agentDir, dir), { recursive: true });
+    }
+    // Write project config files
+    const projectFiles = [
+        ['package.json', generatePackageJson(config)],
+        ['tsconfig.json', generateTsconfig()],
+        ['vitest.config.ts', generateVitestConfig()],
+        ['.gitignore', 'node_modules/\ndist/\ncoverage/\n*.tsbuildinfo\n.env\n.DS_Store\n*.log\n'],
+        [
+            '.mcp.json',
+            JSON.stringify({ mcpServers: { [config.id]: { command: 'node', args: ['dist/index.js'], cwd: '.' } } }, null, 2),
+        ],
+        ['scripts/copy-assets.js', generateCopyAssetsScript()],
+        ['README.md', generateReadme(config)],
+        ['scripts/setup.sh', generateSetupScript(config)],
+    ];
+    for (const [path, content] of projectFiles) {
+        writeFileSync(join(agentDir, path), content, 'utf-8');
+        filesCreated.push(path);
+    }
+    // Make setup script executable
+    chmodSync(join(agentDir, 'scripts', 'setup.sh'), 0o755);
+    // Write source files
+    const sourceFiles = [
+        ['src/facades/core.facade.ts', generateCoreFacade(config)],
+        ['src/identity/persona.ts', generatePersona(config)],
+        ['src/activation/claude-md-content.ts', generateClaudeMdTemplate(config)],
+        ['src/activation/inject-claude-md.ts', generateInjectClaudeMd(config)],
+        ['src/activation/activate.ts', generateActivate(config)],
+        ['src/index.ts', generateEntryPoint(config)],
+        ['src/llm/llm-client.ts', generateLLMClient(config)],
+        ['src/__tests__/facades.test.ts', generateFacadesTest(config)],
+    ];
+    // Domain facades and empty data files
+    for (const domain of config.domains) {
+        sourceFiles.push([`src/facades/${domain}.facade.ts`, generateDomainFacade(config.id, domain)]);
+        sourceFiles.push([`src/intelligence/data/${domain}.json`, generateEmptyBundle(domain)]);
+    }
+    for (const [path, content] of sourceFiles) {
+        writeFileSync(join(agentDir, path), content, 'utf-8');
+        filesCreated.push(path);
+    }
+    const totalOps = config.domains.length * 5 + 24; // 5 per domain + 24 core (activation, registration, memory, session, export, planning, brain, llm)
+    // Register the agent as an MCP server in ~/.claude.json
+    const mcpReg = registerMcpServer(config.id, agentDir);
+    const summaryLines = [
+        `Created ${config.name} agent at ${agentDir}`,
+        `${config.domains.length + 1} 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`,
+        `1 test suite — facades (vault, brain, planner, llm tests provided by @soleri/core)`,
+    ];
+    if (mcpReg.registered) {
+        summaryLines.push(`MCP server registered in ${mcpReg.path}`);
+    }
+    else {
+        summaryLines.push(`Warning: Failed to register MCP server in ${mcpReg.path}: ${mcpReg.error}`);
+    }
+    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`);
+    return {
+        success: true,
+        agentDir,
+        filesCreated,
+        domains: config.domains,
+        summary: summaryLines.join('\n'),
+    };
+}
+/**
+ * List agents in a directory.
+ */
+export function listAgents(parentDir) {
+    if (!existsSync(parentDir))
+        return [];
+    const agents = [];
+    let entries;
+    try {
+        entries = readdirSync(parentDir, { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+    for (const name of entries) {
+        const dir = join(parentDir, name);
+        const pkgPath = join(dir, 'package.json');
+        if (!existsSync(pkgPath))
+            continue;
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            if (!pkg.name?.endsWith('-mcp'))
+                continue;
+            const dataDir = join(dir, 'src', 'intelligence', 'data');
+            let domains = [];
+            try {
+                domains = readdirSync(dataDir)
+                    .filter((f) => f.endsWith('.json'))
+                    .map((f) => f.replace('.json', ''));
+            }
+            catch {
+                /* empty */
+            }
+            agents.push({
+                id: name,
+                name: pkg.name.replace('-mcp', ''),
+                role: pkg.description || '',
+                path: dir,
+                domains,
+                hasNodeModules: existsSync(join(dir, 'node_modules')),
+                hasDistDir: existsSync(join(dir, 'dist')),
+            });
+        }
+        catch {
+            /* skip non-agent directories */
+        }
+    }
+    return agents;
+}
+/**
+ * Register the agent as an MCP server in ~/.claude.json (User MCPs).
+ * Idempotent — updates existing entry if present.
+ */
+function registerMcpServer(agentId, agentDir) {
+    const claudeJsonPath = join(homedir(), '.claude.json');
+    try {
+        let config = {};
+        if (existsSync(claudeJsonPath)) {
+            config = JSON.parse(readFileSync(claudeJsonPath, 'utf-8'));
+        }
+        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
+            config.mcpServers = {};
+        }
+        const servers = config.mcpServers;
+        servers[agentId] = {
+            type: 'stdio',
+            command: 'node',
+            args: [join(agentDir, 'dist', 'index.js')],
+            env: {},
+        };
+        writeFileSync(claudeJsonPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+        return { registered: true, path: claudeJsonPath };
+    }
+    catch (err) {
+        return {
+            registered: false,
+            path: claudeJsonPath,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+function generateEmptyBundle(domain) {
+    return JSON.stringify({
+        domain,
+        version: '1.0.0',
+        entries: [],
+    }, null, 2);
+}
+function generateCopyAssetsScript() {
+    return [
+        "import { cpSync, existsSync, mkdirSync } from 'node:fs';",
+        "import { join, dirname } from 'node:path';",
+        "import { fileURLToPath } from 'node:url';",
+        '',
+        'const __dirname = dirname(fileURLToPath(import.meta.url));',
+        "const root = join(__dirname, '..');",
+        "const dist = join(root, 'dist');",
+        "const dataSource = join(root, 'src', 'intelligence', 'data');",
+        "const dataDest = join(dist, 'intelligence', 'data');",
+        '',
+        'if (existsSync(dataSource)) {',
+        '  mkdirSync(dataDest, { recursive: true });',
+        '  cpSync(dataSource, dataDest, { recursive: true });',
+        "  console.log('Copied intelligence data to dist/');",
+        '}',
+    ].join('\n');
+}
+//# sourceMappingURL=scaffolder.js.map

package/dist/scaffolder.js.map

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

package/dist/templates/activate.d.ts

@@ -0,0 +1,9 @@
+import type { AgentConfig } from '../types.js';
+/**
+ * Generates src/activation/activate.ts for a new agent.
+ * Provides the activate/deactivate system that returns full context
+ * to Claude — persona, guidelines, tool recommendations, setup status.
+ *
+ * Uses array-joined pattern because generated code contains template literals.
+ */
+export declare function generateActivate(config: AgentConfig): string;

package/dist/templates/activate.js

@@ -0,0 +1,139 @@
+/**
+ * Generates src/activation/activate.ts for a new agent.
+ * Provides the activate/deactivate system that returns full context
+ * to Claude — persona, guidelines, tool recommendations, setup status.
+ *
+ * Uses array-joined pattern because generated code contains template literals.
+ */
+export function generateActivate(config) {
+    const facadeId = config.id.replace(/-/g, '_');
+    const _marker = `${config.id}:mode`;
+    // Build tool recommendations from config domains
+    const toolRecLines = [];
+    for (const d of config.domains) {
+        const toolName = `${facadeId}_${d.replace(/-/g, '_')}`;
+        toolRecLines.push(`      { intent: 'search ${d}', facade: '${toolName}', op: 'search' },`);
+        toolRecLines.push(`      { intent: '${d} patterns', facade: '${toolName}', op: 'get_patterns' },`);
+        toolRecLines.push(`      { intent: 'capture ${d}', facade: '${toolName}', op: 'capture' },`);
+    }
+    // Build behavioral guidelines from config principles
+    const guidelineLines = config.principles
+        .map((p) => {
+        const escaped = p.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+        return `      '${escaped}',`;
+    })
+        .join('\n');
+    return [
+        "import { join } from 'node:path';",
+        "import { homedir } from 'node:os';",
+        "import { PERSONA } from '../identity/persona.js';",
+        "import { hasAgentMarker } from './inject-claude-md.js';",
+        "import type { Vault, Planner, Plan } from '@soleri/core';",
+        '',
+        'export interface ActivationResult {',
+        '  activated: boolean;',
+        '  persona: {',
+        '    name: string;',
+        '    role: string;',
+        '    description: string;',
+        '    greeting: string;',
+        '  };',
+        '  guidelines: string[];',
+        '  tool_recommendations: Array<{ intent: string; facade: string; op: string }>;',
+        '  session_instruction: string;',
+        '  setup_status: {',
+        '    claude_md_injected: boolean;',
+        '    global_claude_md_injected: boolean;',
+        '    vault_has_entries: boolean;',
+        '    vault_entry_count: number;',
+        '  };',
+        '  executing_plans: Array<{ id: string; objective: string; tasks: number; completed: number }>;',
+        '  next_steps: string[];',
+        '}',
+        '',
+        'export interface DeactivationResult {',
+        '  deactivated: boolean;',
+        '  message: string;',
+        '}',
+        '',
+        '/**',
+        ` * Activate ${config.name} — returns full context for Claude to adopt the persona.`,
+        ' */',
+        'export function activateAgent(vault: Vault, projectPath: string, planner?: Planner): ActivationResult {',
+        '  // Check CLAUDE.md injection status (project-level and global)',
+        "  const projectClaudeMd = join(projectPath, 'CLAUDE.md');",
+        "  const globalClaudeMd = join(homedir(), '.claude', 'CLAUDE.md');",
+        '  const claudeMdInjected = hasAgentMarker(projectClaudeMd);',
+        '  const globalClaudeMdInjected = hasAgentMarker(globalClaudeMd);',
+        '',
+        '  // Check vault status',
+        '  const stats = vault.stats();',
+        '  const vaultHasEntries = stats.totalEntries > 0;',
+        '',
+        "  // Build next steps based on what's missing",
+        '  const nextSteps: string[] = [];',
+        '  if (!globalClaudeMdInjected && !claudeMdInjected) {',
+        `    nextSteps.push('No CLAUDE.md configured — run inject_claude_md with global: true for all projects, or without for this project only');`,
+        '  } else if (!globalClaudeMdInjected) {',
+        `    nextSteps.push('Global CLAUDE.md not configured — run inject_claude_md with global: true to enable activation in all projects');`,
+        '  }',
+        '  if (!vaultHasEntries) {',
+        "    nextSteps.push('Vault is empty — start capturing knowledge with the domain capture ops');",
+        '  }',
+        '  if (nextSteps.length === 0) {',
+        `    nextSteps.push('All set! ${config.name} is fully integrated.');`,
+        '  }',
+        '',
+        '  // Check for executing plans',
+        '  const executingPlans = planner ? planner.getExecuting().map((p) => ({',
+        '    id: p.id,',
+        '    objective: p.objective,',
+        '    tasks: p.tasks.length,',
+        "    completed: p.tasks.filter((t) => t.status === 'completed').length,",
+        '  })) : [];',
+        '  if (executingPlans.length > 0) {',
+        '    nextSteps.unshift(`${executingPlans.length} plan(s) in progress — use get_plan to review`);',
+        '  }',
+        '',
+        '  return {',
+        '    activated: true,',
+        '    persona: {',
+        '      name: PERSONA.name,',
+        '      role: PERSONA.role,',
+        '      description: PERSONA.description,',
+        '      greeting: PERSONA.greeting,',
+        '    },',
+        '    guidelines: [',
+        guidelineLines,
+        '    ],',
+        '    tool_recommendations: [',
+        `      { intent: 'health check', facade: '${facadeId}_core', op: 'health' },`,
+        `      { intent: 'search all', facade: '${facadeId}_core', op: 'search' },`,
+        `      { intent: 'vault stats', facade: '${facadeId}_core', op: 'vault_stats' },`,
+        ...toolRecLines,
+        '    ],',
+        `    session_instruction: 'You are now ' + PERSONA.name + ', a ' + PERSONA.role + '. Stay in character for the ENTIRE session. ' +`,
+        `      'Reference patterns from the knowledge vault. Provide concrete examples. Flag anti-patterns with severity.',`,
+        '    setup_status: {',
+        '      claude_md_injected: claudeMdInjected,',
+        '      global_claude_md_injected: globalClaudeMdInjected,',
+        '      vault_has_entries: vaultHasEntries,',
+        '      vault_entry_count: stats.totalEntries,',
+        '    },',
+        '    executing_plans: executingPlans,',
+        '    next_steps: nextSteps,',
+        '  };',
+        '}',
+        '',
+        '/**',
+        ` * Deactivate ${config.name} — drops persona for the session.`,
+        ' */',
+        'export function deactivateAgent(): DeactivationResult {',
+        '  return {',
+        '    deactivated: true,',
+        `    message: 'Goodbye! ' + PERSONA.name + ' persona deactivated. Reverting to default behavior.',`,
+        '  };',
+        '}',
+    ].join('\n');
+}
+//# sourceMappingURL=activate.js.map

package/dist/templates/activate.js.map

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

package/dist/templates/brain.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates the brain.ts source file for a new agent.
+ * The Brain provides a local, zero-dependency intelligence layer:
+ * TF-IDF scoring, auto-tagging, duplicate detection, and search feedback.
+ */
+export declare function generateBrain(): string;