@planu/cli 0.15.2

package/dist/tools/generate-tests/generators/visual-regression-generator.js

@@ -0,0 +1,304 @@
+// tools/generate-tests/generators/visual-regression-generator.ts — SPEC-058a Section C
+// Generates visual regression and frontend screenshot test scaffolds.
+const UI_FRAMEWORKS = [
+    'react',
+    'vue',
+    'angular',
+    'svelte',
+    'next',
+    'nextjs',
+    'next.js',
+    'nuxt',
+    'sveltekit',
+    'svelte-kit',
+    'solid',
+    'solidjs',
+    'preact',
+    'qwik',
+    'remix',
+    'gatsby',
+    'astro',
+];
+const DARK_MODE_SIGNALS = [
+    'tailwind',
+    'shadcn',
+    'radix',
+    'mui',
+    'chakra',
+    'mantine',
+    'daisy',
+    'daisyui',
+    'styled-components',
+    'emotion',
+];
+const BP_MOBILE = { label: 'mobile', width: 375, height: 812 };
+const BP_TABLET = { label: 'tablet', width: 768, height: 1024 };
+const BP_DESKTOP = { label: 'desktop', width: 1280, height: 800 };
+/**
+ * Returns true when the project has at least one frontend/fullstack app with a UI framework.
+ */
+export function isVisualRegressionProject(knowledge) {
+    const frontendApps = knowledge.apps.filter((app) => app.type === 'frontend');
+    for (const app of frontendApps) {
+        const fw = (app.framework ?? '').toLowerCase();
+        if (UI_FRAMEWORKS.some((uif) => fw.includes(uif))) {
+            return true;
+        }
+    }
+    // Fall back to top-level framework when no frontend apps matched
+    if (frontendApps.length === 0) {
+        const topFw = (knowledge.framework ?? '').toLowerCase();
+        return UI_FRAMEWORKS.some((uif) => topFw.includes(uif));
+    }
+    return false;
+}
+function hasDarkModeSupport(knowledge) {
+    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
+    return DARK_MODE_SIGNALS.some((sig) => stackLower.some((s) => s.includes(sig)));
+}
+/**
+ * Generate visual regression test definitions.
+ */
+export function generateVisualRegressionTestDefs(title, testDir, _testExt) {
+    const defs = [
+        {
+            name: `${title} — Visual: screenshot baseline matches approved snapshot`,
+            type: 'e2e',
+            file: `${testDir}/visual/`,
+            description: 'Capture full-page screenshot and compare against approved baseline snapshot — fails on unexpected visual changes',
+            priority: 'critical',
+            automatable: true,
+        },
+        {
+            name: `${title} — Visual: responsive layout at 375px, 768px, 1280px`,
+            type: 'e2e',
+            file: `${testDir}/visual/`,
+            description: 'Verify layout integrity across mobile (375px), tablet (768px), and desktop (1280px) breakpoints',
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — Visual: component renders without layout shift`,
+            type: 'unit',
+            file: `${testDir}/visual/`,
+            description: 'Component snapshot test — verify no unintended style or markup changes in isolated render',
+            priority: 'medium',
+            automatable: true,
+        },
+    ];
+    // Dark mode def added unconditionally — caller controls knowledge, but we always include it
+    // since isVisualRegressionProject already filtered for UI projects that commonly support dark mode
+    defs.push({
+        name: `${title} — Visual: dark mode toggle does not break layout`,
+        type: 'e2e',
+        file: `${testDir}/visual/`,
+        description: 'Toggle dark/light mode and verify screenshot matches approved dark-mode snapshot without overflow or invisible text',
+        priority: 'medium',
+        automatable: true,
+    });
+    return defs;
+}
+// === Language-specific content generators ===
+function generatePlaywrightTest(title, slug) {
+    return `// Visual regression tests for ${title}
+// Requires: @playwright/test with --update-snapshots for initial baseline
+import { test, expect } from '@playwright/test';
+
+const BASE_URL = process.env.BASE_URL ?? 'http://localhost:3000';
+
+test.describe('${title} — Visual Regression', () => {
+  test('full-page screenshot matches baseline', async ({ page }) => {
+    await page.goto(BASE_URL);
+    await page.waitForLoadState('networkidle');
+    await expect(page).toHaveScreenshot('${slug}-baseline.png', {
+      fullPage: true,
+      maxDiffPixelRatio: 0.02,
+    });
+  });
+
+  test('responsive — mobile 375px', async ({ page }) => {
+    await page.setViewportSize({ width: ${BP_MOBILE.width}, height: ${BP_MOBILE.height} });
+    await page.goto(BASE_URL);
+    await page.waitForLoadState('networkidle');
+    await expect(page).toHaveScreenshot('${slug}-mobile.png', {
+      maxDiffPixelRatio: 0.02,
+    });
+  });
+
+  test('responsive — tablet 768px', async ({ page }) => {
+    await page.setViewportSize({ width: ${BP_TABLET.width}, height: ${BP_TABLET.height} });
+    await page.goto(BASE_URL);
+    await page.waitForLoadState('networkidle');
+    await expect(page).toHaveScreenshot('${slug}-tablet.png', {
+      maxDiffPixelRatio: 0.02,
+    });
+  });
+
+  test('responsive — desktop 1280px', async ({ page }) => {
+    await page.setViewportSize({ width: ${BP_DESKTOP.width}, height: ${BP_DESKTOP.height} });
+    await page.goto(BASE_URL);
+    await page.waitForLoadState('networkidle');
+    await expect(page).toHaveScreenshot('${slug}-desktop.png', {
+      maxDiffPixelRatio: 0.02,
+    });
+  });
+
+  test('component renders without layout shift', async ({ page }) => {
+    await page.goto(\`\${BASE_URL}/components\`);
+    // TODO: navigate to your component preview/Storybook URL
+    await page.waitForLoadState('networkidle');
+    await expect(page).toHaveScreenshot('${slug}-component.png');
+  });
+
+  test('dark mode toggle does not break layout', async ({ page }) => {
+    await page.goto(BASE_URL);
+    await page.waitForLoadState('networkidle');
+    // TODO: adjust selector to match your dark mode toggle
+    await page.click('[data-testid="theme-toggle"], button[aria-label*="dark"], button[aria-label*="theme"]');
+    await page.waitForTimeout(300); // allow CSS transition
+    await expect(page).toHaveScreenshot('${slug}-dark-mode.png', {
+      maxDiffPixelRatio: 0.02,
+    });
+  });
+});
+`;
+}
+function generatePytestPlaywrightTest(title, slug) {
+    const pySlug = slug.replace(/-/g, '_');
+    return `"""Visual regression tests for ${title} — pytest-playwright."""
+# Requires: pytest-playwright + pytest-playwright-snapshot
+# Install: pip install pytest-playwright playwright-pytest-snapshot
+# Run: pytest --update-snapshots (first time to create baseline)
+import pytest
+from playwright.sync_api import Page, expect
+
+
+BASE_URL = "http://localhost:3000"
+
+
+@pytest.fixture(scope="session")
+def base_url() -> str:
+    import os
+    return os.environ.get("BASE_URL", BASE_URL)
+
+
+def test_${pySlug}_full_page_screenshot(page: Page, base_url: str, assert_snapshot: object) -> None:
+    """Full-page screenshot matches approved baseline."""
+    page.goto(base_url)
+    page.wait_for_load_state("networkidle")
+    assert_snapshot(page.screenshot(full_page=True), name="${slug}-baseline.png")
+
+
+def test_${pySlug}_responsive_mobile(page: Page, base_url: str, assert_snapshot: object) -> None:
+    """Layout intact at 375px (mobile)."""
+    page.set_viewport_size({"width": ${BP_MOBILE.width}, "height": ${BP_MOBILE.height}})
+    page.goto(base_url)
+    page.wait_for_load_state("networkidle")
+    assert_snapshot(page.screenshot(), name="${slug}-mobile.png")
+
+
+def test_${pySlug}_responsive_tablet(page: Page, base_url: str, assert_snapshot: object) -> None:
+    """Layout intact at 768px (tablet)."""
+    page.set_viewport_size({"width": ${BP_TABLET.width}, "height": ${BP_TABLET.height}})
+    page.goto(base_url)
+    page.wait_for_load_state("networkidle")
+    assert_snapshot(page.screenshot(), name="${slug}-tablet.png")
+
+
+def test_${pySlug}_responsive_desktop(page: Page, base_url: str, assert_snapshot: object) -> None:
+    """Layout intact at 1280px (desktop)."""
+    page.set_viewport_size({"width": ${BP_DESKTOP.width}, "height": ${BP_DESKTOP.height}})
+    page.goto(base_url)
+    page.wait_for_load_state("networkidle")
+    assert_snapshot(page.screenshot(), name="${slug}-desktop.png")
+
+
+def test_${pySlug}_dark_mode(page: Page, base_url: str, assert_snapshot: object) -> None:
+    """Dark mode toggle does not break layout."""
+    page.goto(base_url)
+    page.wait_for_load_state("networkidle")
+    # TODO: adjust selector to match your dark mode toggle
+    page.click('[data-testid="theme-toggle"]')
+    page.wait_for_timeout(300)
+    assert_snapshot(page.screenshot(), name="${slug}-dark-mode.png")
+`;
+}
+function generateCypressVisualTest(title, slug) {
+    return `// Visual regression tests for ${title} — Cypress + cypress-image-snapshot
+// Install: npm install --save-dev cypress-image-snapshot
+// Config: import 'cypress-image-snapshot/command' in cypress/support/commands.ts
+describe('${title} — Visual Regression', () => {
+  const BASE_URL = Cypress.env('BASE_URL') ?? 'http://localhost:3000';
+
+  it('full-page screenshot matches baseline', () => {
+    cy.visit(BASE_URL);
+    cy.matchImageSnapshot('${slug}-baseline', { failureThreshold: 0.02 });
+  });
+
+  it('responsive — mobile 375px', () => {
+    cy.viewport(${BP_MOBILE.width}, ${BP_MOBILE.height});
+    cy.visit(BASE_URL);
+    cy.matchImageSnapshot('${slug}-mobile', { failureThreshold: 0.02 });
+  });
+
+  it('responsive — tablet 768px', () => {
+    cy.viewport(${BP_TABLET.width}, ${BP_TABLET.height});
+    cy.visit(BASE_URL);
+    cy.matchImageSnapshot('${slug}-tablet', { failureThreshold: 0.02 });
+  });
+
+  it('responsive — desktop 1280px', () => {
+    cy.viewport(${BP_DESKTOP.width}, ${BP_DESKTOP.height});
+    cy.visit(BASE_URL);
+    cy.matchImageSnapshot('${slug}-desktop', { failureThreshold: 0.02 });
+  });
+
+  it('dark mode toggle does not break layout', () => {
+    cy.visit(BASE_URL);
+    // TODO: adjust selector to match your dark mode toggle
+    cy.get('[data-testid="theme-toggle"]').click();
+    cy.wait(300); // allow CSS transition
+    cy.matchImageSnapshot('${slug}-dark-mode', { failureThreshold: 0.02 });
+  });
+});
+`;
+}
+function generateVisualTestContent(title, slug, framework, language) {
+    if (language === 'python') {
+        return generatePytestPlaywrightTest(title, slug);
+    }
+    if (framework === 'cypress') {
+        return generateCypressVisualTest(title, slug);
+    }
+    return generatePlaywrightTest(title, slug);
+}
+function getFileExtension(language) {
+    const exts = {
+        python: 'py',
+        go: 'go',
+        ruby: 'rb',
+        java: 'java',
+        javascript: 'test.ts',
+        typescript: 'test.ts',
+    };
+    return exts[language] ?? 'test.ts';
+}
+/**
+ * Generate visual regression test files for the given spec.
+ */
+export function generateVisualRegressionTestFiles(spec, testDir, framework, language, testExt, autoGenerate) {
+    const ext = language === 'python' ? 'py' : getFileExtension(language);
+    const resolvedFramework = framework === 'cypress' ? 'cypress' : 'playwright';
+    const content = generateVisualTestContent(spec.title, spec.slug, framework, language);
+    return [
+        {
+            path: `${testDir}/visual/${spec.slug}.visual.${ext === 'test.ts' ? testExt : ext}`,
+            framework: resolvedFramework,
+            content,
+            ready: autoGenerate,
+        },
+    ];
+}
+// Re-export for dark mode detection utility (used in spec-dispatcher if needed)
+export { hasDarkModeSupport };
+//# sourceMappingURL=visual-regression-generator.js.map

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

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

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

@@ -0,0 +1,17 @@
+import type { TestDefinition, TestFile, ProjectKnowledge } from '../../../types/index.js';
+/**
+ * Returns true when the project uses WebSocket technology.
+ */
+export declare function isWebSocketProject(knowledge: ProjectKnowledge): boolean;
+/**
+ * Generate WebSocket test definitions.
+ */
+export declare function generateWebSocketTestDefs(title: string, testDir: string, _testExt: string): TestDefinition[];
+/**
+ * Generate WebSocket test file scaffolds for the target language.
+ */
+export declare function generateWebSocketTestFiles(spec: {
+    title: string;
+    slug: string;
+}, testDir: string, framework: string, language: string, testExt: string, autoGenerate: boolean): TestFile[];
+//# sourceMappingURL=websocket-test-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-test-generator.d.ts","sourceRoot":"","sources":["../../../../src/tools/generate-tests/generators/websocket-test-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgB1F;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAGvE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,cAAc,EAAE,CA2ClB;AA+JD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,OAAO,GACpB,QAAQ,EAAE,CAgBZ"}

package/dist/tools/generate-tests/generators/websocket-test-generator.js

@@ -0,0 +1,243 @@
+// tools/generate-tests/generators/websocket-test-generator.ts — SPEC-058a Section D
+// Generates WebSocket test scaffolds: connection lifecycle, reconnection, ordering, heartbeat.
+const WS_SIGNALS = [
+    'ws',
+    'socket.io',
+    'socketio',
+    'signalr',
+    'websocket',
+    'sockjs',
+    'phoenix-channels',
+    'phoenix',
+    'actioncable',
+    'pusher',
+    'ably',
+];
+/**
+ * Returns true when the project uses WebSocket technology.
+ */
+export function isWebSocketProject(knowledge) {
+    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
+    return WS_SIGNALS.some((sig) => stackLower.some((s) => s.includes(sig)));
+}
+/**
+ * Generate WebSocket test definitions.
+ */
+export function generateWebSocketTestDefs(title, testDir, _testExt) {
+    return [
+        {
+            name: `${title} — WebSocket: connection lifecycle (open/close/error)`,
+            type: 'integration',
+            file: `${testDir}/websocket/`,
+            description: 'Verify WebSocket connection opens, exchanges messages, and closes cleanly',
+            priority: 'critical',
+            automatable: true,
+        },
+        {
+            name: `${title} — WebSocket: reconnection with backoff`,
+            type: 'integration',
+            file: `${testDir}/websocket/`,
+            description: 'Verify client reconnects with exponential backoff after unexpected disconnect',
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — WebSocket: message ordering guarantee`,
+            type: 'integration',
+            file: `${testDir}/websocket/`,
+            description: 'Send N messages sequentially and verify they arrive in FIFO order',
+            priority: 'high',
+            automatable: true,
+        },
+        {
+            name: `${title} — WebSocket: heartbeat/ping-pong keeps connection alive`,
+            type: 'integration',
+            file: `${testDir}/websocket/`,
+            description: 'Verify ping/pong mechanism keeps the connection alive beyond idle timeout',
+            priority: 'medium',
+            automatable: true,
+        },
+        {
+            name: `${title} — WebSocket: auth rejection on invalid token`,
+            type: 'integration',
+            file: `${testDir}/websocket/`,
+            description: 'Verify connection is rejected or closed when an invalid auth token is provided',
+            priority: 'critical',
+            automatable: true,
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Content generators
+// ---------------------------------------------------------------------------
+function buildTsWebSocketTest(title) {
+    return `// WebSocket tests for: ${title}
+// Generated by Planu SDD MCP Server (SPEC-058a)
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+// import WebSocket from 'ws';
+
+const WS_URL = process.env['WS_URL'] ?? 'ws://localhost:3000';
+
+describe('${title} — WebSocket Tests', () => {
+  // let ws: WebSocket;
+
+  beforeAll(() => {
+    // ws = new WebSocket(WS_URL);
+  });
+
+  afterAll(() => {
+    // ws?.close();
+  });
+
+  describe('Connection lifecycle', () => {
+    it('opens connection successfully', async () => {
+      // await new Promise<void>((resolve, reject) => {
+      //   ws.on('open', resolve);
+      //   ws.on('error', reject);
+      // });
+      // expect(ws.readyState).toBe(WebSocket.OPEN);
+      expect(true).toBe(true); // Replace with real connection assertion
+    });
+
+    it('closes connection cleanly', async () => {
+      // ws.close(1000, 'Normal closure');
+      // await new Promise<void>((resolve) => ws.on('close', resolve));
+      // expect(ws.readyState).toBe(WebSocket.CLOSED);
+      expect(true).toBe(true); // Replace with real close assertion
+    });
+  });
+
+  describe('Reconnection', () => {
+    it('reconnects with exponential backoff after disconnect', async () => {
+      // Simulate abrupt disconnect and verify reconnection attempt
+      // const attempts: number[] = [];
+      // client.on('reconnect_attempt', (n) => attempts.push(n));
+      // await simulateDisconnect();
+      // expect(attempts.length).toBeGreaterThan(0);
+      expect(true).toBe(true); // Replace with real reconnect test
+    });
+  });
+
+  describe('Message ordering', () => {
+    it('messages arrive in FIFO order', async () => {
+      // const received: string[] = [];
+      // ws.on('message', (data) => received.push(data.toString()));
+      // for (let i = 0; i < 10; i++) ws.send(\`msg-\${i}\`);
+      // await new Promise((r) => setTimeout(r, 500));
+      // expect(received).toEqual(Array.from({ length: 10 }, (_, i) => \`msg-\${i}\`));
+      expect(true).toBe(true); // Replace with real ordering test
+    });
+  });
+
+  describe('Heartbeat', () => {
+    it('ping/pong keeps connection alive', async () => {
+      // let pongReceived = false;
+      // ws.on('pong', () => { pongReceived = true; });
+      // ws.ping();
+      // await new Promise((r) => setTimeout(r, 1000));
+      // expect(pongReceived).toBe(true);
+      expect(true).toBe(true); // Replace with real heartbeat test
+    });
+  });
+
+  describe('Auth', () => {
+    it('rejects connection with invalid token', async () => {
+      // const badWs = new WebSocket(WS_URL, { headers: { Authorization: 'Bearer invalid' } });
+      // await expect(
+      //   new Promise<void>((_, reject) => {
+      //     badWs.on('error', reject);
+      //     badWs.on('close', (code) => reject(new Error(\`closed: \${code}\`)));
+      //   }),
+      // ).rejects.toThrow();
+      expect(true).toBe(true); // Replace with real auth rejection test
+    });
+  });
+});
+`;
+}
+function buildPythonWebSocketTest(title) {
+    const cls = title.replace(/\s+/g, '');
+    return `"""WebSocket tests for: ${title}
+Generated by Planu SDD MCP Server (SPEC-058a).
+Uses websockets library for Python.
+"""
+import pytest
+# import asyncio
+# import websockets
+
+
+WS_URL = "ws://localhost:3000"
+
+
+class Test${cls}WebSocket:
+    """WebSocket test suite for ${title}."""
+
+    def test_connection_opens_successfully(self) -> None:
+        """WebSocket connection opens and receives welcome message."""
+        # async def _test():
+        #     async with websockets.connect(WS_URL) as ws:
+        #         assert ws.open
+        # asyncio.get_event_loop().run_until_complete(_test())
+        pass
+
+    def test_connection_closes_cleanly(self) -> None:
+        """WebSocket connection closes with normal code 1000."""
+        # async def _test():
+        #     async with websockets.connect(WS_URL) as ws:
+        #         await ws.close(1000, "Normal closure")
+        #         assert ws.closed
+        # asyncio.get_event_loop().run_until_complete(_test())
+        pass
+
+    def test_messages_arrive_in_order(self) -> None:
+        """Messages sent sequentially arrive in FIFO order."""
+        # async def _test():
+        #     async with websockets.connect(WS_URL) as ws:
+        #         for i in range(10):
+        #             await ws.send(f"msg-{i}")
+        #         received = [await ws.recv() for _ in range(10)]
+        #         assert received == [f"msg-{i}" for i in range(10)]
+        # asyncio.get_event_loop().run_until_complete(_test())
+        pass
+
+    def test_heartbeat_keeps_connection_alive(self) -> None:
+        """Ping/pong keeps the connection alive beyond idle timeout."""
+        # async def _test():
+        #     async with websockets.connect(WS_URL) as ws:
+        #         pong = await ws.ping()
+        #         await pong  # wait for pong response
+        # asyncio.get_event_loop().run_until_complete(_test())
+        pass
+
+    def test_invalid_token_rejects_connection(self) -> None:
+        """Connection with invalid auth token is rejected."""
+        # async def _test():
+        #     with pytest.raises(websockets.exceptions.InvalidStatusCode):
+        #         await websockets.connect(
+        #             WS_URL,
+        #             extra_headers={"Authorization": "Bearer invalid"},
+        #         )
+        # asyncio.get_event_loop().run_until_complete(_test())
+        pass
+`;
+}
+/**
+ * Generate WebSocket test file scaffolds for the target language.
+ */
+export function generateWebSocketTestFiles(spec, testDir, framework, language, testExt, autoGenerate) {
+    const isPython = language === 'python';
+    const resolvedExt = isPython ? 'py' : testExt;
+    const resolvedFramework = isPython ? 'pytest' : framework;
+    const content = isPython
+        ? buildPythonWebSocketTest(spec.title)
+        : buildTsWebSocketTest(spec.title);
+    return [
+        {
+            path: `${testDir}/websocket/${spec.slug}.ws.test.${resolvedExt}`,
+            framework: resolvedFramework,
+            content,
+            ready: autoGenerate,
+        },
+    ];
+}
+//# sourceMappingURL=websocket-test-generator.js.map

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

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

package/dist/tools/generate-tests/plan-mode-handler.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectKnowledge, ToolResult } from '../../types/index.js';
+export declare function handlePlanMode(projectId: string, knowledge: ProjectKnowledge): ToolResult;
+//# sourceMappingURL=plan-mode-handler.d.ts.map

package/dist/tools/generate-tests/plan-mode-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-tests/plan-mode-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAwBxF,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,UAAU,CAyCzF"}

package/dist/tools/generate-tests/plan-mode-handler.js

@@ -0,0 +1,54 @@
+// tools/generate-tests/plan-mode-handler.ts — SPEC-058a Plan mode handler
+// Extracted from generate-tests.ts to stay under 400-line limit
+import { generateTestPlan } from '../../engine/test-plan-generator.js';
+function formatLayerSection(layer) {
+    const statusIcon = layer.needed ? '✓' : '–';
+    const lines = [
+        `### ${statusIcon} ${layer.type.toUpperCase()} tests (${layer.priority})`,
+        '',
+        `**Needed:** ${layer.needed ? 'Yes' : 'No'}`,
+        `**Reason:** ${layer.reason}`,
+    ];
+    if (layer.needed) {
+        lines.push(`**Estimated hours:** ${layer.estimatedHours}h`);
+        if (layer.frameworks.length > 0) {
+            lines.push(`**Frameworks:** ${layer.frameworks.join(', ')}`);
+        }
+        if (layer.tools.length > 0) {
+            lines.push(`**Tools:** ${layer.tools.join(', ')}`);
+        }
+    }
+    lines.push('');
+    return lines;
+}
+export function handlePlanMode(projectId, knowledge) {
+    const plan = generateTestPlan(knowledge);
+    const lines = [
+        '## Test Plan',
+        '',
+        `**Project:** \`${projectId}\``,
+        `**Generated at:** ${plan.generatedAt}`,
+        `**Total estimated hours:** ${plan.totalEstimatedHours}h`,
+        `**Starter kit mode:** ${plan.starterKit ? 'Yes (no apps detected)' : 'No'}`,
+        '',
+        '## Layers',
+        '',
+    ];
+    for (const layer of plan.layers) {
+        lines.push(...formatLayerSection(layer));
+    }
+    if (plan.mcpRecommendations.length > 0) {
+        lines.push('## MCP Recommendations', '');
+        for (const rec of plan.mcpRecommendations) {
+            lines.push(`- ${rec}`);
+        }
+        lines.push('');
+    }
+    if (plan.starterKit) {
+        lines.push('## Starter Kit', '', 'No apps were detected. Use the starter kit templates to bootstrap your test setup:', '- Add a test runner to your project (vitest, pytest, go test, etc.)', '- Configure coverage thresholds (aim for 80%+ lines, 70%+ branches)', '- Set up CI/CD to run tests on every push', '');
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+//# sourceMappingURL=plan-mode-handler.js.map

package/dist/tools/generate-tests/plan-mode-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode-handler.js","sourceRoot":"","sources":["../../../src/tools/generate-tests/plan-mode-handler.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,gEAAgE;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAEvE,SAAS,kBAAkB,CAAC,KAAoB;IAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5C,MAAM,KAAK,GAAa;QACtB,OAAO,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,KAAK,CAAC,QAAQ,GAAG;QACzE,EAAE;QACF,eAAe,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QAC5C,eAAe,KAAK,CAAC,MAAM,EAAE;KAC9B,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC;QAC5D,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,SAA2B;IAC3E,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,KAAK,GAAa;QACtB,cAAc;QACd,EAAE;QACF,kBAAkB,SAAS,IAAI;QAC/B,qBAAqB,IAAI,CAAC,WAAW,EAAE;QACvC,8BAA8B,IAAI,CAAC,mBAAmB,GAAG;QACzD,yBAAyB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,EAAE;QAC5E,EAAE;QACF,WAAW;QACX,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CACR,gBAAgB,EAChB,EAAE,EACF,oFAAoF,EACpF,qEAAqE,EACrE,qEAAqE,EACrE,2CAA2C,EAC3C,EAAE,CACH,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}