@planu/cli 0.23.2 → 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/license-validator/core.d.ts

@@ -6,4 +6,5 @@ export declare function checkToolAccess(toolName: string, tier: PricingTier): Li
 export declare function getTierLimits(tier: PricingTier): TierLimits;
 export declare function checkLimits(tier: PricingTier, currentCount: number, limitType: 'maxProjects' | 'maxActiveSpecs'): LicenseCheckResult;
 export declare function isValidationFresh(state: LicenseState): boolean;
+export declare function isInGracePeriod(state: LicenseState): boolean;
 //# sourceMappingURL=core.d.ts.map

package/dist/engine/license-validator/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/license-validator/core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACX,MAAM,sBAAsB,CAAC;AAa9B,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,WAAW,CAK1E;AAqBD,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAG9D;AAMD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAa1E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,kBAAkB,CAqBvF;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAG3D;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,aAAa,GAAG,gBAAgB,GAC1C,kBAAkB,CAkBpB;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAG9D"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/license-validator/core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACX,MAAM,sBAAsB,CAAC;AAe9B,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,WAAW,CAQ1E;AAqBD,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAG9D;AAMD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAa1E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,kBAAkB,CAqBvF;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAG3D;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,aAAa,GAAG,gBAAgB,GAC1C,kBAAkB,CAkBpB;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAG9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAG5D"}

package/dist/engine/license-validator/core.js

@@ -1,10 +1,12 @@
 // engine/license-validator/core.ts — Offline-first license validation logic.
 // Source of truth: local license state. Remote validation only on activation + every 30 days.
 import { loadLicensePlans } from './config-loader.js';
+import { verifyMachineFingerprint } from './fingerprint.js';
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
-const VALIDATION_TTL_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
+const VALIDATION_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+const GRACE_PERIOD_MS = 3 * 24 * 60 * 60 * 1000; // 3 days offline grace
 // ---------------------------------------------------------------------------
 // Tier resolution
 // ---------------------------------------------------------------------------
@@ -12,6 +14,9 @@ export function resolveCurrentTier(state) {
     if (!state) {
         return 'free';
     }
+    if (!verifyMachineFingerprint(state.machineFingerprint)) {
+        return 'free';
+    }
     return state.tier;
 }
 // ---------------------------------------------------------------------------
@@ -107,4 +112,8 @@ export function isValidationFresh(state) {
     const lastValidated = new Date(state.lastValidatedAt).getTime();
     return Date.now() - lastValidated < VALIDATION_TTL_MS;
 }
+export function isInGracePeriod(state) {
+    const lastValidated = new Date(state.lastValidatedAt).getTime();
+    return Date.now() - lastValidated < VALIDATION_TTL_MS + GRACE_PERIOD_MS;
+}
 //# sourceMappingURL=core.js.map

package/dist/engine/license-validator/core.js.map

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

package/dist/engine/license-validator/fingerprint.d.ts

@@ -0,0 +1,3 @@
+export declare function computeMachineFingerprint(): string;
+export declare function verifyMachineFingerprint(stored: string | undefined): boolean;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/engine/license-validator/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../../src/engine/license-validator/fingerprint.ts"],"names":[],"mappings":"AAMA,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAO5E"}

package/dist/engine/license-validator/fingerprint.js

@@ -0,0 +1,17 @@
+// engine/license-validator/fingerprint.ts — Deterministic machine identity for license binding.
+// Uses only node:os and node:crypto — no external deps.
+import { createHash } from 'node:crypto';
+import { arch, hostname, platform, userInfo } from 'node:os';
+export function computeMachineFingerprint() {
+    const raw = [hostname(), platform(), arch(), userInfo().username].join('|');
+    return createHash('sha256').update(raw).digest('hex');
+}
+export function verifyMachineFingerprint(stored) {
+    if (!stored) {
+        // Legacy state (pre-hardening) — no fingerprint stored yet.
+        // Allow access; fingerprint will be added on next revalidation.
+        return true;
+    }
+    return computeMachineFingerprint() === stored;
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/engine/license-validator/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../../src/engine/license-validator/fingerprint.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,wDAAwD;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE7D,MAAM,UAAU,yBAAyB;IACvC,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5E,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAA0B;IACjE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,4DAA4D;QAC5D,gEAAgE;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,yBAAyB,EAAE,KAAK,MAAM,CAAC;AAChD,CAAC"}

package/dist/engine/license-validator.d.ts

@@ -1,4 +1,5 @@
-export { resolveCurrentTier, variantToTier, isToolAllowed, checkToolAccess, getTierLimits, checkLimits, isValidationFresh, } from './license-validator/core.js';
+export { resolveCurrentTier, variantToTier, isToolAllowed, checkToolAccess, getTierLimits, checkLimits, isValidationFresh, isInGracePeriod, } from './license-validator/core.js';
 export { loadLicensePlans, resetPlanCache } from './license-validator/config-loader.js';
 export { activateLicense, validateLicense, deactivateLicense, } from './license-validator/lemon-squeezy.js';
+export { computeMachineFingerprint, verifyMachineFingerprint, } from './license-validator/fingerprint.js';
 //# sourceMappingURL=license-validator.d.ts.map

package/dist/engine/license-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"license-validator.d.ts","sourceRoot":"","sources":["../../src/engine/license-validator.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAExF,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"license-validator.d.ts","sourceRoot":"","sources":["../../src/engine/license-validator.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAExF,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,oCAAoC,CAAC"}

package/dist/engine/license-validator.js

@@ -1,5 +1,6 @@
 // engine/license-validator.ts — Barrel re-export for the license validator module.
-export { resolveCurrentTier, variantToTier, isToolAllowed, checkToolAccess, getTierLimits, checkLimits, isValidationFresh, } from './license-validator/core.js';
+export { resolveCurrentTier, variantToTier, isToolAllowed, checkToolAccess, getTierLimits, checkLimits, isValidationFresh, isInGracePeriod, } from './license-validator/core.js';
 export { loadLicensePlans, resetPlanCache } from './license-validator/config-loader.js';
 export { activateLicense, validateLicense, deactivateLicense, } from './license-validator/lemon-squeezy.js';
+export { computeMachineFingerprint, verifyMachineFingerprint, } from './license-validator/fingerprint.js';
 //# sourceMappingURL=license-validator.js.map

package/dist/engine/license-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"license-validator.js","sourceRoot":"","sources":["../../src/engine/license-validator.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAExF,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"license-validator.js","sourceRoot":"","sources":["../../src/engine/license-validator.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAExF,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,oCAAoC,CAAC"}

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