@planu/cli 0.24.0 → 0.25.0

package/dist/engine/hooks/templates.js

@@ -0,0 +1,138 @@
+// engine/hooks/templates.ts — Predefined hook templates for common workflows (SPEC-071)
+// ---------------------------------------------------------------------------
+// Built-in templates
+// ---------------------------------------------------------------------------
+/**
+ * sdd-full: Full SDD workflow automation.
+ * Validates spec on creation, logs when done.
+ */
+const SDD_FULL_TEMPLATE = {
+    name: 'sdd-full',
+    description: 'Full SDD workflow: validate on creation, audit on done',
+    hooks: [
+        {
+            name: 'Auto-validate on spec creation',
+            description: 'Runs validate tool whenever a new spec is created',
+            trigger: 'on_spec_created',
+            actions: [
+                {
+                    type: 'run_tool',
+                    tool: 'validate',
+                    args: {},
+                },
+            ],
+            enabled: true,
+        },
+        {
+            name: 'Log spec completion',
+            description: 'Logs a message when a spec reaches done status',
+            trigger: 'on_spec_status_change',
+            filter: { toStatus: 'done' },
+            actions: [
+                {
+                    type: 'log_message',
+                    message: 'Spec {{specId}} is now done in project {{projectId}}',
+                },
+            ],
+            enabled: true,
+        },
+    ],
+};
+/**
+ * ci-ready: CI/CD integration hooks.
+ * Runs checks on drift detection and commit events.
+ */
+const CI_READY_TEMPLATE = {
+    name: 'ci-ready',
+    description: 'CI/CD integration: alert on drift, notify on commit',
+    hooks: [
+        {
+            name: 'Alert on drift',
+            description: 'Logs alert when drift is detected above threshold',
+            trigger: 'on_drift_detected',
+            actions: [
+                {
+                    type: 'log_message',
+                    message: 'DRIFT ALERT: spec {{specId}} drift score {{driftScore}} in project {{projectId}}',
+                },
+            ],
+            enabled: true,
+        },
+        {
+            name: 'Log commit events',
+            description: 'Records commit information for traceability',
+            trigger: 'on_commit',
+            actions: [
+                {
+                    type: 'log_message',
+                    message: 'Commit {{commitHash}} on branch {{branch}}: {{commitMessage}}',
+                },
+            ],
+            enabled: true,
+        },
+    ],
+};
+/**
+ * quality-gate: Enforces quality gates at critical transitions.
+ */
+const QUALITY_GATE_TEMPLATE = {
+    name: 'quality-gate',
+    description: 'Quality gates: audit before implementing, validate on review',
+    hooks: [
+        {
+            name: 'Audit before implementing',
+            description: 'Runs audit tool when spec moves to implementing',
+            trigger: 'on_spec_status_change',
+            filter: { toStatus: 'implementing' },
+            actions: [
+                {
+                    type: 'run_tool',
+                    tool: 'audit',
+                    args: {},
+                },
+            ],
+            enabled: true,
+        },
+        {
+            name: 'Validate on review',
+            description: 'Runs validate tool when spec moves to review',
+            trigger: 'on_spec_status_change',
+            filter: { toStatus: 'review' },
+            actions: [
+                {
+                    type: 'run_tool',
+                    tool: 'validate',
+                    args: {},
+                },
+            ],
+            enabled: true,
+        },
+    ],
+};
+// ---------------------------------------------------------------------------
+// Template registry
+// ---------------------------------------------------------------------------
+const TEMPLATES = {
+    'sdd-full': SDD_FULL_TEMPLATE,
+    'ci-ready': CI_READY_TEMPLATE,
+    'quality-gate': QUALITY_GATE_TEMPLATE,
+};
+/**
+ * Return all available template names.
+ */
+export function listTemplateNames() {
+    return Object.keys(TEMPLATES);
+}
+/**
+ * Return a template by name, or undefined if not found.
+ */
+export function getTemplate(name) {
+    return TEMPLATES[name];
+}
+/**
+ * Return all templates.
+ */
+export function getAllTemplates() {
+    return Object.values(TEMPLATES);
+}
+//# sourceMappingURL=templates.js.map

package/dist/engine/hooks/templates.js.map

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

package/dist/engine/hooks/triggers.d.ts

@@ -0,0 +1,27 @@
+import type { HookDefinition, HookEventPayload, HookEventPayloadSpecCreated, HookEventPayloadStatusChange, HookEventPayloadDriftDetected, HookEventPayloadCommit } from '../../types/index.js';
+/**
+ * Build the payload for on_spec_created events.
+ */
+export declare function buildSpecCreatedPayload(projectId: string, specId: string, specTitle: string, specType: string): HookEventPayloadSpecCreated;
+/**
+ * Build the payload for on_spec_status_change events.
+ */
+export declare function buildStatusChangePayload(projectId: string, specId: string, specTitle: string, fromStatus: string, toStatus: string): HookEventPayloadStatusChange;
+/**
+ * Build the payload for on_drift_detected events.
+ */
+export declare function buildDriftDetectedPayload(projectId: string, specId: string, driftScore: number, driftSummary: string): HookEventPayloadDriftDetected;
+/**
+ * Build the payload for on_commit events.
+ */
+export declare function buildCommitPayload(projectId: string, commitHash: string, commitMessage: string, branch: string): HookEventPayloadCommit;
+/**
+ * Check whether a hook's filter conditions are satisfied by the given payload.
+ * Returns true when the hook should fire (no filter = always fires).
+ */
+export declare function matchesFilter(hook: HookDefinition, payload: HookEventPayload): boolean;
+/**
+ * Simple glob matching: supports * wildcard (matches any character sequence).
+ */
+export declare function matchesGlob(value: string, pattern: string): boolean;
+//# sourceMappingURL=triggers.d.ts.map

package/dist/engine/hooks/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/triggers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAM9B;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,2BAA2B,CAS7B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,4BAA4B,CAU9B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,6BAA6B,CAS/B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,sBAAsB,CASxB;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAuBtF;AAiBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGnE"}

package/dist/engine/hooks/triggers.js

@@ -0,0 +1,104 @@
+// engine/hooks/triggers.ts — Event matching logic and payload construction (SPEC-071)
+// ---------------------------------------------------------------------------
+// Payload constructors
+// ---------------------------------------------------------------------------
+/**
+ * Build the payload for on_spec_created events.
+ */
+export function buildSpecCreatedPayload(projectId, specId, specTitle, specType) {
+    return {
+        trigger: 'on_spec_created',
+        projectId,
+        specId,
+        specTitle,
+        specType,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Build the payload for on_spec_status_change events.
+ */
+export function buildStatusChangePayload(projectId, specId, specTitle, fromStatus, toStatus) {
+    return {
+        trigger: 'on_spec_status_change',
+        projectId,
+        specId,
+        specTitle,
+        fromStatus,
+        toStatus,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Build the payload for on_drift_detected events.
+ */
+export function buildDriftDetectedPayload(projectId, specId, driftScore, driftSummary) {
+    return {
+        trigger: 'on_drift_detected',
+        projectId,
+        specId,
+        driftScore,
+        driftSummary,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Build the payload for on_commit events.
+ */
+export function buildCommitPayload(projectId, commitHash, commitMessage, branch) {
+    return {
+        trigger: 'on_commit',
+        projectId,
+        commitHash,
+        commitMessage,
+        branch,
+        timestamp: new Date().toISOString(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Filter matching
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a hook's filter conditions are satisfied by the given payload.
+ * Returns true when the hook should fire (no filter = always fires).
+ */
+export function matchesFilter(hook, payload) {
+    const filter = hook.filter;
+    if (!filter) {
+        return true;
+    }
+    if (payload.trigger === 'on_spec_status_change') {
+        if (filter.fromStatus !== undefined && filter.fromStatus !== payload.fromStatus) {
+            return false;
+        }
+        if (filter.toStatus !== undefined && filter.toStatus !== payload.toStatus) {
+            return false;
+        }
+    }
+    if (filter.specIdPattern !== undefined) {
+        const specId = getSpecIdFromPayload(payload);
+        if (specId !== null && !matchesGlob(specId, filter.specIdPattern)) {
+            return false;
+        }
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function getSpecIdFromPayload(payload) {
+    if (payload.trigger === 'on_spec_created' ||
+        payload.trigger === 'on_spec_status_change' ||
+        payload.trigger === 'on_drift_detected') {
+        return payload.specId;
+    }
+    return null;
+}
+/**
+ * Simple glob matching: supports * wildcard (matches any character sequence).
+ */
+export function matchesGlob(value, pattern) {
+    const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*');
+    return new RegExp(`^${escaped}$`).test(value);
+}
+//# sourceMappingURL=triggers.js.map

package/dist/engine/hooks/triggers.js.map

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

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

@@ -0,0 +1,32 @@
+import type { RegistryEntry, SpecAccuracyReport, RegistryEnrichment } from '../../types/index.js';
+export type { RegistryEnrichment };
+import { formatReport } from './reporter.js';
+/**
+ * Validate spec content against the framework registry.
+ * Returns a complete SpecAccuracyReport with issues, score, and stale warnings.
+ * This is the primary entry point for the check_spec_accuracy tool.
+ *
+ * @param specContent  Full text of the spec (HU.md or fragment)
+ * @param frameworks   Optional list of framework IDs to scope the validation;
+ *                     if omitted, frameworks are auto-detected from the text.
+ */
+export declare function validateSpecContent(specContent: string, frameworks?: string[]): Promise<SpecAccuracyReport>;
+/**
+ * Enrich a documentation response with relevant registry patterns.
+ * Used by consult_docs to add guardrail data when answering framework questions.
+ *
+ * @param topic     The topic or question being asked
+ * @param framework The framework being queried (e.g. "nextjs")
+ */
+export declare function enrichWithRegistry(topic: string, framework: string): Promise<RegistryEnrichment>;
+/**
+ * Format a validation report as Markdown.
+ * Re-exported from reporter for convenience.
+ */
+export { formatReport };
+/**
+ * Save a custom registry entry to data/global/registry-custom.json.
+ * Custom entries override base entries with the same framework ID.
+ */
+export declare function saveCustomEntry(entry: RegistryEntry): Promise<void>;
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGlG,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAGnC,OAAO,EAAe,YAAY,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,kBAAkB,CAAC,CAsB7B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAiC7B;AAED;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBzE"}

package/dist/engine/registry/core.js

@@ -0,0 +1,85 @@
+// engine/registry/core.ts — Orchestrator for spec accuracy validation and doc enrichment
+// Composes loader → matcher → validator → reporter into two public functions.
+import { loadRegistry } from './loader.js';
+import { detectFrameworks, extractReferences, detectUnknownFrameworks } from './matcher.js';
+import { validateReferences } from './validator.js';
+import { buildReport, formatReport } from './reporter.js';
+/**
+ * Validate spec content against the framework registry.
+ * Returns a complete SpecAccuracyReport with issues, score, and stale warnings.
+ * This is the primary entry point for the check_spec_accuracy tool.
+ *
+ * @param specContent  Full text of the spec (HU.md or fragment)
+ * @param frameworks   Optional list of framework IDs to scope the validation;
+ *                     if omitted, frameworks are auto-detected from the text.
+ */
+export async function validateSpecContent(specContent, frameworks) {
+    const registry = await loadRegistry();
+    // Step 1: Determine which frameworks to check
+    const frameworksToCheck = frameworks && frameworks.length > 0
+        ? frameworks.filter((f) => registry.has(f))
+        : detectFrameworks(specContent, registry);
+    // Step 2: Detect frameworks mentioned in the text that are NOT in registry
+    const unknownFrameworks = detectUnknownFrameworks(specContent, registry).filter((uf) => !frameworksToCheck.includes(uf));
+    // Step 3: Extract API/pattern references
+    const references = extractReferences(specContent, frameworksToCheck, registry);
+    // Step 4: Validate each reference
+    const validationResults = validateReferences(references, registry);
+    // Step 5: Build and return report
+    return buildReport(validationResults, frameworksToCheck, unknownFrameworks, registry);
+}
+/**
+ * Enrich a documentation response with relevant registry patterns.
+ * Used by consult_docs to add guardrail data when answering framework questions.
+ *
+ * @param topic     The topic or question being asked
+ * @param framework The framework being queried (e.g. "nextjs")
+ */
+export async function enrichWithRegistry(topic, framework) {
+    const registry = await loadRegistry();
+    const normalizedId = framework.toLowerCase();
+    const entry = registry.get(normalizedId);
+    if (!entry) {
+        return { matchedFrameworks: [], correctPatterns: [], deprecatedWarnings: [] };
+    }
+    const topicLower = topic.toLowerCase();
+    // Filter patterns relevant to the topic
+    const relevantCorrect = entry.correctPatterns
+        .filter((p) => p.pattern.toLowerCase().includes(topicLower) ||
+        topicLower.includes(p.pattern.toLowerCase().split(' ')[0] ?? ''))
+        .map((p) => p.pattern + (p.example ? `: ${p.example}` : ''));
+    const relevantDeprecated = entry.deprecatedPatterns
+        .filter((p) => p.pattern.toLowerCase().includes(topicLower) ||
+        topicLower.includes(p.replacedBy?.toLowerCase().split(' ')[0] ?? ''))
+        .map((p) => `OBSOLETO: ${p.pattern} → Usar: ${p.replacedBy}`);
+    return {
+        matchedFrameworks: [normalizedId],
+        correctPatterns: relevantCorrect,
+        deprecatedWarnings: relevantDeprecated,
+    };
+}
+/**
+ * Format a validation report as Markdown.
+ * Re-exported from reporter for convenience.
+ */
+export { formatReport };
+/**
+ * Save a custom registry entry to data/global/registry-custom.json.
+ * Custom entries override base entries with the same framework ID.
+ */
+export async function saveCustomEntry(entry) {
+    const { readJson, writeJson, globalDataDir } = await import('../../storage/base-store.js');
+    const { join } = await import('node:path');
+    const filePath = join(globalDataDir(), 'registry-custom.json');
+    const store = await readJson(filePath, { entries: [] });
+    // Replace existing entry with same framework ID, or append
+    const existing = store.entries.findIndex((e) => e.framework === entry.framework);
+    if (existing >= 0) {
+        store.entries[existing] = entry;
+    }
+    else {
+        store.entries.push(entry);
+    }
+    await writeJson(filePath, store);
+}
+//# sourceMappingURL=core.js.map

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

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

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

@@ -0,0 +1,6 @@
+export { validateSpecContent, enrichWithRegistry, saveCustomEntry, formatReport } from './core.js';
+export { loadBaseRegistry, loadCustomRegistry, loadRegistry } from './loader.js';
+export { detectFrameworks, extractReferences, detectUnknownFrameworks } from './matcher.js';
+export { validateReference, validateReferences, detectStaleEntries } from './validator.js';
+export { buildReport } from './reporter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/engine/registry/index.js

@@ -0,0 +1,8 @@
+// engine/registry/index.ts — Barrel export for the spec registry engine.
+// Types (RegistryEntry, FrameworkReference, ValidationResult, etc.) live in src/types/registry.ts
+export { validateSpecContent, enrichWithRegistry, saveCustomEntry, formatReport } from './core.js';
+export { loadBaseRegistry, loadCustomRegistry, loadRegistry } from './loader.js';
+export { detectFrameworks, extractReferences, detectUnknownFrameworks } from './matcher.js';
+export { validateReference, validateReferences, detectStaleEntries } from './validator.js';
+export { buildReport } from './reporter.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/registry/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,kGAAkG;AAElG,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { RegistryEntry } from '../../types/index.js';
+/**
+ * Load all base framework entries from src/config/framework-registry/.
+ * Skips index.json and any file that fails to parse.
+ */
+export declare function loadBaseRegistry(): Promise<RegistryEntry[]>;
+/**
+ * Load user-defined custom registry entries from data/global/registry-custom.json.
+ * Returns an empty array when the file does not exist.
+ */
+export declare function loadCustomRegistry(): Promise<RegistryEntry[]>;
+/**
+ * Load and merge the full registry: base + custom.
+ * Custom entries override base entries with the same framework ID.
+ * The merged map preserves custom entries for duplicates.
+ */
+export declare function loadRegistry(): Promise<Map<string, RegistryEntry>>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/loader.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAyC,MAAM,sBAAsB,CAAC;AAuCjG;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAWjE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAGnE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAYxE"}

package/dist/engine/registry/loader.js

@@ -0,0 +1,81 @@
+// engine/registry/loader.ts — Loads and merges framework registry entries
+// Base entries come from src/config/framework-registry/*.json
+// Custom entries come from data/global/registry-custom.json (user-added)
+import { readFile, readdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readJson } from '../../storage/base-store.js';
+const REGISTRY_DIR = join(dirname(fileURLToPath(import.meta.url)), '../../config/framework-registry');
+const CUSTOM_REGISTRY_PATH = 'data/global/registry-custom.json';
+/**
+ * Load a single framework JSON file from the base registry directory.
+ * Returns null if the file is missing or malformed.
+ */
+async function loadFrameworkFile(fileName) {
+    try {
+        const raw = await readFile(join(REGISTRY_DIR, fileName), 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            framework: parsed.framework,
+            displayName: parsed.displayName,
+            frameworkVersion: parsed.frameworkVersion,
+            lastUpdated: parsed.lastUpdated,
+            ecosystem: parsed.ecosystem,
+            customEntry: false,
+            correctPatterns: Array.isArray(parsed.correctPatterns)
+                ? parsed.correctPatterns
+                : [],
+            deprecatedPatterns: Array.isArray(parsed.deprecatedPatterns)
+                ? parsed.deprecatedPatterns
+                : [],
+            commonMistakes: Array.isArray(parsed.commonMistakes)
+                ? parsed.commonMistakes
+                : [],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load all base framework entries from src/config/framework-registry/.
+ * Skips index.json and any file that fails to parse.
+ */
+export async function loadBaseRegistry() {
+    let files;
+    try {
+        files = await readdir(REGISTRY_DIR);
+    }
+    catch {
+        return [];
+    }
+    const jsonFiles = files.filter((f) => f.endsWith('.json') && f !== 'index.json');
+    const results = await Promise.all(jsonFiles.map(loadFrameworkFile));
+    return results.filter((e) => e !== null);
+}
+/**
+ * Load user-defined custom registry entries from data/global/registry-custom.json.
+ * Returns an empty array when the file does not exist.
+ */
+export async function loadCustomRegistry() {
+    const store = await readJson(CUSTOM_REGISTRY_PATH, { entries: [] });
+    return store.entries.map((e) => ({ ...e, customEntry: true }));
+}
+/**
+ * Load and merge the full registry: base + custom.
+ * Custom entries override base entries with the same framework ID.
+ * The merged map preserves custom entries for duplicates.
+ */
+export async function loadRegistry() {
+    const [base, custom] = await Promise.all([loadBaseRegistry(), loadCustomRegistry()]);
+    const map = new Map();
+    for (const entry of base) {
+        map.set(entry.framework, entry);
+    }
+    // Custom overrides base for same framework ID
+    for (const entry of custom) {
+        map.set(entry.framework, { ...entry, customEntry: true });
+    }
+    return map;
+}
+//# sourceMappingURL=loader.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { RegistryEntry, FrameworkReference } from '../../types/index.js';
+export type { FrameworkReference };
+/**
+ * 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 declare function detectFrameworks(specText: string, registry: Map<string, RegistryEntry>): string[];
+/**
+ * Extract potential API/pattern references from spec text for specific frameworks.
+ * Returns deduplicated references with framework attribution.
+ */
+export declare function extractReferences(specText: string, frameworkIds: string[], registry: Map<string, RegistryEntry>): FrameworkReference[];
+/**
+ * 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 declare function detectUnknownFrameworks(specText: string, registry: Map<string, RegistryEntry>): string[];
+//# sourceMappingURL=matcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/matcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,YAAY,EAAE,kBAAkB,EAAE,CAAC;AA2DnC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,MAAM,EAAE,CAejG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EAAE,EACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACnC,kBAAkB,EAAE,CA6BtB;AAgBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACnC,MAAM,EAAE,CAuBV"}