lazycodex-ai 5.0.0-beta.4 → 5.0.0-beta.40

package/packages/omo-codex/plugin/test/hook-status-message.test.mjs

@@ -25,13 +25,12 @@ const AGGREGATE_EXPECTED_LABELS = new Map([
 	["hooks/hooks.json:PreToolUse:1:0", "Enforcing Unlimited Goal Budget"],
 	["hooks/hooks.json:PostToolUse:0:0", "Checking Comments"],
 	["hooks/hooks.json:PostToolUse:0:1", "Checking LSP Diagnostics"],
-	["hooks/hooks.json:PostToolUse:0:2", "Checking CodeGraph Init Guidance"],
 	["hooks/hooks.json:PostToolUse:1:0", "Matching Project Rules"],
 	["hooks/hooks.json:PostCompact:0:0", "Resetting Git Bash MCP Reminder"],
 	["hooks/hooks.json:PostCompact:1:0", "Resetting Project Rule Cache"],
 	["hooks/hooks.json:PostCompact:2:0", "Resetting LSP Diagnostics Cache"],
-	["hooks/hooks.json:Stop:0:0", "Checking Start-Work Continuation"],
-	["hooks/hooks.json:SubagentStop:0:0", "Checking Start-Work Continuation"],
+	["hooks/hooks.json:Stop:0:0", "Checking Ulw-Execute Continuation"],
+	["hooks/hooks.json:SubagentStop:0:0", "Checking Ulw-Execute Continuation"],
 	["hooks/hooks.json:SubagentStop:1:0", "Verifying LazyCodex Executor Evidence"],
 ]);
 
@@ -47,8 +46,8 @@ const COMPONENT_EXPECTED_LABELS = new Map([
 	["components/ultrawork/hooks/hooks.json:UserPromptSubmit:0:0", "Checking Ultrawork Trigger"],
 	["components/ulw-loop/hooks/hooks.json:UserPromptSubmit:0:0", "Checking Ulw-Loop Steering"],
 	["components/ulw-loop/hooks/hooks.json:PreToolUse:0:0", "Enforcing Unlimited Ulw-Loop Budget"],
-	["components/start-work-continuation/hooks/hooks.json:Stop:0:0", "Checking Start-Work Continuation"],
-	["components/start-work-continuation/hooks/hooks.json:SubagentStop:0:0", "Checking Start-Work Continuation"],
+	["components/ulw-execute-continuation/hooks/hooks.json:Stop:0:0", "Checking Ulw-Execute Continuation"],
+	["components/ulw-execute-continuation/hooks/hooks.json:SubagentStop:0:0", "Checking Ulw-Execute Continuation"],
 	[
 		"components/lazycodex-executor-verify/hooks/hooks.json:SubagentStop:0:0",
 		"Verifying LazyCodex Executor Evidence",

package/packages/omo-codex/plugin/test/lcx-contribute-bug-fix-template.test.mjs

@@ -8,7 +8,7 @@ import { fileURLToPath } from "node:url";
 const root = dirname(dirname(fileURLToPath(import.meta.url)));
 const scriptPath = join(root, "skills", "lcx-contribute-bug-fix", "scripts", "create-pr-body.mjs");
 
-test("#given complete bug-fix evidence #when creating a PR body #then required LazyCodex sections and label are emitted", async () => {
+test("#given complete bug-fix evidence #when creating a PR body #then evidence and machine label are emitted", async () => {
 	// given
 	const { createLazyCodexBugFixPrBody } = await import(`file://${scriptPath}`);
 	const input = {
@@ -27,15 +27,11 @@ test("#given complete bug-fix evidence #when creating a PR body #then required L
 	const body = createLazyCodexBugFixPrBody(input);
 
 	// then
-	assert.match(body, /^## Problem Situation/m);
-	assert.match(body, /## Reproduction Logs/);
-	assert.match(body, /## Approach/);
-	assert.match(body, /## Why I Am Confident/);
-	assert.match(body, /## Risks/);
-	assert.match(body, /## User-Visible Behavior Changes/);
-	assert.match(body, /## Verification/);
-	assert.match(body, /lazycodex-generated/);
-	assert.match(body, /This PR was debugged, implemented, and created with \[LazyCodex\]/);
+	for (const field of ["problem", "reproductionLogs", "approach", "confidence", "risks", "userVisibleBehaviorChanges"]) {
+		assert.ok(body.includes(input[field]));
+	}
+	for (const command of input.verification) assert.ok(body.includes(command));
+	assert.match(body, /^Tag: lazycodex-generated$/m);
 });
 
 test("#given missing bug-fix evidence #when creating a PR body #then the script rejects the incomplete payload", async () => {
@@ -57,7 +53,7 @@ test("#given missing bug-fix evidence #when creating a PR body #then the script
 		});
 
 	// then
-	assert.throws(action, /reproductionLogs must be a non-empty string/);
+	assert.throws(action, /reproductionLogs/);
 });
 
 test("#given a JSON payload path #when running the PR body script #then markdown is written to the requested file", async () => {
@@ -65,27 +61,25 @@ test("#given a JSON payload path #when running the PR body script #then markdown
 	const workspace = await mkdtemp(join(tmpdir(), "lcx-pr-body-test-"));
 	const inputPath = join(workspace, "input.json");
 	const outputPath = join(workspace, "body.md");
-	await writeFile(
-		inputPath,
-		JSON.stringify({
-			title: "Fix Codex skill sync drift",
-			targetRepository: "code-yeongyu/lazycodex",
-			problem: "Skill sync omitted a shared skill from the aggregate plugin.",
-			reproductionLogs: "node --test failed before the fix.",
-			approach: "Add the missing shared skill source and sync the aggregate plugin.",
-			confidence: "The failing sync test now passes.",
-			risks: "Low risk.",
-			userVisibleBehaviorChanges: "Users get a direct bug-fix PR skill.",
-			verification: ["node --test test/lcx-contribute-bug-fix-template.test.mjs"],
-		}),
-		"utf8",
-	);
+	const input = {
+		title: "Fix Codex skill sync drift",
+		targetRepository: "code-yeongyu/lazycodex",
+		problem: "Skill sync omitted a shared skill from the aggregate plugin.",
+		reproductionLogs: "node --test failed before the fix.",
+		approach: "Add the missing shared skill source and sync the aggregate plugin.",
+		confidence: "The failing sync test now passes.",
+		risks: "Low risk.",
+		userVisibleBehaviorChanges: "Users get a direct bug-fix PR skill.",
+		verification: ["node --test test/lcx-contribute-bug-fix-template.test.mjs"],
+	};
+	await writeFile(inputPath, JSON.stringify(input), "utf8");
 
 	// when
 	const { spawnSync } = await import("node:child_process");
+	const { createLazyCodexBugFixPrBody } = await import(`file://${scriptPath}`);
 	const result = spawnSync(process.execPath, [scriptPath, inputPath, outputPath], { encoding: "utf8" });
 
 	// then
 	assert.equal(result.status, 0, result.stderr);
-	assert.match(await readFile(outputPath, "utf8"), /## User-Visible Behavior Changes/);
+	assert.equal(await readFile(outputPath, "utf8"), createLazyCodexBugFixPrBody(input));
 });

package/packages/omo-codex/plugin/test/mcp-research-servers.test.mjs

@@ -14,11 +14,9 @@ test("#given aggregate MCP config #when inspected #then registers research MCPs
 	const serverNames = Object.keys(mcp.mcpServers).sort();
 
 	// then
-	assert.deepEqual(serverNames, ["codegraph", "context7", "git_bash", "grep_app", "lsp"]);
+	assert.deepEqual(serverNames, ["context7", "git_bash", "grep_app", "lsp"]);
 	assert.equal(mcp.mcpServers.grep_app.url, "https://mcp.grep.app");
 	assert.equal(mcp.mcpServers.context7.url, "https://mcp.context7.com/mcp");
 	assert.equal(Object.hasOwn(mcp.mcpServers, "ast_grep"), false);
-	assert.deepEqual(mcp.mcpServers.codegraph.args, ["components/codegraph/dist/serve.js"]);
-	assert.equal(mcp.mcpServers.codegraph.required, false);
 	assert.equal(mcp.mcpServers.lsp.startup_timeout_sec, 10);
 });

package/packages/omo-codex/plugin/test/migrate-codex-config.test.mjs

@@ -55,7 +55,7 @@ test("#given stale root reasoning config #when ensuring config #then replaces st
 	assert.equal(result.match(/^model_reasoning_effort\s*=/gm)?.length, 1);
 	assert.equal(result.match(/^plan_mode_reasoning_effort\s*=/gm)?.length, 1);
 	assert.match(result, /model = "gpt-5\.6-sol"/);
-	assert.match(result, /model_context_window = 372000/);
+	assert.match(result, /model_context_window = 650000/);
 	assert.match(result, /model_reasoning_effort = "high"/);
 	assert.match(result, /plan_mode_reasoning_effort = "xhigh"/);
 	assert.doesNotMatch(result, /gpt-5\.2/);
@@ -80,7 +80,7 @@ test("#given section settings reuse managed root keys #when ensuring config #the
 	);
 
 	assert.match(result, /^model = "gpt-5\.6-sol"$/m);
-	assert.match(result, /^model_context_window = 372000$/m);
+	assert.match(result, /^model_context_window = 650000$/m);
 	assert.match(result, /\[model_providers\.openai\]\nmodel = "provider-scoped-value"\nmodel_context_window = 123456/);
 	assert.match(result, /\[profiles\.review\]\nmodel_reasoning_effort = "medium"\nplan_mode_reasoning_effort = "medium"/);
 });
@@ -162,7 +162,7 @@ test("#given global and project-local stale Codex configs #when migrating #then
 
 	assert.deepEqual(result.changed.sort(), [join(codexHome, "config.toml"), projectConfig].sort());
 	assert.match(await readFile(join(codexHome, "config.toml"), "utf8"), /model = "gpt-5\.6-sol"/);
-	assert.match(await readFile(projectConfig, "utf8"), /model_context_window = 372000/);
+	assert.match(await readFile(projectConfig, "utf8"), /model_context_window = 650000/);
 });
 
 test("#given model catalog is unavailable and stale 272k config #when migrating #then fallback catalog still upgrades it", async () => {
@@ -184,7 +184,7 @@ test("#given model catalog is unavailable and stale 272k config #when migrating
 	const content = await readFile(join(codexHome, "config.toml"), "utf8");
 	assert.deepEqual(result.changed, [join(codexHome, "config.toml")]);
 	assert.match(content, /model = "gpt-5\.6-sol"/);
-	assert.match(content, /model_context_window = 372000/);
+	assert.match(content, /model_context_window = 650000/);
 });
 
 test("#given model catalog is malformed and stale config #when migrating #then fallback catalog still upgrades it", async () => {
@@ -207,7 +207,7 @@ test("#given model catalog is malformed and stale config #when migrating #then f
 	const content = await readFile(join(codexHome, "config.toml"), "utf8");
 	assert.deepEqual(result.changed, [join(codexHome, "config.toml")]);
 	assert.match(content, /model = "gpt-5\.6-sol"/);
-	assert.match(content, /model_context_window = 372000/);
+	assert.match(content, /model_context_window = 650000/);
 });
 
 test("#given user-customized Codex model config #when migrating #then user values are preserved without root multi-agent mode", async () => {
@@ -262,7 +262,7 @@ test("#given managed config state is malformed #when migrating #then migration i
 	const content = await readFile(join(codexHome, "config.toml"), "utf8");
 	const state = JSON.parse(await readFile(statePath, "utf8"));
 	assert.deepEqual(result.changed, [join(codexHome, "config.toml")]);
-	assert.match(content, /model_context_window = 372000/);
+	assert.match(content, /model_context_window = 650000/);
 	assert.equal(state.files[join(codexHome, "config.toml")].managed, true);
 });
 
@@ -671,14 +671,14 @@ test("#given global config starts with inline-comment features table #when full
 	const parsed = parseTomlWithPython(content);
 	assert.equal("multi_agent_mode" in parsed, false);
 	assert.equal(parsed.model, "gpt-5.6-sol");
-	assert.equal(parsed.model_context_window, 372000);
+	assert.equal(parsed.model_context_window, 650000);
 	assert.equal(parsed.model_reasoning_effort, "high");
 	assert.equal(parsed.plan_mode_reasoning_effort, "xhigh");
 	assert.equal(parsed.features.plugins, true);
 	assert.equal("multi_agent_mode" in parsed.features, false);
 	assert.equal("model" in parsed.features, false);
 	assert.equal("model_context_window" in parsed.features, false);
-	assert.match(content, /^model = "gpt-5\.6-sol"\nmodel_context_window = 372000/m);
+	assert.match(content, /^model = "gpt-5\.6-sol"\nmodel_context_window = 650000/m);
 	assert.doesNotMatch(content, /^\s*multi_agent_mode\s*=/m);
 	assert.match(content, /\[features\] # keep comment\nplugins = true/);
 });

package/packages/omo-codex/plugin/test/scaffold-plan.test.mjs

@@ -8,42 +8,6 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 const root = dirname(dirname(fileURLToPath(import.meta.url)));
 const scriptPath = join(root, "skills", "ulw-plan", "scripts", "scaffold-plan.mjs");
 const scriptUrl = pathToFileURL(scriptPath).href;
-const workflowPath = join(root, "skills", "ulw-plan", "references", "full-workflow.md");
-
-test("#given the scaffold script and the workflow reference #when compared #then every plan header the script emits is documented in full-workflow.md (no drift)", async () => {
-	// given
-	const { PLAN_SECTION_HEADERS } = await import(scriptUrl);
-	const workflow = await readFile(workflowPath, "utf8");
-
-	// then --- the script is the single source of the plan shape; the reference must document the same headers
-	assert.ok(PLAN_SECTION_HEADERS.length >= 6);
-	for (const header of PLAN_SECTION_HEADERS) {
-		assert.ok(workflow.includes(header), `full-workflow.md is missing plan header: ${header}`);
-	}
-});
-
-test("#given buildPlanSkeleton #when intent is unclear #then the human TL;DR leads the plan and surfaces the decisions veto block", async () => {
-	// given
-	const { buildPlanSkeleton, PLAN_SECTION_HEADERS } = await import(scriptUrl);
-	const plan = buildPlanSkeleton("demo", "unclear");
-
-	// then --- the human-readable summary is on top, above the AI detail
-	assert.ok(plan.indexOf("## TL;DR (For humans)") < plan.indexOf("## Scope"));
-	assert.match(plan, /Decisions I made for you/);
-	for (const header of PLAN_SECTION_HEADERS) {
-		assert.ok(plan.includes(header), `plan skeleton missing header: ${header}`);
-	}
-});
-
-test("#given buildPlanSkeleton #when intent is clear #then it surfaces a decisions-to-sanity-check block instead", async () => {
-	// given
-	const { buildPlanSkeleton } = await import(scriptUrl);
-	const plan = buildPlanSkeleton("demo", "clear");
-
-	// then
-	assert.match(plan, /Decisions to sanity-check/);
-	assert.doesNotMatch(plan, /Decisions I made for you/);
-});
 
 test("#given resolveSafeOmoPath #when the target escapes .omo or the workspace #then it is refused (the script never escapes .omo)", async () => {
 	// given

package/packages/omo-codex/plugin/test/sync-skills-codex-compatibility.test.mjs

@@ -0,0 +1,101 @@
+import assert from "node:assert/strict";
+import { readdir, readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+
+import {
+	codexHarnessToolCompatibility,
+	insertCodexCompatibilityGuidance,
+} from "../scripts/sync-skills.mjs";
+
+const frontmatter = "---\nname: fixture-sentinel\n---\n\n";
+const opencodeExample = "# SENTINEL_SECTION\ntask(SENTINEL_INPUT)\n";
+const pluginRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const repositoryRoot = join(pluginRoot, "..", "..");
+const opencodeToolPattern = /\b(?:call_omo_agent|background_output|team_[a-z_]+|task)\s*\(/;
+
+test("#given sentinel OpenCode tool content #when compatibility guidance is inserted #then the production artifact is placed after frontmatter and before the tool token", () => {
+	const input = `${frontmatter}${opencodeExample}`;
+
+	const actual = insertCodexCompatibilityGuidance(input);
+
+	assert.equal(actual, `${frontmatter}${codexHarnessToolCompatibility}${opencodeExample}`);
+	assert.ok(actual.indexOf(codexHarnessToolCompatibility) < actual.indexOf(opencodeExample));
+});
+
+test("#given already transformed sentinel content #when compatibility guidance is inserted again #then the transform is idempotent", () => {
+	const once = insertCodexCompatibilityGuidance(`${frontmatter}${opencodeExample}`);
+
+	const twice = insertCodexCompatibilityGuidance(once);
+
+	assert.equal(twice, once);
+});
+
+test("#given a stale generated compatibility block #when guidance is inserted #then the production artifact replaces it", () => {
+	const staleSentinel = "STALE_GENERATED_SENTINEL";
+	const staleGuidance = codexHarnessToolCompatibility.replace("multi_agent_v1.spawn_agent", staleSentinel);
+	assert.notEqual(staleGuidance, codexHarnessToolCompatibility);
+
+	const actual = insertCodexCompatibilityGuidance(`${frontmatter}${staleGuidance}${opencodeExample}`);
+
+	assert.equal(actual, `${frontmatter}${codexHarnessToolCompatibility}${opencodeExample}`);
+	assert.equal(actual.includes(staleSentinel), false);
+});
+
+test("#given a custom compatibility block before an OpenCode tool token #when guidance is inserted #then the custom block is preserved", () => {
+	const generatedHeading = codexHarnessToolCompatibility.slice(0, codexHarnessToolCompatibility.indexOf("\n") + 1);
+	const customBlock = `${generatedHeading}\nCUSTOM_BLOCK_SENTINEL\n\n`;
+	const input = `${frontmatter}${customBlock}${opencodeExample}`;
+
+	const actual = insertCodexCompatibilityGuidance(input);
+
+	assert.equal(actual, input);
+});
+
+test("#given an exported template wrapper containing an OpenCode tool token #when guidance is inserted #then wrapper bytes are preserved", () => {
+	const templateWrapper = "export const TEMPLATE_SENTINEL = `task(INPUT_SENTINEL)`;\n";
+
+	const actual = insertCodexCompatibilityGuidance(templateWrapper);
+
+	assert.equal(actual, `${codexHarnessToolCompatibility}${templateWrapper}`);
+});
+
+test("#given real shared skills that need Codex translation #when aggregate skills are synced #then each generated skill injects the production compatibility artifact once before any remaining OpenCode tool token", async () => {
+	const sharedSkillsRoot = join(repositoryRoot, "shared-skills", "skills");
+	const entries = await readdir(sharedSkillsRoot, { withFileTypes: true });
+	const syncScript = await readFile(join(pluginRoot, "scripts", "sync-skills.mjs"), "utf8");
+	const componentSkillNames = new Set(
+		[...syncScript.matchAll(/\[\s*"([^"]+)"\s*,\s*"components\//g)].map((match) => match[1]),
+	);
+	let checked = 0;
+
+	for (const entry of entries) {
+		if (!entry.isDirectory()) continue;
+		if (componentSkillNames.has(entry.name)) continue;
+		const source = await readFile(join(sharedSkillsRoot, entry.name, "SKILL.md"), "utf8");
+		const sourceToolToken = source.match(opencodeToolPattern)?.[0];
+		if (!sourceToolToken) continue;
+		const generated = await readFile(join(pluginRoot, "skills", entry.name, "SKILL.md"), "utf8");
+
+		assert.equal(generated.split(codexHarnessToolCompatibility).length - 1, 1, entry.name);
+		const compatibilityIndex = generated.indexOf(codexHarnessToolCompatibility);
+		assert.ok(compatibilityIndex >= 0, entry.name);
+		const firstGeneratedToolIndex = generated.search(opencodeToolPattern);
+		assert.ok(firstGeneratedToolIndex >= compatibilityIndex, entry.name);
+		assert.ok(firstGeneratedToolIndex < compatibilityIndex + codexHarnessToolCompatibility.length, entry.name);
+		checked += 1;
+	}
+
+	assert.ok(checked > 0, "at least one shared skill must exercise compatibility injection");
+});
+
+test("#given the aggregate sync implementation #when its skill adaptation pipeline is inspected #then it still applies compatibility guidance before overlays", async () => {
+	const script = await readFile(join(pluginRoot, "scripts", "sync-skills.mjs"), "utf8");
+
+	assert.match(
+		script,
+		/applyCodexSkillOverlays\(\s*skillName,\s*insertCodexCompatibilityGuidance\(content\),?\s*\)/,
+	);
+	assert.match(script, /await adaptSkillForCodex\(skillName\)/);
+});

package/packages/omo-codex/plugin/test/sync-skills-test-support.mjs

@@ -23,16 +23,19 @@ export const expectedSkills = [
 	"remove-ai-slops",
 	"review-work",
 	"rules",
-	"start-work",
 	"teammode",
 	"ultimate-browsing",
 	"ultrawork",
+	"ulw-execute",
 	"ulw-loop",
 	"ulw-plan",
 	"ulw-research",
 	"visual-qa",
 ];
 
+// `ultrawork` is intentionally absent: its skill body is composed by sync-skills.mjs directly from
+// the canonical packages/prompts-core/prompts/ultrawork/codex.md, so it has no component skill
+// source directory to diff against. Its composition is asserted separately in sync-skills.test.mjs.
 export const componentSkillSources = [
 	["comment-checker", "components/comment-checker/skills/comment-checker"],
 	["lcx-contribute-bug-fix", "components/lcx/skills/lcx-contribute-bug-fix"],
@@ -43,9 +46,16 @@ export const componentSkillSources = [
 	["teammode", "components/teammode/skills/teammode"],
 	["ulw-loop", "components/ulw-loop/skills/ulw-loop"],
 	["ulw-plan", "components/ultrawork/skills/ulw-plan"],
-	["ultrawork", "components/ultrawork/skills/ultrawork"],
 ];
 
+export const canonicalUltraworkDirectiveRelativePath = join(
+	"packages",
+	"prompts-core",
+	"prompts",
+	"ultrawork",
+	"codex.md",
+);
+
 const codexCompatibilityEndMarkers = [
 	"For work likely to exceed one wait cycle, require the child to send `WORKING: <task> - <current phase>` before long passes and `BLOCKED: <reason>` only when progress stops. A `multi_agent_v1.wait_agent` timeout only means no new mailbox update arrived. Treat a running child as alive. Fallback only when the child is completed without the deliverable, ack-only after followup, explicitly `BLOCKED:`, or no longer running.\n\n",
 	"On `multi_agent_v2` sessions the same `agent_type` applies (the OMO installer exposes it) with `fork_turns` instead of `fork_context`. If a code block below conflicts with this section, this section wins.\n\n",
@@ -69,33 +79,33 @@ export function removeCodexCompatibilityGuidance(content) {
 	return `${content.slice(0, start)}${content.slice(end + endMarker.length)}`;
 }
 
-const startWorkOriginalCompletion = `When all top-level checkboxes in \`## TODOs\` and \`## Final Verification Wave\` are complete:
+const ulwExecuteOriginalCompletion = `When all top-level checkboxes in \`## TODOs\` and \`## Final Verification Wave\` are complete:
 
 1. Run the plan's final verification commands.
 2. For PR/branch work, finish the lifecycle from the task-owned worktree: sync \`.omo/\` state back to the main repo, create or update the PR, wait for review/verification gates, merge by default unless explicitly opted out, and remove the worktree only after successful merge or explicit handoff.
 3. Remove or mark the Boulder work as completed.
 4. Print an \`ORCHESTRATION COMPLETE\` block with the plan path, verification commands, artifacts, and cleanup receipts.`;
 
-const startWorkCodexCompletion = `When all top-level checkboxes in \`## TODOs\` and \`## Final Verification Wave\` are complete:
+const ulwExecuteCodexCompletion = `When all top-level checkboxes in \`## TODOs\` and \`## Final Verification Wave\` are complete:
 
 1. Run the plan's final verification commands.
 2. Complete the **Global Review and Debugging Gate** before any completion claim, PR creation, PR handoff, branch handoff, or merge:
    - Invoke the \`review-work\` skill with the final diff, changed files, user goal, constraints, run command, and verification evidence. All five review lanes must return PASS. A timeout, missing deliverable, ack-only child, \`BLOCKED:\`, or inconclusive lane is a gate failure, not approval.
-   - Each passing review lane binds to the exact full commit SHA it reviewed. Immediately append a durable record to \`.omo/start-work/ledger.jsonl\` with the lane name, full SHA, PASS verdict, and report artifact/source. Before same-SHA reuse after any continuation or compaction, re-read the ledger record and require the exact lane/SHA pair; memory, chat history, or an unstamped report is not coverage. New commits require fresh applicable lane coverage.
-   - Run a debugging-oriented runtime audit even when the review passes: name at least three plausible failure hypotheses for the changed surface, run the distinguishing checks against the actual artifact, and append a separate durable record with the audit name, exact full SHA, verdict, and evidence artifact/source to \`.omo/start-work/ledger.jsonl\`. Reuse it only after re-reading an exact audit/SHA match.
+   - Each passing review lane binds to the exact full commit SHA it reviewed. Immediately append a durable record to \`.omo/ulw-execute/ledger.jsonl\` with the lane name, full SHA, PASS verdict, and report artifact/source. Before same-SHA reuse after any continuation or compaction, re-read the ledger record and require the exact lane/SHA pair; memory, chat history, or an unstamped report is not coverage. New commits require fresh applicable lane coverage.
+   - Run a debugging-oriented runtime audit even when the review passes: name at least three plausible failure hypotheses for the changed surface, run the distinguishing checks against the actual artifact, and append a separate durable record with the audit name, exact full SHA, verdict, and evidence artifact/source to \`.omo/ulw-execute/ledger.jsonl\`. Reuse it only after re-reading an exact audit/SHA match.
    - If any review lane or debugging hypothesis fails, invoke the \`debugging\` skill, confirm root cause with runtime evidence, add the minimal failing test or reproduction, fix it, rerun the affected verification, then rerun the Global Review and Debugging Gate.
-   - Evidence hygiene is mandatory: redact or mask secrets and sensitive user data before writing \`.omo/start-work/ledger.jsonl\`, a PR body, or a handoff. Never include raw tokens, credentials, auth headers, cookies, API keys, env dumps, private logs, or PII; use concise summaries, lengths, hashes, or short non-sensitive prefixes instead.
+   - Evidence hygiene is mandatory: redact or mask secrets and sensitive user data before writing \`.omo/ulw-execute/ledger.jsonl\`, a PR body, or a handoff. Never include raw tokens, credentials, auth headers, cookies, API keys, env dumps, private logs, or PII; use concise summaries, lengths, hashes, or short non-sensitive prefixes instead.
    - If the work includes creating, updating, or handing off a PR, refresh \`git status\` and the PR/branch state from the task-owned worktree after the gate, and include only redacted review/debugging evidence in the PR body or handoff.
 3. Finish the PR/branch lifecycle from its task-owned worktree: sync \`.omo/\` state back to the main repo, create or update the PR when requested, wait for CI/review/Cubic gates, merge by default unless explicitly opted out, and remove the worktree only after successful merge or explicit handoff.
 4. Remove or mark the Boulder work as completed.
 5. Print an \`ORCHESTRATION COMPLETE\` block with the plan path, verification commands, Global Review and Debugging Gate verdict, artifacts, and cleanup receipts.`;
 
-const startWorkOriginalHardRule = "- No completion claim while an applicable ultraqa adversarial class was never probed. Each applicable class needs a captured observable result; each skipped class needs a one-line not-applicable reason in the ledger.\n- No PR/branch implementation, review, or merge in the main worktree; use the task-owned git worktree.\n- No unprefixed session ids in Boulder state. Sessions are always recorded as `codex:<session_id>`.";
+const ulwExecuteOriginalHardRule = "- No completion claim while an applicable ultraqa adversarial class was never probed. Each applicable class needs a captured observable result; each skipped class needs a one-line not-applicable reason in the ledger.\n- No PR/branch implementation, review, or merge in the main worktree; use the task-owned git worktree.\n- No unprefixed session ids in Boulder state. Sessions are always recorded as `codex:<session_id>`.";
 
-const startWorkCodexHardRule = "- No completion claim while an applicable ultraqa adversarial class was never probed. Each applicable class needs a captured observable result; each skipped class needs a one-line not-applicable reason in the ledger.\n- No `ORCHESTRATION COMPLETE`, final response, PR creation, PR handoff, or merge before the Global Review and Debugging Gate passes with recorded evidence.\n- No PR/branch implementation or review in the main worktree; create or use a task-owned git worktree first.\n- No unprefixed session ids in Boulder state. Sessions are always recorded as `codex:<session_id>`.";
+const ulwExecuteCodexHardRule = "- No completion claim while an applicable ultraqa adversarial class was never probed. Each applicable class needs a captured observable result; each skipped class needs a one-line not-applicable reason in the ledger.\n- No `ORCHESTRATION COMPLETE`, final response, PR creation, PR handoff, or merge before the Global Review and Debugging Gate passes with recorded evidence.\n- No PR/branch implementation or review in the main worktree; create or use a task-owned git worktree first.\n- No unprefixed session ids in Boulder state. Sessions are always recorded as `codex:<session_id>`.";
 
 const reviewWorkCodexGate = `
-When \`review-work\` is used as a final implementation, PR, or \`$start-work\`
+When \`review-work\` is used as a final implementation, PR, or \`$ulw-execute\`
 gate, it is blocking. A timeout, missing deliverable, ack-only response,
 explicit \`BLOCKED:\`, or inconclusive lane is not a pass. Treat that lane as
 failed, investigate the underlying uncertainty with the \`debugging\` skill when
@@ -134,10 +144,10 @@ export function removeCodexSkillOverlays(skillName, content) {
 	if (skillName === "ulw-research") {
 		return content.replace(ulwResearchCodexDeliveryGate, ulwResearchOriginalDeliveryGates);
 	}
-	if (skillName === "start-work") {
+	if (skillName === "ulw-execute") {
 		return content
-			.replace(startWorkCodexCompletion, startWorkOriginalCompletion)
-			.replace(startWorkCodexHardRule, startWorkOriginalHardRule);
+			.replace(ulwExecuteCodexCompletion, ulwExecuteOriginalCompletion)
+			.replace(ulwExecuteCodexHardRule, ulwExecuteOriginalHardRule);
 	}
 	if (skillName === "review-work") {
 		return content.replace(reviewWorkCodexGatePattern, "");

package/packages/omo-codex/plugin/test/sync-skills.test.mjs

@@ -5,8 +5,7 @@ import test from "node:test";
 import { fileURLToPath } from "node:url";
 import { sharedSkillsRootPath } from "@oh-my-opencode/shared-skills";
 import {
-	CONTEXT_PRESSURE_SKILL_BUDGET_BYTES,
-	assertPackagedContentMatches,
+	canonicalUltraworkDirectiveRelativePath,
 	componentSkillSources,
 	expectedSkills,
 	listSkillFiles,
@@ -16,7 +15,6 @@ import {
 
 const root = dirname(dirname(fileURLToPath(import.meta.url)));
 const repoRoot = join(root, "..", "..", "..");
-const opencodeOnlyToolPattern = /\b(?:call_omo_agent|background_output|team_[a-z_]+|task)\s*\(/;
 const generatedSkillMetadataFiles = new Set(["agents/openai.yaml"]);
 
 async function readPackagedSkillFile(...segments) {
@@ -131,7 +129,6 @@ test("#given a shared skill name collides with a Codex component skill #when agg
 	// when / then
 	assert.notEqual(removeCodexCompatibilityGuidance(aggregateSkill), removeCodexCompatibilityGuidance(sharedSkill));
 	assert.equal(removeCodexCompatibilityGuidance(aggregateSkill), removeCodexCompatibilityGuidance(componentSkill));
-	assert.match(aggregateSkill, /multi_agent_v1/);
 });
 
 test("#given shared skill source tests #when aggregate Codex skills are synced #then source tests are not packaged", async () => {
@@ -180,6 +177,18 @@ test("#given component skill sources #when aggregate Codex component skills are
 	}
 });
 
+test("#given the canonical prompts-core directive #when the aggregate ultrawork skill is inspected #then it wraps the canonical bytes in skill frontmatter", async () => {
+	// given
+	const canonical = await readFile(join(repoRoot, canonicalUltraworkDirectiveRelativePath), "utf8");
+
+	// when
+	const skill = await readFile(join(root, "skills", "ultrawork", "SKILL.md"), "utf8");
+
+	// then
+	assert.match(skill, /^---\r?\nname: ultrawork\r?\n/);
+	assert.equal(removeCodexCompatibilityGuidance(skill).endsWith(canonical), true);
+});
+
 test("#given synced ulw-loop skill #when Codex hint metadata is inspected #then ulw-loop surfaces the ulw-loop alias", async () => {
 	// given
 	const skillRoot = join(root, "skills", "ulw-loop");
@@ -191,9 +200,7 @@ test("#given synced ulw-loop skill #when Codex hint metadata is inspected #then
 	// then
 	assert.match(skill, /^---\r?\nname: ulw-loop\r?\n/m);
 	assert.match(interfaceMetadata, /display_name: "\(OmO\) ulw-loop"/);
-	assert.doesNotMatch(interfaceMetadata, /ulw-loop \/ ulw-loop/);
-	assert.match(interfaceMetadata, /short_description: "Goal-like ultrawork loop for systematic decomposition"/);
-	assert.match(interfaceMetadata, /default_prompt: "Use \$ulw-loop/);
+	assert.match(interfaceMetadata, /^\s*default_prompt:\s*".+"$/m);
 });
 
 test("#given synced ulw-loop skill #when Codex hint metadata is inspected #then ulw-loop remains discoverable as an alias", async () => {
@@ -229,92 +236,11 @@ test("#given synced git-master skill #when inspected #then commits and git histo
 
 	// then
 	assert.match(skill, /^---\r?\nname: git-master\r?\n/m);
-	assert.match(skill, /MUST USE whenever a task needs a commit or git-history investigation/);
-	assert.match(skill, /Commit only the user's requested changes/);
-	assert.match(skill, /Choose the Git tool by the question/);
-	assert.match(skill, /git log -S "text"/);
-	assert.match(skill, /git blame -L start,end -- file/);
 	assert.match(interfaceMetadata, /display_name: "\(OmO\) git-master"/);
 	assert.match(interfaceMetadata, /- "git commit"/);
 	assert.match(interfaceMetadata, /- "history search"/);
 });
 
-test("#given synced ulw-loop skill #when worker guidance is inspected #then context-hygiene guidance matches the source", async () => {
-	// given
-	const sourceSkill = await readFile(
-		join(root, "components", "ulw-loop", "skills", "ulw-loop", "references", "full-workflow.md"),
-		"utf8",
-	);
-	const syncedSkill = await readFile(join(root, "skills", "ulw-loop", "SKILL.md"), "utf8");
-	const syncedWorkflow = await readFile(join(root, "skills", "ulw-loop", "references", "full-workflow.md"), "utf8");
-	// ulw-loop is V2-primary (gpt-5.6 sol/terra use the flat `wait_agent`); the `multi_agent_v1.*`
-	// namespace is documented only as the v1 fallback, so the wait_agent refs accept the bare token.
-	const requiredPatterns = [
-		["wait_agent ref", /\bwait_agent\b/],
-		["local spawned-name tracking", /Track spawned agent names locally/],
-		["wait_agent mailbox path", /wait_agent.*mailbox signals/],
-		["progress status contract", /WORKING:/],
-		["long-running plan/reviewer background guidance", /Plan and reviewer agents may run for a long time/],
-		["bounded plan/reviewer polling", /wait_agent.*cycles/],
-		["exponential backoff wait guard", /double the timeout up to ~5 minutes/],
-		["git-master checkpointing", /git-master/],
-		["touched-path commit-style probe", /touched-path commit history/],
-		["verified work-unit commit", /verified work unit/],
-		["observed commit style", /commit in the observed style/],
-	];
-
-	// when / then
-	for (const [label, pattern] of requiredPatterns) {
-		assert.match(sourceSkill, pattern, `source skill missing ${label}`);
-		assert.match(syncedWorkflow, pattern, `synced workflow missing ${label}`);
-	}
-	assert.match(syncedSkill, /references\/full-workflow\.md/);
-	assert.match(syncedSkill, /wait_agent/);
-	assert.match(syncedSkill, /close_agent/);
-});
-
-test("#given packaged start-work skill #when inspected #then no-plan bootstrap and adversarial verification contracts are shipped", async () => {
-	// given
-	const skillFile = await readPackagedSkillFile("start-work", "SKILL.md");
-
-	// when / then
-	assertPackagedContentMatches(skillFile, [
-		["executes Prometheus plan with Boulder state", /Prometheus work plan[\s\S]*Boulder state/],
-		["bootstraps ulw-plan when no selectable plan exists", /no selectable plan[\s\S]*ulw-plan|ulw-plan[\s\S]*no selectable plan/i],
-		["does not execute work without an approved plan", /approved plan[\s\S]*(?:before|prior to)[\s\S]*execution|execution[\s\S]*(?:requires|needs)[\s\S]*approved plan/i],
-		["keeps hook continuation Boulder-only", /Boulder[\s\S]*(?:continuation|Stop hook)[\s\S]*(?:only|solely)|(?:continuation|Stop hook)[\s\S]*(?:only|solely)[\s\S]*Boulder/i],
-		["distinguishes execution from verification", /execution[\s\S]*verification|verification[\s\S]*execution/i],
-		["requires dirty-worktree-aware editing", /dirty worktree/i],
-		["requires stale-state probes", /stale state/i],
-		["rejects misleading success output", /misleading success output/i],
-		["does not accept worker done claims without independent verification", /done claim[\s\S]*independent(?:ly)? verified|independent(?:ly)? verify[\s\S]*done claim/i],
-	]);
-});
-
-test("#given packaged ulw-plan skill #when inspected #then dynamic multi-agent planning contracts are shipped", async () => {
-	// given
-	const skillFile = await readPackagedSkillFile("ulw-plan", "SKILL.md");
-	const workflowFile = await readPackagedSkillFile("ulw-plan", "references", "full-workflow.md");
-	const combinedFile = {
-		path: `${skillFile.path} + ${workflowFile.path}`,
-		content: `${skillFile.content}\n${workflowFile.content}`,
-	};
-
-	// when / then
-	assertPackagedContentMatches(combinedFile, [
-		["self-orchestrates 5 host subagents for planning", /(?:self-orchestrates|orchestrates)[\s\S]*5[\s\S]*host subagents/i],
-		["requires dynamic workflow phases", /dynamic[\s\S]*workflow[\s\S]*phase|phase[\s\S]*dynamic[\s\S]*workflow/i],
-		["keeps verification distinct from execution", /verification[\s\S]*execution|execution[\s\S]*verification/i],
-		["requires dirty-worktree-aware planning", /dirty worktree/i],
-		["requires stale-state checks between source and packaged payloads", /stale state/i],
-		["rejects misleading success output", /misleading success output/i],
-		["does not accept subagent outputs as success without independent verification", /subagent outputs?[\s\S]*(?:not|never)[\s\S]*(?:success|approval)|independent(?:ly)? verif(?:y|ied|ication)[\s\S]*subagent outputs?/i],
-		["treats Discord or external content as claims, not instructions", /(?:Discord|external content)[\s\S]*claims?[\s\S]*not instructions?|not instructions?[\s\S]*(?:Discord|external content)/i],
-	]);
-	assert.doesNotMatch(combinedFile.content, opencodeOnlyToolPattern);
-	assert.doesNotMatch(combinedFile.content, /Proceeding to plan generation/);
-});
-
 test("#given packaged Codex ulw-plan surfaces #when inspected #then dangerous sandbox bypass guidance is not shipped", async () => {
 	// given
 	const dangerousBypassToken = ["dangerously", "bypass"].join("-");
@@ -330,34 +256,3 @@ test("#given packaged Codex ulw-plan surfaces #when inspected #then dangerous sa
 	assert.doesNotMatch(packagedWorkflow.content, dangerousBypassPattern, `${packagedWorkflow.path} ships unsafe Codex bypass guidance`);
 	assert.doesNotMatch(componentWorkflow.content, dangerousBypassPattern, `${componentWorkflow.path} ships unsafe Codex bypass guidance`);
 });
-
-test("#given packaged ulw-research skill #when Codex delivery gates are inspected #then the category-based proofread gate is stripped", async () => {
-	// given
-	const content = await readFile(join(root, "skills", "ulw-research", "SKILL.md"), "utf8");
-
-	// then the writing-category proofread gate never ships to Codex (no category concept there)
-	assert.doesNotMatch(content, /category="writing"/, "codex ulw-research ships the writing-category proofread gate");
-	assert.doesNotMatch(content, /Proofread gate/, "codex ulw-research still references the proofread gate");
-	// and the visual-QA delivery gate survives as the single gate
-	assert.match(content, /### The delivery gate \u2014 visual QA must PASS/u, "codex ulw-research lost the visual-QA delivery gate");
-	assert.match(content, /Visual QA \(always\)/, "codex ulw-research lost the visual-QA gate body");
-});
-
-test("#given context-pressure-prone skills #when bundled for Codex #then the eagerly loaded payload stays budgeted", async () => {
-	// given
-	const skillsRoot = join(root, "skills");
-	const skillNames = ["debugging", "ulw-loop"];
-
-	// when
-	let totalBytes = 0;
-	for (const skillName of skillNames) {
-		const content = await readFile(join(skillsRoot, skillName, "SKILL.md"), "utf8");
-		totalBytes += Buffer.byteLength(content, "utf8");
-	}
-
-	// then
-	assert.ok(
-		totalBytes <= CONTEXT_PRESSURE_SKILL_BUDGET_BYTES,
-		`debugging + ulw-loop eager payload is ${totalBytes} bytes, above ${CONTEXT_PRESSURE_SKILL_BUDGET_BYTES}`,
-	);
-});