@planu/cli 1.1.1 → 1.2.0

package/dist/engine/code-impact-analyzer.js

@@ -0,0 +1,152 @@
+// engine/code-impact-analyzer.ts — Code Change → Spec Impact Analyzer (SPEC-366)
+import { execSync } from 'node:child_process';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function specIdFromPath(specId) {
+    return specId.toLowerCase().replace(/-/g, '');
+}
+function fileMatchesSpec(filePath, spec) {
+    const lower = filePath.toLowerCase();
+    const specLower = specIdFromPath(spec.id);
+    // Direct binding: file path contains specId
+    if (lower.includes(specLower)) {
+        return 'direct-binding';
+    }
+    // Filename match: spec title words appear in the file path
+    const titleWords = spec.title
+        .toLowerCase()
+        .split(/\W+/)
+        .filter((w) => w.length > 3);
+    const matchCount = titleWords.filter((w) => lower.includes(w)).length;
+    if (titleWords.length > 0 && matchCount >= Math.ceil(titleWords.length * 0.5)) {
+        return 'filename-match';
+    }
+    // Semantic match: spec tags appear in the diff/path
+    const specTags = spec.tags.map((t) => t.toLowerCase());
+    if (specTags.some((t) => lower.includes(t))) {
+        return 'semantic-match';
+    }
+    return null;
+}
+function diffMatchesSpec(diffText, spec) {
+    const lower = diffText.toLowerCase();
+    const specLower = specIdFromPath(spec.id);
+    if (lower.includes(specLower)) {
+        return 'direct-binding';
+    }
+    const titleWords = spec.title
+        .toLowerCase()
+        .split(/\W+/)
+        .filter((w) => w.length > 3);
+    const matchCount = titleWords.filter((w) => lower.includes(w)).length;
+    if (titleWords.length > 0 && matchCount >= Math.ceil(titleWords.length * 0.5)) {
+        return 'semantic-match';
+    }
+    const specTags = spec.tags.map((t) => t.toLowerCase());
+    if (specTags.some((t) => lower.includes(t))) {
+        return 'semantic-match';
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function analyzeCodeImpact(specs, filePath, diffText) {
+    const affectedSpecs = [];
+    for (const spec of specs) {
+        let relation = null;
+        if (filePath !== undefined) {
+            relation = fileMatchesSpec(filePath, spec);
+        }
+        if (relation === null && diffText !== undefined) {
+            relation = diffMatchesSpec(diffText, spec);
+        }
+        if (relation !== null) {
+            affectedSpecs.push({
+                specId: spec.id,
+                title: spec.title,
+                relation,
+                status: spec.status,
+            });
+        }
+    }
+    // Sort by relation priority
+    const order = {
+        'direct-binding': 0,
+        'filename-match': 1,
+        'semantic-match': 2,
+    };
+    affectedSpecs.sort((a, b) => order[a.relation] - order[b.relation]);
+    return {
+        ...(filePath !== undefined ? { filePath } : {}),
+        affectedSpecs,
+        totalSpecs: specs.length,
+    };
+}
+export function checkCodeChangeCompliance(specs, filePath, commitDiff) {
+    const impact = analyzeCodeImpact(specs, filePath, commitDiff);
+    const approvedStatuses = new Set(['approved', 'implementing', 'done', 'in-progress']);
+    const justifyingSpecs = impact.affectedSpecs.filter((s) => approvedStatuses.has(s.status.toLowerCase()));
+    const unjustifiedChanges = [];
+    if (impact.affectedSpecs.length === 0) {
+        unjustifiedChanges.push({
+            filePath: filePath ?? 'unknown',
+            reason: 'No related specs found for this change.',
+        });
+    }
+    else if (justifyingSpecs.length === 0) {
+        unjustifiedChanges.push({
+            filePath: filePath ?? 'unknown',
+            reason: `Related specs found (${impact.affectedSpecs.map((s) => s.specId).join(', ')}) but none are approved/implementing.`,
+        });
+    }
+    const total = impact.affectedSpecs.length === 0 ? 0 : justifyingSpecs.length;
+    const denom = Math.max(impact.affectedSpecs.length, 1);
+    const complianceScore = Math.round((total / denom) * 100);
+    const summary = complianceScore >= 100
+        ? `Change is fully justified by ${String(justifyingSpecs.length)} spec(s).`
+        : complianceScore > 0
+            ? `Partial compliance (${String(complianceScore)}%). Some specs are not yet approved.`
+            : 'Change is not justified by any approved spec.';
+    return { complianceScore, justifyingSpecs, unjustifiedChanges, summary };
+}
+export function suggestSpecUpdates(specs, filePath) {
+    const suggestions = [];
+    const impact = analyzeCodeImpact(specs, filePath);
+    if (impact.affectedSpecs.length === 0) {
+        suggestions.push({
+            type: 'create',
+            reason: `No specs found for "${filePath}". Consider creating a new spec to document this functionality.`,
+        });
+    }
+    else {
+        for (const affected of impact.affectedSpecs) {
+            const spec = specs.find((s) => s.id === affected.specId);
+            if (spec !== undefined && spec.status !== 'done') {
+                suggestions.push({
+                    type: 'update',
+                    specId: affected.specId,
+                    title: spec.title,
+                    reason: `File "${filePath}" matches this spec (${affected.relation}). Update acceptance criteria if behavior changed.`,
+                });
+            }
+        }
+    }
+    return { filePath, suggestions };
+}
+export function runGitDiffImpact(specs, projectPath) {
+    let diffText = '';
+    try {
+        diffText = execSync('git diff HEAD', {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch {
+        // ignore git errors — proceed with empty diff
+    }
+    return analyzeCodeImpact(specs, undefined, diffText);
+}
+//# sourceMappingURL=code-impact-analyzer.js.map

package/dist/engine/code-impact-analyzer.js.map

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

package/dist/engine/compliance-reporter.d.ts

@@ -0,0 +1,11 @@
+import type { ComplianceStandard, AuditComplianceGap, ComplianceReportFormat, AuditExportFormat, Spec } from '../types/index.js';
+export declare function generateComplianceReport(_projectPath: string, standard: ComplianceStandard, format: ComplianceReportFormat): {
+    content: string;
+    mimeType: string;
+};
+export declare function exportAuditLog(specs: Spec[], format: AuditExportFormat, dateRange?: {
+    from?: string;
+    to?: string;
+}): string;
+export declare function analyzeComplianceGaps(standard: ComplianceStandard): AuditComplianceGap[];
+//# sourceMappingURL=compliance-reporter.d.ts.map

package/dist/engine/compliance-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compliance-reporter.d.ts","sourceRoot":"","sources":["../../src/engine/compliance-reporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAGlB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,IAAI,EACL,MAAM,mBAAmB,CAAC;AAgI3B,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,sBAAsB,GAC7B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAgEvC;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,IAAI,EAAE,EACb,MAAM,EAAE,iBAAiB,EACzB,SAAS,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,MAAM,CA4CR;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAqCxF"}

package/dist/engine/compliance-reporter.js

@@ -0,0 +1,245 @@
+// engine/compliance-reporter.ts — SPEC-371: Compliance & Audit Reports
+// ---------------------------------------------------------------------------
+// SOC2 controls mapped to Planu features
+// ---------------------------------------------------------------------------
+function getSoc2Controls() {
+    return [
+        {
+            id: 'CC6',
+            name: 'Logical and Physical Access Controls',
+            description: 'Access to specs requires approval workflow',
+            status: 'satisfied',
+            evidence: 'Planu approval workflow enforces review before spec transitions',
+        },
+        {
+            id: 'CC7',
+            name: 'System Operations',
+            description: 'Audit trail captures all spec operations',
+            status: 'satisfied',
+            evidence: 'audit_trail tool records create/update/approve/validate events',
+        },
+        {
+            id: 'CC8',
+            name: 'Change Management',
+            description: 'Spec versioning tracks all changes',
+            status: 'satisfied',
+            evidence: 'spec_version_history captures diffs for every spec update',
+        },
+        {
+            id: 'A1',
+            name: 'Availability',
+            description: 'Data stored locally with no single point of failure',
+            status: 'satisfied',
+            evidence: 'JSON files in data/ directory with atomic writes',
+        },
+    ];
+}
+function getIso27001Controls() {
+    return [
+        {
+            id: 'A.8.1',
+            name: 'Responsibility for Assets',
+            description: 'Specs assigned to owners via role management',
+            status: 'partial',
+            evidence: 'assign_role tool exists; not always used',
+            recommendation: 'Enforce role assignment on spec creation',
+        },
+        {
+            id: 'A.12.4',
+            name: 'Logging and Monitoring',
+            description: 'Audit trail covers spec lifecycle events',
+            status: 'satisfied',
+            evidence: 'audit_trail stores immutable event log',
+        },
+        {
+            id: 'A.14.2',
+            name: 'Security in Development',
+            description: 'Specs validated before implementation',
+            status: 'satisfied',
+            evidence: 'validate tool enforces acceptance criteria before done status',
+        },
+    ];
+}
+function getGdprControls() {
+    return [
+        {
+            id: 'Art.5',
+            name: 'Data Minimization',
+            description: 'Only spec content stored — no personal data collected',
+            status: 'satisfied',
+            evidence: 'Planu stores only spec content and project metadata',
+        },
+        {
+            id: 'Art.17',
+            name: 'Right to Erasure',
+            description: 'delete_spec and delete_project remove all data',
+            status: 'satisfied',
+            evidence: 'delete_spec tool removes spec files; delete_project removes project dir',
+        },
+        {
+            id: 'Art.32',
+            name: 'Security of Processing',
+            description: 'Data stored locally; no external transmission',
+            status: 'partial',
+            evidence: 'Telemetry opt-in sends anonymized data',
+            recommendation: 'Document telemetry data types in privacy notice',
+        },
+    ];
+}
+function getHipaaControls() {
+    return [
+        {
+            id: '164.312(b)',
+            name: 'Audit Controls',
+            description: 'Audit trail records all access and modifications',
+            status: 'satisfied',
+            evidence: 'audit_trail tool available',
+        },
+        {
+            id: '164.312(e)(1)',
+            name: 'Transmission Security',
+            description: 'MCP transport security',
+            status: 'partial',
+            evidence: 'MCP uses stdio by default; HTTP transport requires TLS configuration',
+            recommendation: 'Enable HTTPS transport with TLS for network deployments',
+        },
+    ];
+}
+function getControls(standard) {
+    switch (standard) {
+        case 'soc2-type2':
+            return getSoc2Controls();
+        case 'iso27001':
+            return getIso27001Controls();
+        case 'gdpr':
+            return getGdprControls();
+        case 'hipaa':
+            return getHipaaControls();
+        case 'custom':
+            return getSoc2Controls();
+    }
+}
+export function generateComplianceReport(_projectPath, standard, format) {
+    const controls = getControls(standard);
+    const satisfiedCount = controls.filter((c) => c.status === 'satisfied').length;
+    const overallStatus = satisfiedCount === controls.length
+        ? 'compliant'
+        : satisfiedCount > 0
+            ? 'partial'
+            : 'non-compliant';
+    const report = {
+        standard,
+        generatedAt: new Date().toISOString(),
+        controls,
+        overallStatus,
+        summary: `${standard.toUpperCase()} compliance assessment: ${satisfiedCount}/${controls.length} controls satisfied.`,
+    };
+    if (format === 'json') {
+        return { content: JSON.stringify(report, null, 2), mimeType: 'application/json' };
+    }
+    // HTML format
+    const rows = controls
+        .map((c) => `<tr>
+          <td>${c.id}</td>
+          <td>${c.name}</td>
+          <td class="${c.status}">${c.status}</td>
+          <td>${c.evidence ?? ''}</td>
+          <td>${c.recommendation ?? ''}</td>
+        </tr>`)
+        .join('\n');
+    const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>${standard.toUpperCase()} Compliance Report</title>
+  <style>
+    body { font-family: sans-serif; padding: 2rem; }
+    h1 { color: #1a1a2e; }
+    table { border-collapse: collapse; width: 100%; }
+    th, td { border: 1px solid #ccc; padding: 8px; text-align: left; }
+    th { background: #f0f0f0; }
+    .satisfied { color: green; font-weight: bold; }
+    .partial { color: orange; }
+    .gap { color: red; font-weight: bold; }
+  </style>
+</head>
+<body>
+  <h1>${standard.toUpperCase()} Compliance Report</h1>
+  <p>Generated: ${report.generatedAt}</p>
+  <p>Status: <strong>${overallStatus}</strong> — ${report.summary}</p>
+  <table>
+    <thead><tr><th>Control</th><th>Name</th><th>Status</th><th>Evidence</th><th>Recommendation</th></tr></thead>
+    <tbody>${rows}</tbody>
+  </table>
+</body>
+</html>`;
+    return { content: html, mimeType: 'text/html' };
+}
+export function exportAuditLog(specs, format, dateRange) {
+    // Build synthetic audit entries from spec history
+    const entries = specs.map((s) => ({
+        timestamp: s.updatedAt,
+        specId: s.id,
+        title: s.title,
+        status: s.status,
+        action: 'status-change',
+        actor: 'system',
+    }));
+    // Apply date filter
+    const filtered = entries.filter((e) => {
+        const ts = new Date(e.timestamp).getTime();
+        if (dateRange?.from && ts < new Date(dateRange.from).getTime()) {
+            return false;
+        }
+        if (dateRange?.to && ts > new Date(dateRange.to).getTime()) {
+            return false;
+        }
+        return true;
+    });
+    if (format === 'csv') {
+        const header = 'timestamp,specId,title,status,action,actor';
+        const rows = filtered.map((e) => `"${e.timestamp}","${e.specId}","${e.title}","${e.status}","${e.action}","${e.actor}"`);
+        return [header, ...rows].join('\n');
+    }
+    if (format === 'json-ld') {
+        return JSON.stringify({
+            '@context': 'https://schema.org',
+            '@type': 'ItemList',
+            items: filtered,
+        }, null, 2);
+    }
+    return JSON.stringify(filtered, null, 2);
+}
+export function analyzeComplianceGaps(standard) {
+    const controls = getControls(standard);
+    const gaps = [];
+    for (const control of controls) {
+        if (control.status === 'gap' || control.status === 'partial') {
+            gaps.push({
+                controlId: control.id,
+                controlName: control.name,
+                gap: control.recommendation ?? 'Not fully implemented',
+                recommendation: control.recommendation ?? 'Review and implement missing controls',
+                severity: control.status === 'gap' ? 'critical' : 'medium',
+            });
+        }
+    }
+    // Standard-specific known gaps
+    if (standard === 'soc2-type2' || standard === 'iso27001') {
+        gaps.push({
+            controlId: 'AUTH',
+            controlName: 'Multi-Factor Authentication',
+            gap: 'No MFA configured for Planu server access',
+            recommendation: 'Implement MFA for HTTP transport endpoints',
+            severity: 'high',
+        }, {
+            controlId: 'ENC',
+            controlName: 'Encryption at Rest',
+            gap: 'Audit logs not encrypted at rest',
+            recommendation: 'Enable filesystem-level encryption or use encrypted storage',
+            severity: 'high',
+        });
+    }
+    return gaps;
+}
+//# sourceMappingURL=compliance-reporter.js.map

package/dist/engine/compliance-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compliance-reporter.js","sourceRoot":"","sources":["../../src/engine/compliance-reporter.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAYvE,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E,SAAS,eAAe;IACtB,OAAO;QACL;YACE,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,sCAAsC;YAC5C,WAAW,EAAE,4CAA4C;YACzD,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,iEAAiE;SAC5E;QACD;YACE,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,0CAA0C;YACvD,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,gEAAgE;SAC3E;QACD;YACE,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,oCAAoC;YACjD,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,2DAA2D;SACtE;QACD;YACE,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,qDAAqD;YAClE,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,kDAAkD;SAC7D;KACF,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO;QACL;YACE,EAAE,EAAE,OAAO;YACX,IAAI,EAAE,2BAA2B;YACjC,WAAW,EAAE,8CAA8C;YAC3D,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,0CAA0C;YACpD,cAAc,EAAE,0CAA0C;SAC3D;QACD;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EAAE,0CAA0C;YACvD,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,wCAAwC;SACnD;QACD;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,uCAAuC;YACpD,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,+DAA+D;SAC1E;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe;IACtB,OAAO;QACL;YACE,EAAE,EAAE,OAAO;YACX,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,uDAAuD;YACpE,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,qDAAqD;SAChE;QACD;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,gDAAgD;YAC7D,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,yEAAyE;SACpF;QACD;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EAAE,+CAA+C;YAC5D,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,wCAAwC;YAClD,cAAc,EAAE,iDAAiD;SAClE;KACF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO;QACL;YACE,EAAE,EAAE,YAAY;YAChB,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,kDAAkD;YAC/D,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,4BAA4B;SACvC;QACD;YACE,EAAE,EAAE,eAAe;YACnB,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EAAE,wBAAwB;YACrC,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,sEAAsE;YAChF,cAAc,EAAE,yDAAyD;SAC1E;KACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,QAA4B;IAC/C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,eAAe,EAAE,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,mBAAmB,EAAE,CAAC;QAC/B,KAAK,MAAM;YACT,OAAO,eAAe,EAAE,CAAC;QAC3B,KAAK,OAAO;YACV,OAAO,gBAAgB,EAAE,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,eAAe,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,YAAoB,EACpB,QAA4B,EAC5B,MAA8B;IAE9B,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAC/E,MAAM,aAAa,GACjB,cAAc,KAAK,QAAQ,CAAC,MAAM;QAChC,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,cAAc,GAAG,CAAC;YAClB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,eAAe,CAAC;IAExB,MAAM,MAAM,GAAqB;QAC/B,QAAQ;QACR,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,QAAQ;QACR,aAAa;QACb,OAAO,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,2BAA2B,cAAc,IAAI,QAAQ,CAAC,MAAM,sBAAsB;KACrH,CAAC;IAEF,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IACpF,CAAC;IAED,cAAc;IACd,MAAM,IAAI,GAAG,QAAQ;SAClB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ;gBACQ,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,IAAI;uBACC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;gBAC5B,CAAC,CAAC,QAAQ,IAAI,EAAE;gBAChB,CAAC,CAAC,cAAc,IAAI,EAAE;cACxB,CACT;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,IAAI,GAAG;;;;WAIJ,QAAQ,CAAC,WAAW,EAAE;;;;;;;;;;;;;QAazB,QAAQ,CAAC,WAAW,EAAE;kBACZ,MAAM,CAAC,WAAW;uBACb,aAAa,eAAe,MAAM,CAAC,OAAO;;;aAGpD,IAAI;;;QAGT,CAAC;IAEP,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,MAAyB,EACzB,SAA0C;IAE1C,kDAAkD;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,MAAM,EAAE,CAAC,CAAC,EAAE;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,eAAe;QACvB,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC,CAAC;IAEJ,oBAAoB;IACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACpC,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3C,IAAI,SAAS,EAAE,IAAI,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,4CAA4C,CAAC;QAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CACvB,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,KAAK,GAAG,CAC9F,CAAC;QACF,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,SAAS,CACnB;YACE,UAAU,EAAE,oBAAoB;YAChC,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,QAAQ;SAChB,EACD,IAAI,EACJ,CAAC,CACF,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAA4B;IAChE,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,IAAI,GAAyB,EAAE,CAAC;IAEtC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7D,IAAI,CAAC,IAAI,CAAC;gBACR,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,WAAW,EAAE,OAAO,CAAC,IAAI;gBACzB,GAAG,EAAE,OAAO,CAAC,cAAc,IAAI,uBAAuB;gBACtD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,uCAAuC;gBACjF,QAAQ,EAAE,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ;aAC3D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,IAAI,QAAQ,KAAK,YAAY,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QACzD,IAAI,CAAC,IAAI,CACP;YACE,SAAS,EAAE,MAAM;YACjB,WAAW,EAAE,6BAA6B;YAC1C,GAAG,EAAE,2CAA2C;YAChD,cAAc,EAAE,4CAA4C;YAC5D,QAAQ,EAAE,MAAM;SACjB,EACD;YACE,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,oBAAoB;YACjC,GAAG,EAAE,kCAAkC;YACvC,cAAc,EAAE,6DAA6D;YAC7E,QAAQ,EAAE,MAAM;SACjB,CACF,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/engine/context-manager.d.ts

@@ -0,0 +1,7 @@
+import type { ContextTokenBreakdown, ContextOptimizeSuggestion, Spec } from '../types/index.js';
+export declare function estimateTokenBreakdown(specCount: number, decisionCount: number, lessonCount: number): ContextTokenBreakdown;
+export declare function suggestArchivableSpecs(specs: Spec[], archiveAfterDays: number): ContextOptimizeSuggestion;
+export declare function archiveSpecToPath(archivePath: string, spec: Spec): Promise<void>;
+export declare function restoreArchivedSpecFromPath(archivePath: string): Promise<boolean>;
+export declare function listArchivedSpecIds(archiveDir: string): Promise<string[]>;
+//# sourceMappingURL=context-manager.d.ts.map

package/dist/engine/context-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../../src/engine/context-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,qBAAqB,EACrB,yBAAyB,EAEzB,IAAI,EACL,MAAM,mBAAmB,CAAC;AAM3B,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,qBAAqB,CAavB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,EAAE,EACb,gBAAgB,EAAE,MAAM,GACvB,yBAAyB,CAoC3B;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAOtF;AAED,wBAAsB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQvF;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAO/E"}

package/dist/engine/context-manager.js

@@ -0,0 +1,76 @@
+// engine/context-manager.ts — SPEC-370: Context Window Management
+import { readdir, readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+const TOKENS_PER_SPEC = 1500;
+const TOKENS_PER_DECISION = 200;
+const TOKENS_PER_LESSON = 150;
+export function estimateTokenBreakdown(specCount, decisionCount, lessonCount) {
+    return {
+        specs: specCount * TOKENS_PER_SPEC,
+        decisions: decisionCount * TOKENS_PER_DECISION,
+        lessons: lessonCount * TOKENS_PER_LESSON,
+        total: specCount * TOKENS_PER_SPEC +
+            decisionCount * TOKENS_PER_DECISION +
+            lessonCount * TOKENS_PER_LESSON,
+        specCount,
+        decisionCount,
+        lessonCount,
+    };
+}
+export function suggestArchivableSpecs(specs, archiveAfterDays) {
+    const now = Date.now();
+    const archivable = [];
+    for (const spec of specs) {
+        if (spec.status !== 'done') {
+            continue;
+        }
+        const doneAt = spec.updatedAt;
+        const doneMs = doneAt ? new Date(doneAt).getTime() : 0;
+        const daysSince = Math.floor((now - doneMs) / (24 * 60 * 60 * 1000));
+        if (doneAt && daysSince < archiveAfterDays) {
+            continue;
+        }
+        const relevanceScore = Math.max(0, 100 - daysSince);
+        archivable.push({
+            specId: spec.id,
+            title: spec.title,
+            status: spec.status,
+            estimatedTokens: TOKENS_PER_SPEC,
+            daysSinceDone: daysSince,
+            relevanceScore,
+        });
+    }
+    archivable.sort((a, b) => a.relevanceScore - b.relevanceScore);
+    const potentialSavings = archivable.length * TOKENS_PER_SPEC;
+    return {
+        specs: archivable,
+        potentialSavings,
+        recommendation: archivable.length > 0
+            ? `Archive ${archivable.length} done spec(s) to save ~${potentialSavings.toLocaleString()} tokens`
+            : 'No archivable specs found. All done specs are recent or already archived.',
+    };
+}
+export async function archiveSpecToPath(archivePath, spec) {
+    await mkdir(dirname(archivePath), { recursive: true });
+    await writeFile(archivePath, JSON.stringify({ spec, archivedAt: new Date().toISOString() }), 'utf8');
+}
+export async function restoreArchivedSpecFromPath(archivePath) {
+    try {
+        const raw = await readFile(archivePath, 'utf8');
+        const data = JSON.parse(raw);
+        return data !== null && typeof data === 'object';
+    }
+    catch {
+        return false;
+    }
+}
+export async function listArchivedSpecIds(archiveDir) {
+    try {
+        const files = await readdir(archiveDir);
+        return files.filter((f) => f.endsWith('.json')).map((f) => f.replace('.json', ''));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=context-manager.js.map

package/dist/engine/context-manager.js.map

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

package/dist/engine/cost-budget-manager.d.ts

@@ -0,0 +1,10 @@
+import type { CostBudget, CostBudgetData, CostForecast, CostBudgetStatus, BudgetHistoryEntry, BudgetPeriod } from '../types/index.js';
+export declare function generateAlertRuleId(trigger: string, threshold: number): string;
+export declare function computeForecast(history: BudgetHistoryEntry[], period: BudgetPeriod, currency: CostBudget['currency']): CostForecast;
+export declare function computeBudgetStatus(data: CostBudgetData, currentSpendUSD: number): CostBudgetStatus;
+export declare function buildHistoryFromEntries(entries: {
+    timestamp: string;
+    costUsd: number;
+    totalTokens: number;
+}[], days: number): BudgetHistoryEntry[];
+//# sourceMappingURL=cost-budget-manager.d.ts.map

package/dist/engine/cost-budget-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-budget-manager.d.ts","sourceRoot":"","sources":["../../src/engine/cost-budget-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EAEd,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAM3B,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM9E;AAuDD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,kBAAkB,EAAE,EAC7B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,GAC/B,YAAY,CA8Bd;AAMD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,EACpB,eAAe,EAAE,MAAM,GACtB,gBAAgB,CAoDlB;AAkBD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,EACtE,IAAI,EAAE,MAAM,GACX,kBAAkB,EAAE,CAsBtB"}