@planu/cli 0.28.0 → 0.30.0

package/dist/engine/spec-coverage/keyword-extractor.d.ts

@@ -0,0 +1,10 @@
+export declare const STOP_WORDS: Set<string>;
+/** Extracts 3-5 meaningful keywords from an AC description text. */
+export declare function extractKeywords(text: string): readonly string[];
+/** Patterns for extracting test block names from source code. */
+export declare const TEST_NAME_PATTERNS: RegExp[];
+/** Extracts the first matching test name from source code. */
+export declare function extractTestName(content: string, nearPattern: RegExp): string;
+/** Extracts all test/describe block names from source code. */
+export declare function extractAllTestNames(content: string): readonly string[];
+//# sourceMappingURL=keyword-extractor.d.ts.map

package/dist/engine/spec-coverage/keyword-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-extractor.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-coverage/keyword-extractor.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,UAAU,aAqErB,CAAC;AAEH,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAkB/D;AAMD,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,UAM9B,CAAC;AAEF,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAuB5E;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAetE"}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/engine/spec-templates/catalog-extra.js

@@ -1,367 +1,12 @@
 // engine/spec-templates/catalog-extra.ts — Additional built-in templates (data, security, performance).
-// Split from catalog.ts to keep file size within the 500-line limit.
-/** Extra built-in spec templates (data, security, performance). */
+// Templates are defined in dedicated files and re-exported here for backward compatibility.
+import { DATA_MIGRATION_TEMPLATE, SECURITY_FEATURE_TEMPLATE } from './templates-data-security.js';
+import { PERFORMANCE_OPTIMIZATION_TEMPLATE, THIRD_PARTY_INTEGRATION_TEMPLATE, } from './templates-perf-integration.js';
+/** Extra built-in spec templates (data, security, performance, integration). */
 export const EXTRA_TEMPLATES = [
-    {
-        id: 'data-migration',
-        name: 'Data Migration',
-        category: 'data',
-        description: 'Safe, reversible database or data migration with rollback support.',
-        tags: ['migration', 'database', 'schema', 'data'],
-        variables: [
-            {
-                key: 'MigrationName',
-                label: 'Migration name',
-                description: 'Short descriptive name for this migration',
-                example: 'Add email_verified column to users',
-                required: true,
-            },
-        ],
-        huTemplate: `# HU: Data Migration — {{MigrationName}}
-
-## User Story
-As a developer, I want to apply the migration "{{MigrationName}}" safely so that production data is not at risk.
-
-## Acceptance Criteria
-
-### AC-1: Migration script
-- [ ] Migration has an "up" (apply) and "down" (rollback) operation
-- [ ] Script is idempotent (safe to run multiple times)
-- [ ] Each step is transactional where supported by the database
-
-### AC-2: Data safety
-- [ ] Pre-migration backup documented in runbook
-- [ ] No destructive operation without a confirmed backup
-- [ ] Migration tested on a staging copy of production data
-
-### AC-3: Zero-downtime strategy
-- [ ] Migration can be applied while the application is running
-- [ ] Backward-compatible schema changes first (expand), then cleanup (contract)
-- [ ] Feature flag used if application code needs to switch behavior
-
-### AC-4: Rollback
-- [ ] Rollback procedure documented and tested
-- [ ] Rollback does not cause data loss
-- [ ] Time to rollback < 15 minutes
-
-### AC-5: Observability
-- [ ] Migration duration logged
-- [ ] Row counts before/after logged for verification
-- [ ] Anomalies (unexpected row counts) trigger alerts
-`,
-        fichaTecnicaTemplate: `# FICHA TÉCNICA: Data Migration — {{MigrationName}}
-
-## Affected Files
-- migrations/{{MigrationName}}/up
-- migrations/{{MigrationName}}/down
-- runbooks/{{MigrationName}}-rollback
-
-## Types / Entities
-- Migration metadata: id, name, appliedAt, duration, rolledBack
-
-## Risks
-- Data loss on rollback → mandatory backup before apply
-- Long-running migration → table locks in production
-- Missing idempotency → partial application leaves DB in bad state
-
-## Estimation (rough)
-- Dev: 4–12 hours
-- Review: 2–4 hours
-- Difficulty: 3/5
-`,
-        progressTemplate: `# PROGRESS: Data Migration — {{MigrationName}}
-
-## Status: draft
-
-## Criteria
-- [ ] AC-1: Migration script
-- [ ] AC-2: Data safety
-- [ ] AC-3: Zero-downtime strategy
-- [ ] AC-4: Rollback
-- [ ] AC-5: Observability
-`,
-    },
-    {
-        id: 'security-feature',
-        name: 'Security Feature',
-        category: 'security',
-        description: 'Security hardening: rate limiting, input sanitization, audit logging, etc.',
-        tags: ['security', 'hardening', 'audit', 'rate-limiting'],
-        variables: [
-            {
-                key: 'FeatureName',
-                label: 'Security feature name',
-                description: 'Name of the security feature being implemented',
-                example: 'Rate Limiting',
-                required: true,
-            },
-            {
-                key: 'ProtectedResource',
-                label: 'Protected resource or area',
-                description: 'What is being protected by this feature',
-                example: 'authentication endpoints',
-                required: true,
-            },
-        ],
-        huTemplate: `# HU: Security Feature — {{FeatureName}}
-
-## User Story
-As a security engineer, I want {{FeatureName}} applied to {{ProtectedResource}} so that attack vectors are reduced.
-
-## Acceptance Criteria
-
-### AC-1: Implementation
-- [ ] {{FeatureName}} implemented at the correct layer (edge, gateway, application)
-- [ ] Configuration externalized (not hardcoded)
-- [ ] Enabled in production, configurable in development
-
-### AC-2: Bypass prevention
-- [ ] Cannot be bypassed by manipulating headers or query parameters
-- [ ] Handles IPv4, IPv6, and forwarded IP headers correctly
-- [ ] Works behind reverse proxies and CDNs
-
-### AC-3: Observability
-- [ ] Blocked/throttled requests logged with reason
-- [ ] Metrics exported: blocked count, block rate, top blocked IPs
-- [ ] Alert triggers when block rate exceeds threshold
-
-### AC-4: Testing
-- [ ] Unit tests cover allowed and blocked cases
-- [ ] Integration tests simulate attack patterns
-- [ ] Penetration test checklist updated
-
-### AC-5: Documentation
-- [ ] Security runbook updated with new feature
-- [ ] Limits and thresholds documented with rationale
-- [ ] On-call playbook updated for incident response
-`,
-        fichaTecnicaTemplate: `# FICHA TÉCNICA: Security Feature — {{FeatureName}}
-
-## Affected Files
-- middleware/{{FeatureName}}
-- config/security-config
-- monitoring/security-alerts
-- runbooks/security-incident
-
-## Types / Entities
-- \`{{FeatureName}}Config\`: thresholds, enabled, dryRun
-- \`SecurityEvent\`: type, resource, ip, timestamp, blocked
-
-## Risks
-- False positives blocking legitimate users → dry-run mode first
-- Missing coverage for all entry points → security audit required
-- Misconfiguration under proxy → test in staging with proxy enabled
-
-## Estimation (rough)
-- Dev: 4–12 hours
-- Review: 2–4 hours
-- Difficulty: 3/5
-`,
-        progressTemplate: `# PROGRESS: Security Feature — {{FeatureName}}
-
-## Status: draft
-
-## Criteria
-- [ ] AC-1: Implementation
-- [ ] AC-2: Bypass prevention
-- [ ] AC-3: Observability
-- [ ] AC-4: Testing
-- [ ] AC-5: Documentation
-`,
-    },
-    {
-        id: 'performance-optimization',
-        name: 'Performance Optimization',
-        category: 'performance',
-        description: 'Measurable performance improvements with before/after benchmarks.',
-        tags: ['performance', 'optimization', 'caching', 'benchmarks'],
-        variables: [
-            {
-                key: 'TargetArea',
-                label: 'Target area',
-                description: 'The specific area to optimize (e.g. API response time, DB queries)',
-                example: 'API response time',
-                required: true,
-            },
-            {
-                key: 'CurrentBaseline',
-                label: 'Current baseline',
-                description: 'Current measured performance metric',
-                example: 'P95 latency: 800ms',
-                required: false,
-                defaultValue: 'TBD — measure before starting',
-            },
-            {
-                key: 'TargetGoal',
-                label: 'Target goal',
-                description: 'Desired performance metric after optimization',
-                example: 'P95 latency: < 200ms',
-                required: false,
-                defaultValue: 'TBD — define after baseline measurement',
-            },
-        ],
-        huTemplate: `# HU: Performance Optimization — {{TargetArea}}
-
-## User Story
-As a user, I want {{TargetArea}} to be faster so that the application feels responsive.
-
-## Baseline
-- Current: {{CurrentBaseline}}
-- Target: {{TargetGoal}}
-
-## Acceptance Criteria
-
-### AC-1: Baseline measurement
-- [ ] Benchmark suite established before any changes
-- [ ] Metrics captured: P50, P95, P99 latency, throughput, error rate
-- [ ] Benchmark results stored for comparison
-
-### AC-2: Optimization implementation
-- [ ] Root cause of performance issue identified and documented
-- [ ] Optimization applied at the correct layer
-- [ ] No correctness regression introduced by optimization
-
-### AC-3: Cache strategy (if applicable)
-- [ ] Cache invalidation strategy defined
-- [ ] Cache hit rate monitored
-- [ ] Cache warm-up procedure documented
-
-### AC-4: Validation
-- [ ] Post-optimization benchmark shows improvement vs baseline
-- [ ] Target goal reached or documented with explanation if not
-- [ ] Load test confirms improvement holds under concurrent traffic
-
-### AC-5: Observability
-- [ ] Performance metrics added to dashboard
-- [ ] Regression alert configured (auto-detect if P95 degrades)
-`,
-        fichaTecnicaTemplate: `# FICHA TÉCNICA: Performance Optimization — {{TargetArea}}
-
-## Affected Files
-- (determined during root-cause analysis)
-- monitoring/dashboards/{{TargetArea}}
-- benchmarks/{{TargetArea}}
-
-## Types / Entities
-- \`BenchmarkResult\`: timestamp, p50, p95, p99, throughput, errorRate
-- \`CacheEntry\` (if caching): key, value, ttl, hitCount
-
-## Risks
-- Optimization that breaks correctness → benchmark must include correctness tests
-- Cache inconsistency → strong consistency tests required
-- Performance regression after unrelated change → regression alert required
-
-## Estimation (rough)
-- Dev: 4–20 hours (highly variable by root cause)
-- Review: 2–4 hours
-- Difficulty: 3–4/5
-`,
-        progressTemplate: `# PROGRESS: Performance Optimization — {{TargetArea}}
-
-## Status: draft
-
-## Criteria
-- [ ] AC-1: Baseline measurement
-- [ ] AC-2: Optimization implementation
-- [ ] AC-3: Cache strategy
-- [ ] AC-4: Validation
-- [ ] AC-5: Observability
-`,
-    },
-    {
-        id: 'third-party-integration',
-        name: 'Third-Party Integration',
-        category: 'integration',
-        description: 'Integrating with an external service (payment, email, SMS, CRM, etc.).',
-        tags: ['integration', 'external', 'api', 'webhook'],
-        variables: [
-            {
-                key: 'ServiceName',
-                label: 'Service name',
-                description: 'Name of the external service to integrate',
-                example: 'Stripe',
-                required: true,
-            },
-            {
-                key: 'IntegrationPurpose',
-                label: 'Purpose',
-                description: 'What the integration enables',
-                example: 'payment processing',
-                required: true,
-            },
-        ],
-        huTemplate: `# HU: {{ServiceName}} Integration
-
-## User Story
-As a developer, I want to integrate {{ServiceName}} so that the platform can handle {{IntegrationPurpose}} reliably.
-
-## Acceptance Criteria
-
-### AC-1: Credentials management
-- [ ] API keys and secrets stored in environment variables (never hardcoded)
-- [ ] Separate credentials for development, staging, and production
-- [ ] Credential rotation documented in runbook
-
-### AC-2: Core integration
-- [ ] {{ServiceName}} SDK or HTTP client initialized with proper config
-- [ ] All calls wrapped in retry logic with exponential backoff
-- [ ] Timeouts configured (no infinite waits)
-
-### AC-3: Error handling
-- [ ] {{ServiceName}} API errors mapped to internal error types
-- [ ] Network failures do not crash the application
-- [ ] Errors logged with enough context for debugging
-
-### AC-4: Webhooks (if applicable)
-- [ ] Webhook endpoint validates signature before processing
-- [ ] Events processed idempotently (replay-safe)
-- [ ] Failed event processing alerts the on-call team
-
-### AC-5: Observability
-- [ ] All outbound calls logged (method, status, latency)
-- [ ] Circuit breaker implemented for high-traffic paths
-
-### AC-6: Testing
-- [ ] Unit tests mock {{ServiceName}} client
-- [ ] Integration tests use sandbox/test environment
-- [ ] Webhook tests replay recorded payloads
-`,
-        fichaTecnicaTemplate: `# FICHA TÉCNICA: {{ServiceName}} Integration
-
-## Affected Files
-- integrations/{{ServiceName}}/client
-- integrations/{{ServiceName}}/webhook-handler
-- integrations/{{ServiceName}}/error-mapper
-- config/{{ServiceName}}-config
-- tests/integrations/{{ServiceName}}
-
-## Types / Entities
-- \`{{ServiceName}}Config\`: apiKey, baseUrl, timeout, retries
-- \`{{ServiceName}}Error\`: code, message, retryable
-- \`WebhookEvent\`: id, type, payload, receivedAt
-
-## Risks
-- Vendor API changes without notice → pin SDK version, monitor changelogs
-- Rate limits exceeded → implement request queuing
-- Credentials leaked → secrets manager mandatory
-
-## Estimation (rough)
-- Dev: 8–20 hours
-- Review: 2–4 hours
-- Difficulty: 3/5
-`,
-        progressTemplate: `# PROGRESS: {{ServiceName}} Integration
-
-## Status: draft
-
-## Criteria
-- [ ] AC-1: Credentials management
-- [ ] AC-2: Core integration
-- [ ] AC-3: Error handling
-- [ ] AC-4: Webhooks
-- [ ] AC-5: Observability
-- [ ] AC-6: Testing
-`,
-    },
+    DATA_MIGRATION_TEMPLATE,
+    SECURITY_FEATURE_TEMPLATE,
+    PERFORMANCE_OPTIMIZATION_TEMPLATE,
+    THIRD_PARTY_INTEGRATION_TEMPLATE,
 ];
 //# sourceMappingURL=catalog-extra.js.map

package/dist/engine/spec-templates/catalog-extra.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-extra.js","sourceRoot":"","sources":["../../../src/engine/spec-templates/catalog-extra.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"catalog-extra.js","sourceRoot":"","sources":["../../../src/engine/spec-templates/catalog-extra.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,4FAA4F;AAG5F,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAClG,OAAO,EACL,iCAAiC,EACjC,gCAAgC,GACjC,MAAM,iCAAiC,CAAC;AAEzC,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAwB;IAClD,uBAAuB;IACvB,yBAAyB;IACzB,iCAAiC;IACjC,gCAAgC;CACjC,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { SpecTemplateEntry } from '../../types/spec-templates.js';
+/** All industry vertical templates. */
+export declare const INDUSTRY_TEMPLATES: SpecTemplateEntry[];
+//# sourceMappingURL=catalog-industry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-industry.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-templates/catalog-industry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAkBvE,uCAAuC;AACvC,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EAWjD,CAAC"}