JonyanDunh
diff --git a/‎.claude-plugin/marketplace.json‎
Lines changed: 8 additions & 6 deletions b/‎.claude-plugin/marketplace.json‎
Lines changed: 8 additions & 6 deletions
diff --git a/‎.claude-plugin/plugin.json‎
Lines changed: 5 additions & 3 deletions b/‎.claude-plugin/plugin.json‎
Lines changed: 5 additions & 3 deletions
diff --git a/‎.github/workflows/ci.yml‎
Lines changed: 35 additions & 15 deletions b/‎.github/workflows/ci.yml‎
Lines changed: 35 additions & 15 deletions
diff --git a/‎CONTRIBUTING.md‎
Lines changed: 38 additions & 10 deletions b/‎CONTRIBUTING.md‎
Lines changed: 38 additions & 10 deletions
diff --git a/‎NOTICE‎
Lines changed: 30 additions & 4 deletions b/‎NOTICE‎
Lines changed: 30 additions & 4 deletions
@@ -1,16 +1,16 @@
 {
   "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
-  "name": "claude-code-watchdog",
-  "description": "Watchdog — watches the agent and re-feeds the same prompt until the task genuinely stops producing file edits. Derived from Anthropic's ralph-loop, Apache 2.0.",
+  "name": "claude-code-watchdog-nodejs",
+  "description": "Watchdog (Node.js rewrite) — cross-platform self-referential Claude Code loop with zero bash/jq dependencies. Runs natively on Linux, macOS, and Windows. Apache 2.0, derived from ralph-loop.",
   "owner": {
     "name": "Jonyan Dunh",
     "email": "jonyandunh@outlook.com"
   },
   "plugins": [
     {
       "name": "watchdog",
-      "description": "A self-referential loop for Claude Code that re-feeds the user's prompt until the task truly stops producing file edits. Uses a headless Haiku classifier to judge convergence, requires the agent to actually call tools before exit (no pure-text 'done' claims), and is hidden from the agent so it cannot cheat. Per-session state keyed by TERM_SESSION_ID. Apache 2.0, derived from ralph-loop.",
-      "version": "1.0.3",
+      "description": "Self-referential loop for Claude Code that re-feeds the user's prompt until the task truly stops producing file edits. Cross-platform Node.js implementation with no bash / jq dependencies. Uses a headless Haiku classifier to judge convergence, requires the agent to actually call tools before exit (no pure-text 'done' claims), and is hidden from the agent so it cannot cheat. Per-session state keyed by TERM_SESSION_ID. Apache 2.0, derived from ralph-loop.",
+      "version": "1.1.0",
       "author": {
         "name": "Jonyan Dunh",
         "email": "jonyandunh@outlook.com"
@@ -26,9 +26,11 @@
         "self-referential",
         "iteration",
         "convergence",
-        "ralph-loop"
+        "ralph-loop",
+        "nodejs",
+        "cross-platform"
       ]
     }
   ],
-  "version": "1.0.3"
+  "version": "1.1.0"
 }
@@ -1,7 +1,7 @@
 {
   "name": "watchdog",
-  "version": "1.0.3",
-  "description": "Continuous self-referential AI watchdog for interactive iterative development. Runs Claude in a while-true loop with the same prompt until the task stops producing file edits.",
+  "version": "1.1.0",
+  "description": "Self-referential loop for Claude Code. Re-feeds the same prompt after every turn until files actually stop changing. Cross-platform Node.js implementation — no bash / jq dependencies, runs natively on Linux, macOS, and Windows.",
   "author": {
     "name": "Jonyan Dunh",
     "email": "jonyandunh@outlook.com"
@@ -17,6 +17,8 @@
     "self-referential",
     "iteration",
     "convergence",
-    "ralph-loop"
+    "ralph-loop",
+    "nodejs",
+    "cross-platform"
   ]
 }
@@ -10,39 +10,59 @@ permissions:
   contents: read
 
 jobs:
-  shellcheck:
-    name: ShellCheck shell scripts
-    runs-on: ubuntu-latest
+  nodejs-tests:
+    name: Node.js tests (${{ matrix.os }}, node ${{ matrix.node }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        node: ['18', '20', '22']
+    runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4
-      - name: Run shellcheck
-        uses: ludeeus/action-shellcheck@master
+      - name: Use Node.js ${{ matrix.node }}
+        uses: actions/setup-node@v4
         with:
-          scandir: "."
-          severity: warning
-        env:
-          SHELLCHECK_OPTS: -e SC2317
+          node-version: ${{ matrix.node }}
+      - name: Syntax-check all JavaScript files
+        shell: bash
+        run: |
+          set -e
+          find . -type f -name '*.js' ! -path './.git/*' -print0 | while IFS= read -r -d '' f; do
+            node --check "$f"
+          done
+      - name: Run the test suite
+        shell: bash
+        # Explicit file list — Node's --test glob support only landed in
+        # v21+. Listing files keeps CI working on Node 18 and 20 (which
+        # treat 'test/*.test.js' as a literal path).
+        run: |
+          node --test \
+            test/transcript.test.js \
+            test/state.test.js \
+            test/judge.test.js \
+            test/setup.test.js \
+            test/stop-watchdog.test.js \
+            test/stop-hook.test.js
 
   jsonlint:
     name: Lint JSON manifests
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: Install jq
-        run: sudo apt-get update && sudo apt-get install -y jq
-      - name: Validate all JSON files
+      - name: Validate all JSON files with Node
         run: |
           set -e
           fail=0
           while IFS= read -r f; do
-            if ! jq empty "$f" 2>/tmp/jq-err; then
+            if ! node -e "JSON.parse(require('fs').readFileSync(process.argv[1],'utf8'))" "$f" 2>/tmp/json-err; then
               echo "::error file=$f::Invalid JSON"
-              cat /tmp/jq-err
+              cat /tmp/json-err
               fail=1
             else
               echo "ok: $f"
             fi
-          done < <(find . -type f -name '*.json' ! -path './.git/*')
+          done < <(find . -type f -name '*.json' ! -path './.git/*' ! -path './node_modules/*')
           exit $fail
 
   markdownlint:
 
@@ -43,21 +43,24 @@ Then `/reload-plugins` inside Claude Code.
 claude-code-watchdog/
 ├── .claude-plugin/         # marketplace + plugin manifests
 ├── commands/               # slash command definitions (markdown with frontmatter)
-├── hooks/                  # Stop hook registration + stop-hook.sh (core loop logic)
-├── scripts/                # setup-watchdog.sh / stop-watchdog.sh (bash state management)
+├── hooks/                  # Stop hook registration + stop-hook.js (core loop logic)
+├── scripts/                # setup-watchdog.js / stop-watchdog.js entry points
+├── lib/                    # shared modules (state, transcript, judge, log, stdin, constants)
+├── test/                   # node:test unit + integration tests with fixtures
 ├── LICENSE                 # Apache 2.0
 └── NOTICE                  # Attribution to ralph-loop (required by Apache 2.0 § 4)
 ```
 
-The heart of the plugin is `hooks/stop-hook.sh`. Read that first before changing anything.
+The heart of the plugin is `hooks/stop-hook.js`. Read that first before changing anything — it consumes everything under `lib/`.
 
 ## Before you open a PR
 
-1. **Shell scripts must pass `shellcheck`.** CI runs it on every `.sh` file. Install locally (`apt install shellcheck`, `brew install shellcheck`) and fix warnings before pushing.
-2. **Line endings must be LF.** The `.gitattributes` file enforces this — do not override.
-3. **Do not skip the `NOTICE` file when making derivative changes.** If your change affects how we differ from `ralph-loop`, update the "modifications" list in `NOTICE`.
-4. **Do not commit debug logging.** Remove any `WATCHDOG_DEBUG_LOG=...` scaffolding before the PR.
-5. **One logical change per PR.** Mixing a bugfix with a refactor makes review harder.
+1. **All JavaScript must parse under `node --check`.** CI runs it on every `.js` file. Broken syntax will fail the build.
+2. **All tests must pass.** Run `node --test 'test/*.test.js'` locally before pushing. CI runs the full suite on `ubuntu-latest`, `macos-latest`, and `windows-latest` across Node 18 / 20 / 22 — any regression on any matrix entry blocks merge.
+3. **Line endings must be LF.** The `.gitattributes` file enforces this — do not override.
+4. **Do not skip the `NOTICE` file when making derivative changes.** If your change affects how we differ from `ralph-loop`, update the "modifications" list in `NOTICE`.
+5. **Do not commit debug logging.** Remove any `console.log` scaffolding before the PR — `lib/log.js` is the only sanctioned stderr output surface.
+6. **One logical change per PR.** Mixing a bugfix with a refactor makes review harder.
 
 ## Commit messages
 
@@ -78,15 +81,40 @@ Common types:
 
 ## Testing your change
 
-There is no automated test suite (the project is small and the interesting behavior requires a live Claude Code session). Manual verification steps:
+Watchdog ships with 53 automated tests using Node's built-in `node:test` runner — no external test dependencies. Run them from the repo root:
+
+```bash
+# Node 22+: glob pattern
+node --test 'test/*.test.js'
+
+# Node 18/20: shell expansion (quotes removed) or explicit file list
+node --test test/*.test.js
+```
+
+Target an individual file:
+
+```bash
+node --test test/transcript.test.js
+```
+
+The suite covers:
+
+- **`test/transcript.test.js`** — JSONL parser, real-vs-tool_result user turn detection, tool_use extraction
+- **`test/state.test.js`** — atomic state file writes, merge updates, validation, per-session path keying
+- **`test/judge.test.js`** — verdict parser (FILE_CHANGES substring trap, ambiguous, empty, multi-token)
+- **`test/setup.test.js`** — E2E subprocess tests for `scripts/setup-watchdog.js`
+- **`test/stop-watchdog.test.js`** — E2E subprocess tests for `scripts/stop-watchdog.js`
+- **`test/stop-hook.test.js`** — E2E subprocess tests for `hooks/stop-hook.js` including the recursion guard, ownership claim, max iterations cap, missing transcript, and pure-text turn branches
+
+In addition to the unit/integration suite, you should **also** manually verify your change in a live Claude Code session:
 
 1. Clear any stale state: `rm -f .claude/watchdog.*.local.json`
 2. Load the plugin locally (see Quick start above)
 3. Run a small iterative task:
    ```
    /watchdog:start "Create tmp/test.md with 'hello world'" --max-iterations 5
    ```
-4. Verify the loop converges (file created, Haiku judges NO_FILE_CHANGES on the next turn, loop exits)
+4. Verify the loop converges (file created, Haiku judges `NO_FILE_CHANGES` on the next turn, loop exits)
 5. Verify `/watchdog:stop` cleanly removes the state file
 
 ## Reporting bugs
 
@@ -43,7 +43,7 @@ introduces the following substantive modifications:
   - Introduced per-session state files keyed by TERM_SESSION_ID so
     concurrent watchdogs in different terminal tabs do not clobber
     each other's state. The state file format was also switched from
-    markdown-with-YAML-frontmatter to JSON, parsed with jq.
+    markdown-with-YAML-frontmatter to JSON.
 
   - Appended an English verification reminder to every re-fed prompt,
     instructing the agent to re-run the verification with real tool
@@ -54,12 +54,38 @@ introduces the following substantive modifications:
     mistaken for turn boundaries, causing the current turn's tool_use
     blocks to be excluded from the classification prompt.
 
+  - Added an owner_session_id recursion guard. The headless Haiku
+    classifier we spawn is itself a Claude Code session, so its own
+    Stop hook fires when it ends. TERM_SESSION_ID is inherited by
+    subprocesses, so the recursive invocation would find and clobber
+    the main session's state file. The fix records the per-invocation
+    Claude session_id (from the hook's stdin JSON, which is NOT
+    inherited) as owner_session_id on first fire, and recursive fires
+    with a different session_id bail out without touching state.
+
+  - Rewrote the entire plugin from Bash + jq + POSIX coreutils to
+    Node.js (v1.1.0). The new implementation has zero shell or POSIX
+    dependencies — it runs natively on Linux, macOS, and native
+    Windows (PowerShell / cmd) with only `node` 18+ required. Shared
+    logic is extracted into reusable modules under lib/ (constants,
+    state, transcript, judge, log, stdin), consumed by three thin
+    entry points (setup-watchdog.js, stop-watchdog.js, stop-hook.js).
+    The port is covered by 53 tests using Node's built-in node:test
+    runner (no external test dependencies).
+
 Files significantly modified from their ralph-loop originals include:
 
-  - hooks/stop-hook.sh
-  - scripts/setup-watchdog.sh (originally scripts/setup-ralph-loop.sh)
-  - scripts/stop-watchdog.sh  (originally scripts/cancel-ralph.sh)
+  - hooks/stop-hook.js        (was hooks/stop-hook.sh in ralph-loop
+                               and Watchdog 1.0.x)
+  - scripts/setup-watchdog.js (originally scripts/setup-ralph-loop.sh)
+  - scripts/stop-watchdog.js  (originally scripts/cancel-ralph.sh)
   - commands/start.md         (originally commands/ralph-loop.md)
   - commands/stop.md          (originally commands/cancel-ralph.md)
+  - lib/constants.js          (new in Watchdog 1.1.0)
+  - lib/state.js              (new in Watchdog 1.1.0)
+  - lib/transcript.js         (new in Watchdog 1.1.0)
+  - lib/judge.js              (new in Watchdog 1.1.0)
+  - lib/log.js                (new in Watchdog 1.1.0)
+  - lib/stdin.js              (new in Watchdog 1.1.0)
 
 See each file's header comment for a per-file attribution notice.
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "watchdog",`
`3`		`- "version": "1.0.3",`
`4`		`- "description": "Continuous self-referential AI watchdog for interactive iterative development. Runs Claude in a while-true loop with the same prompt until the task stops producing file edits.",`
	`3`	`+ "version": "1.1.0",`
	`4`	`+ "description": "Self-referential loop for Claude Code. Re-feeds the same prompt after every turn until files actually stop changing. Cross-platform Node.js implementation — no bash / jq dependencies, runs natively on Linux, macOS, and Windows.",`
`5`	`5`	`"author": {`
`6`	`6`	`"name": "Jonyan Dunh",`
`7`	`7`	`"email": "jonyandunh@outlook.com"`
`@@ -17,6 +17,8 @@`
`17`	`17`	`"self-referential",`
`18`	`18`	`"iteration",`
`19`	`19`	`"convergence",`
`20`		`- "ralph-loop"`
	`20`	`+ "ralph-loop",`
	`21`	`+ "nodejs",`
	`22`	`+ "cross-platform"`
`21`	`23`	`]`
`22`	`24`	`}`