ccgauge 1.0.3 → 1.0.5

package/.next/standalone/node_modules/semver/internal/re.js

@@ -0,0 +1,223 @@
+'use strict'
+
+const {
+  MAX_SAFE_COMPONENT_LENGTH,
+  MAX_SAFE_BUILD_LENGTH,
+  MAX_LENGTH,
+} = require('./constants')
+const debug = require('./debug')
+exports = module.exports = {}
+
+// The actual regexps go on exports.re
+const re = exports.re = []
+const safeRe = exports.safeRe = []
+const src = exports.src = []
+const safeSrc = exports.safeSrc = []
+const t = exports.t = {}
+let R = 0
+
+const LETTERDASHNUMBER = '[a-zA-Z0-9-]'
+
+// Replace some greedy regex tokens to prevent regex dos issues. These regex are
+// used internally via the safeRe object since all inputs in this library get
+// normalized first to trim and collapse all extra whitespace. The original
+// regexes are exported for userland consumption and lower level usage. A
+// future breaking change could export the safer regex only with a note that
+// all input should have extra whitespace removed.
+const safeRegexReplacements = [
+  ['\\s', 1],
+  ['\\d', MAX_LENGTH],
+  [LETTERDASHNUMBER, MAX_SAFE_BUILD_LENGTH],
+]
+
+const makeSafeRegex = (value) => {
+  for (const [token, max] of safeRegexReplacements) {
+    value = value
+      .split(`${token}*`).join(`${token}{0,${max}}`)
+      .split(`${token}+`).join(`${token}{1,${max}}`)
+  }
+  return value
+}
+
+const createToken = (name, value, isGlobal) => {
+  const safe = makeSafeRegex(value)
+  const index = R++
+  debug(name, index, value)
+  t[name] = index
+  src[index] = value
+  safeSrc[index] = safe
+  re[index] = new RegExp(value, isGlobal ? 'g' : undefined)
+  safeRe[index] = new RegExp(safe, isGlobal ? 'g' : undefined)
+}
+
+// The following Regular Expressions can be used for tokenizing,
+// validating, and parsing SemVer version strings.
+
+// ## Numeric Identifier
+// A single `0`, or a non-zero digit followed by zero or more digits.
+
+createToken('NUMERICIDENTIFIER', '0|[1-9]\\d*')
+createToken('NUMERICIDENTIFIERLOOSE', '\\d+')
+
+// ## Non-numeric Identifier
+// Zero or more digits, followed by a letter or hyphen, and then zero or
+// more letters, digits, or hyphens.
+
+createToken('NONNUMERICIDENTIFIER', `\\d*[a-zA-Z-]${LETTERDASHNUMBER}*`)
+
+// ## Main Version
+// Three dot-separated numeric identifiers.
+
+createToken('MAINVERSION', `(${src[t.NUMERICIDENTIFIER]})\\.` +
+                   `(${src[t.NUMERICIDENTIFIER]})\\.` +
+                   `(${src[t.NUMERICIDENTIFIER]})`)
+
+createToken('MAINVERSIONLOOSE', `(${src[t.NUMERICIDENTIFIERLOOSE]})\\.` +
+                        `(${src[t.NUMERICIDENTIFIERLOOSE]})\\.` +
+                        `(${src[t.NUMERICIDENTIFIERLOOSE]})`)
+
+// ## Pre-release Version Identifier
+// A numeric identifier, or a non-numeric identifier.
+// Non-numeric identifiers include numeric identifiers but can be longer.
+// Therefore non-numeric identifiers must go first.
+
+createToken('PRERELEASEIDENTIFIER', `(?:${src[t.NONNUMERICIDENTIFIER]
+}|${src[t.NUMERICIDENTIFIER]})`)
+
+createToken('PRERELEASEIDENTIFIERLOOSE', `(?:${src[t.NONNUMERICIDENTIFIER]
+}|${src[t.NUMERICIDENTIFIERLOOSE]})`)
+
+// ## Pre-release Version
+// Hyphen, followed by one or more dot-separated pre-release version
+// identifiers.
+
+createToken('PRERELEASE', `(?:-(${src[t.PRERELEASEIDENTIFIER]
+}(?:\\.${src[t.PRERELEASEIDENTIFIER]})*))`)
+
+createToken('PRERELEASELOOSE', `(?:-?(${src[t.PRERELEASEIDENTIFIERLOOSE]
+}(?:\\.${src[t.PRERELEASEIDENTIFIERLOOSE]})*))`)
+
+// ## Build Metadata Identifier
+// Any combination of digits, letters, or hyphens.
+
+createToken('BUILDIDENTIFIER', `${LETTERDASHNUMBER}+`)
+
+// ## Build Metadata
+// Plus sign, followed by one or more period-separated build metadata
+// identifiers.
+
+createToken('BUILD', `(?:\\+(${src[t.BUILDIDENTIFIER]
+}(?:\\.${src[t.BUILDIDENTIFIER]})*))`)
+
+// ## Full Version String
+// A main version, followed optionally by a pre-release version and
+// build metadata.
+
+// Note that the only major, minor, patch, and pre-release sections of
+// the version string are capturing groups.  The build metadata is not a
+// capturing group, because it should not ever be used in version
+// comparison.
+
+createToken('FULLPLAIN', `v?${src[t.MAINVERSION]
+}${src[t.PRERELEASE]}?${
+  src[t.BUILD]}?`)
+
+createToken('FULL', `^${src[t.FULLPLAIN]}$`)
+
+// like full, but allows v1.2.3 and =1.2.3, which people do sometimes.
+// also, 1.0.0alpha1 (prerelease without the hyphen) which is pretty
+// common in the npm registry.
+createToken('LOOSEPLAIN', `[v=\\s]*${src[t.MAINVERSIONLOOSE]
+}${src[t.PRERELEASELOOSE]}?${
+  src[t.BUILD]}?`)
+
+createToken('LOOSE', `^${src[t.LOOSEPLAIN]}$`)
+
+createToken('GTLT', '((?:<|>)?=?)')
+
+// Something like "2.*" or "1.2.x".
+// Note that "x.x" is a valid xRange identifer, meaning "any version"
+// Only the first item is strictly required.
+createToken('XRANGEIDENTIFIERLOOSE', `${src[t.NUMERICIDENTIFIERLOOSE]}|x|X|\\*`)
+createToken('XRANGEIDENTIFIER', `${src[t.NUMERICIDENTIFIER]}|x|X|\\*`)
+
+createToken('XRANGEPLAIN', `[v=\\s]*(${src[t.XRANGEIDENTIFIER]})` +
+                   `(?:\\.(${src[t.XRANGEIDENTIFIER]})` +
+                   `(?:\\.(${src[t.XRANGEIDENTIFIER]})` +
+                   `(?:${src[t.PRERELEASE]})?${
+                     src[t.BUILD]}?` +
+                   `)?)?`)
+
+createToken('XRANGEPLAINLOOSE', `[v=\\s]*(${src[t.XRANGEIDENTIFIERLOOSE]})` +
+                        `(?:\\.(${src[t.XRANGEIDENTIFIERLOOSE]})` +
+                        `(?:\\.(${src[t.XRANGEIDENTIFIERLOOSE]})` +
+                        `(?:${src[t.PRERELEASELOOSE]})?${
+                          src[t.BUILD]}?` +
+                        `)?)?`)
+
+createToken('XRANGE', `^${src[t.GTLT]}\\s*${src[t.XRANGEPLAIN]}$`)
+createToken('XRANGELOOSE', `^${src[t.GTLT]}\\s*${src[t.XRANGEPLAINLOOSE]}$`)
+
+// Coercion.
+// Extract anything that could conceivably be a part of a valid semver
+createToken('COERCEPLAIN', `${'(^|[^\\d])' +
+              '(\\d{1,'}${MAX_SAFE_COMPONENT_LENGTH}})` +
+              `(?:\\.(\\d{1,${MAX_SAFE_COMPONENT_LENGTH}}))?` +
+              `(?:\\.(\\d{1,${MAX_SAFE_COMPONENT_LENGTH}}))?`)
+createToken('COERCE', `${src[t.COERCEPLAIN]}(?:$|[^\\d])`)
+createToken('COERCEFULL', src[t.COERCEPLAIN] +
+              `(?:${src[t.PRERELEASE]})?` +
+              `(?:${src[t.BUILD]})?` +
+              `(?:$|[^\\d])`)
+createToken('COERCERTL', src[t.COERCE], true)
+createToken('COERCERTLFULL', src[t.COERCEFULL], true)
+
+// Tilde ranges.
+// Meaning is "reasonably at or greater than"
+createToken('LONETILDE', '(?:~>?)')
+
+createToken('TILDETRIM', `(\\s*)${src[t.LONETILDE]}\\s+`, true)
+exports.tildeTrimReplace = '$1~'
+
+createToken('TILDE', `^${src[t.LONETILDE]}${src[t.XRANGEPLAIN]}$`)
+createToken('TILDELOOSE', `^${src[t.LONETILDE]}${src[t.XRANGEPLAINLOOSE]}$`)
+
+// Caret ranges.
+// Meaning is "at least and backwards compatible with"
+createToken('LONECARET', '(?:\\^)')
+
+createToken('CARETTRIM', `(\\s*)${src[t.LONECARET]}\\s+`, true)
+exports.caretTrimReplace = '$1^'
+
+createToken('CARET', `^${src[t.LONECARET]}${src[t.XRANGEPLAIN]}$`)
+createToken('CARETLOOSE', `^${src[t.LONECARET]}${src[t.XRANGEPLAINLOOSE]}$`)
+
+// A simple gt/lt/eq thing, or just "" to indicate "any version"
+createToken('COMPARATORLOOSE', `^${src[t.GTLT]}\\s*(${src[t.LOOSEPLAIN]})$|^$`)
+createToken('COMPARATOR', `^${src[t.GTLT]}\\s*(${src[t.FULLPLAIN]})$|^$`)
+
+// An expression to strip any whitespace between the gtlt and the thing
+// it modifies, so that `> 1.2.3` ==> `>1.2.3`
+createToken('COMPARATORTRIM', `(\\s*)${src[t.GTLT]
+}\\s*(${src[t.LOOSEPLAIN]}|${src[t.XRANGEPLAIN]})`, true)
+exports.comparatorTrimReplace = '$1$2$3'
+
+// Something like `1.2.3 - 1.2.4`
+// Note that these all use the loose form, because they'll be
+// checked against either the strict or loose comparator form
+// later.
+createToken('HYPHENRANGE', `^\\s*(${src[t.XRANGEPLAIN]})` +
+                   `\\s+-\\s+` +
+                   `(${src[t.XRANGEPLAIN]})` +
+                   `\\s*$`)
+
+createToken('HYPHENRANGELOOSE', `^\\s*(${src[t.XRANGEPLAINLOOSE]})` +
+                        `\\s+-\\s+` +
+                        `(${src[t.XRANGEPLAINLOOSE]})` +
+                        `\\s*$`)
+
+// Star ranges basically just allow anything at all.
+createToken('STAR', '(<|>)?=?\\s*\\*')
+// >=0.0.0 is like a star
+createToken('GTE0', '^\\s*>=\\s*0\\.0\\.0\\s*$')
+createToken('GTE0PRE', '^\\s*>=\\s*0\\.0\\.0-0\\s*$')

package/.next/standalone/node_modules/semver/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "semver",
+  "version": "7.7.4",
+  "description": "The semantic version parser used by npm.",
+  "main": "index.js",
+  "scripts": {
+    "test": "tap",
+    "snap": "tap",
+    "lint": "npm run eslint",
+    "postlint": "template-oss-check",
+    "lintfix": "npm run eslint -- --fix",
+    "posttest": "npm run lint",
+    "template-oss-apply": "template-oss-apply --force",
+    "eslint": "eslint \"**/*.{js,cjs,ts,mjs,jsx,tsx}\""
+  },
+  "devDependencies": {
+    "@npmcli/eslint-config": "^6.0.0",
+    "@npmcli/template-oss": "4.29.0",
+    "benchmark": "^2.1.4",
+    "tap": "^16.0.0"
+  },
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/npm/node-semver.git"
+  },
+  "bin": {
+    "semver": "bin/semver.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "classes/",
+    "functions/",
+    "internal/",
+    "ranges/",
+    "index.js",
+    "preload.js",
+    "range.bnf"
+  ],
+  "tap": {
+    "timeout": 30,
+    "coverage-map": "map.js",
+    "nyc-arg": [
+      "--exclude",
+      "tap-snapshots/**"
+    ]
+  },
+  "engines": {
+    "node": ">=10"
+  },
+  "author": "GitHub Inc.",
+  "templateOSS": {
+    "//@npmcli/template-oss": "This file is partially managed by @npmcli/template-oss. Edits may be overwritten.",
+    "version": "4.29.0",
+    "engines": ">=10",
+    "distPaths": [
+      "classes/",
+      "functions/",
+      "internal/",
+      "ranges/",
+      "index.js",
+      "preload.js",
+      "range.bnf"
+    ],
+    "allowPaths": [
+      "/classes/",
+      "/functions/",
+      "/internal/",
+      "/ranges/",
+      "/index.js",
+      "/preload.js",
+      "/range.bnf",
+      "/benchmarks"
+    ],
+    "publish": "true"
+  }
+}

package/.next/standalone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccgauge",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Local web dashboard for Claude Code and OpenAI Codex CLI token usage and cost",
   "keywords": [
     "claude",
@@ -64,10 +64,16 @@
     "start:next": "next start -p 3737",
     "lint": "eslint .",
     "typecheck": "tsc --noEmit",
-    "test": "node --experimental-strip-types --no-warnings scripts/test-codex-parser.mjs",
+    "test": "node --experimental-strip-types --no-warnings scripts/test-codex-parser.mjs && node --experimental-strip-types --no-warnings scripts/test-turns.mjs && node --experimental-strip-types --no-warnings scripts/test-source-merge.mjs && node --experimental-strip-types --no-warnings scripts/test-cost-from-usage.mjs && node --experimental-strip-types --no-warnings scripts/test-range.mjs && node scripts/check-parser-versions.mjs && node scripts/check-readme-images.mjs",
     "test:mcp": "node scripts/test-mcp-server.mjs",
     "clean": "node -e \"for (const p of ['.next','node_modules','tsconfig.tsbuildinfo']) require('node:fs').rmSync(p,{recursive:true,force:true})\"",
     "screenshots": "node scripts/screenshots.mjs",
+    "site:dev": "cd site && astro dev --port 4321",
+    "site:build": "cd site && astro build",
+    "site:preview": "cd site && astro preview --port 4322",
+    "site:check": "cd site && astro check",
+    "site:gen:placeholders": "node site/scripts/gen-placeholders.mjs",
+    "site:clean": "node -e \"for (const p of ['site/dist','site/.astro','site/node_modules']) require('node:fs').rmSync(p,{recursive:true,force:true})\"",
     "prepack": "pnpm build"
   },
   "dependencies": {
@@ -77,10 +83,15 @@
     "open": "^10.1.0"
   },
   "devDependencies": {
+    "@astrojs/check": "^0.9.4",
+    "@astrojs/tailwind": "^5.1.4",
     "@eslint/eslintrc": "^3.3.5",
+    "@fontsource-variable/geist": "^5.1.1",
+    "@fontsource-variable/geist-mono": "^5.1.1",
     "@types/node": "^22.10.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "astro": "^4.16.18",
     "autoprefixer": "^10.4.20",
     "clsx": "^2.1.1",
     "date-fns": "^4.1.0",

package/.next/standalone/public/favicon.svg

@@ -1,7 +1,21 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
-  <rect width="64" height="64" rx="14" fill="#4F46E5"/>
-  <path d="M14 41 A18 18 0 0 1 50 41" stroke="#fff" stroke-opacity="0.32" stroke-width="4.5" stroke-linecap="round"/>
-  <path d="M14 41 A18 18 0 0 1 43.2 25.4" stroke="#fff" stroke-width="4.5" stroke-linecap="round"/>
-  <line x1="32" y1="41" x2="42" y2="27" stroke="#fff" stroke-width="2.5" stroke-linecap="round"/>
-  <circle cx="32" cy="41" r="3" fill="#fff"/>
+  <title>ccgauge</title>
+  <rect x="3" y="3" width="58" height="58" rx="16" fill="#6366F1"/>
+  <rect x="3.75" y="3.75" width="56.5" height="56.5" rx="15.25" stroke="#FFFFFF" stroke-opacity="0.18" stroke-width="1.5"/>
+  <path d="M15 39.5 A17 17 0 0 1 49 39.5" stroke="#FFFFFF" stroke-opacity="0.24" stroke-width="5" stroke-linecap="round"/>
+  <path d="M20.8 39.5 A11.2 11.2 0 0 1 43.2 39.5" stroke="#FFFFFF" stroke-opacity="0.2" stroke-width="1.8" stroke-linecap="round"/>
+  <path d="M15 39.5 A17 17 0 0 1 42.8 26" stroke="#FFFFFF" stroke-width="5" stroke-linecap="round"/>
+  <g stroke="#FFFFFF" stroke-linecap="round" stroke-width="2" stroke-opacity="0.54">
+    <path d="M18.1 34.2 L15 32.4"/>
+    <path d="M24 28.5 L22.3 25.5"/>
+    <path d="M32 26.2 L32 22.8"/>
+    <path d="M40 28.5 L41.7 25.5"/>
+    <path d="M45.9 34.2 L49 32.4"/>
+  </g>
+  <path d="M32 39.5 L42.8 26" stroke="#FFFFFF" stroke-width="3.4" stroke-linecap="round"/>
+  <circle cx="32" cy="39.5" r="4.8" fill="#FFFFFF"/>
+  <circle cx="32" cy="39.5" r="2" fill="#4F46E5"/>
+  <rect x="17" y="46" width="7" height="5" rx="2" fill="#34D399"/>
+  <rect x="28.5" y="43" width="7" height="8" rx="2" fill="#FBBF24"/>
+  <rect x="40" y="45" width="7" height="6" rx="2" fill="#93C5FD"/>
 </svg>

package/CHANGELOG.md

@@ -5,6 +5,291 @@ All notable changes to **ccgauge** are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.5] — 2026-05-19
+
+CLI ergonomics overhaul + a brand-new `turns` / `conversations`
+metric exposed in MCP and CLI report. Plus one P1 fix that resurrected
+`ccgauge mcp` (silently exiting since 1.0.3's in-process refactor).
+
+### Highlights
+
+- **`turns` / "Conversations" metric** added to MCP responses and CLI
+  report. A turn is one user prompt — the same unit the dashboard's
+  usage table rows, and `usage trend → Conversations` toggle, already
+  count. A single turn typically fans out to 10–20× more `requests`
+  via tool loops, reasoning steps, and sub-agents, so `turns` is the
+  better signal for "how often did I actually talk to the model".
+  All three surfaces now share `lib/turns.ts → summarizeTurns()`.
+- **15+ CLI fixes + UX polish** — `ccgauge -r 7d` now produces a
+  helpful root error instead of `start: unknown option`; bare
+  `ccgauge` is the documented shortcut for `ccgauge start` again;
+  `ccgauge status` returns systemd-style exit 3 when not running;
+  `ccgauge stop` no longer kills unrelated processes after a reboot
+  (PID identity is verified); `ccgauge logs -f` no longer
+  duplicates lines under heavy write rates; foreground server starts
+  via `spawn` (matches background path); and a dozen smaller things.
+- **New `ccgauge doctor` command** — one-screen diagnostic dumping
+  version, environment, build artifacts, background-service state,
+  and per-provider scan stats. The recommended first step for any
+  bug report.
+- **P1 fix: `ccgauge mcp` now stays alive.** 1.0.3 refactored the
+  subcommand to run in-process via `await import()`, but a stray
+  `process.exit(0)` after `runStdioServer()` killed the process right
+  after the JSON-RPC transport opened, before any LLM client could
+  finish `initialize`. The smoke test now drives `node bin/cli.mjs
+  mcp` directly so this CLI-wrapper layer can never regress silently
+  again.
+
+### Added
+
+- **`ccgauge doctor`** — single-shot diagnostic command. Prints
+  ccgauge version + node / platform, ccgauge-relevant env vars
+  (`CCGAUGE_*`, `CLAUDE_CONFIG_DIR`, `CODEX_HOME`, `NO_COLOR`,
+  `FORCE_COLOR`), build-artifact presence, background-service state,
+  and the indexer probe from `ccgauge mcp --check`. Plain text so
+  it pastes into a GitHub issue cleanly.
+- **MCP `turns` field** in every analytical tool's response shape:
+  - `usage_summary` — `totals.turns`, `bySource.{claude,codex}.turns`.
+  - `usage_by_time` — `buckets[i].totals.turns` and per-source
+    breakdown; turns attribute to the bucket of their **earliest**
+    record (same convention as the dashboard's overview chart).
+  - `usage_by_model` — `models[i].turns` (turn is counted under
+    the model of its first record; sums across models equal the
+    scope's `totals.turns`).
+  - `usage_by_project` — `projects[i].turns` (by turn's first cwd).
+  - `usage_by_session` — `sessions[i].turns` (one session can hold
+    many turns; CLI users / LLMs comparing "long session vs many
+    short sessions" finally have the right number).
+  - `daily_summary`, `weekly_summary`, `recent_activity` — same
+    fields flow through their nested totals / per_day / sessions.
+  - `cost_estimator` is unchanged (pure pricing, no turn concept).
+- **CLI report `Convos` field** in `ccgauge report` output:
+  - **Tokens section** gets a new `Convos / Requests` line, so the
+    two activity counts read side-by-side.
+  - **Top-N breakdown table** (model / project / session) gets a
+    new `Convos` column between the dimension label and `Reqs`.
+  - JSON output (`--json`) carries `totals.turns`, `trend[i].turns`,
+    `breakdown[i].turns`.
+- **`lib/turns.ts → summarizeTurns()`** helper — given a (filtered)
+  record slice plus the full user / parent context, returns one
+  `TurnSummary` per distinct turn root with its `firstTimestamp`,
+  `firstModel`, `cwd`, `sessionId`, `source`. The single source of
+  truth shared by dashboard / MCP / CLI report.
+- **`SessionSummary.projectLabel`** — worktree-aware display label
+  (`"ai-self-web (playwright)"` instead of bare `"playwright"`),
+  matching the usage table. Drives the `/sessions` page, the
+  session-detail header, and CLI report's session breakdown.
+
+### Changed
+
+- **`ccgauge` (no subcommand)** is the documented shortcut for
+  `ccgauge start` again. A regression in 1.0.4's `normalizeArgv`
+  refactor made bare `ccgauge` print root help and exit 1.
+- **`ccgauge status` exit code** is now systemd-style 3 when no
+  background service is running, so shell scripts can `if ccgauge
+  status; then …`. **`--json` mode** intentionally still exits 0
+  (the consumer is a script that should read `payload.running`),
+  so `ccgauge status --json | jq` under `set -e` keeps working.
+- **`ccgauge mcp` runs in-process via `await import()` + the bundle
+  exports `runStdioServer` / `printCheck`.** Saves ~80–150 ms vs
+  the old spawn-a-child design and removes a brittle signal-
+  forwarding shim. (1.0.3 introduced this; 1.0.5 fixes the
+  `process.exit(0)` regression that broke it for real users.)
+- **`ccgauge mcp --check`** — verifies the bundle, boots the
+  indexer, prints one line per provider with scanned dirs + record
+  counts, and exits. Lets users debug "Claude Desktop doesn't see
+  ccgauge tools" without spinning up an MCP client.
+- **`--color` / `--no-color` / `FORCE_COLOR` / `NO_COLOR`** all
+  resolve through a single `shouldUseColor()` helper now, with the
+  documented precedence (`--no-color` highest, then env vars, then
+  `isTTY`). Previously the report's color flag was hard-AND'd with
+  `isTTY`, so `FORCE_COLOR=1 ccgauge report | tee log` lost colour.
+- **`ccgauge start` foreground** uses `spawn` instead of `fork`.
+  Next.js standalone doesn't use IPC; `fork` was opening an unused
+  channel and the parent's `process.exit(0)` was racing the child's
+  teardown on Ctrl+C. Now matches the background path's `spawn` +
+  exit-code forwarding.
+- **`--quiet`** silences Next.js's stderr too. Previously only stdout
+  was ignored, so warnings still leaked. (Background mode is
+  unaffected — it has always logged to a file.)
+- **`ccgauge restart --dir ""`** clears the inherited override
+  instead of silently re-reading the previous run's `dataDir` from
+  `state.json`. Uses commander's `getOptionValueSource('dir') ===
+  'cli'` instead of `!opts.dir` truthy check.
+- **Background-start failure messages** now include the last 5
+  lines of `~/.ccgauge/ccgauge.log`, so users don't have to discover
+  `ccgauge logs` to learn that EADDRINUSE / their override path
+  doesn't exist / etc. caused the silent timeout.
+- **"Build artifact not found"** errors from `start` / `report` /
+  `mcp` are unified into one `missingArtifactError(...)` helper.
+  Includes `node --version` / `ccgauge --version` / `platform` so
+  bug reports don't lose those.
+- **`[ccgauge] error:`** prefix is now consistent on stderr
+  diagnostics (was a mix of `[ccgauge]`, `[ccgauge-mcp]`, and bare
+  prose). stdout user-facing messages stay unprefixed.
+- **`/sessions` project column** uses `projectLabel` (worktree-aware)
+  so rows for `…/.claude/worktrees/playwright` read
+  `ai-self-web (playwright)` — matching the usage table.
+- **CLI report's session breakdown** (`--by session`) `sub` text
+  also uses `projectLabel`, for the same reason.
+- **README / README.zh-CN** Commands table gains `ccgauge doctor`;
+  Troubleshooting gains a "anything unexpected → ccgauge doctor"
+  lead; MCP troubleshooting points at `ccgauge mcp --check`.
+
+### Fixed
+
+- **`ccgauge mcp` exited immediately after the JSON-RPC handshake**
+  (P1 regression from 1.0.3): the in-process CLI wrapper called
+  `process.exit(0)` after `await runStdioServer()`, but
+  `runStdioServer` returns as soon as `server.connect(transport)`
+  finishes the handshake — the long-running stdin readline is what
+  holds the process alive. Removed the exit; documented with a
+  `CRITICAL:` comment so it can't come back. Smoke test now runs
+  through `node bin/cli.mjs mcp` so the CLI wrapper is on the
+  covered path.
+- **`ccgauge -r 7d -s codex` reported `start: unknown option '-r'`**
+  instead of "did you mean `report`?". `normalizeArgv` now only
+  injects `start` when every flag belongs to `start`'s own option
+  set; otherwise it leaves argv alone and lets commander surface
+  its own root-level error (which lists subcommands).
+- **`ccgauge logs -f` duplicated lines under heavy write rates.**
+  The follow loop used `stat().size` as the read cursor but didn't
+  cap the `createReadStream`'s upper bound, so a chunk written
+  between `stat` and the read could appear in both ticks. Now
+  pins `end: s.size - 1`.
+- **`ccgauge stop` could kill unrelated processes after a reboot.**
+  `process.kill(pid, 0)` only checks PID liveness, and PID space
+  recycles aggressively across boots. `state.json` now records a
+  `bootId` (~ system uptime) and a `cmdMarker` (`"next-server"`),
+  and `isProcessRunning` verifies both — falling back to the bare
+  kill(0) on Windows where `ps` isn't available.
+- **`test-mcp-server.mjs` flake** caused by top-N truncation: a
+  tool that's in claude-only top-10 can land #11 in the merged
+  all top-10 once codex contributes more competitors. The
+  per-tool count comparison now skips tools that didn't survive
+  the merged truncation (the broader "source filter is a no-op"
+  check below catches the real bug it was originally meant to).
+- **`/usage` project filter listed worktree leaves** as if they
+  were independent projects (`affectionate-sammet-00dc35`,
+  `agitated-diffie-5c15fe`, …), out of sync with `/projects`
+  which already collapses worktrees under their canonical repo
+  root. The dropdown now lists canonical cwds only; the
+  `projects` URL param semantics changed from exact-cwd to
+  canonical-cwd matching, and the aggregator's `projects` filter
+  is bypassed in favour of a canonical-aware pre-filter so a
+  single record under `…/.claude/worktrees/X` still counts when
+  the user picks its main repo.
+
+### Performance
+
+- **Aggregator hot loop** — `withinRange` predicate used to call
+  `Date#toISOString()` + `Array.includes()` once per record. Each
+  entry-point function now hoists those into a `prepareOpts` step:
+  ISO strings computed once, `models` / `projects` materialized as
+  `Set` for O(1) membership. Measurable on the MCP `weekly_summary`
+  / `usage_by_*` paths over year-scale histories; invisible for the
+  single-pass dashboard aggregators.
+- **MCP indexer's 30 s polling fallback** is now **off by default**.
+  fs.watch's `recursive: true` handles changes reliably on modern
+  macOS / Linux / Windows; the polling fallback was originally
+  there for flaky network mounts and FUSE setups. The web
+  dashboard's indexer **keeps polling ON** (user expects fresh
+  data when they alt-tab back). Override either default with
+  `CCGAUGE_POLL_FALLBACK={0,1}`.
+- **`get-port` / `open` are lazy-imported** — only loaded by `start`
+  / `restart` / `open`. Short-lived commands like `mcp`, `status`,
+  `logs`, `report`, `--version` shave ~20–30 ms cold-start each.
+  Matters most for `ccgauge mcp`, which LLM clients spawn per
+  conversation.
+
+### Internal
+
+- **`summarizeTurns()`** in `lib/turns.ts` is the single source of
+  truth for turn-level metadata; dashboard, MCP, and CLI report all
+  consume it. Same parent-chain walk + synthetic-user skip as
+  `buildTurnIndex` (which it builds on top of).
+- **`TurnsContext`** in `lib/mcp/formatters.ts` packages
+  `{ users, parentMap }` so per-source aggregator helpers can
+  re-derive turn boundaries without re-plumbing args through every
+  call site.
+- **`SessionSummary` carries `projectLabel`** (worktree-aware) in
+  addition to `projectName` (plain basename). Populated once by
+  `aggregateBySession` via `resolveProjectLabel` (per-cwd cache).
+- **`bootId()` helper** in `bin/cli.mjs` (`Date.now() - os.uptime()
+  * 1000`, rounded) — a coarse system-boot timestamp used to tell
+  pre-reboot PIDs from post-reboot ones.
+- **`shouldUseColor()` + `ansiPalette()`** in `bin/cli.mjs` — used
+  by `printReady` so the startup banner respects `NO_COLOR` and
+  doesn't leave `^[[1m...` mojibake when piped to `tee` / CI.
+- **Smoke test runs through the CLI wrapper.** `scripts/test-mcp-
+  server.mjs` now spawns `node bin/cli.mjs mcp` instead of `node
+  dist/mcp/server.mjs`, so any regression in the CLI wrapper
+  (signal handling, lifecycle, exit-code shaping) is caught here.
+
+## [1.0.4] — 2026-05-18
+
+Correctness fixes + much stronger test coverage, plus a brand refresh
+and a marketing-site restructure. No new runtime features.
+
+### Fixed
+
+- **Windows path sanitization.** `sanitizeForUser` now also strips
+  forward-slashed, JSON-escaped, and long-path (`\\?\`) variants of
+  `homedir()`, not just the literal `C:\Users\<name>` form. macOS /
+  Linux behaviour unchanged.
+- **5h-block empty state** follows the active source —
+  `?source=codex` no longer says "Send a message in Claude Code".
+  Same fix on the Codex tab inside the All view.
+- **`combineTimeBuckets` shared-reference bug.** Shallow-cloned model
+  entries were aliased back into the indexer's aggregator cache, so
+  downstream mutations could poison subsequent reads. Deep-cloned on
+  insertion; pinned by a new test.
+- **`safeMcpHandler` non-Error throws** are now wrapped + scrubbed
+  before re-throw; the previous branch silently fell through, shipping
+  unscrubbed payloads into the MCP envelope.
+
+### Added
+
+- **6 test / drift scripts**, all wired into `pnpm test`:
+  `test-turns`, `test-source-merge`, `test-cost-from-usage`,
+  `test-range` (fixture-based unit tests for the four core code
+  paths), plus `check-parser-versions` and `check-readme-images` (CI
+  drift guards for silently-stale-cache and broken-npm-image
+  regressions).
+
+### Changed
+
+- **Refined gauge brand mark**, unified across the dashboard, the
+  marketing site, and both favicons. Cleaner geometry (centre at
+  (32, 41), radius 18; arc + needle terminating on the dial rim),
+  Indigo-400 → -600 gradient background, white-ring pivot. New shared
+  `<LogoMark>` component on the marketing site so its Nav + Footer
+  now use the same mark as the dashboard.
+- **Marketing site is source-only.** Removed `site/package.json` and
+  `site/pnpm-lock.yaml`; Astro deps live in root `devDependencies`,
+  commands are explicit `pnpm site:*`. Still excluded from the npm
+  tarball (`pnpm pack --dry-run | grep -c '^site/'` → `0`).
+- **Theme-aware product screenshots.** New `<ThemedScreenshot>`
+  component swaps between dark / light captures via the
+  `.theme-light` class on `<html>`. 24 captures (6 pages × 2 locales
+  × 2 themes) generated by an expanded `scripts/screenshots.mjs`.
+- **OG cards** regenerated at higher fidelity.
+- **`cost_estimator` MCP tool** description spells out that reasoning
+  tokens are already counted inside `output_tokens` — don't
+  double-count.
+- **Activity heatmap tooltip** finally renders the share / of-peak
+  labels that were defined but never used.
+- **`CacheCreationBlock` type** extracted in `parse-jsonl.ts`.
+- **CLI `readState()`** type-guards `pid` / `url` / `logFile`.
+
+### Internal
+
+- MCP server warm-up comment clarifies the fire-and-forget
+  `getMcpIndexerReady()` is a cold-start shave — tool handlers still
+  await the same memoized init promise.
+- `AGENTS.md` + bundled READMEs updated for the source-only site
+  layout and the new `pnpm site:*` command set.
+
 ## [1.0.3] — 2026-05-15
 
 A focused **MCP server** correctness + performance + ergonomics pass,
@@ -678,6 +963,8 @@ of HTML to the browser.
 - Initial public release as `ccgauge`: local Next.js dashboard for
   Claude Code token usage, cost, and 5-hour block tracking.
 
+[1.0.5]: https://github.com/chengzuopeng/ccgauge/compare/v1.0.4...v1.0.5
+[1.0.4]: https://github.com/chengzuopeng/ccgauge/compare/v1.0.3...v1.0.4
 [1.0.3]: https://github.com/chengzuopeng/ccgauge/compare/v1.0.2...v1.0.3
 [1.0.2]: https://github.com/chengzuopeng/ccgauge/compare/v1.0.1...v1.0.2
 [1.0.1]: https://github.com/chengzuopeng/ccgauge/compare/v1.0.0...v1.0.1