claude-spotter 1.4.11 → 1.4.13

package/CHANGELOG.md

@@ -1,5 +1,74 @@
 # Changelog
 
+## 1.4.13
+
+**Spotter 監査文面の末尾「監査役を明示してください」念押し行を削除**。
+`additionalContext` / pending text の末尾に入っていた 2 行 (UserPromptSubmit:
+「使う場合は『Spotter の推奨に従い〜』のように監査役の指摘を明示してください。」、
+Stop deferred delivery:「応答には『Spotter からの指摘を受けて〜』のように
+監査役の介入を明示してください。」) が、毎ターン主役 AI の文脈に積もって邪魔になる
+という運用上のフィードバックを反映。ヘッダー `[Spotter からの推奨ツール]` /
+`[Spotter からの指摘]` 自体が出典明示を担っているため、§12.2 / §12.3 の透明化原則は
+ヘッダーで維持し、念押し行のみを落とす。Claude / Codex 両 host が同じ
+`formatTransparentContext` / `formatTransparentBlockReason` を共有しているので
+hook parity は自動的に維持される。
+
+### 変更点
+
+- **編集 [src/hooks/lib.mjs](src/hooks/lib.mjs)**:
+  `formatTransparentContext` / `formatTransparentBlockReason` から末尾の空行 +
+  念押し行を削除。コメントを「header 自体が出典明示を担う」旨に書き換え。
+- **編集 [test/hooks.test.mjs](test/hooks.test.mjs)**:
+  逐語アサート 2 件を本体に追従。
+
+### 検証
+
+- `node --test` 334 tests / 333 pass / 1 skip 緑。
+- Codex hook 側の expected (`test/codex-hook-cmd.test.mjs`) はヘッダー文字列
+  `Spotter からの指摘` だけを正規表現マッチしているため無変更で pass。
+
+## 1.4.12
+
+**macOS/Homebrew install verification docs**。npm registry からの clean global install 後に
+`spotter install` と `spotter codex-hook install` が通ること、Codex hook が versioned
+Homebrew Cellar Node path ではなく安定 symlink を使うことを README に明記した。
+
+### 変更点
+
+- **編集 [README.md](README.md) / [README.ja.md](README.ja.md)**:
+  macOS Homebrew Node 環境では Codex hook command が `/opt/homebrew/bin/node` を使うこと、
+  release install smoke 手順 (`npm uninstall -g`, `npm install -g`, `spotter install -y`,
+  `spotter codex-hook install`) を追加。
+
+### 検証
+
+- npm registry からの実インストールで確認:
+  `npm uninstall -g claude-spotter`, `npm install -g claude-spotter`,
+  `spotter --version`, `spotter install -y`, `spotter codex-hook install` が exit 0。
+
+## 1.4.11
+
+**macOS Homebrew Node の versioned Cellar path を Codex hook に残さない修正**。
+`spotter codex-hook install` が `/opt/homebrew/Cellar/node/<version>/bin/node` を hook command に
+書くと、Homebrew の Node 更新後に Codex hook が古い Node を指したまま壊れるため、現在の
+Node 実体と一致する PATH 上の安定 symlink を優先するようにした。
+
+### 変更点
+
+- **編集 [src/cli/codex-hook-cmd.mjs](src/cli/codex-hook-cmd.mjs)**:
+  `resolveCodexHookNodePath()` を追加。PATH 上の `node` が `process.execPath` と同じ realpath を
+  指す場合は、その安定パスを hook command に使う。該当しない環境では従来通り
+  `process.execPath` に fallback するため、Windows / WSL2 の挙動は維持される。
+- 既存の Spotter-owned Codex hook が古い Cellar Node path を指している場合、再実行で現在の
+  stable Node path と npm global package path に書き換える。Caveat など他 tool の hook は保持する。
+
+### 検証
+
+- `node --test` 334 tests / 333 pass / 1 skip 緑。
+- npm registry からの実インストールで確認:
+  `npm uninstall -g claude-spotter`, `npm install -g claude-spotter`,
+  `spotter --version`, `spotter install -y`, `spotter codex-hook install` が exit 0。
+
 ## 1.4.10
 
 **Claude host primary auditor: Codex CLI 検出で自動採用、なければ Haiku の 2 段選択へ**。

package/README.ja.md

@@ -43,6 +43,11 @@ cd your-project
 spotter install
 ```
 
+macOS の Homebrew Node 環境では、Codex hook command の Node パスに現在の実体と一致する
+安定 symlink (`/opt/homebrew/bin/node`) を使います。
+`/opt/homebrew/Cellar/node/<version>/...` のような version 固定パスを書かないため、
+Homebrew で Node が更新されても Codex hook が古い Node パスに取り残されません。
+
 `v0.3.0` 以降は**プロジェクト単位の明示的 install** を採用しています (v0.2 までの `postinstall` 自動登録はデーモン増殖の主因だったため撤回)。各プロジェクトの `.claude/settings.json` に hook を登録し、そのプロジェクトでの Claude Code セッションのみで有効になります。
 Codex CLI が使える環境では、同じ `spotter install` が user-level の Codex native hooks も登録します。実際に動くプロジェクトは `spotter install` が作る `.spotter/marker.json` で制限されるため、無関係な Codex セッションでは Spotter は起動しません。
 Codex 側では現行の `[features].hooks = true` を有効化し、互換のため旧 `codex_hooks` diagnostics output も認識します。
@@ -53,6 +58,16 @@ Spotter を upgrade した後、release note で hook 設定変更が案内さ
 spotter uninstall        # このプロジェクトの hook 登録を解除
 ```
 
+リリース時の npm install smoke:
+
+```bash
+npm uninstall -g claude-spotter
+npm install -g claude-spotter
+spotter --version
+spotter install -y
+spotter codex-hook install
+```
+
 ## 動作要件
 
 - **Node.js 22.5 以上**

package/README.md

@@ -43,6 +43,11 @@ cd your-project
 spotter install
 ```
 
+On macOS with Homebrew Node, Codex hook commands use the stable
+`/opt/homebrew/bin/node` symlink when it resolves to the current Node binary,
+instead of a versioned `/opt/homebrew/Cellar/node/<version>/...` path. That keeps
+Codex hooks working across Homebrew Node upgrades.
+
 Since `v0.3.0`, Spotter requires **explicit per-project install** (the earlier `postinstall` auto-registration was the leading cause of orphan daemons). `spotter install` writes hooks into the project's `.claude/settings.json`; the audit is then active only in Claude Code sessions for that project.
 When the Codex CLI is available, the same `spotter install` also registers user-level Codex native hooks. Project activation still depends on the same per-project `.spotter/marker.json`, so unrelated Codex sessions do not trigger Spotter.
 For Codex, install enables the current `[features].hooks = true` flag and still recognizes older `codex_hooks` diagnostics output for compatibility.
@@ -53,6 +58,16 @@ After upgrading Spotter, re-run `spotter install` in each installed project when
 spotter uninstall        # remove hooks from this project
 ```
 
+Release install smoke:
+
+```bash
+npm uninstall -g claude-spotter
+npm install -g claude-spotter
+spotter --version
+spotter install -y
+spotter codex-hook install
+```
+
 ## Requirements
 
 - **Node.js 22.5+**

package/package.json

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

package/src/hooks/lib.mjs

@@ -129,14 +129,12 @@ export function die(message, exitCode = 2) {
 }
 
 export function formatTransparentContext(missingTools) {
-  // §12.2: transparent phrasing — Bell should reference Spotter explicitly.
+  // §12.2: transparent phrasing — header `[Spotter からの推奨ツール]` 自体が出典明示を担う。
   const lines = missingTools.map((m) => `- \`${m.name}\`: ${m.reason}`);
   return [
     '[Spotter からの推奨ツール]',
     'このプロンプトに応答する前に、以下のツールを使うべきか検討してください。',
     ...lines,
-    '',
-    '使う場合は「Spotter の推奨に従い〜」のように監査役の指摘を明示してください。',
   ].join('\n');
 }
 
@@ -156,13 +154,11 @@ export async function recordClaudeHookEvent({ projectRoot, event, writeError } =
 }
 
 export function formatTransparentBlockReason(missingTools) {
-  // §12.3: transparent phrasing for Stop hook block.
+  // §12.3: transparent phrasing — header `[Spotter からの指摘]` 自体が出典明示を担う。
   const lines = missingTools.map((m) => `- \`${m.name}\`: ${m.reason}`);
   return [
     '[Spotter からの指摘]',
     '上記応答ではツールが不足している可能性があります。以下を検討し、必要なら呼び出した上で応答を補正してください。',
     ...lines,
-    '',
-    '応答には「Spotter からの指摘を受けて〜」のように監査役の介入を明示してください。',
   ].join('\n');
 }