@v1nvn/statusline 0.22.0

package/README.md

@@ -0,0 +1,92 @@
+# @v1nvn/statusline
+
+The CLI behind the statusline plugin: it composes the two settings keys
+that paint Claude Code's status line and agent panel, then reverts and checks
+them. Pure TypeScript — the bash runtime it points at ships inside the plugin
+(`plugins/statusline/runtime/`), not in this package.
+
+User-facing docs: [root README § statusline](../../README.md#statusline).
+
+## Quickstart
+
+The wizard is the way to configure — both surfaces, live previews, enter saves.
+
+Install once (the runtime the keys point at lives in the plugin cache):
+
+```sh
+claude plugin marketplace add v1nvn/agentic
+claude plugin install statusline@agentic
+```
+
+In Claude Code — type `/lab`, run the wizard it hands you (`!`
+runs it in your session with a real terminal):
+
+```
+! npx -y @v1nvn/statusline configure
+```
+
+In a terminal — same command, bare:
+
+```sh
+npx -y @v1nvn/statusline configure
+```
+
+`j/k` move · `h/l` switch design · `w` width · enter saves · `q` cancels.
+
+## Usage
+
+One CLI, both ways: `/lab` inside a session runs these same
+commands; `npx` runs them in a terminal.
+
+| Command | Does |
+|---|---|
+| `configure` | bare on a TTY: the wizard. With flags: strict — every layout item needs a variant flag or `--fallback=default\|existing`; `--dry-run` renders without writing; a foreign key needs `--force` |
+| `catalog` | one line per item, `*` marks the live variant |
+| `status` | one row per fact plus a verdict — exit 0 healthy, 1 needs action, every action row names its fix |
+| `restore` | both keys back to their pre-lab values from `backup.json`, then deletes the lab data — run it before uninstalling |
+
+```sh
+npx -y @v1nvn/statusline catalog
+npx -y @v1nvn/statusline configure --model block --bar gauge --fallback=default --dry-run   # preview, write nothing
+npx -y @v1nvn/statusline configure --model block --bar gauge --fallback=default             # the write
+npx -y @v1nvn/statusline status
+npx -y @v1nvn/statusline restore
+```
+
+## Develop
+
+```sh
+yarn workspace @v1nvn/statusline build    # vite → dist/, chmod +x the bin
+yarn workspace @v1nvn/statusline test     # vitest
+yarn lint && yarn typecheck                   # from the repo root
+```
+
+Node ≥ 22. One workspace dep: `@v1nvn/agentic-core` (usage/exit helpers).
+
+## Modules
+
+| File | Role |
+|---|---|
+| `src/cli.ts` | commander wiring — four subcommands, help text |
+| `src/index.ts` | bin entry — verb dispatch, exit codes, wizard TTY deps |
+| `src/configure.ts` | the writer — key composition, ours-matcher, JSON splice engine, backup write, dry-run render |
+| `src/resolve.ts` | runtime resolution + key parsing — the one resolution way |
+| `src/restore.ts` | revert decision tree + explicit-path cleanup |
+| `src/status.ts` | diagnostic rows + verdict |
+| `src/catalog.ts` | item listing, live variant starred |
+| `src/wizard.ts` · `src/wizard-tui.ts` | the terminal wizard — previews both surfaces, saves via `configure` |
+| `src/payloads.ts` · `src/demo-repo.ts` | preview plumbing — spawns the runtime with env + stdin; demo git repo for fixtures |
+| `assets/` | preview fixtures — `payloads/p1–p4.json` (main surface), `ticks/multi.json` (panel) |
+
+## Contracts
+
+- `configure` writes exactly two keys of `~/.claude/settings.json` — nothing
+  else on disk except `backup.json` and `captures/`.
+- The key value is one inline shell command: resolver statement first, env
+  assignments hugging `bash` last; statement order is pinned by golden tests.
+- One resolution way: the newest-plugin-cache glob — `installed_plugins.json`
+  is read nowhere.
+- One splice home: the settings.json span primitives live in `configure.ts`;
+  `restore` imports them.
+- `restore` never resolves the runtime — it works uninstalled.
+- Deletion is explicit paths only — no globs, no recursive rm.

package/assets/payloads/p1.json

@@ -0,0 +1,92 @@
+{
+  "session_id": "a1b2c3d4demo",
+  "session_name": "statusline-makeover",
+  "transcript_path": "/Users/vineet/.claude/projects/demo/x.jsonl",
+  "version": "2.1.275",
+  "cwd": "/demo/atlas-web",
+  "model": {
+    "id": "claude-opus-5",
+    "display_name": "Opus"
+  },
+  "workspace": {
+    "current_dir": "/demo/atlas-web",
+    "project_dir": "/demo/atlas-web",
+    "added_dirs": [],
+    "repo": {
+      "host": "github.com",
+      "owner": "vineet",
+      "name": "atlas-web"
+    }
+  },
+  "output_style": {
+    "name": "default"
+  },
+  "effort": {
+    "level": "high"
+  },
+  "thinking": {
+    "enabled": true
+  },
+  "fast_mode": false,
+  "vim": {
+    "mode": "NORMAL"
+  },
+  "pr": {
+    "number": 4821,
+    "url": "https://github.com/vineet/atlas-web/pull/4821",
+    "review_state": "pending"
+  },
+  "cost": {
+    "total_cost_usd": 3.87,
+    "total_duration_ms": 4925000,
+    "total_api_duration_ms": 742000,
+    "total_lines_added": 156,
+    "total_lines_removed": 23
+  },
+  "context_window": {
+    "total_input_tokens": 116800,
+    "total_output_tokens": 8400,
+    "context_window_size": 200000,
+    "used_percentage": 58.4,
+    "remaining_percentage": 41.6,
+    "current_usage": {
+      "input_tokens": 8200,
+      "output_tokens": 8400,
+      "cache_creation_input_tokens": 18400,
+      "cache_read_input_tokens": 90200
+    }
+  },
+  "exceeds_200k_tokens": false,
+  "prompt_cache": {
+    "warm": true,
+    "caching_observed": true,
+    "ttl": "1h",
+    "expires_at": 1788869062,
+    "requests": 214,
+    "misses": 3,
+    "expected_rebuilds": 1,
+    "hit_ratio": 0.94,
+    "cache_write_tokens": 352000,
+    "miss_recache_tokens": 310200,
+    "last_miss_at": 1788865162,
+    "last_miss_cause": {
+      "causes": ["tools_changed"],
+      "tools_added": 2,
+      "tools_removed": 0
+    }
+  },
+  "rate_limits": {
+    "five_hour": {
+      "used_percentage": 23.5,
+      "resets_at": 1788880972
+    },
+    "seven_day": {
+      "used_percentage": 41.2,
+      "resets_at": 1789385542
+    },
+    "spend_limit": {
+      "used_percentage": 62.8,
+      "resets_at": 1789817542
+    }
+  }
+}

package/assets/payloads/p2.json

@@ -0,0 +1,62 @@
+{
+  "session_id": "e5f6demo02",
+  "cwd": "/demo/atlas-web",
+  "model": {
+    "id": "claude-sonnet-5",
+    "display_name": "Sonnet"
+  },
+  "workspace": {
+    "current_dir": "/demo/atlas-web",
+    "project_dir": "/demo/atlas-web"
+  },
+  "version": "2.1.275",
+  "output_style": {
+    "name": "default"
+  },
+  "effort": {
+    "level": "low"
+  },
+  "cost": {
+    "total_cost_usd": 0.42,
+    "total_duration_ms": 412000,
+    "total_api_duration_ms": 96000,
+    "total_lines_added": 12,
+    "total_lines_removed": 0
+  },
+  "context_window": {
+    "total_input_tokens": 22400,
+    "total_output_tokens": 1800,
+    "context_window_size": 200000,
+    "used_percentage": 11.2,
+    "remaining_percentage": 88.8,
+    "current_usage": {
+      "input_tokens": 4200,
+      "output_tokens": 1800,
+      "cache_creation_input_tokens": 6200,
+      "cache_read_input_tokens": 12000
+    }
+  },
+  "prompt_cache": {
+    "warm": true,
+    "caching_observed": true,
+    "ttl": "5m",
+    "expires_at": 1788869542,
+    "requests": 9,
+    "misses": 0,
+    "expected_rebuilds": 0,
+    "hit_ratio": 0.99,
+    "cache_write_tokens": 26100,
+    "miss_recache_tokens": 0,
+    "last_miss_at": 1788865642
+  },
+  "rate_limits": {
+    "five_hour": {
+      "used_percentage": 6.1,
+      "resets_at": 1788883312
+    },
+    "seven_day": {
+      "used_percentage": 8.4,
+      "resets_at": 1789437142
+    }
+  }
+}

package/assets/payloads/p3.json

@@ -0,0 +1,69 @@
+{
+  "session_id": "c9d0demo03",
+  "cwd": "/demo/atlas-web",
+  "model": {
+    "id": "claude-opus-5",
+    "display_name": "Opus"
+  },
+  "workspace": {
+    "current_dir": "/demo/atlas-web",
+    "project_dir": "/demo/atlas-web"
+  },
+  "version": "2.1.275",
+  "output_style": {
+    "name": "default"
+  },
+  "effort": {
+    "level": "high"
+  },
+  "thinking": {
+    "enabled": true
+  },
+  "cost": {
+    "total_cost_usd": 8.91,
+    "total_duration_ms": 6110000,
+    "total_api_duration_ms": 1030000,
+    "total_lines_added": 412,
+    "total_lines_removed": 87
+  },
+  "context_window": {
+    "total_input_tokens": 190800,
+    "total_output_tokens": 22400,
+    "context_window_size": 200000,
+    "used_percentage": 95.4,
+    "remaining_percentage": 4.6,
+    "current_usage": {
+      "input_tokens": 19800,
+      "output_tokens": 22400,
+      "cache_creation_input_tokens": 22000,
+      "cache_read_input_tokens": 149000
+    }
+  },
+  "exceeds_200k_tokens": false,
+  "prompt_cache": {
+    "warm": false,
+    "caching_observed": true,
+    "ttl": "1h",
+    "expires_at": 1788867132,
+    "requests": 312,
+    "misses": 9,
+    "expected_rebuilds": 2,
+    "hit_ratio": 0.71,
+    "cache_write_tokens": 412000,
+    "miss_recache_tokens": 399100,
+    "last_miss_at": 1788867117,
+    "last_miss_cause": {
+      "causes": ["ttl_expired_1h"]
+    }
+  },
+  "rate_limits": {
+    "five_hour": {
+      "used_percentage": 88.4,
+      "resets_at": 1788869232
+    },
+    "seven_day": {
+      "used_percentage": 63.1,
+      "resets_at": 1789157142
+    }
+  }
+}

package/assets/payloads/p4.json

@@ -0,0 +1,86 @@
+{
+  "session_id": "b7a8demo04",
+  "session_name": "auth-refactor",
+  "cwd": "/demo/atlas-web",
+  "model": {
+    "id": "claude-opus-5",
+    "display_name": "Opus"
+  },
+  "workspace": {
+    "current_dir": "/demo/atlas-web",
+    "project_dir": "/demo/atlas-web",
+    "git_worktree": "fix-auth"
+  },
+  "version": "2.1.275",
+  "output_style": {
+    "name": "explanatory"
+  },
+  "effort": {
+    "level": "medium"
+  },
+  "vim": {
+    "mode": "INSERT"
+  },
+  "agent": {
+    "name": "code-reviewer"
+  },
+  "pr": {
+    "number": 5102,
+    "url": "https://github.com/vineet/atlas-web/pull/5102",
+    "review_state": "approved"
+  },
+  "worktree": {
+    "name": "fix-auth",
+    "path": "/demo/atlas-web-wt",
+    "branch": "worktree-fix-auth",
+    "original_cwd": "/demo/atlas-web",
+    "original_branch": "main"
+  },
+  "cost": {
+    "total_cost_usd": 12.4,
+    "total_duration_ms": 8420000,
+    "total_api_duration_ms": 1490000,
+    "total_lines_added": 1240,
+    "total_lines_removed": 312
+  },
+  "context_window": {
+    "total_input_tokens": 148400,
+    "total_output_tokens": 14100,
+    "context_window_size": 200000,
+    "used_percentage": 74.2,
+    "remaining_percentage": 25.8,
+    "current_usage": {
+      "input_tokens": 16200,
+      "output_tokens": 14100,
+      "cache_creation_input_tokens": 30200,
+      "cache_read_input_tokens": 102000
+    }
+  },
+  "prompt_cache": {
+    "warm": true,
+    "caching_observed": true,
+    "ttl": "1h",
+    "expires_at": 1788867742,
+    "requests": 401,
+    "misses": 5,
+    "expected_rebuilds": 1,
+    "hit_ratio": 0.88,
+    "cache_write_tokens": 388000,
+    "miss_recache_tokens": 341000,
+    "last_miss_at": 1788863842
+  },
+  "rate_limits": {
+    "five_hour": {
+      "used_percentage": 52.7,
+      "resets_at": 1788882142
+    },
+    "seven_day": {
+      "used_percentage": 44.0,
+      "resets_at": 1789407142
+    },
+    "spend_limit": {
+      "used_percentage": 35.2,
+      "resets_at": 1788988933
+    }
+  }
+}

package/assets/ticks/multi.json

@@ -0,0 +1,70 @@
+{
+  "columns": 200,
+  "tasks": [
+    {
+      "id": "row-explore",
+      "label": "Explore",
+      "name": "explore",
+      "description": "Reading unit 2's landed pattern",
+      "model": "Sonnet [1m]",
+      "effort": "high",
+      "contextWindowSize": 200000,
+      "tokenCount": 142300,
+      "startTime": 1788862735
+    },
+    {
+      "id": "row-tests",
+      "label": "Tests",
+      "name": "test-writer",
+      "description": "Golden capture for the subagent rows",
+      "model": "Opus",
+      "effort": "medium",
+      "contextWindowSize": 180000,
+      "tokenCount": 9000,
+      "startTime": 1788869875000
+    },
+    {
+      "id": "row-review",
+      "label": "Review",
+      "name": "reviewer",
+      "description": "",
+      "model": "Haiku",
+      "effort": "low",
+      "contextWindowSize": 0,
+      "tokenCount": 0,
+      "startTime": 1788869990
+    },
+    {
+      "id": "row-fork",
+      "label": "",
+      "name": "Fork",
+      "description": "Name stands in when label is empty",
+      "model": "Sonnet",
+      "effort": "",
+      "contextWindowSize": 1000000,
+      "tokenCount": 950000,
+      "startTime": 0
+    },
+    {
+      "id": "row-idle",
+      "label": "Idle",
+      "name": "idle",
+      "description": "Idle",
+      "model": "",
+      "effort": "",
+      "contextWindowSize": 0,
+      "tokenCount": 0,
+      "startTime": 1788870001
+    },
+    {
+      "label": "NoId",
+      "name": "ghost",
+      "description": "Row without an id renders no line",
+      "model": "Opus",
+      "effort": "high",
+      "contextWindowSize": 200000,
+      "tokenCount": 1000,
+      "startTime": 1788869950
+    }
+  ]
+}