@planu/cli 1.10.0 → 1.12.0

package/dist/engine/distribution/cost-estimator.js

@@ -0,0 +1,113 @@
+// Monthly cost table (approximate 2026 prices)
+const COST_TABLE = {
+    aws: {
+        compute: { tier: 'ECS Fargate (0.5 vCPU, 1GB)', monthlyUsd: 15, notes: '~720 hours/month' },
+        database: {
+            tier: 'RDS PostgreSQL t3.micro',
+            monthlyUsd: 25,
+            notes: 'Single-AZ, 20GB storage',
+        },
+        cache: { tier: 'ElastiCache t3.micro', monthlyUsd: 18, notes: 'Single node' },
+        cdn: { tier: 'CloudFront', monthlyUsd: 5, notes: '10GB transfer included' },
+        storage: { tier: 'S3 Standard', monthlyUsd: 3, notes: '100GB storage' },
+        monitoring: { tier: 'CloudWatch', monthlyUsd: 10, notes: 'Basic metrics + logs' },
+    },
+    gcp: {
+        compute: { tier: 'Cloud Run (min 1 instance)', monthlyUsd: 12, notes: '1 vCPU, 512MB' },
+        database: { tier: 'Cloud SQL PostgreSQL', monthlyUsd: 30, notes: 'db-f1-micro, 10GB' },
+        cache: { tier: 'Memorystore Redis', monthlyUsd: 20, notes: '1GB basic tier' },
+        cdn: { tier: 'Cloud CDN', monthlyUsd: 4, notes: '10GB egress included' },
+        storage: { tier: 'Cloud Storage', monthlyUsd: 2, notes: '100GB standard' },
+        monitoring: { tier: 'Cloud Monitoring', monthlyUsd: 8, notes: 'Basic ops suite' },
+    },
+    railway: {
+        compute: { tier: 'Railway Hobby', monthlyUsd: 5, notes: 'Included in hobby plan' },
+        database: { tier: 'Railway PostgreSQL', monthlyUsd: 5, notes: '1GB included' },
+        cache: { tier: 'Railway Redis', monthlyUsd: 5, notes: 'Shared instance' },
+        cdn: { tier: 'N/A', monthlyUsd: 0, notes: 'Not offered' },
+        storage: { tier: 'Volume', monthlyUsd: 2, notes: '1GB volume' },
+        monitoring: { tier: 'Built-in metrics', monthlyUsd: 0, notes: 'Included' },
+    },
+    vercel: {
+        compute: {
+            tier: 'Vercel Pro Functions',
+            monthlyUsd: 20,
+            notes: 'Fluid compute, included in Pro',
+        },
+        database: {
+            tier: 'Vercel Marketplace DB',
+            monthlyUsd: 15,
+            notes: 'Neon/PlanetScale starter',
+        },
+        cache: { tier: 'Vercel KV (Upstash)', monthlyUsd: 5, notes: '100MB included' },
+        cdn: { tier: 'Vercel Edge Network', monthlyUsd: 0, notes: 'Included in Pro' },
+        storage: { tier: 'Vercel Blob', monthlyUsd: 5, notes: '5GB included' },
+        monitoring: { tier: 'Vercel Analytics', monthlyUsd: 10, notes: 'Web Analytics Pro' },
+    },
+    fly: {
+        compute: { tier: 'Fly.io shared-cpu-1x', monthlyUsd: 3, notes: '256MB RAM' },
+        database: { tier: 'Fly Postgres', monthlyUsd: 5, notes: 'Single node' },
+        cache: { tier: 'Fly Redis (Upstash)', monthlyUsd: 5, notes: '10K commands/day free' },
+        cdn: { tier: 'N/A', monthlyUsd: 0, notes: 'Not offered' },
+        storage: { tier: 'Fly Volumes', monthlyUsd: 2, notes: '1GB volume' },
+        monitoring: { tier: 'Fly Metrics', monthlyUsd: 0, notes: 'Included' },
+    },
+    generic: {
+        compute: { tier: 'VPS equivalent', monthlyUsd: 10, notes: 'Generic estimate' },
+        database: { tier: 'Managed DB', monthlyUsd: 20, notes: 'Generic estimate' },
+        cache: { tier: 'Redis managed', monthlyUsd: 15, notes: 'Generic estimate' },
+        cdn: { tier: 'CDN basic', monthlyUsd: 5, notes: 'Generic estimate' },
+        storage: { tier: 'Object storage', monthlyUsd: 3, notes: 'Generic estimate' },
+        monitoring: { tier: 'Monitoring basic', monthlyUsd: 8, notes: 'Generic estimate' },
+    },
+};
+export function estimateCost(provider, resources) {
+    const table = COST_TABLE[provider];
+    const resourceCosts = resources
+        .map((r) => {
+        const entry = table[r];
+        if (!entry) {
+            return null;
+        }
+        return {
+            resource: r,
+            provider,
+            tier: entry.tier,
+            monthlyUsd: entry.monthlyUsd,
+            notes: entry.notes,
+        };
+    })
+        .filter((r) => r !== null);
+    const total = resourceCosts.reduce((sum, r) => sum + r.monthlyUsd, 0);
+    const breakdown = resourceCosts
+        .map((r) => `  ${r.resource}: $${r.monthlyUsd}/mo (${r.tier})`)
+        .join('\n');
+    return {
+        provider,
+        resources: resourceCosts,
+        totalMonthlyUsd: total,
+        totalYearlyUsd: total * 12,
+        breakdown: `Provider: ${provider}\n${breakdown}\n  Total: $${total}/month ($${total * 12}/year)`,
+    };
+}
+export function detectProvider(stack, framework) {
+    const s = (stack ?? '').toLowerCase();
+    const f = (framework ?? '').toLowerCase();
+    if (s.includes('vercel') || f.includes('next') || f.includes('vercel')) {
+        return 'vercel';
+    }
+    if (s.includes('railway')) {
+        return 'railway';
+    }
+    if (s.includes('fly')) {
+        return 'fly';
+    }
+    if (s.includes('gcp') || s.includes('google')) {
+        return 'gcp';
+    }
+    if (s.includes('aws') || s.includes('amazon')) {
+        return 'aws';
+    }
+    return 'generic';
+}
+//# sourceMappingURL=cost-estimator.js.map

package/dist/engine/distribution/cost-estimator.js.map

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

package/dist/engine/distribution/diagram-generator.d.ts

@@ -0,0 +1,12 @@
+export interface DiagramSpec {
+    services: {
+        name: string;
+        type: string;
+    }[];
+    databases: string[];
+    caches: string[];
+    external: string[];
+}
+export declare function generateC4Diagram(input: DiagramSpec): string;
+export declare function specTodiagramInput(specTitles: string[], stack?: string): DiagramSpec;
+//# sourceMappingURL=diagram-generator.d.ts.map

package/dist/engine/distribution/diagram-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/distribution/diagram-generator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAoC5D;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CA4BpF"}

package/dist/engine/distribution/diagram-generator.js

@@ -0,0 +1,59 @@
+export function generateC4Diagram(input) {
+    const lines = ['```mermaid', 'graph TB'];
+    if (input.services.length > 0) {
+        lines.push('  subgraph Services');
+        for (const s of input.services) {
+            lines.push(`    ${s.name.replace(/\s+/g, '_')}["${s.name}\n[${s.type}]"]`);
+        }
+        lines.push('  end');
+    }
+    if (input.databases.length > 0) {
+        lines.push('  subgraph Data');
+        for (const db of input.databases) {
+            lines.push(`    ${db.replace(/\s+/g, '_')}[("${db}")]`);
+        }
+        lines.push('  end');
+    }
+    if (input.caches.length > 0) {
+        for (const cache of input.caches) {
+            lines.push(`  ${cache.replace(/\s+/g, '_')}(("${cache}"))`);
+        }
+    }
+    if (input.external.length > 0) {
+        lines.push('  subgraph External');
+        for (const ext of input.external) {
+            lines.push(`    ${ext.replace(/\s+/g, '_')}["${ext}"]:::external`);
+        }
+        lines.push('  end');
+    }
+    lines.push('  classDef external fill:#f9f,stroke:#333,stroke-dasharray: 5 5');
+    lines.push('```');
+    return lines.join('\n');
+}
+export function specTodiagramInput(specTitles, stack) {
+    const services = [{ name: 'API Server', type: 'Service' }];
+    const databases = [];
+    const caches = [];
+    const external = [];
+    const allText = specTitles.join(' ').toLowerCase();
+    if (allText.includes('postgres') || allText.includes('database') || allText.includes('sql')) {
+        databases.push('PostgreSQL');
+    }
+    if (allText.includes('redis') || allText.includes('cache')) {
+        caches.push('Redis Cache');
+    }
+    if (allText.includes('auth') || allText.includes('oauth')) {
+        external.push('Auth Provider');
+    }
+    if (allText.includes('email') || allText.includes('notification')) {
+        external.push('Email Service');
+    }
+    if (allText.includes('payment') || allText.includes('billing') || allText.includes('stripe')) {
+        external.push('Payment Gateway');
+    }
+    if ((stack ?? '').toLowerCase().includes('next') || allText.includes('frontend')) {
+        services.push({ name: 'Frontend', type: 'Web App' });
+    }
+    return { services, databases, caches, external };
+}
+//# sourceMappingURL=diagram-generator.js.map

package/dist/engine/distribution/diagram-generator.js.map

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

package/dist/engine/distribution/readiness-analyzer.d.ts

@@ -0,0 +1,4 @@
+import type { DistributionReadiness } from '../../types/index.js';
+export type DistributionReadinessResult = DistributionReadiness;
+export declare function analyzeDistributionReadiness(specTitles: string[]): DistributionReadinessResult;
+//# sourceMappingURL=readiness-analyzer.d.ts.map

package/dist/engine/distribution/readiness-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-analyzer.d.ts","sourceRoot":"","sources":["../../../src/engine/distribution/readiness-analyzer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,MAAM,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AA6ChE,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,2BAA2B,CAqB9F"}

package/dist/engine/distribution/readiness-analyzer.js

@@ -0,0 +1,61 @@
+const CRITICAL_SPEC_PATTERNS = [
+    {
+        key: 'auth',
+        patterns: ['auth', 'login', 'jwt', 'oauth', 'session', 'token'],
+        label: 'Authentication',
+    },
+    {
+        key: 'error',
+        patterns: ['error handling', 'error boundary', 'exception'],
+        label: 'Error Handling',
+    },
+    {
+        key: 'rate-limit',
+        patterns: ['rate limit', 'throttle', 'quota'],
+        label: 'Rate Limiting',
+    },
+    {
+        key: 'monitoring',
+        patterns: ['monitoring', 'observability', 'logging', 'metrics', 'otel'],
+        label: 'Observability/Monitoring',
+    },
+    {
+        key: 'backup',
+        patterns: ['backup', 'restore', 'disaster recovery', 'data retention'],
+        label: 'Backup & Recovery',
+    },
+    {
+        key: 'cost',
+        patterns: ['cost', 'budget', 'billing', 'spending'],
+        label: 'Cost Management',
+    },
+    {
+        key: 'security',
+        patterns: ['security', 'vulnerability', 'penetration', 'audit'],
+        label: 'Security Audit',
+    },
+    {
+        key: 'ci',
+        patterns: ['ci', 'cd', 'pipeline', 'deploy', 'release'],
+        label: 'CI/CD Pipeline',
+    },
+];
+export function analyzeDistributionReadiness(specTitles) {
+    const titlesLower = specTitles.map((t) => t.toLowerCase());
+    const present = [];
+    const missing = [];
+    for (const critical of CRITICAL_SPEC_PATTERNS) {
+        const found = critical.patterns.some((p) => titlesLower.some((t) => t.includes(p)));
+        if (found) {
+            present.push(critical.label);
+        }
+        else {
+            missing.push(critical.label);
+        }
+    }
+    const score = Math.round((present.length / CRITICAL_SPEC_PATTERNS.length) * 100);
+    const level = score >= 80 ? 'ready' : score >= 50 ? 'partial' : 'not-ready';
+    const recommendations = missing.map((m) => `Create a spec for: ${m}`);
+    return { score, level, present, missing, recommendations };
+}
+//# sourceMappingURL=readiness-analyzer.js.map

package/dist/engine/distribution/readiness-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-analyzer.js","sourceRoot":"","sources":["../../../src/engine/distribution/readiness-analyzer.ts"],"names":[],"mappings":"AAMA,MAAM,sBAAsB,GAAG;IAC7B;QACE,GAAG,EAAE,MAAM;QACX,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC;QAC/D,KAAK,EAAE,gBAAgB;KACxB;IACD;QACE,GAAG,EAAE,OAAO;QACZ,QAAQ,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,CAAC;QAC3D,KAAK,EAAE,gBAAgB;KACxB;IACD;QACE,GAAG,EAAE,YAAY;QACjB,QAAQ,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC;QAC7C,KAAK,EAAE,eAAe;KACvB;IACD;QACE,GAAG,EAAE,YAAY;QACjB,QAAQ,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC;QACvE,KAAK,EAAE,0BAA0B;KAClC;IACD;QACE,GAAG,EAAE,QAAQ;QACb,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,mBAAmB,EAAE,gBAAgB,CAAC;QACtE,KAAK,EAAE,mBAAmB;KAC3B;IACD;QACE,GAAG,EAAE,MAAM;QACX,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC;QACnD,KAAK,EAAE,iBAAiB;KACzB;IACD;QACE,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,CAAC;QAC/D,KAAK,EAAE,gBAAgB;KACxB;IACD;QACE,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC;QACvD,KAAK,EAAE,gBAAgB;KACxB;CACF,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,UAAoB;IAC/D,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,QAAQ,IAAI,sBAAsB,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;IACjF,MAAM,KAAK,GACT,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;IAEhE,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;IAEtE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;AAC7D,CAAC"}

package/dist/engine/distribution/runbook-generator.d.ts

@@ -0,0 +1,7 @@
+export interface RunbookInput {
+    projectName: string;
+    provider: string;
+    services: string[];
+}
+export declare function generateRunbook(input: RunbookInput): string;
+//# sourceMappingURL=runbook-generator.d.ts.map

package/dist/engine/distribution/runbook-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runbook-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/distribution/runbook-generator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAwC3D"}

package/dist/engine/distribution/runbook-generator.js

@@ -0,0 +1,42 @@
+export function generateRunbook(input) {
+    const { projectName, provider, services } = input;
+    const date = new Date().toISOString().split('T')[0];
+    return `# Operational Runbook — ${projectName}
+Generated: ${date} | Provider: ${provider}
+
+## 1. Pre-Deployment Checklist
+- [ ] All tests passing in CI
+- [ ] Environment variables configured in ${provider} dashboard
+- [ ] Database migrations reviewed and tested on staging
+- [ ] Rollback plan documented (see section 3)
+- [ ] On-call engineer notified
+
+## 2. Deployment Steps
+${services.map((s, i) => `${i + 1}. Deploy ${s} to ${provider}`).join('\n')}
+${services.length + 1}. Run health check endpoints
+${services.length + 2}. Verify monitoring dashboards show green
+
+## 3. Rollback Procedure
+1. Identify the last stable deployment tag
+2. Trigger rollback in ${provider} dashboard → select previous deployment
+3. Verify rollback successful via health check
+4. Notify team in incident channel
+
+## 4. Health Checks
+${services.map((s) => `- GET /${s.toLowerCase().replace(/\s+/g, '-')}/health → 200 OK`).join('\n')}
+
+## 5. Alerting Thresholds
+| Metric | Warning | Critical |
+|--------|---------|----------|
+| Error rate | >1% | >5% |
+| P99 latency | >500ms | >2000ms |
+| CPU usage | >70% | >90% |
+| Memory | >80% | >95% |
+
+## 6. Incident Response
+- P1 (production down): Page on-call immediately, start incident bridge
+- P2 (degraded): Notify team, investigate within 30 minutes
+- P3 (minor): Track in issue tracker, fix in next sprint
+`;
+}
+//# sourceMappingURL=runbook-generator.js.map

package/dist/engine/distribution/runbook-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runbook-generator.js","sourceRoot":"","sources":["../../../src/engine/distribution/runbook-generator.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,eAAe,CAAC,KAAmB;IACjD,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,2BAA2B,WAAW;aAClC,IAAI,gBAAgB,QAAQ;;;;4CAIG,QAAQ;;;;;;EAMlD,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;EACzE,QAAQ,CAAC,MAAM,GAAG,CAAC;EACnB,QAAQ,CAAC,MAAM,GAAG,CAAC;;;;yBAII,QAAQ;;;;;EAK/B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;CAcjG,CAAC;AACF,CAAC"}

package/dist/engine/drift/violation-resolver.d.ts

@@ -0,0 +1,9 @@
+import type { DriftResolutionResult } from '../../types/health.js';
+/**
+ * Resolves drift violations semi-automatically by inspecting cached drift
+ * entries and taking action based on the spec's current status.
+ *
+ * When dryRun=true, returns the planned resolutions without writing any files.
+ */
+export declare function resolveDriftViolations(projectPath: string, projectId: string, dryRun?: boolean): Promise<DriftResolutionResult>;
+//# sourceMappingURL=violation-resolver.d.ts.map

package/dist/engine/drift/violation-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"violation-resolver.d.ts","sourceRoot":"","sources":["../../../src/engine/drift/violation-resolver.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAiB,MAAM,uBAAuB,CAAC;AAwFlF;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,UAAQ,GACb,OAAO,CAAC,qBAAqB,CAAC,CA+DhC"}

package/dist/engine/drift/violation-resolver.js

@@ -0,0 +1,128 @@
+// engine/drift/violation-resolver.ts — Semi-automatic drift violation resolution (SPEC-408)
+import { mkdir, writeFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { specStore } from '../../storage/index.js';
+import { DriftCacheStore } from '../../storage/drift-cache-store.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function specDirExists(specDir) {
+    try {
+        await access(specDir);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function createFollowUpSpec(projectPath, parentSpecId, reason, dryRun) {
+    const timestamp = Date.now();
+    const specId = `SPEC-followup-${parentSpecId.toLowerCase()}-${timestamp}`;
+    if (!dryRun) {
+        const specDir = join(projectPath, 'planu', 'specs', specId);
+        await mkdir(specDir, { recursive: true });
+        const now = new Date().toISOString();
+        const specContent = [
+            '---',
+            `id: ${specId}`,
+            `title: "Follow-up: ${parentSpecId} drift resolution"`,
+            `status: draft`,
+            `tags: [drift, follow-up, auto-generated]`,
+            `createdAt: ${now}`,
+            '---',
+            '',
+            `# Follow-up for ${parentSpecId}`,
+            '',
+            reason,
+            '',
+            '## Acceptance Criteria',
+            '',
+            `- [ ] Review all criteria from ${parentSpecId} against current implementation`,
+            '- [ ] Update spec or implementation to re-align',
+            '- [ ] Run detect_drift to confirm score returns to 0',
+            '',
+        ].join('\n');
+        await writeFile(join(specDir, 'spec.md'), specContent, 'utf-8');
+        await writeFile(join(specDir, 'progress.md'), `# ${specId} — Progress\n\nstatus: draft\n`, 'utf-8');
+    }
+    return specId;
+}
+// ---------------------------------------------------------------------------
+// Violation handlers per status
+// ---------------------------------------------------------------------------
+function buildDoneButDivergedResolution(specId) {
+    return {
+        specId,
+        action: 'follow-up-spec-queued',
+        description: 'Spec is done but code has diverged — follow-up spec created to track delta',
+    };
+}
+function buildInProgressAheadResolution(specId) {
+    return {
+        specId,
+        action: 'spec-note-added',
+        description: 'Spec is in-progress and code is ahead — criteria note added to flag untracked work',
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Resolves drift violations semi-automatically by inspecting cached drift
+ * entries and taking action based on the spec's current status.
+ *
+ * When dryRun=true, returns the planned resolutions without writing any files.
+ */
+export async function resolveDriftViolations(projectPath, projectId, dryRun = false) {
+    const cacheStore = new DriftCacheStore(projectId);
+    const cacheData = await cacheStore.load();
+    const cachedEntries = Object.values(cacheData.entries);
+    const specs = await specStore.listSpecs(projectId);
+    const specMap = new Map(specs.map((s) => [s.id, s]));
+    const resolved = [];
+    const followUpSpecsCreated = [];
+    const manualReview = [];
+    for (const entry of cachedEntries) {
+        const spec = specMap.get(entry.specId);
+        if (!spec) {
+            manualReview.push(`${entry.specId}: spec no longer exists — remove orphaned drift cache`);
+            continue;
+        }
+        if (spec.status === 'done') {
+            // Code diverged from a completed spec — create follow-up
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            const reason = `Drift detected (score: ${entry.driftScore.toFixed(2)}) in files: ${(entry.driftedFiles ?? []).join(', ') || 'unknown'}`;
+            const followUpId = await createFollowUpSpec(projectPath, spec.id, reason, dryRun);
+            followUpSpecsCreated.push(followUpId);
+            resolved.push(buildDoneButDivergedResolution(spec.id));
+        }
+        else if (spec.status === 'implementing') {
+            // In-progress spec with code ahead — annotate but don't block
+            resolved.push(buildInProgressAheadResolution(spec.id));
+        }
+        else if (spec.status === 'draft') {
+            // Draft spec but code already exists — flag for human review
+            manualReview.push(`${spec.id}: spec is in draft status but drift detected — review if implementation started`);
+        }
+        else {
+            manualReview.push(`${spec.id}: drift detected (status: ${spec.status}) — manual review needed`);
+        }
+    }
+    if (cachedEntries.length === 0) {
+        // Check all implementing/done specs without cached drift entries
+        const activeSpecs = specs.filter((s) => s.status === 'implementing' || s.status === 'done' || s.status === 'draft');
+        for (const spec of activeSpecs) {
+            const specDir = join(projectPath, 'planu', 'specs', spec.id);
+            const hasProgress = await specDirExists(join(specDir, 'progress.md'));
+            if (!hasProgress && spec.status === 'draft') {
+                manualReview.push(`${spec.id}: draft spec with no progress tracking — run auto_fix_health`);
+            }
+        }
+    }
+    return {
+        resolved,
+        followUpSpecsCreated,
+        manualReview,
+    };
+}
+//# sourceMappingURL=violation-resolver.js.map

package/dist/engine/drift/violation-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"violation-resolver.js","sourceRoot":"","sources":["../../../src/engine/drift/violation-resolver.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAE5F,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,KAAK,UAAU,aAAa,CAAC,OAAe;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,WAAmB,EACnB,YAAoB,EACpB,MAAc,EACd,MAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,iBAAiB,YAAY,CAAC,WAAW,EAAE,IAAI,SAAS,EAAE,CAAC;IAE1E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG;YAClB,KAAK;YACL,OAAO,MAAM,EAAE;YACf,sBAAsB,YAAY,oBAAoB;YACtD,eAAe;YACf,0CAA0C;YAC1C,cAAc,GAAG,EAAE;YACnB,KAAK;YACL,EAAE;YACF,mBAAmB,YAAY,EAAE;YACjC,EAAE;YACF,MAAM;YACN,EAAE;YACF,wBAAwB;YACxB,EAAE;YACF,kCAAkC,YAAY,iCAAiC;YAC/E,iDAAiD;YACjD,sDAAsD;YACtD,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAC5B,KAAK,MAAM,gCAAgC,EAC3C,OAAO,CACR,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,SAAS,8BAA8B,CAAC,MAAc;IACpD,OAAO;QACL,MAAM;QACN,MAAM,EAAE,uBAAuB;QAC/B,WAAW,EAAE,4EAA4E;KAC1F,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CAAC,MAAc;IACpD,OAAO;QACL,MAAM;QACN,MAAM,EAAE,iBAAiB;QACzB,WAAW,EACT,oFAAoF;KACvF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,SAAiB,EACjB,MAAM,GAAG,KAAK;IAEd,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAEvD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAErD,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,oBAAoB,GAAa,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEvC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,uDAAuD,CAAC,CAAC;YAC1F,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,yDAAyD;YACzD,uEAAuE;YACvE,MAAM,MAAM,GAAG,0BAA0B,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;YACxI,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAClF,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;YAC1C,8DAA8D;YAC9D,QAAQ,CAAC,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YACnC,6DAA6D;YAC7D,YAAY,CAAC,IAAI,CACf,GAAG,IAAI,CAAC,EAAE,iFAAiF,CAC5F,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CACf,GAAG,IAAI,CAAC,EAAE,6BAA6B,IAAI,CAAC,MAAM,0BAA0B,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,iEAAiE;QACjE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,cAAc,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,CAClF,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7D,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;YAEtE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC5C,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,8DAA8D,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,oBAAoB;QACpB,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/engine/ears/criterion-scorer.d.ts

@@ -0,0 +1,7 @@
+import type { CriterionQuality } from '../../types/ears.js';
+/**
+ * Score a single acceptance criterion using EARS and testability heuristics.
+ */
+export declare function scoreCriterion(text: string): CriterionQuality;
+export declare function gradeSpec(avgScore: number): 'A' | 'B' | 'C' | 'D' | 'F';
+//# sourceMappingURL=criterion-scorer.d.ts.map

package/dist/engine/ears/criterion-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criterion-scorer.d.ts","sourceRoot":"","sources":["../../../src/engine/ears/criterion-scorer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA8B5D;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAyD7D;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAcvE"}

package/dist/engine/ears/criterion-scorer.js

@@ -0,0 +1,87 @@
+// engine/ears/criterion-scorer.ts — EARS criterion scoring (SPEC-410)
+import { detectEarsPattern, detectVaguenessFlags, isEarsCompliant } from './pattern-matcher.js';
+import { generateRewrites } from './rewriter.js';
+// Patterns that indicate a measurable numeric threshold
+const NUMERIC_VALUE_REGEX = /\d+\s*(?:ms|milliseconds?|seconds?|minutes?|hours?|items?|%|percent|kb|mb|gb|px|requests?|users?|calls?|retries?)/i;
+// Patterns for specific API routes/endpoints
+const ENDPOINT_REGEX = /(?:\/api\/|GET\s+|POST\s+|PUT\s+|DELETE\s+|PATCH\s+)/i;
+// Patterns for clear success conditions
+const SUCCESS_CONDITION_REGEX = /\b(?:returns?|displays?|shows?|navigates?\s+to|renders?|saves?|stores?|loads?|creates?|sends?|emits?)\b/i;
+// Patterns for a measurable threshold (numeric value with unit or comparison)
+const MEASURABLE_THRESHOLD_REGEX = /\b(?:at (?:most|least)|no more than|within|fewer than|greater than|more than|\d+\s*(?:ms|seconds?|items?|%|kb|mb))\b/i;
+// Patterns for named components/features
+const COMPONENT_REGEX = /\b(?:[A-Z][a-zA-Z]+(?:Component|Page|Modal|Service|Store|API|Endpoint|Handler|Manager|Controller|View|Form|Button|Panel|Screen)|\w+[-_]\w+)\b/;
+// Patterns for trigger conditions
+const TRIGGER_REGEX = /\b(?:when|if|while|where|after|before|on(?:ce)?)\b/i;
+// Patterns for actors
+const ACTOR_REGEX = /\b(?:user|admin|system|operator|manager|client|server|guest|subscriber|owner)\b/i;
+/**
+ * Score a single acceptance criterion using EARS and testability heuristics.
+ */
+export function scoreCriterion(text) {
+    const earsPattern = detectEarsPattern(text);
+    const earsCompliant = isEarsCompliant(text);
+    const vaguenessFlagsFound = detectVaguenessFlags(text);
+    const vaguenessDeduction = Math.min(vaguenessFlagsFound.length * 2, 10);
+    // --- Testability Score (0-10) ---
+    let testabilityScore = 0;
+    if (NUMERIC_VALUE_REGEX.test(text)) {
+        testabilityScore += 3;
+    }
+    if (earsCompliant) {
+        testabilityScore += 3;
+    }
+    if (ENDPOINT_REGEX.test(text)) {
+        testabilityScore += 2;
+    }
+    if (SUCCESS_CONDITION_REGEX.test(text)) {
+        testabilityScore += 2;
+    }
+    testabilityScore = Math.max(0, testabilityScore - vaguenessDeduction);
+    testabilityScore = Math.min(10, testabilityScore);
+    // --- Specificity Score (0-10) ---
+    let specificityScore = 0;
+    if (MEASURABLE_THRESHOLD_REGEX.test(text) || NUMERIC_VALUE_REGEX.test(text)) {
+        specificityScore += 4;
+    }
+    if (COMPONENT_REGEX.test(text)) {
+        specificityScore += 3;
+    }
+    if (TRIGGER_REGEX.test(text)) {
+        specificityScore += 2;
+    }
+    if (ACTOR_REGEX.test(text)) {
+        specificityScore += 1;
+    }
+    specificityScore = Math.max(0, specificityScore - vaguenessDeduction);
+    specificityScore = Math.min(10, specificityScore);
+    const overallScore = Math.round(((testabilityScore + specificityScore) / 2) * 10) / 10;
+    // Generate rewrite suggestions only when score is below threshold
+    const rewriteSuggestions = overallScore < 7 ? generateRewrites(text, earsPattern) : [];
+    return {
+        text,
+        testabilityScore,
+        specificityScore,
+        earsPattern,
+        earsCompliant,
+        vaguenessFlagsFound,
+        overallScore,
+        rewriteSuggestions,
+    };
+}
+export function gradeSpec(avgScore) {
+    if (avgScore >= 9) {
+        return 'A';
+    }
+    if (avgScore >= 7) {
+        return 'B';
+    }
+    if (avgScore >= 5) {
+        return 'C';
+    }
+    if (avgScore >= 3) {
+        return 'D';
+    }
+    return 'F';
+}
+//# sourceMappingURL=criterion-scorer.js.map

package/dist/engine/ears/criterion-scorer.js.map

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

package/dist/engine/ears/pattern-matcher.d.ts

@@ -0,0 +1,5 @@
+import type { EarsPattern } from '../../types/ears.js';
+export declare function detectEarsPattern(criterion: string): EarsPattern;
+export declare function detectVaguenessFlags(criterion: string): string[];
+export declare function isEarsCompliant(criterion: string): boolean;
+//# sourceMappingURL=pattern-matcher.d.ts.map

package/dist/engine/ears/pattern-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.d.ts","sourceRoot":"","sources":["../../../src/engine/ears/pattern-matcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA+BvD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAOhE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhE;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1D"}