@planu/cli 1.1.2 → 1.3.0

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

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/continue-config-generator.d.ts

@@ -0,0 +1,15 @@
+import type { ContinueConfigFile, ContinueMcpServerEntry, ContinueTransport } from '../types/index.js';
+/**
+ * Build the MCP server entry for Planu depending on transport type.
+ */
+export declare function buildPlanuMcpEntry(transport: ContinueTransport, hostedUrl?: string): ContinueMcpServerEntry;
+/**
+ * Generate the full .continue/config.json content.
+ */
+export declare function generateContinueConfig(transport: ContinueTransport, hostedUrl?: string): ContinueConfigFile;
+/**
+ * Check whether a parsed .continue/config.json has a Planu MCP entry.
+ * Returns the transport type if found, otherwise null.
+ */
+export declare function detectPlanuTransport(config: ContinueConfigFile): ContinueTransport | null;
+//# sourceMappingURL=continue-config-generator.d.ts.map

package/dist/engine/continue-config-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continue-config-generator.d.ts","sourceRoot":"","sources":["../../src/engine/continue-config-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAgB3B;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,iBAAiB,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,sBAAsB,CAaxB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,iBAAiB,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,kBAAkB,CAMpB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,IAAI,CASzF"}

package/dist/engine/continue-config-generator.js

@@ -0,0 +1,53 @@
+// ---------------------------------------------------------------------------
+// Slash commands included in every Continue config
+// ---------------------------------------------------------------------------
+const PLANU_SLASH_COMMANDS = [
+    { name: 'spec', description: 'Look up a Planu spec by ID' },
+    { name: 'validate', description: 'Validate current spec compliance' },
+    { name: 'criteria', description: 'Show acceptance criteria for current spec' },
+];
+// ---------------------------------------------------------------------------
+// Public functions
+// ---------------------------------------------------------------------------
+/**
+ * Build the MCP server entry for Planu depending on transport type.
+ */
+export function buildPlanuMcpEntry(transport, hostedUrl) {
+    if (transport === 'sse') {
+        return {
+            name: 'planu',
+            transport: { type: 'sse', url: hostedUrl ?? '' },
+        };
+    }
+    return {
+        name: 'planu',
+        command: 'npx',
+        args: ['-y', '@planu/cli'],
+        transport: 'stdio',
+    };
+}
+/**
+ * Generate the full .continue/config.json content.
+ */
+export function generateContinueConfig(transport, hostedUrl) {
+    const mcpEntry = buildPlanuMcpEntry(transport, hostedUrl);
+    return {
+        mcpServers: [mcpEntry],
+        slashCommands: PLANU_SLASH_COMMANDS,
+    };
+}
+/**
+ * Check whether a parsed .continue/config.json has a Planu MCP entry.
+ * Returns the transport type if found, otherwise null.
+ */
+export function detectPlanuTransport(config) {
+    const entry = config.mcpServers.find((s) => s.name === 'planu');
+    if (!entry) {
+        return null;
+    }
+    if (typeof entry.transport === 'object' && entry.transport.type === 'sse') {
+        return 'sse';
+    }
+    return 'stdio';
+}
+//# sourceMappingURL=continue-config-generator.js.map

package/dist/engine/continue-config-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continue-config-generator.js","sourceRoot":"","sources":["../../src/engine/continue-config-generator.ts"],"names":[],"mappings":"AAOA,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E,MAAM,oBAAoB,GAAG;IAC3B,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,4BAA4B,EAAE;IAC3D,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,kCAAkC,EAAE;IACrE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,2CAA2C,EAAE;CAC/E,CAAC;AAEF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA4B,EAC5B,SAAkB;IAElB,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO;YACL,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,IAAI,EAAE,EAAE;SACjD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;QAC1B,SAAS,EAAE,OAAO;KACnB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAA4B,EAC5B,SAAkB;IAElB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1D,OAAO;QACL,UAAU,EAAE,CAAC,QAAQ,CAAC;QACtB,aAAa,EAAE,oBAAoB;KACpC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA0B;IAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

package/dist/engine/cost-budget-manager.js

@@ -0,0 +1,165 @@
+// engine/cost-budget-manager.ts — Cost Budget & Alerts Manager (SPEC-367)
+import { createHash } from 'node:crypto';
+// ---------------------------------------------------------------------------
+// ID generation
+// ---------------------------------------------------------------------------
+export function generateAlertRuleId(trigger, threshold) {
+    const hash = createHash('sha256')
+        .update(`${trigger}-${String(threshold)}-${Date.now()}`)
+        .digest('hex')
+        .slice(0, 8);
+    return `alert-${hash}`;
+}
+// ---------------------------------------------------------------------------
+// Period spend calculation
+// ---------------------------------------------------------------------------
+function getPeriodStart(period) {
+    const now = new Date();
+    switch (period) {
+        case 'daily': {
+            const d = new Date(now);
+            d.setHours(0, 0, 0, 0);
+            return d;
+        }
+        case 'weekly': {
+            const d = new Date(now);
+            d.setDate(d.getDate() - 6);
+            d.setHours(0, 0, 0, 0);
+            return d;
+        }
+        case 'monthly': {
+            const d = new Date(now);
+            d.setDate(1);
+            d.setHours(0, 0, 0, 0);
+            return d;
+        }
+        case 'total':
+            return new Date(0);
+    }
+}
+function getDaysRemainingInPeriod(period) {
+    const now = new Date();
+    switch (period) {
+        case 'daily':
+            return 1;
+        case 'weekly': {
+            const start = getPeriodStart('weekly');
+            const total = 7;
+            const elapsed = Math.floor((now.getTime() - start.getTime()) / (1000 * 60 * 60 * 24));
+            return Math.max(0, total - elapsed);
+        }
+        case 'monthly': {
+            const lastDay = new Date(now.getFullYear(), now.getMonth() + 1, 0).getDate();
+            return lastDay - now.getDate() + 1;
+        }
+        case 'total':
+            return 365;
+    }
+}
+// ---------------------------------------------------------------------------
+// Forecast
+// ---------------------------------------------------------------------------
+export function computeForecast(history, period, currency) {
+    const MIN_DATA_POINTS = 3;
+    const daysRemaining = getDaysRemainingInPeriod(period);
+    if (history.length < MIN_DATA_POINTS) {
+        const currentSpend = history.reduce((acc, h) => acc + h.spendUSD, 0);
+        return {
+            currentPeriodSpendUSD: currentSpend,
+            projectedPeriodSpendUSD: null,
+            daysRemaining,
+            currency,
+            dataPoints: history.length,
+            insufficientData: true,
+        };
+    }
+    const recentDays = history.slice(-7);
+    const avgDailySpend = recentDays.reduce((acc, h) => acc + h.spendUSD, 0) / recentDays.length;
+    const currentSpend = history.reduce((acc, h) => acc + h.spendUSD, 0);
+    const projectedRemaining = avgDailySpend * daysRemaining;
+    return {
+        currentPeriodSpendUSD: currentSpend,
+        projectedPeriodSpendUSD: currentSpend + projectedRemaining,
+        daysRemaining,
+        currency,
+        dataPoints: history.length,
+        insufficientData: false,
+    };
+}
+// ---------------------------------------------------------------------------
+// Budget status
+// ---------------------------------------------------------------------------
+export function computeBudgetStatus(data, currentSpendUSD) {
+    if (data.budget === undefined) {
+        return {
+            budget: null,
+            currentSpendUSD,
+            percentUsed: null,
+            triggeredAlerts: [],
+            status: 'no-budget',
+        };
+    }
+    const budget = data.budget;
+    const percentUsed = (currentSpendUSD / budget.maxUSD) * 100;
+    const triggeredAlerts = [];
+    const now = new Date().toISOString();
+    for (const rule of data.alertRules) {
+        const shouldTrigger = shouldRuleTrigger(rule, currentSpendUSD, percentUsed, budget);
+        if (!shouldTrigger) {
+            continue;
+        }
+        // Check cooldown
+        if (rule.lastTriggeredAt !== undefined) {
+            const elapsed = (new Date(now).getTime() - new Date(rule.lastTriggeredAt).getTime()) / (1000 * 60);
+            if (elapsed < rule.cooldownMinutes) {
+                continue;
+            }
+        }
+        triggeredAlerts.push(`Alert "${rule.id}": ${rule.trigger} threshold ${String(rule.threshold)} reached ` +
+            `(current: ${currentSpendUSD.toFixed(4)} USD, ${percentUsed.toFixed(1)}%). ` +
+            `Channels: ${rule.channels.join(', ')}`);
+    }
+    let status;
+    if (percentUsed >= 100) {
+        status = 'critical';
+    }
+    else if (budget.alertThresholds.length > 0 &&
+        percentUsed >= (budget.alertThresholds[budget.alertThresholds.length - 1] ?? 80)) {
+        status = 'warning';
+    }
+    else {
+        status = 'ok';
+    }
+    return { budget, currentSpendUSD, percentUsed, triggeredAlerts, status };
+}
+function shouldRuleTrigger(rule, currentSpendUSD, percentUsed, _budget) {
+    if (rule.trigger === 'budget-percent') {
+        return percentUsed >= rule.threshold;
+    }
+    return currentSpendUSD >= rule.threshold;
+}
+// ---------------------------------------------------------------------------
+// History helpers
+// ---------------------------------------------------------------------------
+export function buildHistoryFromEntries(entries, days) {
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - days);
+    const byDate = new Map();
+    for (const entry of entries) {
+        const entryDate = new Date(entry.timestamp);
+        if (entryDate < cutoff) {
+            continue;
+        }
+        const dateKey = entry.timestamp.slice(0, 10);
+        const existing = byDate.get(dateKey);
+        if (existing !== undefined) {
+            existing.spendUSD += entry.costUsd;
+            existing.tokens += entry.totalTokens;
+        }
+        else {
+            byDate.set(dateKey, { date: dateKey, spendUSD: entry.costUsd, tokens: entry.totalTokens });
+        }
+    }
+    return Array.from(byDate.values()).sort((a, b) => a.date.localeCompare(b.date));
+}
+//# sourceMappingURL=cost-budget-manager.js.map

package/dist/engine/cost-budget-manager.js.map

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

package/dist/engine/dependency-impact-analyzer.d.ts

@@ -0,0 +1,14 @@
+import type { ApiSurface, BreakingChangesResult } from '../types/index.js';
+/**
+ * Given a modified specId and a change description, find all other specs
+ * that have registered surfaces potentially impacted by the change.
+ */
+export declare function analyzeBreakingChanges(sourceSpecId: string, changeDescription: string, allSurfaces: ApiSurface[]): BreakingChangesResult;
+/** Generate HTML report for dependency impact analysis. */
+export declare function generateImpactReport(result: BreakingChangesResult): string;
+/** Check which specs depend on a given spec's surfaces. */
+export declare function checkApiCompatibility(specId: string, allSurfaces: ApiSurface[]): {
+    dependents: string[];
+    surfaceCount: number;
+};
+//# sourceMappingURL=dependency-impact-analyzer.d.ts.map

package/dist/engine/dependency-impact-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-impact-analyzer.d.ts","sourceRoot":"","sources":["../../src/engine/dependency-impact-analyzer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAEV,qBAAqB,EAEtB,MAAM,mBAAmB,CAAC;AAqC3B;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,UAAU,EAAE,GACxB,qBAAqB,CAwCvB;AAMD,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAuC1E;AAMD,2DAA2D;AAC3D,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,UAAU,EAAE,GACxB;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAuBhD"}