specforge-mcp 0.1.1 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specforge-mcp",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "SpecForge — MCP Server for Spec Driven Development. Manages specs, estimations, reverse engineering, and auto-learning across any language/framework.",
   "type": "module",
   "main": "dist/index.js",
@@ -14,6 +14,25 @@
   "engines": {
     "node": ">=22.0.0"
   },
+  "packageManager": "pnpm@10.28.2",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && node -e \"import('node:fs').then(({cpSync})=>cpSync('src/config','dist/config',{recursive:true}))\"",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist",
+    "lint": "eslint src/ tests/ --max-warnings 0",
+    "lint:fix": "eslint src/ tests/ --fix --max-warnings 0",
+    "format": "prettier --write 'src/**/*.ts' 'tests/**/*.test.ts'",
+    "format:check": "prettier --check 'src/**/*.ts' 'tests/**/*.test.ts'",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "check": "pnpm typecheck && pnpm lint && pnpm format:check",
+    "setup:protection": "bash scripts/setup-branch-protection.sh",
+    "prepare": "husky || true",
+    "prepublishOnly": "pnpm build"
+  },
   "lint-staged": {
     "src/**/*.ts": [
       "eslint --fix --max-warnings 0",
@@ -48,6 +67,11 @@
     "@eslint/js": "^10.0.1",
     "@secretlint/secretlint-rule-no-homedir": "^11.3.1",
     "@secretlint/secretlint-rule-preset-recommend": "^11.3.1",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.6",
+    "@semantic-release/npm": "^13.1.4",
+    "@semantic-release/release-notes-generator": "^14.1.0",
     "@types/node": "^25.3.0",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^10.0.2",
@@ -57,25 +81,10 @@
     "lint-staged": "^16.2.7",
     "prettier": "^3.8.1",
     "secretlint": "^11.3.1",
+    "semantic-release": "^25.0.3",
     "tsc-alias": "^1.8.16",
     "typescript": "^5.7.0",
     "typescript-eslint": "^8.56.1",
     "vitest": "^4.0.18"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && node -e \"import('node:fs').then(({cpSync})=>cpSync('src/config','dist/config',{recursive:true}))\"",
-    "dev": "tsc --watch",
-    "start": "node dist/index.js",
-    "clean": "rm -rf dist",
-    "lint": "eslint src/ tests/ --max-warnings 0",
-    "lint:fix": "eslint src/ tests/ --fix --max-warnings 0",
-    "format": "prettier --write 'src/**/*.ts' 'tests/**/*.test.ts'",
-    "format:check": "prettier --check 'src/**/*.ts' 'tests/**/*.test.ts'",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "check": "pnpm typecheck && pnpm lint && pnpm format:check",
-    "setup:protection": "bash scripts/setup-branch-protection.sh"
   }
-}
+}

package/src/config/version.ts

@@ -0,0 +1,11 @@
+// version.ts — reads from package.json at runtime; updated automatically by semantic-release
+
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const pkgPath = join(dirname(fileURLToPath(import.meta.url)), '../../package.json');
+const raw: unknown = JSON.parse(readFileSync(pkgPath, 'utf8'));
+const { version } = raw as { version: string };
+
+export const SPECFORGE_VERSION = version;

package/dist/engine/agent-generator.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=agent-generator.test.d.ts.map

package/dist/engine/agent-generator.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-generator.test.d.ts","sourceRoot":"","sources":["../../src/engine/agent-generator.test.ts"],"names":[],"mappings":""}

package/dist/engine/agent-generator.test.js

@@ -1,556 +0,0 @@
-// SpecForge — Agent Generator Engine Tests
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-vi.mock('node:fs/promises', () => ({
-    readFile: vi.fn(),
-}));
-import { readFile } from 'node:fs/promises';
-import { generateSubAgent, generateAgentSystem, getFrameworkConfig } from './agent-generator.js';
-const mockedReadFile = vi.mocked(readFile);
-// === Helper factories ===
-function makeKnowledge(overrides = {}) {
-    return {
-        projectId: 'proj-1',
-        projectPath: '/home/user/my-project',
-        locale: 'en',
-        experienceLevel: 'intermediate',
-        language: 'typescript',
-        framework: 'express',
-        packageManager: 'npm',
-        buildCommand: 'npm run build',
-        testCommand: 'npm test',
-        stack: ['typescript', 'express'],
-        database: 'postgresql',
-        architecture: {
-            primary: 'layered',
-            secondary: [],
-            layers: [
-                { name: 'API', directories: ['src/routes'], responsibility: 'HTTP', dependsOn: ['Service'], neverDependsOn: [] },
-                { name: 'Service', directories: ['src/services'], responsibility: 'Logic', dependsOn: [], neverDependsOn: [] },
-            ],
-            boundaries: [],
-            communicationPatterns: ['REST'],
-            deploymentUnits: ['docker'],
-        },
-        apps: [],
-        conventions: {},
-        layers: ['routes', 'services'],
-        environments: ['development'],
-        apiContracts: [],
-        specLocation: 'docs/sdd/specs',
-        envSetup: {
-            projectId: 'proj-1',
-            variables: [],
-            missing: [],
-            security: { gitignoreHasEnv: true, noSecretsInCode: true, noEnvInGit: true, noSecretsInLogs: true, usesSecretManager: false, issues: [] },
-            setupSteps: [],
-        },
-        linting: {
-            projectId: 'proj-1',
-            language: 'typescript',
-            detectedLinters: [],
-            missingRecommended: [],
-            rulesConflicts: [],
-            customRulesFromProject: [],
-            maturityScore: 0.5,
-        },
-        availableMcps: [
-            { name: 'sdd-mcp', command: 'npx sdd-mcp', tools: ['sdd_init_project', 'sdd_create_spec'], relevantFor: ['sdd'] },
-        ],
-        docsRegistry: {},
-        qualityProfile: {
-            enabledCategories: ['solid'],
-            customRules: [],
-            principles: ['SOLID', 'DRY'],
-            strictness: 'standard',
-        },
-        lastAnalyzed: '2025-01-01T00:00:00Z',
-        ...overrides,
-    };
-}
-function makePlatformsConfig() {
-    return {
-        platforms: {},
-        subAgentFrameworks: {
-            'claude-agent-sdk': {
-                name: 'Anthropic Agent SDK',
-                languages: ['typescript', 'python'],
-                docsUrl: 'https://docs.anthropic.com/en/docs/agents',
-                supportsHandoffs: true,
-                supportsMcp: true,
-            },
-            crewai: {
-                name: 'CrewAI',
-                languages: ['python'],
-                docsUrl: 'https://docs.crewai.com',
-                supportsHandoffs: true,
-                supportsMcp: false,
-            },
-            langgraph: {
-                name: 'LangGraph',
-                languages: ['python'],
-                docsUrl: 'https://langchain-ai.github.io/langgraph',
-                supportsHandoffs: false,
-                supportsMcp: true,
-            },
-            autogen: {
-                name: 'AutoGen',
-                languages: ['python'],
-                docsUrl: 'https://microsoft.github.io/autogen',
-                supportsHandoffs: false,
-                supportsMcp: false,
-            },
-            mastra: {
-                name: 'Mastra',
-                languages: ['typescript'],
-                docsUrl: 'https://mastra.ai/docs',
-                supportsHandoffs: false,
-                supportsMcp: true,
-            },
-            'vercel-ai-sdk': {
-                name: 'Vercel AI SDK',
-                languages: ['typescript'],
-                docsUrl: 'https://sdk.vercel.ai/docs',
-                supportsHandoffs: false,
-                supportsMcp: false,
-            },
-        },
-    };
-}
-// === Setup ===
-beforeEach(() => {
-    vi.resetAllMocks();
-    // Reset the internal cache by reloading — we'll configure mock per test
-    // Clear the module-level cache by forcing the config to reload via rejecting once
-    // Actually, the module has a `frameworksCache` variable. Since we can't directly
-    // reset it, we need to clear it via side-effects.
-    // The cache is set once and sticks. Let's mock readFile to always succeed.
-});
-// Helper to set up readFile to return our config
-function setupConfigMock() {
-    mockedReadFile.mockResolvedValue(JSON.stringify(makePlatformsConfig()));
-}
-// === Tests ===
-describe('getFrameworkConfig', () => {
-    it('returns config from loaded file', async () => {
-        setupConfigMock();
-        const config = await getFrameworkConfig('claude-agent-sdk');
-        // First call loads from file — but cache may exist from previous test
-        // The important thing is the result
-        expect(config.name).toBe('Anthropic Agent SDK');
-        expect(config.languages).toContain('typescript');
-        expect(config.supportsHandoffs).toBe(true);
-        expect(config.supportsMcp).toBe(true);
-    });
-    it('returns fallback for unknown framework', async () => {
-        setupConfigMock();
-        const config = await getFrameworkConfig('unknown-framework');
-        expect(config.name).toBe('unknown-framework');
-        expect(config.languages).toEqual(['typescript']);
-        expect(config.docsUrl).toBe('');
-        expect(config.supportsHandoffs).toBe(false);
-        expect(config.supportsMcp).toBe(false);
-    });
-    it('uses cache on second call', async () => {
-        setupConfigMock();
-        await getFrameworkConfig('claude-agent-sdk');
-        await getFrameworkConfig('crewai');
-        // readFile should only have been called at most once (due to caching)
-        // If cache was already warm from a previous test, it might be 0
-        expect(mockedReadFile.mock.calls.length).toBeLessThanOrEqual(1);
-    });
-});
-describe('generateSubAgent', () => {
-    beforeEach(() => {
-        setupConfigMock();
-    });
-    describe('claude-agent-sdk framework', () => {
-        it('generates agent files for claude-agent-sdk', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('claude-agent-sdk', 'analyzer', 'code-analyst', ['code-analysis', 'architecture-review'], knowledge, ['sdd_audit_code'], 'You are a code analyzer.');
-            expect(result.framework).toBe('claude-agent-sdk');
-            expect(result.files).toHaveLength(1);
-            expect(result.files[0].path).toContain('agents/analyzer.ts');
-            expect(result.files[0].content).toContain('Anthropic');
-            expect(result.files[0].content).toContain('analyzer');
-            expect(result.files[0].content).toContain('code-analyst');
-            expect(result.agentDefinition.name).toBe('analyzer');
-            expect(result.agentDefinition.role).toBe('code-analyst');
-            expect(result.agentDefinition.tools).toContain('sdd_audit_code');
-            expect(result.agentDefinition.systemPrompt).toBe('You are a code analyzer.');
-            expect(result.installInstructions).toContain('npm install @anthropic-ai/sdk');
-        });
-        it('uses custom system prompt when provided', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('claude-agent-sdk', 'test-agent', 'orchestrator', ['task-routing'], knowledge, [], 'Custom prompt here.');
-            expect(result.agentDefinition.systemPrompt).toBe('Custom prompt here.');
-        });
-        it('builds system prompt when not provided', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('claude-agent-sdk', 'test-agent', 'code-analyst', ['code-analysis'], knowledge);
-            expect(result.agentDefinition.systemPrompt).toContain('test-agent');
-            expect(result.agentDefinition.systemPrompt).toContain('code-analyst');
-            expect(result.agentDefinition.systemPrompt).toContain('code-analysis');
-            expect(result.agentDefinition.systemPrompt).toContain('typescript');
-            expect(result.agentDefinition.systemPrompt).toContain('express');
-            expect(result.agentDefinition.systemPrompt).toContain('layered');
-            expect(result.agentDefinition.systemPrompt).toContain('postgresql');
-            expect(result.agentDefinition.systemPrompt).toContain('SOLID');
-        });
-        it('omits framework in prompt when null', async () => {
-            const knowledge = makeKnowledge({ framework: null });
-            const result = await generateSubAgent('claude-agent-sdk', 'test-agent', 'code-analyst', ['code-analysis'], knowledge);
-            expect(result.agentDefinition.systemPrompt).not.toContain('Framework:');
-        });
-        it('omits quality principles when empty', async () => {
-            const knowledge = makeKnowledge({
-                qualityProfile: {
-                    enabledCategories: [],
-                    customRules: [],
-                    principles: [],
-                    strictness: 'standard',
-                },
-            });
-            const result = await generateSubAgent('claude-agent-sdk', 'test-agent', 'code-analyst', ['code-analysis'], knowledge);
-            expect(result.agentDefinition.systemPrompt).not.toContain('Quality Principles');
-        });
-        it('infers tools when none provided', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('claude-agent-sdk', 'test-agent', 'code-analyst', ['code-analysis'], knowledge);
-            expect(result.agentDefinition.tools).toContain('read_file');
-            expect(result.agentDefinition.tools).toContain('write_file');
-            expect(result.agentDefinition.tools).toContain('list_directory');
-            expect(result.agentDefinition.tools).toContain('sdd_audit_code');
-            // MCP tools
-            expect(result.agentDefinition.tools).toContain('sdd_init_project');
-            expect(result.agentDefinition.tools).toContain('sdd_create_spec');
-        });
-        it('deduplicates inferred tools', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('claude-agent-sdk', 'test-agent', 'code-analyst', ['code-analysis'], knowledge);
-            const unique = new Set(result.agentDefinition.tools);
-            expect(unique.size).toBe(result.agentDefinition.tools.length);
-        });
-    });
-    describe('crewai framework', () => {
-        it('generates CrewAI files', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('crewai', 'analyst', 'code-analyst', ['code-analysis'], knowledge, ['sdd_audit_code']);
-            expect(result.framework).toBe('crewai');
-            expect(result.files).toHaveLength(1);
-            expect(result.files[0].path).toContain('agents/analyst_agent.py');
-            expect(result.files[0].content).toContain('from crewai import Agent');
-            expect(result.files[0].content).toContain('analyst_agent');
-            expect(result.installInstructions).toContain('pip install crewai');
-        });
-        it('includes allow_delegation based on handoff conditions', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('crewai', 'coordinator', 'orchestrator', ['task-routing'], knowledge);
-            // orchestrator has handoff conditions
-            expect(result.files[0].content).toContain('allow_delegation=True');
-        });
-        it('sets allow_delegation=False when no handoff conditions', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('crewai', 'worker', 'documentation', ['doc-writing'], knowledge);
-            // documentation role has handoffConditions=[] which is truthy in JS
-            expect(result.files[0].content).toContain('allow_delegation=True');
-        });
-    });
-    describe('langgraph framework', () => {
-        it('generates LangGraph files', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('langgraph', 'processor', 'code-implementor', ['code-generation'], knowledge);
-            expect(result.framework).toBe('langgraph');
-            expect(result.files).toHaveLength(1);
-            expect(result.files[0].path).toContain('agents/processor_graph.py');
-            expect(result.files[0].content).toContain('from langgraph.graph import StateGraph');
-            expect(result.files[0].content).toContain('ProcessorState');
-            expect(result.files[0].content).toContain('processor_node');
-            expect(result.installInstructions).toContain('pip install langgraph');
-        });
-    });
-    describe('autogen framework', () => {
-        it('generates AutoGen files', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('autogen', 'reviewer', 'code-reviewer', ['code-review'], knowledge);
-            expect(result.framework).toBe('autogen');
-            expect(result.files).toHaveLength(1);
-            expect(result.files[0].path).toContain('agents/reviewer_autogen.py');
-            expect(result.files[0].content).toContain('from autogen import AssistantAgent');
-            expect(result.files[0].content).toContain('reviewer_agent');
-            expect(result.installInstructions).toContain('pip install autogen-agentchat');
-        });
-    });
-    describe('mastra framework', () => {
-        it('generates Mastra files', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('mastra', 'test-agent', 'testing', ['test-generation'], knowledge);
-            expect(result.framework).toBe('mastra');
-            expect(result.files).toHaveLength(1);
-            expect(result.files[0].path).toContain('agents/test-agent.ts');
-            expect(result.files[0].content).toContain('from "@mastra/core"');
-            expect(result.files[0].content).toContain('testAgentAgent');
-            expect(result.installInstructions).toContain('npm install @mastra/core');
-        });
-    });
-    describe('vercel-ai-sdk framework', () => {
-        it('generates Vercel AI SDK files', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('vercel-ai-sdk', 'helper', 'documentation', ['doc-writing'], knowledge);
-            expect(result.framework).toBe('vercel-ai-sdk');
-            expect(result.files).toHaveLength(1);
-            expect(result.files[0].path).toContain('agents/helper.ts');
-            expect(result.files[0].content).toContain('from "ai"');
-            expect(result.files[0].content).toContain('runHelper');
-            expect(result.installInstructions).toContain('npm install ai @ai-sdk/anthropic');
-        });
-    });
-    describe('custom/generic framework', () => {
-        it('generates generic JSON files for custom framework', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('custom', 'my agent', 'orchestrator', ['task-routing'], knowledge);
-            expect(result.framework).toBe('custom');
-            expect(result.files).toHaveLength(1);
-            expect(result.files[0].path).toContain('agents/my-agent.json');
-            expect(result.files[0].format).toBe('json');
-            const parsed = JSON.parse(result.files[0].content);
-            expect(parsed.name).toBe('my agent');
-            expect(parsed.role).toBe('orchestrator');
-        });
-    });
-    describe('inferModel', () => {
-        it('returns sonnet for complex roles', async () => {
-            const knowledge = makeKnowledge();
-            for (const role of ['orchestrator', 'code-analyst']) {
-                const result = await generateSubAgent('custom', 'test', role, [], knowledge);
-                expect(result.agentDefinition.model).toContain('claude-sonnet');
-            }
-        });
-        it('returns sonnet for complex capabilities', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('custom', 'test', 'general', ['architecture-review'], knowledge);
-            expect(result.agentDefinition.model).toContain('claude-sonnet');
-        });
-        it('returns sonnet for simple roles too (current implementation)', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('custom', 'test', 'simple-worker', ['simple-task'], knowledge);
-            expect(result.agentDefinition.model).toContain('claude-sonnet');
-        });
-    });
-    describe('inferMaxTurns', () => {
-        it('returns correct turns for known roles', async () => {
-            const knowledge = makeKnowledge();
-            const roleTurns = [
-                { role: 'orchestrator', expected: 20 },
-                { role: 'code-analyst', expected: 10 },
-                { role: 'code-implementor', expected: 30 },
-                { role: 'code-reviewer', expected: 15 },
-                { role: 'documentation', expected: 10 },
-                { role: 'testing', expected: 15 },
-            ];
-            for (const { role, expected } of roleTurns) {
-                const result = await generateSubAgent('custom', 'test', role, [], knowledge);
-                expect(result.agentDefinition.maxTurns).toBe(expected);
-            }
-        });
-        it('returns default 10 for unknown role', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('custom', 'test', 'unknown-role', [], knowledge);
-            expect(result.agentDefinition.maxTurns).toBe(10);
-        });
-    });
-    describe('inferHandoffConditions', () => {
-        it('returns conditions for orchestrator', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('custom', 'test', 'orchestrator', [], knowledge);
-            expect(result.agentDefinition.handoffConditions.length).toBe(3);
-        });
-        it('returns conditions for code-analyst', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('custom', 'test', 'code-analyst', [], knowledge);
-            expect(result.agentDefinition.handoffConditions.length).toBe(2);
-        });
-        it('returns conditions for code-implementor', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('custom', 'test', 'code-implementor', [], knowledge);
-            expect(result.agentDefinition.handoffConditions.length).toBe(2);
-        });
-        it('returns conditions for code-reviewer', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('custom', 'test', 'code-reviewer', [], knowledge);
-            expect(result.agentDefinition.handoffConditions.length).toBe(2);
-        });
-        it('returns empty array for unknown role', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('custom', 'test', 'unknown', [], knowledge);
-            expect(result.agentDefinition.handoffConditions).toEqual([]);
-        });
-    });
-    describe('inferTools for different roles', () => {
-        it('includes orchestrator tools', async () => {
-            const knowledge = makeKnowledge({ availableMcps: [] });
-            const result = await generateSubAgent('custom', 'test', 'orchestrator', [], knowledge);
-            expect(result.agentDefinition.tools).toContain('sdd_init_project');
-            expect(result.agentDefinition.tools).toContain('sdd_orchestrate');
-        });
-        it('includes code-implementor tools', async () => {
-            const knowledge = makeKnowledge({ availableMcps: [] });
-            const result = await generateSubAgent('custom', 'test', 'code-implementor', [], knowledge);
-            expect(result.agentDefinition.tools).toContain('bash');
-            expect(result.agentDefinition.tools).toContain('sdd_validate_spec');
-        });
-        it('includes documentation tools', async () => {
-            const knowledge = makeKnowledge({ availableMcps: [] });
-            const result = await generateSubAgent('custom', 'test', 'documentation', [], knowledge);
-            expect(result.agentDefinition.tools).toContain('sdd_generate_docs');
-        });
-        it('includes testing tools', async () => {
-            const knowledge = makeKnowledge({ availableMcps: [] });
-            const result = await generateSubAgent('custom', 'test', 'testing', [], knowledge);
-            expect(result.agentDefinition.tools).toContain('sdd_generate_test_plan');
-            expect(result.agentDefinition.tools).toContain('bash');
-        });
-        it('includes code-reviewer tools', async () => {
-            const knowledge = makeKnowledge({ availableMcps: [] });
-            const result = await generateSubAgent('custom', 'test', 'code-reviewer', [], knowledge);
-            expect(result.agentDefinition.tools).toContain('sdd_audit_code');
-            expect(result.agentDefinition.tools).toContain('sdd_detect_drift');
-        });
-        it('returns only base tools for unknown role', async () => {
-            const knowledge = makeKnowledge({ availableMcps: [] });
-            const result = await generateSubAgent('custom', 'test', 'unknown-role', [], knowledge);
-            expect(result.agentDefinition.tools).toEqual(['read_file', 'write_file', 'list_directory']);
-        });
-    });
-    describe('install instructions', () => {
-        it('includes handoff message when framework supports it', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('claude-agent-sdk', 'test', 'orchestrator', [], knowledge);
-            expect(result.installInstructions).toContain('handoffs');
-        });
-        it('includes MCP message when framework supports it', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('claude-agent-sdk', 'test', 'orchestrator', [], knowledge);
-            expect(result.installInstructions).toContain('MCP tools');
-        });
-        it('omits handoff message when not supported', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('autogen', 'test', 'orchestrator', [], knowledge);
-            expect(result.installInstructions).not.toContain('handoffs');
-        });
-        it('omits MCP message when not supported', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('autogen', 'test', 'orchestrator', [], knowledge);
-            expect(result.installInstructions).not.toContain('MCP tools');
-        });
-        it('includes generated files list', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('claude-agent-sdk', 'test', 'orchestrator', [], knowledge);
-            expect(result.installInstructions).toContain('Generated files:');
-            expect(result.installInstructions).toContain('agents/test.ts');
-        });
-        it('omits install command for custom framework', async () => {
-            const knowledge = makeKnowledge();
-            const result = await generateSubAgent('custom', 'test', 'orchestrator', [], knowledge);
-            // No specific install command for custom
-            expect(result.installInstructions).not.toContain('npm install');
-            expect(result.installInstructions).not.toContain('pip install');
-        });
-    });
-});
-describe('generateAgentSystem', () => {
-    beforeEach(() => {
-        setupConfigMock();
-    });
-    it('generates a full multi-agent system with 4 agents', async () => {
-        const knowledge = makeKnowledge();
-        const agents = await generateAgentSystem('claude-agent-sdk', knowledge);
-        expect(agents).toHaveLength(4);
-        expect(agents[0].agentDefinition.name).toBe('coordinator');
-        expect(agents[0].agentDefinition.role).toBe('orchestrator');
-        expect(agents[1].agentDefinition.name).toBe('analyst');
-        expect(agents[1].agentDefinition.role).toBe('code-analyst');
-        expect(agents[2].agentDefinition.name).toBe('implementor');
-        expect(agents[2].agentDefinition.role).toBe('code-implementor');
-        expect(agents[3].agentDefinition.name).toBe('reviewer');
-        expect(agents[3].agentDefinition.role).toBe('code-reviewer');
-    });
-    it('coordinator has a custom system prompt', async () => {
-        const knowledge = makeKnowledge();
-        const agents = await generateAgentSystem('claude-agent-sdk', knowledge);
-        const coordinator = agents[0];
-        expect(coordinator.agentDefinition.systemPrompt).toContain('coordinator agent');
-        expect(coordinator.agentDefinition.systemPrompt).toContain('SDD workflow');
-        expect(coordinator.agentDefinition.systemPrompt).toContain('typescript');
-        expect(coordinator.agentDefinition.systemPrompt).toContain('express');
-        expect(coordinator.agentDefinition.systemPrompt).toContain('layered');
-        expect(coordinator.agentDefinition.systemPrompt).toContain('docs/sdd/specs');
-    });
-    it('coordinator prompt handles null framework', async () => {
-        const knowledge = makeKnowledge({ framework: null });
-        const agents = await generateAgentSystem('claude-agent-sdk', knowledge);
-        expect(agents[0].agentDefinition.systemPrompt).toContain('Framework: none');
-    });
-    it('each agent has specific tools', async () => {
-        const knowledge = makeKnowledge();
-        const agents = await generateAgentSystem('claude-agent-sdk', knowledge);
-        expect(agents[0].agentDefinition.tools).toContain('sdd_orchestrate');
-        expect(agents[1].agentDefinition.tools).toContain('sdd_audit_code');
-        expect(agents[2].agentDefinition.tools).toContain('sdd_validate_spec');
-        expect(agents[3].agentDefinition.tools).toContain('sdd_generate_checklist');
-    });
-    it('works with crewai framework', async () => {
-        const knowledge = makeKnowledge();
-        const agents = await generateAgentSystem('crewai', knowledge);
-        expect(agents).toHaveLength(4);
-        for (const agent of agents) {
-            expect(agent.framework).toBe('crewai');
-            expect(agent.files[0].path).toContain('.py');
-        }
-    });
-});
-describe('loadFrameworks error handling', () => {
-    it('returns fallback config when file read fails', async () => {
-        // We need to force a fresh load. Since the cache is module-level,
-        // and we already loaded successfully, the cache is already warm.
-        // This test verifies the getFrameworkConfig fallback for unknown frameworks.
-        const config = await getFrameworkConfig('totally-unknown');
-        expect(config.name).toBe('totally-unknown');
-        expect(config.languages).toEqual(['typescript']);
-    });
-});
-describe('escapeTemplateLiteral', () => {
-    it('escapes backticks and template expressions in generated code', async () => {
-        setupConfigMock();
-        const knowledge = makeKnowledge();
-        const result = await generateSubAgent('claude-agent-sdk', 'test-agent', 'code-analyst', ['code-analysis'], knowledge, [], 'Use `code` and ${expression} in prompt');
-        expect(result.files[0].content).toContain('\\`code\\`');
-        expect(result.files[0].content).toContain('\\${expression}');
-    });
-});
-describe('name transformations', () => {
-    it('converts agent name to camelCase', async () => {
-        setupConfigMock();
-        const knowledge = makeKnowledge();
-        const result = await generateSubAgent('claude-agent-sdk', 'my-cool-agent', 'orchestrator', [], knowledge);
-        expect(result.files[0].content).toContain('myCoolAgentAgent');
-    });
-    it('converts agent name to PascalCase in LangGraph', async () => {
-        setupConfigMock();
-        const knowledge = makeKnowledge();
-        const result = await generateSubAgent('langgraph', 'my-cool-agent', 'orchestrator', [], knowledge);
-        expect(result.files[0].content).toContain('MyCoolAgentState');
-    });
-    it('converts spaces to underscores for Python frameworks', async () => {
-        setupConfigMock();
-        const knowledge = makeKnowledge();
-        const result = await generateSubAgent('crewai', 'my cool agent', 'orchestrator', [], knowledge);
-        expect(result.files[0].path).toContain('my_cool_agent');
-    });
-    it('converts spaces to hyphens for TS frameworks', async () => {
-        setupConfigMock();
-        const knowledge = makeKnowledge();
-        const result = await generateSubAgent('mastra', 'my cool agent', 'orchestrator', [], knowledge);
-        expect(result.files[0].path).toContain('my-cool-agent');
-    });
-});
-//# sourceMappingURL=agent-generator.test.js.map