@planu/cli 0.24.0 → 0.26.0

package/dist/engine/registry/matcher.js

@@ -0,0 +1,150 @@
+// engine/registry/matcher.ts — Detects framework mentions and API references in spec text
+// Uses registry-aware keywords to avoid false positives on plain English words.
+/** Mapping of framework ID → detection keywords (aliases / common spellings). */
+const FRAMEWORK_ALIASES = {
+    nextjs: ['next.js', 'nextjs', 'next js', 'next/navigation', 'next/router', 'app router'],
+    react: ['react', 'react dom', 'reactdom', 'jsx', 'useState', 'useEffect', 'useCallback'],
+    vue: ['vue', 'vue 3', 'vue.js', 'vuejs', 'composition api', 'script setup'],
+    nuxt: ['nuxt', 'nuxt 3', 'nuxt.js', 'usefetch', 'definepageeta'],
+    angular: ['angular', 'angular 17', '@angular', 'standalone component', 'angularjs'],
+    sveltekit: ['sveltekit', 'svelte kit', 'svelte', '+page.server.ts', 'use:enhance'],
+    astro: ['astro', 'astro.js', 'astro 4', 'client:load', 'getcollection'],
+    remix: ['remix', 'remix 2', '@remix-run', 'useloaderdata', 'useactiondata'],
+    express: ['express', 'express.js', 'expressjs', 'express.router', 'app.get(', 'app.use('],
+    nestjs: ['nestjs', 'nest.js', '@nestjs', '@injectable', '@controller', '@module'],
+    django: ['django', 'django 5', 'django orm', 'models.model', 'views.py', 'urls.py'],
+    fastapi: [
+        'fastapi',
+        'fast api',
+        'fastapi route',
+        '@app.get',
+        '@app.post',
+        'pydantic v2',
+        'basemodel',
+    ],
+    springboot: [
+        'spring boot',
+        'springboot',
+        '@springbootapplication',
+        '@restcontroller',
+        'jparepository',
+    ],
+    rails: ['rails', 'ruby on rails', 'activerecord', 'activesupport', 'hotwire', 'turbo'],
+    laravel: ['laravel', 'laravel 11', 'eloquent', 'artisan', 'blade template'],
+    gin: ['gin framework', 'gin.new()', 'gin.default()', 'c.json(', 'gin.h{', 'c.shouldbindjson'],
+    actix: ['actix-web', 'actix web', 'actix 4', 'web::data', 'httpresponse', 'web::path'],
+    aspnet: ['asp.net', 'aspnet', '.net core', 'dotnet', '@controller', 'iactionresult', 'blazor'],
+    flutter: [
+        'flutter',
+        'dart flutter',
+        'statefulwidget',
+        'statelesswidget',
+        'buildcontext',
+        'scaffold(',
+    ],
+    swiftui: ['swiftui', 'swift ui', '@state', '@observedobject', '@stateobject', 'navigationstack'],
+};
+/** Regex patterns to detect API/pattern references in text. */
+const API_PATTERNS = [
+    // Function calls: functionName() or method.call()
+    /\b([a-zA-Z$_][a-zA-Z0-9$_.]{2,})\s*\(/g,
+    // Import statements
+    /import\s+.*?\s+from\s+['"]([^'"]+)['"]/g,
+    // Config keys: key.subkey = value
+    /\b([a-z][a-z0-9-]{2,}\.[a-z][a-z0-9-.]{2,})\s*=/g,
+    // Decorator-like patterns: @SomeName
+    /@([A-Z][a-zA-Z0-9]+)/g,
+];
+/**
+ * Detect which frameworks from the registry are mentioned in the spec text.
+ * A framework is considered mentioned if one of its aliases appears in the text
+ * (case-insensitive). Avoids single-word generic terms without API context.
+ */
+export function detectFrameworks(specText, registry) {
+    const lower = specText.toLowerCase();
+    const detected = [];
+    for (const [frameworkId, aliases] of Object.entries(FRAMEWORK_ALIASES)) {
+        if (!registry.has(frameworkId)) {
+            continue;
+        }
+        const matched = aliases.some((alias) => lower.includes(alias.toLowerCase()));
+        if (matched) {
+            detected.push(frameworkId);
+        }
+    }
+    return [...new Set(detected)];
+}
+/**
+ * Extract potential API/pattern references from spec text for specific frameworks.
+ * Returns deduplicated references with framework attribution.
+ */
+export function extractReferences(specText, frameworkIds, registry) {
+    const references = [];
+    const seen = new Set();
+    for (const frameworkId of frameworkIds) {
+        const entry = registry.get(frameworkId);
+        if (!entry) {
+            continue;
+        }
+        // Extract all pattern-like tokens from the text
+        for (const regex of API_PATTERNS) {
+            const cloned = new RegExp(regex.source, regex.flags);
+            let match;
+            while ((match = cloned.exec(specText)) !== null) {
+                const token = (match[1] ?? match[0]).trim();
+                const key = `${frameworkId}::${token}`;
+                if (seen.has(key) || token.length < 3) {
+                    continue;
+                }
+                seen.add(key);
+                const kind = determineKind(match[0]);
+                references.push({ framework: frameworkId, text: token, kind });
+            }
+        }
+    }
+    return references;
+}
+/** Determine the kind of reference from the matched text. */
+function determineKind(rawMatch) {
+    if (rawMatch.startsWith('import')) {
+        return 'import';
+    }
+    if (rawMatch.startsWith('@')) {
+        return 'api-call';
+    }
+    if (/=\s*$/.test(rawMatch)) {
+        return 'config-key';
+    }
+    return 'pattern-mention';
+}
+/**
+ * Detect any framework names mentioned in the spec that are NOT in the registry.
+ * Scans for common framework keywords in text that don't map to known entries.
+ */
+export function detectUnknownFrameworks(specText, registry) {
+    const lower = specText.toLowerCase();
+    const knownFrameworkNames = new Set([...registry.values()].map((e) => e.displayName.toLowerCase()));
+    // Broad keyword scan for frameworks not in registry
+    const frameworkMentionRegex = /\b((?:[a-z][a-z0-9-]{1,}\.?(?:js|ts|py|rb|php|go|rs))|(?:fastify|hono|elysia|fiber|axum|rocket|gin|echo|koa|hapi|oak|deno|bun))\b/gi;
+    const unknown = [];
+    const seen = new Set();
+    let m;
+    while ((m = frameworkMentionRegex.exec(lower)) !== null) {
+        const name = (m[1] ?? '').toLowerCase();
+        if (!seen.has(name) && !knownFrameworkNames.has(name) && !isInRegistry(name, registry)) {
+            seen.add(name);
+            unknown.push(m[1] ?? name);
+        }
+    }
+    return unknown;
+}
+/** Check if a name matches any alias in the registry. */
+function isInRegistry(name, registry) {
+    for (const aliases of Object.values(FRAMEWORK_ALIASES)) {
+        if (aliases.some((a) => a.toLowerCase() === name.toLowerCase())) {
+            return true;
+        }
+    }
+    return registry.has(name);
+}
+//# sourceMappingURL=matcher.js.map

package/dist/engine/registry/matcher.js.map

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

package/dist/engine/registry/reporter.d.ts

@@ -0,0 +1,10 @@
+import type { SpecAccuracyReport, RegistryEntry, ValidationResult } from '../../types/index.js';
+/**
+ * Build the full SpecAccuracyReport from validation results and metadata.
+ */
+export declare function buildReport(results: ValidationResult[], frameworksDetected: string[], frameworksNotInRegistry: string[], registry: Map<string, RegistryEntry>): SpecAccuracyReport;
+/**
+ * Format a SpecAccuracyReport as a Markdown string for display in MCP response.
+ */
+export declare function formatReport(report: SpecAccuracyReport): string;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/engine/registry/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/reporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAElB,aAAa,EACb,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAkD9B;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,kBAAkB,EAAE,MAAM,EAAE,EAC5B,uBAAuB,EAAE,MAAM,EAAE,EACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACnC,kBAAkB,CAepB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAkF/D"}

package/dist/engine/registry/reporter.js

@@ -0,0 +1,132 @@
+// engine/registry/reporter.ts — Builds the SpecAccuracyReport from validation results
+/** Threshold (days) beyond which a registry entry is considered stale. */
+const STALE_DAYS = 180;
+const MS_PER_DAY = 86_400_000;
+/** Calculate score as percentage of references that were validated (not unknown). */
+function calculateScore(results) {
+    if (results.length === 0) {
+        return 100;
+    }
+    const validated = results.filter((r) => r.status !== 'unknown').length;
+    return Math.round((validated / results.length) * 100);
+}
+/** Extract unique issues from validation results (skip valid ones). */
+function collectIssues(results) {
+    const seen = new Set();
+    const issues = [];
+    for (const result of results) {
+        if (result.status === 'valid' || !result.issue) {
+            continue;
+        }
+        const key = `${result.issue.type}::${result.issue.framework}::${result.issue.reference}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            issues.push(result.issue);
+        }
+    }
+    return issues;
+}
+/** Find registry entries that haven't been updated in more than 180 days. */
+function detectStaleEntries(frameworkIds, registry) {
+    const now = Date.now();
+    return frameworkIds.filter((id) => {
+        const entry = registry.get(id);
+        /* v8 ignore next 2 — defensive guard; callers pass IDs from detectFrameworks() which already filters by registry */
+        if (!entry) {
+            return false;
+        }
+        const updated = new Date(entry.lastUpdated).getTime();
+        return !isNaN(updated) && now - updated > STALE_DAYS * MS_PER_DAY;
+    });
+}
+/**
+ * Build the full SpecAccuracyReport from validation results and metadata.
+ */
+export function buildReport(results, frameworksDetected, frameworksNotInRegistry, registry) {
+    const issues = collectIssues(results);
+    const score = calculateScore(results);
+    const validatedReferences = results.filter((r) => r.status !== 'unknown').length;
+    const staleRegistryEntries = detectStaleEntries(frameworksDetected, registry);
+    return {
+        score,
+        issues,
+        frameworksDetected,
+        frameworksNotInRegistry,
+        totalReferencesChecked: results.length,
+        validatedReferences,
+        staleRegistryEntries,
+    };
+}
+/**
+ * Format a SpecAccuracyReport as a Markdown string for display in MCP response.
+ */
+export function formatReport(report) {
+    const lines = [];
+    lines.push('## Spec Accuracy Report');
+    lines.push('');
+    lines.push(`**Score de confianza:** ${report.score}/100`);
+    lines.push(`**Referencias analizadas:** ${report.totalReferencesChecked}`);
+    lines.push(`**Referencias validadas:** ${report.validatedReferences}`);
+    lines.push('');
+    if (report.frameworksDetected.length > 0) {
+        lines.push(`**Frameworks detectados:** ${report.frameworksDetected.join(', ')}`);
+    }
+    if (report.frameworksNotInRegistry.length > 0) {
+        lines.push('');
+        lines.push('### Advertencias — Frameworks no en registry');
+        lines.push('');
+        for (const fw of report.frameworksNotInRegistry) {
+            lines.push(`- Framework '${fw}' no encontrado en el registry — las referencias a su API no pudieron ser validadas`);
+        }
+    }
+    if (report.staleRegistryEntries.length > 0) {
+        lines.push('');
+        lines.push('### Advertencias — Entradas desactualizadas');
+        lines.push('');
+        for (const fw of report.staleRegistryEntries) {
+            lines.push(`- La entrada de '${fw}' tiene mas de 180 dias sin actualizar — verificar si los patrones siguen vigentes`);
+        }
+    }
+    const errors = report.issues.filter((i) => i.severity === 'error');
+    const warnings = report.issues.filter((i) => i.severity === 'warning');
+    const infos = report.issues.filter((i) => i.severity === 'info');
+    if (errors.length > 0) {
+        lines.push('');
+        lines.push('### Errores detectados');
+        lines.push('');
+        for (const issue of errors) {
+            lines.push(`- **[${issue.framework}]** \`${issue.reference}\``);
+            if (issue.suggestion) {
+                lines.push(`  - Sugerencia: ${issue.suggestion}`);
+            }
+        }
+    }
+    if (warnings.length > 0) {
+        lines.push('');
+        lines.push('### Advertencias de patrones');
+        lines.push('');
+        for (const issue of warnings) {
+            lines.push(`- **[${issue.framework}]** \`${issue.reference}\``);
+            if (issue.suggestion) {
+                lines.push(`  - Sugerencia: ${issue.suggestion}`);
+            }
+        }
+    }
+    if (infos.length > 0) {
+        lines.push('');
+        lines.push('### Informacion adicional');
+        lines.push('');
+        for (const issue of infos) {
+            lines.push(`- **[${issue.framework}]** ${issue.reference}`);
+            if (issue.suggestion) {
+                lines.push(`  - ${issue.suggestion}`);
+            }
+        }
+    }
+    if (report.issues.length === 0) {
+        lines.push('');
+        lines.push('No se detectaron problemas en las referencias analizadas.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=reporter.js.map

package/dist/engine/registry/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../../src/engine/registry/reporter.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAStF,0EAA0E;AAC1E,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B,qFAAqF;AACrF,SAAS,cAAc,CAAC,OAA2B;IACjD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACvE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,uEAAuE;AACvE,SAAS,aAAa,CAAC,OAA2B;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC/C,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACzF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6EAA6E;AAC7E,SAAS,kBAAkB,CACzB,YAAsB,EACtB,QAAoC;IAEpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/B,oHAAoH;QACpH,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;QACtD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,OAA2B,EAC3B,kBAA4B,EAC5B,uBAAiC,EACjC,QAAoC;IAEpC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACjF,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAE9E,OAAO;QACL,KAAK;QACL,MAAM;QACN,kBAAkB;QAClB,uBAAuB;QACvB,sBAAsB,EAAE,OAAO,CAAC,MAAM;QACtC,mBAAmB;QACnB,oBAAoB;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,+BAA+B,MAAM,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC3E,KAAK,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACvE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,MAAM,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,MAAM,CAAC,uBAAuB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,uBAAuB,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CACR,gBAAgB,EAAE,qFAAqF,CACxG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CACR,oBAAoB,EAAE,oFAAoF,CAC3G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IAEjE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,SAAS,SAAS,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;YAChE,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,SAAS,SAAS,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;YAChE,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,SAAS,OAAO,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YAC5D,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/engine/registry/validator.d.ts

@@ -0,0 +1,17 @@
+import type { RegistryEntry, FrameworkReference, ValidationResult } from '../../types/index.js';
+export type { ValidationResult };
+/**
+ * Validate a single reference against its framework registry entry.
+ * Precedence: mistake > deprecated > correct > unknown
+ */
+export declare function validateReference(ref: FrameworkReference, registry: Map<string, RegistryEntry>): ValidationResult;
+/**
+ * Validate all references and return the classification results.
+ * References for frameworks not in the registry are skipped (handled separately).
+ */
+export declare function validateReferences(references: FrameworkReference[], registry: Map<string, RegistryEntry>): ValidationResult[];
+/**
+ * Detect registry entries that have not been updated in more than 180 days.
+ */
+export declare function detectStaleEntries(registry: Map<string, RegistryEntry>): string[];
+//# sourceMappingURL=validator.d.ts.map

package/dist/engine/registry/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/validator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EAEb,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAsCjC;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,kBAAkB,EACvB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACnC,gBAAgB,CAiDlB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,kBAAkB,EAAE,EAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACnC,gBAAgB,EAAE,CAEpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,MAAM,EAAE,CAajF"}

package/dist/engine/registry/validator.js

@@ -0,0 +1,103 @@
+// engine/registry/validator.ts — Compares extracted references against registry entries
+// Classifies each reference as: valid, deprecated, mistake, or unknown
+/** Search through all patterns in a registry entry to find a match. */
+function findInPatterns(token, patterns) {
+    const lowerToken = token.toLowerCase();
+    return patterns.some((p) => {
+        const lowerPattern = p.pattern.toLowerCase();
+        const lowerExample = (p.example ?? '').toLowerCase();
+        return lowerPattern.includes(lowerToken) || lowerExample.includes(lowerToken);
+    });
+}
+/** Find a matching deprecated pattern and return its replacement. */
+function findDeprecated(token, patterns) {
+    const lowerToken = token.toLowerCase();
+    return patterns.find((p) => {
+        const lowerPattern = p.pattern.toLowerCase();
+        const lowerExample = (p.example ?? '').toLowerCase();
+        return lowerPattern.includes(lowerToken) || lowerExample.includes(lowerToken);
+    });
+}
+/** Find a matching common mistake and return it. */
+function findMistake(token, patterns) {
+    const lowerToken = token.toLowerCase();
+    return patterns.find((p) => {
+        const lowerPattern = p.pattern.toLowerCase();
+        const lowerExample = (p.example ?? '').toLowerCase();
+        return lowerPattern.includes(lowerToken) || lowerExample.includes(lowerToken);
+    });
+}
+/**
+ * Validate a single reference against its framework registry entry.
+ * Precedence: mistake > deprecated > correct > unknown
+ */
+export function validateReference(ref, registry) {
+    const entry = registry.get(ref.framework);
+    if (!entry) {
+        return {
+            reference: ref,
+            status: 'unknown',
+            issue: {
+                type: 'unknown-framework',
+                framework: ref.framework,
+                reference: ref.text,
+                suggestion: `Framework '${ref.framework}' no encontrado en el registry`,
+                severity: 'warning',
+            },
+        };
+    }
+    // Check common mistakes first (highest priority — explicit errors)
+    const mistake = findMistake(ref.text, entry.commonMistakes);
+    if (mistake) {
+        const issue = {
+            type: 'invalid-api',
+            framework: ref.framework,
+            reference: ref.text,
+            suggestion: mistake.replacedBy ? `Usar en su lugar: ${mistake.replacedBy}` : mistake.pattern,
+            severity: mistake.severity ?? 'warning',
+        };
+        return { reference: ref, status: 'mistake', issue };
+    }
+    // Check deprecated patterns
+    const deprecated = findDeprecated(ref.text, entry.deprecatedPatterns);
+    if (deprecated) {
+        const issue = {
+            type: 'deprecated-pattern',
+            framework: ref.framework,
+            reference: ref.text,
+            suggestion: `Patron obsoleto. Reemplazar con: ${deprecated.replacedBy}`,
+            severity: deprecated.severity ?? 'warning',
+        };
+        return { reference: ref, status: 'deprecated', issue };
+    }
+    // Check correct patterns
+    if (findInPatterns(ref.text, entry.correctPatterns)) {
+        return { reference: ref, status: 'valid' };
+    }
+    // Not found in any pattern list — unknown but not an error
+    return { reference: ref, status: 'unknown' };
+}
+/**
+ * Validate all references and return the classification results.
+ * References for frameworks not in the registry are skipped (handled separately).
+ */
+export function validateReferences(references, registry) {
+    return references.map((ref) => validateReference(ref, registry));
+}
+/**
+ * Detect registry entries that have not been updated in more than 180 days.
+ */
+export function detectStaleEntries(registry) {
+    const now = Date.now();
+    const MS_PER_DAY = 86_400_000;
+    const STALE_DAYS = 180;
+    const stale = [];
+    for (const entry of registry.values()) {
+        const updated = new Date(entry.lastUpdated).getTime();
+        if (!isNaN(updated) && now - updated > STALE_DAYS * MS_PER_DAY) {
+            stale.push(entry.framework);
+        }
+    }
+    return stale;
+}
+//# sourceMappingURL=validator.js.map

package/dist/engine/registry/validator.js.map

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

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

@@ -0,0 +1,16 @@
+import type { SpecChangelogEntry, SpecChangelogData, AppendChangelogOptions, ReadChangelogOptions } from '../../types/index.js';
+/** Format a single changelog entry as Markdown. */
+export declare function formatEntry(entry: SpecChangelogEntry, specId: string): string;
+/** Parse the timestamp from the first entry in a CHANGELOG.md content. */
+export declare function parseFirstEntryTimestamp(content: string): string | null;
+/** Parse changelog entries from a CHANGELOG.md content string. */
+export declare function parseChangelogEntries(content: string, specId: string): SpecChangelogEntry[];
+/** Read the CHANGELOG.md for a spec directory. Returns null if not found. */
+export declare function readChangelog(options: ReadChangelogOptions): Promise<SpecChangelogData | null>;
+/** Read only the timestamp of the last (most recent) changelog entry. Optimized for list_specs. */
+export declare function readLastModifiedTimestamp(specDir: string): Promise<string | null>;
+/** Append a new entry to the CHANGELOG.md for a spec. Creates the file if it doesn't exist. */
+export declare function appendChangelogEntry(options: AppendChangelogOptions): Promise<boolean>;
+/** Format a relative date string (e.g. "hace 2 dias") for a timestamp. */
+export declare function formatRelativeDate(timestamp: string): string;
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-changelog/core.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,kBAAkB,EAElB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAK9B,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAmD7E;AAQD,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIvE;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAqC3F;AAED,6EAA6E;AAC7E,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAWnC;AAED,mGAAmG;AACnG,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASvF;AAED,+FAA+F;AAC/F,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAwC5F;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAkB5D"}

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