orquesta-cli 0.1.13 → 0.1.14

package/src/core/usage-tracker.ts

@@ -1,438 +0,0 @@
-/**
- * Usage Tracker
- *
- * Phase 3: Usage tracking functionality
- * - Track token usage (aggregated by session/task)
- * - Per-session/daily/monthly statistics
- * - Local file storage
- * - Real-time session token tracking
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { logger } from '../utils/logger.js';
-import { contextTracker } from './compact/context-tracker.js';
-
-/**
- * Single usage record
- */
-export interface UsageRecord {
-  timestamp: string;
-  model: string;
-  inputTokens: number;
-  outputTokens: number;
-  totalTokens: number;
-  sessionId?: string;
-}
-
-/**
- * Daily usage aggregation
- */
-export interface DailyUsage {
-  date: string;
-  totalInputTokens: number;
-  totalOutputTokens: number;
-  totalTokens: number;
-  requestCount: number;
-  models: Record<string, number>;
-}
-
-/**
- * Total usage data
- */
-export interface UsageData {
-  records: UsageRecord[];
-  dailyStats: Record<string, DailyUsage>;
-  totalInputTokens: number;
-  totalOutputTokens: number;
-  totalTokens: number;
-  totalRequests: number;
-  lastUpdated: string;
-}
-
-/**
- * Usage summary
- */
-export interface UsageSummary {
-  today: DailyUsage | null;
-  thisMonth: {
-    totalTokens: number;
-    totalRequests: number;
-    days: number;
-  };
-  allTime: {
-    totalInputTokens: number;
-    totalOutputTokens: number;
-    totalTokens: number;
-    totalRequests: number;
-    firstUsed: string | null;
-  };
-}
-
-/**
- * Current session/task usage (for real-time aggregation)
- */
-export interface SessionUsage {
-  inputTokens: number;
-  outputTokens: number;
-  totalTokens: number;
-  requestCount: number;
-  startTime: number;
-  models: Record<string, number>;
-  /** Last prompt_tokens for context usage tracking */
-  lastPromptTokens: number;
-}
-
-const DATA_DIR = path.join(process.env['HOME'] || '.', '.local-cli');
-const USAGE_FILE = path.join(DATA_DIR, 'usage.json');
-
-/**
- * Usage Tracker Class
- */
-class UsageTrackerClass {
-  private data: UsageData;
-  private saveTimeout: ReturnType<typeof setTimeout> | null = null;
-
-  // Current session usage (aggregate multiple LLM calls)
-  private currentSession: SessionUsage = {
-    inputTokens: 0,
-    outputTokens: 0,
-    totalTokens: 0,
-    requestCount: 0,
-    startTime: Date.now(),
-    models: {},
-    lastPromptTokens: 0,
-  };
-
-  constructor() {
-    logger.enter('UsageTracker.constructor');
-    this.data = this.loadData();
-    logger.exit('UsageTracker.constructor');
-  }
-
-  /**
-   * Load usage data from file
-   */
-  private loadData(): UsageData {
-    logger.enter('UsageTracker.loadData');
-
-    try {
-      if (fs.existsSync(USAGE_FILE)) {
-        const content = fs.readFileSync(USAGE_FILE, 'utf-8');
-        const data = JSON.parse(content) as UsageData;
-        logger.vars({ name: 'recordCount', value: data.records.length });
-        logger.exit('UsageTracker.loadData', { loaded: true });
-        return data;
-      }
-    } catch (error) {
-      logger.warn('Failed to load usage data, starting fresh', error);
-    }
-
-    const emptyData: UsageData = {
-      records: [],
-      dailyStats: {},
-      totalInputTokens: 0,
-      totalOutputTokens: 0,
-      totalTokens: 0,
-      totalRequests: 0,
-      lastUpdated: new Date().toISOString(),
-    };
-
-    logger.exit('UsageTracker.loadData', { loaded: false });
-    return emptyData;
-  }
-
-  /**
-   * Save usage data to file (debounced)
-   */
-  private saveData(): void {
-    if (this.saveTimeout) {
-      clearTimeout(this.saveTimeout);
-    }
-
-    this.saveTimeout = setTimeout(() => {
-      logger.flow('Saving usage data');
-      try {
-        if (!fs.existsSync(DATA_DIR)) {
-          fs.mkdirSync(DATA_DIR, { recursive: true });
-        }
-        this.data.lastUpdated = new Date().toISOString();
-        fs.writeFileSync(USAGE_FILE, JSON.stringify(this.data, null, 2));
-      } catch (error) {
-        logger.error('Failed to save usage data', error as Error);
-      }
-    }, 1000);
-  }
-
-  /**
-   * Record token usage (per individual LLM call)
-   * - Update current session usage
-   * - Update overall statistics
-   * @param promptTokens - Optional: last prompt_tokens for context tracking
-   */
-  recordUsage(
-    model: string,
-    inputTokens: number,
-    outputTokens: number,
-    sessionId?: string,
-    promptTokens?: number
-  ): void {
-    logger.enter('UsageTracker.recordUsage', { model, inputTokens, outputTokens });
-
-    const timestamp = new Date().toISOString();
-    const date = timestamp.split('T')[0] || timestamp;
-    const totalTokens = inputTokens + outputTokens;
-
-    // Update current session usage (real-time aggregation)
-    this.currentSession.inputTokens += inputTokens;
-    this.currentSession.outputTokens += outputTokens;
-    this.currentSession.totalTokens += totalTokens;
-    this.currentSession.requestCount += 1;
-    this.currentSession.models[model] = (this.currentSession.models[model] || 0) + totalTokens;
-
-    // Update lastPromptTokens for context tracking
-    if (promptTokens !== undefined) {
-      this.currentSession.lastPromptTokens = promptTokens;
-      // Also update contextTracker for auto-compact detection
-      contextTracker.updateUsage(promptTokens);
-    }
-
-    // Add record
-    const record: UsageRecord = {
-      timestamp,
-      model,
-      inputTokens,
-      outputTokens,
-      totalTokens,
-      sessionId,
-    };
-    this.data.records.push(record);
-
-    // Update totals
-    this.data.totalInputTokens += inputTokens;
-    this.data.totalOutputTokens += outputTokens;
-    this.data.totalTokens += totalTokens;
-    this.data.totalRequests += 1;
-
-    // Update daily stats
-    if (!this.data.dailyStats[date]) {
-      this.data.dailyStats[date] = {
-        date,
-        totalInputTokens: 0,
-        totalOutputTokens: 0,
-        totalTokens: 0,
-        requestCount: 0,
-        models: {},
-      };
-    }
-
-    const daily = this.data.dailyStats[date]!;
-    daily.totalInputTokens += inputTokens;
-    daily.totalOutputTokens += outputTokens;
-    daily.totalTokens += totalTokens;
-    daily.requestCount += 1;
-    daily.models[model] = (daily.models[model] || 0) + totalTokens;
-
-    // Keep only last 30 days of detailed records
-    const thirtyDaysAgo = new Date();
-    thirtyDaysAgo.setDate(thirtyDaysAgo.getDate() - 30);
-    this.data.records = this.data.records.filter(
-      r => new Date(r.timestamp) > thirtyDaysAgo
-    );
-
-    this.saveData();
-    logger.exit('UsageTracker.recordUsage');
-  }
-
-  /**
-   * Get usage summary
-   */
-  getSummary(): UsageSummary {
-    logger.enter('UsageTracker.getSummary');
-
-    const today = new Date().toISOString().split('T')[0] || '';
-    const todayStats = this.data.dailyStats[today] || null;
-
-    // This month stats
-    const currentMonth = today.substring(0, 7); // YYYY-MM
-    let monthTokens = 0;
-    let monthRequests = 0;
-    let monthDays = 0;
-
-    for (const [date, stats] of Object.entries(this.data.dailyStats)) {
-      if (date.startsWith(currentMonth)) {
-        monthTokens += stats.totalTokens;
-        monthRequests += stats.requestCount;
-        monthDays += 1;
-      }
-    }
-
-    // First usage date
-    const firstRecord = this.data.records[0];
-    const firstUsed = firstRecord ? firstRecord.timestamp.split('T')[0] || null : null;
-
-    const summary: UsageSummary = {
-      today: todayStats,
-      thisMonth: {
-        totalTokens: monthTokens,
-        totalRequests: monthRequests,
-        days: monthDays,
-      },
-      allTime: {
-        totalInputTokens: this.data.totalInputTokens,
-        totalOutputTokens: this.data.totalOutputTokens,
-        totalTokens: this.data.totalTokens,
-        totalRequests: this.data.totalRequests,
-        firstUsed,
-      },
-    };
-
-    logger.exit('UsageTracker.getSummary');
-    return summary;
-  }
-
-  /**
-   * Get today's usage
-   */
-  getTodayUsage(): DailyUsage | null {
-    const today = new Date().toISOString().split('T')[0] || '';
-    return this.data.dailyStats[today] || null;
-  }
-
-  /**
-   * Get total tokens used
-   */
-  getTotalTokens(): number {
-    return this.data.totalTokens;
-  }
-
-  /**
-   * Get current session usage (real-time aggregated value)
-   */
-  getSessionUsage(): SessionUsage {
-    return { ...this.currentSession };
-  }
-
-  /**
-   * Get session elapsed time in seconds
-   */
-  getSessionElapsedSeconds(): number {
-    return Math.floor((Date.now() - this.currentSession.startTime) / 1000);
-  }
-
-  /**
-   * Reset session usage (call when starting new task)
-   */
-  resetSession(): void {
-    logger.flow('Resetting session usage');
-    this.currentSession = {
-      inputTokens: 0,
-      outputTokens: 0,
-      totalTokens: 0,
-      requestCount: 0,
-      startTime: Date.now(),
-      models: {},
-      lastPromptTokens: 0,
-    };
-  }
-
-  /**
-   * Format session usage for status bar display
-   * Claude Code style: "✶ ~ doing… (esc to interrupt · 2m 7s · ↑ 3.6k tokens)"
-   */
-  formatSessionStatus(currentActivity?: string): string {
-    const elapsed = this.getSessionElapsedSeconds();
-    const tokens = this.currentSession.totalTokens;
-
-    // Format time
-    let timeStr: string;
-    if (elapsed < 60) {
-      timeStr = `${elapsed}s`;
-    } else {
-      const mins = Math.floor(elapsed / 60);
-      const secs = elapsed % 60;
-      timeStr = `${mins}m ${secs}s`;
-    }
-
-    // Format tokens
-    let tokenStr: string;
-    if (tokens < 1000) {
-      tokenStr = tokens.toString();
-    } else if (tokens < 1000000) {
-      tokenStr = `${(tokens / 1000).toFixed(1)}k`;
-    } else {
-      tokenStr = `${(tokens / 1000000).toFixed(2)}M`;
-    }
-
-    // Build status string
-    const activity = currentActivity || 'Processing';
-    return `✶ ${activity}… (esc to interrupt · ${timeStr} · ↑ ${tokenStr} tokens)`;
-  }
-
-  /**
-   * Format usage for display
-   */
-  formatUsageDisplay(): string {
-    logger.enter('UsageTracker.formatUsageDisplay');
-
-    const summary = this.getSummary();
-    const lines: string[] = [];
-
-    lines.push('📊 Usage Statistics');
-    lines.push('');
-
-    // Today
-    lines.push('📅 Today');
-    if (summary.today) {
-      lines.push(`   Requests: ${summary.today.requestCount}`);
-      lines.push(`   Input tokens: ${summary.today.totalInputTokens.toLocaleString()}`);
-      lines.push(`   Output tokens: ${summary.today.totalOutputTokens.toLocaleString()}`);
-      lines.push(`   Total tokens: ${summary.today.totalTokens.toLocaleString()}`);
-    } else {
-      lines.push('   No usage records');
-    }
-    lines.push('');
-
-    // This month
-    lines.push('📆 This Month');
-    lines.push(`   Requests: ${summary.thisMonth.totalRequests.toLocaleString()}`);
-    lines.push(`   Total tokens: ${summary.thisMonth.totalTokens.toLocaleString()}`);
-    lines.push(`   Active days: ${summary.thisMonth.days}`);
-    lines.push('');
-
-    // All time
-    lines.push('📈 All Time');
-    lines.push(`   Total requests: ${summary.allTime.totalRequests.toLocaleString()}`);
-    lines.push(`   Input tokens: ${summary.allTime.totalInputTokens.toLocaleString()}`);
-    lines.push(`   Output tokens: ${summary.allTime.totalOutputTokens.toLocaleString()}`);
-    lines.push(`   Total tokens: ${summary.allTime.totalTokens.toLocaleString()}`);
-    if (summary.allTime.firstUsed) {
-      lines.push(`   First used: ${summary.allTime.firstUsed}`);
-    }
-
-    logger.exit('UsageTracker.formatUsageDisplay');
-    return lines.join('\n');
-  }
-
-  /**
-   * Clear all usage data
-   */
-  clearData(): void {
-    logger.flow('Clearing all usage data');
-    this.data = {
-      records: [],
-      dailyStats: {},
-      totalInputTokens: 0,
-      totalOutputTokens: 0,
-      totalTokens: 0,
-      totalRequests: 0,
-      lastUpdated: new Date().toISOString(),
-    };
-    this.saveData();
-  }
-}
-
-// Singleton instance
-export const usageTracker = new UsageTrackerClass();
-
-export default usageTracker;

package/src/errors/base.ts

@@ -1,81 +0,0 @@
-/**
- * Base Error Class
- *
- * Base class for all custom errors
- */
-
-export interface ErrorDetails {
-  [key: string]: unknown;
-}
-
-export interface ErrorOptions {
-  cause?: Error;
-  details?: ErrorDetails;
-  isRecoverable?: boolean;
-  userMessage?: string;
-}
-
-/**
- * BaseError - Base class for all custom errors
- */
-export class BaseError extends Error {
-  public readonly code: string;
-  public override readonly cause?: Error;
-  public readonly details?: ErrorDetails;
-  public readonly isRecoverable: boolean;
-  public readonly userMessage: string;
-  public readonly timestamp: Date;
-
-  constructor(
-    message: string,
-    code: string,
-    options: ErrorOptions = {}
-  ) {
-    super(message);
-    this.name = this.constructor.name;
-    Object.setPrototypeOf(this, new.target.prototype);
-    this.code = code;
-    this.cause = options.cause;
-    this.details = options.details;
-    this.isRecoverable = options.isRecoverable ?? false;
-    this.userMessage = options.userMessage ?? message;
-    this.timestamp = new Date();
-
-    // Capture stack trace
-    Error.captureStackTrace(this, this.constructor);
-  }
-
-  /**
-   * Convert error information to JSON
-   */
-  toJSON(): Record<string, unknown> {
-    return {
-      name: this.name,
-      code: this.code,
-      message: this.message,
-      userMessage: this.userMessage,
-      isRecoverable: this.isRecoverable,
-      details: this.details,
-      timestamp: this.timestamp,
-      stack: this.stack,
-      cause: this.cause ? {
-        name: this.cause.name,
-        message: this.cause.message,
-      } : undefined,
-    };
-  }
-
-  /**
-   * Get message to display to user
-   */
-  getUserMessage(): string {
-    return this.userMessage;
-  }
-
-  /**
-   * Check if error is recoverable
-   */
-  canRecover(): boolean {
-    return this.isRecoverable;
-  }
-}

package/src/errors/file.ts

@@ -1,183 +0,0 @@
-/**
- * File System Error Classes
- *
- * File system-related errors
- */
-
-import { BaseError, ErrorOptions } from './base.js';
-
-/**
- * FileSystemError - General file system error
- */
-export class FileSystemError extends BaseError {
-  public readonly path?: string;
-
-  constructor(message: string, path?: string, options: ErrorOptions = {}) {
-    super(
-      message,
-      'FILE_SYSTEM_ERROR',
-      {
-        ...options,
-        details: {
-          ...options.details,
-          path,
-        },
-        isRecoverable: options.isRecoverable ?? false,
-        userMessage: options.userMessage ?? `File system error occurred${path ? ` (path: ${path})` : ''}.`,
-      }
-    );
-    this.path = path;
-  }
-}
-
-/**
- * FileNotFoundError - File not found error
- */
-export class FileNotFoundError extends BaseError {
-  public readonly path: string;
-
-  constructor(path: string, options: ErrorOptions = {}) {
-    super(
-      `File not found: ${path}`,
-      'FILE_NOT_FOUND',
-      {
-        ...options,
-        details: {
-          ...options.details,
-          path,
-        },
-        isRecoverable: false,
-        userMessage: options.userMessage ?? `File not found: ${path}`,
-      }
-    );
-    this.path = path;
-  }
-}
-
-/**
- * DirectoryNotFoundError - Directory not found error
- */
-export class DirectoryNotFoundError extends BaseError {
-  public readonly path: string;
-
-  constructor(path: string, options: ErrorOptions = {}) {
-    super(
-      `Directory not found: ${path}`,
-      'DIRECTORY_NOT_FOUND',
-      {
-        ...options,
-        details: {
-          ...options.details,
-          path,
-        },
-        isRecoverable: false,
-        userMessage: options.userMessage ?? `Directory not found: ${path}`,
-      }
-    );
-    this.path = path;
-  }
-}
-
-/**
- * PermissionError - Permission error
- */
-export class PermissionError extends BaseError {
-  public readonly path?: string;
-  public readonly operation?: string;
-
-  constructor(
-    message: string,
-    path?: string,
-    operation?: string,
-    options: ErrorOptions = {}
-  ) {
-    super(
-      message,
-      'PERMISSION_ERROR',
-      {
-        ...options,
-        details: {
-          ...options.details,
-          path,
-          operation,
-        },
-        isRecoverable: false,
-        userMessage: options.userMessage ?? `Permission denied${path ? `: ${path}` : ''}${operation ? ` (operation: ${operation})` : ''}.`,
-      }
-    );
-    this.path = path;
-    this.operation = operation;
-  }
-}
-
-/**
- * FileReadError - File read error
- */
-export class FileReadError extends BaseError {
-  public readonly path: string;
-
-  constructor(path: string, options: ErrorOptions = {}) {
-    super(
-      `Failed to read file: ${path}`,
-      'FILE_READ_ERROR',
-      {
-        ...options,
-        details: {
-          ...options.details,
-          path,
-        },
-        isRecoverable: false,
-        userMessage: options.userMessage ?? `Failed to read file: ${path}`,
-      }
-    );
-    this.path = path;
-  }
-}
-
-/**
- * FileWriteError - File write error
- */
-export class FileWriteError extends BaseError {
-  public readonly path: string;
-
-  constructor(path: string, options: ErrorOptions = {}) {
-    super(
-      `Failed to write file: ${path}`,
-      'FILE_WRITE_ERROR',
-      {
-        ...options,
-        details: {
-          ...options.details,
-          path,
-        },
-        isRecoverable: true,
-        userMessage: options.userMessage ?? `Failed to write file: ${path}. Please check disk space.`,
-      }
-    );
-    this.path = path;
-  }
-}
-
-/**
- * InvalidPathError - Invalid path error
- */
-export class InvalidPathError extends BaseError {
-  public readonly path: string;
-
-  constructor(path: string, options: ErrorOptions = {}) {
-    super(
-      `Invalid path: ${path}`,
-      'INVALID_PATH_ERROR',
-      {
-        ...options,
-        details: {
-          ...options.details,
-          path,
-        },
-        isRecoverable: true,
-        userMessage: options.userMessage ?? `Invalid path: ${path}`,
-      }
-    );
-    this.path = path;
-  }
-}