oh-my-opencode 4.19.1 → 4.19.3

package/packages/omo-codex/plugin/hooks/user-prompt-submit-loading-project-rules.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/rules/dist/cli.js\" hook user-prompt-submit",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.19.1) Loading Project Rules",
+						"statusMessage": "(OmO 4.19.3) Loading Project Rules",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\rules\\dist\\cli.js\" hook user-prompt-submit"
 					}
 				]

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

@@ -1,12 +1,12 @@
 {
 	"name": "@sisyphuslabs/omo-codex-plugin",
-	"version": "4.19.1",
+	"version": "4.19.3",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@sisyphuslabs/omo-codex-plugin",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"workspaces": [
 				"components/codegraph",
 				"components/comment-checker",
@@ -94,13 +94,14 @@
 			"version": "0.1.0",
 			"dev": true,
 			"dependencies": {
+				"@oh-my-opencode/omo-config-core": "workspace:*",
 				"js-yaml": "^4.1.1",
 				"jsonc-parser": "^3.3.1"
 			}
 		},
 		"components/codegraph": {
 			"name": "@sisyphuslabs/codex-codegraph",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"bin": {
 				"omo-codegraph": "dist/cli.js"
 			},
@@ -114,12 +115,12 @@
 				"node": ">=20.0.0"
 			},
 			"optionalDependencies": {
-				"@colbymchenry/codegraph": "1.4.1"
+				"@colbymchenry/codegraph": "1.5.0"
 			}
 		},
 		"components/comment-checker": {
 			"name": "@code-yeongyu/codex-comment-checker",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"license": "MIT",
 			"bin": {
 				"omo-comment-checker": "dist/cli.js"
@@ -140,7 +141,7 @@
 		},
 		"components/git-bash": {
 			"name": "@sisyphuslabs/codex-git-bash-hook",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"bin": {
 				"omo-git-bash-hook": "dist/cli.js"
 			},
@@ -155,7 +156,7 @@
 		},
 		"components/lazycodex-executor-verify": {
 			"name": "@code-yeongyu/codex-lazycodex-executor-verify",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"license": "MIT",
 			"bin": {
 				"lazycodex-executor-verify": "dist/cli.js"
@@ -172,7 +173,7 @@
 		},
 		"components/lsp": {
 			"name": "@code-yeongyu/codex-lsp",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"license": "MIT",
 			"dependencies": {
 				"@code-yeongyu/lsp-daemon": "file:../../../../lsp-daemon",
@@ -193,7 +194,7 @@
 		},
 		"components/rules": {
 			"name": "@code-yeongyu/codex-rules",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"license": "MIT",
 			"dependencies": {
 				"picomatch": "^4.0.3"
@@ -215,7 +216,7 @@
 		},
 		"components/start-work-continuation": {
 			"name": "@code-yeongyu/codex-start-work-continuation",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"license": "MIT",
 			"bin": {
 				"omo-start-work-continuation": "dist/cli.js"
@@ -232,7 +233,7 @@
 		},
 		"components/teammode": {
 			"name": "@sisyphuslabs/codex-teammode",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"devDependencies": {
 				"@types/node": "^25.9.3",
 				"bun-types": "^1.3.1",
@@ -245,7 +246,7 @@
 		},
 		"components/telemetry": {
 			"name": "@code-yeongyu/codex-telemetry",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"license": "MIT",
 			"bin": {
 				"omo-telemetry": "dist/cli.js"
@@ -263,7 +264,7 @@
 		},
 		"components/ultrawork": {
 			"name": "@code-yeongyu/codex-ultrawork",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"license": "MIT",
 			"bin": {
 				"omo-ultrawork": "dist/cli.js"
@@ -281,7 +282,7 @@
 		},
 		"components/ulw-loop": {
 			"name": "@code-yeongyu/codex-ulw-loop",
-			"version": "4.19.1",
+			"version": "4.19.3",
 			"license": "MIT",
 			"bin": {
 				"omo-ulw-loop": "dist/cli.js",
@@ -512,27 +513,27 @@
 			"link": true
 		},
 		"node_modules/@colbymchenry/codegraph": {
-			"version": "1.4.1",
-			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph/-/codegraph-1.4.1.tgz",
-			"integrity": "sha512-xZayboJt6T3QBzBsBsI0eJ3J/tN4vYs6LMuvrxJVdM71yQFjrFKFeV3KsbicAgkj6AHnTXxUNk26g9BYwkNMgg==",
+			"version": "1.5.0",
+			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph/-/codegraph-1.5.0.tgz",
+			"integrity": "sha512-/l1JMVOQ9WGQLrc/IIuAg7Igr944t79/oNCJTcnGkYtIeQx2XFIqI0ho+9Les/Yu4zKfmPU17hIUshD6yP1fKw==",
 			"license": "MIT",
 			"optional": true,
 			"bin": {
 				"codegraph": "npm-shim.js"
 			},
 			"optionalDependencies": {
-				"@colbymchenry/codegraph-darwin-arm64": "1.4.1",
-				"@colbymchenry/codegraph-darwin-x64": "1.4.1",
-				"@colbymchenry/codegraph-linux-arm64": "1.4.1",
-				"@colbymchenry/codegraph-linux-x64": "1.4.1",
-				"@colbymchenry/codegraph-win32-arm64": "1.4.1",
-				"@colbymchenry/codegraph-win32-x64": "1.4.1"
+				"@colbymchenry/codegraph-darwin-arm64": "1.5.0",
+				"@colbymchenry/codegraph-darwin-x64": "1.5.0",
+				"@colbymchenry/codegraph-linux-arm64": "1.5.0",
+				"@colbymchenry/codegraph-linux-x64": "1.5.0",
+				"@colbymchenry/codegraph-win32-arm64": "1.5.0",
+				"@colbymchenry/codegraph-win32-x64": "1.5.0"
 			}
 		},
 		"node_modules/@colbymchenry/codegraph-darwin-arm64": {
-			"version": "1.4.1",
-			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-darwin-arm64/-/codegraph-darwin-arm64-1.4.1.tgz",
-			"integrity": "sha512-USSpExjuxZWN0OeNexZp2V5fCfOI4ZekqE79CJiBdGdPbqGTB+857ImIqzWGyF/rAyyED94Wc0Cd82t+uWD30w==",
+			"version": "1.5.0",
+			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-darwin-arm64/-/codegraph-darwin-arm64-1.5.0.tgz",
+			"integrity": "sha512-ptQV1WlEKCDDy0Wl2r/urVGwaczUn5ezjt/Rv22Gj7RnKHAc9pNdU1uvL3gQzvoWJ9q7kmCeo7q6866/ZohbjQ==",
 			"cpu": [
 				"arm64"
 			],
@@ -543,9 +544,9 @@
 			]
 		},
 		"node_modules/@colbymchenry/codegraph-darwin-x64": {
-			"version": "1.4.1",
-			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-darwin-x64/-/codegraph-darwin-x64-1.4.1.tgz",
-			"integrity": "sha512-syLC7QPsNui2hPrK58El0XQrjjdSYhsoKS5i26ieD8DVrb0adzFQrBRP8qId/wfGp078xdC54rdKvqgmbIL1WQ==",
+			"version": "1.5.0",
+			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-darwin-x64/-/codegraph-darwin-x64-1.5.0.tgz",
+			"integrity": "sha512-7BUOOxMacLNXmXTQTrjDTZXhbo0o5R5Z19uKjICIau2KxO9oU+Zbk7Bnf4P/JT1T4M41xRuiCJVE1uqBi6cFWA==",
 			"cpu": [
 				"x64"
 			],
@@ -556,9 +557,9 @@
 			]
 		},
 		"node_modules/@colbymchenry/codegraph-linux-arm64": {
-			"version": "1.4.1",
-			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-linux-arm64/-/codegraph-linux-arm64-1.4.1.tgz",
-			"integrity": "sha512-XC6GJ9/fTicW9CE3k2fOcUOcbtDU8mS53t+PUfzq3Py9+JiX3PtJgtBB8bmf6e45NZUF5foaLUwFXfxTTl961g==",
+			"version": "1.5.0",
+			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-linux-arm64/-/codegraph-linux-arm64-1.5.0.tgz",
+			"integrity": "sha512-Bq5Ggb7PoLF7mnOiGl/UxMrDgrPCAQUMsl7BpMkAxq8FulvVEp7E/GrIQih2YB32vWr18KpN2i2VoRLAHLIDUw==",
 			"cpu": [
 				"arm64"
 			],
@@ -569,9 +570,9 @@
 			]
 		},
 		"node_modules/@colbymchenry/codegraph-linux-x64": {
-			"version": "1.4.1",
-			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-linux-x64/-/codegraph-linux-x64-1.4.1.tgz",
-			"integrity": "sha512-bjfa+0IyjbxpZz7ghznN4qMPoYVSiZafeZu/rXGdg3VI+kEPOPZrk2vmtWIU9tBPGVJbeU2Kwa/0Z2DkUGOJ9A==",
+			"version": "1.5.0",
+			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-linux-x64/-/codegraph-linux-x64-1.5.0.tgz",
+			"integrity": "sha512-wT1O7NkQoV6zPiq36d1qBqoIHL2ZRnOkFMjQ7JJwWS7KHnP32qHCd/pPaSwl8cNRlGYkYSaX3WVDpz2BaV+Now==",
 			"cpu": [
 				"x64"
 			],
@@ -582,9 +583,9 @@
 			]
 		},
 		"node_modules/@colbymchenry/codegraph-win32-arm64": {
-			"version": "1.4.1",
-			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-win32-arm64/-/codegraph-win32-arm64-1.4.1.tgz",
-			"integrity": "sha512-mb5bFDhwcP49U0P2IBRhH1O5ZmnlgE8lIXTlg2dqpfLeL+XfxzyeJ+i4I0KU0h1hlNWP/u3d2k+1EGem2swDBw==",
+			"version": "1.5.0",
+			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-win32-arm64/-/codegraph-win32-arm64-1.5.0.tgz",
+			"integrity": "sha512-cWMJp8BeVLKR1mUVklI3opy9mJL/yrVkvjBqJFXRejM8CCU+UTpPDxDzQuPyywY0qyD0Ru2tjuWT4do7OUcNvg==",
 			"cpu": [
 				"arm64"
 			],
@@ -595,9 +596,9 @@
 			]
 		},
 		"node_modules/@colbymchenry/codegraph-win32-x64": {
-			"version": "1.4.1",
-			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-win32-x64/-/codegraph-win32-x64-1.4.1.tgz",
-			"integrity": "sha512-ipN6WvTKa0cSXIL6DTdACq57WnNYTjVq2wtC5uPT8F22o6Ucbcu3/w3OzKkkfwP4mkXv2cDMbuvExbnYNULyuw==",
+			"version": "1.5.0",
+			"resolved": "https://registry.npmjs.org/@colbymchenry/codegraph-win32-x64/-/codegraph-win32-x64-1.5.0.tgz",
+			"integrity": "sha512-45gycJ+t153vpLEVkXChEySG1Ok5zqCgiBeonLe5V7Jxt1w+MF2vG00qexTC0pBWTmHSeMW4Q8d47nVMiC8ciQ==",
 			"cpu": [
 				"x64"
 			],

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

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

package/packages/omo-codex/plugin/shared/src/config-loader.ts

@@ -2,45 +2,194 @@ import { homedir } from "node:os"
 
 import {
 	loadOmoConfig,
+	mergeOmoConfigRecords,
+	OmoConfigSchema,
 	type LoadOmoConfigOptions,
-} from "../../../../utils/src/omo-config/loader.ts"
-import type { OmoConfig } from "../../../../utils/src/omo-config.ts"
-import type { OmoConfigSource } from "../../../../utils/src/omo-config/resolve.ts"
+	type MigrationEnvironment,
+	type MigrationFileSystem,
+	type OmoConfig,
+	type OmoConfigEnv,
+	type OmoConfigSource,
+} from "../../../../omo-config-core/src/index.ts"
 
-export type CodexOmoConfigOptions = Omit<LoadOmoConfigOptions, "harness">
+import {
+	runCodexConfigMigration,
+	type CodexConfigMigrationOptions,
+	type CodexConfigMigrationResult,
+} from "./config-migration.ts"
+
+export type CodexOmoConfigOptions = Omit<LoadOmoConfigOptions, "fileSystem" | "harness"> & {
+	readonly fileSystem?: MigrationFileSystem
+	readonly homeDir?: string
+}
+
+export type CodexStartupMigrationOptions = CodexConfigMigrationOptions
+export type CodexStartupMigrationResult = CodexConfigMigrationResult
+
+type CodexCodegraphConfig = {
+	readonly auto_provision?: boolean
+	readonly daemon?: boolean
+	readonly enabled?: boolean
+	readonly excluded_roots?: readonly string[]
+	readonly install_dir?: string
+	readonly session_start_cooldown_ms?: number
+	readonly telemetry?: boolean
+	readonly watch_debounce_ms?: number
+}
 
-export type CodexOmoConfig = OmoConfig & {
+type CodexResolvedConfig = Omit<OmoConfig, "codegraph"> & {
+	readonly codegraph?: CodexCodegraphConfig
+}
+
+export type CodexOmoConfig = CodexResolvedConfig & {
 	readonly sources: readonly OmoConfigSource[]
 	readonly trustedCodegraphInstallDir?: string
 	readonly warnings: readonly string[]
 }
 
+const ENV_BOOLEAN_SETTINGS = [
+	["auto_provision", "AUTO_PROVISION"],
+	["enabled", "ENABLED"],
+	["telemetry", "TELEMETRY"],
+] as const
+
+function resolveHomeDir(options: CodexOmoConfigOptions): string {
+	const env = options.env ?? process.env
+	return options.homeDir ?? env.HOME ?? env.USERPROFILE ?? homedir()
+}
+
+function environmentWithHome(env: OmoConfigEnv, homeDir: string): OmoConfigEnv {
+	return { ...env, HOME: homeDir }
+}
+
+function migrationEnvironment(homeDir: string, env: OmoConfigEnv): MigrationEnvironment {
+	return {
+		HOME: homeDir,
+		...(env.USERPROFILE === undefined ? {} : { USERPROFILE: env.USERPROFILE }),
+	}
+}
+
+/** Runs only the legacy config.jsonc transaction before Codex reads omo.jsonc. */
+export function runCodexStartupMigration(options: CodexStartupMigrationOptions): CodexStartupMigrationResult {
+	return runCodexConfigMigration(options)
+}
+
+function parseBoolean(value: string): boolean | undefined {
+	const normalized = value.trim().toLowerCase()
+	if (["1", "true", "yes", "on"].includes(normalized)) return true
+	if (["0", "false", "no", "off"].includes(normalized)) return false
+	return undefined
+}
+
+function envOverrides(env: OmoConfigEnv, warnings: string[]): Record<string, unknown> {
+	const codegraph: Record<string, unknown> = {}
+	for (const prefix of ["OMO", "CODEX"]) {
+		for (const [setting, suffix] of ENV_BOOLEAN_SETTINGS) {
+			const name = `${prefix}_CODEGRAPH_${suffix}`
+			const rawValue = env[name]
+			if (rawValue === undefined) continue
+			const value = parseBoolean(rawValue)
+			if (value === undefined) warnings.push(`${name} has invalid boolean value "${rawValue}"`)
+			else codegraph[setting] = value
+		}
+
+		const installDir = env[`${prefix}_CODEGRAPH_INSTALL_DIR`]
+		if (installDir !== undefined) codegraph["install_dir"] = installDir
+		const cooldown = env[`${prefix}_CODEGRAPH_SESSION_START_COOLDOWN_MS`]
+		if (cooldown !== undefined) {
+			const value = Number(cooldown)
+			if (!Number.isFinite(value) || value < 60_000) {
+				warnings.push(`${prefix}_CODEGRAPH_SESSION_START_COOLDOWN_MS has invalid number value "${cooldown}"`)
+			} else codegraph["session_start_cooldown_ms"] = value
+		}
+		const debounce = env[`${prefix}_CODEGRAPH_WATCH_DEBOUNCE_MS`]
+		if (debounce !== undefined) {
+			const value = Number(debounce)
+			if (!Number.isFinite(value) || value < 0) warnings.push(`${prefix}_CODEGRAPH_WATCH_DEBOUNCE_MS has invalid number value "${debounce}"`)
+			else codegraph["watch_debounce_ms"] = value
+		}
+	}
+	return Object.keys(codegraph).length === 0 ? {} : { codegraph }
+}
+
+function migrationWarnings(result: CodexStartupMigrationResult): readonly string[] {
+	const warnings: string[] = []
+	if (result.error !== undefined) warnings.push(`omo-codex: configuration migration: ${result.error}`)
+	if (result.journalResumed) warnings.push("omo-codex: recovered an interrupted configuration migration")
+	if (result.migratedFrom.length > 0) {
+		warnings.push(`omo-codex: migrated legacy configuration from ${result.migratedFrom.join(", ")}`)
+	}
+	for (const migration of result.results) {
+		for (const diagnostic of migration.diagnostics) {
+			warnings.push(`omo-codex: configuration migration: ${diagnostic}`)
+		}
+	}
+	return warnings
+}
+
+function applicabilityWarnings(config: OmoConfig): readonly string[] {
+	return config.codegraph?.watch_debounce_ms === undefined
+		? []
+		: ["codegraph.watch_debounce_ms is not supported for harness codex"]
+}
+
+function codexCodegraphConfig(value: OmoConfig["codegraph"]): CodexCodegraphConfig | undefined {
+	if (value === undefined) return undefined
+	return {
+		auto_provision: value.auto_provision,
+		daemon: value.daemon,
+		enabled: value.enabled,
+		telemetry: value.telemetry,
+		...(value.excluded_roots === undefined ? {} : { excluded_roots: value.excluded_roots }),
+		...(value.install_dir === undefined ? {} : { install_dir: value.install_dir }),
+		...(value.session_start_cooldown_ms === undefined ? {} : { session_start_cooldown_ms: value.session_start_cooldown_ms }),
+		...(value.watch_debounce_ms === undefined ? {} : { watch_debounce_ms: value.watch_debounce_ms }),
+	}
+}
+
 export function getCodexOmoConfig(options: CodexOmoConfigOptions = {}): CodexOmoConfig {
 	const env = options.env ?? process.env
 	const homeDir = resolveHomeDir(options)
+	const environment = environmentWithHome(env, homeDir)
+	const migration = runCodexStartupMigration({
+		cwd: options.cwd ?? process.cwd(),
+		environment,
+		env: migrationEnvironment(homeDir, environment),
+		...(options.fileSystem === undefined ? {} : { fileSystem: options.fileSystem }),
+		...(options.platform === undefined ? {} : { platform: options.platform }),
+	})
 	const result = loadOmoConfig({
 		...(options.cwd === undefined ? {} : { cwd: options.cwd }),
-		env,
-		homeDir,
+		env: environment,
+		...(options.fileSystem === undefined ? {} : { fileSystem: options.fileSystem }),
 		harness: "codex",
+		...(options.platform === undefined ? {} : { platform: options.platform }),
+		...(options.profile === undefined ? {} : { profile: options.profile }),
 	})
 	const trustedConfig = loadOmoConfig({
 		cwd: homeDir,
-		env,
-		homeDir,
+		env: environment,
+		...(options.fileSystem === undefined ? {} : { fileSystem: options.fileSystem }),
 		harness: "codex",
+		...(options.platform === undefined ? {} : { platform: options.platform }),
+		...(options.profile === undefined ? {} : { profile: options.profile }),
 	})
+	const envWarnings: string[] = []
+	const config = OmoConfigSchema.parse(mergeOmoConfigRecords(result.config, envOverrides(env, envWarnings)))
 	const trustedCodegraphInstallDir = trustedConfig.config.codegraph?.install_dir
+	const { codegraph, ...resolvedConfig } = config
+	const codexCodegraph = codexCodegraphConfig(codegraph)
 
 	return {
-		...result.config,
+		...resolvedConfig,
+		...(codexCodegraph === undefined ? {} : { codegraph: codexCodegraph }),
 		sources: result.sources,
 		...(trustedCodegraphInstallDir === undefined ? {} : { trustedCodegraphInstallDir }),
-		warnings: result.warnings,
+		warnings: [
+			...migrationWarnings(migration),
+			...result.diagnostics.map((diagnostic) => diagnostic.message),
+			...envWarnings,
+			...applicabilityWarnings(config),
+		],
 	}
 }
-
-function resolveHomeDir(options: CodexOmoConfigOptions): string {
-	const env = options.env ?? process.env
-	return options.homeDir ?? env["HOME"] ?? env["USERPROFILE"] ?? homedir()
-}

package/packages/omo-codex/plugin/shared/src/config-migration.ts

@@ -0,0 +1,162 @@
+import { existsSync } from "node:fs"
+import { posix, win32 } from "node:path"
+
+import {
+	runMigrations,
+	type LoadedMigrationSource,
+	type MigrationBoundary,
+	type MigrationClock,
+	type MigrationEnvironment,
+	type MigrationFileSystem,
+	type MigrationPlan,
+	type MigrationRunResult,
+	type MigrationTransformResult,
+} from "../../../../omo-config-core/src/index.ts"
+
+const MIGRATION_ID = "2026-07-codex-config-jsonc"
+const OMO_SCHEMA_URL = "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/omo.schema.json"
+
+type DiscoveryFileSystem = {
+	readonly existsSync: (path: string) => boolean
+}
+
+type PathOperations = {
+	readonly join: (...paths: string[]) => string
+}
+
+export type CodexConfigMigrationOptions = {
+	readonly backupTimestamp?: string
+	readonly clock?: MigrationClock
+	readonly cwd: string
+	readonly discoveryFileSystem?: DiscoveryFileSystem
+	readonly env?: MigrationEnvironment
+	readonly environment?: Readonly<Record<string, string | undefined>>
+	readonly fileSystem?: MigrationFileSystem
+	readonly homeDir?: string
+	readonly isProcessAlive?: (pid: number) => boolean
+	readonly onBoundary?: (boundary: MigrationBoundary) => void
+	readonly pathOperations?: PathOperations
+	readonly pid?: number
+	readonly platform?: NodeJS.Platform
+}
+
+export type CodexConfigMigrationResult = {
+	readonly error?: string
+	readonly journalResumed: boolean
+	readonly migratedFrom: readonly string[]
+	readonly results: readonly MigrationRunResult[]
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+	return typeof value === "object" && value !== null && !Array.isArray(value)
+}
+
+function recordAt(value: Readonly<Record<string, unknown>>, key: string): Record<string, unknown> | undefined {
+	const candidate = value[key]
+	return isRecord(candidate) ? candidate : undefined
+}
+
+function migrationHistory(sources: readonly LoadedMigrationSource[], configPath: string): Record<string, readonly string[]> {
+	const history: string[] = []
+	for (const source of sources) {
+		if (!isRecord(source.value)) continue
+		for (const key of ["_migrations", "appliedMigrations"]) {
+			const values = source.value[key]
+			if (!Array.isArray(values)) continue
+			for (const value of values) {
+				if (typeof value === "string" && !history.includes(value)) history.push(value)
+			}
+		}
+	}
+	return history.length === 0 ? {} : { [configPath]: history }
+}
+
+function transformConfigJsonc(configPath: string, sources: readonly LoadedMigrationSource[]): MigrationTransformResult {
+	const config = sources.find((source) => source.path === configPath)
+	const legacy = config === undefined || !isRecord(config.value) ? {} : config.value
+	const omo = recordAt(legacy, "[omo]")
+	const senpi = recordAt(legacy, "[senpi]")
+	const history = migrationHistory(sources, configPath)
+	return {
+		diagnostics: omo !== undefined && senpi !== undefined
+			? ["conflict: [senpi] legacy [omo] kept [senpi]"]
+			: [],
+		document: {
+			$schema: OMO_SCHEMA_URL,
+			...(recordAt(legacy, "codegraph") === undefined ? {} : { codegraph: recordAt(legacy, "codegraph") }),
+			...(recordAt(legacy, "[opencode]") === undefined ? {} : { "[opencode]": recordAt(legacy, "[opencode]") }),
+			...(recordAt(legacy, "[codex]") === undefined ? {} : { "[codex]": recordAt(legacy, "[codex]") }),
+			...(senpi === undefined && omo === undefined ? {} : { "[senpi]": senpi ?? omo }),
+			...(Object.keys(history).length === 0 ? {} : { legacy_migrations: history }),
+		},
+	}
+}
+
+function timestamp(value: string | undefined): string {
+	return value ?? new Date().toISOString().replace(/[:.]/g, "-")
+}
+
+function sourceExists(options: CodexConfigMigrationOptions, path: string): boolean {
+	return (options.discoveryFileSystem ?? options.fileSystem ?? { existsSync }).existsSync(path)
+}
+
+function migrationPlan(homeDir: string, options: CodexConfigMigrationOptions): MigrationPlan | undefined {
+	const platform = options.platform ?? process.platform
+	const paths = options.pathOperations ?? (platform === "win32" ? win32 : posix)
+	const configPath = paths.join(homeDir, ".omo", "config.jsonc")
+	const sidecarPath = `${configPath}.migrations.json`
+	const sourcePaths = [configPath, sidecarPath].filter((path) => sourceExists(options, path))
+	if (sourcePaths.length === 0) return undefined
+	const backupRoot = paths.join(homeDir, ".omo", `migration-backup-${timestamp(options.backupTimestamp)}-opencode-config`, ".omo")
+	return {
+		id: MIGRATION_ID,
+		sources: sourcePaths.map((path) => ({
+			backupPath: paths.join(backupRoot, path === configPath ? "config.jsonc" : "config.jsonc.migrations.json"),
+			path,
+		})),
+		targetPath: paths.join(homeDir, ".omo", "omo.jsonc"),
+		transform: (sources) => transformConfigJsonc(configPath, sources),
+	}
+}
+
+function migratedSources(results: readonly MigrationRunResult[]): readonly string[] {
+	return [...new Set(results.flatMap((result) => result.status === "migrated"
+		? result.preview?.backupMoves.map((move) => move.from) ?? []
+		: []))].sort()
+}
+
+export function runCodexConfigMigration(options: CodexConfigMigrationOptions): CodexConfigMigrationResult {
+	const environment = options.environment ?? process.env
+	const homeDir = options.homeDir ?? environment["HOME"] ?? environment["USERPROFILE"]
+	if (homeDir === undefined || homeDir.length === 0) {
+		return { error: "Cannot migrate configuration because no home directory is available", journalResumed: false, migratedFrom: [], results: [] }
+	}
+
+	try {
+		const batch = runMigrations({
+			...(options.clock === undefined ? {} : { clock: options.clock }),
+			discover: () => {
+				const plan = migrationPlan(homeDir, options)
+				return plan === undefined ? [] : [plan]
+			},
+			...(options.env === undefined ? { env: { HOME: homeDir } } : { env: options.env }),
+			...(options.fileSystem === undefined ? {} : { fileSystem: options.fileSystem }),
+			...(options.isProcessAlive === undefined ? {} : { isProcessAlive: options.isProcessAlive }),
+			...(options.onBoundary === undefined ? {} : { onBoundary: options.onBoundary }),
+			...(options.pid === undefined ? {} : { pid: options.pid }),
+		})
+		return {
+			...(batch.status === "locked" ? { error: "Configuration migration is already running" } : {}),
+			journalResumed: batch.journalResumed,
+			migratedFrom: migratedSources(batch.results),
+			results: batch.results,
+		}
+	} catch (error) {
+		return {
+			error: error instanceof Error ? error.message : String(error),
+			journalResumed: false,
+			migratedFrom: [],
+			results: [],
+		}
+	}
+}