specforge-mcp 0.1.0

package/dist/tools/generate-sub-agent.js

@@ -0,0 +1,82 @@
+// tools/generate-sub-agent.ts — Create specialized sub-agents
+// Uses agent-generator engine: generateSubAgent()
+import { t, ti } from '../i18n/index.js';
+import { knowledgeStore } from '../storage/index.js';
+import { generateSubAgent } from '../engine/agent-generator.js';
+export async function handleGenerateSubAgent(args) {
+    const { projectId, framework, agentName, role, capabilities, tools = [], systemPrompt } = args;
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    if (!knowledge) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('errors.projectNotFound', { projectId }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const result = await generateSubAgent(framework, agentName, role, capabilities, knowledge, tools, systemPrompt);
+    // Format output
+    const lines = [
+        `## ${t('tools.generate_sub_agent.description')}`,
+        '',
+        `**Framework:** ${result.framework}`,
+        `**Agent name:** ${result.agentDefinition.name}`,
+        `**Role:** ${result.agentDefinition.role}`,
+        `**Model:** ${result.agentDefinition.model}`,
+        `**Max turns:** ${result.agentDefinition.maxTurns ?? 'default'}`,
+        '',
+    ];
+    // Tools
+    if (result.agentDefinition.tools.length > 0) {
+        lines.push('### Available Tools');
+        lines.push('');
+        for (const tool of result.agentDefinition.tools) {
+            lines.push(`- \`${tool}\``);
+        }
+        lines.push('');
+    }
+    // Handoff conditions
+    if (result.agentDefinition.handoffConditions &&
+        result.agentDefinition.handoffConditions.length > 0) {
+        lines.push('### Handoff Conditions');
+        lines.push('');
+        for (const condition of result.agentDefinition.handoffConditions) {
+            lines.push(`- ${condition}`);
+        }
+        lines.push('');
+    }
+    // System prompt
+    lines.push('### System Prompt');
+    lines.push('');
+    lines.push('```');
+    lines.push(result.agentDefinition.systemPrompt);
+    lines.push('```');
+    lines.push('');
+    // Generated files
+    for (const file of result.files) {
+        lines.push(`### File: \`${file.path}\``);
+        lines.push('');
+        const lang = file.path.endsWith('.py')
+            ? 'python'
+            : file.path.endsWith('.ts')
+                ? 'typescript'
+                : file.path.endsWith('.json')
+                    ? 'json'
+                    : 'text';
+        lines.push(`\`\`\`${lang}`);
+        lines.push(file.content);
+        lines.push('```');
+        lines.push('');
+    }
+    // Install instructions
+    lines.push('### Installation');
+    lines.push('');
+    lines.push(result.installInstructions);
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+//# sourceMappingURL=generate-sub-agent.js.map

package/dist/tools/generate-sub-agent.js.map

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

package/dist/tools/generate-sub-agent.test.d.ts

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

package/dist/tools/generate-sub-agent.test.d.ts.map

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

package/dist/tools/generate-sub-agent.test.js

@@ -0,0 +1,162 @@
+// Tests for handleGenerateSubAgent
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('../i18n/index.js', () => ({
+    t: (key) => key,
+    ti: (key, _vars) => key,
+}));
+vi.mock('../storage/index.js', () => ({
+    knowledgeStore: { getKnowledge: vi.fn() },
+}));
+vi.mock('../engine/agent-generator.js', () => ({
+    generateSubAgent: vi.fn(),
+}));
+import { handleGenerateSubAgent } from './generate-sub-agent.js';
+import { knowledgeStore } from '../storage/index.js';
+import { generateSubAgent } from '../engine/agent-generator.js';
+const mockGetKnowledge = vi.mocked(knowledgeStore.getKnowledge);
+const mockGenerateSubAgent = vi.mocked(generateSubAgent);
+const baseKnowledge = {
+    language: 'typescript',
+    framework: 'express',
+    projectPath: '/test',
+    stack: [],
+    conventions: {},
+    architecture: { primary: 'monolith', secondary: [], layers: [] },
+    database: 'postgresql',
+    testCommand: null,
+    buildCommand: null,
+    linting: { detectedLinters: [] },
+    apiContracts: [],
+    layers: [],
+};
+const baseResult = {
+    framework: 'claude-agent-sdk',
+    agentDefinition: {
+        name: 'review-agent',
+        role: 'Code Reviewer',
+        model: 'claude-sonnet-4-20250514',
+        maxTurns: 10,
+        tools: ['read_file', 'search_code'],
+        handoffConditions: ['Escalate to human when confidence < 80%'],
+        systemPrompt: 'You are a code review agent.',
+    },
+    files: [
+        { path: 'agents/review-agent.ts', content: 'export class ReviewAgent {}' },
+        { path: 'agents/review-agent.json', content: '{"name":"review-agent"}' },
+    ],
+    installInstructions: 'npm install @anthropic-ai/sdk',
+};
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+describe('handleGenerateSubAgent', () => {
+    it('should return error when project not found', async () => {
+        mockGetKnowledge.mockResolvedValue(null);
+        const result = await handleGenerateSubAgent({
+            projectId: 'missing',
+            framework: 'claude-agent-sdk',
+            agentName: 'test',
+            role: 'Test',
+            capabilities: ['test'],
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('errors.projectNotFound');
+    });
+    it('should generate sub-agent successfully', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        mockGenerateSubAgent.mockResolvedValue(baseResult);
+        const result = await handleGenerateSubAgent({
+            projectId: 'proj-1',
+            framework: 'claude-agent-sdk',
+            agentName: 'review-agent',
+            role: 'Code Reviewer',
+            capabilities: ['read', 'analyze'],
+        });
+        expect(result.isError).toBeUndefined();
+        const text = result.content[0].text;
+        expect(text).toContain('claude-agent-sdk');
+        expect(text).toContain('review-agent');
+        expect(text).toContain('Code Reviewer');
+        expect(text).toContain('claude-sonnet-4-20250514');
+        expect(text).toContain('10'); // maxTurns
+        expect(text).toContain('read_file');
+        expect(text).toContain('Handoff Conditions');
+        expect(text).toContain('Escalate');
+        expect(text).toContain('System Prompt');
+        expect(text).toContain('code review agent');
+        expect(text).toContain('review-agent.ts');
+        expect(text).toContain('typescript'); // .ts extension => typescript lang
+        expect(text).toContain('json'); // .json extension => json lang
+        expect(text).toContain('Installation');
+    });
+    it('should pass tools and systemPrompt when provided', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        mockGenerateSubAgent.mockResolvedValue(baseResult);
+        await handleGenerateSubAgent({
+            projectId: 'proj-1',
+            framework: 'crewai',
+            agentName: 'test',
+            role: 'Worker',
+            capabilities: ['work'],
+            tools: ['web_search', 'file_read'],
+            systemPrompt: 'Custom prompt',
+        });
+        expect(mockGenerateSubAgent).toHaveBeenCalledWith('crewai', 'test', 'Worker', ['work'], baseKnowledge, ['web_search', 'file_read'], 'Custom prompt');
+    });
+    it('should handle agent with no tools, no handoff conditions', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        mockGenerateSubAgent.mockResolvedValue({
+            ...baseResult,
+            agentDefinition: {
+                ...baseResult.agentDefinition,
+                tools: [],
+                handoffConditions: [],
+                maxTurns: undefined,
+            },
+        });
+        const result = await handleGenerateSubAgent({
+            projectId: 'proj-1',
+            framework: 'langgraph',
+            agentName: 'minimal',
+            role: 'Simple',
+            capabilities: ['basic'],
+        });
+        const text = result.content[0].text;
+        expect(text).not.toContain('### Available Tools');
+        expect(text).not.toContain('### Handoff Conditions');
+        expect(text).toContain('default'); // maxTurns ?? 'default'
+    });
+    it('should detect python extension for .py files', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        mockGenerateSubAgent.mockResolvedValue({
+            ...baseResult,
+            files: [{ path: 'agents/agent.py', content: 'class Agent: pass', format: 'markdown' }],
+        });
+        const result = await handleGenerateSubAgent({
+            projectId: 'proj-1',
+            framework: 'crewai',
+            agentName: 'py-agent',
+            role: 'Worker',
+            capabilities: ['work'],
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('```python');
+    });
+    it('should default file lang to text for unknown extensions', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        mockGenerateSubAgent.mockResolvedValue({
+            ...baseResult,
+            files: [{ path: 'agents/agent.yaml', content: 'name: agent', format: 'yaml' }],
+        });
+        const result = await handleGenerateSubAgent({
+            projectId: 'proj-1',
+            framework: 'custom',
+            agentName: 'yaml-agent',
+            role: 'Worker',
+            capabilities: ['work'],
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('```text');
+    });
+});
+//# sourceMappingURL=generate-sub-agent.test.js.map

package/dist/tools/generate-sub-agent.test.js.map

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

package/dist/tools/generate-tests/adapters/contract-testing-adapter.d.ts

@@ -0,0 +1,16 @@
+import type { ProjectKnowledge, TestFile } from '../../../types/index.js';
+/**
+ * Generate contract spec file (OpenAPI/Pact/GraphQL/tRPC) for a spec.
+ * Returns a TestFile ready to be added to the tool output.
+ */
+export declare function buildContractTestFile(specTitle: string, specSlug: string, knowledge: ProjectKnowledge, autoGenerate: boolean): TestFile;
+/**
+ * Generate mock server file (MSW/json-server/WireMock) for a spec.
+ * Returns a TestFile ready to be added to the tool output.
+ */
+export declare function buildMockServerFile(specTitle: string, specSlug: string, knowledge: ProjectKnowledge, autoGenerate: boolean): TestFile;
+/**
+ * Build human-readable summary lines for the contract + mock section.
+ */
+export declare function buildContractMockSummaryLines(specTitle: string, knowledge: ProjectKnowledge): string[];
+//# sourceMappingURL=contract-testing-adapter.d.ts.map

package/dist/tools/generate-tests/adapters/contract-testing-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-testing-adapter.d.ts","sourceRoot":"","sources":["../../../../src/tools/generate-tests/adapters/contract-testing-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAe1E;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,gBAAgB,EAC3B,YAAY,EAAE,OAAO,GACpB,QAAQ,CAUV;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,gBAAgB,EAC3B,YAAY,EAAE,OAAO,GACpB,QAAQ,CAaV;AAID;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,gBAAgB,GAC1B,MAAM,EAAE,CA0BV"}

package/dist/tools/generate-tests/adapters/contract-testing-adapter.js

@@ -0,0 +1,67 @@
+// tools/generate-tests/adapters/contract-testing-adapter.ts
+// SPEC-018: Adapter connecting contract/mock generators to generate_tests tool output
+import { generateContractSpec, getContractFilePath, buildSampleEndpoints, } from '../../../engine/test-generators/contract-test-generator.js';
+import { generateMockDefinitions, generateMockServerContent, detectMockTool, getMockFileExtension, } from '../../../engine/test-generators/mock-generator.js';
+// === Contract test file generation ===
+/**
+ * Generate contract spec file (OpenAPI/Pact/GraphQL/tRPC) for a spec.
+ * Returns a TestFile ready to be added to the tool output.
+ */
+export function buildContractTestFile(specTitle, specSlug, knowledge, autoGenerate) {
+    const contractSpec = generateContractSpec(specTitle, knowledge);
+    const filePath = getContractFilePath(specSlug, contractSpec.format);
+    return {
+        path: filePath,
+        framework: `contract-${contractSpec.format}`,
+        content: contractSpec.content,
+        ready: autoGenerate,
+    };
+}
+// === Mock file generation ===
+/**
+ * Generate mock server file (MSW/json-server/WireMock) for a spec.
+ * Returns a TestFile ready to be added to the tool output.
+ */
+export function buildMockServerFile(specTitle, specSlug, knowledge, autoGenerate) {
+    const endpoints = buildSampleEndpoints(specTitle);
+    const mocks = generateMockDefinitions(endpoints, specTitle);
+    const tool = detectMockTool(knowledge.stack);
+    const ext = getMockFileExtension(tool);
+    const content = generateMockServerContent(mocks, specTitle, tool);
+    return {
+        path: `mocks/${specSlug}.mock.${ext}`,
+        framework: `mock-${tool}`,
+        content,
+        ready: autoGenerate,
+    };
+}
+// === Summary lines for output ===
+/**
+ * Build human-readable summary lines for the contract + mock section.
+ */
+export function buildContractMockSummaryLines(specTitle, knowledge) {
+    const contractSpec = generateContractSpec(specTitle, knowledge);
+    const endpoints = buildSampleEndpoints(specTitle);
+    const tool = detectMockTool(knowledge.stack);
+    const lines = [
+        '### Contract Testing',
+        '',
+        `**Format:** ${contractSpec.format} (auto-detected from project stack)`,
+        `**Endpoints:** ${endpoints.length} endpoints scaffolded`,
+        '',
+        '| Method | Path | Status Codes |',
+        '|--------|------|--------------|',
+        ...endpoints.map((ep) => `| ${ep.method} | \`${ep.path}\` | ${ep.statusCodes.join(', ')} |`),
+        '',
+        '### Mock Server',
+        '',
+        `**Tool:** ${tool} (auto-detected)`,
+        `**Mocks:** ${endpoints.length} endpoint mocks with realistic sample data`,
+        '**Features:** Simulated delay (250ms), error scenarios (400/401/403/404/500)',
+        '',
+        '> Frontend developers can use these mocks to work independently of the backend.',
+        '',
+    ];
+    return lines;
+}
+//# sourceMappingURL=contract-testing-adapter.js.map

package/dist/tools/generate-tests/adapters/contract-testing-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-testing-adapter.js","sourceRoot":"","sources":["../../../../src/tools/generate-tests/adapters/contract-testing-adapter.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,sFAAsF;AAGtF,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,4DAA4D,CAAC;AACpE,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,cAAc,EACd,oBAAoB,GACrB,MAAM,mDAAmD,CAAC;AAE3D,wCAAwC;AAExC;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,QAAgB,EAChB,SAA2B,EAC3B,YAAqB;IAErB,MAAM,YAAY,GAAG,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAEpE,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,YAAY,YAAY,CAAC,MAAM,EAAE;QAC5C,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,KAAK,EAAE,YAAY;KACpB,CAAC;AACJ,CAAC;AAED,+BAA+B;AAE/B;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,QAAgB,EAChB,SAA2B,EAC3B,YAAqB;IAErB,MAAM,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,uBAAuB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,SAAS,QAAQ,SAAS,GAAG,EAAE;QACrC,SAAS,EAAE,QAAQ,IAAI,EAAE;QACzB,OAAO;QACP,KAAK,EAAE,YAAY;KACpB,CAAC;AACJ,CAAC;AAED,mCAAmC;AAEnC;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,SAAiB,EACjB,SAA2B;IAE3B,MAAM,YAAY,GAAG,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAE7C,MAAM,KAAK,GAAa;QACtB,sBAAsB;QACtB,EAAE;QACF,eAAe,YAAY,CAAC,MAAM,qCAAqC;QACvE,kBAAkB,SAAS,CAAC,MAAM,uBAAuB;QACzD,EAAE;QACF,kCAAkC;QAClC,kCAAkC;QAClC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,MAAM,QAAQ,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5F,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,aAAa,IAAI,kBAAkB;QACnC,cAAc,SAAS,CAAC,MAAM,4CAA4C;QAC1E,8EAA8E;QAC9E,EAAE;QACF,iFAAiF;QACjF,EAAE;KACH,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tools/generate-tests/generators/a11y-tests-generator.d.ts

@@ -0,0 +1,4 @@
+import type { TestDefinition } from '../../../types/index.js';
+export declare function generateA11yTestDefs(title: string, testDir: string): TestDefinition[];
+export declare function generateA11yTestContent(title: string, framework: string, language: string): string;
+//# sourceMappingURL=a11y-tests-generator.d.ts.map

package/dist/tools/generate-tests/generators/a11y-tests-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-tests-generator.d.ts","sourceRoot":"","sources":["../../../../src/tools/generate-tests/generators/a11y-tests-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAmBrF;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,CAKR"}

package/dist/tools/generate-tests/generators/a11y-tests-generator.js

@@ -0,0 +1,93 @@
+// tools/generate-tests/generators/a11y-tests-generator.ts
+// SPEC-017a: Accessibility test definitions and content generators
+export function generateA11yTestDefs(title, testDir) {
+    return [
+        {
+            name: `${title} — a11y: zero WCAG violations`,
+            type: 'unit',
+            file: `${testDir}/a11y/`,
+            description: `Verify zero WCAG AA violations using axe-core on all UI components`,
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — a11y: keyboard navigation`,
+            type: 'unit',
+            file: `${testDir}/a11y/`,
+            description: `Verify all interactive elements are keyboard accessible`,
+            priority: 'high',
+            automatable: true,
+        },
+    ];
+}
+export function generateA11yTestContent(title, framework, language) {
+    if (language === 'python') {
+        return generatePythonA11yTest(title);
+    }
+    return generateJsA11yTest(title, framework);
+}
+function generateJsA11yTest(title, framework) {
+    const isVitest = framework === 'vitest';
+    const runner = isVitest ? 'vitest' : 'jest';
+    return [
+        `// Accessibility tests for: ${title}`,
+        '// Generated by SpecForge SDD MCP Server',
+        '// Requires: @axe-core/react (React) or axe-core + jest-axe',
+        '',
+        `import { describe, it, expect } from '${runner}'`,
+        "import { render } from '@testing-library/react'",
+        "import { axe, toHaveNoViolations } from 'jest-axe'",
+        '',
+        'expect.extend(toHaveNoViolations)',
+        '',
+        `describe('${title} — Accessibility (WCAG 2.1 AA)', () => {`,
+        `  it('should have no WCAG violations', async () => {`,
+        `    // TODO: Replace with actual component`,
+        `    const { container } = render(<div>Component under test</div>)`,
+        `    const results = await axe(container)`,
+        `    expect(results).toHaveNoViolations()`,
+        `  })`,
+        '',
+        `  it('should be keyboard navigable', async () => {`,
+        `    // TODO: Replace with actual component`,
+        `    const { getByRole } = render(<div tabIndex={0}>Interactive element</div>)`,
+        `    const element = getByRole('generic')`,
+        `    element.focus()`,
+        `    expect(document.activeElement).toBe(element)`,
+        `  })`,
+        '',
+        `  it('should have visible focus indicators', async () => {`,
+        `    // Manual verification required: ensure CSS :focus-visible styles are defined`,
+        `    // Automated: check outline is not none without replacement`,
+        `    expect(true).toBe(true) // Replace with actual focus style assertion`,
+        `  })`,
+        `})`,
+    ].join('\n');
+}
+function generatePythonA11yTest(title) {
+    return [
+        `# Accessibility tests for: ${title}`,
+        '# Generated by SpecForge SDD MCP Server',
+        '# Requires: playwright + axe-playwright for Python',
+        '',
+        'import pytest',
+        '',
+        `class Test${title.replace(/\s+/g, '')}Accessibility:`,
+        `    def test_no_wcag_violations(self, page):`,
+        `        """Test zero WCAG 2.1 AA violations."""`,
+        `        # TODO: Navigate to the component/page URL`,
+        `        page.goto("http://localhost:3000")`,
+        `        # TODO: Use playwright-axe or axe-playwright`,
+        `        # violations = check_violations(page)`,
+        `        # assert len(violations) == 0`,
+        `        pass`,
+        '',
+        `    def test_keyboard_navigation(self, page):`,
+        `        """Test keyboard accessibility."""`,
+        `        page.goto("http://localhost:3000")`,
+        `        page.keyboard.press("Tab")`,
+        `        # TODO: Assert focused element is the expected first interactive element`,
+        `        pass`,
+    ].join('\n');
+}
+//# sourceMappingURL=a11y-tests-generator.js.map

package/dist/tools/generate-tests/generators/a11y-tests-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-tests-generator.js","sourceRoot":"","sources":["../../../../src/tools/generate-tests/generators/a11y-tests-generator.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,mEAAmE;AAInE,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,OAAe;IACjE,OAAO;QACL;YACE,IAAI,EAAE,GAAG,KAAK,+BAA+B;YAC7C,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,GAAG,OAAO,QAAQ;YACxB,WAAW,EAAE,oEAAoE;YACjF,QAAQ,EAAE,MAAM;YAChB,WAAW,EAAE,IAAI;SAClB;QACD;YACE,IAAI,EAAE,GAAG,KAAK,8BAA8B;YAC5C,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,GAAG,OAAO,QAAQ;YACxB,WAAW,EAAE,yDAAyD;YACtE,QAAQ,EAAE,MAAM;YAChB,WAAW,EAAE,IAAI;SAClB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAa,EACb,SAAiB,EACjB,QAAgB;IAEhB,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa,EAAE,SAAiB;IAC1D,MAAM,QAAQ,GAAG,SAAS,KAAK,QAAQ,CAAC;IACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO;QACL,+BAA+B,KAAK,EAAE;QACtC,0CAA0C;QAC1C,6DAA6D;QAC7D,EAAE;QACF,yCAAyC,MAAM,GAAG;QAClD,iDAAiD;QACjD,oDAAoD;QACpD,EAAE;QACF,mCAAmC;QACnC,EAAE;QACF,aAAa,KAAK,0CAA0C;QAC5D,sDAAsD;QACtD,4CAA4C;QAC5C,mEAAmE;QACnE,0CAA0C;QAC1C,0CAA0C;QAC1C,MAAM;QACN,EAAE;QACF,oDAAoD;QACpD,4CAA4C;QAC5C,+EAA+E;QAC/E,0CAA0C;QAC1C,qBAAqB;QACrB,kDAAkD;QAClD,MAAM;QACN,EAAE;QACF,4DAA4D;QAC5D,mFAAmF;QACnF,iEAAiE;QACjE,0EAA0E;QAC1E,MAAM;QACN,IAAI;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,OAAO;QACL,8BAA8B,KAAK,EAAE;QACrC,yCAAyC;QACzC,oDAAoD;QACpD,EAAE;QACF,eAAe;QACf,EAAE;QACF,aAAa,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB;QACtD,8CAA8C;QAC9C,iDAAiD;QACjD,oDAAoD;QACpD,4CAA4C;QAC5C,sDAAsD;QACtD,+CAA+C;QAC/C,uCAAuC;QACvC,cAAc;QACd,EAAE;QACF,+CAA+C;QAC/C,4CAA4C;QAC5C,4CAA4C;QAC5C,oCAAoC;QACpC,kFAAkF;QAClF,cAAc;KACf,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/tools/generate-tests/generators/advanced-testing-generator.d.ts

@@ -0,0 +1,16 @@
+import type { TestDefinition, TestFile, Spec, ProjectKnowledge } from '../../../types/index.js';
+/**
+ * Return true when the project has advanced testing patterns to generate.
+ * Detects property-based needs, critical modules, k8s, or web projects.
+ */
+export declare function isAdvancedTestingProject(spec: Spec, knowledge: ProjectKnowledge): boolean;
+/**
+ * Generate advanced testing test definitions (used for the test plan summary).
+ */
+export declare function generateAdvancedTestingDefs(spec: Spec, testDir: string): TestDefinition[];
+/**
+ * Generate advanced testing test files for the spec.
+ * Generates property-based scaffolds, mutation configs, a11y tests, and chaos runbooks.
+ */
+export declare function generateAdvancedTestingFiles(spec: Spec, testDir: string, language: string, knowledge: ProjectKnowledge, autoGenerate: boolean): TestFile[];
+//# sourceMappingURL=advanced-testing-generator.d.ts.map

package/dist/tools/generate-tests/generators/advanced-testing-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-testing-generator.d.ts","sourceRoot":"","sources":["../../../../src/tools/generate-tests/generators/advanced-testing-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AA4BhG;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAmBzF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAwBzF;AAgFD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,gBAAgB,EAC3B,YAAY,EAAE,OAAO,GACpB,QAAQ,EAAE,CA2BZ"}

package/dist/tools/generate-tests/generators/advanced-testing-generator.js

@@ -0,0 +1,146 @@
+// tools/generate-tests/generators/advanced-testing-generator.ts — SPEC-049
+// Generates advanced testing scaffolds: property-based, mutation config, a11y, chaos runbook.
+import { detectPropertyBasedNeed, generatePropertyScaffold, generateMutationConfig, getMutationTool, generateChaosRunbook, buildChaosRunbookMarkdown, isKubernetesProject, generateA11yTests, isWebProject, } from '../../../engine/advanced-testing/index.js';
+/** Criteria keywords that trigger property-based test generation. */
+const CRITICAL_KEYWORDS = ['critical', 'payment', 'auth', 'security', 'financial', 'core'];
+/** Return true if the spec involves a critical module needing mutation config. */
+function isCriticalModule(spec) {
+    const text = `${spec.title} ${spec.tags.join(' ')}`.toLowerCase();
+    return CRITICAL_KEYWORDS.some((kw) => text.includes(kw));
+}
+/** Join all spec criteria text for keyword detection. */
+function getCriteriaText(spec) {
+    // Use title and tags as a proxy for criteria text
+    return `${spec.title} ${spec.tags.join(' ')}`;
+}
+/**
+ * Return true when the project has advanced testing patterns to generate.
+ * Detects property-based needs, critical modules, k8s, or web projects.
+ */
+export function isAdvancedTestingProject(spec, knowledge) {
+    const criteriaText = getCriteriaText(spec);
+    if (detectPropertyBasedNeed(criteriaText)) {
+        return true;
+    }
+    if (isCriticalModule(spec)) {
+        return true;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    const toolingKeys = Object.keys(knowledge.tooling ?? {});
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    const stackEntries = knowledge.stack ?? [];
+    if (isKubernetesProject([...toolingKeys, ...stackEntries])) {
+        return true;
+    }
+    if (isWebProject(stackEntries)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Generate advanced testing test definitions (used for the test plan summary).
+ */
+export function generateAdvancedTestingDefs(spec, testDir) {
+    const defs = [];
+    defs.push({
+        name: `${spec.title} — Property-Based: invariant properties hold for all valid inputs`,
+        type: 'unit',
+        file: `${testDir}/advanced/`,
+        description: 'Verify invariant properties using property-based testing (fast-check/Hypothesis)',
+        priority: 'high',
+        automatable: true,
+    });
+    if (isCriticalModule(spec)) {
+        defs.push({
+            name: `${spec.title} — Mutation: mutation score ≥ 80%`,
+            type: 'unit',
+            file: `${testDir}/advanced/`,
+            description: 'Run mutation testing (Stryker/mutmut) and verify mutation score ≥ 80%',
+            priority: 'high',
+            automatable: true,
+        });
+    }
+    return defs;
+}
+/** Generate a property-based test file for the spec. */
+function buildPropertyBasedTestFile(spec, testDir, language, autoGenerate) {
+    const criteriaText = getCriteriaText(spec);
+    const invariantHint = detectPropertyBasedNeed(criteriaText)
+        ? 'invariant: output is within expected range for any valid input'
+        : 'idempotent: applying N times equals applying 1 time';
+    const scaffold = generatePropertyScaffold(language, invariantHint);
+    const ext = language === 'python' ? 'py' : 'ts';
+    const slug = spec.id.toLowerCase().replace(/[^a-z0-9]/g, '-');
+    return {
+        path: `${testDir}/advanced/${slug}.property.${ext}`,
+        framework: language === 'python' ? 'hypothesis' : 'fast-check',
+        content: scaffold.scaffold,
+        ready: autoGenerate,
+    };
+}
+/** Generate a mutation testing config file for the spec. */
+function buildMutationConfigFile(spec, testDir, language, autoGenerate) {
+    const tool = getMutationTool(language);
+    const mutationConfig = generateMutationConfig(tool, language);
+    const slug = spec.id.toLowerCase().replace(/[^a-z0-9]/g, '-');
+    const ext = language === 'python' ? 'cfg' : 'mjs';
+    return {
+        path: `${testDir}/advanced/${slug}.mutation.${ext}`,
+        framework: tool,
+        content: mutationConfig.configFile,
+        ready: autoGenerate,
+    };
+}
+/** Generate a chaos runbook file for the spec. */
+function buildChaosRunbookFile(spec, testDir, autoGenerate) {
+    const slug = spec.id.toLowerCase().replace(/[^a-z0-9]/g, '-');
+    const experiments = generateChaosRunbook('staging');
+    const content = buildChaosRunbookMarkdown('staging', experiments);
+    return {
+        path: `${testDir}/advanced/${slug}.chaos.md`,
+        framework: 'litmuschaos',
+        content,
+        ready: autoGenerate,
+    };
+}
+/** Generate an accessibility test file for the spec. */
+function buildA11yTestFile(spec, testDir, language, autoGenerate) {
+    const testFramework = language === 'typescript' || language === 'javascript' ? 'playwright' : 'pa11y';
+    const a11yScaffold = generateA11yTests(testFramework);
+    const slug = spec.id.toLowerCase().replace(/[^a-z0-9]/g, '-');
+    const ext = language === 'typescript' ? 'ts' : 'js';
+    return {
+        path: `${testDir}/advanced/${slug}.a11y.${ext}`,
+        framework: a11yScaffold.framework,
+        content: a11yScaffold.testFile,
+        ready: autoGenerate,
+    };
+}
+/**
+ * Generate advanced testing test files for the spec.
+ * Generates property-based scaffolds, mutation configs, a11y tests, and chaos runbooks.
+ */
+export function generateAdvancedTestingFiles(spec, testDir, language, knowledge, autoGenerate) {
+    const files = [];
+    const criteriaText = getCriteriaText(spec);
+    // Property-based test scaffold
+    if (detectPropertyBasedNeed(criteriaText) || isCriticalModule(spec)) {
+        files.push(buildPropertyBasedTestFile(spec, testDir, language, autoGenerate));
+    }
+    // Mutation config for critical modules
+    if (isCriticalModule(spec)) {
+        files.push(buildMutationConfigFile(spec, testDir, language, autoGenerate));
+    }
+    // Chaos runbook for k8s projects
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    const projectFiles = Object.keys(knowledge.tooling ?? {}).concat(knowledge.stack ?? []);
+    if (isKubernetesProject(projectFiles)) {
+        files.push(buildChaosRunbookFile(spec, testDir, autoGenerate));
+    }
+    // A11y tests for web projects
+    if (isWebProject(knowledge.stack)) {
+        files.push(buildA11yTestFile(spec, testDir, language, autoGenerate));
+    }
+    return files;
+}
+//# sourceMappingURL=advanced-testing-generator.js.map