@walwal-harness/cli 7.1.24 → 7.1.25

package/CHANGELOG.md

@@ -31,6 +31,16 @@ docmeta:
 
 ## Unreleased
 
+## 7.1.25 — Absolute Claude hook paths + Codex adapter docs (2026-05-26)
+
+### Fixed
+- Claude hooks and statusline now install with project-root absolute script paths, preventing `UserPromptSubmit hook error: scripts/harness-user-prompt-submit.sh: No such file or directory` when Claude runs hooks outside the project root.
+- Existing relative-path harness hooks are migrated to absolute paths on re-init.
+
+### Changed
+- Codex command and AGENTS templates now explain that `.codex/skills/**/SKILL.md` is the Codex runtime protocol and `.codex/agents/` is not required.
+- `migrate` appends a Codex Runtime Adapter block to existing AGENTS.md files when missing.
+
 ## 7.1.24 — Hourly CEO wake loop + migrate script refresh (2026-05-22)
 
 ### Changed

package/README.md

@@ -215,6 +215,7 @@ Hourly autonomous wake:
 - `HARNESS_WAKE_MODEL=<model>` optionally pins the Claude model for wake ticks.
 - Each wake tick prompts CEO to convene CXX + OPS, collect progress and decisions, dispatch the next action without asking Owner, and require CQO/OPS verification until the active goal works.
 - `npx @walwal-harness/cli migrate` refreshes package-owned runtime scripts, so existing projects receive wake prompt updates without a full re-init.
+- In Codex, `.codex/skills/**/SKILL.md` files are the runtime protocol. `.codex/agents/` is not required; Codex should manually read the relevant skill if it is not auto-listed.
 
 ---
 

package/assets/templates/AGENTS.md.template

@@ -19,6 +19,18 @@ Internal routing uses agent/skill wiring only.
 
 ---
 
+## 1.1 Codex Runtime Adapter
+
+Codex does not need `.codex/agents/` to run this harness. The installed Codex contract is:
+
+- Owner entrypoints are `.codex/commands/goal.md`, `.codex/commands/submission.md`, and `.codex/commands/hot-fix.md`.
+- Harness role protocols live in `.codex/skills/harness-{ceo,coo,cdo,cto,cqo,ops,hiring,resource-manager,brick-office}/SKILL.md`.
+- If Codex does not auto-list these as available skills, manually read the relevant `SKILL.md` file and follow it. Do not report that the harness is unavailable just because `.codex/agents/` is absent.
+- When a command asks for a "fresh session context", Codex must create a role-scoped context by reading only the role skill, the active mission files, and required conventions/gotchas before writing that role's `{cxx}.md`. If Codex sub-agent tooling is explicitly available and requested, it may be used; otherwise execute the role protocol sequentially with clear role boundaries.
+- Codex must not treat `.codex/skills` as passive documentation. These files are the installed runtime protocol for Codex.
+
+---
+
 ## 2. Think Before Acting
 
 Don't assume. Don't hide confusion.

package/bin/init.js

@@ -168,6 +168,33 @@ function mergeClaudePermissionAllow(settings, entries) {
   return changed;
 }
 
+function shellQuote(value) {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+
+function harnessScriptCommand(scriptName) {
+  return `bash ${shellQuote(path.join(PROJECT_ROOT, 'scripts', scriptName))}`;
+}
+
+function replaceHarnessHookCommand(entries, marker, command) {
+  let changed = false;
+  for (const entry of entries) {
+    if (!entry || typeof entry !== 'object') continue;
+    if (Array.isArray(entry.hooks)) {
+      for (const hook of entry.hooks) {
+        if (hook && hook.command && hook.command.includes(marker) && hook.command !== command) {
+          hook.command = command;
+          changed = true;
+        }
+      }
+    } else if (entry.type === 'command' && entry.command && entry.command.includes(marker) && entry.command !== command) {
+      entry.command = command;
+      changed = true;
+    }
+  }
+  return changed;
+}
+
 const V7_REMOVED_CONVENTION_FILES = [
   'conductor.md',
   'coo-developer.md',
@@ -820,7 +847,7 @@ function installSessionHook() {
 
   // Migrate any legacy flat entries (created by older walwal-harness versions)
   // into the correct matcher + hooks-array shape that Claude Code expects.
-  const hookCmd = 'bash scripts/harness-session-start.sh';
+  const hookCmd = harnessScriptCommand('harness-session-start.sh');
   let migrated = false;
   settings.hooks.SessionStart = settings.hooks.SessionStart
     .map((entry) => {
@@ -845,6 +872,8 @@ function installSessionHook() {
       )
   );
 
+  const hookUpdated = replaceHarnessHookCommand(settings.hooks.SessionStart, 'harness-session-start', hookCmd);
+
   if (!alreadyInstalled) {
     settings.hooks.SessionStart.push({
       matcher: '',
@@ -852,9 +881,9 @@ function installSessionHook() {
     });
     writeClaudeSettings(settings);
     log('SessionStart hook installed in .claude/settings.json');
-  } else if (migrated) {
+  } else if (migrated || hookUpdated) {
     writeClaudeSettings(settings);
-    log('SessionStart hook migrated to matcher + hooks-array format');
+    log('SessionStart hook migrated in .claude/settings.json');
   } else {
     log('SessionStart hook already installed');
   }
@@ -872,16 +901,9 @@ function installStatusline() {
 
   let settings = readClaudeSettings();
 
-  // Check if statusLine is already configured
-  if (settings.statusLine && settings.statusLine.command &&
-      settings.statusLine.command.includes('harness-statusline')) {
-    log('Statusline already installed');
-    return;
-  }
-
   settings.statusLine = {
     type: 'command',
-    command: 'bash scripts/harness-statusline.sh',
+    command: harnessScriptCommand('harness-statusline.sh'),
     refreshInterval: 3
   };
 
@@ -904,7 +926,7 @@ function installUserPromptSubmitHook() {
   if (!settings.hooks) settings.hooks = {};
   if (!settings.hooks.UserPromptSubmit) settings.hooks.UserPromptSubmit = [];
 
-  const hookCmd = 'bash scripts/harness-user-prompt-submit.sh';
+  const hookCmd = harnessScriptCommand('harness-user-prompt-submit.sh');
 
   // Detect existing harness UserPromptSubmit hook (any shape)
   const alreadyInstalled = settings.hooks.UserPromptSubmit.some((entry) => {
@@ -920,6 +942,8 @@ function installUserPromptSubmitHook() {
     return false;
   });
 
+  const hookUpdated = replaceHarnessHookCommand(settings.hooks.UserPromptSubmit, 'harness-user-prompt-submit', hookCmd);
+
   if (!alreadyInstalled) {
     settings.hooks.UserPromptSubmit.push({
       matcher: '',
@@ -930,6 +954,9 @@ function installUserPromptSubmitHook() {
     log('  → /goal, /submission, and /hot-fix are guided through harness-ceo and CXX workflow');
     log('  → Opt-out per message: say "harness skip" or "without harness"');
     log('  → Disable globally: set .harness/config.json behavior.auto_route_ceo = false');
+  } else if (hookUpdated) {
+    writeClaudeSettings(settings);
+    log('UserPromptSubmit hook migrated in .claude/settings.json');
   } else {
     log('UserPromptSubmit hook already installed');
   }
@@ -950,7 +977,7 @@ function installStopHook() {
   if (!settings.hooks) settings.hooks = {};
   if (!settings.hooks.Stop) settings.hooks.Stop = [];
 
-  const hookCmd = 'bash scripts/harness-stop.sh';
+  const hookCmd = harnessScriptCommand('harness-stop.sh');
 
   const alreadyInstalled = settings.hooks.Stop.some((entry) => {
     if (!entry || typeof entry !== 'object') return false;
@@ -965,6 +992,8 @@ function installStopHook() {
     return false;
   });
 
+  const hookUpdated = replaceHarnessHookCommand(settings.hooks.Stop, 'harness-stop', hookCmd);
+
   if (!alreadyInstalled) {
     settings.hooks.Stop.push({
       matcher: '',
@@ -975,6 +1004,9 @@ function installStopHook() {
     log('  → Conductor 가 running 인 동안 turn 종료 시 자동으로 다음 tick 으로 연쇄');
     log('  → 비활성: .harness/config.json behavior.auto_chain_on_stop = false');
     log('  → 상한: behavior.auto_chain_max_per_sprint (기본 200)');
+  } else if (hookUpdated) {
+    writeClaudeSettings(settings);
+    log('Stop hook migrated in .claude/settings.json');
   } else {
     log('Stop hook already installed');
   }
@@ -1227,6 +1259,7 @@ function detectMigrationNeeded() {
     hrResourcePoolStale: false,
     harnessMdStale: false,
     agentsMissingOpsVerificationRules: false,
+    agentsMissingCodexAdapterRules: false,
     rosterCodexPathsMissing: false,
     resourceIndexCodexWordingMissing: false,
     memoryMissingSystemEntries: [],
@@ -1347,6 +1380,12 @@ function detectMigrationNeeded() {
       ) {
         flags.agentsMissingOpsVerificationRules = true;
       }
+      if (
+        !agentsBody.includes('Codex Runtime Adapter') &&
+        !agentsBody.includes('.codex/skills/harness-ceo/SKILL.md')
+      ) {
+        flags.agentsMissingCodexAdapterRules = true;
+      }
     } catch {}
   }
   if (fs.existsSync(rosterPath)) {
@@ -1852,6 +1891,32 @@ function runMigrate(opts = {}) {
     }
   }
 
+
+  if (flags.agentsMissingCodexAdapterRules) {
+    const agentsPath = path.join(PROJECT_ROOT, 'AGENTS.md');
+    if (fs.existsSync(agentsPath)) {
+      const original = fs.readFileSync(agentsPath, 'utf8');
+      const block = [
+        '',
+        '---',
+        '',
+        '## walwal-harness Codex Runtime Adapter',
+        '',
+        '- Codex does not require .codex/agents/; repo-local .codex/skills/**/SKILL.md files are the Codex runtime protocol.',
+        '- For /goal, /submission, and /hot-fix, read .codex/commands/{goal,submission,hot-fix}.md and .codex/skills/harness-ceo/SKILL.md if Codex does not auto-load them.',
+        '- Do not report walwal-harness as unavailable just because skills are not listed in the global Available Skills panel.',
+        '- Emulate fresh CXX context by reading the role skill, active mission files, and required conventions/gotchas before writing that role\'s {cxx}.md.',
+        ''
+      ].join('\n');
+      log('  AGENTS.md: Codex runtime adapter rules append');
+      if (!dryRun) {
+        fs.writeFileSync(path.join(backupDir, 'AGENTS.codex-adapter.md'), original);
+        const sep = original.endsWith('\n') ? '' : '\n';
+        fs.writeFileSync(agentsPath, original + sep + block);
+      }
+    }
+  }
+
   // 7. Bundle version stamp — record which package version was last applied.
   if (flags.bundleVersionStale) {
     const { current, installed } = flags.bundleVersionStale;

package/commands/goal.md

@@ -7,6 +7,11 @@ argument-hint: "<goal request>"
 
 Route the Owner request to the installed `harness-ceo` agent/skill.
 
+Codex adapter:
+- If Codex does not auto-load `harness-ceo`, manually read `.codex/skills/harness-ceo/SKILL.md` and follow it.
+- Absence of `.codex/agents/` is not a failure. `.codex/skills/**/SKILL.md` is the Codex runtime protocol.
+- For CXX "fresh session context", use role-scoped context: read the CXX skill, active mission files, and required conventions/gotchas before writing that role's `{cxx}.md`.
+
 Required flow:
 1. Create or update a goal under `.harness/documents/goal-{goal_index}-{goal_name}/`.
 2. Record CEO decisions in `.harness/documents/goal-{goal_index}-{goal_name}/ceo.md`.

package/commands/hot-fix.md

@@ -7,6 +7,11 @@ argument-hint: "<incident or fix request>"
 
 Route the Owner request to the installed `harness-ceo` agent/skill as an emergency mission under the active goal.
 
+Codex adapter:
+- If Codex does not auto-load `harness-ceo`, manually read `.codex/skills/harness-ceo/SKILL.md` and follow it.
+- Absence of `.codex/agents/` is not a failure. `.codex/skills/**/SKILL.md` is the Codex runtime protocol.
+- For CXX "fresh session context", use role-scoped context: read the CXX skill, active mission files, and required conventions/gotchas before writing that role's `{cxx}.md`.
+
 Required flow:
 1. Locate the active goal document root under `.harness/documents/{goal_name}/`. If no active goal exists, CEO must create/select one before proceeding.
 2. Create `.harness/documents/{goal_name}/hotfix-{hotfix_index}-{hotfix_name}/ceo.md`.

package/commands/submission.md

@@ -7,6 +7,11 @@ argument-hint: "<additional requirement>"
 
 Route the Owner request to the installed `harness-ceo` agent/skill as an additional requirement under the active goal.
 
+Codex adapter:
+- If Codex does not auto-load `harness-ceo`, manually read `.codex/skills/harness-ceo/SKILL.md` and follow it.
+- Absence of `.codex/agents/` is not a failure. `.codex/skills/**/SKILL.md` is the Codex runtime protocol.
+- For CXX "fresh session context", use role-scoped context: read the CXX skill, active mission files, and required conventions/gotchas before writing that role's `{cxx}.md`.
+
 Required flow:
 1. Locate the active goal document root under `.harness/documents/{goal_name}/`. If no active goal exists, CEO must ask the Owner to create or select one with `/goal` before proceeding.
 2. Create a submission record under `.harness/documents/{goal_name}/submission-{submission_index}-{submission_name}/`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "7.1.24",
+  "version": "7.1.25",
   "description": "Company-style AI agent harness for Claude and Codex. Installs commands, CXX agents, skills, HR-Resource hiring pool, and project-local .harness runtime state.",
   "bin": {
     "walwal-harness": "bin/init.js"