@planu/cli 0.27.0 → 0.29.0

package/dist/engine/spec-coverage/keyword-extractor.js

@@ -0,0 +1,147 @@
+// engine/spec-coverage/keyword-extractor.ts — Keyword extraction and test name parsing.
+// Extracted from criteria-mapper.ts to keep file sizes within limits.
+// ---------------------------------------------------------------------------
+// Stop words for heuristic keyword extraction
+// ---------------------------------------------------------------------------
+export const STOP_WORDS = new Set([
+    'the',
+    'a',
+    'an',
+    'is',
+    'are',
+    'was',
+    'were',
+    'be',
+    'been',
+    'being',
+    'have',
+    'has',
+    'had',
+    'do',
+    'does',
+    'did',
+    'will',
+    'would',
+    'could',
+    'should',
+    'may',
+    'might',
+    'shall',
+    'must',
+    'can',
+    'to',
+    'of',
+    'in',
+    'on',
+    'at',
+    'by',
+    'for',
+    'with',
+    'from',
+    'as',
+    'and',
+    'or',
+    'but',
+    'not',
+    'no',
+    'if',
+    'when',
+    'where',
+    'that',
+    'which',
+    'this',
+    'it',
+    'its',
+    'el',
+    'la',
+    'los',
+    'las',
+    'un',
+    'una',
+    'de',
+    'del',
+    'en',
+    'que',
+    'se',
+    'por',
+    'para',
+    'con',
+    'al',
+    'lo',
+    'le',
+    'les',
+    'y',
+    'o',
+]);
+/** Extracts 3-5 meaningful keywords from an AC description text. */
+export function extractKeywords(text) {
+    const words = text
+        .toLowerCase()
+        .replace(/[^a-zA-Z0-9\s_àáéíóúñüÀÁÉÍÓÚÑÜ]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length >= 3 && !STOP_WORDS.has(w));
+    // De-duplicate preserving order
+    const seen = new Set();
+    const unique = [];
+    for (const w of words) {
+        if (!seen.has(w)) {
+            seen.add(w);
+            unique.push(w);
+        }
+    }
+    return unique.slice(0, 5);
+}
+// ---------------------------------------------------------------------------
+// Test name extraction helpers
+// ---------------------------------------------------------------------------
+/** Patterns for extracting test block names from source code. */
+export const TEST_NAME_PATTERNS = [
+    /(?:describe|it|test|context|suite|feature|scenario)\s*\(\s*['"`](.*?)['"`]/g,
+    /(?:func\s+Test\w+)\s*\(/g, // Go: func TestXxx(
+    /(?:def\s+test_\w+)\s*\(/g, // Python: def test_xxx(
+    /#\[test\]\s*(?:fn\s+(\w+))/g, // Rust: #[test] fn name
+    /(?:func|fun)\s+(test\w+)\s*\(/gi, // Swift/Kotlin
+];
+/** Extracts the first matching test name from source code. */
+export function extractTestName(content, nearPattern) {
+    // Find the line with the pattern match, then look for a nearby test name
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        /* v8 ignore next 1 */
+        const line = lines[i] ?? '';
+        if (!nearPattern.test(line)) {
+            continue;
+        }
+        // Look in ±5 lines for a test name
+        const start = Math.max(0, i - 5);
+        const end = Math.min(lines.length - 1, i + 5);
+        for (let j = start; j <= end; j++) {
+            /* v8 ignore next 1 */
+            const nearby = lines[j] ?? '';
+            const nameMatch = /(?:describe|it|test|context)\s*\(\s*['"`](.*?)['"`]/.exec(nearby);
+            if (nameMatch?.[1]) {
+                return nameMatch[1];
+            }
+        }
+        return line.trim().slice(0, 80);
+    }
+    return '';
+}
+/** Extracts all test/describe block names from source code. */
+export function extractAllTestNames(content) {
+    const names = [];
+    for (const pattern of TEST_NAME_PATTERNS) {
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            /* v8 ignore next 1 */
+            const name = match[1] ?? match[0];
+            /* v8 ignore next 1 */
+            if (name) {
+                names.push(name);
+            }
+        }
+    }
+    return names;
+}
+//# sourceMappingURL=keyword-extractor.js.map

package/dist/engine/spec-coverage/keyword-extractor.js.map

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

package/dist/engine/spec-coverage/test-matchers.d.ts

@@ -0,0 +1,9 @@
+import type { TestMatch, CoverageTestFile } from '../../types/index.js';
+/** Strategy 1: look for AC-ID or AC ID (with space or no dash) in test content. */
+export declare function findDirectReferences(acId: string, testFiles: readonly CoverageTestFile[], testContents: ReadonlyMap<string, string>): TestMatch[];
+/** Strategy 2: look for SPEC-ID in file path or content. */
+export declare function findSpecReferences(specId: string, testFiles: readonly CoverageTestFile[], testContents: ReadonlyMap<string, string>): TestMatch[];
+/** Strategy 3: match keywords from criterion text against test names in files. */
+export declare function findKeywordMatches(keywords: readonly string[], testFiles: readonly CoverageTestFile[], testContents: ReadonlyMap<string, string>): TestMatch[];
+export { extractKeywords } from './keyword-extractor.js';
+//# sourceMappingURL=test-matchers.d.ts.map

package/dist/engine/spec-coverage/test-matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-matchers.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-coverage/test-matchers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxE,mFAAmF;AACnF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,gBAAgB,EAAE,EACtC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,SAAS,EAAE,CAkBb;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,gBAAgB,EAAE,EACtC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,SAAS,EAAE,CAgBb;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,SAAS,EAAE,SAAS,gBAAgB,EAAE,EACtC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,SAAS,EAAE,CAqBb;AAGD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/engine/spec-coverage/test-matchers.js

@@ -0,0 +1,59 @@
+// engine/spec-coverage/test-matchers.ts — Test-to-criterion matching strategies.
+// Extracted from criteria-mapper.ts to keep file sizes within limits.
+import { extractTestName, extractAllTestNames } from './keyword-extractor.js';
+/** Strategy 1: look for AC-ID or AC ID (with space or no dash) in test content. */
+export function findDirectReferences(acId, testFiles, testContents) {
+    const matches = [];
+    // Build regex variants: AC-01, AC01, #AC-01, AC 01
+    const acNum = acId.replace('AC-', '');
+    const pattern = new RegExp(`\\b(?:AC[-\\s]?${acNum}|#AC-?${acNum})\\b`, 'i');
+    for (const tf of testFiles) {
+        const content = testContents.get(tf.file) ?? '';
+        if (!pattern.test(content)) {
+            continue;
+        }
+        // Extract the test name from the first matching line
+        const testName = extractTestName(content, pattern);
+        matches.push({ file: tf.file, testName, strategy: 'direct-reference' });
+    }
+    return matches;
+}
+/** Strategy 2: look for SPEC-ID in file path or content. */
+export function findSpecReferences(specId, testFiles, testContents) {
+    const matches = [];
+    const specPattern = new RegExp(`\\b${specId.replace('-', '[-_]?')}\\b`, 'i');
+    for (const tf of testFiles) {
+        const inPath = specPattern.test(tf.file);
+        const content = testContents.get(tf.file) ?? '';
+        const inContent = specPattern.test(content);
+        if (!inPath && !inContent) {
+            continue;
+        }
+        const testName = inContent ? extractTestName(content, specPattern) : tf.file;
+        matches.push({ file: tf.file, testName, strategy: 'spec-reference' });
+    }
+    return matches;
+}
+/** Strategy 3: match keywords from criterion text against test names in files. */
+export function findKeywordMatches(keywords, testFiles, testContents) {
+    const matches = [];
+    for (const tf of testFiles) {
+        const content = testContents.get(tf.file) ?? '';
+        // Extract all describe/it/test block names
+        const testNames = extractAllTestNames(content);
+        const combinedText = [...testNames, tf.file].join(' ').toLowerCase();
+        const matchCount = keywords.filter((kw) => combinedText.includes(kw.toLowerCase())).length;
+        if (matchCount >= 2) {
+            matches.push({
+                file: tf.file,
+                /* v8 ignore next 1 */
+                testName: testNames[0] ?? tf.file,
+                strategy: 'heuristic',
+            });
+        }
+    }
+    return matches;
+}
+// Re-export extractKeywords for backward compatibility
+export { extractKeywords } from './keyword-extractor.js';
+//# sourceMappingURL=test-matchers.js.map

package/dist/engine/spec-coverage/test-matchers.js.map

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

package/dist/engine/spec-migrator.d.ts

@@ -0,0 +1,17 @@
+import type { Spec, SpecMigrationResult, SpecMigrationDeps } from '../types/index.js';
+/**
+ * Detect specs stored under a legacy location (docs/sdd/specs/).
+ * Caller provides the list of specs (from storage layer).
+ */
+export declare function filterLegacySpecs(specs: Spec[]): Spec[];
+/**
+ * Migrate legacy specs to planu/specs/ with modern file naming.
+ * Moves files on disk and calls the provided updateSpec for each migrated spec.
+ * Also rewrites planu.json.
+ */
+export declare function migrateSpecs(projectPath: string, legacySpecs: Spec[], deps: SpecMigrationDeps): Promise<SpecMigrationResult>;
+/**
+ * Check if a project path has a planu.json with legacy specLocation.
+ */
+export declare function hasLegacyConfig(projectPath: string): Promise<boolean>;
+//# sourceMappingURL=spec-migrator.d.ts.map

package/dist/engine/spec-migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-migrator.d.ts","sourceRoot":"","sources":["../../src/engine/spec-migrator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAetF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAEvD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,IAAI,EAAE,EACnB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAoB9B;AA8ED;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS3E"}

package/dist/engine/spec-migrator.js

@@ -0,0 +1,119 @@
+import { isLegacyLocation, createPlanuConfig, serializePlanuConfig, } from './planu-config-writer.js';
+import { mkdir, rename, readdir, rmdir, access, writeFile, readFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+const LEGACY_TO_MODERN_NAMES = {
+    'HU.md': 'spec.md',
+    'FICHA-TECNICA.md': 'technical.md',
+    'PROGRESS.md': 'progress.md',
+};
+/**
+ * Detect specs stored under a legacy location (docs/sdd/specs/).
+ * Caller provides the list of specs (from storage layer).
+ */
+export function filterLegacySpecs(specs) {
+    return specs.filter((s) => isLegacyLocation(s.specPath) || isLegacyLocation(s.technicalPath));
+}
+/**
+ * Migrate legacy specs to planu/specs/ with modern file naming.
+ * Moves files on disk and calls the provided updateSpec for each migrated spec.
+ * Also rewrites planu.json.
+ */
+export async function migrateSpecs(projectPath, legacySpecs, deps) {
+    const errors = [];
+    let migratedCount = 0;
+    for (const spec of legacySpecs) {
+        try {
+            await migrateSingleSpec(projectPath, spec, deps);
+            migratedCount++;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            errors.push(`${spec.id}: ${msg}`);
+        }
+    }
+    // Rewrite planu.json with modern config
+    const planuConfigPath = join(projectPath, 'planu.json');
+    const planuConfig = createPlanuConfig();
+    await writeFile(planuConfigPath, serializePlanuConfig(planuConfig), 'utf-8');
+    return { migratedCount, errors };
+}
+async function migrateSingleSpec(projectPath, spec, deps) {
+    const oldSpecDir = dirname(join(projectPath, spec.specPath));
+    const newRelDir = spec.specPath
+        .replace(/docs\/sdd\/specs/, 'planu/specs')
+        .replace(/\/[^/]+$/, '');
+    const newAbsDir = join(projectPath, newRelDir);
+    // Create target directory
+    await mkdir(newAbsDir, { recursive: true });
+    // Move and rename known files
+    const dirEntries = await safeReaddir(oldSpecDir);
+    for (const entry of dirEntries) {
+        const modernName = LEGACY_TO_MODERN_NAMES[entry] ?? entry;
+        const src = join(oldSpecDir, entry);
+        const dest = join(newAbsDir, modernName);
+        await rename(src, dest);
+    }
+    // Update spec paths in storage
+    const updates = {
+        specPath: rewritePath(spec.specPath),
+        technicalPath: rewritePath(spec.technicalPath),
+    };
+    if (spec.progressPath) {
+        updates.progressPath = rewritePath(spec.progressPath);
+    }
+    if (spec.executiveReportPath) {
+        updates.executiveReportPath = rewritePath(spec.executiveReportPath);
+    }
+    if (spec.technicalReportPath) {
+        updates.technicalReportPath = rewritePath(spec.technicalReportPath);
+    }
+    if (spec.planPath) {
+        updates.planPath = rewritePath(spec.planPath);
+    }
+    await deps.updateSpec(spec.projectId, spec.id, updates);
+    // Cleanup empty legacy directories
+    await cleanupEmptyDirs(oldSpecDir);
+}
+function rewritePath(path) {
+    return path
+        .replace(/docs\/sdd\/specs/, 'planu/specs')
+        .replace(/\/HU\.md$/, '/spec.md')
+        .replace(/\/FICHA-TECNICA\.md$/, '/technical.md')
+        .replace(/\/PROGRESS\.md$/, '/progress.md');
+}
+async function safeReaddir(dir) {
+    try {
+        return await readdir(dir);
+    }
+    catch {
+        return [];
+    }
+}
+async function cleanupEmptyDirs(dir) {
+    try {
+        const entries = await readdir(dir);
+        if (entries.length === 0) {
+            await rmdir(dir);
+            // Try to clean parent too (e.g., docs/sdd/specs/ itself)
+            await cleanupEmptyDirs(dirname(dir));
+        }
+    }
+    catch {
+        // Directory might not exist or not be empty — safe to ignore
+    }
+}
+/**
+ * Check if a project path has a planu.json with legacy specLocation.
+ */
+export async function hasLegacyConfig(projectPath) {
+    try {
+        await access(join(projectPath, 'planu.json'));
+        const content = await readFile(join(projectPath, 'planu.json'), 'utf-8');
+        const config = JSON.parse(content);
+        return config.specLocation ? isLegacyLocation(config.specLocation) : false;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=spec-migrator.js.map

package/dist/engine/spec-migrator.js.map

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

package/dist/engine/spec-templates/catalog-extra.d.ts

@@ -1,4 +1,4 @@
 import type { SpecTemplateEntry } from '../../types/spec-templates.js';
-/** Extra built-in spec templates (data, security, performance). */
+/** Extra built-in spec templates (data, security, performance, integration). */
 export declare const EXTRA_TEMPLATES: SpecTemplateEntry[];
 //# sourceMappingURL=catalog-extra.d.ts.map

package/dist/engine/spec-templates/catalog-extra.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-extra.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-templates/catalog-extra.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,mEAAmE;AACnE,eAAO,MAAM,eAAe,EAAE,iBAAiB,EA0W9C,CAAC"}
+{"version":3,"file":"catalog-extra.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-templates/catalog-extra.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAOvE,gFAAgF;AAChF,eAAO,MAAM,eAAe,EAAE,iBAAiB,EAK9C,CAAC"}