claude-spotter 1.5.0 → 1.5.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 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を
+  継承しない実環境に合わせ、hub unitも`dashboard-hub.env`を読む。device unitと同じく、
+  実測したnpm binをPATHへ置き、端末固有のversion pathを配布unitへ焼かない。
+
 ## 1.5.0 — 2026-08-04
 
 - **評価結果を端末別Web dashboardで表示。** 各端末の`~/.spotter/evaluation.db`をrequestごとに読み、

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`をその場で読み、端末外へ複製しない。
 
@@ -40,6 +42,12 @@ SPOTTER_DEVICE_ID=main-server
 SPOTTER_DEVICE_NAME=main-server
 ```
 
+device envと同じPATHを`~/.config/spotter/dashboard-hub.env`にも置く。main-serverの例:
+
+```ini
+PATH=/home/kite/.nvm/versions/node/v24.14.1/bin:/usr/local/bin:/usr/bin:/bin
+```
+
 ```sh
 systemctl --user daemon-reload
 systemctl --user enable --now spotter-dashboard-device.service spotter-dashboard-hub.service
@@ -47,8 +55,7 @@ curl --fail http://127.0.0.1:53940/_spotter/health
 curl --fail http://172.18.0.1:53940/
 ```
 
-systemd user managerの`PATH`から`spotter`が見えない場合だけ、ユーザー環境の実際のnpm binを
-unitの`Environment=PATH=...`として追加する。別の起動経路へfallbackしない。
+device envにも同じPATH行を置く。値は各端末で実測したnpm binを使い、別の起動経路へfallbackしない。
 
 ## FOX WSL2
 
@@ -83,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/systemd/spotter-dashboard-hub.service

@@ -4,6 +4,7 @@ After=network.target
 
 [Service]
 Type=simple
+EnvironmentFile=%h/.config/spotter/dashboard-hub.env
 ExecStart=/usr/bin/env spotter dashboard hub --config %h/.config/spotter/dashboard-hub.json --host 172.18.0.1 --port 53940
 Restart=on-failure
 RestartSec=10

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.0",
+  "version": "1.5.2",
   "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

@@ -50,7 +50,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 }) : ''}
@@ -212,6 +212,7 @@ 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; }