oh-my-opencode 4.14.2 → 4.15.1

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

@@ -1,6 +1,6 @@
 {
 	"name": "@sisyphuslabs/codex-bootstrap",
-	"version": "4.14.2",
+	"version": "4.15.1",
 	"description": "Codex SessionStart bootstrap component that provisions LazyCodex runtime dependencies from a detached worker.",
 	"type": "module",
 	"private": true,

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

@@ -1,6 +1,6 @@
 {
 	"name": "@sisyphuslabs/codex-codegraph",
-	"version": "4.14.2",
+	"version": "4.15.1",
 	"description": "Codex plugin MCP wrapper for CodeGraph.",
 	"type": "module",
 	"private": true,

package/packages/omo-codex/plugin/components/comment-checker/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-comment-checker",
-	"version": "4.14.2",
+	"version": "4.15.1",
 	"description": "Codex plugin that runs comment-checker after edit-like PostToolUse hooks.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/git-bash/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sisyphuslabs/codex-git-bash-hook",
-	"version": "4.14.2",
+	"version": "4.15.1",
 	"description": "Codex hook component that reminds Windows sessions to prefer the OMO git_bash MCP.",
 	"type": "module",
 	"private": true,

package/packages/omo-codex/plugin/components/lazycodex-executor-verify/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-lazycodex-executor-verify",
-	"version": "4.14.2",
+	"version": "4.15.1",
 	"description": "Codex SubagentStop evidence verifier for LazyCodex executor completions.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

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

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-lsp",
-	"version": "4.14.2",
+	"version": "4.15.1",
 	"description": "Codex plugin that exposes Language Server Protocol tools and post-edit diagnostics.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

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

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-rules",
-	"version": "4.14.2",
+	"version": "4.15.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/start-work-continuation/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-start-work-continuation",
-	"version": "4.14.2",
+	"version": "4.15.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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sisyphuslabs/codex-teammode",
-	"version": "4.14.2",
+	"version": "4.15.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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-telemetry",
-	"version": "4.14.2",
+	"version": "4.15.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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-ultrawork",
-	"version": "4.14.2",
+	"version": "4.15.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/ulw-loop/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-ulw-loop",
-	"version": "4.14.2",
+	"version": "4.15.1",
 	"description": "Codex plugin: durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/ulw-loop/skills/ulw-loop/references/full-workflow.md

@@ -127,7 +127,7 @@ Gather context BEFORE planning with parallel `explorer` / `librarian` workers pl
 First survey available skills: read every loosely-relevant skill's description, deliberately choose which this work uses, and prefer applying genuinely-relevant skills over working raw.
 Then run tier triage per goal — rigor (LIGHT/HEAVY below) and shape (`delivery` default, or `research` when the deliverable is a cited answer, not an artifact) — and record both in an `annotate_ledger` steering entry. Default is LIGHT — a narrow change inside existing layers. Take HEAVY only on a fact you can point to: a new module / abstraction / domain model; auth, security, or session; an external integration; a DB schema or migration; concurrency, transaction boundaries, or cache invalidation; a cross-domain refactor; or the user signaled care or demanded review. When unsure, take HEAVY; upgrade the moment a HEAVY fact surfaces, never downgrade mid-run.
 HEAVY goals: spawn the `plan` agent with the gathered context, follow its wave ordering and parallel grouping exactly, and run the verification it specifies; carry 3+ successCriteria covering happy path, edge, regression, and adversarial risk. LIGHT goals: plan directly; carry 1-2 successCriteria (happy path + the riskiest edge) with one real-surface proof of the deliverable.
-Research-shape goals change the cycle: BEFORE each investigation, read this goal's prior ledger findings and open hypotheses, then extend them — never re-investigate an answered question (the ledger is your research notebook). Record findings via `annotate_ledger` with their source (`file:line`, command output, doc URL) as `--evidence`. Track hypotheses as `HYPOTHESIS[id]: <claim> | status: open`, flipped to `confirmed`/`refuted` only on an observed source. A research criterion passes on a cited answer — skip QA-channel, cleanup, and commit, but keep source-observability (never "looks correct"). Keep hypotheses inside the user's stated question; a scope-widening one is an `add_subgoal` proposal you surface, never silent creep. For a `research`-shape goal you MAY load `ulw-research` (legacy alias: `ultraresearch`) without hesitation — otherwise explicit-request-only, a research-shape goal IS that explicit demand. Research-only: never for a `delivery` goal. It composes with the librarian routing above — `ulw-research` for saturation (many parallel sources, recursive expansion), a single `librarian` for one lookup.
+Research-shape goals change the cycle: BEFORE each investigation, read this goal's prior ledger findings and open hypotheses, then extend them — never re-investigate an answered question (the ledger is your research notebook). Record findings via `annotate_ledger` with their source (`file:line`, command output, doc URL) as `--evidence`. Track hypotheses as `HYPOTHESIS[id]: <claim> | status: open`, flipped to `confirmed`/`refuted` only on an observed source. A research criterion passes on a cited answer — skip QA-channel, cleanup, and commit, but keep source-observability (never "looks correct"). Keep hypotheses inside the user's stated question; a scope-widening one is an `add_subgoal` proposal you surface, never silent creep. For a `research`-shape goal you MAY load `ulw-research` without hesitation — otherwise explicit-request-only, a research-shape goal IS that explicit demand. Research-only: never for a `delivery` goal. It composes with the librarian routing above — `ulw-research` for saturation (many parallel sources, recursive expansion), a single `librarian` for one lookup.
 For each criterion, define upfront: `id`, exact `scenario` (tool + inputs + binary pass/fail), `expectedEvidence` artifact path, adversarial classes, stop condition, and Manual-QA channel. Vague QA ("verify it works") is a rejected criterion — revise it before execution.
 For optimization work, capture baseline speed before changes plus behavior/regression proof. Every attempt records speed, behavior/regression, and the keep/revert/iterate decision.
 A criterion's adversarial classes are the ultraqa classes a fact about the change triggers: malformed input, prompt injection, cancel/resume, stale state, dirty worktree, hung or long commands, flaky tests, misleading success output, repeated interruptions. Record untriggered classes as not-applicable in one line.

package/packages/omo-codex/plugin/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "@sisyphuslabs/omo-codex-plugin",
-	"version": "4.14.2",
+	"version": "4.15.1",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@sisyphuslabs/omo-codex-plugin",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"workspaces": [
 				"components/codegraph",
 				"components/comment-checker",
@@ -93,7 +93,7 @@
 		},
 		"components/codegraph": {
 			"name": "@sisyphuslabs/codex-codegraph",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"bin": {
 				"omo-codegraph": "dist/cli.js"
 			},
@@ -112,7 +112,7 @@
 		},
 		"components/comment-checker": {
 			"name": "@code-yeongyu/codex-comment-checker",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"license": "MIT",
 			"bin": {
 				"omo-comment-checker": "dist/cli.js"
@@ -133,7 +133,7 @@
 		},
 		"components/git-bash": {
 			"name": "@sisyphuslabs/codex-git-bash-hook",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"bin": {
 				"omo-git-bash-hook": "dist/cli.js"
 			},
@@ -148,7 +148,7 @@
 		},
 		"components/lazycodex-executor-verify": {
 			"name": "@code-yeongyu/codex-lazycodex-executor-verify",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"license": "MIT",
 			"bin": {
 				"lazycodex-executor-verify": "dist/cli.js"
@@ -165,7 +165,7 @@
 		},
 		"components/lsp": {
 			"name": "@code-yeongyu/codex-lsp",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"license": "MIT",
 			"dependencies": {
 				"@code-yeongyu/lsp-daemon": "file:../../../../lsp-daemon"
@@ -185,7 +185,7 @@
 		},
 		"components/rules": {
 			"name": "@code-yeongyu/codex-rules",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"license": "MIT",
 			"dependencies": {
 				"picomatch": "^4.0.3"
@@ -207,7 +207,7 @@
 		},
 		"components/start-work-continuation": {
 			"name": "@code-yeongyu/codex-start-work-continuation",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"license": "MIT",
 			"bin": {
 				"omo-start-work-continuation": "dist/cli.js"
@@ -224,7 +224,7 @@
 		},
 		"components/teammode": {
 			"name": "@sisyphuslabs/codex-teammode",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"devDependencies": {
 				"@types/node": "^25.9.3",
 				"bun-types": "^1.3.1",
@@ -237,7 +237,7 @@
 		},
 		"components/telemetry": {
 			"name": "@code-yeongyu/codex-telemetry",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"license": "MIT",
 			"bin": {
 				"omo-telemetry": "dist/cli.js"
@@ -255,7 +255,7 @@
 		},
 		"components/ultrawork": {
 			"name": "@code-yeongyu/codex-ultrawork",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"license": "MIT",
 			"bin": {
 				"omo-ultrawork": "dist/cli.js"
@@ -273,7 +273,7 @@
 		},
 		"components/ulw-loop": {
 			"name": "@code-yeongyu/codex-ulw-loop",
-			"version": "4.14.2",
+			"version": "4.15.1",
 			"license": "MIT",
 			"bin": {
 				"omo-ulw-loop": "dist/cli.js",

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

@@ -1,6 +1,6 @@
 {
   "name": "@sisyphuslabs/omo-codex-plugin",
-  "version": "4.14.2",
+  "version": "4.15.1",
   "description": "Aggregate Codex plugin root for OMO components.",
   "type": "module",
   "packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/scripts/auto-update-plan.mjs

@@ -1,6 +1,7 @@
 import { spawn, spawnSync } from "node:child_process";
-import { readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { existsSync, lstatSync, readFileSync, readdirSync, readlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import { detectInstallFlow, resolveInstallSnapshotPath } from "./install-flow.mjs";
@@ -9,6 +10,23 @@ import { resolveSpawnInvocation } from "./spawn-command.mjs";
 const DEFAULT_UPDATE_COMMAND = "npx";
 const DEFAULT_UPDATE_ARGS = ["--yes", "lazycodex-ai@latest", "install", "--no-tui", "--codex-autonomous"];
 const DEFAULT_LATEST_VERSION_TIMEOUT_MS = 1_500;
+const SISYPHUS_MARKETPLACE_NAME = "sisyphuslabs";
+const OMO_PLUGIN_NAME = "omo";
+const COMMAND_SHIM_MARKER = ":: generated by oh-my-openagent Codex installer";
+const MANAGED_COMPONENT_BIN_NAMES = new Set([
+	"lazycodex-executor-verify",
+	"omo-codegraph",
+	"omo-comment-checker",
+	"omo-git-bash-hook",
+	"omo-lsp",
+	"omo-rules",
+	"omo-start-work-continuation",
+	"omo-telemetry",
+	"omo-ultrawork",
+	"omo-ulw-loop",
+	"ulw",
+	"ulw-loop",
+]);
 
 export function resolveLazyCodexUpdatePlan({ currentVersion, latestVersion, command = DEFAULT_UPDATE_COMMAND, args = DEFAULT_UPDATE_ARGS } = {}) {
 	const current = parseVersion(currentVersion);
@@ -38,6 +56,16 @@ export function detectAutoUpdateInstallFlow(env) {
 	return detectInstallFlow({ pluginRoot: resolveAutoUpdatePluginRoot(env), env });
 }
 
+export function detectMarketplaceLocalRepair(env = {}) {
+	const codexHome = resolveCodexHome(env);
+	const marketplaceRoot = join(codexHome, "plugins", "cache", SISYPHUS_MARKETPLACE_NAME);
+	const reasons = [
+		...missingCachedMarketplaceSources(marketplaceRoot),
+		...missingManagedBinTargets({ env, marketplaceRoot }),
+	];
+	return { needsRepair: reasons.length > 0, reasons };
+}
+
 export function resolveCurrentVersion(env) {
 	if (env.LAZYCODEX_CURRENT_VERSION?.trim()) return env.LAZYCODEX_CURRENT_VERSION.trim();
 	const pluginRoot = dirname(dirname(fileURLToPath(import.meta.url)));
@@ -120,6 +148,109 @@ function resolveAutoUpdatePluginRoot(env) {
 	return dirname(dirname(fileURLToPath(import.meta.url)));
 }
 
+function resolveCodexHome(env) {
+	return resolve(env.CODEX_HOME?.trim() || join(resolveHome(env), ".codex"));
+}
+
+function resolveHome(env) {
+	return env.HOME?.trim() || homedir();
+}
+
+function resolveInstallerBinDir(env, codexHome) {
+	if (env.CODEX_LOCAL_BIN_DIR?.trim()) return resolve(env.CODEX_LOCAL_BIN_DIR.trim());
+	const home = resolveHome(env);
+	const defaultCodexHome = resolve(home, ".codex");
+	const resolvedCodexHome = resolve(codexHome);
+	return resolvedCodexHome === defaultCodexHome ? resolve(home, ".local", "bin") : join(resolvedCodexHome, "bin");
+}
+
+function missingCachedMarketplaceSources(marketplaceRoot) {
+	const manifest = readJsonObject(join(marketplaceRoot, ".agents", "plugins", "marketplace.json"));
+	if (manifest === undefined || !Array.isArray(manifest.plugins)) return [];
+	const reasons = [];
+	for (const plugin of manifest.plugins) {
+		if (!isPlainRecord(plugin) || plugin.name !== OMO_PLUGIN_NAME) continue;
+		const localPath = localMarketplaceSourcePath(plugin.source);
+		if (localPath === undefined) continue;
+		const resolvedPath = resolve(marketplaceRoot, localPath);
+		if (!isPathInside(resolvedPath, marketplaceRoot)) {
+			reasons.push({ kind: "invalid-marketplace-payload" });
+			continue;
+		}
+		if (!existsSync(resolvedPath)) {
+			reasons.push({ kind: "missing-marketplace-payload" });
+		}
+	}
+	return reasons;
+}
+
+function missingManagedBinTargets({ env, marketplaceRoot }) {
+	const binDir = resolveInstallerBinDir(env, resolveCodexHome(env));
+	let names;
+	try {
+		names = readdirSync(binDir);
+	} catch (error) {
+		if (error instanceof Error && "code" in error && error.code === "ENOENT") return [];
+		throw error;
+	}
+	const reasons = [];
+	for (const name of names) {
+		const binName = managedBinNameForEntry(name);
+		if (binName === undefined) continue;
+		const linkPath = join(binDir, name);
+		let target;
+		try {
+			target = readManagedBinTarget(linkPath);
+		} catch (error) {
+			if (error instanceof Error && "code" in error && error.code === "ENOENT") continue;
+			throw error;
+		}
+		if (target === undefined) continue;
+		if (!isManagedCachedComponentTarget(target, marketplaceRoot) || existsSync(target)) continue;
+		reasons.push({ kind: "dangling-managed-bin", binName });
+	}
+	return reasons;
+}
+
+function managedBinNameForEntry(name) {
+	const candidate = name.endsWith(".cmd") ? name.slice(0, -4) : name;
+	return MANAGED_COMPONENT_BIN_NAMES.has(candidate) ? candidate : undefined;
+}
+
+function readManagedBinTarget(linkPath) {
+	const linkStat = lstatSync(linkPath);
+	if (linkStat.isSymbolicLink()) {
+		const linkTarget = readlinkSync(linkPath);
+		return isAbsolute(linkTarget) ? linkTarget : resolve(dirname(linkPath), linkTarget);
+	}
+	if (!linkStat.isFile()) return undefined;
+	const content = readFileSync(linkPath, "utf8");
+	if (!content.includes(COMMAND_SHIM_MARKER)) return undefined;
+	return extractCommandShimTarget(content);
+}
+
+function extractCommandShimTarget(content) {
+	const match = /"([^"\r\n]+components[\\/][^"\r\n]+[\\/]dist[\\/]cli\.js)" %\*/.exec(content);
+	return match?.[1];
+}
+
+function localMarketplaceSourcePath(source) {
+	if (!isPlainRecord(source)) return undefined;
+	return source.source === "local" && typeof source.path === "string" ? source.path : undefined;
+}
+
+function isManagedCachedComponentTarget(target, marketplaceRoot) {
+	if (!isPathInside(target, marketplaceRoot)) return false;
+	const parts = target.split(/[\\/]+/);
+	const suffix = parts.slice(-4);
+	return suffix[0] === "components" && suffix[2] === "dist" && suffix[3] === "cli.js";
+}
+
+function isPathInside(path, root) {
+	const relativePath = relative(resolve(root), resolve(path));
+	return relativePath === "" || (!relativePath.startsWith("..") && !isAbsolute(relativePath));
+}
+
 function readVersionManifest(path) {
 	try {
 		const parsed = JSON.parse(readFileSync(path, "utf8"));
@@ -131,3 +262,17 @@ function readVersionManifest(path) {
 		throw error;
 	}
 }
+
+function readJsonObject(path) {
+	try {
+		const parsed = JSON.parse(readFileSync(path, "utf8"));
+		return isPlainRecord(parsed) ? parsed : undefined;
+	} catch (error) {
+		if (error instanceof Error) return undefined;
+		throw error;
+	}
+}
+
+function isPlainRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}

package/packages/omo-codex/plugin/scripts/auto-update-release-notes.mjs

@@ -25,6 +25,35 @@ export function formatMarketplaceFlowNotice({ updateContext, releaseNotes }) {
 	].join(" ");
 }
 
+export function formatMarketplaceRepairStartedNotice({ pendingNotice, releaseNotes, repairReasons = [] }) {
+	const reasons = formatRepairReasons(repairReasons);
+	return [
+		`[LazyCodex] Auto-update repair started in the background: v${pendingNotice.fromVersion} -> v${pendingNotice.toVersion}.`,
+		`Detected stale local LazyCodex cache/bin state: ${reasons}.`,
+		"LazyCodex started its bundled reinstall repair. Tell the user, in the user's preferred tone, that LazyCodex found a broken local cache or command link and started a repair; recommend starting a new Codex session after it completes.",
+		formatReleaseNotesForNotice({ version: pendingNotice.toVersion, releaseNotes }),
+	].join(" ");
+}
+
+function formatRepairReasons(repairReasons) {
+	if (repairReasons.length === 0) return "stale local cache state was detected";
+	return [...new Set(repairReasons.map(formatRepairReason))].join("; ");
+}
+
+function formatRepairReason(reason) {
+	if (!isPlainRecord(reason)) return "stale local cache state";
+	if (reason.kind === "missing-marketplace-payload") return "missing marketplace payload";
+	if (reason.kind === "invalid-marketplace-payload") return "invalid marketplace payload";
+	if (reason.kind === "dangling-managed-bin" && typeof reason.binName === "string") {
+		return `dangling managed command link: ${sanitizeBinName(reason.binName)}`;
+	}
+	return "stale local cache state";
+}
+
+function sanitizeBinName(binName) {
+	return /^[a-z0-9][a-z0-9._-]{0,80}$/i.test(binName) ? binName : "managed command";
+}
+
 export async function resolveReleaseNotes({ env, latestVersion }) {
 	const override = env.LAZYCODEX_RELEASE_NOTES?.trim();
 	if (override) return truncateReleaseNotes(override);
@@ -133,3 +162,7 @@ function parsePositiveInteger(value, fallback) {
 	const parsed = Number.parseInt(value, 10);
 	return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
 }
+
+function isPlainRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}

package/packages/omo-codex/plugin/scripts/auto-update.mjs

@@ -14,6 +14,7 @@ import {
 import {
 	compareVersions,
 	defaultRunCommandForManualUpdate,
+	detectMarketplaceLocalRepair,
 	detectAutoUpdateInstallFlow,
 	parsePositiveInteger,
 	parseVersion,
@@ -23,7 +24,12 @@ import {
 	resolveLatestVersion,
 	resolveLazyCodexUpdatePlan,
 } from "./auto-update-plan.mjs";
-import { formatMarketplaceFlowNotice, formatUpdateStartedNotice, resolveReleaseNotes } from "./auto-update-release-notes.mjs";
+import {
+	formatMarketplaceFlowNotice,
+	formatMarketplaceRepairStartedNotice,
+	formatUpdateStartedNotice,
+	resolveReleaseNotes,
+} from "./auto-update-release-notes.mjs";
 import { migrateCodexConfig } from "./migrate-codex-config.mjs";
 import { migrateOmoSotConfig } from "./migrate-omo-sot.mjs";
 import { resolveSpawnInvocation } from "./spawn-command.mjs";
@@ -38,9 +44,11 @@ export function resolveAutoUpdatePlan({ env = process.env, now = Date.now(), las
 		return { shouldRun: false, reason: "disabled" };
 	}
 
+	const flow = installFlow ?? detectAutoUpdateInstallFlow(env).flow;
+	const marketplaceRepair = flow === "marketplace" ? detectMarketplaceLocalRepair(env) : undefined;
 	const intervalMs = parsePositiveInteger(env.LAZYCODEX_AUTO_UPDATE_INTERVAL_MS, DEFAULT_INTERVAL_MS);
 	const successStatus = lastStatus === undefined || lastStatus === "success";
-	if (successStatus && typeof lastCheckedAt === "number" && intervalMs > 0 && now - lastCheckedAt < intervalMs) {
+	if (marketplaceRepair?.needsRepair !== true && successStatus && typeof lastCheckedAt === "number" && intervalMs > 0 && now - lastCheckedAt < intervalMs) {
 		return { shouldRun: false, reason: "throttled" };
 	}
 	const retryIntervalMs = parsePositiveInteger(env.LAZYCODEX_AUTO_UPDATE_RETRY_INTERVAL_MS, DEFAULT_RETRY_INTERVAL_MS);
@@ -48,8 +56,26 @@ export function resolveAutoUpdatePlan({ env = process.env, now = Date.now(), las
 		return { shouldRun: false, reason: "retry-throttled" };
 	}
 
-	const flow = installFlow ?? detectAutoUpdateInstallFlow(env).flow;
-	if (flow === "marketplace") return { shouldRun: false, reason: "marketplace-flow" };
+	if (flow === "marketplace") {
+		const repair = marketplaceRepair ?? detectMarketplaceLocalRepair(env);
+		if (!repair.needsRepair) return { shouldRun: false, reason: "marketplace-flow" };
+		const currentVersion = resolveCurrentVersion(env) ?? "unknown";
+		const latestVersion = resolveLatestVersion(env) ?? currentVersion ?? "latest";
+		return {
+			shouldRun: true,
+			kind: "marketplace-local-repair",
+			repairReasons: repair.reasons,
+			command: resolveCommand(env),
+			args: resolveArgs(env),
+			currentVersion,
+			latestVersion,
+			env: {
+				...env,
+				LAZYCODEX_AUTO_UPDATE_DISABLED: "1",
+				OMO_CODEX_AUTO_UPDATE_DISABLED: "1",
+			},
+		};
+	}
 
 	const currentVersion = resolveCurrentVersion(env);
 	const latestVersion = resolveLatestVersion(env);
@@ -142,7 +168,13 @@ export async function runAutoUpdateCheck({ env = process.env, now = Date.now() }
 		return { started: false, reason: "locked", notices };
 	}
 	try {
-		await appendUpdateLog(env, now, "started", { command: plan.command, args: plan.args });
+		await appendUpdateLog(env, now, "started", plan.kind === "marketplace-local-repair"
+			? { kind: plan.kind, repairReasons: plan.repairReasons ?? [] }
+			: {
+				command: plan.command,
+				args: plan.args,
+				...(plan.kind === undefined ? {} : { kind: plan.kind }),
+			});
 		const pendingNotice = { fromVersion: plan.currentVersion, toVersion: plan.latestVersion, startedAt: now };
 		const releaseNotes = await resolveReleaseNotes({ env, latestVersion: plan.latestVersion });
 		if (env.LAZYCODEX_AUTO_UPDATE_WAIT === "1") {
@@ -155,7 +187,7 @@ export async function runAutoUpdateCheck({ env = process.env, now = Date.now() }
 			await appendUpdateLog(env, now, "finished", { status });
 			if (status === 0) {
 				await writeState(statePath, { lastCheckedAt: now, lastAttemptedAt: now, lastStatus: "success", pendingNotice });
-				await recordUpdateStartedNotice({ env, now, notices, pendingNotice, releaseNotes });
+				await recordUpdateStartedNotice({ env, now, notices, pendingNotice, releaseNotes, plan });
 			} else {
 				await writeState(statePath, { lastAttemptedAt: now, lastStatus: "failed" });
 			}
@@ -169,7 +201,7 @@ export async function runAutoUpdateCheck({ env = process.env, now = Date.now() }
 			detached: true,
 		});
 		await writeState(statePath, { lastAttemptedAt: now, lastStatus: "started", pendingNotice });
-		await recordUpdateStartedNotice({ env, now, notices, pendingNotice, releaseNotes });
+		await recordUpdateStartedNotice({ env, now, notices, pendingNotice, releaseNotes, plan });
 		child.unref();
 		return { started: true, notices };
 	} finally {
@@ -197,10 +229,16 @@ async function settlePendingNotice({ env, now, statePath, state, notices }) {
 	return nextState;
 }
 
-async function recordUpdateStartedNotice({ env, now, notices, pendingNotice, releaseNotes }) {
-	notices.push(formatUpdateStartedNotice({ pendingNotice, releaseNotes }));
+async function recordUpdateStartedNotice({ env, now, notices, pendingNotice, releaseNotes, plan }) {
+	notices.push(plan.kind === "marketplace-local-repair"
+		? formatMarketplaceRepairStartedNotice({
+			pendingNotice,
+			releaseNotes,
+			repairReasons: plan.repairReasons ?? [],
+		})
+		: formatUpdateStartedNotice({ pendingNotice, releaseNotes }));
 	await appendUpdateLog(env, now, "notified", {
-		kind: "update-started",
+		kind: plan.kind === "marketplace-local-repair" ? "marketplace-local-repair-started" : "update-started",
 		fromVersion: pendingNotice.fromVersion,
 		toVersion: pendingNotice.toVersion,
 	});

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

@@ -19,6 +19,7 @@ const skillSources = [
 	["ulw-plan", "components/ultrawork/skills/ulw-plan"],
 ];
 const componentSkillNames = new Set(skillSources.map(([name]) => name));
+const codexHiddenSharedSkillNames = new Set(["ultraresearch"]);
 const skillDisplayPrefix = "(OmO) ";
 
 function shouldCopySkillSource(source) {
@@ -164,6 +165,22 @@ prefixes when identity is needed.
 `;
 
 function applyCodexSkillOverlays(skillName, content) {
+	if (skillName === "ulw-research") {
+		return content
+			.replace(
+				", the legacy alias 'ultraresearch', any 'ulw' research wording,",
+				", any 'ulw' research wording,",
+			)
+			.replace(
+				'the legacy alias "ultraresearch" (also `/ultraresearch`, `$ultraresearch`), ',
+				"",
+			)
+			.replace(
+				"answer those normally, and mention that `ulw-research` is available (legacy alias: `ultraresearch`) when a question would clearly benefit from it.",
+				"answer those normally, and mention that `ulw-research` is available when a question would clearly benefit from it.",
+			)
+			.replace("# Ultraresearch Synthesis: <query>", "# ULW-Research Synthesis: <query>");
+	}
 	if (skillName === "start-work") {
 		return content
 			.replace(startWorkOriginalCompletion, startWorkCodexCompletion)
@@ -236,6 +253,7 @@ async function syncSkills() {
 
 	for (const skillName of sharedSkillNames) {
 		if (componentSkillNames.has(skillName)) continue;
+		if (codexHiddenSharedSkillNames.has(skillName)) continue;
 		await cp(join(sharedSkillsRoot, skillName), join(skillsRoot, skillName), {
 			filter: shouldCopySkillSource,
 			recursive: true,

package/packages/omo-codex/plugin/skills/frontend/ATTRIBUTION.md

@@ -150,10 +150,11 @@ path-mapped from the designpowers project. It is not committed here; the build
 materializes the selected files from the pinned submodule under
 `packages/shared-skills/upstreams/designpowers`. The materialized set includes the
 upstream `LICENSE`, ten `agents/*.md` role-reference files, and selected
-`skills/*/SKILL.md` files. Bridge/state/router integration skills are intentionally
+`skills/*/SKILL.md` files renamed to `vendor/skills/*/reference.md` so they remain
+reference documents instead of nested skill entrypoints. Bridge/state/router integration skills are intentionally
 excluded; see `frontend/references/designpowers/UPSTREAM.md` for the allowlist and
 exclusion list. Only the allowed frontmatter description quoting normalization described
-above may alter these materialized `SKILL.md` files.
+above may alter these materialized `reference.md` files.
 
 - Source: https://github.com/Owl-Listener/designpowers
 - Pinned upstream commit: cb00757da9d554591fa78d27aa1854d60a05c4f7
@@ -199,3 +200,10 @@ capture evidence and a local reconnaissance run following the MIT-licensed
 `JCodesMore/ai-website-cloner-template` workflow; it is not copied from Aside or from the
 template. Aside names, trademarks, product text, and visual assets remain the property of
 their respective owners and are referenced only for descriptive design-analysis purposes.
+
+`frontend/references/design/clone-from-url.md` is a project-original runtime-extraction
+workflow guide. Its browser + `getComputedStyle` clone approach follows the same
+MIT-licensed `JCodesMore/ai-website-cloner-template` clone-website workflow that `aside.md`
+cites; no source from that template is copied. It carries no third-party attribution beyond
+that lineage note, and it grants no license to copy any target site's trademarks, brand
+assets, or proprietary copy.