{"record":{"id":"9f3662fcd28316b2","repo":"Yeachan-Heo/oh-my-codex","slug":"explore-deprecation-message-n-n-explore-help","errorCode":null,"errorMessage":"${EXPLORE_DEPRECATION_MESSAGE}\\n\\n${EXPLORE_HELP}","messagePattern":"\\$\\{EXPLORE_DEPRECATION_MESSAGE\\}\\\\n\\\\n\\$\\{EXPLORE_HELP\\}","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"src/cli/explore.ts","lineNumber":95,"sourceCode":"    const binaryPath = join(packageRoot, 'bin', binaryName);\n    if (!existsSync(binaryPath)) return undefined;\n    return { command: binaryPath, args: [] };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction shouldShowHelp(args: readonly string[]): boolean {\n  return args.length > 0 && args.every((arg) => arg === '--help' || arg === '-h' || arg === 'help');\n}\n\nexport async function exploreCommand(args: string[]): Promise<void> {\n  if (shouldShowHelp(args)) {\n    console.log(EXPLORE_HELP);\n    return;\n  }\n\n  throw new Error(`${EXPLORE_DEPRECATION_MESSAGE}\\n\\n${EXPLORE_HELP}`);\n}\n","sourceCodeStart":77,"sourceCodeEnd":97,"githubUrl":"https://github.com/Yeachan-Heo/oh-my-codex/blob/3ad79a8a6fe6e95fdbb8c00e40716fffe4011ce2/src/cli/explore.ts#L77-L97","documentation":"The `explore` CLI command has been deprecated/removed; any non-help invocation throws an error containing the deprecation message and help text. This mirrors the autoresearch removal pattern.","triggerScenarios":"Running `omx explore <args>` with anything other than help flags; calling `exploreCommand(args)` programmatically (it is also invoked by `captureExploreCommand`).","commonSituations":"Post-upgrade breakage where scripts or integrations still call explore; automation built on an older CLI version.","solutions":["Run `omx explore --help` to read the replacement guidance","Migrate to the replacement command named in EXPLORE_DEPRECATION_MESSAGE","Update wrappers/capture scripts that call exploreCommand","Pin the older CLI version as a temporary workaround"],"exampleFix":"# before\nomx explore ./src\n\n# after\nomx explore --help  # follow the suggested replacement command","handlingStrategy":"validation","validationCode":"const HELP_ONLY = new Set(['--help', '-h']);\nif (!args.every(a => HELP_ONLY.has(a))) {\n  throw new Error('explore command is deprecated; use its replacement');\n}","typeGuard":null,"tryCatchPattern":"try {\n  await exploreCommand(args);\n} catch (e) {\n  console.error((e as Error).message); // includes replacement guidance\n  process.exitCode = 1;\n}","preventionTips":["Audit capture pipelines calling captureExploreCommand before upgrades","Track deprecation notices in release notes"],"tags":["cli","deprecation","explore"],"backgroundTag":"deprecated-command-invoked","analyzedSha":"3ad79a8a6fe6e95fdbb8c00e40716fffe4011ce2","analyzedAt":"2026-08-27T22:18:39.783Z","schemaVersion":2},"datasetVersion":"2026-08-28T00:17:15.603Z"}