@planu/cli 0.23.2 → 0.25.0

package/dist/engine/spec-changelog/core.js

@@ -0,0 +1,175 @@
+// engine/spec-changelog/core.ts — Changelog entry creation and persistence
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const CHANGELOG_FILENAME = 'CHANGELOG.md';
+const CHANGELOG_VERSION_COMMENT = '<!-- changelog-version: 1 -->';
+/** Format a single changelog entry as Markdown. */
+export function formatEntry(entry, specId) {
+    const lines = [];
+    lines.push(`## ${entry.timestamp} — ${entry.type}`);
+    lines.push('');
+    lines.push(`**Tool**: ${entry.triggeredBy}`);
+    lines.push(`**Descripcion**: ${entry.description}`);
+    lines.push('');
+    if (entry.before !== undefined && entry.after !== undefined) {
+        if (entry.type === 'status_changed') {
+            lines.push(`**Antes**: ${entry.before.status} | **Despues**: ${entry.after.status}`);
+            lines.push(`**Progreso**: ${entry.before.completedCount}/${entry.before.criteriaCount} → ${entry.after.completedCount}/${entry.after.criteriaCount}`);
+        }
+        else {
+            lines.push(`**Criterios antes**: ${entry.before.criteriaCount} | **Criterios despues**: ${entry.after.criteriaCount}`);
+            if (entry.type === 'progress_updated') {
+                lines.push(`**Progreso**: ${entry.before.completedCount}/${entry.before.criteriaCount} → ${entry.after.completedCount}/${entry.after.criteriaCount}`);
+            }
+        }
+        lines.push('');
+    }
+    if (entry.diff !== undefined) {
+        const { added, removed, modified } = entry.diff;
+        const hasCriteriaChanges = added.length > 0 || removed.length > 0 || modified.length > 0;
+        if (hasCriteriaChanges) {
+            lines.push('### Criterios modificados');
+            for (const item of added) {
+                lines.push(`\u2795 ${item}`);
+            }
+            for (const item of removed) {
+                lines.push(`\u2796 ${item}`);
+            }
+            for (const item of modified) {
+                lines.push(`\u270f\ufe0f ${item.after} (antes: ${item.before})`);
+            }
+            lines.push('');
+        }
+    }
+    lines.push('---');
+    lines.push('');
+    void specId; // referenced in header externally
+    return lines.join('\n');
+}
+/** Build the full CHANGELOG.md header for a spec. */
+function buildHeader(specId, specTitle) {
+    const title = specTitle ? `${specId}: ${specTitle}` : specId;
+    return [CHANGELOG_VERSION_COMMENT, '', `# Changelog — ${title}`, '', ''].join('\n');
+}
+/** Parse the timestamp from the first entry in a CHANGELOG.md content. */
+export function parseFirstEntryTimestamp(content) {
+    // Matches lines like: ## 2026-03-04T14:23:00Z — reconciled
+    const match = /^## (\d{4}-\d{2}-\d{2}T[\d:.]+Z) —/m.exec(content);
+    return match?.[1] ?? null;
+}
+/** Parse changelog entries from a CHANGELOG.md content string. */
+export function parseChangelogEntries(content, specId) {
+    const entries = [];
+    // Split on section headers: ## <timestamp> — <type>
+    const sectionRegex = /^## (\d{4}-\d{2}-\d{2}T[\d:.]+Z) — (\w+)/gm;
+    const matches = [...content.matchAll(sectionRegex)];
+    for (const match of matches) {
+        const timestamp = match[1];
+        const type = match[2];
+        if (timestamp === undefined || type === undefined) {
+            continue;
+        }
+        const sectionStart = match.index;
+        const nextMatch = matches[matches.indexOf(match) + 1];
+        const sectionEnd = nextMatch?.index ?? content.length;
+        const sectionContent = content.slice(sectionStart, sectionEnd);
+        // Extract tool name
+        const toolMatch = /\*\*Tool\*\*: (.+)/.exec(sectionContent);
+        const triggeredBy = toolMatch?.[1]?.trim() ?? 'unknown';
+        // Extract description
+        const descMatch = /\*\*Descripcion\*\*: (.+)/.exec(sectionContent);
+        const description = descMatch?.[1]?.trim() ?? '';
+        entries.push({
+            timestamp,
+            type: type,
+            description,
+            triggeredBy,
+        });
+    }
+    void specId;
+    return entries;
+}
+/** Read the CHANGELOG.md for a spec directory. Returns null if not found. */
+export async function readChangelog(options) {
+    const { specDir, specId } = options;
+    const filePath = join(specDir, CHANGELOG_FILENAME);
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const entries = parseChangelogEntries(content, specId);
+        return { specId, entries };
+    }
+    catch {
+        return null;
+    }
+}
+/** Read only the timestamp of the last (most recent) changelog entry. Optimized for list_specs. */
+export async function readLastModifiedTimestamp(specDir) {
+    const filePath = join(specDir, CHANGELOG_FILENAME);
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return parseFirstEntryTimestamp(content);
+    }
+    catch {
+        return null;
+    }
+}
+/** Append a new entry to the CHANGELOG.md for a spec. Creates the file if it doesn't exist. */
+export async function appendChangelogEntry(options) {
+    const { specDir, specId, entry } = options;
+    const filePath = join(specDir, CHANGELOG_FILENAME);
+    try {
+        let existingContent = '';
+        let hasHeader = false;
+        try {
+            existingContent = await readFile(filePath, 'utf-8');
+            hasHeader = existingContent.includes(CHANGELOG_VERSION_COMMENT);
+        }
+        catch {
+            // File doesn't exist yet — will create fresh
+        }
+        const entryMarkdown = formatEntry(entry, specId);
+        let newContent;
+        if (!hasHeader) {
+            newContent = buildHeader(specId) + entryMarkdown + existingContent;
+        }
+        else {
+            // Insert after the header block (after the # Changelog line)
+            const insertAfterPattern = /^# Changelog[^\n]*\n\n/m;
+            const match = insertAfterPattern.exec(existingContent);
+            if (match) {
+                const insertAt = match.index + match[0].length;
+                newContent =
+                    existingContent.slice(0, insertAt) + entryMarkdown + existingContent.slice(insertAt);
+            }
+            else {
+                // Fallback: append after existing content
+                newContent = existingContent + entryMarkdown;
+            }
+        }
+        await writeFile(filePath, newContent, 'utf-8');
+        return true;
+    }
+    catch (error) {
+        console.error(`[spec-changelog] Failed to write CHANGELOG.md for ${specId}:`, error);
+        return false;
+    }
+}
+/** Format a relative date string (e.g. "hace 2 dias") for a timestamp. */
+export function formatRelativeDate(timestamp) {
+    const date = new Date(timestamp);
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+    if (diffDays === 0) {
+        return 'hoy';
+    }
+    if (diffDays === 1) {
+        return 'hace 1 dia';
+    }
+    if (diffDays <= 30) {
+        return `hace ${diffDays} dias`;
+    }
+    // Older than 30 days: return ISO date portion
+    return timestamp.slice(0, 10);
+}
+//# sourceMappingURL=core.js.map

package/dist/engine/spec-changelog/core.js.map

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

package/dist/engine/spec-changelog/diff.d.ts

@@ -0,0 +1,18 @@
+import type { CriteriaDiff } from '../../types/index.js';
+/** Normalize a criteria text for comparison (trim, collapse whitespace). */
+export declare function normalizeCriteriaText(text: string): string;
+/**
+ * Compute a simple similarity score (0–1) between two strings.
+ * Uses character bigram overlap.
+ */
+export declare function similarityScore(a: string, b: string): number;
+/**
+ * Compute semantic diff between two sets of criteria texts.
+ * Returns added, removed, and modified criteria.
+ */
+export declare function computeCriteriaDiff(before: string[], after: string[]): CriteriaDiff;
+/**
+ * Returns true if the diff contains any actual changes.
+ */
+export declare function hasDiffChanges(diff: CriteriaDiff): boolean;
+//# sourceMappingURL=diff.d.ts.map

package/dist/engine/spec-changelog/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-changelog/diff.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA8B5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,CA0EnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE1D"}

package/dist/engine/spec-changelog/diff.js

@@ -0,0 +1,116 @@
+// engine/spec-changelog/diff.ts — Semantic diff calculation for spec criteria
+/** Normalize a criteria text for comparison (trim, collapse whitespace). */
+export function normalizeCriteriaText(text) {
+    return text
+        .replace(/^#+\s+/, '') // remove markdown headers
+        .replace(/\*\*/g, '') // remove bold markers
+        .replace(/\s+/g, ' ') // collapse whitespace
+        .trim()
+        .toLowerCase();
+}
+/**
+ * Compute a simple similarity score (0–1) between two strings.
+ * Uses character bigram overlap.
+ */
+export function similarityScore(a, b) {
+    if (a.length === 0 && b.length === 0) {
+        return 0;
+    }
+    if (a === b) {
+        return 1;
+    }
+    if (a.length === 0 || b.length === 0) {
+        return 0;
+    }
+    const buildBigrams = (str) => {
+        const bigrams = new Set();
+        for (let i = 0; i < str.length - 1; i++) {
+            bigrams.add(str.slice(i, i + 2));
+        }
+        return bigrams;
+    };
+    const bigramsA = buildBigrams(a);
+    const bigramsB = buildBigrams(b);
+    let intersection = 0;
+    for (const bigram of bigramsA) {
+        if (bigramsB.has(bigram)) {
+            intersection++;
+        }
+    }
+    return (2 * intersection) / (bigramsA.size + bigramsB.size);
+}
+/**
+ * Compute semantic diff between two sets of criteria texts.
+ * Returns added, removed, and modified criteria.
+ */
+export function computeCriteriaDiff(before, after) {
+    const normalizedBefore = before.map(normalizeCriteriaText);
+    const normalizedAfter = after.map(normalizeCriteriaText);
+    const SIMILARITY_THRESHOLD = 0.6;
+    const matchedBeforeIndices = new Set();
+    const matchedAfterIndices = new Set();
+    const modified = [];
+    // Find modifications: pairs with high similarity but not identical
+    for (let i = 0; i < normalizedBefore.length; i++) {
+        const nb = normalizedBefore[i];
+        /* v8 ignore next 2 — noUncheckedIndexedAccess guard; array built with .map() so never undefined */
+        if (nb === undefined) {
+            continue;
+        }
+        let bestScore = 0;
+        let bestJ = -1;
+        for (let j = 0; j < normalizedAfter.length; j++) {
+            if (matchedAfterIndices.has(j)) {
+                continue;
+            }
+            const na = normalizedAfter[j];
+            /* v8 ignore next 2 — noUncheckedIndexedAccess guard; array built with .map() so never undefined */
+            if (na === undefined) {
+                continue;
+            }
+            const score = similarityScore(nb, na);
+            if (score > bestScore) {
+                bestScore = score;
+                bestJ = j;
+            }
+        }
+        if (bestScore >= SIMILARITY_THRESHOLD && bestJ !== -1) {
+            matchedBeforeIndices.add(i);
+            matchedAfterIndices.add(bestJ);
+            const beforeText = before[i];
+            const afterText = after[bestJ];
+            // Only report as modified if texts actually differ
+            if (beforeText !== undefined && afterText !== undefined && beforeText !== afterText) {
+                modified.push({ before: beforeText, after: afterText });
+            }
+        }
+    }
+    // Removed: unmatched before items
+    const removed = [];
+    for (let i = 0; i < before.length; i++) {
+        if (!matchedBeforeIndices.has(i)) {
+            const text = before[i];
+            if (text !== undefined) {
+                removed.push(text);
+            }
+        }
+    }
+    // Added: unmatched after items
+    const added = [];
+    for (let j = 0; j < after.length; j++) {
+        if (!matchedAfterIndices.has(j)) {
+            const text = after[j];
+            if (text !== undefined) {
+                added.push(text);
+            }
+        }
+    }
+    return { added, removed, modified };
+}
+/**
+ * Returns true if the diff contains any actual changes.
+ */
+export function hasDiffChanges(diff) {
+    return diff.added.length > 0 || diff.removed.length > 0 || diff.modified.length > 0;
+}
+//# sourceMappingURL=diff.js.map

package/dist/engine/spec-changelog/diff.js.map

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

package/dist/engine/spec-changelog/index.d.ts

@@ -0,0 +1,3 @@
+export * from './core.js';
+export * from './diff.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/spec-changelog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-changelog/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/engine/spec-changelog/index.js

@@ -0,0 +1,4 @@
+// engine/spec-changelog/index.ts — Barrel export for spec-changelog module
+export * from './core.js';
+export * from './diff.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/spec-changelog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/spec-changelog/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/engine/spec-coverage/core.d.ts

@@ -0,0 +1,14 @@
+import type { SpecCoverageResult, SpecCoverageStore, CoverageGrade } from '../../types/index.js';
+/**
+ * Runs the full spec coverage analysis for one spec.
+ * Reads the HU.md, discovers test files, maps tests to criteria, calculates
+ * score and grade, persists results, and returns the result object.
+ */
+export declare function analyzeSpecCoverage(projectId: string, specId: string, huPath: string, projectPath: string): Promise<SpecCoverageResult>;
+/**
+ * Loads persisted coverage results from storage for a project.
+ * Returns null if no data exists or the file is corrupted.
+ */
+export declare function loadCoverageStore(projectId: string): Promise<SpecCoverageStore | null>;
+export declare function calculateGrade(score: number): CoverageGrade;
+//# sourceMappingURL=core.d.ts.map

package/dist/engine/spec-coverage/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-coverage/core.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EAEd,MAAM,sBAAsB,CAAC;AAe9B;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA4D7B;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAa5F;AAMD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAW3D"}

package/dist/engine/spec-coverage/core.js

@@ -0,0 +1,132 @@
+// engine/spec-coverage/core.ts — Orchestrator for spec coverage analysis.
+// Coordinates test-finder, criteria-mapper, scoring, and persistence.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { readJson, writeJson, projectDataDir } from '../../storage/base-store.js';
+import { findTestFiles, detectTestRunners, readTestFileContent } from './test-finder.js';
+import { extractCriteria, mapTestsToCriterion } from './criteria-mapper.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const COVERAGE_FILE = 'spec-coverage.json';
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Runs the full spec coverage analysis for one spec.
+ * Reads the HU.md, discovers test files, maps tests to criteria, calculates
+ * score and grade, persists results, and returns the result object.
+ */
+export async function analyzeSpecCoverage(projectId, specId, huPath, projectPath) {
+    // 1. Read HU.md content
+    const huContent = await readHuFile(huPath);
+    // 2. Extract acceptance criteria
+    const rawCriteria = extractCriteria(huContent);
+    if (rawCriteria.length === 0) {
+        throw new Error(`No acceptance criteria found in HU.md for spec ${specId}. ` +
+            `Expected format: "- [ ] **AC-01**: description"`);
+    }
+    // 3. Find test files
+    const testFiles = await findTestFiles(projectPath);
+    // 4. Load test file contents (needed for criteria mapping)
+    const testContents = new Map();
+    await Promise.all(testFiles.map(async (tf) => {
+        const content = await readTestFileContent(projectPath, tf.file);
+        testContents.set(tf.file, content);
+    }));
+    // 5. Map each criterion to tests
+    const criteria = rawCriteria.map((rc) => mapTestsToCriterion(rc, testFiles, testContents, specId));
+    // 6. Detect test runners
+    const detectedRunners = await detectTestRunners(projectPath);
+    // 7. Calculate score and grade
+    const coveredCriteria = criteria.filter((c) => c.status === 'covered').length;
+    const superficialCriteria = criteria.filter((c) => c.status === 'superficial').length;
+    const uncoveredCriteria = criteria.filter((c) => c.status === 'uncovered').length;
+    const totalCriteria = criteria.length;
+    // Only high/medium confidence (covered) counts toward the score
+    const score = totalCriteria > 0 ? Math.round((coveredCriteria / totalCriteria) * 100) : 0;
+    const grade = calculateGrade(score);
+    const result = {
+        specId,
+        analyzedAt: new Date().toISOString(),
+        score,
+        grade,
+        totalCriteria,
+        coveredCriteria,
+        superficialCriteria,
+        uncoveredCriteria,
+        detectedRunners,
+        criteria,
+    };
+    // 8. Persist (best-effort — never throw on persistence failure)
+    await persistResult(projectId, specId, result);
+    return result;
+}
+/**
+ * Loads persisted coverage results from storage for a project.
+ * Returns null if no data exists or the file is corrupted.
+ */
+export async function loadCoverageStore(projectId) {
+    const filePath = join(projectDataDir(projectId), COVERAGE_FILE);
+    const defaultStore = { version: 1, updatedAt: '', specs: {} };
+    try {
+        const store = await readJson(filePath, defaultStore);
+        /* c8 ignore next 3 — defensive guard for corrupted files */
+        if (typeof store.specs !== 'object') {
+            return null;
+        }
+        return store;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Scoring helpers
+// ---------------------------------------------------------------------------
+export function calculateGrade(score) {
+    if (score >= 90) {
+        return 'A';
+    }
+    if (score >= 75) {
+        return 'B';
+    }
+    if (score >= 50) {
+        return 'C';
+    }
+    return 'D';
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+async function readHuFile(huPath) {
+    try {
+        return await readFile(huPath, 'utf-8');
+    }
+    catch (err) {
+        throw new Error(`Cannot read HU.md at "${huPath}": ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+}
+async function persistResult(projectId, specId, result) {
+    const filePath = join(projectDataDir(projectId), COVERAGE_FILE);
+    try {
+        const existing = await readJson(filePath, {
+            version: 1,
+            updatedAt: '',
+            specs: {},
+        });
+        const updated = {
+            version: 1,
+            updatedAt: new Date().toISOString(),
+            specs: {
+                ...existing.specs,
+                [specId]: result,
+            },
+        };
+        await writeJson(filePath, updated);
+    }
+    catch {
+        // Persistence failure is non-fatal — analysis result is still returned
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/engine/spec-coverage/core.js.map

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

package/dist/engine/spec-coverage/criteria-mapper.d.ts

@@ -0,0 +1,18 @@
+import type { CriterionCoverage, CoverageTestFile, RawCriterion } from '../../types/index.js';
+/**
+ * Parses HU.md content and returns a list of acceptance criteria with their
+ * identifiers and descriptions. Supports flexible AC formats:
+ *   - `- [ ] **AC-01**: text`
+ *   - `- **AC-01**: text`
+ *   - `AC-01: text`
+ *   - `- AC-01 text`
+ */
+export declare function extractCriteria(huContent: string): readonly RawCriterion[];
+/**
+ * Maps a list of test files to a single criterion using the 3 strategies
+ * defined in SPEC-068. Returns the full CriterionCoverage for that criterion.
+ */
+export declare function mapTestsToCriterion(criterion: RawCriterion, testFiles: readonly CoverageTestFile[], testContents: ReadonlyMap<string, string>, specId: string): CriterionCoverage;
+/** Extracts 3–5 meaningful keywords from an AC description text. */
+export declare function extractKeywords(text: string): readonly string[];
+//# sourceMappingURL=criteria-mapper.d.ts.map

package/dist/engine/spec-coverage/criteria-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria-mapper.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-coverage/criteria-mapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EAIjB,gBAAgB,EAChB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAiF9B;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAmC1E;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,YAAY,EACvB,SAAS,EAAE,SAAS,gBAAgB,EAAE,EACtC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,MAAM,EAAE,MAAM,GACb,iBAAiB,CAsCnB;AAsFD,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAkB/D"}