specforge-mcp 0.1.0

package/dist/tools/generate-tests.js

@@ -0,0 +1,285 @@
+// tools/generate-tests.ts — Generate test scaffold from spec
+// Uses project knowledge + spec to create test definitions
+import { t, ti } from '../i18n/index.js';
+import { knowledgeStore, specStore } from '../storage/index.js';
+import { generateUnitTestContent, generateIntegrationTestContent, generateE2eTestContent, buildTestCommands, } from './generate-tests-content.js';
+import { buildContractMockSummaryLines } from './generate-tests/adapters/contract-testing-adapter.js';
+import { runSpecializedGenerators } from './generate-tests/spec-dispatcher.js';
+export async function handleGenerateTests(args) {
+    const { specId, projectId, autoGenerate = false } = args;
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    if (!knowledge) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('errors.projectNotFound', { projectId }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('errors.specNotFound', { specId }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Determine test framework from project knowledge
+    const testFramework = inferTestFramework(knowledge.language, knowledge.stack);
+    const testDir = inferTestDir(knowledge.language);
+    const testExt = getTestExt(knowledge.language);
+    // Generate test definitions based on spec
+    const unitTests = generateUnitTestDefs(spec.title, spec.target, testDir);
+    const integrationTests = generateIntegrationTestDefs(spec.title, spec.target, testDir);
+    const e2eTests = generateE2eTestDefs(spec.title, spec.target, testDir);
+    // Generate test files with scaffolding
+    const testFiles = [];
+    const slug = spec.id.toLowerCase().replace(/[^a-z0-9]/g, '-');
+    // Unit test file
+    testFiles.push({
+        path: `${testDir}/unit/${slug}.test.${testExt}`,
+        framework: testFramework,
+        content: generateUnitTestContent(spec.title, spec.target, testFramework, knowledge.language),
+        ready: autoGenerate,
+    });
+    // Integration test file
+    if (spec.target === 'backend' || spec.target === 'fullstack') {
+        testFiles.push({
+            path: `${testDir}/integration/${slug}.integration.test.${testExt}`,
+            framework: testFramework,
+            content: generateIntegrationTestContent(spec.title, testFramework, knowledge.language),
+            ready: autoGenerate,
+        });
+    }
+    // E2E test file
+    if (spec.target === 'frontend' || spec.target === 'fullstack') {
+        const e2eFramework = knowledge.stack.includes('playwright')
+            ? 'playwright'
+            : knowledge.stack.includes('cypress')
+                ? 'cypress'
+                : 'playwright';
+        testFiles.push({
+            path: `${testDir}/e2e/${slug}.e2e.test.${testExt}`,
+            framework: e2eFramework,
+            content: generateE2eTestContent(spec.title, e2eFramework),
+            ready: autoGenerate,
+        });
+    }
+    // Dispatch spec-specific generators (agents, smart contracts, ML, games, MCP, events, etc.)
+    const { isApiSpec } = runSpecializedGenerators({ spec, knowledge, testDir, testFramework, slug, autoGenerate, testExt }, unitTests, integrationTests, testFiles);
+    const commands = buildTestCommands(knowledge.testCommand, testFramework);
+    const result = {
+        unitTests,
+        integrationTests,
+        e2eTests,
+        manualTests: [
+            `Manually verify ${spec.title} in development environment`,
+            'Check edge cases not covered by automated tests',
+            'Verify visual appearance matches design',
+        ],
+        coverageTarget: 80,
+        testFiles,
+        commands,
+    };
+    // Format output
+    const lines = [
+        `## ${t('tools.generate_tests.description')}`,
+        '',
+        `**Spec:** ${spec.title} (\`${spec.id}\`)`,
+        `**Framework:** ${testFramework}`,
+        `**Coverage target:** ${result.coverageTarget}%`,
+        '',
+    ];
+    if (result.unitTests.length > 0) {
+        lines.push('### Unit Tests');
+        lines.push('');
+        for (const test of result.unitTests) {
+            lines.push(`- **${test.name}** (${test.priority}) — ${test.description}`);
+            lines.push(`  File: \`${test.file}\``);
+        }
+        lines.push('');
+    }
+    if (result.integrationTests.length > 0) {
+        lines.push('### Integration Tests');
+        lines.push('');
+        for (const test of result.integrationTests) {
+            lines.push(`- **${test.name}** (${test.priority}) — ${test.description}`);
+            lines.push(`  File: \`${test.file}\``);
+        }
+        lines.push('');
+    }
+    if (result.e2eTests.length > 0) {
+        lines.push('### E2E Tests');
+        lines.push('');
+        for (const test of result.e2eTests) {
+            lines.push(`- **${test.name}** (${test.priority}) — ${test.description}`);
+            lines.push(`  File: \`${test.file}\``);
+        }
+        lines.push('');
+    }
+    if (result.manualTests.length > 0) {
+        lines.push('### Manual Tests');
+        lines.push('');
+        for (const test of result.manualTests) {
+            lines.push(`- [ ] ${test}`);
+        }
+        lines.push('');
+    }
+    // SPEC-018: Contract + mock summary (API specs only)
+    if (isApiSpec) {
+        lines.push(...buildContractMockSummaryLines(spec.title, knowledge));
+    }
+    // Show generated files
+    if (result.testFiles.length > 0) {
+        lines.push('### Generated Test Files');
+        lines.push('');
+        for (const file of result.testFiles) {
+            lines.push(`#### \`${file.path}\``);
+            lines.push('');
+            const ext = file.path.endsWith('.py') ? 'python' : 'typescript';
+            lines.push(`\`\`\`${ext}`);
+            lines.push(file.content);
+            lines.push('```');
+            lines.push('');
+        }
+    }
+    // Commands
+    if (result.commands.length > 0) {
+        lines.push('### Commands');
+        lines.push('');
+        lines.push('```bash');
+        for (const cmd of result.commands) {
+            lines.push(cmd);
+        }
+        lines.push('```');
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+// === Internal helpers ===
+function inferTestFramework(language, stack) {
+    if (stack.includes('vitest')) {
+        return 'vitest';
+    }
+    if (stack.includes('jest')) {
+        return 'jest';
+    }
+    if (stack.includes('pytest')) {
+        return 'pytest';
+    }
+    const defaults = {
+        typescript: 'vitest',
+        javascript: 'vitest',
+        python: 'pytest',
+        go: 'go-test',
+        rust: 'cargo-test',
+        java: 'junit',
+        kotlin: 'junit',
+        swift: 'xctest',
+        dart: 'flutter-test',
+    };
+    return defaults[language] ?? 'vitest';
+}
+function inferTestDir(language) {
+    const dirs = {
+        typescript: 'tests',
+        javascript: 'tests',
+        python: 'tests',
+        go: 'tests',
+        rust: 'tests',
+        java: 'src/test',
+        kotlin: 'src/test',
+        swift: 'Tests',
+        dart: 'test',
+    };
+    return dirs[language] ?? 'tests';
+}
+function getTestExt(language) {
+    const exts = {
+        typescript: 'ts',
+        javascript: 'js',
+        python: 'py',
+        go: 'go',
+        rust: 'rs',
+        java: 'java',
+        kotlin: 'kt',
+        swift: 'swift',
+        dart: 'dart',
+    };
+    return exts[language] ?? 'ts';
+}
+function generateUnitTestDefs(title, _target, testDir) {
+    return [
+        {
+            name: `${title} — core logic`,
+            type: 'unit',
+            file: `${testDir}/unit/`,
+            description: `Verify core business logic for ${title}`,
+            priority: 'critical',
+            automatable: true,
+        },
+        {
+            name: `${title} — edge cases`,
+            type: 'unit',
+            file: `${testDir}/unit/`,
+            description: `Test edge cases and error handling for ${title}`,
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — validation`,
+            type: 'unit',
+            file: `${testDir}/unit/`,
+            description: `Test input validation and sanitization`,
+            priority: 'high',
+            automatable: true,
+        },
+    ];
+}
+function generateIntegrationTestDefs(title, target, testDir) {
+    if (target !== 'backend' && target !== 'fullstack') {
+        return [];
+    }
+    return [
+        {
+            name: `${title} — API integration`,
+            type: 'integration',
+            file: `${testDir}/integration/`,
+            description: `Test API endpoints for ${title}`,
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — database integration`,
+            type: 'integration',
+            file: `${testDir}/integration/`,
+            description: `Test database operations for ${title}`,
+            priority: 'medium',
+            automatable: true,
+        },
+    ];
+}
+function generateE2eTestDefs(title, target, testDir) {
+    if (target !== 'frontend' && target !== 'fullstack') {
+        return [];
+    }
+    return [
+        {
+            name: `${title} — user flow`,
+            type: 'e2e',
+            file: `${testDir}/e2e/`,
+            description: `End-to-end test of user flow for ${title}`,
+            priority: 'high',
+            automatable: true,
+        },
+    ];
+}
+//# sourceMappingURL=generate-tests.js.map

package/dist/tools/generate-tests.js.map

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

package/dist/tools/generate-tests.test.d.ts

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

package/dist/tools/generate-tests.test.d.ts.map

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

package/dist/tools/generate-tests.test.js

@@ -0,0 +1,222 @@
+// Tests for handleGenerateTests
+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() },
+    specStore: { getSpec: vi.fn() },
+}));
+import { handleGenerateTests } from './generate-tests.js';
+import { knowledgeStore, specStore } from '../storage/index.js';
+const mockGetKnowledge = vi.mocked(knowledgeStore.getKnowledge);
+const mockGetSpec = vi.mocked(specStore.getSpec);
+const baseKnowledge = {
+    language: 'typescript',
+    framework: 'express',
+    projectPath: '/test',
+    stack: ['vitest'],
+    conventions: {},
+    architecture: { primary: 'monolith', secondary: [], layers: [] },
+    database: 'postgresql',
+    testCommand: 'npm test',
+    buildCommand: 'npm run build',
+    linting: { detectedLinters: [] },
+    apiContracts: [],
+    layers: [],
+};
+const baseSpec = {
+    id: 'SPEC-001',
+    slug: 'user-auth',
+    title: 'User Authentication',
+    type: 'feature',
+    scope: 'feature',
+    target: 'backend',
+    tags: ['auth'],
+    status: 'approved',
+    risk: 'medium',
+    difficulty: 3,
+    estimation: { devHours: 8, reviewHours: 2, totalCostUsd: 100 },
+    dependencies: [],
+    createdAt: '2025-01-01',
+    updatedAt: '2025-01-01',
+};
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+describe('handleGenerateTests', () => {
+    it('should return error when project not found', async () => {
+        mockGetKnowledge.mockResolvedValue(null);
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'missing',
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('errors.projectNotFound');
+    });
+    it('should return error when spec not found', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        mockGetSpec.mockResolvedValue(null);
+        const result = await handleGenerateTests({
+            specId: 'SPEC-999',
+            projectId: 'proj-1',
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('errors.specNotFound');
+    });
+    it('should generate unit test for backend spec', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        mockGetSpec.mockResolvedValue(baseSpec);
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'proj-1',
+        });
+        expect(result.isError).toBeUndefined();
+        const text = result.content[0].text;
+        expect(text).toContain('Unit Tests');
+        expect(text).toContain('User Authentication');
+        expect(text).toContain('vitest');
+        expect(text).toContain('Coverage target');
+        expect(text).toContain('80%');
+        expect(text).toContain('Integration Tests'); // backend => integration
+        expect(text).not.toContain('E2E Tests'); // backend only => no e2e
+        expect(text).toContain('Manual Tests');
+        expect(text).toContain('Generated Test Files');
+        expect(text).toContain('Commands');
+    });
+    it('should generate e2e test for fullstack spec', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        mockGetSpec.mockResolvedValue({ ...baseSpec, target: 'fullstack' });
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'proj-1',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('E2E Tests');
+        expect(text).toContain('Integration Tests');
+    });
+    it('should generate e2e test for frontend spec without integration', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        mockGetSpec.mockResolvedValue({ ...baseSpec, target: 'frontend' });
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'proj-1',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('E2E Tests');
+        // frontend-only: no integration tests generated
+    });
+    it('should use pytest for python language', async () => {
+        mockGetKnowledge.mockResolvedValue({
+            ...baseKnowledge,
+            language: 'python',
+            stack: ['pytest'],
+        });
+        mockGetSpec.mockResolvedValue(baseSpec);
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'proj-1',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('pytest');
+        expect(text).toContain('.py');
+    });
+    it('should use cypress when in stack', async () => {
+        mockGetKnowledge.mockResolvedValue({
+            ...baseKnowledge,
+            stack: ['vitest', 'cypress'],
+        });
+        mockGetSpec.mockResolvedValue({ ...baseSpec, target: 'fullstack' });
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'proj-1',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('cy.');
+    });
+    it('should include existing test command in commands', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        mockGetSpec.mockResolvedValue(baseSpec);
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'proj-1',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('npm test');
+    });
+    it('should default to vitest for unknown language', async () => {
+        mockGetKnowledge.mockResolvedValue({
+            ...baseKnowledge,
+            language: 'unknown-lang',
+            stack: [],
+        });
+        mockGetSpec.mockResolvedValue(baseSpec);
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'proj-1',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('vitest');
+    });
+    it('should omit existing test command when testCommand is null', async () => {
+        mockGetKnowledge.mockResolvedValue({
+            ...baseKnowledge,
+            testCommand: null,
+        });
+        mockGetSpec.mockResolvedValue(baseSpec);
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'proj-1',
+        });
+        const text = result.content[0].text;
+        expect(text).not.toContain('# Run all tests');
+        expect(text).toContain('vitest'); // still shows framework commands
+    });
+    it('should omit framework commands for unknown framework', async () => {
+        mockGetKnowledge.mockResolvedValue({
+            ...baseKnowledge,
+            language: 'dart',
+            stack: [],
+            testCommand: null,
+        });
+        mockGetSpec.mockResolvedValue(baseSpec);
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'proj-1',
+        });
+        const text = result.content[0].text;
+        // dart defaults to 'flutter-test' which has no entry in frameworkCmds
+        expect(text).not.toContain('Commands');
+    });
+    it('should use jest when jest is in stack', async () => {
+        mockGetKnowledge.mockResolvedValue({
+            ...baseKnowledge,
+            stack: ['jest'],
+        });
+        mockGetSpec.mockResolvedValue(baseSpec);
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'proj-1',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('jest');
+        // jest commands should be present
+        expect(text).toContain('npx jest');
+    });
+    it('should use pytest when pytest is in stack (non-python language)', async () => {
+        mockGetKnowledge.mockResolvedValue({
+            ...baseKnowledge,
+            language: 'typescript',
+            stack: ['pytest'],
+        });
+        mockGetSpec.mockResolvedValue(baseSpec);
+        const result = await handleGenerateTests({
+            specId: 'SPEC-001',
+            projectId: 'proj-1',
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('pytest');
+    });
+});
+//# sourceMappingURL=generate-tests.test.js.map

package/dist/tools/generate-tests.test.js.map

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

package/dist/tools/git/branch-ops.d.ts

@@ -0,0 +1,4 @@
+import type { ToolResult, GitConfig } from '../../types/index.js';
+export declare function handleCreateBranch(projectId: string, specId: string | undefined, config?: GitConfig): Promise<ToolResult>;
+export declare function handleCheckBranch(projectId: string, _specId: string | undefined, config?: GitConfig): Promise<ToolResult>;
+//# sourceMappingURL=branch-ops.d.ts.map

package/dist/tools/git/branch-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-ops.d.ts","sourceRoot":"","sources":["../../../src/tools/git/branch-ops.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAmB,MAAM,sBAAsB,CAAC;AAYnF,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,UAAU,CAAC,CA8DrB;AAED,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,UAAU,CAAC,CAsDrB"}

package/dist/tools/git/branch-ops.js

@@ -0,0 +1,106 @@
+import { specStore } from '../../storage/index.js';
+import { ti } from '../../i18n/index.js';
+import { git, resolveProjectPath, slugify, mergeConfig, DEFAULT_BRANCH_PREFIXES, DEFAULT_PROTECTED_BRANCHES, } from './git-helpers.js';
+export async function handleCreateBranch(projectId, specId, config) {
+    if (!specId) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: 'specId is required for create-branch action' }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const projectPath = await resolveProjectPath(projectId);
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [
+                { type: 'text', text: JSON.stringify({ error: `Spec '${specId}' not found` }, null, 2) },
+            ],
+            isError: true,
+        };
+    }
+    const mergedConfig = mergeConfig(config);
+    /* v8 ignore start */
+    const prefixes = mergedConfig.branchPrefix ?? DEFAULT_BRANCH_PREFIXES;
+    const prefix = prefixes[spec.type] ?? 'feat';
+    /* v8 ignore end */
+    const slug = slugify(spec.title);
+    const branchName = `${prefix}/${specId}-${slug}`;
+    // Check if branch already exists
+    try {
+        const { stdout } = await git(projectPath, ['branch', '--list', branchName]);
+        if (stdout.trim().length > 0) {
+            await git(projectPath, ['checkout', branchName]);
+            const result = {
+                action: 'create-branch',
+                branchName,
+                message: `Switched to existing branch '${branchName}'`,
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+    }
+    catch {
+        // branch list failed — proceed with creation
+    }
+    await git(projectPath, ['checkout', '-b', branchName]);
+    await specStore.updateSpec(projectId, specId, { gitBranch: branchName });
+    const result = {
+        action: 'create-branch',
+        branchName,
+        message: ti('tools.manage_git.success', { action: 'create-branch' }),
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+}
+export async function handleCheckBranch(projectId, _specId, config) {
+    const projectPath = await resolveProjectPath(projectId);
+    const { stdout: currentBranch } = await git(projectPath, ['rev-parse', '--abbrev-ref', 'HEAD']);
+    const branch = currentBranch.trim();
+    const mergedConfig = mergeConfig(config);
+    /* v8 ignore start */
+    const protectedBranches = mergedConfig.protectedBranches ?? DEFAULT_PROTECTED_BRANCHES;
+    /* v8 ignore end */
+    const isProtected = protectedBranches.includes(branch);
+    const conventionPattern = /^(feat|fix|refactor|infra|docs|project)\/SPEC-\d{3}-/;
+    const followsConvention = conventionPattern.test(branch);
+    const specIdMatch = /SPEC-\d{3}/.exec(branch);
+    const branchSpecId = specIdMatch ? specIdMatch[0] : null;
+    let specExists = false;
+    if (branchSpecId) {
+        const spec = await specStore.getSpec(projectId, branchSpecId);
+        specExists = spec !== null;
+    }
+    const issues = [];
+    if (isProtected) {
+        issues.push(`Currently on protected branch '${branch}'. Create a feature branch for changes.`);
+    }
+    if (!followsConvention && !isProtected) {
+        issues.push(`Branch '${branch}' does not follow SpecForge naming convention: <type>/SPEC-XXX-<slug>`);
+    }
+    if (branchSpecId && !specExists) {
+        issues.push(`Spec '${branchSpecId}' referenced in branch name not found in project.`);
+    }
+    const result = {
+        action: 'check-branch',
+        branchName: branch,
+        isProtected,
+        followsConvention,
+        linkedSpecId: branchSpecId,
+        specExists,
+        issues,
+        message: issues.length === 0
+            ? `Branch '${branch}' is valid`
+            : `Branch '${branch}' has ${issues.length} issue(s)`,
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+}
+//# sourceMappingURL=branch-ops.js.map