claude-spotter 1.5.1 → 1.5.3

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.5.3 — 2026-08-04
+
+- **dashboardの難解な集計略号を廃止。** 概要cardとproject/tool別内訳の
+  `S/P/I/C/A/M`を、対象ターン、ツール提案あり、提案ツール数、利用判定済み、
+  実際に使用、判定不能の日本語表示へ置き換える。集計schemaとCLIの内部キーは変更しない。
+- **率の意味を式ではなく言葉で表示。** 提案率は「ツール提案あり ÷ 対象ターン」、
+  採用率は「実際に使用 ÷ 利用判定済み」と併記する。
+
+## 1.5.2 — 2026-08-04
+
+- **Mac LaunchAgentでNodeを解決。** `spotter`の絶対pathだけでなく、env shebangが使う
+  Homebrew Nodeを含むPATHをplistへ明示し、launchdの最小PATHでもdevice serverを起動できるようにした。
+- **Windows nativeとWSL2のloopback portを分離。** WSL2 localhost relayがWindows側の53940も
+  占有する実環境に合わせ、Windows native deviceを53944へ移し、main-serverの53943 tunnelも
+  53944へ接続する。Windowsを選んだ時にWSL2の評価DBが表示される衝突を解消した。
+- **評価SQLiteの初回同時open待ちを実測に合わせた。** 高負荷のNode 22.13でschema作成の競合が
+  既定1秒を超えたため、SQLite自身のbounded `busy_timeout`を5秒へ変更した。retry、lockfile、
+  background処理は追加せず、lockがない通常処理は待たない。
+
 ## 1.5.1 — 2026-08-04
 
 - **main-server hubのsystemd PATHを明示設定可能にした。** user managerがnvmのnpm binを

package/README.md

@@ -256,8 +256,9 @@ spotter uninstall        # remove hooks from this project (leaves ~/.spotter int
 
 The dashboard is local-first. Every terminal reads its own `~/.spotter/evaluation.db`; the hub
 keeps only a static device-to-upstream map and does not copy evaluation data into a cloud database.
-The device view shows `S/P/I/C/A/M`, proposal and adoption rates, project/tool breakdowns,
-non-adopted cases, and the two separately captured context sources. The hub checks health only
+The device view shows Japanese labels for every evaluation metric, proposal and adoption rates
+with their numerator and denominator, project/tool breakdowns, non-adopted cases, and the two
+separately captured context sources. The hub checks health only
 when the device list is requested, so an offline terminal is isolated without a background monitor
 or retry queue.
 

package/docs/11_dashboard-operations.md

@@ -2,7 +2,9 @@
 
 ## 固定構成
 
-各端末のdevice serverは`127.0.0.1:53940`だけで待ち受ける。main-serverのhubは
+各端末のdevice serverはloopbackだけで待ち受ける。main-server、Mac、FOX WSL2は
+`127.0.0.1:53940`、FOX Windows nativeはWSL2 localhost relayとの衝突を避けて
+`127.0.0.1:53944`を使う。main-serverのhubは
 Docker Caddyから到達できる`172.18.0.1:53940`で待ち受ける。評価DBは各端末の
 `~/.spotter/evaluation.db`をその場で読み、端末外へ複製しない。
 
@@ -88,7 +90,7 @@ main-serverのSSH host名またはIPを明示して次を1回実行する。
 登録される2 taskはログオン時にdevice serverとreverse tunnelを起動する。確認:
 
 ```powershell
-Invoke-RestMethod http://127.0.0.1:53940/_spotter/health
+Invoke-RestMethod http://127.0.0.1:53944/_spotter/health
 Get-ScheduledTask -TaskName 'Spotter dashboard *' | Get-ScheduledTaskInfo
 ```
 

package/ops/dashboard/launchd/dev.kitepon.spotter-dashboard-device.plist

@@ -12,6 +12,10 @@
     <string>--host</string><string>127.0.0.1</string>
     <string>--port</string><string>53940</string>
   </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key><string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
+  </dict>
   <key>RunAtLoad</key><true/>
   <key>KeepAlive</key><true/>
   <key>ThrottleInterval</key><integer>10</integer>

package/ops/dashboard/windows/spotter-dashboard-device.ps1

@@ -1,4 +1,4 @@
 $ErrorActionPreference = 'Stop'
 $spotter = Join-Path $env:APPDATA 'npm\spotter.cmd'
-& $spotter dashboard device --id fox-windows --name 'FOX Windows native' --host 127.0.0.1 --port 53940
+& $spotter dashboard device --id fox-windows --name 'FOX Windows native' --host 127.0.0.1 --port 53944
 exit $LASTEXITCODE

package/ops/dashboard/windows/spotter-dashboard-tunnel.ps1

@@ -3,5 +3,5 @@ $ErrorActionPreference = 'Stop'
 & "$env:WINDIR\System32\OpenSSH\ssh.exe" -N `
   -o BatchMode=yes -o ExitOnForwardFailure=yes `
   -o ServerAliveInterval=30 -o ServerAliveCountMax=3 -o TCPKeepAlive=yes `
-  -R '127.0.0.1:53943:127.0.0.1:53940' $MainServer
+  -R '127.0.0.1:53943:127.0.0.1:53944' $MainServer
 exit $LASTEXITCODE

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-spotter",
-  "version": "1.5.1",
+  "version": "1.5.3",
   "description": "Audit agent running alongside Claude Code that catches missed tool calls — 気づく役と実行する役の分離",
   "type": "module",
   "bin": {

package/src/core/evaluation-store.mjs

@@ -4,7 +4,7 @@ import { dirname, join } from 'node:path';
 import { DatabaseSync } from 'node:sqlite';
 
 export const EVALUATION_STORE_SCHEMA = 'spotter.evaluation_store.v1';
-export const DEFAULT_EVALUATION_BUSY_TIMEOUT_MS = 1_000;
+export const DEFAULT_EVALUATION_BUSY_TIMEOUT_MS = 5_000;
 // daemonの無通信寿命と同じ30分を超えたopen観測は、保存行を変更せず、
 // report上だけproposal itemをoutcome_missingとして扱う。
 export const DEFAULT_OPEN_TURN_STALE_MS = 30 * 60 * 1_000;
@@ -29,7 +29,7 @@ export function createEvaluationStore({
   mkdirSync(dirname(databasePath), { recursive: true, mode: 0o700 });
   const database = new DatabaseSync(databasePath);
   // cold startでは別projectのprocessも同じ未作成DBを同時に開き得る。
-  // WAL化とschema作成が最初のwrite lockを競う前に、既定1秒のbounded waitを有効にする。
+  // WAL化とschema作成が最初のwrite lockを競う前に、既定5秒のbounded waitを有効にする。
   database.exec(`PRAGMA busy_timeout=${busyTimeoutMs};`);
   database.exec('PRAGMA foreign_keys=ON;');
   initialize(database);

package/src/dashboard/render.mjs

@@ -3,6 +3,14 @@
 // opens EvaluationStore or asks Throughline for context.
 
 const METRIC_KEYS = ['S', 'P', 'I', 'C', 'A', 'M'];
+const METRIC_LABELS = {
+  S: '対象ターン',
+  P: 'ツール提案あり',
+  I: '提案ツール数',
+  C: '利用判定済み',
+  A: '実際に使用',
+  M: '判定不能',
+};
 
 /**
  * Render a complete dashboard document.
@@ -50,7 +58,7 @@ export function renderDashboard({
   <header class="page-header">
     <p class="eyebrow">Spotter</p>
     <h1>${escapeHtml(title)}</h1>
-    ${selectedDevice ? `<p class="subtitle">端末: ${escapeHtml(selectedDevice.name ?? selectedDevice.id)}</p>` : '<p class="subtitle">端末を選択してください。</p>'}
+    ${selectedDevice ? `<p class="subtitle">端末: ${escapeHtml(selectedDevice.name ?? selectedDevice.id)} · <a class="device-picker-link" href="/">端末を選び直す</a></p>` : '<p class="subtitle">端末を選択してください。</p>'}
   </header>
   ${renderDevices(devices, selectedId)}
   ${selectedDevice ? renderDeviceContent({ overview: dashboardModel, cases: renderedCases, caseDetail, filters, action }) : ''}
@@ -96,7 +104,7 @@ function renderDeviceContent({ overview, cases, caseDetail, filters, action }) {
   return `${renderFilters(filters, action)}
 <section aria-labelledby="overview-heading">
   <div class="section-heading"><h2 id="overview-heading">概要</h2>${renderRates(totals)}</div>
-  <div class="metrics" aria-label="評価メトリクス">${METRIC_KEYS.map((key) => `<article class="metric"><span>${key}</span><strong>${escapeHtml(metric(totals, key))}</strong></article>`).join('')}</div>
+  <div class="metrics" aria-label="評価メトリクス">${METRIC_KEYS.map((key) => `<article class="metric"><span>${METRIC_LABELS[key]}</span><strong>${escapeHtml(metric(totals, key))}</strong></article>`).join('')}</div>
 </section>
 ${renderBreakdown('project-breakdown', 'project別内訳', projects)}
 ${renderBreakdown('tool-breakdown', 'tool別内訳', tools)}
@@ -119,13 +127,13 @@ function renderFilters(filters, action) {
 function renderRates(summary) {
   const proposal = rate(metricNumber(summary, 'P'), metricNumber(summary, 'S'));
   const adoption = rate(metricNumber(summary, 'A'), metricNumber(summary, 'C'));
-  return `<dl class="rates"><div><dt>提案率 P/S</dt><dd>${escapeHtml(proposal)}</dd></div><div><dt>採用率 A/C</dt><dd>${escapeHtml(adoption)}</dd></div></dl>`;
+  return `<dl class="rates"><div><dt>提案率<small>ツール提案あり ÷ 対象ターン</small></dt><dd>${escapeHtml(proposal)}</dd></div><div><dt>採用率<small>実際に使用 ÷ 利用判定済み</small></dt><dd>${escapeHtml(adoption)}</dd></div></dl>`;
 }
 
 function renderBreakdown(id, title, rows) {
   return `<section aria-labelledby="${id}">
   <h2 id="${id}">${title}</h2>
-  ${rows.length === 0 ? '<p class="empty">該当するデータはありません。</p>' : `<div class="table-wrap"><table><thead><tr><th scope="col">項目</th>${METRIC_KEYS.map((key) => `<th scope="col">${key}</th>`).join('')}<th scope="col">提案率</th><th scope="col">採用率</th></tr></thead><tbody>${rows.map(([label, summary]) => `<tr><th scope="row">${escapeHtml(label)}</th>${METRIC_KEYS.map((key) => `<td>${escapeHtml(metric(summary, key))}</td>`).join('')}<td>${escapeHtml(rate(metricNumber(summary, 'P'), metricNumber(summary, 'S')))}</td><td>${escapeHtml(rate(metricNumber(summary, 'A'), metricNumber(summary, 'C')))}</td></tr>`).join('')}</tbody></table></div>`}
+  ${rows.length === 0 ? '<p class="empty">該当するデータはありません。</p>' : `<div class="table-wrap"><table><thead><tr><th scope="col">項目</th>${METRIC_KEYS.map((key) => `<th scope="col">${METRIC_LABELS[key]}</th>`).join('')}<th scope="col">提案率</th><th scope="col">採用率</th></tr></thead><tbody>${rows.map(([label, summary]) => `<tr><th scope="row">${escapeHtml(label)}</th>${METRIC_KEYS.map((key) => `<td>${escapeHtml(metric(summary, key))}</td>`).join('')}<td>${escapeHtml(rate(metricNumber(summary, 'P'), metricNumber(summary, 'S')))}</td><td>${escapeHtml(rate(metricNumber(summary, 'A'), metricNumber(summary, 'C')))}</td></tr>`).join('')}</tbody></table></div>`}
 </section>`;
 }
 
@@ -212,12 +220,13 @@ body { margin: 0; }
 .eyebrow { color: #3565a0; font-weight: 700; letter-spacing: .08em; margin: 0; text-transform: uppercase; }
 h1 { margin: .25rem 0; font-size: clamp(1.75rem, 4vw, 2.5rem); } h2 { margin-top: 2rem; } h3 { margin-bottom: .5rem; }
 .subtitle, .empty { color: #52606d; }
+.device-picker-link { color: inherit; }
 .device-nav ul { display: flex; flex-wrap: wrap; gap: .5rem; list-style: none; margin: .5rem 0; padding: 0; }
 .device { align-items: center; border: 1px solid #ccd4dd; border-radius: 999px; color: inherit; display: inline-flex; gap: .45rem; padding: .45rem .7rem; text-decoration: none; }
 .device[aria-current="page"] { border-color: #1c63b8; box-shadow: 0 0 0 2px #b8d6fa; }.device small { color: #52606d; }.status-dot { background: #a03333; border-radius: 50%; height: .55rem; width: .55rem; }.online .status-dot { background: #16803c; }
 .filters { align-items: end; display: flex; flex-wrap: wrap; gap: .75rem; margin: 1.5rem 0; }.filters label { display: grid; font-size: .85rem; gap: .25rem; }.filters input, button { border: 1px solid #aeb8c4; border-radius: .35rem; font: inherit; padding: .45rem; }button { background: #1c63b8; color: white; cursor: pointer; }
-.section-heading { align-items: baseline; display: flex; flex-wrap: wrap; gap: 1rem; justify-content: space-between; }.rates { display: flex; gap: 1.25rem; margin: 0; }.rates div { display: flex; gap: .35rem; }.rates dt { color: #52606d; }.rates dd { font-weight: 700; margin: 0; }
-.metrics { display: grid; gap: .75rem; grid-template-columns: repeat(6, minmax(90px, 1fr)); }.metric { background: #fff; border: 1px solid #d7dce2; border-radius: .5rem; padding: .8rem; }.metric span { color: #52606d; display: block; }.metric strong { font-size: 1.5rem; }
+.section-heading { align-items: baseline; display: flex; flex-wrap: wrap; gap: 1rem; justify-content: space-between; }.rates { display: flex; gap: 1.25rem; margin: 0; }.rates div { display: flex; gap: .45rem; }.rates dt { color: #52606d; }.rates dt small { display: block; font-size: .72rem; }.rates dd { font-weight: 700; margin: 0; }
+.metrics { display: grid; gap: .75rem; grid-template-columns: repeat(6, minmax(110px, 1fr)); }.metric { background: #fff; border: 1px solid #d7dce2; border-radius: .5rem; padding: .8rem; }.metric span { color: #52606d; display: block; }.metric strong { font-size: 1.5rem; }
 .table-wrap { overflow-x: auto; }table { border-collapse: collapse; min-width: 680px; width: 100%; }th, td { border-bottom: 1px solid #d7dce2; padding: .6rem; text-align: left; vertical-align: top; }thead { background: #eaf0f6; }tbody tr:nth-child(even) { background: #fbfcfd; }
 .case-detail { border-top: 2px solid #1c63b8; margin-top: 2.5rem; }.metadata { display: flex; flex-wrap: wrap; gap: 1rem; }.metadata div { min-width: 12rem; }.metadata dt { color: #52606d; }.metadata dd { margin: .2rem 0; overflow-wrap: anywhere; }pre { background: #1e2935; color: #e6edf3; margin: 0; overflow-x: auto; padding: 1rem; white-space: pre-wrap; word-break: break-word; }
 @media (max-width: 700px) { .dashboard { padding-top: 1rem; }.metrics { grid-template-columns: repeat(3, 1fr); }.filters { align-items: stretch; flex-direction: column; }.filters input, button { width: 100%; }.rates { flex-direction: column; gap: .25rem; } }