@planu/cli 0.69.0 → 0.70.0

package/dist/types/token-ledger.d.ts

@@ -0,0 +1,195 @@
+export interface LedgerEntry {
+    id: string;
+    timestamp: string;
+    sessionId: string;
+    toolName: string;
+    specId?: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    costUsd: number;
+    estimatedTokens?: number;
+    estimatedCostUsd?: number;
+    cached: boolean;
+    optimizationSavings?: number;
+}
+export interface LedgerFilter {
+    period?: 'today' | 'week' | 'month' | 'all_time';
+    specId?: string;
+    toolName?: string;
+    model?: string;
+    sessionId?: string;
+}
+export interface LedgerAggregation {
+    totalTokens: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCostUsd: number;
+    totalEstimatedCostUsd: number;
+    entryCount: number;
+    uniqueTools: number;
+    uniqueModels: number;
+    uniqueSessions: number;
+    avgTokensPerCall: number;
+    avgCostPerCall: number;
+    tokensByTool: Record<string, number>;
+    costByTool: Record<string, number>;
+    tokensByModel: Record<string, number>;
+    costByModel: Record<string, number>;
+    estimationAccuracy: number;
+    overEstimationPercent: number;
+}
+export interface MonthlyLedger {
+    month: string;
+    entries: LedgerEntry[];
+    aggregation: LedgerAggregation;
+}
+export interface BudgetConfig {
+    monthlyLimitUsd?: number;
+    warningThresholdPercent: number;
+    criticalThresholdPercent: number;
+}
+export interface LedgerBudgetStatus {
+    monthlyLimitUsd: number | null;
+    spentUsd: number;
+    remainingUsd: number | null;
+    percentUsed: number | null;
+    projectedMonthlyUsd: number;
+    projectedExhaustionDay: number | null;
+    isWarning: boolean;
+    isCritical: boolean;
+    isOverBudget: boolean;
+    daysInMonth: number;
+    daysElapsed: number;
+    dailyAvgUsd: number;
+}
+export interface DailyBreakdown {
+    date: string;
+    totalTokens: number;
+    totalCostUsd: number;
+    callCount: number;
+    topTool: string;
+    topModel: string;
+}
+export interface TrendResult {
+    direction: 'increasing' | 'stable' | 'decreasing';
+    changePercent: number;
+    description: string;
+}
+export interface Anomaly {
+    date: string;
+    type: 'spike' | 'unusual_model' | 'high_cost_tool';
+    severity: 'info' | 'warning' | 'critical';
+    description: string;
+    value: number;
+    threshold: number;
+}
+export interface TopConsumer {
+    name: string;
+    tokens: number;
+    costUsd: number;
+    percentage: number;
+    callCount: number;
+}
+export interface OptimizationSavings {
+    tokensSavedByCache: number;
+    tokensSavedByOptimization: number;
+    totalTokensSaved: number;
+    costSavedUsd: number;
+    savingsPercent: number;
+}
+export interface ReconciliationInput {
+    specId: string;
+    estimatedInputTokens: number;
+    estimatedOutputTokens: number;
+    estimatedCostUsd: number;
+    estimatedModel: string;
+    actualEntries: LedgerEntry[];
+}
+export interface ReconciliationResult {
+    specId: string;
+    estimated: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+        costUsd: number;
+        model: string;
+    };
+    actual: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+        costUsd: number;
+        models: string[];
+        callCount: number;
+    };
+    deviation: {
+        tokenPercent: number;
+        costPercent: number;
+        absoluteTokenDiff: number;
+        absoluteCostDiff: number;
+        direction: 'over' | 'under' | 'accurate';
+    };
+    accuracy: {
+        tokenAccuracy: number;
+        costAccuracy: number;
+        grade: 'excellent' | 'good' | 'fair' | 'poor';
+    };
+    calibrationSuggestion?: string;
+}
+export interface CalibrationData {
+    specId: string;
+    timestamp: string;
+    estimatedTokens: number;
+    actualTokens: number;
+    ratio: number;
+}
+export interface TokenIntelligenceInput {
+    period?: string;
+    groupBy?: string;
+    view?: string;
+    specId?: string;
+    projectPath?: string;
+}
+export interface LedgerAccumulatorState {
+    totalTokens: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCostUsd: number;
+    totalEstimatedCostUsd: number;
+    tokensByTool: Record<string, number>;
+    costByTool: Record<string, number>;
+    tokensByModel: Record<string, number>;
+    costByModel: Record<string, number>;
+    tools: Set<string>;
+    models: Set<string>;
+    sessions: Set<string>;
+    estimatedSum: number;
+    actualForEstimated: number;
+    estimatedCount: number;
+}
+export interface DailyTotal {
+    date: string;
+    tokens: number;
+    costUsd: number;
+    calls: number;
+}
+export interface SimpleTokenTrend {
+    direction: 'increasing' | 'decreasing' | 'stable';
+    changePercent: number;
+}
+export interface SimpleTokenAnomaly {
+    date: string;
+    severity: 'critical' | 'warning';
+    description: string;
+    tokens: number;
+}
+export interface RankedConsumer {
+    rank: number;
+    name: string;
+    tokens: number;
+    costUsd: number;
+    percentOfTotal: number;
+}
+//# sourceMappingURL=token-ledger.d.ts.map

package/dist/types/token-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-ledger.d.ts","sourceRoot":"","sources":["../../src/types/token-ledger.ts"],"names":[],"mappings":"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"}

package/dist/types/token-ledger.js

@@ -0,0 +1,3 @@
+// Token Ledger Types (SPEC-182)
+export {};
+//# sourceMappingURL=token-ledger.js.map

package/dist/types/token-ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-ledger.js","sourceRoot":"","sources":["../../src/types/token-ledger.ts"],"names":[],"mappings":"AAAA,gCAAgC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "0.69.0",
+  "version": "0.70.0",
   "description": "Planu — MCP Server for Spec Driven Development. Manages specs, estimations, reverse engineering, and auto-learning across any language/framework.",
   "type": "module",
   "main": "dist/index.js",

package/src/config/license-plans.json

@@ -62,6 +62,7 @@
     "check_readiness",
     "contribute_context",
     "context_budget",
+    "token_intelligence",
     "data_governance",
     "legal_compliance_report",
     "define_ui_contract",