claude-spotter 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,6 +1,12 @@
 # Changelog
 
-## 0.1.0 (Unreleased)
+## 0.1.1
+
+- `npm install -g claude-spotter` now registers hooks at user level automatically via the `postinstall` lifecycle — no separate `spotter install` step needed
+- `npm uninstall -g claude-spotter` removes hook entries from `~/.claude/settings.json` via `preuninstall`
+- Opt-out: set `CLAUDE_SPOTTER_NO_AUTO_INSTALL=1` before install, or install in an environment where `CI=true` (CI is auto-skipped)
+
+## 0.1.0
 
 Initial release.
 

package/README.md

@@ -10,10 +10,11 @@ Spotter は、ツールカタログを完全に把握した別エージェント
 
 ```bash
 npm install -g claude-spotter
-spotter install     # .claude/settings.json に hook を登録 (diff を見せて確認)
 ```
 
-次回 Claude Code セッションから自動で有効になります。
+これだけで `~/.claude/settings.json` に hook が自動登録され、次回 Claude Code セッションから全プロジェクトで有効になります (`postinstall` ライフサイクルが `spotter install --user` を自動実行します)。
+
+自動登録を止めたい場合は `CLAUDE_SPOTTER_NO_AUTO_INSTALL=1 npm install -g claude-spotter` と打てばスキップされ、あとから `spotter install` / `spotter install --user` を好きなタイミングで手動実行できます。CI 環境 (`CI=true`) では自動的にスキップされます。
 
 ## 動作要件
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-spotter",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Audit agent running alongside Claude Code that catches missed tool calls — 気づく役と実行する役の分離",
   "type": "module",
   "bin": {
@@ -10,7 +10,9 @@
     ".": "./src/index.mjs"
   },
   "scripts": {
-    "test": "node --test"
+    "test": "node --test",
+    "postinstall": "node scripts/postinstall.mjs",
+    "preuninstall": "node scripts/preuninstall.mjs"
   },
   "keywords": [
     "claude",
@@ -40,6 +42,7 @@
   "files": [
     "bin",
     "src",
+    "scripts",
     "templates",
     "README.md",
     "LICENSE",

package/scripts/postinstall.mjs

@@ -0,0 +1,42 @@
+// Runs after `npm install (-g) claude-spotter`.
+// Registers hooks at user level so Spotter is active across all projects
+// without requiring a separate `spotter install` step.
+//
+// Never fails npm install — on any error we warn and exit 0 so the user's
+// node_modules/global bin is still usable. They can re-run `spotter install --user`
+// manually if needed.
+
+import { runInstall } from '../src/cli/install.mjs';
+
+const SKIP_ENV = 'CLAUDE_SPOTTER_NO_AUTO_INSTALL';
+
+async function main() {
+  if (process.env[SKIP_ENV]) {
+    console.log(`claude-spotter: auto-install skipped (${SKIP_ENV} set).`);
+    console.log('  run `spotter install --user` later to register hooks.');
+    return;
+  }
+
+  // Skip in well-known CI environments — CI builds shouldn't silently modify
+  // ~/.claude/settings.json of whatever runner user this is.
+  if (process.env.CI === 'true' || process.env.CI === '1') {
+    console.log('claude-spotter: auto-install skipped (CI detected).');
+    console.log('  run `spotter install --user` on your dev machine.');
+    return;
+  }
+
+  try {
+    await runInstall({ target: 'user', autoYes: true });
+    console.log('\nclaude-spotter: hooks registered at user level (~/.claude/settings.json).');
+    console.log('  Open a new Claude Code session to activate.');
+    console.log(`  To skip this next time: set ${SKIP_ENV}=1 before npm install.`);
+  } catch (err) {
+    console.warn(`claude-spotter: auto-install skipped — ${err.message}`);
+    console.warn('  run `spotter install --user` to register hooks manually.');
+  }
+}
+
+main().catch((err) => {
+  // Defensive: never let postinstall crash the install.
+  console.warn(`claude-spotter: postinstall unexpected error — ${err.message}`);
+});

package/scripts/preuninstall.mjs

@@ -0,0 +1,14 @@
+// Runs before `npm uninstall (-g) claude-spotter`.
+// Removes hooks from ~/.claude/settings.json so an uninstall leaves the system clean.
+//
+// Never fails the uninstall — on error we warn and exit 0.
+
+import { runUninstall } from '../src/cli/uninstall.mjs';
+
+try {
+  await runUninstall({ target: 'user', autoYes: true });
+  console.log('claude-spotter: hooks removed from ~/.claude/settings.json.');
+} catch (err) {
+  console.warn(`claude-spotter: hook cleanup skipped — ${err.message}`);
+  console.warn('  you may need to edit ~/.claude/settings.json manually.');
+}

package/src/version.mjs

@@ -1 +1 @@
-export const version = '0.1.0';
+export const version = '0.1.1';