cairn-ai 0.1.2 → 0.1.5

package/.agents/workflows/cairn-doctor.md

@@ -11,7 +11,7 @@ bunx cairn-ai@latest doctor
 When running from local source:
 
 ```sh
-scripts/cairn doctor
+node scripts/cairn.mjs doctor
 ```
 
 Checks:

package/.agents/workflows/cairn-install.md

@@ -11,7 +11,7 @@ bunx cairn-ai@latest install
 When running from local source:
 
 ```sh
-scripts/cairn install
+node scripts/cairn.mjs install
 ```
 
 After installation, check status with the `cairn-doctor` workflow.

package/.agents/workflows/cairn-memory.md

@@ -7,9 +7,9 @@ Goal: create or update repository memory without asking the user for discoverabl
 Procedure:
 
 1. Ensure `MEMORY.md`, `PLAN.md`, `docs/memory`, and `docs/plan`.
-2. Read `MEMORY.md`.
+2. Every agent must read the project-root `MEMORY.md` for domain knowledge and repository policy before assigned discovery or update work.
 3. Explore repository facts with focused tools.
-4. Use `explorer` for read-only domain discovery and contradiction checks when available; use `worker` for exact references, command checks, and bounded evidence capture.
+4. Use `explorer` for read-only domain discovery and contradiction checks when available; use `worker` for exact references, command checks, and bounded evidence capture. Tell every delegated agent to read the project-root `MEMORY.md` before work.
 5. Write details to `docs/memory/<domain>.md`.
 6. Keep `MEMORY.md` as a short index.
 7. Use the OS locale for user-visible output unless the user asks for another language.

package/.agents/workflows/cairn-plan.md

@@ -2,20 +2,21 @@
 
 Use the `cairn-plan` skill.
 
-Goal: leave a decision-complete plan for the current task in files.
+Goal: leave a decision-complete plan for the current task in files before non-trivial implementation.
 
 Procedure:
 
-1. Read `MEMORY.md` and relevant `docs/memory/*.md`.
-2. If the active or assigned model is Claude-family, read `docs/model-guidance/claude.md`; if Codex-family, read `docs/model-guidance/codex.md`.
-3. Run `scripts/cairn toolcheck` when available.
-4. If required LSP/check tools are missing, run `scripts/cairn toolcheck --install` or a repository-native install command before accepting a fallback.
-5. Explore before asking the user.
-6. Run complexity triage before applying agent, plugin, or delegated workflow guidance.
-7. Use Light Path by default unless a Heavy Path condition clearly applies.
-8. Use `explorer` for independent read-only discovery, impact analysis, pattern search, and read-only verification when available.
-9. Use `worker` for bounded implementation or verification tasks with clear file ownership. Keep urgent blocking work local.
-10. Write `docs/plan/<topic>.md`.
-11. Add the topic link and status to `PLAN.md`.
-12. Put tool readiness, module acceptance verification, and surface integration verification on every module slice.
-13. Use the OS locale for user-visible output unless the user asks for another language.
+1. Every agent must read the project-root `MEMORY.md` for domain knowledge and repository policy before repository exploration, tool selection, work, or delegation.
+2. Read relevant `docs/memory/*.md`.
+3. If the active or assigned model is Claude-family, read `docs/model-guidance/claude.md`; if Codex-family, read `docs/model-guidance/codex.md`.
+4. Run `node scripts/cairn.mjs toolcheck` when available.
+5. If required LSP/check tools are missing, run `node scripts/cairn.mjs toolcheck --install` or a repository-native install command before accepting a fallback.
+6. Explore before asking the user.
+7. Run complexity triage before applying agent, plugin, or delegated workflow guidance, and record it before mutating files.
+8. Use Light Path by default unless a Heavy Path condition clearly applies.
+9. Use `explorer` for independent read-only discovery, impact analysis, pattern search, and read-only verification when available.
+10. Use `worker` for bounded implementation or verification tasks with clear file ownership. Tell every delegated agent to read the project-root `MEMORY.md` before work. Keep urgent blocking work local.
+11. Write `docs/plan/<topic>.md`.
+12. Add the topic link and status to `PLAN.md`.
+13. Put the selected Light/Heavy Path, checked Heavy Path signals, tool readiness, module acceptance verification, and surface integration verification on every module slice.
+14. Use the OS locale for user-visible output unless the user asks for another language.

package/.agents/workflows/cairn-review.md

@@ -6,9 +6,9 @@ Goal: review completed work against plan, memory, policy, and evidence.
 
 Procedure:
 
-1. Read the plan slice and memory inputs.
+1. Every agent must read the project-root `MEMORY.md` for domain knowledge and repository policy before review work, then read the plan slice and memory inputs.
 2. Check changed files, tool readiness evidence, and verification evidence.
-3. Delegate independent read-only review to `explorer` when it materially improves speed or quality; use `worker` only for scoped verification reruns or QA artifacts.
+3. Delegate independent read-only review to `explorer` when it materially improves speed or quality; use `worker` only for scoped verification reruns or QA artifacts. Tell every delegated agent to read the project-root `MEMORY.md` before work.
 4. Report findings first, ordered by severity, with file and line references. If no issues are found, say so clearly and mention remaining test gaps or residual risk.
 5. Record review evidence in `docs/plan/<topic>.md`.
 6. Use the OS locale for user-visible output unless the user asks for another language.

package/.agents/workflows/cairn-toolcheck.md

@@ -5,13 +5,13 @@ Goal: detect repository stacks and check required LSP, typecheck, lint, dry-run,
 Run the local command first:
 
 ```sh
-scripts/cairn toolcheck
+node scripts/cairn.mjs toolcheck
 ```
 
 If required tools are missing, attempt repository-native installation:
 
 ```sh
-scripts/cairn toolcheck --install
+node scripts/cairn.mjs toolcheck --install
 ```
 
 Record detected stacks, missing tools, install attempts, and blockers in the related `docs/plan/<topic>.md`.

package/.agents/workflows/cairn-uninstall.md

@@ -11,7 +11,7 @@ bunx cairn-ai@latest uninstall
 When running from local source:
 
 ```sh
-scripts/cairn uninstall
+node scripts/cairn.mjs uninstall
 ```
 
 The source work folder and user-created `MEMORY.md`, `PLAN.md`, `docs/memory`, and `docs/plan` files are not deleted.

package/.agents/workflows/cairn-upgrade.md

@@ -11,7 +11,7 @@ bunx cairn-ai@latest upgrade
 When running from local source:
 
 ```sh
-scripts/cairn upgrade
+node scripts/cairn.mjs upgrade
 ```
 
 After upgrade, check status with the `cairn-doctor` workflow.

package/.agents/workflows/cairn-work.md

@@ -2,19 +2,20 @@
 
 Use the `cairn-work` skill.
 
-Goal: execute the next incomplete module slice in `PLAN.md`.
+Goal: execute the next incomplete module slice in `PLAN.md` without bypassing the recorded complexity triage.
 
 Procedure:
 
-1. Read `PLAN.md`, the detailed plan, `MEMORY.md`, and relevant memory notes.
-2. Read the Codex or Claude model guidance recorded in the plan.
-3. Select one small module slice.
-4. Confirm required tool readiness. If a required LSP/check tool is missing, run `scripts/cairn toolcheck --install` or a repository-native install command before accepting a fallback.
-5. Confirm the complexity triage and selected Light/Heavy Path recorded in the plan.
-6. For Light Path, implement directly or use one bounded `worker`, then run focused verification.
-7. For Heavy Path, follow the plan's staged implementation and review gates without role-mapping shortcuts.
-8. When delegating implementation to `worker`, state the file ownership clearly and tell the worker not to revert others' edits.
-9. Re-run module acceptance verification.
-10. Re-run surface integration verification.
-11. Record tool readiness and verification evidence in `docs/plan/<topic>.md` and update `PLAN.md`.
-12. Use the OS locale for user-visible output unless the user asks for another language.
+1. Every agent must read the project-root `MEMORY.md` for domain knowledge and repository policy before selecting or executing a slice.
+2. Read `PLAN.md`, the detailed plan, and relevant memory notes.
+3. Read the Codex or Claude model guidance recorded in the plan.
+4. Select one small module slice.
+5. Confirm required tool readiness. If a required LSP/check tool is missing, run `node scripts/cairn.mjs toolcheck --install` or a repository-native install command before accepting a fallback.
+6. Confirm the complexity triage and selected Light/Heavy Path recorded in the plan. If missing, update the plan before mutating files.
+7. For Light Path, implement directly or use one bounded `worker`, then run focused verification.
+8. For Heavy Path, follow the plan's staged implementation and review gates without role-mapping shortcuts.
+9. When delegating implementation to `worker`, state the file ownership clearly, tell every delegated agent to read the project-root `MEMORY.md` before work, and tell the worker not to revert others' edits.
+10. Re-run module acceptance verification.
+11. Re-run surface integration verification.
+12. Record tool readiness and verification evidence in `docs/plan/<topic>.md` and update `PLAN.md`.
+13. Use the OS locale for user-visible output unless the user asks for another language.

package/.claude/agents/explorer.md

@@ -2,4 +2,6 @@
 
 Read-only discovery agent for codebase questions, impact analysis, pattern search, and verification.
 
+Before any task, read the project-root `MEMORY.md` for domain knowledge and repository policy.
+
 Refer to `agents/explorer.md`.

package/.claude/agents/worker.md

@@ -2,4 +2,6 @@
 
 Focused execution agent for search, small edits, command checks, and QA artifacts.
 
+Before any task, read the project-root `MEMORY.md` for domain knowledge and repository policy.
+
 Refer to `agents/worker.md`.

package/.claude/commands/cairn-doctor.md

@@ -3,7 +3,7 @@
 Diagnose Cairn installation status.
 
 ```sh
-scripts/cairn doctor
+node scripts/cairn.mjs doctor
 ```
 
 Published package:

package/.claude/commands/cairn-install.md

@@ -3,7 +3,7 @@
 Install Cairn into Codex, Claude Code, and Antigravity.
 
 ```sh
-scripts/cairn install
+node scripts/cairn.mjs install
 ```
 
 Published package:

package/.claude/commands/cairn-plan.md

@@ -1,5 +1,5 @@
 # cairn-plan
 
-Create or update `PLAN.md` and `docs/plan/<topic>.md`, including tool readiness.
+Start by reading the project-root `MEMORY.md`, then create or update `PLAN.md` and `docs/plan/<topic>.md` before non-trivial implementation, including Light/Heavy Path complexity triage and tool readiness.
 
 Follow plugin command `commands/cairn-plan.md`.

package/.claude/commands/cairn-toolcheck.md

@@ -3,8 +3,8 @@
 Detect repository stacks and check required LSP, typecheck, lint, dry-run, and verification tools.
 
 ```sh
-scripts/cairn toolcheck
-scripts/cairn toolcheck --install
+node scripts/cairn.mjs toolcheck
+node scripts/cairn.mjs toolcheck --install
 ```
 
 Use `--install` before accepting a missing required tool as unavailable.

package/.claude/commands/cairn-uninstall.md

@@ -3,7 +3,7 @@
 Remove the Codex, Claude Code, and Antigravity entries installed by Cairn.
 
 ```sh
-scripts/cairn uninstall
+node scripts/cairn.mjs uninstall
 ```
 
 Published package:

package/.claude/commands/cairn-upgrade.md

@@ -3,7 +3,7 @@
 Update the Cairn installation from the current source.
 
 ```sh
-scripts/cairn upgrade
+node scripts/cairn.mjs upgrade
 ```
 
 Published package:

package/.claude/commands/cairn-work.md

@@ -1,5 +1,5 @@
 # cairn-work
 
-Execute the next incomplete module slice with tool readiness, module acceptance verification, and surface integration verification.
+Start by reading the project-root `MEMORY.md`, then execute the next incomplete module slice only after the plan records Light/Heavy Path complexity triage, tool readiness, module acceptance verification, and surface integration verification.
 
 Follow plugin command `commands/cairn-work.md`.

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cairn",
-  "version": "0.1.1",
+  "version": "0.1.5",
   "description": "Token-efficient agent harness with tool readiness for Codex, Claude Code, and Antigravity.",
   "author": {
     "name": "WkNam"
@@ -22,9 +22,11 @@
     ],
     "defaultPrompt": [
       "Use Cairn to create MEMORY.md and PLAN.md for this repository.",
+      "At the start of each task, every agent must read the project-root MEMORY.md for domain knowledge and repository policy before planning, implementation, review, or delegation.",
       "Run cairn-toolcheck before planning implementation work.",
-      "Run cairn-plan for this task without asking me for discoverable facts.",
-      "Run cairn-work from the current PLAN.md and pass both verification gates."
+      "Before non-trivial implementation, run cairn-plan for this task without asking me for discoverable facts.",
+      "Record Light Path or Heavy Path complexity triage in docs/plan/<topic>.md before mutating files.",
+      "Run cairn-work from the current PLAN.md and pass dry-run/check, module acceptance, and surface integration gates."
     ]
   }
 }

package/agents/explorer.md

@@ -9,6 +9,8 @@ tools: Read, Grep, Glob, Bash
 
 Handle read-only discovery and verification tasks.
 
+Before doing any assigned task, read the project-root `MEMORY.md`. Treat it as the domain knowledge and repository policy index, then read only the relevant `docs/memory/*.md` notes needed for the task.
+
 Use for:
 
 - Codebase questions.

package/agents/worker.md

@@ -9,6 +9,8 @@ tools: Read, Grep, Glob, Bash, Write, Edit, MultiEdit
 
 Handle narrow, focused tasks.
 
+Before doing any assigned task, read the project-root `MEMORY.md`. Treat it as the domain knowledge and repository policy index, then read only the relevant `docs/memory/*.md` notes needed for the task.
+
 Use for:
 
 - Finding exact files and symbols.

package/commands/cairn-doctor.md

@@ -5,7 +5,7 @@ Goal: diagnose Cairn installation status.
 Run:
 
 ```sh
-scripts/cairn doctor
+node scripts/cairn.mjs doctor
 ```
 
 With the published package:

package/commands/cairn-install.md

@@ -5,7 +5,7 @@ Goal: install Cairn into Codex, Claude Code, and Antigravity.
 Run:
 
 ```sh
-scripts/cairn install
+node scripts/cairn.mjs install
 ```
 
 With the published package:

package/commands/cairn-memory.md

@@ -2,16 +2,16 @@
 
 Use the `cairn-memory` skill.
 
-Prerequisite: if `scripts/cairn doctor` fails, restore installation with `scripts/cairn install` or `scripts/cairn upgrade`.
+Prerequisite: if `node scripts/cairn.mjs doctor` fails, restore installation with `node scripts/cairn.mjs install` or `node scripts/cairn.mjs upgrade`.
 
 Goal: create or update repository memory without asking the user for discoverable facts.
 
 Procedure:
 
 1. Run the plugin state initialization script.
-2. Read `MEMORY.md`.
+2. Every agent must read the project-root `MEMORY.md` for domain knowledge and repository policy before assigned discovery or update work.
 3. Explore repository facts with focused tools.
-4. Use `explorer` for read-only domain discovery and contradiction checks when available; use `worker` for exact references, command checks, and bounded evidence capture.
+4. Use `explorer` for read-only domain discovery and contradiction checks when available; use `worker` for exact references, command checks, and bounded evidence capture. Tell every delegated agent to read the project-root `MEMORY.md` before work.
 5. Write details to `docs/memory/<domain>.md`.
 6. Keep `MEMORY.md` as a short index.
 7. Use the OS locale for user-visible output unless the user asks for another language.

package/commands/cairn-plan.md

@@ -2,22 +2,23 @@
 
 Use the `cairn-plan` skill.
 
-Prerequisite: if `scripts/cairn doctor` fails, restore installation with `scripts/cairn install` or `scripts/cairn upgrade`.
+Prerequisite: if `node scripts/cairn.mjs doctor` fails, restore installation with `node scripts/cairn.mjs install` or `node scripts/cairn.mjs upgrade`.
 
-Goal: leave a decision-complete plan for the current task in files.
+Goal: leave a decision-complete plan for the current task in files before non-trivial implementation.
 
 Procedure:
 
-1. Read `MEMORY.md` and relevant `docs/memory/*.md`.
-2. If the active or assigned model is Claude-family, read `docs/model-guidance/claude.md`; if Codex-family, read `docs/model-guidance/codex.md`.
-3. Run `scripts/cairn toolcheck` when available.
-4. If required LSP/check tools are missing, run `scripts/cairn toolcheck --install` or a repository-native install command before accepting a fallback.
-5. Explore before asking the user.
-6. Run complexity triage before applying agent, plugin, or delegated workflow guidance.
-7. Use Light Path by default unless a Heavy Path condition clearly applies.
-8. Use `explorer` for independent read-only discovery, impact analysis, pattern search, and read-only verification when available.
-9. Use `worker` for bounded implementation or verification tasks with clear file ownership. Keep urgent blocking work local.
-10. Write `docs/plan/<topic>.md`.
-11. Add the topic link and status to `PLAN.md`.
-12. Put tool readiness, module acceptance verification, and surface integration verification on every module slice.
-13. Use the OS locale for user-visible output unless the user asks for another language.
+1. Every agent must read the project-root `MEMORY.md` for domain knowledge and repository policy before repository exploration, tool selection, work, or delegation.
+2. Read relevant `docs/memory/*.md`.
+3. If the active or assigned model is Claude-family, read `docs/model-guidance/claude.md`; if Codex-family, read `docs/model-guidance/codex.md`.
+4. Run `node scripts/cairn.mjs toolcheck` when available.
+5. If required LSP/check tools are missing, run `node scripts/cairn.mjs toolcheck --install` or a repository-native install command before accepting a fallback.
+6. Explore before asking the user.
+7. Run complexity triage before applying agent, plugin, or delegated workflow guidance, and record it before mutating files.
+8. Use Light Path by default unless a Heavy Path condition clearly applies.
+9. Use `explorer` for independent read-only discovery, impact analysis, pattern search, and read-only verification when available.
+10. Use `worker` for bounded implementation or verification tasks with clear file ownership. Tell every delegated agent to read the project-root `MEMORY.md` before work. Keep urgent blocking work local.
+11. Write `docs/plan/<topic>.md`.
+12. Add the topic link and status to `PLAN.md`.
+13. Put the selected Light/Heavy Path, checked Heavy Path signals, tool readiness, module acceptance verification, and surface integration verification on every module slice.
+14. Use the OS locale for user-visible output unless the user asks for another language.

package/commands/cairn-review.md

@@ -2,15 +2,15 @@
 
 Use the `cairn-review` skill.
 
-Prerequisite: if `scripts/cairn doctor` fails, restore installation with `scripts/cairn install` or `scripts/cairn upgrade`.
+Prerequisite: if `node scripts/cairn.mjs doctor` fails, restore installation with `node scripts/cairn.mjs install` or `node scripts/cairn.mjs upgrade`.
 
 Goal: review completed work against plan, memory, policy, and evidence.
 
 Procedure:
 
-1. Read the plan slice and memory inputs.
+1. Every agent must read the project-root `MEMORY.md` for domain knowledge and repository policy before review work, then read the plan slice and memory inputs.
 2. Check changed files, tool readiness evidence, and verification evidence.
-3. Delegate independent read-only review to `explorer` when it materially improves speed or quality; use `worker` only for scoped verification reruns or QA artifacts.
+3. Delegate independent read-only review to `explorer` when it materially improves speed or quality; use `worker` only for scoped verification reruns or QA artifacts. Tell every delegated agent to read the project-root `MEMORY.md` before work.
 4. Report findings first, ordered by severity, with file and line references. If no issues are found, say so clearly and mention remaining test gaps or residual risk.
 5. Record review evidence in `docs/plan/<topic>.md`.
 6. Use the OS locale for user-visible output unless the user asks for another language.

package/commands/cairn-toolcheck.md

@@ -12,8 +12,8 @@ bunx cairn-ai@latest toolcheck --install
 From this repository:
 
 ```sh
-scripts/cairn toolcheck
-scripts/cairn toolcheck --install
+node scripts/cairn.mjs toolcheck
+node scripts/cairn.mjs toolcheck --install
 ```
 
 Use `--install` when a required tool is missing. Record detected stacks, missing tools, install attempts, and blockers in the related `docs/plan/<topic>.md`.

package/commands/cairn-uninstall.md

@@ -5,7 +5,7 @@ Goal: remove the Codex, Claude Code, and Antigravity entries installed by Cairn.
 Run:
 
 ```sh
-scripts/cairn uninstall
+node scripts/cairn.mjs uninstall
 ```
 
 With the published package:

package/commands/cairn-upgrade.md

@@ -5,7 +5,7 @@ Goal: update the Cairn installation from the current source.
 Run:
 
 ```sh
-scripts/cairn upgrade
+node scripts/cairn.mjs upgrade
 ```
 
 With the published package:

package/commands/cairn-work.md

@@ -2,21 +2,22 @@
 
 Use the `cairn-work` skill.
 
-Prerequisite: if `scripts/cairn doctor` fails, restore installation with `scripts/cairn install` or `scripts/cairn upgrade`.
+Prerequisite: if `node scripts/cairn.mjs doctor` fails, restore installation with `node scripts/cairn.mjs install` or `node scripts/cairn.mjs upgrade`.
 
-Goal: execute the next incomplete module slice in `PLAN.md`.
+Goal: execute the next incomplete module slice in `PLAN.md` without bypassing the recorded complexity triage.
 
 Procedure:
 
-1. Read `PLAN.md`, the detailed plan, `MEMORY.md`, and relevant memory notes.
-2. Read the Codex or Claude model guidance recorded in the plan.
-3. Select one small module slice.
-4. Confirm required tool readiness. If a required LSP/check tool is missing, run `scripts/cairn toolcheck --install` or a repository-native install command before accepting a fallback.
-5. Confirm the complexity triage and selected Light/Heavy Path recorded in the plan.
-6. For Light Path, implement directly or use one bounded `worker`, then run focused verification.
-7. For Heavy Path, follow the plan's staged implementation and review gates without role-mapping shortcuts.
-8. When delegating implementation to `worker`, state the file ownership clearly and tell the worker not to revert others' edits.
-9. Re-run module acceptance verification.
-10. Re-run surface integration verification.
-11. Record tool readiness and verification evidence in `docs/plan/<topic>.md` and update `PLAN.md`.
-12. Use the OS locale for user-visible output unless the user asks for another language.
+1. Every agent must read the project-root `MEMORY.md` for domain knowledge and repository policy before selecting or executing a slice.
+2. Read `PLAN.md`, the detailed plan, and relevant memory notes.
+3. Read the Codex or Claude model guidance recorded in the plan.
+4. Select one small module slice.
+5. Confirm required tool readiness. If a required LSP/check tool is missing, run `node scripts/cairn.mjs toolcheck --install` or a repository-native install command before accepting a fallback.
+6. Confirm the complexity triage and selected Light/Heavy Path recorded in the plan. If missing, update the plan before mutating files.
+7. For Light Path, implement directly or use one bounded `worker`, then run focused verification.
+8. For Heavy Path, follow the plan's staged implementation and review gates without role-mapping shortcuts.
+9. When delegating implementation to `worker`, state the file ownership clearly, tell every delegated agent to read the project-root `MEMORY.md` before work, and tell the worker not to revert others' edits.
+10. Re-run module acceptance verification.
+11. Re-run surface integration verification.
+12. Record tool readiness and verification evidence in `docs/plan/<topic>.md` and update `PLAN.md`.
+13. Use the OS locale for user-visible output unless the user asks for another language.

package/hooks/hooks.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "sh \"${PLUGIN_ROOT}/scripts/cairn-state.sh\" session-start",
+            "command": "node \"${PLUGIN_ROOT}/scripts/cairn-state.mjs\" session-start",
             "timeout": 10,
             "statusMessage": "Cairn: preparing repository memory and plan indexes"
           }
@@ -17,7 +17,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "sh \"${PLUGIN_ROOT}/scripts/cairn-state.sh\" user-prompt-submit",
+            "command": "node \"${PLUGIN_ROOT}/scripts/cairn-state.mjs\" user-prompt-submit",
             "timeout": 10,
             "statusMessage": "Cairn: loading compact work context"
           }
@@ -30,7 +30,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "sh \"${PLUGIN_ROOT}/scripts/cairn-state.sh\" post-tool-use",
+            "command": "node \"${PLUGIN_ROOT}/scripts/cairn-state.mjs\" post-tool-use",
             "timeout": 10,
             "statusMessage": "Cairn: checking memory and plan indexes"
           }
@@ -42,7 +42,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "sh \"${PLUGIN_ROOT}/scripts/cairn-state.sh\" stop",
+            "command": "node \"${PLUGIN_ROOT}/scripts/cairn-state.mjs\" stop",
             "timeout": 10,
             "statusMessage": "Cairn: checking two-gate evidence requirements"
           }
@@ -54,7 +54,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "sh \"${PLUGIN_ROOT}/scripts/cairn-state.sh\" subagent-stop",
+            "command": "node \"${PLUGIN_ROOT}/scripts/cairn-state.mjs\" subagent-stop",
             "timeout": 10,
             "statusMessage": "Cairn: checking subagent handoff evidence"
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cairn-ai",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Token-efficient agent harness with tool readiness for Codex, Claude Code, and Antigravity",
   "license": "MIT",
   "author": {
@@ -21,8 +21,8 @@
     "workflow"
   ],
   "bin": {
-    "cairn": "scripts/cairn",
-    "cairn-ai": "scripts/cairn"
+    "cairn": "scripts/cairn.mjs",
+    "cairn-ai": "scripts/cairn.mjs"
   },
   "files": [
     ".agents/",
@@ -39,7 +39,7 @@
     "README.*.md"
   ],
   "scripts": {
-    "check": "node --check scripts/cairn-lifecycle.mjs && node --check scripts/cairn-toolcheck.mjs && node -e \"JSON.parse(require('node:fs').readFileSync('package.json','utf8')); JSON.parse(require('node:fs').readFileSync('.codex-plugin/plugin.json','utf8')); JSON.parse(require('node:fs').readFileSync('hooks/hooks.json','utf8'))\" && npm test",
+    "check": "node --check scripts/cairn.mjs && node --check scripts/cairn-state.mjs && node --check scripts/cairn-lifecycle.mjs && node --check scripts/cairn-toolcheck.mjs && node -e \"JSON.parse(require('node:fs').readFileSync('package.json','utf8')); JSON.parse(require('node:fs').readFileSync('.codex-plugin/plugin.json','utf8')); JSON.parse(require('node:fs').readFileSync('hooks/hooks.json','utf8'))\" && npm test",
     "test": "node --test",
     "prepack": "npm run check"
   },