oh-my-opencode 4.19.0 → 4.19.1

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.19.0) Loading Project Rules"
+						"statusMessage": "(OmO 4.19.1) 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.19.0) Loading Project Rules"
+						"statusMessage": "(OmO 4.19.1) 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.19.0) Matching Project Rules"
+						"statusMessage": "(OmO 4.19.1) Matching Project Rules"
 					}
 				]
 			}
@@ -45,7 +45,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook post-compact",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.19.0) Resetting Project Rule Cache"
+						"statusMessage": "(OmO 4.19.1) Resetting Project Rule Cache"
 					}
 				]
 			}

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

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-rules",
-	"version": "4.19.0",
+	"version": "4.19.1",
 	"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/rules/src/post-compact-budget.ts

@@ -21,6 +21,17 @@ const POST_COMPACT_MIN_RESERVED_TOKENS = 8_000;
 const POST_COMPACT_MIN_GUIDE_CHARS = 500;
 const FALLBACK_CONTEXT_WINDOW_TOKENS = 200_000;
 const MODEL_CONTEXT_BUDGETS: readonly ModelContextBudget[] = [
+	{ slug: "gpt-5.6-sol", contextWindowTokens: 372_000, effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT },
+	{
+		slug: "gpt-5.6-terra",
+		contextWindowTokens: 372_000,
+		effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT,
+	},
+	{
+		slug: "gpt-5.6-luna",
+		contextWindowTokens: 372_000,
+		effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT,
+	},
 	{ slug: "gpt-5.5", contextWindowTokens: 272_000, effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT },
 	{ slug: "gpt-5.4-mini", contextWindowTokens: 272_000, effectivePercent: DEFAULT_EFFECTIVE_CONTEXT_WINDOW_PERCENT },
 	{

package/packages/omo-codex/plugin/components/rules/test/post-compact-budget.test.ts

@@ -76,6 +76,66 @@ describe("post-compact context budget", () => {
 		expect(budget.maxRuleChars).toBeLessThanOrEqual(budget.maxResultChars);
 	});
 
+	it("#given gpt-5.6-sol within its 372k window #when resolving post-compact budget #then keeps configured post-compact cap", () => {
+		// given
+		const transcriptPath = writeCompactedTranscript("A".repeat(541_500));
+
+		// when
+		const budget = withPostCompactBudget(CONFIG, { model: "gpt-5.6-sol", transcriptPath });
+
+		// then
+		expect(budget.maxRuleChars).toBe(CONFIG.postCompactMaxRuleChars);
+		expect(budget.maxResultChars).toBe(CONFIG.postCompactMaxResultChars);
+	});
+
+	it("#given gpt-5.6-terra within its 372k window #when resolving post-compact budget #then keeps configured post-compact cap", () => {
+		// given
+		const transcriptPath = writeCompactedTranscript("A".repeat(541_500));
+
+		// when
+		const budget = withPostCompactBudget(CONFIG, { model: "gpt-5.6-terra", transcriptPath });
+
+		// then
+		expect(budget.maxRuleChars).toBe(CONFIG.postCompactMaxRuleChars);
+		expect(budget.maxResultChars).toBe(CONFIG.postCompactMaxResultChars);
+	});
+
+	it("#given gpt-5.6-luna within its 372k window #when resolving post-compact budget #then keeps configured post-compact cap", () => {
+		// given
+		const transcriptPath = writeCompactedTranscript("A".repeat(541_500));
+
+		// when
+		const budget = withPostCompactBudget(CONFIG, { model: "gpt-5.6-luna", transcriptPath });
+
+		// then
+		expect(budget.maxRuleChars).toBe(CONFIG.postCompactMaxRuleChars);
+		expect(budget.maxResultChars).toBe(CONFIG.postCompactMaxResultChars);
+	});
+
+	it("#given provider-prefixed gpt-5.6 variant within its 372k window #when resolving post-compact budget #then keeps configured post-compact cap", () => {
+		// given
+		const transcriptPath = writeCompactedTranscript("A".repeat(541_500));
+
+		// when
+		const budget = withPostCompactBudget(CONFIG, { model: "openai/gpt-5.6-sol", transcriptPath });
+
+		// then
+		expect(budget.maxRuleChars).toBe(CONFIG.postCompactMaxRuleChars);
+		expect(budget.maxResultChars).toBe(CONFIG.postCompactMaxResultChars);
+	});
+
+	it("#given unknown model with the same transcript #when resolving post-compact budget #then keeps the 200k fallback floor", () => {
+		// given
+		const transcriptPath = writeCompactedTranscript("A".repeat(541_500));
+
+		// when
+		const budget = withPostCompactBudget(CONFIG, { model: "unknown-model", transcriptPath });
+
+		// then
+		expect(budget.maxResultChars).toBe(500);
+		expect(budget.maxRuleChars).toBe(500);
+	});
+
 	it("#given context pressure marker after compaction #when resolving post-compact budget #then shrinks projected rule injection", () => {
 		// given
 		const transcriptPath = writeCompactedPressureTranscript("small compacted summary");

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.19.0) Checking Start-Work Continuation"
+						"statusMessage": "(OmO 4.19.1) 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.19.0) Checking Start-Work Continuation"
+						"statusMessage": "(OmO 4.19.1) 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.19.0",
+	"version": "4.19.1",
 	"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/teammode/hooks/hooks.json

@@ -8,7 +8,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook post-tool-use",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.19.0) Checking Thread Title Hygiene"
+						"statusMessage": "(OmO 4.19.1) Checking Thread Title Hygiene"
 					}
 				]
 			}

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

@@ -1,6 +1,6 @@
 {
 	"name": "@sisyphuslabs/codex-teammode",
-	"version": "4.19.0",
+	"version": "4.19.1",
 	"description": "Codex team-mode hook component that keeps background thread titles descriptive after create_thread.",
 	"type": "module",
 	"private": true,

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

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook session-start",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.19.0) Recording Session Telemetry"
+						"statusMessage": "(OmO 4.19.1) Recording Session Telemetry"
 					}
 				]
 			}

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

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-telemetry",
-	"version": "4.19.0",
+	"version": "4.19.1",
 	"description": "Codex plugin component that emits omo-codex anonymous daily-active telemetry on SessionStart.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/ultrawork/agents/lazycodex-clone-fidelity-reviewer.toml

@@ -1,8 +1,8 @@
 name = "lazycodex-clone-fidelity-reviewer"
 description = "Read-only LazyCodex clone / design-system fidelity reviewer. Verifies clone and design-port work is a rigorous, token-driven design system, not a pasted screenshot or hardcoded fake."
 nickname_candidates = ["Clone Fidelity Reviewer"]
-model = "gpt-5.6-sol"
-model_reasoning_effort = "xhigh"
+model = "gpt-5.6-terra"
+model_reasoning_effort = "high"
 
 developer_instructions = """
 Role: clone / design-system fidelity reviewer. Read-only.

package/packages/omo-codex/plugin/components/ultrawork/agents/lazycodex-code-reviewer.toml

@@ -1,8 +1,8 @@
 name = "lazycodex-code-reviewer"
 description = "Read-only LazyCodex code-quality reviewer. Audits diffs, tests, and risk with strict artifact-backed findings."
 nickname_candidates = ["Code Reviewer"]
-model = "gpt-5.6-sol"
-model_reasoning_effort = "xhigh"
+model = "gpt-5.6-terra"
+model_reasoning_effort = "medium"
 
 developer_instructions = """
 Role: code quality reviewer. Read-only.

package/packages/omo-codex/plugin/components/ultrawork/agents/lazycodex-gate-reviewer.toml

@@ -2,7 +2,7 @@ name = "lazycodex-gate-reviewer"
 description = "Read-only LazyCodex gate reviewer. Re-audits executor, code review, and QA artifacts before final approval."
 nickname_candidates = ["Gate Reviewer"]
 model = "gpt-5.6-sol"
-model_reasoning_effort = "high"
+model_reasoning_effort = "low"
 
 developer_instructions = """
 Role: final gate reviewer. Read-only.

package/packages/omo-codex/plugin/components/ultrawork/agents/lazycodex-worker-high.toml

@@ -2,7 +2,7 @@ name = "lazycodex-worker-high"
 description = "LazyCodex high-difficulty implementation worker, sized for LARGE changes: a new module or abstraction, a cross-module refactor, concurrency/security/migration work, or any real, complex, big problem that has ONE clear goal. Owns the smallest correct change and records evidence before claiming completion."
 nickname_candidates = ["High Worker"]
 model = "gpt-5.6-sol"
-model_reasoning_effort = "max"
+model_reasoning_effort = "medium"
 
 developer_instructions = """
 Role: implementation executor. You own the task end to end.

package/packages/omo-codex/plugin/components/ultrawork/agents/lazycodex-worker-medium.toml

@@ -1,8 +1,8 @@
 name = "lazycodex-worker-medium"
 description = "LazyCodex medium-difficulty implementation worker, sized for MID-SIZED changes: a standard feature inside existing layers, touching a few files along established patterns. Owns the smallest correct change and records evidence before claiming completion."
 nickname_candidates = ["Medium Worker"]
-model = "gpt-5.6-luna"
-model_reasoning_effort = "max"
+model = "gpt-5.6-terra"
+model_reasoning_effort = "high"
 
 developer_instructions = """
 Role: implementation executor. You own the task end to end.

package/packages/omo-codex/plugin/components/ultrawork/agents/plan.toml

@@ -2,7 +2,7 @@ name = "plan"
 description = "Strategic planning consultant for work with unresolved design uncertainty after discovery. Produces one executable plan; never implements. Writes the plan to .omo/plans/<slug>.md."
 nickname_candidates = ["Planner"]
 model = "gpt-5.6-sol"
-model_reasoning_effort = "max"
+model_reasoning_effort = "high"
 
 developer_instructions = """
 Role: strategic planning consultant. You produce a single, bulletproof, executable work plan only when discovery leaves unresolved design uncertainty.

package/packages/omo-codex/plugin/components/ultrawork/dist/cli.js

@@ -60,7 +60,7 @@ function buildUltraworkAdditionalContext(options = {}) {
 }
 
 // components/ultrawork/src/codex-hook.ts
-var ULTRAWORK_CURRENT_PROMPT_PATTERN = /(?:ultrawork|ulw)/i;
+var ULTRAWORK_CURRENT_PROMPT_PATTERN = /(?:ultrawork|ulw(?!-(?:plan|research)))/i;
 var ULTRAWORK_DIRECTIVE_MARKER = "<ultrawork-mode>";
 var TRANSCRIPT_SEARCH_BYTES = 512000;
 var CONTEXT_PRESSURE_MARKERS = [

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

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook user-prompt-submit",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.19.0) Checking Ultrawork Trigger"
+						"statusMessage": "(OmO 4.19.1) Checking Ultrawork Trigger"
 					}
 				]
 			}

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

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-ultrawork",
-	"version": "4.19.0",
+	"version": "4.19.1",
 	"description": "Codex plugin that injects the ultrawork orchestration directive and ships LazyCodex planning, review, QA, and gate agent roles.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/ultrawork/skills/ulw-plan/SKILL.md

@@ -13,11 +13,30 @@ You are **Prometheus**, a planning consultant. You turn a vague or large request
 
 Outcome-first: explore a lot, ask few sharp questions - or none, when the intent is fuzzy (see routing) - and stop the moment the plan is done.
 
+## MANDATORY OPENING ANNOUNCEMENT
+
+The FIRST user-visible line of the turn that activates this skill MUST be exactly:
+
+`ULW-PLAN MODE ENABLED!`
+
+If another active mode mandates its own first line (ultrawork does), print that line first and this marker on the next line - both contracts stay satisfied.
+
+Directly under the marker, before any exploration, state the working contract once, in your own words, carrying ALL of these commitments:
+
+1. **Persona + no-implementation pledge** - from now on you work as Prometheus, a planning consultant, and you will never start implementation - no product-code edits, no implementer subagents - until the user explicitly says okay; even then, approval authorizes writing the plan only, and execution starts in a separate worker session (e.g. `$start-work`).
+2. **Workflow preview** - the order of what happens next: parallel read-only exploration (plus outside research when the repo cannot answer) until the open unknowns are resolved; the intent verdict from INTENT ROUTING, announced; questions to the user ONLY when a genuine owner-decision survives exploration - or when exploration and research both come back empty on a fork the plan cannot proceed without; then the approval brief, and the plan is written only after the explicit okay.
+
+Example opening (adapt the wording, keep every commitment):
+
+> ULW-PLAN MODE ENABLED!
+> From now on I am working as Prometheus, a planning consultant. I will not start any implementation until you explicitly say okay - and approval authorizes writing the plan only; execution starts separately (e.g. `$start-work`).
+> Next, in order: (1) parallel read-only exploration and research, (2) intent verdict announced (CLEAR or UNCLEAR, plus whether high-accuracy review is required), (3) questions only for the forks exploration cannot settle - or where research finds nothing on a blocking decision, (4) approval brief, then (5) the plan is written after your okay.
+
 ## INTENT ROUTING - pick ONE intent reference
 
 **Review modifiers are a gate trigger, not a style cue.** If the user says "high accuracy", "ultra high accuracy", "고정밀", "deep review", or equivalent - in ANY turn, even appended to a follow-up question and even after the plan already exists - set `review_required: true` in the draft: the dual high-accuracy review (native `momus` + the independent Codex CLI review) is now REQUIRED before handoff, and if the plan already exists you run it this same turn. Answering the current question more carefully does NOT satisfy it. This does NOT choose CLEAR/UNCLEAR and does NOT suppress interview.
 
-After grounding, make ONE judgment, record `intent: clear|unclear` plus `review_required`, **ANNOUNCE both to the user in one line**, then load ONE intent reference (you ALSO read `references/full-workflow.md` for the shared mechanics - see below). The test keys on whether the desired **OUTCOME** is clear, NOT on request length. The announcement is the user's first signal of whether they will be interviewed and whether high-accuracy review is already requested - never skip it.
+After grounding, make ONE judgment, record `intent: clear|unclear` plus `review_required`, **ANNOUNCE both to the user in one line**, then load ONE intent reference (you ALSO read `references/full-workflow.md` for the shared mechanics - see below). The test keys on whether the desired **OUTCOME** is clear, NOT on request length. This verdict line and the opening announcement above are the two mandatory user-visible signals of a planning session - it tells the user whether they will be interviewed and whether high-accuracy review is already requested; never skip either.
 
 > "Intent: **CLEAR**, review required - you specified the endpoint and asked for high accuracy. I will ask only the genuine forks, then run the high-accuracy review after approval."
 > "Intent: **UNCLEAR**, review required - 'make auth better' is open-ended and you asked for high accuracy. I will choose best-practice defaults, then run the high-accuracy review automatically."

package/packages/omo-codex/plugin/components/ultrawork/src/codex-hook.ts

@@ -2,7 +2,7 @@ import { readFileSync } from "node:fs";
 
 import { buildUltraworkAdditionalContext, type UltraworkAdditionalContextOptions } from "./skill-pointer.js";
 
-const ULTRAWORK_CURRENT_PROMPT_PATTERN = /(?:ultrawork|ulw)/i;
+const ULTRAWORK_CURRENT_PROMPT_PATTERN = /(?:ultrawork|ulw(?!-(?:plan|research)))/i;
 const ULTRAWORK_DIRECTIVE_MARKER = "<ultrawork-mode>";
 const TRANSCRIPT_SEARCH_BYTES = 512_000;
 const CONTEXT_PRESSURE_MARKERS = [

package/packages/omo-codex/plugin/components/ultrawork/test/codex-hook-trigger-policy.test.ts

@@ -88,6 +88,48 @@ describe("codex ultrawork trigger policy", () => {
 		expect(isUltraworkPrompt(prompt)).toBe(true);
 	});
 
+	it("#given prompt invokes ulw-plan or ulw-research skills #when hook runs #then does not emit directive", () => {
+		// given
+		const prompts = [
+			"$omo:ulw-plan refactor the auth module",
+			"omo:ulw-plan",
+			"/ulw-plan",
+			"ulw-plan",
+			"$omo:ulw-research how does the hook pipeline work",
+			"ulw-research",
+			"please run ULW-PLAN for this",
+		] as const;
+
+		// when
+		const outputs = prompts.map((prompt) => runUserPromptSubmitHook({ hook_event_name: "UserPromptSubmit", prompt }));
+
+		// then
+		expect(outputs).toEqual(["", "", "", "", "", "", ""]);
+		expect(prompts.map((prompt) => isUltraworkPrompt(prompt))).toEqual([false, false, false, false, false, false, false]);
+	});
+
+	it("#given prompt contains ultrawork or standalone ulw #when hook runs #then emits directive", () => {
+		// given
+		const prompts = [
+			"ultrawork this change",
+			"ulw",
+			"ulw ",
+			"ulw fix this failing test",
+			"ulw-loop keep iterating until green",
+		] as const;
+
+		// when
+		const outputs = prompts.map((prompt) => runUserPromptSubmitHook({ hook_event_name: "UserPromptSubmit", prompt }));
+
+		// then
+		for (const output of outputs) {
+			const parsed = parseHookOutput(output);
+			expect(parsed.hookSpecificOutput.hookEventName).toBe("UserPromptSubmit");
+			expect(parsed.hookSpecificOutput.additionalContext).toMatch(/^<ultrawork-mode>/);
+		}
+		expect(prompts.map((prompt) => isUltraworkPrompt(prompt))).toEqual([true, true, true, true, true]);
+	});
+
 	it("#given prior transcript contains triggers but current prompt does not #when hook runs #then does not emit directive", () => {
 		// given
 		const payload = {

package/packages/omo-codex/plugin/components/ulw-loop/README.md

@@ -11,11 +11,11 @@ Every subcommand below is implemented. Pass `--json` where supported for machine
 | Subcommand | Purpose |
 |------------|---------|
 | `omo ulw-loop help` | Print CLI usage. |
-| `omo ulw-loop create-goals` | Create repo-native goals and seed success criteria from a brief. |
+| `omo ulw-loop create-goals` | Create repo-native goals and seed success criteria from a brief; optionally define review-boundary validation batches with `--validation-batch-json`. |
 | `omo ulw-loop status` | Report active goal, criteria, and evidence state. |
-| `omo ulw-loop complete-goals` | Start or resume the next eligible goal, or report aggregate completion / blocked handoff. |
-| `omo ulw-loop checkpoint` | Gate a goal transition with evidence; final completion requires a complete Codex goal snapshot and a passing quality gate. |
-| `omo ulw-loop steer` | Apply a steering mutation proposal to the plan. |
+| `omo ulw-loop complete-goals` | Manual fallback to start or resume the next eligible goal, or report aggregate completion / blocked handoff. |
+| `omo ulw-loop checkpoint` | Gate a goal transition with evidence; complete checkpoints auto-start the next eligible goal by default, with `--no-advance` preserving the legacy two-call flow. |
+| `omo ulw-loop steer` | Apply one steering mutation proposal or an atomic all-or-nothing batch with `--proposals-json`. |
 | `omo ulw-loop add-goal` | Append a goal to the active plan. |
 | `omo ulw-loop criteria` | Inspect one goal's success criteria. |
 | `omo ulw-loop record-evidence` | Record observable evidence for one criterion. |
@@ -23,6 +23,8 @@ Every subcommand below is implemented. Pass `--json` where supported for machine
 
 The final quality gate parsed by `checkpoint` validates `codeReview`, `manualQa`, `gateReview`, `iteration`, and `criteriaCoverage`. `criteriaCoverage` records the original intent, desired outcome, user-facing outcome review, pass counts, and covered adversarial classes.
 
+Validation batches are optional review boundaries declared at plan creation with `--validation-batch-json '[{"batchId":"VB001","memberIds":[...],"finalGoalId":"..."}]'`. The batch-final goal cannot complete until every other member is complete or superseded-resolved, every member criterion is pass, and a quality gate's coverage counts match the recomputed member criteria. Steering split/supersede mutations keep batch membership consistent and record `batch_updated`.
+
 ## Codex Plugin
 
 This directory is a component of the aggregate `@sisyphuslabs/omo-codex-plugin` root. Plugin discovery (`.codex-plugin/plugin.json`) is owned by that aggregate root, not by this component. The component ships:

package/packages/omo-codex/plugin/components/ulw-loop/dist/checkpoint-continuation.d.ts

@@ -0,0 +1,21 @@
+import { type CheckpointUlwLoopArgs, type CheckpointUlwLoopResult } from "./checkpoint.js";
+import { type UlwLoopGoalInstruction } from "./codex-goal-instruction.js";
+import type { UlwLoopScope } from "./paths.js";
+import type { UlwLoopItem } from "./types.js";
+type ContinuationNext = {
+    readonly resumed: boolean;
+    readonly goal: UlwLoopItem;
+    readonly instruction: UlwLoopGoalInstruction;
+} | {
+    readonly done: true;
+    readonly blocked: boolean;
+    readonly handoff: string;
+};
+export type CheckpointAndContinueResult = CheckpointUlwLoopResult & {
+    readonly next?: ContinuationNext;
+};
+export declare function checkpointAndContinue(repoRoot: string, args: CheckpointUlwLoopArgs & {
+    readonly advance: boolean;
+}, scope?: UlwLoopScope): Promise<CheckpointAndContinueResult>;
+export declare function checkpoint(repoRoot: string, argv: readonly string[], json: boolean, scope?: UlwLoopScope): Promise<number>;
+export {};

package/packages/omo-codex/plugin/components/ulw-loop/dist/checkpoint-continuation.js

@@ -0,0 +1,64 @@
+import { checkpointUlwLoop } from "./checkpoint.js";
+import { hasFlag, parseCodexGoalJson, readValue } from "./cli-arg-parser.js";
+import { blockedDecisionHandoff, printJson } from "./cli-output.js";
+import { buildCodexGoalInstruction } from "./codex-goal-instruction.js";
+import { startNextUlwLoop, summarizeUlwLoopPlan } from "./plan-crud.js";
+import { UlwLoopError } from "./types.js";
+export async function checkpointAndContinue(repoRoot, args, scope) {
+    const result = await checkpointUlwLoop(repoRoot, args, scope);
+    if (args.status !== "complete" || result.aggregateCompletion !== undefined || !args.advance)
+        return result;
+    const next = await startNextUlwLoop(repoRoot, {}, scope);
+    if ("done" in next)
+        return { ...result, plan: next.plan, next: doneNext(next.plan) };
+    const instruction = buildCodexGoalInstruction({ plan: next.plan, goal: next.goal });
+    return { ...result, plan: next.plan, next: { resumed: next.resumed, goal: next.goal, instruction } };
+}
+export async function checkpoint(repoRoot, argv, json, scope) {
+    const goalId = required(argv, "--goal-id");
+    const statusValue = checkpointStatus(required(argv, "--status"));
+    const evidence = required(argv, "--evidence");
+    const codexGoalJson = await parseCodexGoalJson(statusValue === "complete" ? required(argv, "--codex-goal-json") : readValue(argv, "--codex-goal-json"));
+    if (statusValue === "complete" && codexGoalJson === undefined) {
+        throw new UlwLoopError("Missing --codex-goal-json.", "ULW_LOOP_CODEX_GOAL_JSON_REQUIRED");
+    }
+    const qualityGateJson = readValue(argv, "--quality-gate-json");
+    const args = {
+        goalId,
+        status: statusValue,
+        evidence,
+        advance: !hasFlag(argv, "--no-advance"),
+        ...(codexGoalJson === undefined ? {} : { codexGoalJson }),
+        ...(qualityGateJson === undefined ? {} : { qualityGateJson }),
+    };
+    const result = await checkpointAndContinue(repoRoot, args, scope);
+    if (json)
+        printJson({ ok: true, ...result, summary: summarizeUlwLoopPlan(result.plan) });
+    else
+        printCheckpointText(result);
+    return 0;
+}
+function printCheckpointText(result) {
+    process.stdout.write(`ulw-loop checkpoint: ${result.goal.id} -> ${result.goal.status}\n`);
+    if (result.next === undefined)
+        return;
+    if ("instruction" in result.next)
+        process.stdout.write(`${result.next.instruction.text}\n`);
+    else
+        process.stdout.write(`${result.next.handoff || "ulw-loop: all goals complete"}\n`);
+}
+function doneNext(plan) {
+    const handoff = blockedDecisionHandoff(plan);
+    return { done: true, blocked: handoff.length > 0, handoff };
+}
+function required(argv, flag) {
+    const value = readValue(argv, flag)?.trim();
+    if (value)
+        return value;
+    throw new UlwLoopError(`Missing ${flag}.`, "ULW_LOOP_ARGUMENT_MISSING", { details: { flag } });
+}
+function checkpointStatus(value) {
+    if (value === "complete" || value === "failed" || value === "blocked")
+        return value;
+    throw new UlwLoopError("Missing or invalid --status; expected complete, failed, or blocked.", "ULW_LOOP_STATUS_INVALID", { details: { status: value } });
+}

package/packages/omo-codex/plugin/components/ulw-loop/dist/checkpoint.js

@@ -1,4 +1,4 @@
-import { ulwLoopAttemptEvidenceDir } from "./paths.js";
+// biome-ignore-all format: checkpoint stays under the pure LOC ceiling.
 import { existsSync, statSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
@@ -6,9 +6,11 @@ import { buildTaskScopedAggregateReconciliationHint, canReconcileActiveFinalTask
 import { formatCodexGoalReconciliation, readCodexGoalSnapshotInput, reconcileCodexGoalSnapshot, } from "./codex-goal-snapshot.js";
 import { requireAllCriteriaPass, requireAllPlanCriteriaPass, requireEssentialCriteriaPass } from "./evidence.js";
 import { codexGoalMode, compatibleCodexObjectives, expectedCodexObjective, isFinalRunCompletionCandidate, } from "./goal-status.js";
+import { ulwLoopAttemptEvidenceDir } from "./paths.js";
 import { appendLedger, readUlwLoopPlan, withUlwLoopMutationLock, writePlan } from "./plan-io.js";
 import { classifyExternalAuthorizationBlocker, clearGoalBlockerFields, sameBlockerOccurrences, validateQualityGate, } from "./quality-gate.js";
 import { iso, UlwLoopError } from "./types.js";
+import { batchClosedBy, requireAllValidationBatchesClosed, requireBatchFinalReady, requireBatchGate } from "./validation-batch.js";
 const QUALITY_GATE_FS = { existsSync, statSync };
 function ulwLoopFail(message, code) {
     throw new UlwLoopError(message, code);
@@ -112,9 +114,11 @@ export async function checkpointUlwLoop(repoRoot, args, scope) {
         if (args.status === "complete") {
             const aggregate = codexGoalMode(plan) === "aggregate";
             const final = isFinalRunCompletionCandidate(plan, goal);
+            const closesBatch = batchClosedBy(plan, goal.id) !== undefined;
             if (final) {
                 requireAllCriteriaPass(goal);
                 requireAllPlanCriteriaPass(plan);
+                requireAllValidationBatchesClosed(plan, goal.id);
             }
             else if (aggregate)
                 requireEssentialCriteriaPass(goal);
@@ -144,9 +148,13 @@ export async function checkpointUlwLoop(repoRoot, args, scope) {
                 if (!taskScoped)
                     throw new UlwLoopError(`${formatCodexGoalReconciliation(reconciliation)}${aggregate && snapshot?.status === "complete" && objective !== undefined ? buildTaskScopedAggregateReconciliationHint(goal, final) : ""}`, "ulw_loop_codex_snapshot_mismatch");
             }
+            if (closesBatch)
+                requireBatchFinalReady(plan, goal);
+            if (closesBatch && args.qualityGateJson === undefined)
+                throw new UlwLoopError("Validation batch final checkpoint requires --quality-gate-json.", "ULW_LOOP_VALIDATION_BATCH_GATE_REQUIRED");
             if (final)
                 aggregateCompletion = makeAggregateCompletion(now, evidence, codexGoal);
-            if (final || aggregateCompletion !== undefined)
+            if (final || aggregateCompletion !== undefined || closesBatch) {
                 qualityGate = validateQualityGate(await readJsonInput(args.qualityGateJson, repoRoot), {
                     repoRoot,
                     fs: QUALITY_GATE_FS,
@@ -154,6 +162,8 @@ export async function checkpointUlwLoop(repoRoot, args, scope) {
                         ? { currentAttemptDir: ulwLoopAttemptEvidenceDir(goal.id, goal.attempt, scope) }
                         : {}),
                 });
+                requireBatchGate(plan, goal, qualityGate);
+            }
             goal.status = "complete";
             goal.completedAt = now;
             goal.evidence = evidence;
@@ -172,6 +182,9 @@ export async function checkpointUlwLoop(repoRoot, args, scope) {
         await writePlan(repoRoot, plan, scope);
         const ledgerEntry = buildLedger(now, args, goal, qualityGate, codexGoal, aggregateCompletion);
         await appendLedger(repoRoot, ledgerEntry, scope);
+        const closedBatch = args.status === "complete" ? batchClosedBy(plan, goal.id) : undefined;
+        if (closedBatch !== undefined)
+            await appendLedger(repoRoot, { at: now, kind: "batch_closed", goalId: goal.id, message: closedBatch.batchId }, scope);
         return aggregateCompletion === undefined
             ? { plan, goal, ledgerEntry }
             : { plan, goal, ledgerEntry, aggregateCompletion };

package/packages/omo-codex/plugin/components/ulw-loop/dist/cli-arg-parser.js

@@ -1,7 +1,7 @@
 // biome-ignore-all format: keep this module under the mandated pure LOC budget.
 import { readFile } from "node:fs/promises";
 import { UlwLoopError } from "./types.js";
-const VALUE_FLAGS = new Set("--brief --brief-file --session-id --codex-goal-mode --goal --goal-id --criterion-id --status --evidence --notes --codex-goal-json --quality-gate-json --kind --rationale --title --objective --target-goal-id --source --after-json --directive-json --directive-file --idempotency-key".split(" "));
+const VALUE_FLAGS = new Set("--brief --brief-file --session-id --codex-goal-mode --validation-batch-json --goal --goal-id --criterion-id --status --evidence --notes --codex-goal-json --quality-gate-json --kind --rationale --title --objective --target-goal-id --source --after-json --directive-json --directive-file --idempotency-key --proposals-json".split(" "));
 const SUBCOMMANDS = new Set("create-goals status complete-goals criteria record-evidence checkpoint steer add-goal record-review-blockers".split(" "));
 export function hasFlag(argv, flag) { return argv.includes(flag); }
 export function readValue(argv, flag) {

package/packages/omo-codex/plugin/components/ulw-loop/dist/cli-commands.js

@@ -1,6 +1,7 @@
+import { checkpoint } from "./checkpoint-continuation.js";
 import { hasFlag, readValue } from "./cli-arg-parser.js";
 import { printJsonError, ULW_LOOP_HELP } from "./cli-output.js";
-import { addGoal, captureEvidence, checkpoint, completeGoals, createGoals, criteria, reviewBlockers, status, steer, } from "./cli-subcommands.js";
+import { addGoal, captureEvidence, completeGoals, createGoals, criteria, reviewBlockers, status, steer, } from "./cli-subcommands.js";
 import { resolveUlwLoopSessionIdFromEnv } from "./paths.js";
 import { UlwLoopError } from "./types.js";
 export const ULW_LOOP_SUBCOMMANDS = [

package/packages/omo-codex/plugin/components/ulw-loop/dist/cli-output.d.ts

@@ -1,5 +1,5 @@
 import type { UlwLoopCodexGoalMode, UlwLoopPlan } from "./types.js";
-export declare const ULW_LOOP_HELP = "Usage:\n  omo ulw-loop create-goals --brief \"...\" [--brief-file <path>] [--from-stdin] [--codex-goal-mode aggregate|per_story] [--force] [--json]\n  omo ulw-loop status [--json]\n  omo ulw-loop complete-goals [--retry-failed] [--json]\n  omo ulw-loop criteria --goal-id <id> [--json]\n  omo ulw-loop record-evidence --goal-id <id> --criterion-id <id> --status pass|fail|blocked --evidence \"...\" [--notes \"...\"] [--json]\n  omo ulw-loop checkpoint --goal-id <id> --status complete|failed|blocked --evidence \"...\" --codex-goal-json <...> [--quality-gate-json <...>] [--json]\n  omo ulw-loop steer --kind <kind> ... --evidence \"...\" --rationale \"...\" [--json]\n  omo ulw-loop add-goal --title \"...\" --objective \"...\" [--json]\n  omo ulw-loop record-review-blockers --goal-id <id> --title \"...\" --objective \"...\" --evidence \"...\" --codex-goal-json <...> [--json]\n\nAll subcommands accept [--session-id <id>] to isolate state under .omo/ulw-loop/<id>/; without it, Codex session env is used when present.";
+export declare const ULW_LOOP_HELP = "Usage:\n  omo ulw-loop create-goals --brief \"...\" [--brief-file <path>] [--from-stdin] [--codex-goal-mode aggregate|per_story] [--validation-batch-json <json-or-path>] [--force] [--json]\n  omo ulw-loop status [--json]\n  omo ulw-loop complete-goals [--retry-failed] [--json]\n  omo ulw-loop criteria --goal-id <id> [--json]\n  omo ulw-loop record-evidence --goal-id <id> --criterion-id <id> --status pass|fail|blocked --evidence \"...\" [--notes \"...\"] [--json]\n  omo ulw-loop checkpoint --goal-id <id> --status complete|failed|blocked --evidence \"...\" --codex-goal-json <...> [--quality-gate-json <...>] [--no-advance] [--json]\n  omo ulw-loop steer --kind <kind> ... --evidence \"...\" --rationale \"...\" [--proposals-json <json-or-path>] [--json]\n  omo ulw-loop add-goal --title \"...\" --objective \"...\" [--json]\n  omo ulw-loop record-review-blockers --goal-id <id> --title \"...\" --objective \"...\" --evidence \"...\" --codex-goal-json <...> [--json]\n\nAll subcommands accept [--session-id <id>] to isolate state under .omo/ulw-loop/<id>/; without it, Codex session env is used when present.";
 export declare function printJson(value: unknown): void;
 export declare function printJsonError(error: unknown): void;
 export declare function printStatus(plan: UlwLoopPlan): void;

package/packages/omo-codex/plugin/components/ulw-loop/dist/cli-output.js

@@ -1,12 +1,12 @@
 import { UlwLoopError } from "./types.js";
 export const ULW_LOOP_HELP = `Usage:
-  omo ulw-loop create-goals --brief "..." [--brief-file <path>] [--from-stdin] [--codex-goal-mode aggregate|per_story] [--force] [--json]
+  omo ulw-loop create-goals --brief "..." [--brief-file <path>] [--from-stdin] [--codex-goal-mode aggregate|per_story] [--validation-batch-json <json-or-path>] [--force] [--json]
   omo ulw-loop status [--json]
   omo ulw-loop complete-goals [--retry-failed] [--json]
   omo ulw-loop criteria --goal-id <id> [--json]
   omo ulw-loop record-evidence --goal-id <id> --criterion-id <id> --status pass|fail|blocked --evidence "..." [--notes "..."] [--json]
-  omo ulw-loop checkpoint --goal-id <id> --status complete|failed|blocked --evidence "..." --codex-goal-json <...> [--quality-gate-json <...>] [--json]
-  omo ulw-loop steer --kind <kind> ... --evidence "..." --rationale "..." [--json]
+  omo ulw-loop checkpoint --goal-id <id> --status complete|failed|blocked --evidence "..." --codex-goal-json <...> [--quality-gate-json <...>] [--no-advance] [--json]
+  omo ulw-loop steer --kind <kind> ... --evidence "..." --rationale "..." [--proposals-json <json-or-path>] [--json]
   omo ulw-loop add-goal --title "..." --objective "..." [--json]
   omo ulw-loop record-review-blockers --goal-id <id> --title "..." --objective "..." --evidence "..." --codex-goal-json <...> [--json]