specweave 0.14.0 → 0.15.0

package/dist/src/utils/claude-cli-detector.js

@@ -0,0 +1,285 @@
+/**
+ * Claude CLI Detection Utility
+ *
+ * Provides robust detection of Claude Code CLI with comprehensive validation.
+ * Goes beyond checking if 'claude' exists - verifies it can actually run plugin commands.
+ */
+import { execFileNoThrowSync } from './execFileNoThrow.js';
+/**
+ * Robustly detect if Claude CLI is available and working
+ *
+ * Unlike simple `which claude` checks, this function:
+ * 1. Checks if 'claude' command exists in PATH
+ * 2. Verifies it can run --version (basic sanity check)
+ * 3. Verifies plugin commands are supported (claude plugin --help)
+ *
+ * @returns Detailed status about Claude CLI availability
+ *
+ * @example
+ * ```typescript
+ * const status = detectClaudeCli();
+ * if (status.available) {
+ *   console.log('Claude CLI is ready!');
+ * } else if (status.commandExists && !status.pluginCommandsWork) {
+ *   console.log('Claude CLI found but plugin commands not working');
+ * } else {
+ *   console.log('Claude CLI not installed');
+ * }
+ * ```
+ */
+export function detectClaudeCli() {
+    const status = {
+        available: false,
+        commandExists: false,
+        pluginCommandsWork: false,
+        platform: process.platform,
+    };
+    const isDebug = process.env.DEBUG === 'true' || process.env.SPECWEAVE_DEBUG === 'true';
+    // Step 1: Check if 'claude' command exists using which/where
+    const whichCommand = process.platform === 'win32' ? 'where' : 'which';
+    const whichResult = execFileNoThrowSync(whichCommand, ['claude']);
+    if (isDebug) {
+        console.error('\n[DEBUG] Claude CLI Detection:');
+        console.error(`  Platform: ${process.platform}`);
+        console.error(`  Which command: ${whichCommand}`);
+        console.error(`  Which result: ${whichResult.success ? 'found' : 'not found'}`);
+        if (whichResult.success) {
+            console.error(`  Path: ${whichResult.stdout.trim()}`);
+        }
+    }
+    if (!whichResult.success) {
+        status.error = 'command_not_found';
+        status.errorMessage = 'claude command not found in PATH';
+        status.debugStdout = whichResult.stdout;
+        status.debugStderr = whichResult.stderr;
+        status.exitCode = whichResult.exitCode;
+        return status;
+    }
+    status.commandExists = true;
+    status.commandPath = whichResult.stdout.trim().split('\n')[0]; // First line if multiple paths
+    // Step 2: Verify we can run the command (--version check)
+    const versionResult = execFileNoThrowSync('claude', ['--version'], {
+        timeout: 10000, // Increased to 10 seconds for slow systems
+    });
+    if (isDebug) {
+        console.error(`\n  Version check (claude --version):`);
+        console.error(`    Success: ${versionResult.success}`);
+        console.error(`    Exit code: ${versionResult.exitCode}`);
+        console.error(`    Stdout: "${versionResult.stdout}"`);
+        console.error(`    Stderr: "${versionResult.stderr}"`);
+        if (versionResult.error) {
+            console.error(`    Error code: ${versionResult.error.code}`);
+            console.error(`    Error message: ${versionResult.error.message}`);
+        }
+    }
+    if (!versionResult.success) {
+        // Capture full diagnostic info
+        status.debugStdout = versionResult.stdout;
+        status.debugStderr = versionResult.stderr;
+        status.exitCode = versionResult.exitCode;
+        // Classify the error
+        const errorStr = `${versionResult.stderr} ${versionResult.stdout}`.toLowerCase();
+        if (errorStr.includes('eacces') || errorStr.includes('permission')) {
+            status.error = 'permission_denied';
+            status.errorMessage = 'Permission denied when running claude command';
+        }
+        else if (errorStr.includes('enoent') || errorStr.includes('not found')) {
+            status.error = 'command_not_found';
+            status.errorMessage = 'claude command exists in PATH but cannot be executed';
+        }
+        else if (versionResult.exitCode === 127) {
+            status.error = 'command_not_found';
+            status.errorMessage = 'Command not found (exit code 127)';
+        }
+        else if (!versionResult.stdout && !versionResult.stderr) {
+            status.error = 'version_check_failed';
+            status.errorMessage = `claude --version produced no output (exit code: ${versionResult.exitCode})`;
+        }
+        else {
+            status.error = 'version_check_failed';
+            status.errorMessage = `claude --version failed with exit code ${versionResult.exitCode}`;
+        }
+        return status;
+    }
+    status.version = versionResult.stdout.trim();
+    // Step 3: Verify plugin commands are supported
+    const pluginHelpResult = execFileNoThrowSync('claude', ['plugin', '--help'], {
+        timeout: 10000,
+    });
+    if (isDebug) {
+        console.error(`\n  Plugin check (claude plugin --help):`);
+        console.error(`    Success: ${pluginHelpResult.success}`);
+        console.error(`    Exit code: ${pluginHelpResult.exitCode}`);
+        console.error(`    Stdout: "${pluginHelpResult.stdout.substring(0, 100)}..."`);
+    }
+    if (!pluginHelpResult.success) {
+        status.error = 'plugin_commands_not_supported';
+        status.errorMessage = 'claude plugin commands not supported or not working';
+        status.debugStdout = pluginHelpResult.stdout;
+        status.debugStderr = pluginHelpResult.stderr;
+        status.exitCode = pluginHelpResult.exitCode;
+        return status;
+    }
+    status.pluginCommandsWork = true;
+    // All checks passed!
+    status.available = true;
+    if (isDebug) {
+        console.error(`\n  ✅ All checks passed! Claude CLI is ready.\n`);
+    }
+    return status;
+}
+/**
+ * Simple boolean check for quick availability testing
+ * Use this when you just need a yes/no answer.
+ *
+ * @returns true if Claude CLI is fully functional, false otherwise
+ */
+export function isClaudeCliAvailable() {
+    return detectClaudeCli().available;
+}
+/**
+ * Get human-readable diagnostic message based on CLI status
+ *
+ * @param status - Status from detectClaudeCli()
+ * @returns Diagnostic message explaining the issue
+ */
+export function getClaudeCliDiagnostic(status) {
+    if (status.available) {
+        return `Claude CLI is working (version: ${status.version})`;
+    }
+    // Build detailed diagnostic with all available info
+    const parts = [];
+    switch (status.error) {
+        case 'command_not_found':
+            parts.push('Claude CLI not found in PATH');
+            break;
+        case 'permission_denied':
+            parts.push('Permission denied when running Claude CLI');
+            if (status.commandPath) {
+                parts.push(`(at ${status.commandPath})`);
+            }
+            break;
+        case 'version_check_failed':
+            parts.push('Claude CLI found but version check failed');
+            if (status.exitCode !== undefined) {
+                parts.push(`(exit code: ${status.exitCode})`);
+            }
+            if (!status.debugStdout && !status.debugStderr) {
+                parts.push('- produced no output');
+            }
+            break;
+        case 'plugin_commands_not_supported':
+            parts.push('Claude CLI found but plugin commands not working');
+            if (status.version) {
+                parts.push(`(version: ${status.version})`);
+            }
+            break;
+        case 'unknown':
+        default:
+            parts.push('Claude CLI issue');
+            if (status.errorMessage) {
+                parts.push(`- ${status.errorMessage}`);
+            }
+    }
+    // Add debugging hints if we have diagnostic data
+    if (process.env.DEBUG === 'true' || process.env.SPECWEAVE_DEBUG === 'true') {
+        if (status.commandPath) {
+            parts.push(`\n  Path: ${status.commandPath}`);
+        }
+        if (status.exitCode !== undefined) {
+            parts.push(`\n  Exit code: ${status.exitCode}`);
+        }
+        if (status.debugStdout) {
+            parts.push(`\n  Stdout: "${status.debugStdout.substring(0, 200)}"`);
+        }
+        if (status.debugStderr) {
+            parts.push(`\n  Stderr: "${status.debugStderr.substring(0, 200)}"`);
+        }
+    }
+    return parts.join(' ');
+}
+/**
+ * Get actionable suggestions for fixing Claude CLI issues
+ *
+ * @param status - Status from detectClaudeCli()
+ * @returns Array of suggested actions
+ */
+export function getClaudeCliSuggestions(status) {
+    if (status.available) {
+        return [];
+    }
+    const suggestions = [];
+    switch (status.error) {
+        case 'command_not_found':
+            suggestions.push('Install Claude Code CLI via npm:');
+            suggestions.push('  → npm install -g @anthropic-ai/claude-code');
+            suggestions.push('');
+            suggestions.push('Or download from:');
+            suggestions.push('  → https://claude.com/code');
+            break;
+        case 'permission_denied':
+            suggestions.push('Fix permissions:');
+            if (process.platform === 'win32') {
+                suggestions.push('  → Run terminal as Administrator');
+                suggestions.push('  → Or reinstall: npm install -g @anthropic-ai/claude-code');
+            }
+            else {
+                if (status.commandPath) {
+                    suggestions.push(`  → Check permissions: ls -la "${status.commandPath}"`);
+                }
+                suggestions.push('  → Or reinstall: npm install -g @anthropic-ai/claude-code');
+            }
+            break;
+        case 'version_check_failed':
+            suggestions.push('The command exists but is not responding correctly.');
+            suggestions.push('');
+            suggestions.push('Try these troubleshooting steps:');
+            if (status.commandPath) {
+                suggestions.push(`  1. Check what 'claude' actually is: file "${status.commandPath}"`);
+            }
+            suggestions.push('  2. Try running manually: claude --version');
+            suggestions.push('  3. Check if it\'s a different tool named "claude"');
+            suggestions.push('');
+            suggestions.push('If it\'s NOT the Claude Code CLI:');
+            suggestions.push('  → Rename or remove the conflicting command');
+            suggestions.push('  → Install Claude Code CLI: npm install -g @anthropic-ai/claude-code');
+            suggestions.push('');
+            suggestions.push('Enable debug mode for more details:');
+            suggestions.push('  → DEBUG=true specweave init .');
+            break;
+        case 'plugin_commands_not_supported':
+            suggestions.push('Claude CLI found but plugin commands don\'t work.');
+            suggestions.push('');
+            suggestions.push('This could mean:');
+            suggestions.push('  • Outdated version (plugin support added recently)');
+            suggestions.push('  • Different CLI tool named "claude"');
+            suggestions.push('  • Corrupted installation');
+            suggestions.push('');
+            suggestions.push('Try updating:');
+            suggestions.push('  → npm update -g @anthropic-ai/claude-code');
+            suggestions.push('');
+            suggestions.push('If that fails, reinstall:');
+            suggestions.push('  → npm uninstall -g @anthropic-ai/claude-code');
+            suggestions.push('  → npm install -g @anthropic-ai/claude-code');
+            break;
+        case 'unknown':
+        default:
+            suggestions.push('Unexpected error with Claude CLI.');
+            suggestions.push('');
+            suggestions.push('Try these troubleshooting steps:');
+            suggestions.push('  1. Run with debug mode: DEBUG=true specweave init .');
+            suggestions.push('  2. Check version manually: claude --version');
+            suggestions.push('  3. Verify plugin support: claude plugin --help');
+            suggestions.push('  4. Reinstall if needed: npm install -g @anthropic-ai/claude-code');
+            suggestions.push('');
+            if (status.commandPath) {
+                suggestions.push(`  Path: ${status.commandPath}`);
+            }
+            if (status.exitCode !== undefined) {
+                suggestions.push(`  Exit code: ${status.exitCode}`);
+            }
+            break;
+    }
+    return suggestions;
+}
+//# sourceMappingURL=claude-cli-detector.js.map

package/dist/src/utils/claude-cli-detector.js.map

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

package/dist/src/utils/cost-reporter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Cost Report Generation
+ *
+ * Generates human-readable cost reports with multiple export formats:
+ * - JSON (machine-readable)
+ * - CSV (spreadsheet import)
+ * - ASCII Dashboard (CLI display)
+ */
+import type { CostTracker } from '../core/cost-tracker';
+import type { IncrementCostReport } from '../types/cost-tracking';
+export declare class CostReporter {
+    private costTracker;
+    constructor(costTracker: CostTracker);
+    /**
+     * Generate cost report for a specific increment
+     *
+     * @param incrementId - Increment ID (e.g., '0003')
+     * @returns Aggregate cost report
+     */
+    generateIncrementReport(incrementId: string): IncrementCostReport;
+    /**
+     * Export report to JSON file
+     *
+     * @param incrementId - Increment ID
+     * @param outputPath - Output file path
+     */
+    exportToJSON(incrementId: string, outputPath: string): Promise<void>;
+    /**
+     * Export report to CSV file
+     *
+     * @param incrementId - Increment ID
+     * @param outputPath - Output file path
+     */
+    exportToCSV(incrementId: string, outputPath: string): Promise<void>;
+    /**
+     * Generate ASCII dashboard for CLI display
+     *
+     * @param incrementId - Optional increment ID (defaults to all increments)
+     * @returns ASCII table with cost breakdown
+     */
+    generateDashboard(incrementId?: string): string;
+    /**
+     * Generate dashboard for a specific increment
+     */
+    private generateIncrementDashboard;
+    /**
+     * Generate dashboard for all increments
+     */
+    private generateOverallDashboard;
+    /**
+     * Generate compact one-line summary
+     *
+     * @param incrementId - Optional increment ID
+     * @returns One-line summary string
+     */
+    generateSummaryLine(incrementId?: string): string;
+}
+//# sourceMappingURL=cost-reporter.d.ts.map

package/dist/src/utils/cost-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-reporter.d.ts","sourceRoot":"","sources":["../../../src/utils/cost-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,qBAAa,YAAY;IACX,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAE5C;;;;;OAKG;IACH,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB;IAIjE;;;;;OAKG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1E;;;;;OAKG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCzE;;;;;OAKG;IACH,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM;IAQ/C;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA8FlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAmEhC;;;;;OAKG;IACH,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM;CASlD"}

package/dist/src/utils/cost-reporter.js

@@ -0,0 +1,224 @@
+/**
+ * Cost Report Generation
+ *
+ * Generates human-readable cost reports with multiple export formats:
+ * - JSON (machine-readable)
+ * - CSV (spreadsheet import)
+ * - ASCII Dashboard (CLI display)
+ */
+import fs from 'fs-extra';
+export class CostReporter {
+    constructor(costTracker) {
+        this.costTracker = costTracker;
+    }
+    /**
+     * Generate cost report for a specific increment
+     *
+     * @param incrementId - Increment ID (e.g., '0003')
+     * @returns Aggregate cost report
+     */
+    generateIncrementReport(incrementId) {
+        return this.costTracker.getIncrementCost(incrementId);
+    }
+    /**
+     * Export report to JSON file
+     *
+     * @param incrementId - Increment ID
+     * @param outputPath - Output file path
+     */
+    async exportToJSON(incrementId, outputPath) {
+        const report = this.generateIncrementReport(incrementId);
+        await fs.writeJson(outputPath, report, { spaces: 2 });
+    }
+    /**
+     * Export report to CSV file
+     *
+     * @param incrementId - Increment ID
+     * @param outputPath - Output file path
+     */
+    async exportToCSV(incrementId, outputPath) {
+        const sessions = this.costTracker.getIncrementSessions(incrementId);
+        // CSV headers
+        const headers = [
+            'Session ID',
+            'Agent',
+            'Model',
+            'Command',
+            'Started At',
+            'Ended At',
+            'Input Tokens',
+            'Output Tokens',
+            'Total Tokens',
+            'Cost ($)',
+            'Savings ($)',
+        ];
+        // CSV rows
+        const rows = sessions.map((s) => [
+            s.sessionId,
+            s.agent,
+            s.model,
+            s.command || 'N/A',
+            s.startedAt,
+            s.endedAt || 'In Progress',
+            s.tokenUsage.inputTokens.toString(),
+            s.tokenUsage.outputTokens.toString(),
+            s.tokenUsage.totalTokens.toString(),
+            s.cost.toFixed(4),
+            s.savings.toFixed(4),
+        ]);
+        // Generate CSV (simple implementation, no external deps)
+        const csv = [headers.join(','), ...rows.map((row) => row.join(','))].join('\n');
+        await fs.writeFile(outputPath, csv, 'utf-8');
+    }
+    /**
+     * Generate ASCII dashboard for CLI display
+     *
+     * @param incrementId - Optional increment ID (defaults to all increments)
+     * @returns ASCII table with cost breakdown
+     */
+    generateDashboard(incrementId) {
+        if (incrementId) {
+            return this.generateIncrementDashboard(incrementId);
+        }
+        else {
+            return this.generateOverallDashboard();
+        }
+    }
+    /**
+     * Generate dashboard for a specific increment
+     */
+    generateIncrementDashboard(incrementId) {
+        const report = this.generateIncrementReport(incrementId);
+        const sessions = this.costTracker.getIncrementSessions(incrementId);
+        if (sessions.length === 0) {
+            return `No cost data for increment ${incrementId}`;
+        }
+        const lines = [];
+        // Header
+        lines.push('');
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push(`  Cost Report: Increment ${incrementId}`);
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        // Summary
+        lines.push('SUMMARY');
+        lines.push('───────────────────────────────────────────────────────────────');
+        lines.push(`  Total Cost:       $${report.totalCost.toFixed(4).padStart(10)}`);
+        lines.push(`  Total Savings:    $${report.totalSavings.toFixed(4).padStart(10)}`);
+        const baselineCost = report.totalCost + report.totalSavings;
+        const savingsPercentage = baselineCost > 0 ? (report.totalSavings / baselineCost) * 100 : 0;
+        lines.push(`  Savings %:         ${savingsPercentage.toFixed(1).padStart(10)}%`);
+        lines.push(`  Total Tokens:      ${report.totalTokens.toLocaleString().padStart(10)}`);
+        lines.push(`  Sessions:          ${report.sessionCount.toString().padStart(10)}`);
+        lines.push('');
+        // Cost by Model
+        lines.push('COST BY MODEL');
+        lines.push('───────────────────────────────────────────────────────────────');
+        for (const [model, cost] of Object.entries(report.costByModel)) {
+            const percentage = (cost / report.totalCost) * 100;
+            lines.push(`  ${model.padEnd(15)} $${cost.toFixed(4).padStart(10)}  (${percentage.toFixed(1).padStart(5)}%)`);
+        }
+        lines.push('');
+        // Cost by Agent
+        lines.push('COST BY AGENT');
+        lines.push('───────────────────────────────────────────────────────────────');
+        const sortedAgents = Object.entries(report.costByAgent).sort(([, a], [, b]) => b - a);
+        for (const [agent, cost] of sortedAgents.slice(0, 10)) {
+            // Top 10
+            const percentage = (cost / report.totalCost) * 100;
+            lines.push(`  ${agent.padEnd(25)} $${cost.toFixed(4).padStart(8)}  (${percentage.toFixed(1).padStart(5)}%)`);
+        }
+        if (sortedAgents.length > 10) {
+            lines.push(`  ... and ${sortedAgents.length - 10} more agents`);
+        }
+        lines.push('');
+        // Recent Sessions (last 5)
+        lines.push('RECENT SESSIONS');
+        lines.push('───────────────────────────────────────────────────────────────');
+        const recentSessions = sessions
+            .sort((a, b) => {
+            const timeA = new Date(a.startedAt).getTime();
+            const timeB = new Date(b.startedAt).getTime();
+            return timeB - timeA;
+        })
+            .slice(0, 5);
+        for (const session of recentSessions) {
+            const time = new Date(session.startedAt).toLocaleString();
+            lines.push(`  ${time}`);
+            lines.push(`  Agent: ${session.agent.padEnd(20)} Model: ${session.model}`);
+            lines.push(`  Cost: $${session.cost.toFixed(4).padStart(8)}    Savings: $${session.savings.toFixed(4).padStart(8)}`);
+            lines.push('');
+        }
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Generate dashboard for all increments
+     */
+    generateOverallDashboard() {
+        const summary = this.costTracker.getSummary();
+        if (summary.totalSessions === 0) {
+            return 'No cost data available';
+        }
+        const lines = [];
+        // Header
+        lines.push('');
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('  SpecWeave Cost Summary - All Increments');
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        // Overall Summary
+        lines.push('OVERALL SUMMARY');
+        lines.push('───────────────────────────────────────────────────────────────');
+        lines.push(`  Total Cost:       $${summary.totalCost.toFixed(4).padStart(10)}`);
+        lines.push(`  Total Savings:    $${summary.totalSavings.toFixed(4).padStart(10)}`);
+        lines.push(`  Savings %:         ${summary.savingsPercentage.toFixed(1).padStart(10)}%`);
+        lines.push(`  Total Sessions:    ${summary.totalSessions.toString().padStart(10)}`);
+        lines.push('');
+        // Agent Stats
+        if (summary.mostExpensiveAgent) {
+            lines.push('AGENT STATS');
+            lines.push('───────────────────────────────────────────────────────────────');
+            lines.push(`  Most Expensive:    ${summary.mostExpensiveAgent}`);
+            if (summary.cheapestAgent !== summary.mostExpensiveAgent) {
+                lines.push(`  Least Expensive:   ${summary.cheapestAgent}`);
+            }
+            lines.push('');
+        }
+        // By Increment
+        const allSessions = this.costTracker.getAllSessions();
+        const incrementIds = [...new Set(allSessions.map((s) => s.increment).filter(Boolean))];
+        if (incrementIds.length > 0) {
+            lines.push('COST BY INCREMENT');
+            lines.push('───────────────────────────────────────────────────────────────');
+            for (const incrementId of incrementIds) {
+                const report = this.generateIncrementReport(incrementId);
+                lines.push(`  ${incrementId.padEnd(30)} $${report.totalCost.toFixed(4).padStart(8)}  (${report.sessionCount} sessions)`);
+            }
+            lines.push('');
+        }
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        lines.push('💡 Tip: Use "/specweave.costs 0003" to see detailed report for increment 0003');
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Generate compact one-line summary
+     *
+     * @param incrementId - Optional increment ID
+     * @returns One-line summary string
+     */
+    generateSummaryLine(incrementId) {
+        if (incrementId) {
+            const report = this.generateIncrementReport(incrementId);
+            return `Increment ${incrementId}: $${report.totalCost.toFixed(4)} cost, $${report.totalSavings.toFixed(4)} saved (${((report.totalSavings / (report.totalCost + report.totalSavings)) * 100).toFixed(1)}%)`;
+        }
+        else {
+            const summary = this.costTracker.getSummary();
+            return `Total: $${summary.totalCost.toFixed(4)} cost, $${summary.totalSavings.toFixed(4)} saved (${summary.savingsPercentage.toFixed(1)}%) across ${summary.totalSessions} sessions`;
+        }
+    }
+}
+//# sourceMappingURL=cost-reporter.js.map

package/dist/src/utils/cost-reporter.js.map

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

package/dist/src/utils/docs-preview/config-generator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Docusaurus configuration generator
+ * Generates docusaurus.config.js with sensible defaults
+ */
+import { DocusaurusConfig } from './types';
+/**
+ * Generate docusaurus.config.js content
+ */
+export declare function generateDocusaurusConfig(config: DocusaurusConfig): string;
+/**
+ * Write docusaurus.config.js to file
+ */
+export declare function writeDocusaurusConfig(targetDir: string, config: DocusaurusConfig): Promise<void>;
+/**
+ * Generate package.json for Docusaurus site
+ */
+export declare function generatePackageJSON(title: string): string;
+/**
+ * Write package.json to file
+ */
+export declare function writePackageJSON(targetDir: string, title: string): Promise<void>;
+/**
+ * Generate custom CSS for theme customization
+ */
+export declare function generateCustomCSS(theme: string): string;
+/**
+ * Write custom CSS to file
+ */
+export declare function writeCustomCSS(targetDir: string, theme: string): Promise<void>;
+/**
+ * Generate index page (landing page)
+ */
+export declare function generateIndexPage(title: string, tagline: string): string;
+/**
+ * Write index page to file
+ */
+export declare function writeIndexPage(targetDir: string, title: string, tagline: string): Promise<void>;
+/**
+ * Generate index.module.css for landing page styles
+ */
+export declare function generateIndexModuleCSS(): string;
+/**
+ * Write index.module.css to file
+ */
+export declare function writeIndexModuleCSS(targetDir: string): Promise<void>;
+//# sourceMappingURL=config-generator.d.ts.map

package/dist/src/utils/docs-preview/config-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-generator.d.ts","sourceRoot":"","sources":["../../../../src/utils/docs-preview/config-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA8GzE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAuCzD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA8EvD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA8DxE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAsB/C;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1E"}