oh-my-opencode 4.18.1 → 4.19.0

package/packages/omo-codex/plugin/components/lsp/test/package-smoke.test.ts

@@ -44,6 +44,7 @@ describe("plugin package metadata", () => {
 		expect(postCompactCommand).toBe(`node "${pluginRoot}/dist/cli.js" hook post-compact`);
 		expect(lspServer?.command).toBe("node");
 		expect(lspServer?.args).toEqual(["../../../../lsp-daemon/dist/cli.js", "mcp"]);
+		expect(lspServer?.startup_timeout_sec).toBe(10);
 		expect(cliSource).not.toContain("./lazy-lsp-mcp.js");
 		expect(cliSource).toContain("resolveLspDaemonCliPath");
 		expect(daemonCliPathSource).toContain("@code-yeongyu/lsp-daemon/cli");

package/packages/omo-codex/plugin/components/rules/bundled-rules/hephaestus/gpt-5.5.md

@@ -74,7 +74,7 @@ Diagnostics catch type errors, not logic bugs; tests cover only what their autho
 
 # Global Review and Debugging Gate
 
-Run `review-work` plus a `debugging` runtime audit only before a PR handoff or when the user asks for a review; lane pass/fail semantics live in those skills. A passing review lane binds to the exact commit SHA it reviewed: NEVER re-run a lane at a SHA where that same lane already passed this task; every lane that has not passed at the current SHA still runs. For everything else, the gate above is the whole gate: once you have personally observed the artifact working, report your evidence. Redact secrets, tokens, and PII from ledgers, PR bodies, and handoffs.
+Run `review-work` plus a `debugging` runtime audit only before a PR handoff or when the user asks for a review; lane pass/fail semantics live in those skills. Each passing review lane and debugging audit binds to the exact full commit SHA it reviewed. Immediately append a durable task-evidence/ledger record with its name, full SHA, verdict, and report artifact/source. Before reuse after continuation or compaction, re-read the record and require the exact lane/SHA pair; memory or an unstamped report is not coverage. Every missing pair at the current SHA still runs, and new commits require fresh applicable coverage. For everything else, the gate above is the whole gate: once you have personally observed the artifact working, report your evidence. Redact secrets, tokens, and PII from ledgers, PR bodies, and handoffs.
 
 # Failure Recovery
 

package/packages/omo-codex/plugin/components/rules/bundled-rules/hephaestus/gpt-5.6.md

@@ -19,13 +19,15 @@ Status requests are not stop signals: give the update, keep working. Honor every
 
 # Discovery
 
-Never speculate about code you have not read: verify with tools and re-read on every hand-off. Start broad once - and WIDE: tool calls run as JavaScript through `exec`, so write programs, not single calls. Batch EVERY independent read, search, and doc lookup into ONE `exec` script via `Promise.all` over the `tools` object before the first edit; filter and reduce results in-script so only what you need returns to context. NEVER await independent calls one at a time - sequence only when one result feeds the next. Retrieve again only when the core question is open, a needed fact is missing, or a second-order question (callers, error paths, ownership) changes the design. Stop when you can act. Prefer the root fix over the symptom fix.
+Never speculate about code you have not read: verify with tools and re-read on every hand-off. **USE CODE MODE AGGRESSIVELY FOR BOUNDED DISCOVERY.** When multiple independent tool calls produce results that can be materially filtered, joined, deduplicated, or reduced, make ONE `exec` / eval JavaScript program that calls eligible tools concurrently with `Promise.all` and returns only decision-relevant evidence. For shell-native repo work without programmatic tool access, use ONE Python script with `concurrent.futures`, `subprocess`, and utility functions to batch commands and reduce output. **USE LSP FOR SYMBOLS** - definitions, references, rename impact, workspace symbols, and diagnostics - instead of reconstructing semantics with text search. Use direct calls when one result chooses the next action, outputs are already small, semantic judgment is required between calls, approval or side effects are involved, or native artifacts must be preserved. Retrieve again only for a missing required fact or a second-order question that changes the design. Stop when you can act; prefer the root fix over the symptom.
 
 # Operating Loop
 
 Explore -> Plan (`update_plan`, per Task Tracking) -> Implement -> Verify -> Manually QA.
 
-Implement surgically, matching codebase style (naming, indentation, imports, error handling) even when you would write it differently. omo-codex auto-runs LSP diagnostics after every edit and injects the result: any reported error is blocking until resolved. Verify with targeted tests and builds for changed behavior; if validation cannot run, say why and name the next best check.
+Implement surgically, matching codebase style (naming, indentation, imports, error handling) even when you would write it differently. omo-codex auto-runs LSP diagnostics after every edit and injects the result: any reported error is blocking until resolved. Verify with targeted tests and builds for changed behavior; if validation cannot run, say why and name the next best check. Re-run a validation command only when its inputs changed since its last green run; one full pass right before the final message replaces repeated identical reruns.
+
+Waiting is not free: a status poll replays the whole accumulated context through the model. Run a long command (install, build, suite, container, CI watch) to completion in ONE `exec` call with a timeout sized to the expected wait - or send output to a log file read once on a completion signal - never re-poll the same surface with empty reads or sub-minute waits. If two consecutive checks show no state change, double the wait or switch to a completion signal.
 
 # Subagents
 
@@ -52,7 +54,7 @@ Diagnostics catch type errors, not logic bugs; tests cover only what their autho
 
 "This should work" from reading source does not pass. A defect found in usage is yours to fix this turn.
 
-Run `review-work` plus a `debugging` runtime audit only before a PR handoff or when the user asks for a review; lane pass/fail semantics live in those skills. A passing review lane binds to the exact commit SHA it reviewed: NEVER re-run a lane at a SHA where that same lane already passed this task; every lane that has not passed at the current SHA still runs. For everything else, the gate above is the whole gate: once you have personally observed the artifact working, report your evidence. Redact secrets, tokens, and PII from ledgers, PR bodies, and handoffs.
+Run `review-work` plus a `debugging` runtime audit only before a PR handoff or when the user asks for a review; lane pass/fail semantics live in those skills. Each passing review lane and debugging audit binds to the exact full commit SHA it reviewed. Immediately append a durable task-evidence/ledger record with its name, full SHA, verdict, and report artifact/source. Before reuse after continuation or compaction, re-read the record and require the exact lane/SHA pair; memory or an unstamped report is not coverage. Every missing pair at the current SHA still runs, and new commits require fresh applicable coverage. For everything else, the gate above is the whole gate: once you have personally observed the artifact working, report your evidence. Redact secrets, tokens, and PII from ledgers, PR bodies, and handoffs.
 
 # Failure Recovery
 

package/packages/omo-codex/plugin/components/rules/hooks/hooks.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook session-start",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.18.1) Loading Project Rules"
+						"statusMessage": "(OmO 4.19.0) Loading Project Rules"
 					}
 				]
 			}
@@ -19,7 +19,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook user-prompt-submit",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.18.1) Loading Project Rules"
+						"statusMessage": "(OmO 4.19.0) Loading Project Rules"
 					}
 				]
 			}
@@ -32,7 +32,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook post-tool-use",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.18.1) Matching Project Rules"
+						"statusMessage": "(OmO 4.19.0) Matching Project Rules"
 					}
 				]
 			}
@@ -45,7 +45,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook post-compact",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.18.1) Resetting Project Rule Cache"
+						"statusMessage": "(OmO 4.19.0) Resetting Project Rule Cache"
 					}
 				]
 			}

package/packages/omo-codex/plugin/components/rules/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-rules",
-	"version": "4.18.1",
+	"version": "4.19.0",
 	"description": "Codex plugin that injects project rule files into model context through lifecycle hooks.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/start-work-continuation/AGENTS.md

@@ -29,6 +29,13 @@ Conventions for human contributors and AI agents working on this repository.
 - Never use Arrange-Act-Assert comments.
 - Keep fixtures in `test/fixtures/`.
 
+## Layout
+
+- `src/boulder-reader.ts`: reads `.omo/boulder.json`, resolves the active work for the session, re-exports `getPlanChecklist`/`PlanChecklist` from `plan-checklist.ts`. `readContinuationState` returns null only when the plan has no readable top-level checklist (`total === 0`).
+- `src/plan-checklist.ts`: `PlanChecklist` (`completed`/`remaining`/`total`/`nextTaskLabel`) and `getPlanChecklist`/`parsePlanChecklist`. Counts structured `## TODOs` rows (`N. <title>`) and `## Final Verification Wave` rows (`F<number>. <title>`); falls back to simple top-level `- [ ]`/`- [x]` checkboxes. Skips fenced blocks and respects `#`/`##` section boundaries.
+- `src/codex-hook.ts`: Stop/SubagentStop hook; fills `REMAINING_COUNT`/`TOTAL_COUNT`/`NEXT_TASK_LABEL` from the checklist into `directive.md`.
+- `directive.md`: directive template with placeholders, applied per invocation.
+
 ## Build and Hooks
 
 - Build output goes to `dist/`.
@@ -41,3 +48,4 @@ Conventions for human contributors and AI agents working on this repository.
 - Never make a network call from the hook.
 - Keep the directive in `directive.md`. Do not inline it into TypeScript files.
 - The hook only continues sessions listed in `.omo/boulder.json` as `codex:<session_id>`.
+- The hook continues while the plan has a readable top-level checklist (`total > 0`). A fully-checked plan still blocks Stop until the final gate runs and the Boulder work is marked completed; an unreadable or empty checklist yields no output.

package/packages/omo-codex/plugin/components/start-work-continuation/README.md

@@ -2,13 +2,13 @@
 
 Codex Stop-hook continuation injector for the omo-codex `start-work` skill.
 
-It reads `.omo/boulder.json` in the hook payload `cwd`, resolves the active work, inspects the active plan for incomplete top-level checkboxes, and emits Codex Stop-hook JSON when the plan still has work:
+It reads `.omo/boulder.json` in the hook payload `cwd`, resolves the active work, inspects the active plan's top-level checklist, and emits Codex Stop-hook JSON while the plan still has unchecked tasks or its final review/debugging gate remains pending:
 
 ```json
 {"decision":"block","reason":"<directive>"}
 ```
 
-The `reason` is loaded from `directive.md` on every invocation and filled with current plan state. The hook returns no output when `stop_hook_active` is `true`, when no active Boulder work exists, when the work is completed, when the active work is not tied to `codex:<session_id>`, or when all top-level plan checkboxes are complete.
+The `reason` is loaded from `directive.md` on every invocation and filled with current plan state. The hook returns no output when `stop_hook_active` is `true`, when no active Boulder work exists, when the work is completed, when the active work is not tied to `codex:<session_id>`, or when the plan has no readable top-level checklist. An active plan whose checklist is fully checked still blocks Stop until the final gate runs and Boulder is marked completed.
 
 This pairs with the `start-work` skill at `plugin/skills/start-work/SKILL.md`. That skill writes `.omo/boulder.json` with Codex session ids prefixed as `codex:` so the hook can continue only its own active Codex session.
 

package/packages/omo-codex/plugin/components/start-work-continuation/directive.md

@@ -16,7 +16,7 @@ You are mid-flight on a Prometheus work plan; this turn is an automatic continua
 # What to do this turn
 
 1. Read `{{PLAN_PATH}}` AND `{{LEDGER_PATH}}` first — they are the only sources of truth for what remains and what evidence exists; do not trust your memory of prior turns.
-2. Pick the FIRST unchecked top-level checkbox in `## TODOs` or `## Final Verification Wave`. Ignore nested checkboxes under Acceptance Criteria / Evidence / Definition of Done.
+2. When the remaining count is `0`, skip checkbox execution and perform the Final gate now. Otherwise, pick the FIRST unchecked top-level checkbox in `## TODOs` or `## Final Verification Wave`. Ignore nested checkboxes under Acceptance Criteria / Evidence / Definition of Done.
 3. Follow the `start-work` skill in full. The skill is already loaded from your earlier turn — re-read its file at `packages/omo-codex/plugin/skills/start-work/SKILL.md` if you have lost context.
 4. Apply the checkbox's tier from its ledger entry, or classify it now per the start-work skill: LIGHT (default — a narrow change inside existing layers) needs one real-surface proof of the deliverable, with auxiliary surfaces first-class for CLI- or data-shaped work, and only trigger-mapped adversarial classes; HEAVY (new module/abstraction, auth/security, external integration, schema/migration, concurrency, cross-domain refactor, care signals) takes the full per-criterion regime. When unsure, take HEAVY; never downgrade.
 5. Decompose the checkbox into atomic sub-tasks. Dispatch them in PARALLEL via `multi_agent_v1.spawn_agent` calls in this same response unless a sub-task has a NAMED blocking dependency (input from another sub-task or shared file). Use `fork_context: false` unless full history is truly required. Put role and specialty instructions inside `message`. Flat `spawn_agent` requiring `task_name` instead (`multi_agent_v2`)? Add `"task_name"`, use `fork_turns: "none"`, `wait_agent` takes only `timeout_ms`, finished agents end on their own.
@@ -40,7 +40,7 @@ You are mid-flight on a Prometheus work plan; this turn is an automatic continua
 
 # Final gate
 
-Before completion, run `review-work` and a `debugging` runtime audit; inconclusive lanes fail. The gate's pass binds to the commit SHA it reviewed — never re-run it on an already-passed SHA; re-run only when new commits land. Do not create a PR, PR handoff, branch handoff, merge, or final completion answer until this gate passes. For PR/branch work, stay in the task-owned worktree: create/update the PR, wait for CI/review/Cubic gates, merge by default unless explicitly opted out, then clean up. Redact secrets, tokens, credentials, auth headers, cookies, env dumps, logs, and PII.
+Before completion, satisfy all five `review-work` lanes and a `debugging` runtime audit; inconclusive lanes or an inconclusive audit fail. Each pass binds to the exact full commit SHA it reviewed. Immediately append a durable task-evidence record to `{{LEDGER_PATH}}` for every passing lane and the debugging audit with its name, full SHA, verdict, and report artifact/source. Before same-SHA reuse after any continuation or compaction, re-read the ledger record and verify the exact lane/SHA pair; memory, chat history, or an unstamped report is not coverage. New commits require fresh applicable coverage. Do not create a PR, PR handoff, branch handoff, merge, or final completion answer until this gate passes. For PR/branch work, stay in the task-owned worktree: create/update the PR, wait for CI/review/Cubic gates, merge by default unless explicitly opted out, then clean up. After the gate and lifecycle pass, mark the Boulder work completed before the final answer. Redact secrets, tokens, credentials, auth headers, cookies, env dumps, logs, and PII.
 
 # Stop conditions for THIS turn
 
@@ -54,6 +54,6 @@ Before completion, run `review-work` and a `debugging` runtime audit; inconclusi
 - Surface only state changes: sub-agent dispatched, scenario PASS/FAIL with artifact path, checkbox marked, evidence appended.
 - Do NOT print "Should I continue?", restate the plan, or recap prior turns — the Stop hook continues you; the ledger and plan are the durable record.
 
-Begin now. Pick the next checkbox, dispatch the parallel sub-agents, verify, mark, continue.
+Begin now. If no checkbox remains, run the Final gate; otherwise pick the next checkbox, dispatch the parallel sub-agents, verify, mark, continue.
 
 </start-work-continuation>

package/packages/omo-codex/plugin/components/start-work-continuation/dist/cli.js

@@ -1,37 +1,22 @@
 #!/usr/bin/env node
 
 // components/start-work-continuation/src/cli.ts
-import { readFileSync as readFileSync3 } from "node:fs";
+import { readFileSync as readFileSync4 } from "node:fs";
 import { stdin as processStdin, stdout as processStdout } from "node:process";
 
 // components/start-work-continuation/src/boulder-reader.ts
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
 import { isAbsolute, join, relative, resolve } from "node:path";
-var TODO_HEADING = "TODOs";
-var FINAL_VERIFICATION_HEADING = "Final Verification Wave";
-var CHECKBOX_PREFIX_LENGTH = "- [ ] ".length;
-var SESSION_ID_PREFIX_PATTERN = /^(codex|opencode):/;
-function readContinuationState(cwd, sessionId) {
-  const boulderPath = getBoulderFilePath(cwd);
-  const boulderState = readBoulderState(boulderPath);
-  if (boulderState === null)
-    return null;
-  const work = getWorkForSession(boulderState, normalizeSessionId(sessionId, "codex"));
-  if (work === null || !isContinuableStatus(work.status))
-    return null;
-  const planPath = resolveBoulderPlanPathForWork(cwd, work);
-  const checklist = getPlanChecklist(planPath);
-  if (checklist.remaining === 0)
-    return null;
-  return {
-    planName: work.planName,
-    planPath,
-    boulderPath,
-    ledgerPath: join(cwd, ".omo", "start-work", "ledger.jsonl"),
-    worktreePath: work.worktreePath ?? null,
-    checklist
-  };
-}
+
+// components/start-work-continuation/src/plan-checklist.ts
+import { existsSync, readFileSync } from "node:fs";
+var TODO_HEADING_PATTERN = /^##[ \t]+TODOs(?:[ \t]+#+)?[ \t]*$/i;
+var FINAL_VERIFICATION_HEADING_PATTERN = /^##[ \t]+Final Verification Wave(?:[ \t]+#+)?[ \t]*$/i;
+var SECTION_BOUNDARY_HEADING_PATTERN = /^#{1,2}(?:[ \t]+|$)/;
+var FENCE_PATTERN = /^[ \t]{0,3}(`{3,}|~{3,})(.*)$/;
+var SIMPLE_CHECKBOX_PATTERN = /^[-*][ \t]*\[[ \t]*([xX]?)[ \t]*\][ \t]+(.+)$/;
+var TODO_CHECKBOX_PATTERN = /^- \[([ xX])\] ([1-9]\d*\. .+)$/;
+var FINAL_WAVE_CHECKBOX_PATTERN = /^- \[([ xX])\] (F[1-9]\d*\. .+)$/i;
 function getPlanChecklist(planPath) {
   if (!existsSync(planPath))
     return emptyChecklist();
@@ -45,34 +30,155 @@ function getPlanChecklist(planPath) {
 }
 function parsePlanChecklist(markdown) {
   const lines = markdown.split(/\r?\n/);
-  const hasCountedSections = lines.some((line) => isCountedHeading(parseLevelTwoHeading(line)));
+  if (!hasStructuredSection(lines))
+    return parseSimpleChecklist(lines);
   let completed = 0;
   let remaining = 0;
   let nextTaskLabel = null;
-  let isCountedSection = !hasCountedSections;
+  let section = "other";
+  let fence = null;
   for (const line of lines) {
-    const heading = parseLevelTwoHeading(line);
-    if (heading !== null) {
-      isCountedSection = isCountedHeading(heading);
+    if (fence !== null) {
+      if (isClosingFence(line, fence))
+        fence = null;
       continue;
     }
-    if (!isCountedSection)
+    const openingFence = parseOpeningFence(line);
+    if (openingFence !== null) {
+      fence = openingFence;
       continue;
-    const checkbox = parseTopLevelCheckbox(line);
+    }
+    if (SECTION_BOUNDARY_HEADING_PATTERN.test(line)) {
+      section = parseStructuredSectionHeading(line);
+      continue;
+    }
+    if (section === "other")
+      continue;
+    const checkbox = parseStructuredCheckbox(line, section);
     if (checkbox === null)
       continue;
-    if (checkbox.checked) {
+    if (checkbox.checked)
       completed += 1;
-    } else {
+    else {
       remaining += 1;
       nextTaskLabel = nextTaskLabel ?? checkbox.label;
     }
   }
   return { completed, remaining, total: completed + remaining, nextTaskLabel };
 }
+function hasStructuredSection(lines) {
+  let fence = null;
+  for (const line of lines) {
+    if (fence !== null) {
+      if (isClosingFence(line, fence))
+        fence = null;
+      continue;
+    }
+    const openingFence = parseOpeningFence(line);
+    if (openingFence !== null) {
+      fence = openingFence;
+      continue;
+    }
+    if (parseStructuredSectionHeading(line) !== "other")
+      return true;
+  }
+  return false;
+}
+function parseSimpleChecklist(lines) {
+  let completed = 0;
+  let remaining = 0;
+  let nextTaskLabel = null;
+  let fence = null;
+  for (const line of lines) {
+    if (fence !== null) {
+      if (isClosingFence(line, fence))
+        fence = null;
+      continue;
+    }
+    const openingFence = parseOpeningFence(line);
+    if (openingFence !== null) {
+      fence = openingFence;
+      continue;
+    }
+    const checkbox = parseSimpleTopLevelCheckbox(line);
+    if (checkbox === null)
+      continue;
+    if (checkbox.checked)
+      completed += 1;
+    else {
+      remaining += 1;
+      nextTaskLabel = nextTaskLabel ?? checkbox.label;
+    }
+  }
+  return { completed, remaining, total: completed + remaining, nextTaskLabel };
+}
+function parseStructuredSectionHeading(line) {
+  if (TODO_HEADING_PATTERN.test(line))
+    return "todo";
+  if (FINAL_VERIFICATION_HEADING_PATTERN.test(line))
+    return "final-wave";
+  return "other";
+}
+function parseStructuredCheckbox(line, section) {
+  const pattern = section === "todo" ? TODO_CHECKBOX_PATTERN : FINAL_WAVE_CHECKBOX_PATTERN;
+  const match = line.match(pattern);
+  const marker = match?.[1];
+  const label = match?.[2];
+  if (marker === undefined || label === undefined)
+    return null;
+  return { checked: marker.toLowerCase() === "x", label };
+}
+function parseSimpleTopLevelCheckbox(line) {
+  const match = line.match(SIMPLE_CHECKBOX_PATTERN);
+  const marker = match?.[1];
+  const label = match?.[2];
+  if (marker === undefined || label === undefined)
+    return null;
+  return { checked: marker.toLowerCase() === "x", label };
+}
+function parseOpeningFence(line) {
+  const match = line.match(FENCE_PATTERN);
+  const run = match?.[1];
+  const info = match?.[2];
+  const marker = run?.charAt(0);
+  if (run === undefined || info === undefined || marker !== "`" && marker !== "~" || marker === "`" && info.includes("`"))
+    return null;
+  return { marker, length: run.length };
+}
+function isClosingFence(line, fence) {
+  const run = line.match(/^[ \t]{0,3}(`{3,}|~{3,})[ \t]*$/)?.[1];
+  return run?.charAt(0) === fence.marker && run.length >= fence.length;
+}
+function emptyChecklist() {
+  return { completed: 0, remaining: 0, total: 0, nextTaskLabel: null };
+}
+
+// components/start-work-continuation/src/boulder-reader.ts
+var SESSION_ID_PREFIX_PATTERN = /^(codex|opencode):/;
+function readContinuationState(cwd, sessionId) {
+  const boulderPath = getBoulderFilePath(cwd);
+  const boulderState = readBoulderState(boulderPath);
+  if (boulderState === null)
+    return null;
+  const work = getWorkForSession(boulderState, normalizeSessionId(sessionId, "codex"));
+  if (work === null || !isContinuableStatus(work.status))
+    return null;
+  const planPath = resolveBoulderPlanPathForWork(cwd, work);
+  const checklist = getPlanChecklist(planPath);
+  if (checklist.total === 0)
+    return null;
+  return {
+    planName: work.planName,
+    planPath,
+    boulderPath,
+    ledgerPath: join(cwd, ".omo", "start-work", "ledger.jsonl"),
+    worktreePath: work.worktreePath ?? null,
+    checklist
+  };
+}
 function readBoulderState(path) {
   try {
-    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    const parsed = JSON.parse(readFileSync2(path, "utf8"));
     return parseBoulderState(parsed);
   } catch (error) {
     if (error instanceof Error)
@@ -150,27 +256,11 @@ function resolveBoulderPlanPathForWork(cwd, work) {
     return absolutePlanPath;
   }
   const worktreePlanPath = resolve(resolveTrackedPath(cwd, worktreePath), relativePlanPath);
-  return existsSync(worktreePlanPath) ? worktreePlanPath : absolutePlanPath;
+  return existsSync2(worktreePlanPath) ? worktreePlanPath : absolutePlanPath;
 }
 function resolveTrackedPath(baseDirectory, trackedPath) {
   return isAbsolute(trackedPath) ? resolve(trackedPath) : resolve(baseDirectory, trackedPath);
 }
-function parseTopLevelCheckbox(line) {
-  if (line.startsWith("- [ ] "))
-    return { checked: false, label: line.slice(CHECKBOX_PREFIX_LENGTH) };
-  if (line.startsWith("- [x] ") || line.startsWith("- [X] ")) {
-    return { checked: true, label: line.slice(CHECKBOX_PREFIX_LENGTH) };
-  }
-  return null;
-}
-function parseLevelTwoHeading(line) {
-  if (!line.startsWith("## "))
-    return null;
-  return line.slice("## ".length).trim();
-}
-function isCountedHeading(heading) {
-  return heading === TODO_HEADING || heading === FINAL_VERIFICATION_HEADING;
-}
 function parseBoulderWorkStatus(value) {
   if (value === "active" || value === "paused" || value === "completed" || value === "abandoned")
     return value;
@@ -203,16 +293,13 @@ function isContinuableStatus(status) {
 function getBoulderFilePath(cwd) {
   return join(cwd, ".omo", "boulder.json");
 }
-function emptyChecklist() {
-  return { completed: 0, remaining: 0, total: 0, nextTaskLabel: null };
-}
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
 // components/start-work-continuation/src/directive.ts
-import { readFileSync as readFileSync2 } from "node:fs";
-var START_WORK_CONTINUATION_DIRECTIVE = readFileSync2(new URL("../directive.md", import.meta.url), "utf8");
+import { readFileSync as readFileSync3 } from "node:fs";
+var START_WORK_CONTINUATION_DIRECTIVE = readFileSync3(new URL("../directive.md", import.meta.url), "utf8");
 
 // components/start-work-continuation/src/codex-hook.ts
 function runStopHook(input, fs) {
@@ -239,7 +326,7 @@ function renderDirective(state, sessionId) {
     BOULDER_PATH: state.boulderPath,
     REMAINING_COUNT: String(state.checklist.remaining),
     TOTAL_COUNT: String(state.checklist.total),
-    NEXT_TASK_LABEL: state.checklist.nextTaskLabel ?? "",
+    NEXT_TASK_LABEL: state.checklist.nextTaskLabel ?? "none (final gate pending)",
     WORKTREE_BLOCK: worktreeBlock,
     LEDGER_PATH: state.ledgerPath,
     SESSION_ID: sessionId
@@ -285,7 +372,7 @@ function isRecord2(value) {
 // components/start-work-continuation/src/cli.ts
 var nodeFileSystem = {
   readFileSync(path, encoding) {
-    return readFileSync3(path, encoding);
+    return readFileSync4(path, encoding);
   }
 };
 var command = process.argv[2];

package/packages/omo-codex/plugin/components/start-work-continuation/hooks/hooks.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/start-work-continuation/dist/cli.js\" hook stop",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.18.1) Checking Start-Work Continuation"
+						"statusMessage": "(OmO 4.19.0) Checking Start-Work Continuation"
 					}
 				]
 			}
@@ -19,7 +19,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/start-work-continuation/dist/cli.js\" hook subagent-stop",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.18.1) Checking Start-Work Continuation"
+						"statusMessage": "(OmO 4.19.0) Checking Start-Work Continuation"
 					}
 				]
 			}

package/packages/omo-codex/plugin/components/start-work-continuation/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-start-work-continuation",
-	"version": "4.18.1",
+	"version": "4.19.0",
 	"description": "Codex Stop hook continuation injector for omo-codex start-work plans.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/start-work-continuation/src/boulder-reader.ts

@@ -1,12 +1,9 @@
 import { existsSync, readFileSync } from "node:fs";
 import { isAbsolute, join, relative, resolve } from "node:path";
+import { getPlanChecklist, type PlanChecklist } from "./plan-checklist.js";
 
-export type PlanChecklist = {
-	readonly completed: number;
-	readonly remaining: number;
-	readonly total: number;
-	readonly nextTaskLabel: string | null;
-};
+export type { PlanChecklist } from "./plan-checklist.js";
+export { getPlanChecklist } from "./plan-checklist.js";
 
 type BoulderWorkStatus = "active" | "paused" | "completed" | "abandoned";
 
@@ -35,9 +32,6 @@ export type ContinuationState = {
 	readonly checklist: PlanChecklist;
 };
 
-const TODO_HEADING = "TODOs";
-const FINAL_VERIFICATION_HEADING = "Final Verification Wave";
-const CHECKBOX_PREFIX_LENGTH = "- [ ] ".length;
 const SESSION_ID_PREFIX_PATTERN = /^(codex|opencode):/;
 
 export function readContinuationState(cwd: string, sessionId: string): ContinuationState | null {
@@ -50,7 +44,7 @@ export function readContinuationState(cwd: string, sessionId: string): Continuat
 
 	const planPath = resolveBoulderPlanPathForWork(cwd, work);
 	const checklist = getPlanChecklist(planPath);
-	if (checklist.remaining === 0) return null;
+	if (checklist.total === 0) return null;
 
 	return {
 		planName: work.planName,
@@ -62,47 +56,6 @@ export function readContinuationState(cwd: string, sessionId: string): Continuat
 	};
 }
 
-export function getPlanChecklist(planPath: string): PlanChecklist {
-	if (!existsSync(planPath)) return emptyChecklist();
-
-	try {
-		return parsePlanChecklist(readFileSync(planPath, "utf8"));
-	} catch (error) {
-		if (error instanceof Error) return emptyChecklist();
-		throw error;
-	}
-}
-
-function parsePlanChecklist(markdown: string): PlanChecklist {
-	const lines = markdown.split(/\r?\n/);
-	const hasCountedSections = lines.some((line) => isCountedHeading(parseLevelTwoHeading(line)));
-	let completed = 0;
-	let remaining = 0;
-	let nextTaskLabel: string | null = null;
-	let isCountedSection = !hasCountedSections;
-
-	for (const line of lines) {
-		const heading = parseLevelTwoHeading(line);
-		if (heading !== null) {
-			isCountedSection = isCountedHeading(heading);
-			continue;
-		}
-		if (!isCountedSection) continue;
-
-		const checkbox = parseTopLevelCheckbox(line);
-		if (checkbox === null) continue;
-
-		if (checkbox.checked) {
-			completed += 1;
-		} else {
-			remaining += 1;
-			nextTaskLabel = nextTaskLabel ?? checkbox.label;
-		}
-	}
-
-	return { completed, remaining, total: completed + remaining, nextTaskLabel };
-}
-
 function readBoulderState(path: string): BoulderState | null {
 	try {
 		const parsed: unknown = JSON.parse(readFileSync(path, "utf8"));
@@ -193,23 +146,6 @@ function resolveTrackedPath(baseDirectory: string, trackedPath: string): string
 	return isAbsolute(trackedPath) ? resolve(trackedPath) : resolve(baseDirectory, trackedPath);
 }
 
-function parseTopLevelCheckbox(line: string): { readonly checked: boolean; readonly label: string } | null {
-	if (line.startsWith("- [ ] ")) return { checked: false, label: line.slice(CHECKBOX_PREFIX_LENGTH) };
-	if (line.startsWith("- [x] ") || line.startsWith("- [X] ")) {
-		return { checked: true, label: line.slice(CHECKBOX_PREFIX_LENGTH) };
-	}
-	return null;
-}
-
-function parseLevelTwoHeading(line: string): string | null {
-	if (!line.startsWith("## ")) return null;
-	return line.slice("## ".length).trim();
-}
-
-function isCountedHeading(heading: string | null): boolean {
-	return heading === TODO_HEADING || heading === FINAL_VERIFICATION_HEADING;
-}
-
 function parseBoulderWorkStatus(value: unknown): BoulderWorkStatus | undefined {
 	if (value === "active" || value === "paused" || value === "completed" || value === "abandoned") return value;
 	return undefined;
@@ -243,10 +179,6 @@ function getBoulderFilePath(cwd: string): string {
 	return join(cwd, ".omo", "boulder.json");
 }
 
-function emptyChecklist(): PlanChecklist {
-	return { completed: 0, remaining: 0, total: 0, nextTaskLabel: null };
-}
-
 function isRecord(value: unknown): value is Record<string, unknown> {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }

package/packages/omo-codex/plugin/components/start-work-continuation/src/codex-hook.ts

@@ -27,7 +27,7 @@ function renderDirective(state: ContinuationState, sessionId: string): string {
 		BOULDER_PATH: state.boulderPath,
 		REMAINING_COUNT: String(state.checklist.remaining),
 		TOTAL_COUNT: String(state.checklist.total),
-		NEXT_TASK_LABEL: state.checklist.nextTaskLabel ?? "",
+		NEXT_TASK_LABEL: state.checklist.nextTaskLabel ?? "none (final gate pending)",
 		WORKTREE_BLOCK: worktreeBlock,
 		LEDGER_PATH: state.ledgerPath,
 		SESSION_ID: sessionId,