specforge-mcp 0.1.0

package/dist/tools/summarize-spec.test.js

@@ -0,0 +1,180 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('../i18n/index.js', () => ({
+    ti: vi.fn((_key, params) => `translated:${JSON.stringify(params)}`),
+}));
+vi.mock('../storage/index.js', () => ({
+    specStore: {
+        getSpec: vi.fn(),
+    },
+}));
+vi.mock('node:fs/promises', () => ({
+    readFile: vi.fn(),
+}));
+import { handleSummarizeSpec } from './summarize-spec.js';
+import { specStore } from '../storage/index.js';
+import { readFile } from 'node:fs/promises';
+const makeSpec = (overrides = {}) => ({
+    id: 'SPEC-001',
+    title: 'User Auth',
+    type: 'feature',
+    scope: 'feature',
+    status: 'draft',
+    difficulty: 3,
+    risk: 'medium',
+    target: 'fullstack',
+    tags: ['auth'],
+    gitBranch: 'feat/spec-001-user-auth',
+    huPath: '/test/docs/SPEC-001/HU.md',
+    fichaTecnicaPath: '/test/docs/SPEC-001/FICHA-TECNICA.md',
+    estimation: {
+        devHours: 8,
+        reviewHours: 2,
+        recommendedModel: 'sonnet',
+        tokensOpus: 5000,
+        tokensSonnet: 10000,
+        apiCostUsd: 1.5,
+        humanCostUsd: 500,
+        totalCostUsd: 501.5,
+        tokenOptimization: { mode: 'local' },
+    },
+    actuals: null,
+    dependencies: ['SPEC-002'],
+    blockedBy: [],
+    impactAnalysis: { affectedModules: ['auth', 'users'] },
+    ...overrides,
+});
+beforeEach(() => {
+    vi.clearAllMocks();
+    vi.mocked(readFile).mockRejectedValue(new Error('not found'));
+});
+describe('handleSummarizeSpec', () => {
+    it('should return error when spec not found', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(null);
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-999',
+            projectId: 'proj-123',
+        });
+        expect(result.isError).toBe(true);
+    });
+    it('should return technical format by default', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        expect(result.isError).toBeUndefined();
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.format).toBe('technical');
+        expect(parsed.specId).toBe('SPEC-001');
+        expect(parsed.spec).toBeDefined();
+        expect(parsed.estimation).toBeDefined();
+        expect(parsed.files).toBeDefined();
+    });
+    it('should return oneliner format', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            format: 'oneliner',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.format).toBe('oneliner');
+        expect(parsed.summary).toBeDefined();
+        expect(parsed.cost).toContain('$');
+    });
+    it('should return executive format', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            format: 'executive',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.format).toBe('executive');
+        expect(parsed.keyRisks).toBeDefined();
+        expect(parsed.timeline).toBeDefined();
+        expect(parsed.recommendation).toBe('Ready for review');
+    });
+    it('should handle high risk and high difficulty in risk highlights', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ risk: 'high', difficulty: 4, scope: 'architectural', blockedBy: ['SPEC-003'] }));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.riskHighlights.some((r) => r.includes('high'))).toBe(true);
+        expect(parsed.riskHighlights.some((r) => r.includes('difficulty'))).toBe(true);
+        expect(parsed.riskHighlights.some((r) => r.includes('Architectural'))).toBe(true);
+    });
+    it('should extract key decisions from ficha content', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        vi.mocked(readFile).mockImplementation(((path) => {
+            if (path.includes('FICHA-TECNICA')) {
+                return Promise.resolve('## Technical Notes\nUse JWT tokens for auth sessions and verification.\n\n## Decision Log\nDecided to use bcrypt for password hashing because of security.');
+            }
+            if (path.includes('HU')) {
+                return Promise.resolve('## Description\nUser story for auth.');
+            }
+            return Promise.reject(new Error('not found'));
+        }));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.keyDecisions.length).toBeGreaterThan(0);
+    });
+    it('should handle executive format with approved status', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ status: 'approved' }));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            format: 'executive',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.recommendation).toBe('Ready for implementation');
+    });
+    it('should return empty oneLiner for null spec', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(null);
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-999',
+            projectId: 'proj-123',
+            format: 'oneliner',
+        });
+        // When spec is not found, an error is returned before oneliner is built
+        expect(result.isError).toBe(true);
+    });
+    it('should highlight cross-module scope risk', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ scope: 'cross-module', risk: 'low', difficulty: 2, blockedBy: [], dependencies: [] }));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.riskHighlights.some((r) => r.includes('Cross-module'))).toBe(true);
+    });
+    it('should show no-risks fallback when no risks identified', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({
+            risk: 'low',
+            difficulty: 2,
+            scope: 'feature',
+            blockedBy: [],
+            dependencies: [],
+        }));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.riskHighlights.some((r) => r.includes('No significant risks'))).toBe(true);
+    });
+    it('should handle errors gracefully', async () => {
+        vi.mocked(specStore.getSpec).mockRejectedValue(new Error('DB error'));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        expect(result.isError).toBe(true);
+    });
+});
+//# sourceMappingURL=summarize-spec.test.js.map

package/dist/tools/summarize-spec.test.js.map

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

package/dist/tools/update-status.d.ts

@@ -0,0 +1,3 @@
+import type { UpdateStatusInput, ToolResult } from '../types/index.js';
+export declare function handleUpdateStatus(params: UpdateStatusInput): Promise<ToolResult>;
+//# sourceMappingURL=update-status.d.ts.map

package/dist/tools/update-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-status.d.ts","sourceRoot":"","sources":["../../src/tools/update-status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAA2B,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAsBhG,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuMvF"}

package/dist/tools/update-status.js

@@ -0,0 +1,189 @@
+import { ti } from '../i18n/index.js';
+import { specStore, metricsStore } from '../storage/index.js';
+import { calculateAccuracy } from '../engine/estimator.js';
+import { validateDoR, validateDoD } from '../engine/dor-dod.js';
+import { cascadeCheck } from '../engine/spec-versioner.js';
+import { dispatchFeedbackEvent } from './learn.js';
+import { handleCreateBranch } from './git/branch-ops.js';
+/**
+ * Valid state transitions for spec lifecycle.
+ * draft -> review -> approved -> implementing -> done
+ * Also allow: review -> draft (send back), approved -> review (reconsider)
+ */
+const VALID_TRANSITIONS = {
+    draft: ['review'],
+    review: ['draft', 'approved'],
+    approved: ['review', 'implementing'],
+    implementing: ['approved', 'done'],
+    done: [], // terminal state
+};
+export async function handleUpdateStatus(params) {
+    const { specId, projectId, status: newStatus, actuals, autoCreateBranch } = params;
+    try {
+        // Get the current spec
+        const spec = await specStore.getSpec(projectId, specId);
+        if (!spec) {
+            return {
+                content: [{ type: 'text', text: ti('spec.notFound', { id: specId }) }],
+                isError: true,
+            };
+        }
+        const currentStatus = spec.status;
+        // Validate state transition
+        const validNextStates = VALID_TRANSITIONS[currentStatus];
+        if (!validNextStates.includes(newStatus)) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: ti('spec.invalidTransition', {
+                            from: currentStatus,
+                            to: newStatus,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Gate: DoR must pass before transitioning to 'implementing'
+        if (newStatus === 'implementing') {
+            const dorResult = validateDoR(spec);
+            if (!dorResult.isValid) {
+                // SPEC-012: Record failed DoR items for auto-improvement loop
+                void dispatchFeedbackEvent(projectId, {
+                    type: 'checklist',
+                    specId,
+                    input: { gate: 'dor', specType: spec.type },
+                    outcome: { passed: false, failedItems: dorResult.blockingItems },
+                    delta: { failedCount: dorResult.blockingItems.length },
+                    timestamp: new Date().toISOString(),
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'DoR gate failed',
+                                message: dorResult.humanMessage,
+                                expertSummary: dorResult.expertSummary,
+                                blockingItems: dorResult.blockingItems,
+                                warningItems: dorResult.warningItems,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        // Gate: DoD must pass before transitioning to 'done'
+        if (newStatus === 'done') {
+            const dodResult = validateDoD(spec);
+            if (!dodResult.isValid) {
+                // SPEC-012: Record failed DoD items for auto-improvement loop
+                void dispatchFeedbackEvent(projectId, {
+                    type: 'checklist',
+                    specId,
+                    input: { gate: 'dod', specType: spec.type },
+                    outcome: { passed: false, failedItems: dodResult.blockingItems },
+                    delta: { failedCount: dodResult.blockingItems.length },
+                    timestamp: new Date().toISOString(),
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'DoD gate failed',
+                                message: dodResult.humanMessage,
+                                expertSummary: dodResult.expertSummary,
+                                blockingItems: dodResult.blockingItems,
+                                warningItems: dodResult.warningItems,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        // Auto-create branch when transitioning to 'implementing' if requested
+        let autoBranchResult;
+        if (newStatus === 'implementing' && autoCreateBranch) {
+            const foundSpec = await specStore.getSpec(projectId, specId);
+            if (foundSpec && !foundSpec.gitBranch) {
+                const branchResult = await handleCreateBranch(projectId, specId);
+                if (!branchResult.isError) {
+                    try {
+                        const branchData = JSON.parse(branchResult.content[0]?.text ?? '{}');
+                        autoBranchResult = branchData.branchName;
+                    }
+                    catch {
+                        // ignore parse error
+                    }
+                }
+            }
+        }
+        // If transitioning to 'done', actuals are required
+        if (newStatus === 'done' && !actuals) {
+            return {
+                content: [{ type: 'text', text: ti('spec.actualsRequired', {}) }],
+                isError: true,
+            };
+        }
+        // Build the update
+        const updates = {
+            status: newStatus,
+        };
+        // If actuals are provided, save them
+        if (actuals) {
+            updates.actuals = actuals;
+        }
+        // Update the spec
+        const updatedSpec = await specStore.updateSpec(projectId, specId, updates);
+        // If spec is done and has actuals, record metrics
+        if (newStatus === 'done' && actuals) {
+            const accuracyScore = calculateAccuracy(spec.estimation, actuals.devHours + actuals.reviewHours);
+            const metricEntry = {
+                specId,
+                difficulty: spec.difficulty,
+                estimated: spec.estimation,
+                actual: actuals,
+                accuracyScore,
+            };
+            await metricsStore.addMetricEntry(projectId, metricEntry);
+        }
+        // Cascade check: notify downstream specs of the status change
+        const allSpecs = await specStore.listSpecs(projectId);
+        const cascadeResult = cascadeCheck(specId, allSpecs, newStatus);
+        const result = {
+            specId,
+            projectId,
+            previousStatus: currentStatus,
+            newStatus,
+            actuals: actuals ?? null,
+            autoBranch: autoBranchResult ?? null,
+            cascade: cascadeResult,
+            metrics: newStatus === 'done' && actuals
+                ? {
+                    accuracyScore: calculateAccuracy(spec.estimation, actuals.devHours + actuals.reviewHours),
+                    estimatedHours: spec.estimation.devHours + spec.estimation.reviewHours,
+                    actualHours: actuals.devHours + actuals.reviewHours,
+                    estimatedCost: spec.estimation.totalCostUsd,
+                    actualCost: actuals.totalCostUsd,
+                }
+                : null,
+            updatedAt: updatedSpec.updatedAt,
+            message: ti('tools.update_status.success', { specId, status: newStatus }),
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: ti('errors.internalError', { message }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=update-status.js.map

package/dist/tools/update-status.js.map

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

package/dist/tools/update-status.test.d.ts

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

package/dist/tools/update-status.test.d.ts.map

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

package/dist/tools/update-status.test.js

@@ -0,0 +1,142 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('../i18n/index.js', () => ({
+    ti: vi.fn((_key, params) => `translated:${JSON.stringify(params)}`),
+}));
+vi.mock('../storage/index.js', () => ({
+    specStore: {
+        getSpec: vi.fn(),
+        updateSpec: vi.fn(),
+    },
+    metricsStore: {
+        addMetricEntry: vi.fn(),
+    },
+}));
+vi.mock('../engine/estimator.js', () => ({
+    calculateAccuracy: vi.fn(),
+}));
+import { handleUpdateStatus } from './update-status.js';
+import { specStore, metricsStore } from '../storage/index.js';
+import { calculateAccuracy } from '../engine/estimator.js';
+const makeSpec = (overrides = {}) => ({
+    id: 'SPEC-001',
+    title: 'Test Spec',
+    status: 'draft',
+    difficulty: 3,
+    estimation: {
+        devHours: 8,
+        reviewHours: 2,
+        totalCostUsd: 500,
+        recommendedModel: 'sonnet',
+        tokenOptimization: { mode: 'local' },
+    },
+    actuals: null,
+    ...overrides,
+});
+const makeActuals = () => ({
+    devHours: 10,
+    reviewHours: 3,
+    tokensOpus: 5000,
+    tokensSonnet: 10000,
+    apiCostUsd: 2.0,
+    humanCostUsd: 650,
+    totalCostUsd: 652,
+    completedAt: '2024-01-15',
+    notes: 'Done',
+});
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+describe('handleUpdateStatus', () => {
+    it('should return error when spec not found', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(null);
+        const result = await handleUpdateStatus({
+            specId: 'SPEC-999',
+            projectId: 'proj-123',
+            status: 'review',
+        });
+        expect(result.isError).toBe(true);
+    });
+    it('should transition draft to review', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ status: 'draft' }));
+        vi.mocked(specStore.updateSpec).mockResolvedValue({ ...makeSpec({ status: 'review' }), updatedAt: '2024-01-10' });
+        const result = await handleUpdateStatus({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            status: 'review',
+        });
+        expect(result.isError).toBeUndefined();
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.previousStatus).toBe('draft');
+        expect(parsed.newStatus).toBe('review');
+    });
+    it('should reject invalid transition draft to done', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ status: 'draft' }));
+        const result = await handleUpdateStatus({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            status: 'done',
+        });
+        expect(result.isError).toBe(true);
+    });
+    it('should reject transition from done', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ status: 'done' }));
+        const result = await handleUpdateStatus({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            status: 'draft',
+        });
+        expect(result.isError).toBe(true);
+    });
+    it('should require actuals when transitioning to done', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ status: 'implementing' }));
+        const result = await handleUpdateStatus({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            status: 'done',
+        });
+        expect(result.isError).toBe(true);
+    });
+    it('should transition to done with actuals and record metrics', async () => {
+        const actuals = makeActuals();
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ status: 'implementing' }));
+        vi.mocked(specStore.updateSpec).mockResolvedValue({
+            ...makeSpec({ status: 'done', actuals }),
+            updatedAt: '2024-01-15',
+        });
+        vi.mocked(calculateAccuracy).mockReturnValue(0.85);
+        vi.mocked(metricsStore.addMetricEntry).mockResolvedValue(undefined);
+        const result = await handleUpdateStatus({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            status: 'done',
+            actuals: actuals,
+        });
+        expect(result.isError).toBeUndefined();
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.newStatus).toBe('done');
+        expect(parsed.actuals).toBeDefined();
+        expect(parsed.metrics).toBeDefined();
+        expect(parsed.metrics.accuracyScore).toBe(0.85);
+        expect(metricsStore.addMetricEntry).toHaveBeenCalled();
+    });
+    it('should allow review to draft (send back)', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ status: 'review' }));
+        vi.mocked(specStore.updateSpec).mockResolvedValue({ ...makeSpec({ status: 'draft' }), updatedAt: '2024-01-10' });
+        const result = await handleUpdateStatus({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            status: 'draft',
+        });
+        expect(result.isError).toBeUndefined();
+    });
+    it('should handle errors gracefully', async () => {
+        vi.mocked(specStore.getSpec).mockRejectedValue(new Error('DB error'));
+        const result = await handleUpdateStatus({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            status: 'review',
+        });
+        expect(result.isError).toBe(true);
+    });
+});
+//# sourceMappingURL=update-status.test.js.map

package/dist/tools/update-status.test.js.map

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

package/dist/tools/validate-workflow.d.ts

@@ -0,0 +1,3 @@
+import type { ValidateWorkflowInput, ToolResult } from '../types/index.js';
+export declare function handleValidateWorkflow(args: ValidateWorkflowInput): Promise<ToolResult>;
+//# sourceMappingURL=validate-workflow.d.ts.map

package/dist/tools/validate-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-workflow.d.ts","sourceRoot":"","sources":["../../src/tools/validate-workflow.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAmB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgC5F,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyD7F"}

package/dist/tools/validate-workflow.js

@@ -0,0 +1,77 @@
+// tools/validate-workflow.ts — SPEC-053 MCP tool handler
+// Actions: suggest-model | check-git-flow | check-mcp-conventions | check-worktree | full-audit
+import { join } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { validateGitFlow, auditMcpConventions, suggestModel, suggestModelFromRules, getModelRulesFromCatalog, validateWorktreeBase, validateIntegrationReadiness, } from '../engine/workflow-validator.js';
+let catalogCache = null;
+async function loadCatalog() {
+    if (catalogCache) {
+        return catalogCache;
+    }
+    try {
+        const configPath = new URL('../config/workflow-conventions-catalog.json', import.meta.url);
+        const raw = await readFile(configPath, 'utf-8');
+        catalogCache = JSON.parse(raw);
+        return catalogCache;
+    }
+    catch {
+        /* v8 ignore next -- catalog always bundled */
+        return null;
+    }
+}
+function text(content) {
+    return { content: [{ type: 'text', text: JSON.stringify(content, null, 2) }] };
+}
+export async function handleValidateWorkflow(args) {
+    const projectPath = args.projectPath ?? process.cwd();
+    switch (args.action) {
+        case 'suggest-model': {
+            const taskDesc = args.taskDescription ?? '';
+            const catalog = await loadCatalog();
+            let result;
+            /* v8 ignore start */
+            if (!catalog) {
+                result = suggestModel(taskDesc);
+            }
+            else {
+                /* v8 ignore stop */
+                const rules = getModelRulesFromCatalog(catalog);
+                result = suggestModelFromRules(taskDesc, rules);
+            }
+            return text(result);
+        }
+        case 'check-git-flow': {
+            const result = validateGitFlow(projectPath);
+            const summary = result.valid
+                ? 'Git flow is clean — no violations detected.'
+                : `${result.violations.length} violation(s) found. Review suggestions for each.`;
+            return text({ ...result, summary });
+        }
+        case 'check-mcp-conventions': {
+            const toolsDir = args.toolsDir ?? join(projectPath, 'src/tools');
+            const result = await auditMcpConventions(toolsDir);
+            const summary = result.violations.length === 0
+                ? `All ${result.totalChecked} tool file(s) comply with MCP conventions.`
+                : `${result.violations.length} violation(s) across ${result.totalChecked} tool file(s).`;
+            return text({ ...result, summary });
+        }
+        case 'check-worktree': {
+            const worktreePath = args.worktreePath ?? projectPath;
+            const result = validateWorktreeBase(worktreePath);
+            return text(result);
+        }
+        case 'full-audit': {
+            const toolsDir = args.toolsDir ?? join(projectPath, 'src/tools');
+            const gitFlow = validateGitFlow(projectPath);
+            const worktree = validateWorktreeBase(projectPath);
+            const integration = validateIntegrationReadiness(projectPath);
+            const mcpAudit = await auditMcpConventions(toolsDir);
+            const allClear = gitFlow.valid && worktree.valid && integration.ready && mcpAudit.violations.length === 0;
+            const summary = allClear
+                ? 'All workflow checks passed — ready to commit.'
+                : 'One or more workflow checks failed. Review the results below.';
+            return text({ allClear, summary, gitFlow, worktree, integration, mcpAudit });
+        }
+    }
+}
+//# sourceMappingURL=validate-workflow.js.map