@planu/cli 0.97.2 → 0.99.0

package/dist/engine/mutation-config-generator.js

@@ -0,0 +1,111 @@
+// engine/mutation-config-generator.ts — SPEC-323
+// Detects project stack and generates the appropriate mutation testing config file.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getMutationTool, generateMutationConfig as buildMutationConfig, } from './advanced-testing/mutation-advisor.js';
+// ---------------------------------------------------------------------------
+// Stack detection
+// ---------------------------------------------------------------------------
+async function detectStack(projectPath) {
+    const pkgPath = join(projectPath, 'package.json');
+    try {
+        const raw = await readFile(pkgPath, 'utf8');
+        const pkg = JSON.parse(raw);
+        const deps = {
+            ...(pkg.dependencies ?? {}),
+            ...(pkg.devDependencies ?? {}),
+        };
+        const language = 'typescript' in deps ? 'typescript' : 'javascript';
+        let testFramework = 'unknown';
+        if ('vitest' in deps) {
+            testFramework = 'vitest';
+        }
+        else if ('jest' in deps) {
+            testFramework = 'jest';
+        }
+        else if ('mocha' in deps) {
+            testFramework = 'mocha';
+        }
+        return { language, testFramework };
+    }
+    catch {
+        const hasPython = (await readFile(join(projectPath, 'setup.py'), 'utf8').catch(() => null)) !== null ||
+            (await readFile(join(projectPath, 'pyproject.toml'), 'utf8').catch(() => null)) !== null;
+        if (hasPython) {
+            return { language: 'python', testFramework: 'pytest' };
+        }
+        const hasMaven = (await readFile(join(projectPath, 'pom.xml'), 'utf8').catch(() => null)) !== null;
+        if (hasMaven) {
+            return { language: 'java', testFramework: 'junit' };
+        }
+        return { language: 'typescript', testFramework: 'unknown' };
+    }
+}
+// ---------------------------------------------------------------------------
+// Config file name resolution
+// ---------------------------------------------------------------------------
+function resolveConfigFileName(tool) {
+    switch (tool) {
+        case 'stryker':
+            return 'stryker.config.mjs';
+        case 'mutmut':
+        case 'cosmic-ray':
+            return 'setup.cfg';
+        case 'pitest':
+            return 'pom.xml (add mutation plugin section)';
+        case 'cargo-mutants':
+            return '.cargo-mutants.toml';
+        case 'gremlins':
+            return '.gremlins.yaml';
+        case 'stryker4s':
+            return 'stryker4s.conf';
+        case 'stryker-dotnet':
+            return 'stryker-config.json';
+        default:
+            return 'stryker.config.mjs';
+    }
+}
+// ---------------------------------------------------------------------------
+// CI step generation
+// ---------------------------------------------------------------------------
+function buildCiStep(tool) {
+    switch (tool) {
+        case 'stryker':
+            return 'npx stryker run';
+        case 'mutmut':
+            return 'python -m mutmut run && python -m mutmut results';
+        case 'pitest':
+            return 'mvn test-compile org.pitest:pitest-maven:mutationCoverage';
+        case 'cargo-mutants':
+            return 'cargo mutants';
+        case 'gremlins':
+            return 'gremlins unleash ./...';
+        case 'stryker4s':
+            return 'sbt stryker';
+        case 'stryker-dotnet':
+            return 'dotnet stryker';
+        default:
+            return 'npx stryker run';
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Detect project stack and generate the appropriate mutation testing config.
+ */
+export async function generateMutationConfig(projectPath) {
+    const stack = await detectStack(projectPath);
+    const tool = getMutationTool(stack.language);
+    const mutationConfig = buildMutationConfig(tool, stack.language);
+    const configFileName = resolveConfigFileName(tool);
+    const ciStep = buildCiStep(tool);
+    return {
+        configFileName,
+        configContent: mutationConfig.configFile,
+        ciStep,
+        framework: stack.testFramework,
+        tool,
+    };
+}
+//# sourceMappingURL=mutation-config-generator.js.map

package/dist/engine/mutation-config-generator.js.map

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

package/dist/engine/product-intelligence/index.d.ts

@@ -0,0 +1,7 @@
+import type { ProductInsightsReport, ProductInsightsReport_Report } from '../../types/product-intelligence.js';
+/**
+ * Generates a product insights report by querying Supabase telemetry_events.
+ * Throws if the HTTP request fails — caller should handle and return isError.
+ */
+export declare function generateProductInsights(report: ProductInsightsReport_Report, periodDays?: number): Promise<ProductInsightsReport>;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/product-intelligence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/product-intelligence/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,qBAAqB,EACrB,4BAA4B,EAO7B,MAAM,qCAAqC,CAAC;AAkN7C;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,4BAA4B,EACpC,UAAU,SAAK,GACd,OAAO,CAAC,qBAAqB,CAAC,CAiChC"}

package/dist/engine/product-intelligence/index.js

@@ -0,0 +1,211 @@
+// engine/product-intelligence/index.ts — SPEC-328: Product Intelligence Layer engine.
+// Queries Supabase telemetry_events to generate product insights reports.
+// Uses the same auth pattern as telemetry-client.ts (fire-and-forget-friendly).
+import { PLANU_VERSION } from '../../config/version.js';
+const SUPABASE_URL = process.env.PLANU_SUPABASE_URL ?? 'https://canusqigtzldstnjddio.supabase.co';
+const SUPABASE_KEY = process.env.PLANU_SUPABASE_KEY ??
+    'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImNhbnVzcWlndHpsZHN0bmpkZGlvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI3NTk2MjgsImV4cCI6MjA4ODMzNTYyOH0.Thw1Xgf9_iabOD75J00u35d2k5NsIpUBU9PrqOShxMU';
+const TELEMETRY_TABLE = `${SUPABASE_URL}/rest/v1/telemetry_events`;
+/** Core tools expected to be active — used for dead-tool detection. */
+const KNOWN_CORE_TOOLS = [
+    'create_spec',
+    'list_specs',
+    'update_status',
+    'validate',
+    'estimate',
+    'init_project',
+    'suggest_stack',
+    'generate_tests',
+    'generate_docs',
+    'challenge_spec',
+    'check_readiness',
+    'decompose_spec',
+    'scan_project',
+    'manage_git',
+    'product_insights',
+];
+function strProp(props, key) {
+    const val = props[key];
+    return typeof val === 'string' ? val : '';
+}
+async function fetchEvents(sinceIso) {
+    const url = new URL(TELEMETRY_TABLE);
+    url.searchParams.set('created_at', `gte.${sinceIso}`);
+    url.searchParams.set('select', 'event_name,properties,installation_id,created_at');
+    url.searchParams.set('limit', '50000');
+    const res = await fetch(url.toString(), {
+        headers: {
+            apikey: SUPABASE_KEY,
+            Authorization: `Bearer ${SUPABASE_KEY}`,
+            Accept: 'application/json',
+        },
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!res.ok) {
+        throw new Error(`Supabase query failed: ${res.status} ${res.statusText}`);
+    }
+    return (await res.json());
+}
+function buildAdoption(rows, sinceIso) {
+    const map = new Map();
+    for (const row of rows) {
+        const tool = strProp(row.properties, 'tool');
+        if (!tool) {
+            continue;
+        }
+        const event = row.event_name;
+        if (!['tool_used', 'tool_error', 'tool_blocked'].includes(event)) {
+            continue;
+        }
+        let stats = map.get(tool);
+        if (stats === undefined) {
+            stats = { total: 0, installs: new Set(), errors: 0, blocked: 0, lastSeen: sinceIso };
+            map.set(tool, stats);
+        }
+        stats.total += 1;
+        stats.installs.add(row.installation_id);
+        if (event === 'tool_error') {
+            stats.errors += 1;
+        }
+        if (event === 'tool_blocked') {
+            stats.blocked += 1;
+        }
+        if (row.created_at > stats.lastSeen) {
+            stats.lastSeen = row.created_at;
+        }
+    }
+    return Array.from(map.entries()).map(([tool, s]) => ({
+        tool,
+        totalCalls: s.total,
+        uniqueInstalls: s.installs.size,
+        errorRate: s.total > 0 ? s.errors / s.total : 0,
+        blockedRate: s.total > 0 ? s.blocked / s.total : 0,
+        lastSeenAt: s.lastSeen,
+        trend: s.total === 1 ? 'new' : 'stable',
+    }));
+}
+function buildFriction(rows) {
+    const map = new Map();
+    for (const row of rows) {
+        const tool = strProp(row.properties, 'tool');
+        if (!tool) {
+            continue;
+        }
+        if (!['tool_used', 'tool_blocked'].includes(row.event_name)) {
+            continue;
+        }
+        let s = map.get(tool);
+        if (s === undefined) {
+            s = { blocked: 0, total: 0, messages: [] };
+            map.set(tool, s);
+        }
+        s.total += 1;
+        if (row.event_name === 'tool_blocked') {
+            s.blocked += 1;
+            const msg = strProp(row.properties, 'message');
+            if (msg) {
+                s.messages.push(msg);
+            }
+        }
+    }
+    return Array.from(map.entries())
+        .filter(([, s]) => s.blocked > 0)
+        .map(([tool, s]) => {
+        const msgCounts = new Map();
+        for (const m of s.messages) {
+            msgCounts.set(m, (msgCounts.get(m) ?? 0) + 1);
+        }
+        let topMessage = null;
+        let maxCount = 0;
+        for (const [m, c] of msgCounts.entries()) {
+            if (c > maxCount) {
+                maxCount = c;
+                topMessage = m;
+            }
+        }
+        return {
+            tool,
+            blockedCount: s.blocked,
+            totalCalls: s.total,
+            blockedRate: s.total > 0 ? s.blocked / s.total : 0,
+            topMessage,
+        };
+    })
+        .sort((a, b) => b.blockedRate - a.blockedRate);
+}
+function buildVersionAdoption(rows) {
+    const map = new Map();
+    for (const row of rows) {
+        const ver = strProp(row.properties, 'planVersion');
+        if (!ver) {
+            continue;
+        }
+        let installs = map.get(ver);
+        if (installs === undefined) {
+            installs = new Set();
+            map.set(ver, installs);
+        }
+        installs.add(row.installation_id);
+    }
+    const total = Array.from(map.values()).reduce((sum, s) => sum + s.size, 0);
+    return Array.from(map.entries())
+        .map(([planVersion, installs]) => ({
+        planVersion,
+        userCount: installs.size,
+        pct: total > 0 ? installs.size / total : 0,
+        isLatest: planVersion === PLANU_VERSION,
+    }))
+        .sort((a, b) => b.userCount - a.userCount);
+}
+function buildDeadTools(adoption, sinceIso) {
+    const recentlyActive = new Set(adoption.filter((r) => r.lastSeenAt >= sinceIso).map((r) => r.tool));
+    return KNOWN_CORE_TOOLS.filter((t) => !recentlyActive.has(t));
+}
+function buildSummary(report) {
+    const topTool = report.adoption[0];
+    const topFriction = report.frictionPoints[0];
+    const lines = [
+        `Period: ${report.periodDays}d | Events: ${report.totalEvents} | Installs: ${report.uniqueInstalls}`,
+    ];
+    if (topTool !== undefined) {
+        lines.push(`Most used: ${topTool.tool} (${topTool.totalCalls} calls)`);
+    }
+    if (topFriction !== undefined) {
+        lines.push(`Top friction: ${topFriction.tool} (${(topFriction.blockedRate * 100).toFixed(1)}% blocked)`);
+    }
+    if (report.deadTools.length > 0) {
+        lines.push(`Dead tools: ${report.deadTools.join(', ')}`);
+    }
+    return lines.join(' | ');
+}
+/**
+ * Generates a product insights report by querying Supabase telemetry_events.
+ * Throws if the HTTP request fails — caller should handle and return isError.
+ */
+export async function generateProductInsights(report, periodDays = 30) {
+    const since = new Date(Date.now() - periodDays * 24 * 60 * 60 * 1000);
+    const sinceIso = since.toISOString();
+    const rows = await fetchEvents(sinceIso);
+    const uniqueInstalls = new Set(rows.map((r) => r.installation_id)).size;
+    const adoption = report === 'friction' ? [] : buildAdoption(rows, sinceIso);
+    const frictionPoints = report === 'versions' || report === 'dead_tools' ? [] : buildFriction(rows);
+    const versionAdoption = report === 'adoption' || report === 'friction' || report === 'dead_tools'
+        ? []
+        : buildVersionAdoption(rows);
+    const baseAdoption = adoption.length > 0 ? adoption : buildAdoption(rows, sinceIso);
+    const deadTools = report === 'adoption' || report === 'friction' || report === 'versions'
+        ? []
+        : buildDeadTools(baseAdoption, sinceIso);
+    const partial = {
+        generatedAt: new Date().toISOString(),
+        periodDays,
+        totalEvents: rows.length,
+        uniqueInstalls,
+        adoption,
+        frictionPoints,
+        versionAdoption,
+        deadTools,
+    };
+    return { ...partial, summary: buildSummary(partial) };
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/product-intelligence/index.js.map

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

package/dist/engine/tdd-scaffold-generator.d.ts

@@ -0,0 +1,7 @@
+import type { TddScaffoldResult } from '../types/index.js';
+/**
+ * Generate a TDD scaffold from a spec's acceptance criteria.
+ * Returns paths and content for a failing test file and an impl skeleton.
+ */
+export declare function generateTddScaffold(specPath: string, projectPath: string): Promise<TddScaffoldResult>;
+//# sourceMappingURL=tdd-scaffold-generator.d.ts.map

package/dist/engine/tdd-scaffold-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tdd-scaffold-generator.d.ts","sourceRoot":"","sources":["../../src/engine/tdd-scaffold-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAiC,MAAM,mBAAmB,CAAC;AAiO1F;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CA4C5B"}

package/dist/engine/tdd-scaffold-generator.js

@@ -0,0 +1,252 @@
+// engine/tdd-scaffold-generator.ts — SPEC-323
+// Generates TDD scaffold (failing test stubs + impl skeleton) from spec ACs.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Extract checkbox ACs from spec.md content: lines starting with "- [ ]". */
+function extractAcceptanceCriteria(specContent) {
+    const lines = specContent.split('\n');
+    const criteria = [];
+    for (const line of lines) {
+        const match = /^\s*-\s*\[\s*\]\s+(.+)$/.exec(line);
+        if (match?.[1]) {
+            criteria.push(match[1].trim());
+        }
+    }
+    return criteria;
+}
+/** Convert a criterion string to a camelCase test name. */
+function criterionToTestName(criterion) {
+    const cleaned = criterion
+        .replace(/[^\w\s]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .toLowerCase();
+    const words = cleaned.split(' ').filter(Boolean);
+    if (words.length === 0) {
+        return 'criterion';
+    }
+    const [first, ...rest] = words;
+    return ((first ?? 'criterion') + rest.map((w) => (w[0]?.toUpperCase() ?? '') + w.slice(1)).join(''));
+}
+/** Detect test framework from package.json devDependencies / dependencies. */
+async function detectFramework(projectPath) {
+    const pkgPath = join(projectPath, 'package.json');
+    try {
+        const raw = await readFile(pkgPath, 'utf8');
+        const pkg = JSON.parse(raw);
+        const deps = {
+            ...(pkg.dependencies ?? {}),
+            ...(pkg.devDependencies ?? {}),
+        };
+        if ('vitest' in deps) {
+            return 'vitest';
+        }
+        if ('jest' in deps) {
+            return 'jest';
+        }
+        if ('mocha' in deps) {
+            return 'mocha';
+        }
+        return 'unknown';
+    }
+    catch {
+        // Check for Python or Java markers
+        const setup = await readFile(join(projectPath, 'setup.py'), 'utf8').catch(() => null);
+        if (setup !== null) {
+            return 'pytest';
+        }
+        const pom = await readFile(join(projectPath, 'pom.xml'), 'utf8').catch(() => null);
+        if (pom !== null) {
+            return 'junit';
+        }
+        return 'unknown';
+    }
+}
+/** Extract spec slug from path for naming generated files. */
+function specSlugFromPath(specPath) {
+    const parts = specPath.replace(/\\/g, '/').split('/');
+    // Try to find SPEC-XXX pattern in path
+    for (const part of [...parts].reverse()) {
+        if (/SPEC-\d+/.test(part)) {
+            return part.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+        }
+    }
+    return 'spec-unknown';
+}
+// ---------------------------------------------------------------------------
+// Test content builders
+// ---------------------------------------------------------------------------
+function buildVitestContent(stubs) {
+    const lines = [
+        "import { describe, it, expect } from 'vitest';",
+        '',
+        '// TDD scaffold — generated by Planu (SPEC-323)',
+        '// Each test is a FAILING STUB. Implement the production code to make them pass.',
+        '',
+        'describe("Acceptance Criteria", () => {',
+    ];
+    for (const stub of stubs) {
+        lines.push(`  it("should ${stub.testName}", () => {`);
+        lines.push(`    // AC: ${stub.criterion}`);
+        lines.push('    expect.fail("Not implemented — write the implementation first");');
+        lines.push('  });');
+        lines.push('');
+    }
+    lines.push('});');
+    return lines.join('\n');
+}
+function buildJestContent(stubs) {
+    const lines = [
+        '// TDD scaffold — generated by Planu (SPEC-323)',
+        '// Each test is a FAILING STUB. Implement the production code to make them pass.',
+        '',
+        'describe("Acceptance Criteria", () => {',
+    ];
+    for (const stub of stubs) {
+        lines.push(`  it("should ${stub.testName}", () => {`);
+        lines.push(`    // AC: ${stub.criterion}`);
+        lines.push('    throw new Error("Not implemented — write the implementation first");');
+        lines.push('  });');
+        lines.push('');
+    }
+    lines.push('});');
+    return lines.join('\n');
+}
+function buildMochaContent(stubs) {
+    const lines = [
+        "import assert from 'node:assert';",
+        '',
+        '// TDD scaffold — generated by Planu (SPEC-323)',
+        '',
+        'describe("Acceptance Criteria", function () {',
+    ];
+    for (const stub of stubs) {
+        lines.push(`  it("should ${stub.testName}", function () {`);
+        lines.push(`    // AC: ${stub.criterion}`);
+        lines.push('    assert.fail("Not implemented — write the implementation first");');
+        lines.push('  });');
+        lines.push('');
+    }
+    lines.push('});');
+    return lines.join('\n');
+}
+function buildPytestContent(stubs) {
+    const lines = [
+        '# TDD scaffold — generated by Planu (SPEC-323)',
+        '# Each test is a FAILING STUB. Implement the production code to make them pass.',
+        '',
+        'import pytest',
+        '',
+    ];
+    for (const stub of stubs) {
+        const fnName = stub.testName.replace(/([A-Z])/g, '_$1').toLowerCase();
+        lines.push(`def test_${fnName}():`);
+        lines.push(`    # AC: ${stub.criterion}`);
+        lines.push('    raise NotImplementedError("Not implemented — write the implementation first")');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function buildJunitContent(stubs) {
+    const lines = [
+        '// TDD scaffold — generated by Planu (SPEC-323)',
+        'import org.junit.jupiter.api.Test;',
+        'import static org.junit.jupiter.api.Assertions.*;',
+        '',
+        'class AcceptanceCriteriaTest {',
+    ];
+    for (const stub of stubs) {
+        const method = stub.testName.replace(/[^a-zA-Z0-9]/g, '');
+        const first = method[0]?.toUpperCase() ?? '';
+        const rest = method.slice(1);
+        lines.push('    @Test');
+        lines.push(`    void should${first}${rest}() {`);
+        lines.push(`        // AC: ${stub.criterion}`);
+        lines.push('        fail("Not implemented — write the implementation first");');
+        lines.push('    }');
+        lines.push('');
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+function buildTestContent(stubs, framework) {
+    switch (framework) {
+        case 'vitest':
+            return buildVitestContent(stubs);
+        case 'jest':
+            return buildJestContent(stubs);
+        case 'mocha':
+            return buildMochaContent(stubs);
+        case 'pytest':
+            return buildPytestContent(stubs);
+        case 'junit':
+            return buildJunitContent(stubs);
+        case 'unknown':
+            return buildVitestContent(stubs);
+    }
+}
+// ---------------------------------------------------------------------------
+// Implementation skeleton builder
+// ---------------------------------------------------------------------------
+function buildImplSkeleton(stubs, slug) {
+    const lines = [
+        `// ${slug}.ts — implementation skeleton generated by Planu (SPEC-323)`,
+        '// TODO: implement each function to make the TDD stubs pass.',
+        '',
+    ];
+    for (const stub of stubs) {
+        lines.push(`// AC: ${stub.criterion}`);
+        lines.push(`export function ${stub.testName}(): void {`);
+        lines.push('  throw new Error("Not implemented");');
+        lines.push('}');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generate a TDD scaffold from a spec's acceptance criteria.
+ * Returns paths and content for a failing test file and an impl skeleton.
+ */
+export async function generateTddScaffold(specPath, projectPath) {
+    const specContent = await readFile(join(specPath, 'spec.md'), 'utf8').catch(() => readFile(specPath, 'utf8'));
+    const criteria = extractAcceptanceCriteria(specContent);
+    const framework = await detectFramework(projectPath);
+    const slug = specSlugFromPath(specPath);
+    const stubs = criteria.map((criterion) => ({
+        criterion,
+        testName: criterionToTestName(criterion),
+        framework,
+    }));
+    const ext = framework === 'pytest' ? 'py' : framework === 'junit' ? 'java' : 'ts';
+    const testExt = framework === 'pytest' ? '_test.py' : framework === 'junit' ? 'Test.java' : '.test.ts';
+    const testDir = framework === 'pytest' ? 'tests' : framework === 'junit' ? 'src/test' : 'tests';
+    const testFilePath = join(projectPath, testDir, `${slug}${testExt}`);
+    const implFilePath = join(projectPath, 'src', `${slug}.${ext}`);
+    const testContent = buildTestContent(stubs, framework);
+    const implContent = buildImplSkeleton(stubs, slug);
+    const instructions = [
+        `Test file: ${testFilePath}`,
+        `Implementation skeleton: ${implFilePath}`,
+        `Framework detected: ${framework}`,
+        `Generated ${stubs.length} failing stub(s) from acceptance criteria.`,
+        'Run the tests — they should ALL fail (red phase).',
+        'Implement each function in the skeleton until all tests pass (green phase).',
+        'Refactor for clarity while keeping all tests green.',
+    ];
+    return {
+        testFilePath,
+        implFilePath,
+        testContent,
+        implContent,
+        stubs,
+        instructions,
+        framework,
+    };
+}
+//# sourceMappingURL=tdd-scaffold-generator.js.map

package/dist/engine/tdd-scaffold-generator.js.map

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