@planu/cli 0.97.2 → 0.98.0

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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"}

package/dist/engine/version-resolver.d.ts

@@ -0,0 +1,10 @@
+import type { PackageRegistry, VersionCachePolicy, VersionResolutionResult } from '../types/index.js';
+/**
+ * Resolve the latest version of a framework package.
+ * Order: memory cache → persistent cache → registry → fallback.
+ * Never throws — always returns a result.
+ */
+export declare function resolveFrameworkVersion(packageName: string, registry: PackageRegistry, cachePolicy?: VersionCachePolicy): Promise<VersionResolutionResult>;
+/** Clear the in-memory cache (useful for testing). */
+export declare function clearVersionCache(): void;
+//# sourceMappingURL=version-resolver.d.ts.map

package/dist/engine/version-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-resolver.d.ts","sourceRoot":"","sources":["../../src/engine/version-resolver.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,eAAe,EAGf,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AA6F3B;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,eAAe,EACzB,WAAW,GAAE,kBAA+B,GAC3C,OAAO,CAAC,uBAAuB,CAAC,CA0DlC;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/engine/version-resolver.js

@@ -0,0 +1,144 @@
+// Planu — Version Resolver (SPEC-321)
+// Resolves framework versions: in-memory cache → persistent cache → registry → fallback.
+// Never throws — always returns a VersionResolutionResult.
+import { readFile, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+// -- Constants ---------------------------------------------------------------
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const CACHE_FILE = join(tmpdir(), 'planu-version-cache.json');
+// -- In-memory cache ---------------------------------------------------------
+const memoryCache = new Map();
+function cacheKey(packageName, registry) {
+    return `${registry}:${packageName}`;
+}
+function isExpired(entry) {
+    const age = Date.now() - new Date(entry.fetchedAt).getTime();
+    return age > CACHE_TTL_MS;
+}
+// -- Persistent cache --------------------------------------------------------
+async function loadPersistentCache() {
+    try {
+        const raw = await readFile(CACHE_FILE, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return { entries: {} };
+    }
+}
+async function savePersistentCache(store) {
+    try {
+        await writeFile(CACHE_FILE, JSON.stringify(store, null, 2), 'utf-8');
+    }
+    catch {
+        // Ignore write errors — cache is best-effort
+    }
+}
+async function getFromPersistentCache(key) {
+    const store = await loadPersistentCache();
+    return store.entries[key] ?? null;
+}
+async function setInPersistentCache(key, entry) {
+    const store = await loadPersistentCache();
+    store.entries[key] = entry;
+    await savePersistentCache(store);
+}
+// -- Registry fetch ----------------------------------------------------------
+async function fetchFromRegistry(packageName, registry) {
+    try {
+        const { fetchLatestVersion } = await import('./package-registry.js');
+        const result = await fetchLatestVersion(packageName, registry);
+        if (!result) {
+            return null;
+        }
+        return { version: result.version, isDeprecated: result.deprecated };
+    }
+    catch {
+        return null;
+    }
+}
+// -- Fallback versions -------------------------------------------------------
+const FALLBACK_VERSIONS = {
+    'npm:next': '14.0.0',
+    'npm:react': '18.0.0',
+    'npm:hono': '4.0.0',
+    'npm:expo': '50.0.0',
+    'npm:commander': '12.0.0',
+    'npm:tsup': '8.0.0',
+    'npm:astro': '4.0.0',
+    'npm:remix': '2.0.0',
+    'npm:@remix-run/node': '2.0.0',
+    'pypi:fastapi': '0.100.0',
+    'pypi:django': '5.0.0',
+    'go:gin': '1.9.0',
+    'pub:flutter': '3.0.0',
+};
+function getFallbackVersion(packageName, registry) {
+    const key = `${registry}:${packageName}`;
+    return FALLBACK_VERSIONS[key] ?? '1.0.0';
+}
+// -- Public API --------------------------------------------------------------
+/**
+ * Resolve the latest version of a framework package.
+ * Order: memory cache → persistent cache → registry → fallback.
+ * Never throws — always returns a result.
+ */
+export async function resolveFrameworkVersion(packageName, registry, cachePolicy = 'flexible') {
+    const key = cacheKey(packageName, registry);
+    // Offline mode: use cache only, fall back if not found
+    if (cachePolicy === 'offline') {
+        const memEntry = memoryCache.get(key);
+        if (memEntry) {
+            return { ...memEntry, source: 'cache' };
+        }
+        const persEntry = await getFromPersistentCache(key);
+        if (persEntry) {
+            memoryCache.set(key, persEntry);
+            return { ...persEntry, source: 'cache' };
+        }
+        return {
+            version: getFallbackVersion(packageName, registry),
+            source: 'fallback',
+            fetchedAt: new Date().toISOString(),
+            isDeprecated: false,
+        };
+    }
+    // Check memory cache
+    const memEntry = memoryCache.get(key);
+    if (memEntry && !isExpired(memEntry)) {
+        return { ...memEntry, source: 'cache' };
+    }
+    // Check persistent cache (flexible mode accepts non-expired entries)
+    if (cachePolicy === 'flexible') {
+        const persEntry = await getFromPersistentCache(key);
+        if (persEntry && !isExpired(persEntry)) {
+            memoryCache.set(key, persEntry);
+            return { ...persEntry, source: 'cache' };
+        }
+    }
+    // Fetch from registry
+    const fetched = await fetchFromRegistry(packageName, registry);
+    if (fetched) {
+        const entry = {
+            version: fetched.version,
+            isDeprecated: fetched.isDeprecated,
+            fetchedAt: new Date().toISOString(),
+        };
+        memoryCache.set(key, entry);
+        await setInPersistentCache(key, entry);
+        return { ...entry, source: 'registry' };
+    }
+    // Fallback: registry unreachable
+    const fallbackVersion = getFallbackVersion(packageName, registry);
+    return {
+        version: fallbackVersion,
+        source: 'fallback',
+        fetchedAt: new Date().toISOString(),
+        isDeprecated: false,
+    };
+}
+/** Clear the in-memory cache (useful for testing). */
+export function clearVersionCache() {
+    memoryCache.clear();
+}
+//# sourceMappingURL=version-resolver.js.map

package/dist/engine/version-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-resolver.js","sourceRoot":"","sources":["../../src/engine/version-resolver.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,yFAAyF;AACzF,2DAA2D;AAE3D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAUjC,+EAA+E;AAE/E,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW;AACrD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC;AAE9D,+EAA+E;AAE/E,MAAM,WAAW,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEzD,SAAS,QAAQ,CAAC,WAAmB,EAAE,QAAyB;IAC9D,OAAO,GAAG,QAAQ,IAAI,WAAW,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,SAAS,CAAC,KAAwB;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7D,OAAO,GAAG,GAAG,YAAY,CAAC;AAC5B,CAAC;AAED,+EAA+E;AAE/E,KAAK,UAAU,mBAAmB;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,KAAwB;IACzD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;IAC/C,CAAC;AACH,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,GAAW;IAC/C,MAAM,KAAK,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AACpC,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,GAAW,EAAE,KAAwB;IACvE,MAAM,KAAK,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC1C,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3B,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,+EAA+E;AAE/E,KAAK,UAAU,iBAAiB,CAC9B,WAAmB,EACnB,QAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E,MAAM,iBAAiB,GAA2B;IAChD,UAAU,EAAE,QAAQ;IACpB,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE,QAAQ;IACpB,eAAe,EAAE,QAAQ;IACzB,UAAU,EAAE,OAAO;IACnB,WAAW,EAAE,OAAO;IACpB,WAAW,EAAE,OAAO;IACpB,qBAAqB,EAAE,OAAO;IAC9B,cAAc,EAAE,SAAS;IACzB,aAAa,EAAE,OAAO;IACtB,QAAQ,EAAE,OAAO;IACjB,aAAa,EAAE,OAAO;CACvB,CAAC;AAEF,SAAS,kBAAkB,CAAC,WAAmB,EAAE,QAAyB;IACxE,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,WAAW,EAAE,CAAC;IACzC,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,WAAmB,EACnB,QAAyB,EACzB,cAAkC,UAAU;IAE5C,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAE5C,uDAAuD;IACvD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC1C,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,SAAS,EAAE,CAAC;YACd,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAChC,OAAO,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO;YACL,OAAO,EAAE,kBAAkB,CAAC,WAAW,EAAE,QAAQ,CAAC;YAClD,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,YAAY,EAAE,KAAK;SACpB,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,QAAQ,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IAED,qEAAqE;IACrE,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAChC,OAAO,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/D,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,KAAK,GAAsB;YAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,MAAM,oBAAoB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvC,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC1C,CAAC;IAED,iCAAiC;IACjC,MAAM,eAAe,GAAG,kBAAkB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClE,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,YAAY,EAAE,KAAK;KACpB,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,iBAAiB;IAC/B,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC"}

package/dist/engine/web-fetcher/stack-advisor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stack-advisor.d.ts","sourceRoot":"","sources":["../../../src/engine/web-fetcher/stack-advisor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAwBpF,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAStF;AAwHD,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,EAAE,MAAM,EAAE,GACpB,mBAAmB,CAUrB;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EAAE,GACtB,mBAAmB,CAiErB;AAED,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,CA4BpC;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,mBAAmB,GACzB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAgCvD;AAED,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,kBAAkB,CAAC,CA4B7B"}
+{"version":3,"file":"stack-advisor.d.ts","sourceRoot":"","sources":["../../../src/engine/web-fetcher/stack-advisor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAyBpF,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAStF;AAwHD,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,EAAE,MAAM,EAAE,GACpB,mBAAmB,CAUrB;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EAAE,GACtB,mBAAmB,CAiErB;AAED,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,CA4BpC;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,mBAAmB,GACzB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAgCvD;AAmCD,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,kBAAkB,CAAC,CA+B7B"}

package/dist/engine/web-fetcher/stack-advisor.js

@@ -1,4 +1,5 @@
 // Planu — Web Fetcher: Stack recommendation logic
+import { resolveFrameworkVersion } from '../version-resolver.js';
 const FRAMEWORK_PACKAGES = {
     'next.js': 'next',
     react: 'react',
@@ -258,17 +259,44 @@ export function buildMcpCompatibility(stack) {
     results.push({ mcp: 'puppeteer', compatible: true, notes: 'Browser automation for testing.' });
     return results;
 }
+async function resolveVersionForFramework(framework, language) {
+    const packageName = FRAMEWORK_PACKAGES[framework.toLowerCase()];
+    if (packageName) {
+        const result = await resolveFrameworkVersion(packageName, 'npm');
+        if (result.source !== 'fallback') {
+            return result.version;
+        }
+    }
+    // Try language-specific registries for non-npm frameworks
+    if (language === 'python' && framework === 'fastapi') {
+        const result = await resolveFrameworkVersion('fastapi', 'pypi');
+        return result.source !== 'fallback' ? result.version : null;
+    }
+    if (language === 'python' && framework === 'django') {
+        const result = await resolveFrameworkVersion('django', 'pypi');
+        return result.source !== 'fallback' ? result.version : null;
+    }
+    if (language === 'go' && framework === 'gin') {
+        const result = await resolveFrameworkVersion('gin-gonic/gin', 'go');
+        return result.source !== 'fallback' ? result.version : null;
+    }
+    if ((language === 'dart' || language === 'flutter') && framework === 'flutter') {
+        const result = await resolveFrameworkVersion('flutter', 'pub');
+        return result.source !== 'fallback' ? result.version : null;
+    }
+    return null;
+}
 export async function buildSuggestStackResult(projectType, requirements, constraints) {
     const primary = recommendStack(projectType, requirements, constraints);
     const alternative = recommendAlternativeStack(projectType, requirements);
     let confidence = 'low';
     try {
-        const verifiedVersion = await verifyFrameworkVersion(primary.framework);
-        if (verifiedVersion) {
-            primary.version = verifiedVersion;
+        const primaryVersion = await resolveVersionForFramework(primary.framework, primary.language);
+        if (primaryVersion) {
+            primary.version = primaryVersion;
             confidence = 'high';
         }
-        const altVersion = await verifyFrameworkVersion(alternative.framework);
+        const altVersion = await resolveVersionForFramework(alternative.framework, alternative.language);
         if (altVersion) {
             alternative.version = altVersion;
         }

package/dist/engine/web-fetcher/stack-advisor.js.map

@@ -1 +1 @@
-{"version":3,"file":"stack-advisor.js","sourceRoot":"","sources":["../../../src/engine/web-fetcher/stack-advisor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stack-advisor.js","sourceRoot":"","sources":["../../../src/engine/web-fetcher/stack-advisor.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -146,9 +146,9 @@ import { registerEvalSkillTools } from './tools/register-spec-316.js';
 import { registerJiraLinearTools } from './tools/register-spec-317.js';
 import { registerComplianceTools } from './tools/register-spec-319.js';
 import { registerSpecMarketplaceTools } from './tools/register-spec-320.js';
-// ---------------------------------------------------------------------------
+import { registerApiContractValidationTools } from './tools/register-spec-322-tools.js';
+import { registerSpec323Tools } from './tools/register-spec-323-tools.js';
 // Server setup
-// ---------------------------------------------------------------------------
 const SERVER_INSTRUCTIONS = [
     'CONTEXT — Why structured specs matter:',
     '- Vibe Coding (describing features informally to AI) creates technical debt at scale',
@@ -363,22 +363,19 @@ function registerExtendedTools(s) {
     registerJiraLinearTools(s);
     registerComplianceTools(s);
     registerSpecMarketplaceTools(s);
+    registerApiContractValidationTools(s);
+    registerSpec323Tools(s);
     registerPrompts(s);
 }
-function registerAllTools(s) {
-    registerCoreTools(s);
-    registerExtendedTools(s);
-}
 function createMcpServer() {
     const s = withToolTracking(new McpServer({ name: 'planu', version: PLANU_VERSION }, { instructions: SERVER_INSTRUCTIONS }));
-    registerAllTools(s);
+    registerCoreTools(s);
+    registerExtendedTools(s);
     return s;
 }
 // Primary server instance (used for stdio and group manager init)
 const server = createMcpServer();
-// ---------------------------------------------------------------------------
 // Start server
-// ---------------------------------------------------------------------------
 async function main() {
     // SPEC-251: Check npm registry for newer version (fire-and-forget, 24h cache)
     checkForUpdates().catch(() => {
@@ -392,8 +389,7 @@ async function main() {
             console.error('[Planu] License activation from SDD_LICENSE_KEY failed:', err);
         });
     }
-    // SPEC-074: Initialize tool group manager after all tools are registered.
-    // Uses local tool registry instead of SDK-internal _registeredTools.
+    // SPEC-074: Initialize tool group manager using local registry instead of SDK-internal _registeredTools.
     const toolMap = getRegisteredTools();
     const groupManager = new GroupManager(toolMap, () => {
         server.sendToolListChanged();