aiblueprint-cli 1.4.12 → 1.4.14

package/claude-code-config/scripts/statusline/defaults.json

@@ -0,0 +1,79 @@
+{
+	"features": {
+		"usageLimits": true,
+		"spendTracking": true
+	},
+	"oneLine": true,
+	"showSonnetModel": false,
+	"pathDisplayMode": "truncated",
+	"git": {
+		"enabled": true,
+		"showBranch": true,
+		"showDirtyIndicator": true,
+		"showChanges": false,
+		"showStaged": true,
+		"showUnstaged": true
+	},
+	"separator": "•",
+	"session": {
+		"infoSeparator": null,
+		"cost": { "enabled": true, "format": "decimal1" },
+		"duration": { "enabled": true },
+		"tokens": { "enabled": true, "showMax": false, "showDecimals": false },
+		"percentage": {
+			"enabled": true,
+			"showValue": true,
+			"progressBar": {
+				"enabled": true,
+				"length": 10,
+				"style": "braille",
+				"color": "progressive",
+				"background": "none"
+			}
+		}
+	},
+	"context": {
+		"usePayloadContextWindow": true,
+		"maxContextTokens": 200000,
+		"autocompactBufferTokens": 45000,
+		"useUsableContextOnly": true,
+		"overheadTokens": 0
+	},
+	"limits": {
+		"enabled": true,
+		"showTimeLeft": true,
+		"showPacingDelta": true,
+		"cost": { "enabled": false, "format": "decimal1" },
+		"percentage": {
+			"enabled": true,
+			"showValue": true,
+			"progressBar": {
+				"enabled": true,
+				"length": 10,
+				"style": "braille",
+				"color": "progressive",
+				"background": "none"
+			}
+		}
+	},
+	"weeklyUsage": {
+		"enabled": "90%",
+		"showTimeLeft": true,
+		"showPacingDelta": true,
+		"cost": { "enabled": false, "format": "decimal1" },
+		"percentage": {
+			"enabled": true,
+			"showValue": true,
+			"progressBar": {
+				"enabled": true,
+				"length": 10,
+				"style": "braille",
+				"color": "progressive",
+				"background": "none"
+			}
+		}
+	},
+	"dailySpend": {
+		"cost": { "enabled": true, "format": "decimal1" }
+	}
+}

package/claude-code-config/scripts/statusline/docs/ARCHITECTURE.md

@@ -0,0 +1,166 @@
+# Statusline Architecture - Session & Period Tracking
+
+## Concepts Fondamentaux
+
+### Session Claude Code
+
+Une **session** est créée chaque fois qu'on ouvre un chat avec Claude Code.
+
+Caractéristiques:
+- **ID unique**: `session_id` (UUID)
+- **Coût cumulatif**: Le coût total de la session qui AUGMENTE au fil du temps
+- **Persistance**: Une session peut durer des heures/jours
+- **Commande /clear**: Efface la conversation mais GARDE la même session
+- **Le coût ne reset jamais**: Si une session a coûté $10, puis on fait /clear, le coût reste $10 et continue d'augmenter
+
+```
+Session "abc-123"
+├── Début: $0
+├── Après 1h: $5
+├── /clear (conversation effacée)
+├── Après 2h: $12 (coût continue d'augmenter)
+├── Fermeture terminal
+├── Réouverture (même session)
+└── Après 3h: $18 (toujours cumulatif)
+```
+
+### Période (5 heures)
+
+Une **période** est une fenêtre de 5 heures pour le rate limiting d'Anthropic.
+
+Caractéristiques:
+- **resets_at**: Timestamp de fin de période (ex: "2025-12-09T10:00:00.000Z")
+- **Durée fixe**: 5 heures
+- **Indépendant des sessions**: Les sessions peuvent traverser plusieurs périodes
+
+```
+Période A (05:00-10:00)     Période B (10:00-15:00)
+├────────────────────┤     ├────────────────────┤
+   Session 1: +$5              Session 1: +$3 (continue)
+   Session 2: +$8              Session 3: +$10 (nouvelle)
+   ─────────────               ─────────────
+   Total: $13                  Total: $13
+```
+
+## Le Problème Actuel
+
+### Bug: Double Comptage
+
+Quand on calcule le coût d'une période en sommant les coûts totaux des sessions:
+
+```
+Session X: coût total = $24
+Session X: last_resets_at = période actuelle
+
+getCurrentPeriodCost() retourne $24 ❌ FAUX!
+```
+
+Mais si la session X avait déjà $10 AVANT cette période:
+- Coût réel de cette période = $24 - $10 = $14
+- On affiche $24 au lieu de $14 = **double comptage**
+
+### Scénario Réel
+
+```
+1. Période A: Session X coûte $10, on compte $10 ✓
+2. Période B commence
+3. Session X continue, coût monte à $24
+4. On calcule période B: on voit session X = $24
+5. On affiche $24 pour période B ❌
+6. Mais on avait déjà compté $10 en période A!
+7. Total affiché: $10 + $24 = $34
+8. Total réel: $24
+```
+
+## Solution: Tracking des Deltas par Session
+
+### Nouvelle Structure de Données
+
+On doit tracker pour chaque session:
+- Combien on a DÉJÀ compté
+- Dans quelle période on l'a compté
+
+```sql
+-- Table: sessions
+session_id    TEXT PRIMARY KEY
+total_cost    REAL        -- Coût total actuel de la session
+cwd           TEXT
+date          TEXT
+duration_ms   INTEGER
+lines_added   INTEGER
+lines_removed INTEGER
+
+-- Table: session_period_tracking
+session_id    TEXT
+period_id     TEXT        -- resets_at normalisé
+counted_cost  REAL        -- Combien on a compté pour cette période
+last_update   INTEGER     -- Timestamp
+PRIMARY KEY (session_id, period_id)
+
+-- Table: periods
+period_id     TEXT PRIMARY KEY  -- resets_at normalisé
+total_cost    REAL              -- Somme des deltas de toutes les sessions
+utilization   INTEGER
+date          TEXT
+```
+
+### Algorithme Correct
+
+```
+Quand saveSession(session_id, new_cost, current_period):
+  1. Chercher session dans DB
+  2. Si existe:
+       old_cost = session.total_cost
+       delta = new_cost - old_cost
+     Sinon:
+       delta = new_cost
+
+  3. Chercher tracking pour (session_id, current_period)
+  4. Si existe:
+       // Déjà compté dans cette période, calculer le vrai delta
+       already_counted = tracking.counted_cost
+       period_delta = delta  // Le delta depuis la dernière update
+     Sinon:
+       // Nouvelle session dans cette période
+       period_delta = delta
+
+  5. Mettre à jour:
+     - session.total_cost = new_cost
+     - tracking.counted_cost += period_delta
+     - period.total_cost += period_delta
+```
+
+### Exemple Concret
+
+```
+Session X traverse 2 périodes:
+
+Période A:
+  - Session X: $0 → $10
+  - tracking(X, A).counted_cost = $10
+  - period(A).total_cost = $10
+
+Période B:
+  - Session X: $10 → $24
+  - delta = $24 - $10 = $14
+  - tracking(X, B).counted_cost = $14
+  - period(B).total_cost = $14
+
+Calcul période B:
+  - On lit period(B).total_cost = $14 ✓ CORRECT!
+```
+
+## Avantages SQLite
+
+1. **Transactions ACID**: Pas de corruption de données
+2. **Requêtes complexes**: Agrégations, joins faciles
+3. **Index**: Performance pour les lookups par session_id
+4. **Single file**: Toujours portable
+5. **Intégrité référentielle**: FK entre tables
+
+## Migration
+
+1. Créer nouveau fichier `statusline.db`
+2. Migrer données existantes de spend.json et daily-usage.json
+3. Recalculer les period_costs correctement
+4. Supprimer les anciens fichiers JSON

package/claude-code-config/scripts/statusline/fixtures/mock-transcript.jsonl

@@ -0,0 +1,4 @@
+{"parentUuid":null,"isSidechain":false,"userType":"external","cwd":"/Users/melvynx/.claude/scripts/statusline","sessionId":"demo-session","version":"2.0.31","gitBranch":"main","timestamp":"2025-11-11T10:00:00.000Z","message":{"model":"claude-sonnet-4-5-20250929","id":"msg_01","type":"message","role":"user","content":[{"type":"text","text":"Hello"}],"usage":{"input_tokens":1000,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":100}},"uuid":"uuid-1"}
+{"parentUuid":"uuid-1","isSidechain":false,"userType":"external","cwd":"/Users/melvynx/.claude/scripts/statusline","sessionId":"demo-session","version":"2.0.31","gitBranch":"main","timestamp":"2025-11-11T10:05:00.000Z","message":{"model":"claude-sonnet-4-5-20250929","id":"msg_02","type":"message","role":"assistant","content":[{"type":"text","text":"Hi there!"}],"usage":{"input_tokens":50000,"cache_creation_input_tokens":30000,"cache_read_input_tokens":0,"output_tokens":200}},"uuid":"uuid-2"}
+{"parentUuid":"uuid-2","isSidechain":false,"userType":"external","cwd":"/Users/melvynx/.claude/scripts/statusline","sessionId":"demo-session","version":"2.0.31","gitBranch":"main","timestamp":"2025-11-11T10:10:00.000Z","message":{"model":"claude-sonnet-4-5-20250929","id":"msg_03","type":"message","role":"user","content":[{"type":"text","text":"Can you help me?"}],"usage":{"input_tokens":20000,"cache_creation_input_tokens":0,"cache_read_input_tokens":40000,"output_tokens":150}},"uuid":"uuid-3"}
+{"parentUuid":"uuid-3","isSidechain":false,"userType":"external","cwd":"/Users/melvynx/.claude/scripts/statusline","sessionId":"demo-session","version":"2.0.31","gitBranch":"main","timestamp":"2025-11-11T10:15:00.000Z","message":{"model":"claude-sonnet-4-5-20250929","id":"msg_04","type":"message","role":"assistant","content":[{"type":"text","text":"Of course! What do you need?"}],"usage":{"input_tokens":30000,"cache_creation_input_tokens":0,"cache_read_input_tokens":45000,"output_tokens":300}},"uuid":"uuid-4"}

package/claude-code-config/scripts/statusline/fixtures/test-input.json

@@ -1,6 +1,6 @@
 {
 	"session_id": "06a7b019-03f8-4083-a9db-410d95cb01e6",
-	"transcript_path": "/Users/melvynx/.claude/projects/-Users-melvynx--claude/06a7b019-03f8-4083-a9db-410d95cb01e6.jsonl",
+	"transcript_path": "/Users/melvynx/.claude/scripts/statusline/fixtures/mock-transcript.jsonl",
 	"cwd": "/Users/melvynx/.claude",
 	"model": {
 		"id": "claude-sonnet-4-5-20250929",
@@ -10,7 +10,7 @@
 		"current_dir": "/Users/melvynx/.claude",
 		"project_dir": "/Users/melvynx/.claude"
 	},
-	"version": "2.0.31",
+	"version": "2.0.68",
 	"output_style": {
 		"name": "default"
 	},
@@ -21,5 +21,15 @@
 		"total_lines_added": 185,
 		"total_lines_removed": 75
 	},
+	"context_window": {
+		"total_input_tokens": 136349,
+		"total_output_tokens": 21612,
+		"context_window_size": 200000,
+		"current_usage": {
+			"input_tokens": 62500,
+			"cache_creation_input_tokens": 0,
+			"cache_read_input_tokens": 0
+		}
+	},
 	"exceeds_200k_tokens": false
 }

package/claude-code-config/scripts/statusline/src/index.ts

@@ -1,38 +1,189 @@
 #!/usr/bin/env bun
 
-import { defaultConfig } from "../statusline.config";
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { defaultConfig, type StatuslineConfig } from "./lib/config";
 import { getContextData } from "./lib/context";
-import { colors, formatPath, formatSession } from "./lib/formatters";
+import {
+	colors,
+	formatBranch,
+	formatCost,
+	formatDuration,
+	formatPath,
+} from "./lib/formatters";
+import { getGitStatus } from "./lib/git";
+import {
+	renderStatusline,
+	type StatuslineData,
+	type UsageLimit,
+} from "./lib/render-pure";
 import type { HookInput } from "./lib/types";
 
+// Optional feature imports - just delete the folder to disable!
+let getUsageLimits: any = null;
+let normalizeResetsAt: any = null;
+let getPeriodCost: any = null;
+let getTodayCostV2: any = null;
+let saveSessionV2: any = null;
+
+try {
+	const limitsModule = await import("./lib/features/limits");
+	getUsageLimits = limitsModule.getUsageLimits;
+} catch {
+	// Limits feature not available - that's OK!
+}
+
+try {
+	const utilsModule = await import("./lib/utils");
+	normalizeResetsAt = utilsModule.normalizeResetsAt;
+} catch {
+	// Fallback normalizeResetsAt
+	normalizeResetsAt = (resetsAt: string) => resetsAt;
+}
+
+try {
+	const spendModule = await import("./lib/features/spend");
+	getPeriodCost = spendModule.getPeriodCost;
+	getTodayCostV2 = spendModule.getTodayCostV2;
+	saveSessionV2 = spendModule.saveSessionV2;
+} catch {
+	// Spend tracking feature not available - that's OK!
+}
+
+// Re-export from render-pure for backwards compatibility
+export {
+	renderStatusline,
+	type StatuslineData,
+	type UsageLimit,
+} from "./lib/render-pure";
+
+const CONFIG_FILE_PATH = join(import.meta.dir, "..", "statusline.config.json");
+const LAST_PAYLOAD_PATH = join(
+	import.meta.dir,
+	"..",
+	"data",
+	"last_payload.txt",
+);
+
+async function loadConfig(): Promise<StatuslineConfig> {
+	try {
+		const content = await readFile(CONFIG_FILE_PATH, "utf-8");
+		return JSON.parse(content);
+	} catch {
+		return defaultConfig;
+	}
+}
+
 async function main() {
 	try {
 		const input: HookInput = await Bun.stdin.json();
 
-		const dirPath = formatPath(
-			input.workspace.current_dir,
-			defaultConfig.pathDisplayMode,
-		);
-
-		const contextData = await getContextData({
-			transcriptPath: input.transcript_path,
-			maxContextTokens: defaultConfig.context.maxContextTokens,
-		});
-
-		const sessionInfo = formatSession(
-			contextData.tokens,
-			contextData.percentage,
-			defaultConfig.session,
-		);
-
-		const sep = ` ${colors.GRAY}${defaultConfig.separator}${colors.LIGHT_GRAY} `;
-		console.log(`${colors.LIGHT_GRAY}${dirPath}${sep}${sessionInfo}${colors.RESET}`);
-		console.log("");
+		// Save last payload for debugging
+		await writeFile(LAST_PAYLOAD_PATH, JSON.stringify(input, null, 2));
+
+		const config = await loadConfig();
+
+		// Get usage limits (if feature exists)
+		const usageLimits = getUsageLimits
+			? await getUsageLimits()
+			: { five_hour: null, seven_day: null };
+		const currentResetsAt = usageLimits.five_hour?.resets_at ?? undefined;
+
+		// Save session with current period context (if feature exists)
+		if (saveSessionV2) {
+			await saveSessionV2(input, currentResetsAt);
+		}
+
+		const git = await getGitStatus();
+
+		let contextTokens: number | null;
+		let contextPercentage: number | null;
+
+		const usePayloadContext =
+			config.context.usePayloadContextWindow && input.context_window;
+
+		if (usePayloadContext) {
+			const current = input.context_window?.current_usage;
+			if (current) {
+				contextTokens =
+					(current.input_tokens || 0) +
+					(current.cache_creation_input_tokens || 0) +
+					(current.cache_read_input_tokens || 0);
+				const maxTokens =
+					input.context_window?.context_window_size ||
+					config.context.maxContextTokens;
+				contextPercentage = Math.min(
+					100,
+					Math.round((contextTokens / maxTokens) * 100),
+				);
+			} else {
+				// No context data yet - session not started
+				contextTokens = null;
+				contextPercentage = null;
+			}
+		} else {
+			const contextData = await getContextData({
+				transcriptPath: input.transcript_path,
+				maxContextTokens: config.context.maxContextTokens,
+				autocompactBufferTokens: config.context.autocompactBufferTokens,
+				useUsableContextOnly: config.context.useUsableContextOnly,
+				overheadTokens: config.context.overheadTokens,
+			});
+			contextTokens = contextData.tokens;
+			contextPercentage = contextData.percentage;
+		}
+
+		// Get period cost from SQLite (if feature exists)
+		let periodCost: number | undefined;
+		let todayCost: number | undefined;
+
+		if (getPeriodCost && getTodayCostV2 && normalizeResetsAt) {
+			const normalizedPeriodId = currentResetsAt
+				? normalizeResetsAt(currentResetsAt)
+				: null;
+			periodCost = normalizedPeriodId ? getPeriodCost(normalizedPeriodId) : 0;
+			todayCost = getTodayCostV2();
+		}
+
+		const data: StatuslineData = {
+			branch: formatBranch(git, config.git),
+			dirPath: formatPath(input.workspace.current_dir, config.pathDisplayMode),
+			modelName: input.model.display_name,
+			sessionCost: formatCost(
+				input.cost.total_cost_usd,
+				config.session.cost.format,
+			),
+			sessionDuration: formatDuration(input.cost.total_duration_ms),
+			contextTokens,
+			contextPercentage,
+			...(getUsageLimits && {
+				usageLimits: {
+					five_hour: usageLimits.five_hour
+						? {
+								utilization: usageLimits.five_hour.utilization,
+								resets_at: usageLimits.five_hour.resets_at,
+							}
+						: null,
+					seven_day: usageLimits.seven_day
+						? {
+								utilization: usageLimits.seven_day.utilization,
+								resets_at: usageLimits.seven_day.resets_at,
+							}
+						: null,
+				},
+			}),
+			...((getPeriodCost || getTodayCostV2) && { periodCost, todayCost }),
+		};
+
+		const output = renderStatusline(data, config);
+		console.log(output);
+		if (config.oneLine) {
+			console.log("");
+		}
 	} catch (error) {
 		const errorMessage = error instanceof Error ? error.message : String(error);
-		console.log(
-			`${colors.RED}Error:${colors.LIGHT_GRAY} ${errorMessage}${colors.RESET}`,
-		);
+		console.log(`${colors.red("Error:")} ${errorMessage}`);
+		console.log(colors.gray("Check statusline configuration"));
 	}
 }
 

package/claude-code-config/scripts/statusline/src/lib/config-types.ts

@@ -0,0 +1,104 @@
+export type Separator =
+	| "|"
+	| "•"
+	| "·"
+	| "⋅"
+	| "●"
+	| "◆"
+	| "▪"
+	| "▸"
+	| "›"
+	| "→";
+
+export type CostFormat = "integer" | "decimal1" | "decimal2";
+export type ProgressBarStyle = "filled" | "rectangle" | "braille";
+export type ProgressBarColor =
+	| "progressive"
+	| "green"
+	| "yellow"
+	| "red"
+	| "peach"
+	| "black"
+	| "white";
+export type ProgressBarBackground =
+	| "none"
+	| "dark"
+	| "gray"
+	| "light"
+	| "blue"
+	| "purple"
+	| "cyan"
+	| "peach";
+
+export interface CostConfig {
+	enabled: boolean;
+	format: CostFormat;
+}
+
+export interface ProgressBarConfig {
+	enabled: boolean;
+	length: 5 | 10 | 15;
+	style: ProgressBarStyle;
+	color: ProgressBarColor;
+	background: ProgressBarBackground;
+}
+
+export interface PercentageConfig {
+	enabled: boolean;
+	showValue: boolean;
+	progressBar: ProgressBarConfig;
+}
+
+export interface StatuslineConfig {
+	features?: {
+		usageLimits?: boolean;
+		spendTracking?: boolean;
+	};
+	oneLine: boolean;
+	showSonnetModel: boolean;
+	pathDisplayMode: "full" | "truncated" | "basename";
+	git: {
+		enabled: boolean;
+		showBranch: boolean;
+		showDirtyIndicator: boolean;
+		showChanges: boolean;
+		showStaged: boolean;
+		showUnstaged: boolean;
+	};
+	separator: Separator;
+	session: {
+		infoSeparator: Separator | null;
+		cost: CostConfig;
+		duration: { enabled: boolean };
+		tokens: {
+			enabled: boolean;
+			showMax: boolean;
+			showDecimals: boolean;
+		};
+		percentage: PercentageConfig;
+	};
+	context: {
+		usePayloadContextWindow: boolean;
+		maxContextTokens: number;
+		autocompactBufferTokens: number;
+		useUsableContextOnly: boolean;
+		overheadTokens: number;
+	};
+	limits: {
+		enabled: boolean;
+		showTimeLeft: boolean;
+		showPacingDelta: boolean;
+		cost: CostConfig;
+		percentage: PercentageConfig;
+	};
+	weeklyUsage: {
+		enabled: boolean | "90%";
+		showTimeLeft: boolean;
+		showPacingDelta: boolean;
+		cost: CostConfig;
+		percentage: PercentageConfig;
+	};
+	dailySpend: {
+		cost: CostConfig;
+	};
+}

package/claude-code-config/scripts/statusline/src/lib/config.ts

@@ -0,0 +1,21 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import type { StatuslineConfig } from "./config-types";
+
+const CONFIG_DIR = join(import.meta.dir, "..", "..");
+const DEFAULTS_PATH = join(CONFIG_DIR, "defaults.json");
+const CONFIG_PATH = join(CONFIG_DIR, "statusline.config.json");
+
+export const defaultConfig: StatuslineConfig = JSON.parse(
+	readFileSync(DEFAULTS_PATH, "utf-8"),
+);
+
+export function loadConfig(): StatuslineConfig {
+	try {
+		return JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
+	} catch {
+		return JSON.parse(JSON.stringify(defaultConfig));
+	}
+}
+
+export type { StatuslineConfig } from "./config-types";