nemonix-cli 1.0.0

package/src/config/claude-code-config/scripts/statusline/README.md

@@ -0,0 +1,193 @@
+# Claude Code Statusline
+
+Clean, modular 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
+
+## Structure
+
+```
+src/
+├── index.ts              # Main entry point
+└── lib/
+    ├── types.ts          # TypeScript interfaces
+    ├── git.ts            # Git status
+    ├── context.ts        # Context calculation from transcript
+    ├── usage-limits.ts   # Claude API usage limits
+    └── formatters.ts     # Formatting utilities
+```
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run the statusline (needs stdin JSON)
+echo '{ ... }' | bun run 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
+
+# Format code
+bun run format
+
+# Lint code
+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
+
+Explore all configuration options with a live preview:
+
+```bash
+bun run demo
+```
+
+This opens an interactive menu where you can:
+- Toggle any config option with arrow keys and spacebar
+- 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
+
+**Controls:**
+- `↑↓` or `j/k` - Navigate options
+- `Space` - Toggle selected option
+- `R` - Reset to defaults
+- `Q` - Quit
+
+## 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)`
+
+### Other Configuration Options
+
+- **Session display**: Cost, tokens, context percentage
+- **Limits display**: Five-hour usage limits
+- **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.
+
+## Usage in Claude Code
+
+Update your `~/.claude/settings.json`:
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "bun /Users/melvynx/.claude/scripts/statusline/src/index.ts",
+    "padding": 0
+  }
+}
+```
+
+## Testing
+
+```bash
+echo '{
+  "session_id": "test",
+  "transcript_path": "/path/to/transcript.jsonl",
+  "cwd": "/path",
+  "model": {
+    "id": "claude-sonnet-4-5",
+    "display_name": "Sonnet 4.5"
+  },
+  "workspace": {
+    "current_dir": "/path",
+    "project_dir": "/path"
+  },
+  "version": "2.0.31",
+  "output_style": { "name": "default" },
+  "cost": {
+    "total_cost_usd": 0.15,
+    "total_duration_ms": 300000,
+    "total_api_duration_ms": 200000,
+    "total_lines_added": 100,
+    "total_lines_removed": 50
+  }
+}' | bun run start
+```

package/src/config/claude-code-config/scripts/statusline/__tests__/context.test.ts

@@ -0,0 +1,229 @@
+import { afterAll, beforeAll, describe, expect, it } from "bun:test";
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { getContextData, getContextLength } from "../src/lib/context";
+
+const TEST_DIR = join(import.meta.dir, "..", "fixtures", "test-transcripts");
+
+beforeAll(() => {
+	mkdirSync(TEST_DIR, { recursive: true });
+});
+
+afterAll(() => {
+	rmSync(TEST_DIR, { recursive: true, force: true });
+});
+
+function createTranscript(lines: object[]): string {
+	return lines.map((l) => JSON.stringify(l)).join("\n");
+}
+
+describe("getContextLength", () => {
+	it("should return 0 for empty transcript", async () => {
+		const path = join(TEST_DIR, "empty.jsonl");
+		writeFileSync(path, "");
+		expect(await getContextLength(path)).toBe(0);
+	});
+
+	it("should return 0 for transcript with no usage data", async () => {
+		const path = join(TEST_DIR, "no-usage.jsonl");
+		const content = createTranscript([
+			{ type: "user", message: { role: "user", content: "hello" } },
+		]);
+		writeFileSync(path, content);
+		expect(await getContextLength(path)).toBe(0);
+	});
+
+	it("should calculate tokens from most recent entry", async () => {
+		const path = join(TEST_DIR, "with-usage.jsonl");
+		const content = createTranscript([
+			{
+				timestamp: "2025-01-01T10:00:00Z",
+				message: {
+					role: "assistant",
+					usage: { input_tokens: 1000, output_tokens: 100 },
+				},
+			},
+			{
+				timestamp: "2025-01-01T10:05:00Z",
+				message: {
+					role: "assistant",
+					usage: { input_tokens: 5000, output_tokens: 200 },
+				},
+			},
+		]);
+		writeFileSync(path, content);
+		expect(await getContextLength(path)).toBe(5000);
+	});
+
+	it("should include cache tokens in calculation", async () => {
+		const path = join(TEST_DIR, "with-cache.jsonl");
+		const content = createTranscript([
+			{
+				timestamp: "2025-01-01T10:00:00Z",
+				message: {
+					role: "assistant",
+					usage: {
+						input_tokens: 1000,
+						cache_read_input_tokens: 2000,
+						cache_creation_input_tokens: 3000,
+						output_tokens: 100,
+					},
+				},
+			},
+		]);
+		writeFileSync(path, content);
+		expect(await getContextLength(path)).toBe(6000);
+	});
+
+	it("should skip sidechain entries", async () => {
+		const path = join(TEST_DIR, "with-sidechain.jsonl");
+		const content = createTranscript([
+			{
+				timestamp: "2025-01-01T10:00:00Z",
+				message: {
+					role: "assistant",
+					usage: { input_tokens: 1000, output_tokens: 100 },
+				},
+			},
+			{
+				timestamp: "2025-01-01T10:05:00Z",
+				isSidechain: true,
+				message: {
+					role: "assistant",
+					usage: { input_tokens: 99999, output_tokens: 200 },
+				},
+			},
+		]);
+		writeFileSync(path, content);
+		expect(await getContextLength(path)).toBe(1000);
+	});
+
+	it("should skip API error messages", async () => {
+		const path = join(TEST_DIR, "with-error.jsonl");
+		const content = createTranscript([
+			{
+				timestamp: "2025-01-01T10:00:00Z",
+				message: {
+					role: "assistant",
+					usage: { input_tokens: 1000, output_tokens: 100 },
+				},
+			},
+			{
+				timestamp: "2025-01-01T10:05:00Z",
+				isApiErrorMessage: true,
+				message: {
+					role: "assistant",
+					usage: { input_tokens: 99999, output_tokens: 200 },
+				},
+			},
+		]);
+		writeFileSync(path, content);
+		expect(await getContextLength(path)).toBe(1000);
+	});
+
+	it("should return 0 for non-existent file", async () => {
+		expect(await getContextLength("/non/existent/path.jsonl")).toBe(0);
+	});
+});
+
+describe("getContextData", () => {
+	it("should return zeros for non-existent file", async () => {
+		const result = await getContextData({
+			transcriptPath: "/non/existent/path.jsonl",
+			maxContextTokens: 200000,
+			autocompactBufferTokens: 45000,
+		});
+		expect(result).toEqual({ tokens: 0, percentage: 0 });
+	});
+
+	it("should calculate percentage correctly", async () => {
+		const path = join(TEST_DIR, "percentage.jsonl");
+		const content = createTranscript([
+			{
+				timestamp: "2025-01-01T10:00:00Z",
+				message: {
+					role: "assistant",
+					usage: { input_tokens: 100000, output_tokens: 100 },
+				},
+			},
+		]);
+		writeFileSync(path, content);
+
+		const result = await getContextData({
+			transcriptPath: path,
+			maxContextTokens: 200000,
+			autocompactBufferTokens: 45000,
+		});
+
+		expect(result.tokens).toBe(100000);
+		expect(result.percentage).toBe(50);
+	});
+
+	it("should add autocompact buffer when useUsableContextOnly is true", async () => {
+		const path = join(TEST_DIR, "usable.jsonl");
+		const content = createTranscript([
+			{
+				timestamp: "2025-01-01T10:00:00Z",
+				message: {
+					role: "assistant",
+					usage: { input_tokens: 50000, output_tokens: 100 },
+				},
+			},
+		]);
+		writeFileSync(path, content);
+
+		const result = await getContextData({
+			transcriptPath: path,
+			maxContextTokens: 200000,
+			autocompactBufferTokens: 45000,
+			useUsableContextOnly: true,
+		});
+
+		expect(result.tokens).toBe(95000);
+	});
+
+	it("should add overhead tokens", async () => {
+		const path = join(TEST_DIR, "overhead.jsonl");
+		const content = createTranscript([
+			{
+				timestamp: "2025-01-01T10:00:00Z",
+				message: {
+					role: "assistant",
+					usage: { input_tokens: 50000, output_tokens: 100 },
+				},
+			},
+		]);
+		writeFileSync(path, content);
+
+		const result = await getContextData({
+			transcriptPath: path,
+			maxContextTokens: 200000,
+			autocompactBufferTokens: 45000,
+			overheadTokens: 20000,
+		});
+
+		expect(result.tokens).toBe(70000);
+	});
+
+	it("should cap percentage at 100", async () => {
+		const path = join(TEST_DIR, "over100.jsonl");
+		const content = createTranscript([
+			{
+				timestamp: "2025-01-01T10:00:00Z",
+				message: {
+					role: "assistant",
+					usage: { input_tokens: 250000, output_tokens: 100 },
+				},
+			},
+		]);
+		writeFileSync(path, content);
+
+		const result = await getContextData({
+			transcriptPath: path,
+			maxContextTokens: 200000,
+			autocompactBufferTokens: 45000,
+		});
+
+		expect(result.percentage).toBe(100);
+	});
+});

package/src/config/claude-code-config/scripts/statusline/__tests__/formatters.test.ts

@@ -0,0 +1,108 @@
+import { describe, expect, it } from "bun:test";
+import {
+	formatCost,
+	formatDuration,
+	formatPath,
+	formatResetTime,
+	formatTokens,
+} from "../src/lib/formatters";
+
+describe("formatPath", () => {
+	it("should return basename for basename mode", () => {
+		expect(formatPath("/Users/test/project/src/file.ts", "basename")).toBe(
+			"file.ts",
+		);
+	});
+
+	it("should truncate long paths in truncated mode", () => {
+		const result = formatPath("/Users/test/deep/nested/path/file.ts");
+		expect(result).toContain("path");
+		expect(result).toContain("file.ts");
+	});
+
+	it("should handle Windows-style paths", () => {
+		expect(formatPath("C:\\Users\\test\\project\\file.ts", "basename")).toBe(
+			"file.ts",
+		);
+	});
+
+	it("should handle mixed separators", () => {
+		expect(formatPath("/Users/test\\mixed/path", "basename")).toBe("path");
+	});
+});
+
+describe("formatCost", () => {
+	it("should format with 1 decimal by default", () => {
+		expect(formatCost(1.234)).toBe("1.2");
+	});
+
+	it("should format as integer when specified", () => {
+		expect(formatCost(1.789, "integer")).toBe("2");
+	});
+
+	it("should format with 2 decimals when specified", () => {
+		expect(formatCost(1.789, "decimal2")).toBe("1.79");
+	});
+});
+
+describe("formatTokens", () => {
+	it("should format thousands with k suffix", () => {
+		const result = formatTokens(5000);
+		expect(result).toContain("5.0");
+		expect(result).toContain("k");
+	});
+
+	it("should format millions with m suffix", () => {
+		const result = formatTokens(1500000);
+		expect(result).toContain("1.5");
+		expect(result).toContain("m");
+	});
+
+	it("should return raw number for small values", () => {
+		const result = formatTokens(500);
+		expect(result).toContain("500");
+	});
+
+	it("should hide decimals when showDecimals is false", () => {
+		const result = formatTokens(5500, false);
+		expect(result).toContain("6");
+	});
+});
+
+describe("formatDuration", () => {
+	it("should format minutes only for short durations", () => {
+		expect(formatDuration(300000)).toBe("5m");
+	});
+
+	it("should format hours and minutes for long durations", () => {
+		expect(formatDuration(5400000)).toBe("1h 30m");
+	});
+
+	it("should handle zero duration", () => {
+		expect(formatDuration(0)).toBe("0m");
+	});
+});
+
+describe("formatResetTime", () => {
+	it("should return 'now' for past times", () => {
+		const pastTime = new Date(Date.now() - 60000).toISOString();
+		expect(formatResetTime(pastTime)).toBe("now");
+	});
+
+	it("should format future times with hours and minutes", () => {
+		const futureTime = new Date(Date.now() + 3700000).toISOString();
+		const result = formatResetTime(futureTime);
+		expect(result).toContain("h");
+		expect(result).toContain("m");
+	});
+
+	it("should format minutes only for short durations", () => {
+		const futureTime = new Date(Date.now() + 1800000).toISOString();
+		const result = formatResetTime(futureTime);
+		expect(result).toMatch(/^\d+m$/);
+	});
+
+	it("should return N/A for invalid dates", () => {
+		expect(formatResetTime("invalid-date")).toBe("N/A");
+	});
+});