specforge-mcp 0.1.0

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

@@ -0,0 +1,141 @@
+// SpecForge — Agent Generator: Prompt Builders and Inference Helpers
+// Generates system prompts and infers agent configuration from role/capabilities.
+export function buildSystemPrompt(agentName, role, capabilities, knowledge) {
+    const lines = [];
+    lines.push(`You are ${agentName}, a specialized ${role} agent.`);
+    lines.push('');
+    lines.push('## Your Capabilities');
+    for (const cap of capabilities) {
+        lines.push(`- ${cap}`);
+    }
+    lines.push('');
+    lines.push('## Project Context');
+    lines.push(`- Language: ${knowledge.language}`);
+    if (knowledge.framework) {
+        lines.push(`- Framework: ${knowledge.framework}`);
+    }
+    lines.push(`- Architecture: ${knowledge.architecture.primary}`);
+    lines.push(`- Database: ${knowledge.database}`);
+    lines.push('');
+    lines.push('## Rules');
+    lines.push('- Follow the project architecture patterns.');
+    lines.push('- Write clean, well-tested code.');
+    lines.push('- Handle errors explicitly.');
+    lines.push('- Report progress and blockers clearly.');
+    if (knowledge.qualityProfile.principles.length > 0) {
+        lines.push('');
+        lines.push('## Quality Principles');
+        for (const principle of knowledge.qualityProfile.principles) {
+            lines.push(`- ${principle}`);
+        }
+    }
+    // SPEC-022: Scope restrictions — sub-agents must NOT handle commit/push/tracking
+    lines.push('');
+    lines.push('## Scope Restrictions');
+    lines.push('- NEVER git commit or git push changes — that is handled by the parent skill');
+    lines.push('- NEVER update PROGRESS.md or spec tracking files — delegate to parent skill');
+    lines.push('- NEVER run the full CI/CD pipeline — parent skill manages pipeline execution');
+    lines.push('- Focus exclusively on your assigned subtask and report results clearly');
+    return lines.join('\n');
+}
+export function buildCoordinatorPrompt(knowledge) {
+    return [
+        'You are the coordinator agent for the SDD workflow.',
+        '',
+        '## Your Role',
+        'You orchestrate the development workflow:',
+        '1. Receive feature requests and break them into specs.',
+        '2. Assign analysis tasks to the analyst agent.',
+        '3. Route implementation tasks to the implementor agent.',
+        '4. Request reviews from the reviewer agent.',
+        '5. Track progress and resolve conflicts.',
+        '',
+        '## Project Context',
+        `- Language: ${knowledge.language}`,
+        `- Framework: ${knowledge.framework ?? 'none'}`,
+        `- Architecture: ${knowledge.architecture.primary}`,
+        `- Spec location: ${knowledge.specLocation}`,
+        '',
+        '## Workflow',
+        '1. Analyze -> 2. Spec -> 3. Filter -> 4. Implement -> 5. Validate -> 6. Complete',
+        '',
+        '## Rules',
+        '- Always create a spec before implementation.',
+        '- Validate implementation against spec criteria.',
+        '- Record actuals when completing specs.',
+        '- Resolve agent conflicts before proceeding.',
+    ].join('\n');
+}
+export function inferModel(role, capabilities) {
+    // Use Opus for complex reasoning tasks, Sonnet for simpler ones
+    const complexRoles = ['orchestrator', 'architect', 'code-analyst', 'security-auditor'];
+    const complexCapabilities = ['architecture-review', 'security-audit', 'complex-refactoring'];
+    if (complexRoles.includes(role)) {
+        return 'claude-sonnet-4-20250514';
+    }
+    if (capabilities.some((c) => complexCapabilities.includes(c))) {
+        return 'claude-sonnet-4-20250514';
+    }
+    return 'claude-sonnet-4-20250514';
+}
+export function inferTools(role, _capabilities, knowledge) {
+    const tools = [];
+    // Base tools for all agents
+    tools.push('read_file', 'write_file', 'list_directory');
+    // Role-specific tools
+    const roleTools = {
+        orchestrator: ['sdd_init_project', 'sdd_create_spec', 'sdd_update_status', 'sdd_orchestrate'],
+        'code-analyst': [
+            'sdd_audit_code',
+            'sdd_detect_drift',
+            'sdd_reverse_engineer',
+            'sdd_generate_checklist',
+        ],
+        'code-implementor': ['sdd_validate_spec', 'sdd_check_versions', 'bash'],
+        'code-reviewer': ['sdd_audit_code', 'sdd_generate_checklist', 'sdd_detect_drift'],
+        documentation: ['sdd_generate_docs', 'sdd_summarize_spec'],
+        testing: ['sdd_generate_test_plan', 'sdd_validate_spec', 'bash'],
+    };
+    if (roleTools[role]) {
+        tools.push(...(roleTools[role] ?? []));
+    }
+    // MCP tools if available
+    for (const mcp of knowledge.availableMcps) {
+        tools.push(...mcp.tools);
+    }
+    return [...new Set(tools)];
+}
+export function inferMaxTurns(role) {
+    const turnsByRole = {
+        orchestrator: 20,
+        'code-analyst': 10,
+        'code-implementor': 30,
+        'code-reviewer': 15,
+        documentation: 10,
+        testing: 15,
+    };
+    return turnsByRole[role] ?? 10;
+}
+export function inferHandoffConditions(role) {
+    const conditions = {
+        orchestrator: [
+            'Handoff to analyst when code analysis is needed.',
+            'Handoff to implementor when spec is approved and ready for coding.',
+            'Handoff to reviewer when implementation is complete.',
+        ],
+        'code-analyst': [
+            'Handoff back to coordinator with analysis results.',
+            'Handoff to reviewer if critical issues found.',
+        ],
+        'code-implementor': [
+            'Handoff to reviewer when implementation is complete.',
+            'Handoff to coordinator if blocked by dependencies.',
+        ],
+        'code-reviewer': [
+            'Handoff back to implementor if changes needed.',
+            'Handoff to coordinator when review is approved.',
+        ],
+    };
+    return conditions[role] ?? [];
+}
+//# sourceMappingURL=builders.js.map

package/dist/engine/agent-generator/builders.js.map

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

package/dist/engine/agent-generator/framework-files-helpers.d.ts

@@ -0,0 +1,10 @@
+import type { SubAgentFramework, FrameworkConfig, SkillFile } from '../../types/index.js';
+/** Convert a string to camelCase. */
+export declare function camelCase(str: string): string;
+/** Convert a string to PascalCase. */
+export declare function pascalCase(str: string): string;
+/** Escape backticks and template literal expressions for embedding in template literals. */
+export declare function escapeTemplateLiteral(str: string): string;
+/** Build human-readable install instructions for a framework agent. */
+export declare function buildInstallInstructions(framework: SubAgentFramework, config: FrameworkConfig, files: SkillFile[]): string;
+//# sourceMappingURL=framework-files-helpers.d.ts.map

package/dist/engine/agent-generator/framework-files-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-files-helpers.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-generator/framework-files-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE1F,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,sCAAsC;AACtC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,SAAS,EAAE,GACjB,MAAM,CA0CR"}

package/dist/engine/agent-generator/framework-files-helpers.js

@@ -0,0 +1,54 @@
+// SpecForge — Agent Generator: Framework File Helpers
+// Shared utility functions and install instruction builder.
+/** Convert a string to camelCase. */
+export function camelCase(str) {
+    return str
+        .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ''))
+        .replace(/^(.)/, (_, c) => c.toLowerCase());
+}
+/** Convert a string to PascalCase. */
+export function pascalCase(str) {
+    return str
+        .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ''))
+        .replace(/^(.)/, (_, c) => c.toUpperCase());
+}
+/** Escape backticks and template literal expressions for embedding in template literals. */
+export function escapeTemplateLiteral(str) {
+    return str.replace(/`/g, '\\`').replace(/\$\{/g, '\\${');
+}
+/** Build human-readable install instructions for a framework agent. */
+export function buildInstallInstructions(framework, config, files) {
+    const lines = [];
+    lines.push(`## ${config.name} Agent Setup`);
+    lines.push('');
+    lines.push(`Documentation: ${config.docsUrl}`);
+    lines.push(`Supported languages: ${config.languages.join(', ')}`);
+    lines.push('');
+    // Install commands
+    const installCommands = {
+        'claude-agent-sdk': 'npm install @anthropic-ai/sdk',
+        crewai: 'pip install crewai',
+        langgraph: 'pip install langgraph langchain-anthropic',
+        autogen: 'pip install autogen-agentchat',
+        mastra: 'npm install @mastra/core',
+        'vercel-ai-sdk': 'npm install ai @ai-sdk/anthropic',
+    };
+    if (installCommands[framework]) {
+        lines.push(`Install: \`${installCommands[framework]}\``);
+        lines.push('');
+    }
+    lines.push('Generated files:');
+    for (const file of files) {
+        lines.push(`- ${file.path}`);
+    }
+    if (config.supportsHandoffs) {
+        lines.push('');
+        lines.push('This framework supports agent handoffs. Configure handoff conditions as needed.');
+    }
+    if (config.supportsMcp) {
+        lines.push('');
+        lines.push('This framework supports MCP tools. Connect SDD MCP server for full workflow integration.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=framework-files-helpers.js.map

package/dist/engine/agent-generator/framework-files-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-files-helpers.js","sourceRoot":"","sources":["../../../src/engine/agent-generator/framework-files-helpers.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,4DAA4D;AAI5D,qCAAqC;AACrC,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,GAAG;SACP,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACjF,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG;SACP,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACjF,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,wBAAwB,CACtC,SAA4B,EAC5B,MAAuB,EACvB,KAAkB;IAElB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,IAAI,cAAc,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,mBAAmB;IACnB,MAAM,eAAe,GAA2B;QAC9C,kBAAkB,EAAE,+BAA+B;QACnD,MAAM,EAAE,oBAAoB;QAC5B,SAAS,EAAE,2CAA2C;QACtD,OAAO,EAAE,+BAA+B;QACxC,MAAM,EAAE,0BAA0B;QAClC,eAAe,EAAE,kCAAkC;KACpD,CAAC;IAEF,IAAI,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,cAAc,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;IAChG,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CACR,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/engine/agent-generator/framework-files.d.ts

@@ -0,0 +1,5 @@
+import type { SubAgentFramework, SubAgentDefinition, SkillFile, FrameworkConfig, ProjectKnowledge } from '../../types/index.js';
+import { buildInstallInstructions } from './framework-files-helpers.js';
+export { buildInstallInstructions };
+export declare function generateFrameworkFiles(framework: SubAgentFramework, agent: SubAgentDefinition, knowledge: ProjectKnowledge, _config: FrameworkConfig): SkillFile[];
+//# sourceMappingURL=framework-files.d.ts.map

package/dist/engine/agent-generator/framework-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-files.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-generator/framework-files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAIL,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,wBAAwB,EAAE,CAAC;AAqRpC,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,eAAe,GACvB,SAAS,EAAE,CAmBb"}

package/dist/engine/agent-generator/framework-files.js

@@ -0,0 +1,259 @@
+// SpecForge — Agent Generator: Framework-Specific File Generators
+// Generates code files for each supported multi-agent framework.
+import { camelCase, pascalCase, escapeTemplateLiteral, buildInstallInstructions, } from './framework-files-helpers.js';
+export { buildInstallInstructions };
+// === Framework File Generators ===
+function generateClaudeAgentSdkFiles(agent, _knowledge) {
+    const slug = agent.name.toLowerCase().replace(/\s+/g, '-');
+    const content = `// ${agent.name} — Generated by SpecForge SDD MCP Server
+// Framework: Anthropic Agent SDK
+// Docs: https://docs.anthropic.com/en/docs/agents
+
+import Anthropic from "@anthropic-ai/sdk";
+
+const client = new Anthropic();
+
+export const ${camelCase(agent.name)}Agent = {
+  name: "${agent.name}",
+  role: "${agent.role}",
+  model: "${agent.model}",
+  maxTurns: ${agent.maxTurns ?? 10},
+
+  systemPrompt: \`${escapeTemplateLiteral(agent.systemPrompt)}\`,
+
+  tools: ${JSON.stringify(agent.tools, null, 4)},
+
+  ${agent.handoffConditions ? `handoffConditions: ${JSON.stringify(agent.handoffConditions, null, 4)},` : ''}
+
+  async run(input: string) {
+    const response = await client.messages.create({
+      model: this.model,
+      max_tokens: 4096,
+      system: this.systemPrompt,
+      messages: [{ role: "user", content: input }],
+    });
+    return response;
+  },
+};
+`;
+    return [
+        {
+            path: `agents/${slug}.ts`,
+            content,
+            format: 'markdown', // TypeScript content, markdown format for SkillFile
+        },
+    ];
+}
+function generateCrewAiFiles(agent, knowledge) {
+    const slug = agent.name.toLowerCase().replace(/\s+/g, '_');
+    const content = `# ${agent.name} — Generated by SpecForge SDD MCP Server
+# Framework: CrewAI
+# Docs: https://docs.crewai.com
+
+from crewai import Agent, Task
+
+${slug}_agent = Agent(
+    role="${agent.role}",
+    goal="${agent.role} for ${knowledge.language}/${knowledge.framework ?? 'native'} project",
+    backstory="""${agent.systemPrompt.replace(/"/g, '\\"').substring(0, 500)}""",
+    verbose=True,
+    allow_delegation=${agent.handoffConditions ? 'True' : 'False'},
+    tools=[${agent.tools.map((t) => `"${t}"`).join(', ')}],
+    max_iter=${agent.maxTurns ?? 10},
+)
+
+# Example task
+${slug}_task = Task(
+    description="Execute the assigned ${agent.role} task.",
+    expected_output="Structured result of the ${agent.role} analysis.",
+    agent=${slug}_agent,
+)
+`;
+    return [
+        {
+            path: `agents/${slug}_agent.py`,
+            content,
+            format: 'markdown',
+        },
+    ];
+}
+function generateLangGraphFiles(agent, _knowledge) {
+    const slug = agent.name.toLowerCase().replace(/\s+/g, '_');
+    const content = `# ${agent.name} — Generated by SpecForge SDD MCP Server
+# Framework: LangGraph
+# Docs: https://langchain-ai.github.io/langgraph
+
+from langgraph.graph import StateGraph, END
+from langchain_anthropic import ChatAnthropic
+from typing import TypedDict, Annotated
+
+class ${pascalCase(agent.name)}State(TypedDict):
+    messages: list
+    context: dict
+    result: str | None
+
+llm = ChatAnthropic(model="${agent.model}")
+
+def ${slug}_node(state: ${pascalCase(agent.name)}State) -> ${pascalCase(agent.name)}State:
+    """${agent.role} node."""
+    system_prompt = """${agent.systemPrompt.replace(/"/g, '\\"').substring(0, 500)}"""
+
+    response = llm.invoke([
+        {"role": "system", "content": system_prompt},
+        *state["messages"],
+    ])
+
+    return {
+        **state,
+        "result": response.content,
+        "messages": [*state["messages"], {"role": "assistant", "content": response.content}],
+    }
+
+# Build the graph
+graph = StateGraph(${pascalCase(agent.name)}State)
+graph.add_node("${slug}", ${slug}_node)
+graph.set_entry_point("${slug}")
+graph.add_edge("${slug}", END)
+
+${slug}_graph = graph.compile()
+`;
+    return [
+        {
+            path: `agents/${slug}_graph.py`,
+            content,
+            format: 'markdown',
+        },
+    ];
+}
+function generateAutoGenFiles(agent, _knowledge) {
+    const slug = agent.name.toLowerCase().replace(/\s+/g, '_');
+    const content = `# ${agent.name} — Generated by SpecForge SDD MCP Server
+# Framework: AutoGen (Microsoft)
+# Docs: https://microsoft.github.io/autogen
+
+from autogen import AssistantAgent, UserProxyAgent
+
+${slug}_agent = AssistantAgent(
+    name="${agent.name}",
+    system_message="""${agent.systemPrompt.replace(/"/g, '\\"').substring(0, 500)}""",
+    llm_config={
+        "model": "${agent.model}",
+        "temperature": 0,
+    },
+    max_consecutive_auto_reply=${agent.maxTurns ?? 10},
+)
+
+# User proxy for human-in-the-loop
+user_proxy = UserProxyAgent(
+    name="user",
+    human_input_mode="TERMINATE",
+    max_consecutive_auto_reply=0,
+)
+
+# Example usage:
+# user_proxy.initiate_chat(${slug}_agent, message="Analyze the codebase")
+`;
+    return [
+        {
+            path: `agents/${slug}_autogen.py`,
+            content,
+            format: 'markdown',
+        },
+    ];
+}
+function generateMastraFiles(agent, _knowledge) {
+    const slug = agent.name.toLowerCase().replace(/\s+/g, '-');
+    const content = `// ${agent.name} — Generated by SpecForge SDD MCP Server
+// Framework: Mastra
+// Docs: https://mastra.ai/docs
+
+import { Agent } from "@mastra/core";
+
+export const ${camelCase(agent.name)}Agent = new Agent({
+  name: "${agent.name}",
+  instructions: \`${escapeTemplateLiteral(agent.systemPrompt)}\`,
+  model: {
+    provider: "ANTHROPIC",
+    name: "${agent.model}",
+  },
+  tools: {
+    ${agent.tools.map((t) => `// ${t}: imported from your tools registry`).join('\n    ')}
+  },
+});
+`;
+    return [
+        {
+            path: `agents/${slug}.ts`,
+            content,
+            format: 'markdown',
+        },
+    ];
+}
+function generateVercelAiSdkFiles(agent, _knowledge) {
+    const slug = agent.name.toLowerCase().replace(/\s+/g, '-');
+    const content = `// ${agent.name} — Generated by SpecForge SDD MCP Server
+// Framework: Vercel AI SDK
+// Docs: https://sdk.vercel.ai/docs
+
+import { generateText } from "ai";
+import { anthropic } from "@ai-sdk/anthropic";
+
+export async function run${pascalCase(agent.name)}(input: string) {
+  const result = await generateText({
+    model: anthropic("${agent.model}"),
+    system: \`${escapeTemplateLiteral(agent.systemPrompt)}\`,
+    prompt: input,
+    maxSteps: ${agent.maxTurns ?? 10},
+  });
+
+  return result.text;
+}
+`;
+    return [
+        {
+            path: `agents/${slug}.ts`,
+            content,
+            format: 'markdown',
+        },
+    ];
+}
+function generateGenericFiles(agent, _knowledge) {
+    const content = JSON.stringify({
+        name: agent.name,
+        role: agent.role,
+        model: agent.model,
+        systemPrompt: agent.systemPrompt,
+        tools: agent.tools,
+        maxTurns: agent.maxTurns,
+        handoffConditions: agent.handoffConditions,
+    }, null, 2);
+    return [
+        {
+            path: `agents/${agent.name.toLowerCase().replace(/\s+/g, '-')}.json`,
+            content,
+            format: 'json',
+        },
+    ];
+}
+// === Public Entry Point ===
+export function generateFrameworkFiles(framework, agent, knowledge, _config) {
+    switch (framework) {
+        case 'claude-agent-sdk':
+            return generateClaudeAgentSdkFiles(agent, knowledge);
+        case 'crewai':
+            return generateCrewAiFiles(agent, knowledge);
+        case 'langgraph':
+            return generateLangGraphFiles(agent, knowledge);
+        case 'autogen':
+            return generateAutoGenFiles(agent, knowledge);
+        case 'mastra':
+            return generateMastraFiles(agent, knowledge);
+        case 'vercel-ai-sdk':
+            return generateVercelAiSdkFiles(agent, knowledge);
+        case 'custom':
+            return generateGenericFiles(agent, knowledge);
+        default:
+            return generateGenericFiles(agent, knowledge);
+    }
+}
+//# sourceMappingURL=framework-files.js.map

package/dist/engine/agent-generator/framework-files.js.map

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

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

@@ -0,0 +1,18 @@
+import type { SubAgentFramework, GenerateSubAgentResult, ProjectKnowledge, FrameworkConfig } from '../types/index.js';
+import { buildSystemPrompt, buildCoordinatorPrompt, inferModel, inferTools, inferMaxTurns, inferHandoffConditions } from './agent-generator/builders.js';
+import { generateFrameworkFiles, buildInstallInstructions } from './agent-generator/framework-files.js';
+export { buildSystemPrompt, buildCoordinatorPrompt, inferModel, inferTools, inferMaxTurns, inferHandoffConditions, generateFrameworkFiles, buildInstallInstructions, };
+/**
+ * Generate a sub-agent definition for a given multi-agent framework.
+ */
+export declare function generateSubAgent(framework: SubAgentFramework, agentName: string, role: string, capabilities: string[], knowledge: ProjectKnowledge, tools?: string[], systemPrompt?: string): Promise<GenerateSubAgentResult>;
+/**
+ * Generate a complete multi-agent system definition for a project.
+ * Creates a coordinator agent plus specialized sub-agents.
+ */
+export declare function generateAgentSystem(framework: SubAgentFramework, knowledge: ProjectKnowledge): Promise<GenerateSubAgentResult[]>;
+/**
+ * Get framework configuration details.
+ */
+export declare function getFrameworkConfig(framework: SubAgentFramework): Promise<FrameworkConfig>;
+//# sourceMappingURL=agent-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-generator.d.ts","sourceRoot":"","sources":["../../src/engine/agent-generator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,iBAAiB,EAEjB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,aAAa,EACb,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,CAAC;AAuBF;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EAAE,EACtB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,GAAE,MAAM,EAAO,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,sBAAsB,CAAC,CA0BjC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAqDnC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAW/F"}

package/dist/engine/agent-generator.js

@@ -0,0 +1,81 @@
+// SpecForge — Agent Generator Engine
+// Generates sub-agent definitions for various multi-agent frameworks.
+// Orchestrator: delegates to agent-generator/ sub-modules.
+import { readFile } from 'node:fs/promises';
+import { buildSystemPrompt, buildCoordinatorPrompt, inferModel, inferTools, inferMaxTurns, inferHandoffConditions, } from './agent-generator/builders.js';
+import { generateFrameworkFiles, buildInstallInstructions, } from './agent-generator/framework-files.js';
+// Re-export sub-module functions so existing callers via this module still work.
+export { buildSystemPrompt, buildCoordinatorPrompt, inferModel, inferTools, inferMaxTurns, inferHandoffConditions, generateFrameworkFiles, buildInstallInstructions, };
+// === Framework Config ===
+let frameworksCache = null;
+async function loadFrameworks() {
+    if (frameworksCache) {
+        return frameworksCache;
+    }
+    try {
+        const configPath = new URL('../config/agent-platforms.json', import.meta.url);
+        const content = await readFile(configPath, 'utf-8');
+        frameworksCache = JSON.parse(content);
+        return frameworksCache;
+    }
+    catch {
+        /* v8 ignore next -- defensive catch for missing config file */
+        return { subAgentFrameworks: {} };
+    }
+}
+// === Public API ===
+/**
+ * Generate a sub-agent definition for a given multi-agent framework.
+ */
+export async function generateSubAgent(framework, agentName, role, capabilities, knowledge, tools = [], systemPrompt) {
+    const config = await getFrameworkConfig(framework);
+    const resolvedPrompt = systemPrompt ?? buildSystemPrompt(agentName, role, capabilities, knowledge);
+    const resolvedTools = tools.length > 0 ? tools : inferTools(role, capabilities, knowledge);
+    const agentDefinition = {
+        name: agentName,
+        role,
+        model: inferModel(role, capabilities),
+        systemPrompt: resolvedPrompt,
+        tools: resolvedTools,
+        maxTurns: inferMaxTurns(role),
+        // SPEC-022: Only generate handoff conditions for frameworks that support them natively
+        handoffConditions: config.supportsHandoffs ? inferHandoffConditions(role) : undefined,
+    };
+    const files = generateFrameworkFiles(framework, agentDefinition, knowledge, config);
+    return {
+        framework,
+        files,
+        agentDefinition,
+        installInstructions: buildInstallInstructions(framework, config, files),
+    };
+}
+/**
+ * Generate a complete multi-agent system definition for a project.
+ * Creates a coordinator agent plus specialized sub-agents.
+ */
+export async function generateAgentSystem(framework, knowledge) {
+    const agents = [];
+    // Coordinator agent
+    agents.push(await generateSubAgent(framework, 'coordinator', 'orchestrator', ['task-routing', 'spec-management', 'workflow-control'], knowledge, ['sdd_init_project', 'sdd_create_spec', 'sdd_update_status', 'sdd_orchestrate'], buildCoordinatorPrompt(knowledge)));
+    // Analyst agent
+    agents.push(await generateSubAgent(framework, 'analyst', 'code-analyst', ['code-analysis', 'architecture-review', 'dependency-scanning'], knowledge, ['sdd_audit_code', 'sdd_detect_drift', 'sdd_reverse_engineer']));
+    // Implementor agent
+    agents.push(await generateSubAgent(framework, 'implementor', 'code-implementor', ['code-generation', 'file-editing', 'refactoring'], knowledge, ['sdd_validate_spec', 'sdd_check_versions']));
+    // Reviewer agent
+    agents.push(await generateSubAgent(framework, 'reviewer', 'code-reviewer', ['code-review', 'quality-check', 'security-audit'], knowledge, ['sdd_audit_code', 'sdd_generate_checklist', 'sdd_detect_drift']));
+    return agents;
+}
+/**
+ * Get framework configuration details.
+ */
+export async function getFrameworkConfig(framework) {
+    const platforms = await loadFrameworks();
+    return (platforms.subAgentFrameworks[framework] ?? {
+        name: framework,
+        languages: ['typescript'],
+        docsUrl: '',
+        supportsHandoffs: false,
+        supportsMcp: false,
+    });
+}
+//# sourceMappingURL=agent-generator.js.map

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

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

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

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

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

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