cairn-ai 0.1.2 → 0.1.4

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-plan.md

@@ -8,8 +8,8 @@ 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.
+3. Run `node scripts/cairn.mjs toolcheck` when available.
+4. If required LSP/check tools are missing, run `node scripts/cairn.mjs 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.

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

@@ -9,7 +9,7 @@ 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.
+4. 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.
 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.

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-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/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,7 +2,7 @@
 
 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.
 

package/commands/cairn-plan.md

@@ -2,7 +2,7 @@
 
 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.
 
@@ -10,8 +10,8 @@ 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.
+3. Run `node scripts/cairn.mjs toolcheck` when available.
+4. If required LSP/check tools are missing, run `node scripts/cairn.mjs 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.

package/commands/cairn-review.md

@@ -2,7 +2,7 @@
 
 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.
 

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,7 +2,7 @@
 
 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`.
 
@@ -11,7 +11,7 @@ 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.
+4. 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.
 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.

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.4",
   "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"
   },

package/scripts/cairn

@@ -1,10 +1,6 @@
 #!/bin/sh
 set -eu
 
-cmd="${1:-help}"
-shift || true
-locale="${LC_ALL:-${LC_MESSAGES:-${LANG:-en}}}"
-
 script_path="$0"
 link_target="$(readlink "$script_path" 2>/dev/null || true)"
 if [ -n "$link_target" ]; then
@@ -15,101 +11,4 @@ if [ -n "$link_target" ]; then
 fi
 script_dir="$(cd "$(dirname "$script_path")" && pwd)"
 
-locale_family() {
-  case "$locale" in
-    ko*|KO*) printf '%s\n' ko ;;
-    ja*|JA*) printf '%s\n' ja ;;
-    zh*|ZH*) printf '%s\n' zh ;;
-    es*|ES*) printf '%s\n' es ;;
-    fr*|FR*) printf '%s\n' fr ;;
-    de*|DE*) printf '%s\n' de ;;
-    pt*|PT*) printf '%s\n' pt ;;
-    *) printf '%s\n' en ;;
-  esac
-}
-
-say() {
-  key="$1"
-  family="$(locale_family)"
-  case "$family:$key" in
-    ko:memory) printf '%s\n' "cairn-memory 스킬을 사용하세요. MEMORY.md는 짧은 색인으로, 상세 내용은 docs/memory/<domain>.md에 기록합니다." ;;
-    ko:plan) printf '%s\n' "cairn-plan 스킬을 사용하세요. PLAN.md는 색인으로, 상세 계획은 docs/plan/<topic>.md에 기록합니다." ;;
-    ko:work) printf '%s\n' "cairn-work 스킬을 사용하세요. 하나의 모듈 조각을 실행하고 모듈 증거와 표면 증거를 확보합니다." ;;
-    ko:review) printf '%s\n' "cairn-review 스킬을 사용하세요. PLAN.md와 MEMORY.md 기준으로 증거를 비교합니다." ;;
-    ko:toolcheck) printf '%s\n' "저장소 도구를 점검하려면 cairn toolcheck 를 실행하세요. 누락 도구 설치까지 시도하려면 cairn toolcheck --install 을 사용합니다." ;;
-    ko:usage) printf '%s\n' "사용법: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck" ;;
-    ja:memory) printf '%s\n' "cairn-memory スキルを使用してください。MEMORY.md は短い索引にし、詳細は docs/memory/<domain>.md に記録します。" ;;
-    ja:plan) printf '%s\n' "cairn-plan スキルを使用してください。PLAN.md は索引にし、詳細計画は docs/plan/<topic>.md に記録します。" ;;
-    ja:work) printf '%s\n' "cairn-work スキルを使用してください。1つのモジュールスライスを実行し、モジュール証拠と表面証拠を取得します。" ;;
-    ja:review) printf '%s\n' "cairn-review スキルを使用してください。PLAN.md と MEMORY.md に照らして証拠を比較します。" ;;
-    ja:toolcheck) printf '%s\n' "リポジトリツールを確認するには cairn toolcheck を実行してください。不足ツールのインストールも試すには cairn toolcheck --install を使用します。" ;;
-    ja:usage) printf '%s\n' "使い方: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck" ;;
-    zh:memory) printf '%s\n' "使用 cairn-memory skill。将 MEMORY.md 保持为简短索引，并将详细内容写入 docs/memory/<domain>.md。" ;;
-    zh:plan) printf '%s\n' "使用 cairn-plan skill。将 PLAN.md 保持为索引，并将详细计划写入 docs/plan/<topic>.md。" ;;
-    zh:work) printf '%s\n' "使用 cairn-work skill。执行一个模块切片，并收集模块证据和表面证据。" ;;
-    zh:review) printf '%s\n' "使用 cairn-review skill。根据 PLAN.md 和 MEMORY.md 对比证据。" ;;
-    zh:toolcheck) printf '%s\n' "运行 cairn toolcheck 检查仓库工具。使用 cairn toolcheck --install 尝试安装缺失工具。" ;;
-    zh:usage) printf '%s\n' "用法: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck" ;;
-    es:memory) printf '%s\n' "Usa la skill cairn-memory. Mantén MEMORY.md como un índice breve y escribe los detalles en docs/memory/<domain>.md." ;;
-    es:plan) printf '%s\n' "Usa la skill cairn-plan. Mantén PLAN.md como índice y escribe los planes detallados en docs/plan/<topic>.md." ;;
-    es:work) printf '%s\n' "Usa la skill cairn-work. Ejecuta un solo segmento de módulo y captura evidencia de módulo y de superficie." ;;
-    es:review) printf '%s\n' "Usa la skill cairn-review. Compara la evidencia con PLAN.md y MEMORY.md." ;;
-    es:toolcheck) printf '%s\n' "Ejecuta cairn toolcheck para revisar herramientas del repositorio. Usa cairn toolcheck --install para intentar instalar herramientas faltantes." ;;
-    es:usage) printf '%s\n' "Uso: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck" ;;
-    fr:memory) printf '%s\n' "Utilisez la skill cairn-memory. Gardez MEMORY.md comme index court et écrivez les détails dans docs/memory/<domain>.md." ;;
-    fr:plan) printf '%s\n' "Utilisez la skill cairn-plan. Gardez PLAN.md comme index et écrivez les plans détaillés dans docs/plan/<topic>.md." ;;
-    fr:work) printf '%s\n' "Utilisez la skill cairn-work. Exécutez une tranche de module et capturez les preuves de module et de surface." ;;
-    fr:review) printf '%s\n' "Utilisez la skill cairn-review. Comparez les preuves avec PLAN.md et MEMORY.md." ;;
-    fr:toolcheck) printf '%s\n' "Exécutez cairn toolcheck pour vérifier les outils du dépôt. Utilisez cairn toolcheck --install pour tenter d'installer les outils manquants." ;;
-    fr:usage) printf '%s\n' "Utilisation: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck" ;;
-    de:memory) printf '%s\n' "Verwenden Sie die Skill cairn-memory. Halten Sie MEMORY.md als kurzen Index und schreiben Sie Details nach docs/memory/<domain>.md." ;;
-    de:plan) printf '%s\n' "Verwenden Sie die Skill cairn-plan. Halten Sie PLAN.md als Index und schreiben Sie Detailpläne nach docs/plan/<topic>.md." ;;
-    de:work) printf '%s\n' "Verwenden Sie die Skill cairn-work. Führen Sie einen Modulabschnitt aus und erfassen Sie Modul- und Oberflächenbelege." ;;
-    de:review) printf '%s\n' "Verwenden Sie die Skill cairn-review. Vergleichen Sie Belege mit PLAN.md und MEMORY.md." ;;
-    de:toolcheck) printf '%s\n' "Führen Sie cairn toolcheck aus, um Repository-Tools zu prüfen. Verwenden Sie cairn toolcheck --install, um fehlende Tools zu installieren." ;;
-    de:usage) printf '%s\n' "Verwendung: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck" ;;
-    pt:memory) printf '%s\n' "Use a skill cairn-memory. Mantenha MEMORY.md como um índice curto e escreva detalhes em docs/memory/<domain>.md." ;;
-    pt:plan) printf '%s\n' "Use a skill cairn-plan. Mantenha PLAN.md como índice e escreva planos detalhados em docs/plan/<topic>.md." ;;
-    pt:work) printf '%s\n' "Use a skill cairn-work. Execute uma fatia de módulo e capture evidências de módulo e de superfície." ;;
-    pt:review) printf '%s\n' "Use a skill cairn-review. Compare evidências com PLAN.md e MEMORY.md." ;;
-    pt:toolcheck) printf '%s\n' "Execute cairn toolcheck para verificar ferramentas do repositório. Use cairn toolcheck --install para tentar instalar ferramentas ausentes." ;;
-    pt:usage) printf '%s\n' "Uso: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck" ;;
-    *)
-      case "$key" in
-        memory) printf '%s\n' "Use the cairn-memory skill. Keep MEMORY.md as a short index and write details to docs/memory/<domain>.md." ;;
-        plan) printf '%s\n' "Use the cairn-plan skill. Keep PLAN.md as an index and write detailed plans to docs/plan/<topic>.md." ;;
-        work) printf '%s\n' "Use the cairn-work skill. Execute one module slice and capture module and surface evidence." ;;
-        review) printf '%s\n' "Use the cairn-review skill. Compare evidence against PLAN.md and MEMORY.md." ;;
-        toolcheck) printf '%s\n' "Run cairn toolcheck to inspect repository tools. Use cairn toolcheck --install to attempt missing tool installation." ;;
-        usage) printf '%s\n' "Usage: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck" ;;
-      esac
-      ;;
-  esac
-}
-
-case "$cmd" in
-  install|upgrade|doctor|uninstall)
-    node "$script_dir/cairn-lifecycle.mjs" "$cmd" "$@"
-    ;;
-  init)
-    sh "$script_dir/cairn-state.sh" manual
-    ;;
-  memory)
-    say memory
-    ;;
-  plan)
-    say plan
-    ;;
-  work)
-    say work
-    ;;
-  review)
-    say review
-    ;;
-  toolcheck)
-    node "$script_dir/cairn-toolcheck.mjs" "$@"
-    ;;
-  *)
-    say usage
-    ;;
-esac
+exec node "$script_dir/cairn.mjs" "$@"

package/scripts/cairn-lifecycle.mjs

@@ -2,14 +2,16 @@
 import { createHash } from "node:crypto";
 import { realpathSync } from "node:fs";
 import { cp, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
-import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
 const pluginRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-const codexHome = resolve(process.env.CODEX_HOME ?? join(process.env.HOME ?? ".", ".codex"));
-const claudeHome = resolve(process.env.CLAUDE_HOME ?? join(process.env.HOME ?? ".", ".claude"));
-const antigravityHome = resolve(process.env.ANTIGRAVITY_HOME ?? join(process.env.HOME ?? ".", ".agents"));
-const antigravityCliHome = resolve(process.env.ANTIGRAVITY_CLI_HOME ?? join(process.env.HOME ?? ".", ".gemini", "antigravity-cli"));
+const homeRoot = process.env.HOME ?? process.env.USERPROFILE ?? homedir() ?? ".";
+const codexHome = resolve(process.env.CODEX_HOME ?? join(homeRoot, ".codex"));
+const claudeHome = resolve(process.env.CLAUDE_HOME ?? join(homeRoot, ".claude"));
+const antigravityHome = resolve(process.env.ANTIGRAVITY_HOME ?? join(homeRoot, ".agents"));
+const antigravityCliHome = resolve(process.env.ANTIGRAVITY_CLI_HOME ?? join(homeRoot, ".gemini", "antigravity-cli"));
 const configPath = process.env.CODEX_CONFIG_PATH ?? join(codexHome, "config.toml");
 const marketplaceName = "cairn";
 const pluginName = "cairn";
@@ -87,7 +89,7 @@ async function copyPlugin() {
   await mkdir(dirname(installedPluginRoot), { recursive: true });
   await cp(pluginRoot, installedPluginRoot, {
     recursive: true,
-    filter: (source) => !source.includes(`${pluginRoot}/.git`) && !source.includes(`${pluginRoot}/node_modules`),
+    filter: (source) => !pathHasSegment(relative(pluginRoot, source), ".git") && !pathHasSegment(relative(pluginRoot, source), "node_modules"),
   });
   const manifestPath = join(installedPluginRoot, ".codex-plugin", "plugin.json");
   const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
@@ -257,6 +259,10 @@ function append(config, block) {
   return `${config.trimEnd()}${config.trimEnd().length === 0 ? "" : "\n\n"}${block.trimEnd()}\n`;
 }
 
+export function pathHasSegment(path, segment) {
+  return path.split(/[\\/]+/).includes(segment);
+}
+
 export function commandNames() {
   return ["install", "upgrade", "doctor", "uninstall", "memory", "plan", "work", "review", "toolcheck"];
 }

package/scripts/cairn-state.mjs

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+
+const memoryTemplate = `# MEMORY
+
+This file is a short index of persistent repository knowledge.
+
+## Domain Knowledge
+
+- Link detailed notes under \`docs/memory/\`.
+
+## Policy
+
+- Prefer precise repository exploration before implementation.
+- Preserve proper nouns, file names, variable names, service names, alert names, MCP tool names, and agent names exactly as written.
+- Read only the detailed memory files needed for the current task.
+- Write user-visible responses and artifacts in the OS locale unless the user asks for another language.
+
+## Update Rules
+
+- Keep root files short.
+- Move detailed domain knowledge to \`docs/memory/<domain>.md\`.
+- Record facts with source paths, commands, and observed behavior.
+`;
+
+const planTemplate = `# PLAN
+
+This file is a short index of active and completed work plans.
+
+## Active Plans
+
+- Link detailed plans under \`docs/plan/\`.
+
+## Completed Plans
+
+- Move completed topics here with evidence links.
+
+## Planning Rules
+
+- Plans must be decision-complete before implementation.
+- Split implementation into small module slices.
+- Detect repository stack and required LSP/check tools before implementation.
+- Install or bootstrap missing required tools before declaring them unavailable.
+- Each slice normally passes exactly two gates.
+  - Module acceptance verification.
+  - Surface integration verification.
+- Run dry-run or check mode before external-state mutation when available.
+- Use at most two verification passes per slice by default.
+- If a gate fails, diagnose once, shrink or split the slice, and rerun both gates.
+- After two failed passes, record the blocker in \`docs/plan/<topic>.md\`.
+`;
+
+if (isCliEntry()) {
+  const event = process.argv[2] ?? "manual";
+  console.log(await runState(event));
+}
+
+export async function runState(event = "manual", { root = process.env.HARNESS_REPO_ROOT ?? process.cwd(), locale = localeValue() } = {}) {
+  const resolvedRoot = resolve(root);
+  await mkdir(join(resolvedRoot, "docs", "memory"), { recursive: true });
+  await mkdir(join(resolvedRoot, "docs", "plan"), { recursive: true });
+  await writeIfMissing(join(resolvedRoot, "MEMORY.md"), memoryTemplate);
+  await writeIfMissing(join(resolvedRoot, "PLAN.md"), planTemplate);
+
+  const ko = locale.toLowerCase().startsWith("ko");
+  if (event === "session-start" || event === "user-prompt-submit") {
+    return ko
+      ? "Cairn 컨텍스트: 먼저 MEMORY.md와 PLAN.md를 읽고, 필요한 경우 toolcheck로 LSP/check 도구 준비 상태를 확인하세요."
+      : "Cairn context: read MEMORY.md and PLAN.md first, then run toolcheck when LSP/check tool readiness is needed.";
+  }
+  if (event === "post-tool-use") {
+    return ko
+      ? "Cairn 점검: 외부 상태 변경에는 dry-run/check 증거가 필요하고, 동작이 바뀌었다면 docs/plan 증거를 갱신하세요."
+      : "Cairn check: external-state changes need dry-run/check evidence; if behavior changed, update docs/plan evidence.";
+  }
+  if (event === "stop" || event === "subagent-stop") {
+    return ko
+      ? "Cairn 종료 게이트: 완료에는 docs/plan의 dry-run/check, 모듈 수용, 표면 통합 증거가 필요합니다."
+      : "Cairn stop gate: completion requires dry-run/check, module acceptance, and surface integration evidence in docs/plan.";
+  }
+  return ko
+    ? "Cairn이 MEMORY.md, PLAN.md, docs/memory, docs/plan을 초기화했습니다."
+    : "Cairn initialized MEMORY.md, PLAN.md, docs/memory, and docs/plan.";
+}
+
+async function writeIfMissing(path, content) {
+  try {
+    await readFile(path, "utf8");
+  } catch {
+    await writeFile(path, content);
+  }
+}
+
+function localeValue() {
+  return [process.env.LC_ALL, process.env.LC_MESSAGES, process.env.LANG]
+    .find((value) => typeof value === "string" && value.length > 0) ?? Intl.DateTimeFormat().resolvedOptions().locale;
+}
+
+function isCliEntry() {
+  return process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
+}

package/scripts/cairn-toolcheck.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { readdir, stat } from "node:fs/promises";
-import { join } from "node:path";
+import { join, relative, sep } from "node:path";
 import { spawnSync } from "node:child_process";
 import { pathToFileURL } from "node:url";
 
@@ -60,7 +60,7 @@ export async function collectEntries(base) {
     for (const entry of await readdir(dir)) {
       if ([".git", ".cairn", "node_modules", "vendor", "target", ".venv", "__pycache__"].includes(entry)) continue;
       const path = join(dir, entry);
-      const relativePath = path.slice(base.length + 1);
+      const relativePath = normalizePath(relative(base, path));
       if (relativePath === "test/fixtures" || relativePath.startsWith("test/fixtures/")) continue;
       const info = await stat(path);
       if (info.isDirectory()) await walk(path);
@@ -85,7 +85,7 @@ export function detectStacks(paths) {
   return [...stacks];
 }
 
-export function buildRequirements(stacks, entries = [], commandAvailable = commandOk) {
+export function buildRequirements(stacks, entries = [], commandAvailable = commandOk, platform = process.platform) {
   const requirements = [];
   if (stacks.includes("javascript")) {
     requirements.push(req("node", ["--version"], "JavaScript runtime for package scripts and CLI checks"));
@@ -98,8 +98,8 @@ export function buildRequirements(stacks, entries = [], commandAvailable = comma
   if (stacks.includes("python")) {
     const uv = commandAvailable("uv", ["--version"]);
     const project = entries.includes("pyproject.toml");
-    const basedpyrightInstall = pythonInstall(uv, project, "basedpyright");
-    const ruffInstall = pythonInstall(uv, project, "ruff");
+    const basedpyrightInstall = pythonInstall(uv, project, "basedpyright", platform);
+    const ruffInstall = pythonInstall(uv, project, "ruff", platform);
     requirements.push(req("basedpyright", ["--version"], "Python LSP/type checker", basedpyrightInstall));
     requirements.push(req("ruff", ["--version"], "Python lint and format checker", ruffInstall));
   }
@@ -114,7 +114,7 @@ export function buildRequirements(stacks, entries = [], commandAvailable = comma
   }
   if (stacks.includes("java")) {
     addJvmRequirements(requirements);
-    requirements.push(req("jdtls", ["--version"], "Java LSP server", { command: "bash", args: ["-lc", "mkdir -p .cairn/tools && curl -L https://download.eclipse.org/jdtls/milestones/latest/jdt-language-server-latest.tar.gz | tar -xz -C .cairn/tools"] }));
+    requirements.push(req("jdtls", ["--version"], "Java LSP server", jdtlsInstall(platform)));
     addJvmBuildToolRequirements(requirements, entries);
   }
   if (stacks.includes("kotlin")) {
@@ -151,9 +151,12 @@ export function addJvmRequirements(requirements) {
 }
 
 export function addJvmBuildToolRequirements(requirements, entries = []) {
-  if (entries.includes("gradlew")) pushUnique(requirements, req("./gradlew", ["--version"], "Gradle wrapper availability"));
+  if (entries.includes("gradlew.bat")) pushUnique(requirements, req("gradlew.bat", ["--version"], "Gradle wrapper availability"));
+  else if (entries.includes("gradlew")) pushUnique(requirements, req("./gradlew", ["--version"], "Gradle wrapper availability"));
   else if (entries.includes("build.gradle") || entries.includes("build.gradle.kts")) pushUnique(requirements, req("gradle", ["--version"], "Gradle availability"));
-  if (entries.includes("mvnw")) pushUnique(requirements, req("./mvnw", ["--version"], "Maven wrapper availability"));
+  if (entries.includes("mvnw.cmd")) pushUnique(requirements, req("mvnw.cmd", ["--version"], "Maven wrapper availability"));
+  else if (entries.includes("mvnw.bat")) pushUnique(requirements, req("mvnw.bat", ["--version"], "Maven wrapper availability"));
+  else if (entries.includes("mvnw")) pushUnique(requirements, req("./mvnw", ["--version"], "Maven wrapper availability"));
   else if (entries.includes("pom.xml")) pushUnique(requirements, req("mvn", ["--version"], "Maven availability"));
 }
 
@@ -165,12 +168,24 @@ export function composerInstall(packages) {
   return { command: "composer", args: ["require", "--dev", ...packages] };
 }
 
-export function pythonInstall(uv, project, tool) {
+export function pythonInstall(uv, project, tool, platform = process.platform) {
   if (uv && project) return { command: "uv", args: ["add", "--dev", tool] };
   if (uv) return { command: "uv", args: ["tool", "install", tool] };
+  if (platform === "win32") return { command: "py", args: ["-3", "-m", "pip", "install", "--user", tool] };
   return { command: "python3", args: ["-m", "pip", "install", "--user", tool] };
 }
 
+export function jdtlsInstall(platform = process.platform) {
+  const url = "https://download.eclipse.org/jdtls/milestones/latest/jdt-language-server-latest.tar.gz";
+  if (platform === "win32") {
+    return {
+      command: "powershell",
+      args: ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", `New-Item -ItemType Directory -Force .cairn/tools | Out-Null; Invoke-WebRequest -Uri ${url} -OutFile .cairn/tools/jdtls.tar.gz; tar -xzf .cairn/tools/jdtls.tar.gz -C .cairn/tools`],
+    };
+  }
+  return { command: "bash", args: ["-lc", `mkdir -p .cairn/tools && curl -L ${url} | tar -xz -C .cairn/tools`] };
+}
+
 export function req(command, args, reason, installCommand = null) {
   return { name: command, command, args, reason, install: installCommand };
 }
@@ -190,16 +205,41 @@ export function installDev(pm, packages) {
 }
 
 export function commandOk(command, args, root = process.cwd(), runner = run) {
-  if (runner(command, args).status === 0) return true;
-  if (runner(join(root, "node_modules", ".bin", command), args).status === 0) return true;
-  if (runner(join(root, "vendor", "bin", command), args).status === 0) return true;
-  return runner(join(root, ".cairn", "tools", "bin", command), args).status === 0;
+  return commandCandidates(command, root).some((candidate) => runner(candidate, args).status === 0);
+}
+
+export function commandCandidates(command, root = process.cwd(), platform = process.platform) {
+  const candidates = [
+    command,
+    join(root, "node_modules", ".bin", command),
+    join(root, "vendor", "bin", command),
+    join(root, ".cairn", "tools", "bin", command),
+  ];
+  if (platform !== "win32") return candidates;
+  const extensions = [".cmd", ".bat", ".exe"];
+  return candidates.flatMap((candidate) => hasWindowsExecutableExtension(candidate) ? [candidate] : [candidate, ...extensions.map((extension) => `${candidate}${extension}`)]);
 }
 
 export function run(command, args) {
-  return spawnSync(command, args, { stdio: "ignore", encoding: "utf8" });
+  return spawnSync(command, args, {
+    stdio: "ignore",
+    encoding: "utf8",
+    shell: shouldUseShell(command),
+  });
+}
+
+export function shouldUseShell(command, platform = process.platform) {
+  return platform === "win32" && /\.(cmd|bat)$/i.test(command);
 }
 
 function isCliEntry() {
   return process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
 }
+
+function normalizePath(path) {
+  return path.split(sep).join("/");
+}
+
+function hasWindowsExecutableExtension(command) {
+  return /\.(cmd|bat|exe)$/i.test(command);
+}

package/scripts/cairn.mjs

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { spawnSync } from "node:child_process";
+import { runState } from "./cairn-state.mjs";
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+
+export async function main(command = "help", args = [], { runner = spawnSync } = {}) {
+  if (["install", "upgrade", "doctor", "uninstall"].includes(command)) {
+    const result = runner(process.execPath, [join(scriptDir, "cairn-lifecycle.mjs"), command, ...args], { stdio: "inherit" });
+    process.exitCode = result.status ?? 1;
+    return;
+  }
+  if (command === "init") {
+    console.log(await runState("manual"));
+    return;
+  }
+  if (command === "toolcheck") {
+    const result = runner(process.execPath, [join(scriptDir, "cairn-toolcheck.mjs"), ...args], { stdio: "inherit" });
+    process.exitCode = result.status ?? 1;
+    return;
+  }
+  if (["memory", "plan", "work", "review"].includes(command)) {
+    console.log(message(command));
+    return;
+  }
+  console.log(message("usage"));
+}
+
+export function message(key, locale = localeValue()) {
+  const family = localeFamily(locale);
+  return messages[family]?.[key] ?? messages.en[key];
+}
+
+export function localeFamily(locale = localeValue()) {
+  const normalized = locale.toLowerCase();
+  for (const family of ["ko", "ja", "zh", "es", "fr", "de", "pt"]) {
+    if (normalized.startsWith(family)) return family;
+  }
+  return "en";
+}
+
+function localeValue() {
+  return [process.env.LC_ALL, process.env.LC_MESSAGES, process.env.LANG]
+    .find((value) => typeof value === "string" && value.length > 0) ?? Intl.DateTimeFormat().resolvedOptions().locale;
+}
+
+function isCliEntry() {
+  return process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
+}
+
+const messages = {
+  en: {
+    memory: "Use the cairn-memory skill. Keep MEMORY.md as a short index and write details to docs/memory/<domain>.md.",
+    plan: "Use the cairn-plan skill. Keep PLAN.md as an index and write detailed plans to docs/plan/<topic>.md.",
+    work: "Use the cairn-work skill. Execute one module slice and capture module and surface evidence.",
+    review: "Use the cairn-review skill. Compare evidence against PLAN.md and MEMORY.md.",
+    usage: "Usage: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck",
+  },
+  ko: {
+    memory: "cairn-memory 스킬을 사용하세요. MEMORY.md는 짧은 색인으로, 상세 내용은 docs/memory/<domain>.md에 기록합니다.",
+    plan: "cairn-plan 스킬을 사용하세요. PLAN.md는 색인으로, 상세 계획은 docs/plan/<topic>.md에 기록합니다.",
+    work: "cairn-work 스킬을 사용하세요. 하나의 모듈 조각을 실행하고 모듈 증거와 표면 증거를 확보합니다.",
+    review: "cairn-review 스킬을 사용하세요. PLAN.md와 MEMORY.md 기준으로 증거를 비교합니다.",
+    usage: "사용법: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck",
+  },
+  ja: {
+    memory: "cairn-memory スキルを使用してください。MEMORY.md は短い索引にし、詳細は docs/memory/<domain>.md に記録します。",
+    plan: "cairn-plan スキルを使用してください。PLAN.md は索引にし、詳細計画は docs/plan/<topic>.md に記録します。",
+    work: "cairn-work スキルを使用してください。1つのモジュールスライスを実行し、モジュール証拠と表面証拠を取得します。",
+    review: "cairn-review スキルを使用してください。PLAN.md と MEMORY.md に照らして証拠を比較します。",
+    usage: "使い方: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck",
+  },
+  zh: {
+    memory: "使用 cairn-memory skill。将 MEMORY.md 保持为简短索引，并将详细内容写入 docs/memory/<domain>.md。",
+    plan: "使用 cairn-plan skill。将 PLAN.md 保持为索引，并将详细计划写入 docs/plan/<topic>.md。",
+    work: "使用 cairn-work skill。执行一个模块切片，并收集模块证据。",
+    review: "使用 cairn-review skill。根据 PLAN.md 和 MEMORY.md 对比证据。",
+    usage: "用法: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck",
+  },
+  es: {
+    memory: "Usa la skill cairn-memory. Mantén MEMORY.md como un índice breve y escribe los detalles en docs/memory/<domain>.md.",
+    plan: "Usa la skill cairn-plan. Mantén PLAN.md como índice y escribe los planes detallados en docs/plan/<topic>.md.",
+    work: "Usa la skill cairn-work. Ejecuta un solo segmento de módulo y captura evidencia de módulo y de superficie.",
+    review: "Usa la skill cairn-review. Compara la evidencia con PLAN.md y MEMORY.md.",
+    usage: "Uso: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck",
+  },
+  fr: {
+    memory: "Utilisez la skill cairn-memory. Gardez MEMORY.md comme index court et écrivez les détails dans docs/memory/<domain>.md.",
+    plan: "Utilisez la skill cairn-plan. Gardez MEMORY.md comme index et écrivez les plans détaillés dans docs/plan/<topic>.md.",
+    work: "Utilisez la skill cairn-work. Exécutez une tranche de module et capturez les preuves de module et de surface.",
+    review: "Utilisez la skill cairn-review. Comparez les preuves avec PLAN.md et MEMORY.md.",
+    usage: "Utilisation: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck",
+  },
+  de: {
+    memory: "Verwenden Sie die Skill cairn-memory. Halten Sie MEMORY.md als kurzen Index und schreiben Sie Details nach docs/memory/<domain>.md.",
+    plan: "Verwenden Sie die Skill cairn-plan. Halten Sie MEMORY.md als Index und schreiben Sie Detailpläne nach docs/plan/<topic>.md.",
+    work: "Verwenden Sie die Skill cairn-work. Führen Sie einen Modulabschnitt aus und erfassen Sie Modul- und Oberflächenbelege.",
+    review: "Verwenden Sie die Skill cairn-review. Vergleichen Sie Belege mit PLAN.md und MEMORY.md.",
+    usage: "Verwendung: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck",
+  },
+  pt: {
+    memory: "Use a skill cairn-memory. Mantenha MEMORY.md como um índice curto e escreva detalhes em docs/memory/<domain>.md.",
+    plan: "Use a skill cairn-plan. Mantenha MEMORY.md como índice e escreva planos detalhados em docs/plan/<topic>.md.",
+    work: "Use a skill cairn-work. Execute uma fatia de módulo e capture evidências de módulo e de superfície.",
+    review: "Use a skill cairn-review. Compare evidências com PLAN.md e MEMORY.md.",
+    usage: "Uso: cairn install|upgrade|doctor|uninstall|init|memory|plan|work|review|toolcheck",
+  },
+};
+
+if (isCliEntry()) {
+  const [command = "help", ...args] = process.argv.slice(2);
+  await main(command, args);
+}

package/skills/cairn-memory/SKILL.md

@@ -13,7 +13,7 @@ The root `MEMORY.md` is an index, not detailed knowledge. Record details in `doc
 
 ## Procedure
 
-1. Run `scripts/cairn-state.sh manual` if it exists. Otherwise ensure `MEMORY.md`, `PLAN.md`, `docs/memory`, and `docs/plan` directly.
+1. Run `node scripts/cairn-state.mjs manual` if it exists. Otherwise ensure `MEMORY.md`, `PLAN.md`, `docs/memory`, and `docs/plan` directly.
 2. Explore the repository before asking the user.
 3. Delegate when it materially improves speed or quality instead of asking the user.
    - `explorer`: read-only domain discovery, boundaries, invariants, policies, contradictions, and stale facts when available.

package/skills/cairn-plan/SKILL.md

@@ -13,11 +13,11 @@ Plans must reduce execution tokens. Do not leave long plans only in chat. Store
 
 ## Procedure
 
-1. Run `scripts/cairn-state.sh manual` if it exists. Otherwise ensure `MEMORY.md`, `PLAN.md`, `docs/memory`, and `docs/plan` directly.
+1. Run `node scripts/cairn-state.mjs manual` if it exists. Otherwise ensure `MEMORY.md`, `PLAN.md`, `docs/memory`, and `docs/plan` directly.
 2. Read only `MEMORY.md` and relevant `docs/memory/*.md` files.
 3. Based on the active or assigned model, read `docs/model-guidance/README.md` and only the relevant model guidance.
-4. Run `scripts/cairn toolcheck` when available, or `scripts/cairn-toolcheck.mjs` directly, to identify repository stacks and required tools.
-5. If LSP, typecheck, lint, dry-run, or verification tools are missing, run `scripts/cairn toolcheck --install` or the closest repository-native install command before treating the tool as unavailable.
+4. Run `node scripts/cairn.mjs toolcheck` when available, or `scripts/cairn-toolcheck.mjs` directly, to identify repository stacks and required tools.
+5. If LSP, typecheck, lint, dry-run, or verification tools are missing, run `node scripts/cairn.mjs toolcheck --install` or the closest repository-native install command before treating the tool as unavailable.
 6. Explore the repository with focused search and LSP/symbol tools after tool readiness is confirmed.
 7. Identify the closest available dry-run or check mode for every slice that can mutate external state.
 8. Run complexity triage before applying workflow guidance from agents, plugins, or delegated roles.

package/skills/cairn-work/SKILL.md

@@ -17,7 +17,7 @@ Execute only one module slice at a time. Instead of a repeated red-green loop, p
 2. Read the `docs/model-guidance/*.md` inputs recorded in the plan.
 3. Select the first incomplete module slice.
 4. Confirm that required LSP, typecheck, lint, dry-run, and verification tools are available from the plan's tool readiness section.
-5. If a required tool is missing, run `scripts/cairn toolcheck --install` or the closest repository-native install command, then rerun the tool before continuing.
+5. If a required tool is missing, run `node scripts/cairn.mjs toolcheck --install` or the closest repository-native install command, then rerun the tool before continuing.
 6. Confirm the selected Light Path or Heavy Path in the plan.
 7. For Light Path, implement directly or delegate to one bounded `worker`; keep the verification gate.
 8. For Heavy Path, follow the full planning and review pipeline recorded in the plan. Run pre-implementation review before mutation and read-only review after evidence exists.
@@ -43,7 +43,7 @@ CONTEXT: docs/plan/<topic>.md slice, relevant docs/memory notes, applied model g
 ## Tool Readiness Policy
 
 - Run the repository tool readiness command recorded in the plan before implementation.
-- If no command is recorded, run `scripts/cairn toolcheck` when available.
+- If no command is recorded, run `node scripts/cairn.mjs toolcheck` when available.
 - Missing LSP, typecheck, lint, dry-run, or verification tools must trigger a project-local or repository-native install attempt.
 - After installation, rerun the exact tool command and record evidence.
 - If installation fails, stop the slice and record the blocker rather than silently falling back to less precise exploration.