feat: rewrite in Node.js for cross-platform support (v1.1.0)

[JonyanDunh]

Summary

Complete rewrite of the Watchdog plugin from Bash + jq + POSIX coreutils to Node.js. Runs natively on Linux, macOS, and Windows (including PowerShell / cmd — no WSL2 needed). Only runtime dependency is node 18+ and the claude CLI.

Architecture

Three thin entry points consume six shared lib/ modules:

lib/constants.js    — state file path pattern, marker tokens, prompt templates
lib/log.js          — stderr diagnostics
lib/stdin.js        — cross-platform synchronous stdin reader
lib/state.js        — atomic state file lifecycle (temp file + rename)
lib/transcript.js   — JSONL parser + current-turn tool extraction
lib/judge.js        — headless Haiku subprocess + verdict parser

hooks/stop-hook.js         — 186 lines (was stop-hook.sh at 287 lines of bash)
scripts/setup-watchdog.js  — 119 lines (was setup-watchdog.sh at 140 lines)
scripts/stop-watchdog.js   — 39 lines (was stop-watchdog.sh at 36 lines)

738 lines total of production JavaScript, replacing 463 lines of bash. The extra lines buy full modularization, cross-platform support, and a real test suite.

Test suite (53 tests, all green)

Uses Node's built-in `node:test` runner — zero external dependencies.

• `test/transcript.test.js` — 11 tests — JSONL parsing, real-vs-tool_result turn detection, tool_use extraction, malformed-line resilience
• `test/state.test.js` — 11 tests — atomic writes, merge updates, validation, path keying, parent dir creation
• `test/judge.test.js` — 11 tests — verdict parser (FILE_CHANGES substring trap, ambiguous, empty, multi-token)
• `test/setup.test.js` — 10 tests — end-to-end `scripts/setup-watchdog.js` subprocess invocations
• `test/stop-watchdog.test.js` — 3 tests — end-to-end `scripts/stop-watchdog.js` subprocess invocations
• `test/stop-hook.test.js` — 8 tests — end-to-end `hooks/stop-hook.js` including owner_session_id recursion guard, ownership claim, max iterations cap, missing transcript, pure-text turn

Run with: `node --test 'test/*.test.js'`

CI matrix

Dropped shellcheck (no shell scripts left). CI now runs:

Job	Matrix
`nodejs-tests`	`ubuntu-latest` × `macos-latest` × `windows-latest` × Node 18 / 20 / 22 (9 jobs)
`jsonlint`	ubuntu, now uses `node -e JSON.parse` instead of `jq`
`markdownlint`	ubuntu, unchanged

READMEs (all 7 languages)

All 7 READMEs updated in this PR — English authored directly, then 6 parallel subagents translated the new sections into `zh` / `ja` / `ko` / `es` / `vi` / `pt` while preserving each file's existing colloquial tone.

Verified structural parity across all 7 files: same h2/h3 counts, same number of tables, same number of install blocks (`winget`, `scoop`, `node --test`, etc.).

Behavior compatibility

Same semantics as 1.0.x:

• Haiku-classifier convergence detection
• Tool-call exit precondition (pure-text turn never exits)
• `owner_session_id` recursion guard (fixed in v1.0.1)
• Per-session state keyed by `TERM_SESSION_ID`
• Slash command surface: `/watchdog:start`, `/watchdog:stop`, `/watchdog:help`
• State file format (JSON) unchanged

Breaking changes

None for end users who installed via `npm install -g @anthropic-ai/claude-code` — they already have `node` in `PATH`. Users who installed Claude Code via standalone binary / homebrew without Node.js will now need to install Node.js 18+ to use Watchdog.

NOTICE updated

Added the Node.js rewrite as a new modification entry per Apache 2.0 § 4, with the updated file list.

Test plan

• `node --test 'test/*.test.js'` — 53/53 passing
• `node --check` on every `.js` file — all clean
• All 7 READMEs structurally consistent (`grep` counts match)
• `.claude-plugin/plugin.json` bumped to 1.1.0
• `.claude-plugin/marketplace.json` bumped to 1.1.0
• `hooks/hooks.json` invokes `node` instead of `bash`
• CI will confirm Linux/macOS/Windows × Node 18/20/22 parity

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com