@soleri/forge 0.0.1 → 4.0.0

package/dist/knowledge-installer.js

@@ -0,0 +1,437 @@
+import { existsSync, readFileSync, writeFileSync, readdirSync, copyFileSync, mkdirSync, } from 'node:fs';
+import { join, basename } from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { generateDomainFacade, pascalCase, capitalize } from './templates/domain-facade.js';
+const VALID_TYPES = new Set(['pattern', 'anti-pattern', 'rule']);
+const VALID_SEVERITIES = new Set(['critical', 'warning', 'suggestion']);
+// ---------- Vault-only facade generator ----------
+/**
+ * Generate a domain facade for older agents that lack a Brain module.
+ * Uses vault.search() instead of brain.intelligentSearch() and
+ * vault.add() instead of brain.enrichAndCapture().
+ */
+export function generateVaultOnlyDomainFacade(agentId, domain) {
+    const facadeName = `${agentId}_${domain.replace(/-/g, '_')}`;
+    return `import { z } from 'zod';
+import type { FacadeConfig } from './types.js';
+import type { Vault } from '../vault/vault.js';
+
+export function create${pascalCase(domain)}Facade(vault: Vault): FacadeConfig {
+  return {
+    name: '${facadeName}',
+    description: '${capitalize(domain.replace(/-/g, ' '))} patterns, rules, and guidance.',
+    ops: [
+      {
+        name: 'get_patterns',
+        description: 'Get ${domain} patterns filtered by tags or severity.',
+        auth: 'read',
+        schema: z.object({
+          tags: z.array(z.string()).optional(),
+          severity: z.enum(['critical', 'warning', 'suggestion']).optional(),
+          type: z.enum(['pattern', 'anti-pattern', 'rule']).optional(),
+          limit: z.number().optional(),
+        }),
+        handler: async (params) => {
+          return vault.list({
+            domain: '${domain}',
+            severity: params.severity as string | undefined,
+            type: params.type as string | undefined,
+            tags: params.tags as string[] | undefined,
+            limit: (params.limit as number) ?? 20,
+          });
+        },
+      },
+      {
+        name: 'search',
+        description: 'Search ${domain} knowledge by query.',
+        auth: 'read',
+        schema: z.object({
+          query: z.string(),
+          limit: z.number().optional(),
+        }),
+        handler: async (params) => {
+          return vault.search(params.query as string, {
+            domain: '${domain}',
+            limit: (params.limit as number) ?? 10,
+          });
+        },
+      },
+      {
+        name: 'get_entry',
+        description: 'Get a specific ${domain} knowledge entry by ID.',
+        auth: 'read',
+        schema: z.object({ id: z.string() }),
+        handler: async (params) => {
+          const entry = vault.get(params.id as string);
+          if (!entry) return { error: 'Entry not found: ' + params.id };
+          return entry;
+        },
+      },
+      {
+        name: 'capture',
+        description: 'Capture a new ${domain} pattern, anti-pattern, or rule.',
+        auth: 'write',
+        schema: z.object({
+          id: z.string(),
+          type: z.enum(['pattern', 'anti-pattern', 'rule']),
+          title: z.string(),
+          severity: z.enum(['critical', 'warning', 'suggestion']),
+          description: z.string(),
+          context: z.string().optional(),
+          example: z.string().optional(),
+          counterExample: z.string().optional(),
+          why: z.string().optional(),
+          tags: z.array(z.string()),
+        }),
+        handler: async (params) => {
+          vault.add({
+            id: params.id as string,
+            type: params.type as 'pattern' | 'anti-pattern' | 'rule',
+            domain: '${domain}',
+            title: params.title as string,
+            severity: params.severity as 'critical' | 'warning' | 'suggestion',
+            description: params.description as string,
+            context: params.context as string | undefined,
+            example: params.example as string | undefined,
+            counterExample: params.counterExample as string | undefined,
+            why: params.why as string | undefined,
+            tags: params.tags as string[],
+          });
+          return { captured: params.id, domain: '${domain}' };
+        },
+      },
+      {
+        name: 'remove',
+        description: 'Remove a ${domain} knowledge entry by ID.',
+        auth: 'admin',
+        schema: z.object({ id: z.string() }),
+        handler: async (params) => {
+          const removed = vault.remove(params.id as string);
+          return { removed, id: params.id };
+        },
+      },
+    ],
+  };
+}
+`;
+}
+export async function installKnowledge(params) {
+    const { agentPath, bundlePath, generateFacades = true } = params;
+    const warnings = [];
+    const facadesGenerated = [];
+    const sourceFilesPatched = [];
+    // ── Step 1: Validate agent path ──────────────────────────────────
+    const pkgPath = join(agentPath, 'package.json');
+    if (!existsSync(pkgPath)) {
+        return fail(agentPath, '', 'No package.json found — is this an agent project?');
+    }
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    const pkgName = pkg.name ?? '';
+    if (!pkgName.endsWith('-mcp')) {
+        return fail(agentPath, pkgName, `package.json name "${pkgName}" does not end with -mcp`);
+    }
+    const agentId = pkgName.replace(/-mcp$/, '');
+    const dataDir = join(agentPath, 'src', 'intelligence', 'data');
+    if (!existsSync(dataDir)) {
+        return fail(agentPath, agentId, 'src/intelligence/data/ directory not found');
+    }
+    const hasBrain = existsSync(join(agentPath, 'src', 'brain'));
+    // ── Step 2: Read and validate bundles ────────────────────────────
+    const bundleFiles = collectBundleFiles(bundlePath);
+    if (bundleFiles.length === 0) {
+        return fail(agentPath, agentId, `No .json bundle files found at ${bundlePath}`);
+    }
+    const bundles = [];
+    const issues = [];
+    for (const file of bundleFiles) {
+        try {
+            const raw = readFileSync(file, 'utf-8');
+            const parsed = JSON.parse(raw);
+            const fileIssues = validateBundle(parsed, file);
+            if (fileIssues.length > 0) {
+                issues.push(...fileIssues);
+            }
+            else {
+                bundles.push({ file, bundle: parsed });
+            }
+        }
+        catch (err) {
+            issues.push(`${basename(file)}: invalid JSON — ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (bundles.length === 0) {
+        return fail(agentPath, agentId, `All bundles failed validation:\n${issues.join('\n')}`);
+    }
+    if (issues.length > 0) {
+        warnings.push(...issues);
+    }
+    // Determine which domains are new vs existing
+    const existingDataFiles = readdirSync(dataDir).filter((f) => f.endsWith('.json'));
+    const existingDomains = new Set(existingDataFiles.map((f) => f.replace(/\.json$/, '')));
+    const domainsAdded = [];
+    const domainsUpdated = [];
+    for (const { bundle } of bundles) {
+        if (existingDomains.has(bundle.domain)) {
+            domainsUpdated.push(bundle.domain);
+        }
+        else {
+            domainsAdded.push(bundle.domain);
+        }
+    }
+    // ── Step 3: Copy bundles ─────────────────────────────────────────
+    for (const { file, bundle } of bundles) {
+        const dest = join(dataDir, `${bundle.domain}.json`);
+        copyFileSync(file, dest);
+    }
+    // Also copy to dist/intelligence/data/ if dist exists
+    const distDataDir = join(agentPath, 'dist', 'intelligence', 'data');
+    if (existsSync(join(agentPath, 'dist'))) {
+        mkdirSync(distDataDir, { recursive: true });
+        for (const { file, bundle } of bundles) {
+            copyFileSync(file, join(distDataDir, `${bundle.domain}.json`));
+        }
+    }
+    // ── Step 4: Generate facades for new domains ─────────────────────
+    if (generateFacades && domainsAdded.length > 0) {
+        const facadesDir = join(agentPath, 'src', 'facades');
+        for (const domain of domainsAdded) {
+            const facadePath = join(facadesDir, `${domain}.facade.ts`);
+            // Skip if facade already exists (idempotent)
+            if (existsSync(facadePath)) {
+                warnings.push(`Facade ${domain}.facade.ts already exists — skipped`);
+                continue;
+            }
+            const facadeCode = hasBrain
+                ? generateDomainFacade(agentId, domain)
+                : generateVaultOnlyDomainFacade(agentId, domain);
+            writeFileSync(facadePath, facadeCode, 'utf-8');
+            facadesGenerated.push(`${domain}.facade.ts`);
+        }
+        // ── Step 5: Patch src/index.ts ───────────────────────────────────
+        const indexPath = join(agentPath, 'src', 'index.ts');
+        if (existsSync(indexPath)) {
+            const patched = patchIndexTs(readFileSync(indexPath, 'utf-8'), domainsAdded, hasBrain);
+            if (patched !== null) {
+                writeFileSync(indexPath, patched, 'utf-8');
+                sourceFilesPatched.push('src/index.ts');
+            }
+            else {
+                warnings.push('Could not patch src/index.ts — anchor patterns not found. Manual patching needed.');
+            }
+        }
+        // ── Step 6: Patch src/activation/claude-md-content.ts ────────────
+        const claudeMdPath = join(agentPath, 'src', 'activation', 'claude-md-content.ts');
+        if (existsSync(claudeMdPath)) {
+            const patched = patchClaudeMdContent(readFileSync(claudeMdPath, 'utf-8'), agentId, domainsAdded);
+            if (patched !== null) {
+                writeFileSync(claudeMdPath, patched, 'utf-8');
+                sourceFilesPatched.push('src/activation/claude-md-content.ts');
+            }
+            else {
+                warnings.push('Could not patch claude-md-content.ts — anchor not found. Manual patching needed.');
+            }
+        }
+    }
+    // ── Step 7: Build ────────────────────────────────────────────────
+    let buildOutput = '';
+    try {
+        // Using execFileSync with npx to avoid shell injection — command is hardcoded
+        buildOutput = execFileSync('npm', ['run', 'build'], {
+            cwd: agentPath,
+            encoding: 'utf-8',
+            timeout: 60_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch (err) {
+        const stderr = err.stderr ?? '';
+        buildOutput = `Build failed: ${stderr}`;
+        warnings.push('Build failed — check buildOutput for details');
+    }
+    // ── Step 8: Return result ────────────────────────────────────────
+    const entriesTotal = bundles.reduce((sum, { bundle }) => sum + bundle.entries.length, 0);
+    const summaryParts = [
+        `Installed ${bundles.length} bundle(s) with ${entriesTotal} entries into ${agentId}`,
+    ];
+    if (domainsAdded.length > 0)
+        summaryParts.push(`New domains: ${domainsAdded.join(', ')}`);
+    if (domainsUpdated.length > 0)
+        summaryParts.push(`Updated domains: ${domainsUpdated.join(', ')}`);
+    if (facadesGenerated.length > 0)
+        summaryParts.push(`Generated ${facadesGenerated.length} facade(s)`);
+    if (sourceFilesPatched.length > 0)
+        summaryParts.push(`Patched: ${sourceFilesPatched.join(', ')}`);
+    if (warnings.length > 0)
+        summaryParts.push(`${warnings.length} warning(s)`);
+    return {
+        success: !warnings.some((w) => w.includes('Build failed')),
+        agentPath,
+        agentId,
+        bundlesInstalled: bundles.length,
+        entriesTotal,
+        domainsAdded,
+        domainsUpdated,
+        facadesGenerated,
+        sourceFilesPatched,
+        buildOutput,
+        warnings,
+        summary: summaryParts.join('. ') + '.',
+    };
+}
+// ---------- Helpers ----------
+function fail(agentPath, agentId, message) {
+    return {
+        success: false,
+        agentPath,
+        agentId,
+        bundlesInstalled: 0,
+        entriesTotal: 0,
+        domainsAdded: [],
+        domainsUpdated: [],
+        facadesGenerated: [],
+        sourceFilesPatched: [],
+        buildOutput: '',
+        warnings: [message],
+        summary: message,
+    };
+}
+function collectBundleFiles(bundlePath) {
+    if (bundlePath.endsWith('.json')) {
+        return existsSync(bundlePath) ? [bundlePath] : [];
+    }
+    if (!existsSync(bundlePath))
+        return [];
+    return readdirSync(bundlePath)
+        .filter((f) => f.endsWith('.json'))
+        .map((f) => join(bundlePath, f));
+}
+function validateBundle(bundle, file) {
+    const issues = [];
+    const name = basename(file);
+    if (!bundle.domain || typeof bundle.domain !== 'string') {
+        issues.push(`${name}: missing or invalid "domain"`);
+    }
+    if (!bundle.version || typeof bundle.version !== 'string') {
+        issues.push(`${name}: missing or invalid "version"`);
+    }
+    if (!Array.isArray(bundle.entries)) {
+        issues.push(`${name}: "entries" must be an array`);
+        return issues; // can't validate entries
+    }
+    for (let i = 0; i < bundle.entries.length; i++) {
+        const entry = bundle.entries[i];
+        const prefix = `${name}[${i}]`;
+        if (!entry.id)
+            issues.push(`${prefix}: missing "id"`);
+        if (!VALID_TYPES.has(entry.type))
+            issues.push(`${prefix}: invalid type "${entry.type}"`);
+        if (!entry.domain)
+            issues.push(`${prefix}: missing "domain"`);
+        if (!entry.title)
+            issues.push(`${prefix}: missing "title"`);
+        if (!VALID_SEVERITIES.has(entry.severity))
+            issues.push(`${prefix}: invalid severity "${entry.severity}"`);
+        if (!entry.description)
+            issues.push(`${prefix}: missing "description"`);
+        if (!Array.isArray(entry.tags))
+            issues.push(`${prefix}: "tags" must be an array`);
+    }
+    return issues;
+}
+// ---------- Source file patching ----------
+/**
+ * Patch the agent's src/index.ts to add imports and facade registrations
+ * for new domains.
+ *
+ * Anchor patterns:
+ * - Import: insert before `import { createCoreFacade }`
+ * - Facade array: insert before `createCoreFacade(`
+ */
+export function patchIndexTs(source, newDomains, hasBrain) {
+    // Filter out domains whose imports already exist (idempotent)
+    const domainsToImport = newDomains.filter((d) => {
+        const fn = `create${pascalCase(d)}Facade`;
+        return !source.includes(`import { ${fn} }`);
+    });
+    // Filter out domains whose facade calls already exist
+    const domainsToRegister = newDomains.filter((d) => {
+        const fn = `create${pascalCase(d)}Facade(`;
+        return !source.includes(fn);
+    });
+    // Nothing to patch
+    if (domainsToImport.length === 0 && domainsToRegister.length === 0) {
+        return source;
+    }
+    let patched = source;
+    // ── Insert imports ──
+    if (domainsToImport.length > 0) {
+        const importAnchor = /^(import \{ createCoreFacade \}.*$)/m;
+        if (!importAnchor.test(patched))
+            return null;
+        const newImports = domainsToImport
+            .map((d) => {
+            const fn = `create${pascalCase(d)}Facade`;
+            return `import { ${fn} } from './facades/${d}.facade.js';`;
+        })
+            .join('\n');
+        patched = patched.replace(importAnchor, `${newImports}\n$1`);
+    }
+    // ── Insert facade creations ──
+    if (domainsToRegister.length > 0) {
+        const facadeAnchor = /^(\s+createCoreFacade\()/m;
+        if (!facadeAnchor.test(patched))
+            return null;
+        const newCreations = domainsToRegister
+            .map((d) => {
+            const fn = `create${pascalCase(d)}Facade`;
+            const args = hasBrain ? 'vault, brain' : 'vault';
+            return `    ${fn}(${args}),`;
+        })
+            .join('\n');
+        patched = patched.replace(facadeAnchor, `${newCreations}\n$1`);
+    }
+    return patched;
+}
+/**
+ * Patch the agent's src/activation/claude-md-content.ts to add
+ * facade table rows for new domains.
+ *
+ * Primary anchor: line containing `| Memory search |` (newer agents)
+ * Fallback anchor: line containing `## Intent Detection` (older agents without memory/brain rows)
+ */
+export function patchClaudeMdContent(source, agentId, newDomains) {
+    const facadeId = agentId.replace(/-/g, '_');
+    const bt = '`';
+    // Filter out domains whose rows already exist (idempotent)
+    const domainsToAdd = newDomains.filter((d) => {
+        const toolName = `${facadeId}_${d.replace(/-/g, '_')}`;
+        return !source.includes(`${toolName}`);
+    });
+    if (domainsToAdd.length === 0)
+        return source;
+    // Try primary anchor first, then fallback for older agents
+    let anchorIdx = source.indexOf("'| Memory search |");
+    if (anchorIdx === -1) {
+        // Older agents: insert before the empty line preceding ## Intent Detection
+        anchorIdx = source.indexOf("'## Intent Detection'");
+        if (anchorIdx === -1)
+            return null;
+        // Back up to include the preceding empty string line ('',)
+        const emptyLineIdx = source.lastIndexOf("'',", anchorIdx);
+        if (emptyLineIdx !== -1 && anchorIdx - emptyLineIdx < 20) {
+            // Find the start of that line (the indentation)
+            const lineStart = source.lastIndexOf('\n', emptyLineIdx);
+            anchorIdx = lineStart === -1 ? emptyLineIdx : lineStart + 1;
+        }
+    }
+    const newRows = domainsToAdd.flatMap((d) => {
+        const toolName = `${facadeId}_${d.replace(/-/g, '_')}`;
+        return [
+            `    '| ${d} patterns | ${bt}${toolName}${bt} | ${bt}get_patterns${bt} |',`,
+            `    '| Search ${d} | ${bt}${toolName}${bt} | ${bt}search${bt} |',`,
+            `    '| Capture ${d} | ${bt}${toolName}${bt} | ${bt}capture${bt} |',`,
+        ];
+    });
+    return source.slice(0, anchorIdx) + newRows.join('\n') + '\n' + source.slice(anchorIdx);
+}
+//# sourceMappingURL=knowledge-installer.js.map

package/dist/knowledge-installer.js.map

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

package/dist/scaffolder.d.ts

@@ -0,0 +1,13 @@
+import type { AgentConfig, ScaffoldResult, ScaffoldPreview, AgentInfo } from './types.js';
+/**
+ * Preview what scaffold will create without writing anything.
+ */
+export declare function previewScaffold(config: AgentConfig): ScaffoldPreview;
+/**
+ * Scaffold a complete MCP agent project.
+ */
+export declare function scaffold(config: AgentConfig): ScaffoldResult;
+/**
+ * List agents in a directory.
+ */
+export declare function listAgents(parentDir: string): AgentInfo[];