aiblueprint-cli 1.4.59 → 1.4.61

package/agents-config/claude-config/scripts/statusline/CLAUDE.md

@@ -2,18 +2,17 @@
 
 ## Overview
 
-Clean, type-safe statusline implementation for Claude Code using Bun + TypeScript. Displays real-time session information, git status, context usage, and Claude API rate limits.
+Lightweight, type-safe statusline implementation for Claude Code using Bun and TypeScript. Displays session context, git status, model information, duration, and context usage without premium spend or usage-limit tracking.
 
 ## Project Setup & Configuration
 
 ### Dependencies
 
-- **Bun**: Runtime (uses `$` for shell commands)
-- **@biomejs/biome**: Linting & formatting
+- **Bun**: Runtime
+- **picocolors**: Terminal colors
+- **@biomejs/biome**: Linting and formatting
 - **TypeScript**: Type safety
 
-No external npm packages required - pure Bun APIs.
-
 ### Configuration in Claude Code
 
 Add to `~/.claude/settings.json`:
@@ -22,184 +21,67 @@ Add to `~/.claude/settings.json`:
 {
   "statusLine": {
     "type": "command",
-    "command": "bun ~/.claude/scripts/statusline/src/index.ts",
+    "command": "bun /Users/melvynx/.claude/scripts/statusline/src/index.ts",
     "padding": 0
   }
 }
 ```
 
-### Authentication
-
-OAuth token stored in macOS Keychain:
-
-- **Service**: `Claude Code-credentials`
-- **Format**: JSON with `claudeAiOauth.accessToken`
-- **Token type**: `sk-ant-oat01-...` (OAuth token, not API key)
-- **Access**: `security find-generic-password -s "Claude Code-credentials" -w`
-
 ## Architecture
 
-### Modular Design
-
-The project follows a clean architecture with separated concerns:
-
 ```
 src/
-├── index.ts              # Main entry - orchestrates all components
+├── index.ts              # Main entry point
 └── lib/
-    ├── types.ts          # TypeScript interfaces (HookInput)
-    ├── git.ts            # Git operations (branch, changes)
-    ├── context.ts        # Transcript parsing & context calculation
-    ├── usage-limits.ts   # Claude OAuth API integration
-    └── formatters.ts     # Display utilities & colors
-```
-
-### Data Flow
-
-```
-Claude Code Hook → stdin JSON → index.ts
-                                    ↓
-                    ┌───────────────┴───────────────┐
-                    ↓                               ↓
-            [Get Git Status]            [Get Context Data]
-                    ↓                               ↓
-            [Format Branch]             [Get Usage Limits]
-                    ↓                               ↓
-                    └───────────────┬───────────────┘
-                                    ↓
-                            [Build Output Lines]
-                                    ↓
-                            stdout (2 lines)
-```
-
-## Component Specifications
-
-### Context Calculation (`lib/context.ts`)
-
-- **Purpose**: Calculate token usage from Claude Code transcript files
-- **Algorithm**: Parses `.jsonl` transcript, finds most recent main-chain entry
-- **Tokens counted**: `input_tokens + cache_read_input_tokens + cache_creation_input_tokens`
-- **Excludes**: Sidechain entries (agent calls), API error messages
-- **Output**: `{ tokens: number, percentage: number }` (0-100% of 200k context)
-
-### Usage Limits (`lib/usage-limits.ts`)
-
-- **Purpose**: Fetch Claude API rate limits from OAuth endpoint
-- **Auth**: Retrieves OAuth token from macOS Keychain (`Claude Code-credentials`)
-- **API**: `https://api.anthropic.com/api/oauth/usage`
-- **Data**: Five-hour window utilization + reset time
-- **Error handling**: Fails silently, returns null on errors
-
-### Git Status (`lib/git.ts`)
-
-- **Purpose**: Show current branch and uncommitted changes
-- **Detection**: Checks both staged and unstaged changes
-- **Output**: Branch name + line additions/deletions
-- **Display**: `main* (+123 -45)` with color coding
-
-### Formatters (`lib/formatters.ts`)
-
-- **Colors**: ANSI color codes for terminal output
-- **Token display**: `62.5K`, `1.2M` format
-- **Time formatting**: `3h21m`, `45m` for countdowns
-- **Reset time**: Calculates difference between API reset time and now
-
-## Output Specification
-
-### Line 1: Session Info
-
-```
-main* (+123 -45) | ~/.claude | Sonnet 4.5
+    ├── types.ts          # TypeScript interfaces
+    ├── git.ts            # Git operations
+    ├── context.ts        # Payload/transcript context calculation
+    ├── render-pure.ts    # Pure rendering logic
+    └── formatters.ts     # Display utilities and colors
 ```
 
-### Line 2: Metrics
+## Data Flow
 
 ```
-$0.17 (6m) | 62.5K tokens | 31% | 15% (3h27m)
+Claude Code hook -> stdin JSON -> index.ts
+                                -> get git status
+                                -> get context data
+                                -> render statusline
+                                -> stdout
 ```
 
-**Components:**
+## Component Notes
 
-- `$0.17` - Session cost (USD)
-- `(6m)` - Session duration
-- `62.5K tokens` - Context tokens used (from transcript)
-- `31%` - Context percentage (tokens / 200k)
-- `15%` - Five-hour usage (from Claude API)
-- `(3h27m)` - Time until rate limit resets
+- `lib/context.ts` calculates context tokens from the hook payload when available, falling back to transcript parsing.
+- `lib/git.ts` detects branch and staged/unstaged changes.
+- `lib/render-pure.ts` renders output from prepared data and config.
+- `src/commands/interactive-config.ts` must stay in sync with `statusline.config.json`.
 
 ## Development
 
-### Testing
-
 ```bash
-# Run test with fixture
 bun run test
-
-# Use custom fixture
-bun run test fixtures/custom.json
-
-# Manual test
-echo '{ ... }' | bun run start
+bun run statusline:test-fixtures
+bun run statusline:config
 ```
 
-### Code Conventions
-
-- **ALWAYS** use camelCase for variables and functions
-- Use TypeScript strict mode
-- Follow Biome formatting rules
-
-### Error Handling & Performance
-
-**Error Handling** - All components fail silently:
-
-- Missing transcript → 0 tokens, 0%
-- API failure → No usage limits shown
-- Git errors → "no-git" branch
-- Keychain access denied → No usage limits
-
-This ensures statusline never crashes Claude Code.
+Manual test:
 
-**Performance Benchmarks:**
-
-- Context calculation: ~10-50ms (depends on transcript size)
-- API call: ~100-300ms (cached by Claude API)
-- Git operations: ~20-50ms
-- Total: < 500ms typical
-
-## Maintenance Guide
-
-### Adding New Metrics
-
-1. Add interface to `lib/types.ts`
-2. Create fetcher in `lib/*.ts`
-3. Import in `index.ts`
-4. Add to `buildSecondLine()`
-
-### Modifying Display
+```bash
+echo '{ ... }' | bun run statusline:start
+```
 
-- Colors: Edit `lib/formatters.ts` colors constant
-- Layout: Modify `buildFirstLine()` / `buildSecondLine()`
-- Formatting: Add functions to `lib/formatters.ts`
+## Error Handling
 
-## Known Limitations
+The statusline should fail softly:
 
-- macOS only (uses Keychain)
-- Requires `git` CLI for git status
-- Requires Claude Code OAuth (not API key)
-- Transcript must be accessible (permissions)
+- Missing transcript -> 0 tokens, 0%
+- Git errors -> no-git fallback
+- Missing config -> default config
+- Invalid stdin -> concise error output
 
 ## Critical Requirements
 
-### Configuration Updates
-
-- **CRITICAL**: When updating `statusline.config.json` or `statusline.config.ts`, you **MUST** update the interactive demo in `src/commands/interactive-config.ts`
-- **ALWAYS** run `bun run config` after config changes to verify the interactive demo works correctly
-- **REQUIRED**: Keep config file structure in sync with interactive prompts
-
-### Runtime & Dependencies
-
-- **ALWAYS** use Bun for all commands and runtime operations
-- Use `bun run <script>` instead of `npm run` or `pnpm run`
-- Use `bun install` for dependency management
-- **AUTHORIZED LIBRARIES**: `@biomejs/biome` for linting/formatting, third-party libraries like `tiers` are permitted if needed
-- **NEVER** add external npm packages without verification - prefer Bun APIs first
+- Keep `statusline.config.json`, `defaults.json`, and `src/commands/interactive-config.ts` aligned.
+- Use Bun for runtime and tests.
+- Keep this free version lightweight: no spend database, no usage-limit API, no OAuth credential dependency.

package/agents-config/claude-config/scripts/statusline/README.md

@@ -1,16 +1,14 @@
 # Claude Code Statusline
 
-Clean, modular statusline for Claude Code with TypeScript + Bun.
+Lightweight statusline for Claude Code with TypeScript + Bun.
 
 ## Features
 
-- 🌿 Git branch with changes (+added -deleted)
-- 💰 Session cost and duration
-- 🧩 Context tokens used
-- 📊 Context percentage (0-100%)
-- ⏱️ Five-hour usage limit with reset time
-- 📅 Weekly usage limit with configurable threshold
-- 📈 Daily usage percentage tracking and statistics
+- Git branch with staged/unstaged indicators
+- Current working directory
+- Model name and thinking status
+- Session duration
+- Context tokens and percentage
 
 ## Structure
 
@@ -20,8 +18,7 @@ src/
 └── lib/
     ├── types.ts          # TypeScript interfaces
     ├── git.ts            # Git status
-    ├── context.ts        # Context calculation from transcript
-    ├── usage-limits.ts   # Claude API usage limits
+    ├── context.ts        # Context calculation from payload/transcript
     └── formatters.ts     # Formatting utilities
 ```
 
@@ -32,19 +29,10 @@ src/
 bun install
 
 # Run the statusline (needs stdin JSON)
-echo '{ ... }' | bun run start
+echo '{ ... }' | bun run statusline:start
 
-# View today's spending
-bun run spend:today
-
-# View this month's spending
-bun run spend:month
-
-# View usage statistics
-bun run stats
-
-# Interactive config demo
-bun run demo
+# Interactive config
+bun run statusline:config
 
 # Format code
 bun run format
@@ -53,53 +41,12 @@ bun run format
 bun run lint
 ```
 
-## Tracking Features
-
-### Spend Tracking
-
-The statusline automatically saves session data to `data/spend.json`. You can view your spending with:
-
-```bash
-# Today's sessions and cost
-bun run spend:today
-
-# This month's sessions grouped by date
-bun run spend:month
-```
-
-Each session tracks:
-- Cost (USD)
-- Duration
-- Lines added/removed
-- Working directory
-
-### Usage Statistics
-
-Daily usage percentages are automatically tracked in `data/daily-usage.json`. Each 5-hour rate limit period is tracked separately using the `resets_at` timestamp as a unique key.
-
-```bash
-bun run stats
-```
-
-This shows:
-- Average daily usage percentage across all tracked days
-- Total days and total 5-hour periods tracked
-- Recent 7-day usage history with visual bars
-- Per-day statistics: average, max, min across all 5-hour periods
-- Data is kept for 90 days
-
-**How it works:**
-- Each `resets_at` value represents a unique 5-hour rate limit period
-- Multiple 5-hour periods can occur in a single day
-- If the API is called multiple times during the same 5-hour period, only the latest value is kept
-- Daily statistics show the average, maximum, and minimum usage across all periods in that day
-
-## Interactive Demo
+## Interactive Config
 
 Explore all configuration options with a live preview:
 
 ```bash
-bun run demo
+bun run statusline:config
 ```
 
 This opens an interactive menu where you can:
@@ -107,7 +54,7 @@ This opens an interactive menu where you can:
 - See instant preview of how the statusline changes
 - Navigate through all available settings
 - Reset to defaults with `R`
-- Explore session, limits, weekly usage, and git display options
+- Explore session, context, path, and git display options
 
 **Controls:**
 - `↑↓` or `j/k` - Navigate options
@@ -117,39 +64,16 @@ This opens an interactive menu where you can:
 
 ## Configuration
 
-The statusline can be customized via `statusline.config.ts`. Key configuration options:
-
-### Weekly Usage Display
-
-```typescript
-weeklyUsage: {
-  enabled: boolean | "90%",  // true: always show, false: never, "90%": show when 5-hour usage >= 90%
-  showTimeLeft: boolean,
-  percentage: {
-    enabled: boolean,
-    progressBar: {
-      enabled: boolean,
-      length: 5 | 10 | 15,
-      style: "filled" | "rectangle" | "braille",
-      color: "progressive" | "green" | "yellow" | "red"
-    }
-  }
-}
-```
-
-**Default:** `enabled: "90%"` - Weekly limits appear when your 5-hour usage reaches 90%
-
-Display format: `W: ⣿⣿⣧⣀⣀⣀⣀⣀⣀⣀ 45% (6d12h)`
+The statusline can be customized via `statusline.config.json`.
 
 ### Other Configuration Options
 
-- **Session display**: Cost, tokens, context percentage
-- **Limits display**: Five-hour usage limits
+- **Session display**: Duration, tokens, context percentage
 - **Git display**: Branch, changes, staged/unstaged files
 - **Path display**: Full, truncated, or basename modes
 - **Progress bars**: Multiple styles and color schemes
 
-See `statusline.config.ts` for all available options and defaults.
+See `statusline.config.json` for all available options and defaults.
 
 ## Usage in Claude Code
 
@@ -159,7 +83,7 @@ Update your `~/.claude/settings.json`:
 {
   "statusLine": {
     "type": "command",
-    "command": "bun ~/.claude/scripts/statusline/src/index.ts",
+    "command": "bun /Users/melvynx/.claude/scripts/statusline/src/index.ts",
     "padding": 0
   }
 }
@@ -189,5 +113,5 @@ echo '{
     "total_lines_added": 100,
     "total_lines_removed": 50
   }
-}' | bun run start
+}' | bun run statusline:start
 ```

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

@@ -1,7 +1,7 @@
 {
 	"features": {
-		"usageLimits": true,
-		"spendTracking": true
+		"usageLimits": false,
+		"spendTracking": false
 	},
 	"oneLine": true,
 	"showSonnetModel": false,
@@ -17,7 +17,7 @@
 	"separator": "•",
 	"session": {
 		"infoSeparator": null,
-		"cost": { "enabled": true, "format": "decimal1" },
+		"cost": { "enabled": false, "format": "decimal1" },
 		"duration": { "enabled": true },
 		"tokens": { "enabled": true, "showMax": false, "showDecimals": false },
 		"percentage": {
@@ -40,9 +40,9 @@
 		"overheadTokens": 0
 	},
 	"limits": {
-		"enabled": true,
-		"showTimeLeft": true,
-		"showPacingDelta": true,
+		"enabled": false,
+		"showTimeLeft": false,
+		"showPacingDelta": false,
 		"cost": { "enabled": false, "format": "decimal1" },
 		"percentage": {
 			"enabled": true,
@@ -57,9 +57,9 @@
 		}
 	},
 	"weeklyUsage": {
-		"enabled": "90%",
-		"showTimeLeft": true,
-		"showPacingDelta": true,
+		"enabled": false,
+		"showTimeLeft": false,
+		"showPacingDelta": false,
 		"cost": { "enabled": false, "format": "decimal1" },
 		"percentage": {
 			"enabled": true,
@@ -74,6 +74,9 @@
 		}
 	},
 	"dailySpend": {
-		"cost": { "enabled": true, "format": "decimal1" }
+		"cost": { "enabled": false, "format": "decimal1" }
+	},
+	"thinking": {
+		"showDisabledWarning": true
 	}
 }

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

@@ -1,4 +1,4 @@
-{"parentUuid":null,"isSidechain":false,"userType":"external","cwd":"/tmp/test-project","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":"/tmp/test-project","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":"/tmp/test-project","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":"/tmp/test-project","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"}
+{"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/agents-config/claude-config/scripts/statusline/fixtures/test-input.json

@@ -1,14 +1,14 @@
 {
 	"session_id": "06a7b019-03f8-4083-a9db-410d95cb01e6",
-	"transcript_path": "/tmp/test-fixtures/mock-transcript.jsonl",
-	"cwd": "/tmp/test-project",
+	"transcript_path": "/Users/melvynx/.claude/scripts/statusline/fixtures/mock-transcript.jsonl",
+	"cwd": "/Users/melvynx/.claude",
 	"model": {
 		"id": "claude-sonnet-4-5-20250929",
 		"display_name": "Sonnet 4.5"
 	},
 	"workspace": {
-		"current_dir": "/tmp/test-project",
-		"project_dir": "/tmp/test-project"
+		"current_dir": "/Users/melvynx/.claude",
+		"project_dir": "/Users/melvynx/.claude"
 	},
 	"version": "2.0.68",
 	"output_style": {