@superbased/observer 1.34.0-rc.8 → 1.34.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +33 -4
  2. package/package.json +6 -6
package/README.md CHANGED
@@ -419,6 +419,15 @@ or written. A persistent banner marks demo state, and one click
419
419
  clears it again. The fastest way to evaluate the dashboard before
420
420
  routing any real traffic.
421
421
 
422
+ **Time windows.** Every page follows one window (1h / 12h / 1d / 7d /
423
+ 14d / 30d / 90d / 1y / all, or Custom: a picker with one-click presets
424
+ such as Today or Last week, a month calendar and hour / minute
425
+ selects). Time-series charts bucket by that window in your browser's
426
+ time zone - 5 minutes up to 3 hours, hourly up to 7 days, daily up to
427
+ 180 days, weekly beyond - and each chart has an Auto / 5 min / Hour /
428
+ Day / Week control; empty buckets are drawn as zero. A density toggle
429
+ switches tables between comfortable and compact.
430
+
422
431
  ### Overview tab
423
432
 
424
433
  <p align="center">
@@ -429,8 +438,9 @@ High-level snapshot of the selected window:
429
438
 
430
439
  - **KPI tiles**: Sessions count, API turns (proxy-captured), Token
431
440
  rows (JSONL-recovered), Failures (24h)
432
- - **Cost over time** chart — daily token volume, split into the four
433
- billable buckets (net input / cache read / cache write / output)
441
+ - **Cost over time** chart — token volume per time bucket (following
442
+ the window), split into the four billable buckets (net input / cache
443
+ read / cache write / output)
434
444
  - **Actions over time** chart — total actions vs failures
435
445
  - **Top models (by tokens)** chart — top-8 models stacked by net
436
446
  input / cache read / output
@@ -456,6 +466,12 @@ write their own per-turn cost into `estimated_cost_usd`; the engine
456
466
  uses those as-is when present. See
457
467
  `docs/pricing-reference.md` for the rate sheet.
458
468
 
469
+ Costs are stamped when a turn is captured. When a price changes or is
470
+ corrected later, `observer reprice` (a dry run unless `--apply`,
471
+ revertible with `--revert`) or Settings -> Pricing re-prices stored
472
+ turns at the rate in force when each one ran; a cost the tool itself
473
+ reported is never overwritten.
474
+
459
475
  Hover any column header for tooltip; click for the full definition
460
476
  in the help drawer.
461
477
 
@@ -488,8 +504,10 @@ One row per AI-coding session. Each session has a stable ID, a tool
488
504
  opencode / openclaw / pi / antigravity / gemini-cli / hermes /
489
505
  kilo-code / kilo-code-cli), a working-directory project, action
490
506
  count, sub-agent action count (when the session spawned sub-agents via
491
- the `Agent` tool), per-session **Tokens** and **Cost** columns, and —
492
- if `observer score` has run — quality / errors / redundancy ratios. The `~` suffix on Cost flags rows whose pricing
507
+ the `Agent` tool), per-session **Tokens** and **Cost** columns, and
508
+ quality / errors / redundancy ratios (filled in by the daemon's session
509
+ scorer, `[intelligence.scoring]`, on by default, once a session has
510
+ been idle for 30 minutes). The `~` suffix on Cost flags rows whose pricing
493
511
  was tier-fallback rather than billing-grade ("accurate" reliability).
494
512
 
495
513
  Click a row to open the session-detail panel:
@@ -521,6 +539,13 @@ Click a row to open the session-detail panel:
521
539
  browser responsive on multi-thousand-message sessions. Requires
522
540
  `observer backfill --message-id` on first upgrade for historical
523
541
  sessions to surface their parent message ids.
542
+ - **Gauges, quality, lines and commits** — a context-window gauge (and,
543
+ for proxied subscription sessions, the 5-hour / weekly limit gauge), a
544
+ session quality card with the score's parts, AI lines of code split
545
+ into code and comments, and a Commits card listing the git commits the
546
+ session's edits reached and whether it owns each one (the session with
547
+ the most AI code lines in it; merges, teammates' commits and commits
548
+ no AI edit reached have no owner).
524
549
 
525
550
  ### Actions tab
526
551
 
@@ -1394,6 +1419,10 @@ Every command supports `--help` for the full surface.
1394
1419
  | `observer backfill --cache-tier` | Re-walk JSONL to populate `cache_creation_1h_tokens` (added by migration 008) on pre-migration rows. Run once after upgrading to v1.4.16+ to correct historical 1h-tier cache writes that were silently billed at the cheaper 5m rate. |
1395
1420
  | `observer backfill --message-id` | Re-walk JSONL to populate `message_id` on `actions` and `token_usage` (added by migration 012). Required by the per-message timeline view in the Sessions modal. |
1396
1421
  | `observer backfill --all` | Run every supported backfill in one invocation. Idempotent — safe to re-run. |
1422
+ | `observer reprice` | Re-price stored costs at the rate in force when each turn ran. Dry run by default; `--apply` writes, `--revert <run>` undoes a run, `--list` shows history, `--since` / `--until` / `--model` narrow it. Never overwrites a tool-reported cost. |
1423
+ | `observer project <id\|root>` | Per-project spend, AI lines (code vs comments), commits and prompt-to-commit status - the dashboard's Projects detail in the terminal. |
1424
+ | `observer shell-wrap status\|preview\|enable\|disable` | Opt-in command wrapping: PATH shims so typing `claude` runs `observer claude` (per tool, exact preview, byte-for-byte undo). |
1425
+ | `observer ide <id> [project-dir]` | Launch an IDE or desktop app the way the dashboard does and report whether its AI traffic can be routed through the proxy. |
1397
1426
  | `observer profile list\|show\|assign\|create\|delete\|set` | Compression profiles: inspect built-ins, reassign per traffic class or per tool (`assign tool:cline codex-safe`), create/edit custom profiles. Edits apply to new sessions hot. |
1398
1427
  | `observer config set <key> <value>` | Dotted-key config setter (`compression.conversation.enabled true`). `--project <root>` writes a per-repo override file instead. |
1399
1428
  | `observer advise` | Prescriptive cost/quality suggestions from captured activity (the Suggestions tab, in the CLI) |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@superbased/observer",
3
- "version": "1.34.0-rc.8",
3
+ "version": "1.34.0",
4
4
  "description": "Claude Code cost tracking, Cursor token usage, Codex spend — AI coding agent observability across 40 adapters, proxy-accurate token counts and cost.",
5
5
  "keywords": [
6
6
  "ai",
@@ -42,11 +42,11 @@
42
42
  "LICENSE"
43
43
  ],
44
44
  "optionalDependencies": {
45
- "@superbased/observer-linux-x64": "1.34.0-rc.8",
46
- "@superbased/observer-linux-arm64": "1.34.0-rc.8",
47
- "@superbased/observer-darwin-x64": "1.34.0-rc.8",
48
- "@superbased/observer-darwin-arm64": "1.34.0-rc.8",
49
- "@superbased/observer-win32-x64": "1.34.0-rc.8"
45
+ "@superbased/observer-linux-x64": "1.34.0",
46
+ "@superbased/observer-linux-arm64": "1.34.0",
47
+ "@superbased/observer-darwin-x64": "1.34.0",
48
+ "@superbased/observer-darwin-arm64": "1.34.0",
49
+ "@superbased/observer-win32-x64": "1.34.0"
50
50
  },
51
51
  "scripts": {
52
52
  "test": "node bin/observer.js --version"