oh-my-opencode 5.0.0-beta.19 → 5.0.0-beta.20

package/dist/cli-node/index.js

@@ -55,7 +55,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "oh-my-opencode",
-    version: "5.0.0-beta.19",
+    version: "5.0.0-beta.20",
     description: "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
     main: "./dist/index.js",
     types: "dist/index.d.ts",
@@ -140,7 +140,7 @@ var init_package = __esm(() => {
       "packages/omo-codex/plugin/components/lazycodex-executor-verify/dist/cli.js",
       "packages/omo-codex/plugin/components/lsp/dist/cli.js",
       "packages/omo-codex/plugin/components/rules/dist/cli.js",
-      "packages/omo-codex/plugin/components/start-work-continuation/dist/cli.js",
+      "packages/omo-codex/plugin/components/ulw-execute-continuation/dist/cli.js",
       "packages/omo-codex/plugin/components/teammode/dist/cli.js",
       "packages/omo-codex/plugin/components/telemetry/dist/cli.js",
       "packages/omo-codex/plugin/components/ultrawork/dist/cli.js",
@@ -236,7 +236,7 @@ var init_package = __esm(() => {
       zod: "^4.4.3"
     },
     devDependencies: {
-      "@code-yeongyu/senpi": "2026.8.24",
+      "@code-yeongyu/senpi": "2026.8.25",
       "@oh-my-opencode/agents-md-core": "workspace:*",
       "@oh-my-opencode/ast-grep-mcp": "workspace:*",
       "@oh-my-opencode/boulder-state": "workspace:*",
@@ -277,18 +277,18 @@ var init_package = __esm(() => {
       typescript: "^7.0.2"
     },
     optionalDependencies: {
-      "oh-my-opencode-darwin-arm64": "5.0.0-beta.19",
-      "oh-my-opencode-darwin-x64": "5.0.0-beta.19",
-      "oh-my-opencode-darwin-x64-baseline": "5.0.0-beta.19",
-      "oh-my-opencode-linux-arm64": "5.0.0-beta.19",
-      "oh-my-opencode-linux-arm64-musl": "5.0.0-beta.19",
-      "oh-my-opencode-linux-x64": "5.0.0-beta.19",
-      "oh-my-opencode-linux-x64-baseline": "5.0.0-beta.19",
-      "oh-my-opencode-linux-x64-musl": "5.0.0-beta.19",
-      "oh-my-opencode-linux-x64-musl-baseline": "5.0.0-beta.19",
-      "oh-my-opencode-windows-arm64": "5.0.0-beta.19",
-      "oh-my-opencode-windows-x64": "5.0.0-beta.19",
-      "oh-my-opencode-windows-x64-baseline": "5.0.0-beta.19"
+      "oh-my-opencode-darwin-arm64": "5.0.0-beta.20",
+      "oh-my-opencode-darwin-x64": "5.0.0-beta.20",
+      "oh-my-opencode-darwin-x64-baseline": "5.0.0-beta.20",
+      "oh-my-opencode-linux-arm64": "5.0.0-beta.20",
+      "oh-my-opencode-linux-arm64-musl": "5.0.0-beta.20",
+      "oh-my-opencode-linux-x64": "5.0.0-beta.20",
+      "oh-my-opencode-linux-x64-baseline": "5.0.0-beta.20",
+      "oh-my-opencode-linux-x64-musl": "5.0.0-beta.20",
+      "oh-my-opencode-linux-x64-musl-baseline": "5.0.0-beta.20",
+      "oh-my-opencode-windows-arm64": "5.0.0-beta.20",
+      "oh-my-opencode-windows-x64": "5.0.0-beta.20",
+      "oh-my-opencode-windows-x64-baseline": "5.0.0-beta.20"
     },
     overrides: {
       "@earendil-works/pi-agent-core": "0.84.2",
@@ -22769,124 +22769,6 @@ var init_internal_initiator_marker = __esm(() => {
   INTERNAL_NOREPLY_MARKER_DETECT_PATTERN = /<!--\s*OMO_INTERNAL_NOREPLY\s*-->/;
 });
 
-// packages/utils/src/migration/agent-names.ts
-function migrateAgentNames(agents) {
-  const migrated = {};
-  let changed = false;
-  for (const [key, value] of Object.entries(agents)) {
-    const newKey = AGENT_NAME_MAP[key.toLowerCase()] ?? AGENT_NAME_MAP[key] ?? key;
-    if (newKey !== key) {
-      changed = true;
-    }
-    migrated[newKey] = value;
-  }
-  return { migrated, changed };
-}
-var AGENT_NAME_MAP, BUILTIN_AGENT_NAMES;
-var init_agent_names = __esm(() => {
-  AGENT_NAME_MAP = {
-    omo: "sisyphus",
-    OmO: "sisyphus",
-    Sisyphus: "sisyphus",
-    "Sisyphus (Ultraworker)": "sisyphus",
-    sisyphus: "sisyphus",
-    "Hephaestus (Deep Agent)": "hephaestus",
-    "OmO-Plan": "prometheus",
-    "omo-plan": "prometheus",
-    "Planner-Sisyphus": "prometheus",
-    "planner-sisyphus": "prometheus",
-    "Prometheus - Plan Builder": "prometheus",
-    "Prometheus (Plan Builder)": "prometheus",
-    prometheus: "prometheus",
-    "orchestrator-sisyphus": "atlas",
-    Atlas: "atlas",
-    "Atlas (Plan Executor)": "atlas",
-    atlas: "atlas",
-    "plan-consultant": "metis",
-    "Metis - Plan Consultant": "metis",
-    "Metis (Plan Consultant)": "metis",
-    metis: "metis",
-    "Momus - Plan Critic": "momus",
-    "Momus (Plan Critic)": "momus",
-    momus: "momus",
-    "Sisyphus-Junior": "sisyphus-junior",
-    "sisyphus-junior": "sisyphus-junior",
-    build: "build",
-    oracle: "oracle",
-    librarian: "librarian",
-    explore: "explore",
-    "multimodal-looker": "multimodal-looker"
-  };
-  BUILTIN_AGENT_NAMES = new Set([
-    "sisyphus",
-    "oracle",
-    "librarian",
-    "explore",
-    "multimodal-looker",
-    "metis",
-    "momus",
-    "prometheus",
-    "atlas",
-    "build"
-  ]);
-});
-
-// packages/utils/src/migration/hook-names.ts
-var HOOK_NAME_MAP;
-var init_hook_names = __esm(() => {
-  HOOK_NAME_MAP = {
-    "anthropic-auto-compact": "anthropic-context-window-limit-recovery",
-    "sisyphus-orchestrator": "atlas",
-    "sisyphus-gpt-hephaestus-reminder": "no-sisyphus-gpt",
-    "empty-message-sanitizer": null,
-    "delegate-task-english-directive": null,
-    "gpt-permission-continuation": null,
-    "thinking-block-validator": null,
-    "session-recovery": null
-  };
-});
-
-// packages/utils/src/migration/model-versions.ts
-function migrationKey(oldModel, newModel) {
-  return `model-version:${oldModel}->${newModel}`;
-}
-function migrateModelVersions(configs, appliedMigrations) {
-  const migrated = {};
-  let changed = false;
-  const newMigrations = [];
-  for (const [key, value] of Object.entries(configs)) {
-    if (value && typeof value === "object" && !Array.isArray(value)) {
-      const config3 = value;
-      if (typeof config3.model === "string" && !CURRENT_USER_SELECTABLE_MODELS.has(config3.model) && MODEL_VERSION_MAP[config3.model]) {
-        const oldModel = config3.model;
-        const newModel = MODEL_VERSION_MAP[oldModel];
-        const mKey = migrationKey(oldModel, newModel);
-        if (appliedMigrations?.has(mKey)) {
-          migrated[key] = value;
-          continue;
-        }
-        migrated[key] = { ...config3, model: newModel };
-        changed = true;
-        newMigrations.push(mKey);
-        continue;
-      }
-    }
-    migrated[key] = value;
-  }
-  return { migrated, changed, newMigrations };
-}
-var MODEL_VERSION_MAP, CURRENT_USER_SELECTABLE_MODELS;
-var init_model_versions = __esm(() => {
-  MODEL_VERSION_MAP = {
-    "anthropic/claude-opus-4-4": "anthropic/claude-opus-4-8"
-  };
-  CURRENT_USER_SELECTABLE_MODELS = new Set([
-    "anthropic/claude-opus-4-5",
-    "anthropic/claude-opus-4-6",
-    "anthropic/claude-sonnet-4-5"
-  ]);
-});
-
 // packages/utils/src/migration/agent-category.ts
 function configureMigrationCategoryDefaults(defaults) {
   categoryDefaults = defaults ?? {};
@@ -85050,6 +84932,18 @@ var init_fallback_chain_resolution = __esm(() => {
   init_provider_model_id_transform2();
 });
 
+// packages/omo-opencode/src/cli/fallback-lane-policy.ts
+function isExcludedFallbackLaneModel(model) {
+  const slashIndex = model.indexOf("/");
+  if (slashIndex <= 0)
+    return false;
+  return EXCLUDED_FALLBACK_PROVIDERS.has(model.slice(0, slashIndex).toLowerCase());
+}
+var EXCLUDED_FALLBACK_PROVIDERS;
+var init_fallback_lane_policy = __esm(() => {
+  EXCLUDED_FALLBACK_PROVIDERS = new Set(["openrouter", "opencode", "vercel"]);
+});
+
 // packages/omo-opencode/src/cli/model-fallback.ts
 function resolveCompatibleFallbackSettings(providerID, modelID, desired) {
   const compatibility = resolveCompatibleModelSettings({
@@ -85109,7 +85003,7 @@ function attachFallbackModels(config3, fallbackChain, availability) {
   if (primaryIndex === -1) {
     return config3;
   }
-  const fallbackModels = uniqueFallbacks.slice(primaryIndex + 1);
+  const fallbackModels = uniqueFallbacks.slice(primaryIndex + 1).filter((entry) => !isExcludedFallbackLaneModel(entry.model));
   if (fallbackModels.length === 0) {
     return config3;
   }
@@ -85120,7 +85014,7 @@ function attachFallbackModels(config3, fallbackChain, availability) {
 }
 function attachAllFallbackModels(config3, fallbackChain, availability) {
   const uniqueFallbacks = collectAvailableFallbacks(fallbackChain, availability);
-  const fallbackModels = uniqueFallbacks.filter((entry) => entry.model !== config3.model);
+  const fallbackModels = uniqueFallbacks.filter((entry) => entry.model !== config3.model).filter((entry) => !isExcludedFallbackLaneModel(entry.model));
   if (fallbackModels.length === 0) {
     return config3;
   }
@@ -85234,6 +85128,7 @@ var init_model_fallback = __esm(() => {
   init_provider_availability();
   init_fallback_chain_resolution();
   init_provider_model_id_transform2();
+  init_fallback_lane_policy();
 });
 
 // packages/omo-opencode/src/cli/config-manager/generate-omo-config.ts
@@ -85646,58 +85541,18 @@ var init_deep_diff = __esm(() => {
 });
 
 // packages/omo-opencode/src/config-migration/transform-opencode.ts
-function replaceDisabledAgents(value) {
-  if (!Array.isArray(value))
-    return value;
-  return value.map((entry) => {
-    if (typeof entry !== "string")
-      return entry;
-    return AGENT_NAME_MAP[entry.toLowerCase()] ?? AGENT_NAME_MAP[entry] ?? entry;
-  });
-}
-function replaceDisabledHooks(value) {
-  if (!Array.isArray(value))
-    return value;
-  return value.flatMap((entry) => {
-    if (typeof entry !== "string")
-      return [entry];
-    const replacement = HOOK_NAME_MAP[entry];
-    return replacement === null ? [] : [replacement ?? entry];
-  });
-}
-function transformLegacyKeys(value, history) {
+function transformLegacyKeys(value) {
   const config3 = withoutLegacyMetadata(value);
-  const appliedMigrations = new Set(history);
-  const agents = config3.agents;
-  if (isPlainRecord3(agents)) {
-    const namedAgents = migrateAgentNames(agents).migrated;
-    config3.agents = migrateModelVersions(namedAgents, appliedMigrations).migrated;
-  }
-  const categories = config3.categories;
-  if (isPlainRecord3(categories)) {
-    config3.categories = migrateModelVersions(categories, appliedMigrations).migrated;
-  }
+  delete config3.agents;
+  delete config3.categories;
   if (config3.omo_agent !== undefined) {
     config3.sisyphus_agent = config3.omo_agent;
     delete config3.omo_agent;
   }
-  delete config3.lsp;
-  if (isPlainRecord3(config3.experimental) && Object.hasOwn(config3.experimental, "hashline_edit")) {
-    if (config3.hashline_edit === undefined)
-      config3.hashline_edit = config3.experimental.hashline_edit;
-    delete config3.experimental.hashline_edit;
-    if (Object.keys(config3.experimental).length === 0)
-      delete config3.experimental;
-  }
-  if (config3.disabled_agents !== undefined)
-    config3.disabled_agents = replaceDisabledAgents(config3.disabled_agents);
-  if (config3.disabled_hooks !== undefined)
-    config3.disabled_hooks = replaceDisabledHooks(config3.disabled_hooks);
-  return config3;
+  return Object.fromEntries(Object.entries(config3).filter(([key]) => MIGRATED_OPENCODE_FIELDS.has(key)));
 }
 function loadedConfigs(discovered, sources) {
   const metadataByPath = new Map(discovered.map((source) => [source.path, source]));
-  const historyByConfigPath = legacyMigrationHistory(discovered, sources);
   const configs = [];
   for (const source of sources) {
     const metadata = metadataByPath.get(source.path);
@@ -85705,7 +85560,7 @@ function loadedConfigs(discovered, sources) {
       continue;
     configs.push({
       metadata,
-      value: transformLegacyKeys(source.value, historyByConfigPath[metadata.configPath] ?? [])
+      value: transformLegacyKeys(source.value)
     });
   }
   return configs;
@@ -85757,13 +85612,17 @@ function transformProjectSources(input, projectRoot) {
 function transformOpenCodeSources(input) {
   return input.scope.kind === "user" ? transformUserSources(input.discovered, input.sources) : transformProjectSources(input, input.scope.projectRoot);
 }
+var MIGRATED_OPENCODE_FIELDS;
 var init_transform_opencode = __esm(() => {
-  init_agent_names();
-  init_hook_names();
-  init_model_versions();
   init_deep_diff();
   init_legacy_history();
   init_record_values();
+  MIGRATED_OPENCODE_FIELDS = new Set([
+    "disabled_providers",
+    "model_fallback",
+    "models",
+    "sisyphus_agent"
+  ]);
 });
 
 // packages/omo-opencode/src/config-migration/reasoning-unification.ts
@@ -94515,7 +94374,7 @@ var package_default2;
 var init_package2 = __esm(() => {
   package_default2 = {
     name: "@oh-my-opencode/omo-codex",
-    version: "5.0.0-beta.19",
+    version: "5.0.0-beta.20",
     type: "module",
     private: true,
     description: "Codex harness adapter for oh-my-openagent. Vendored Codex plugin namespace (omo) + TypeScript installer + telemetry.",
@@ -98443,9 +98302,9 @@ var LEGACY_CODEX_COMPONENT_BINS = [
   { name: "codex-comment-checker", component: "comment-checker" },
   { name: "codex-lsp", component: "lsp" },
   { name: "codex-rules", component: "rules" },
-  { name: "codex-start-work-continuation", component: "start-work-continuation" },
   { name: "codex-telemetry", component: "telemetry" },
-  { name: "codex-ultrawork", component: "ultrawork" }
+  { name: "codex-ultrawork", component: "ultrawork" },
+  { name: "codex-ulw-execute-continuation", component: "ulw-execute-continuation" }
 ];
 var LEGACY_CODEX_COMPONENT_BIN_NAMES = LEGACY_CODEX_COMPONENT_BINS.map((entry) => entry.name);
 function isLegacyCodexBinTarget(binName, target) {
@@ -103003,9 +102862,9 @@ var MANAGED_CODEX_BIN_NAMES = new Set([
   "omo-git-bash-hook",
   "omo-lsp",
   "omo-rules",
-  "omo-start-work-continuation",
   "omo-telemetry",
   "omo-ultrawork",
+  "omo-ulw-execute-continuation",
   "omo-ulw-loop",
   "lazycodex-executor-verify",
   "ulw",
@@ -103488,6 +103347,7 @@ function localLauncherCmdPath(homeDir = homedir10()) {
 function renderLocalLauncher(options) {
   const brand = {
     name: "OmO",
+    command: "omo",
     displayVersion: options.version ?? "local",
     configDir: ".omo",
     flatLayout: false,
@@ -103689,9 +103549,9 @@ var REQUIRED_PLUGIN_ARTIFACTS = [
   join62("skills", "refactor", "SKILL.md"),
   join62("skills", "remove-ai-slops", "SKILL.md"),
   join62("skills", "review-work", "SKILL.md"),
-  join62("skills", "start-work", "SKILL.md"),
   join62("skills", "ultimate-browsing", "SKILL.md"),
   join62("skills", "ultrawork", "SKILL.md"),
+  join62("skills", "ulw-execute", "SKILL.md"),
   join62("skills", "ulw-loop", "SKILL.md"),
   join62("skills", "ulw-plan", "SKILL.md"),
   join62("skills", "ulw-research", "SKILL.md"),
@@ -107271,7 +107131,7 @@ init_zod();
 var BuiltinCommandNameSchema = exports_external.enum([
   "goal",
   "refactor",
-  "start-work",
+  "ulw-execute",
   "stop-continuation",
   "remove-ai-slops",
   "hyperplan"
@@ -107397,7 +107257,7 @@ var HookNameSchema = exports_external.enum([
   "no-sisyphus-gpt",
   "no-hephaestus-non-gpt",
   "hephaestus-agents-md-injector",
-  "start-work",
+  "ulw-execute",
   "atlas",
   "unstable-agent-babysitter",
   "task-resume-info",
@@ -107608,9 +107468,9 @@ var TuiConfigSchema = exports_external.object({
   sidebar: TuiSidebarConfigSchema.default({ enabled: true })
 });
 
-// packages/omo-opencode/src/config/schema/start-work.ts
+// packages/omo-opencode/src/config/schema/ulw-execute.ts
 init_zod();
-var StartWorkConfigSchema = exports_external.object({
+var UlwExecuteConfigSchema = exports_external.object({
   auto_commit: exports_external.boolean().default(true)
 });
 
@@ -107670,7 +107530,8 @@ var OhMyOpenCodeConfigSchema = exports_external.object({
   tmux: TmuxConfigSchema.optional(),
   tui: TuiConfigSchema.default({ sidebar: { enabled: true } }).optional(),
   sisyphus: SisyphusConfigSchema.optional(),
-  start_work: StartWorkConfigSchema.optional(),
+  ulw_execute: UlwExecuteConfigSchema.optional(),
+  start_work: UlwExecuteConfigSchema.optional(),
   default_mode: DefaultModeConfigSchema.optional(),
   _migrations: exports_external.array(exports_external.string()).optional()
 });
@@ -107761,6 +107622,21 @@ function materializeAgentModelChains(config4) {
   }));
   return changed ? { ...config4, agents } : config4;
 }
+var START_WORK_DEPRECATION_MESSAGE = 'config key "start_work" is deprecated, rename to "ulw_execute" - will be removed next release';
+var deprecationWarningSink = log2;
+function warnLegacyUlwExecuteKey(views) {
+  for (const view of views) {
+    if (!Object.hasOwn(view.config, "start_work"))
+      continue;
+    deprecationWarningSink(`[config] ${shortPath(view.path)}: ${START_WORK_DEPRECATION_MESSAGE}`);
+  }
+}
+function migrateLegacyUlwExecuteKey(config4) {
+  const legacy = config4.start_work;
+  if (legacy === undefined || config4.ulw_execute !== undefined)
+    return config4;
+  return { ...config4, ulw_execute: legacy };
+}
 function migrateRalphLoopConfig(config4) {
   const legacy = config4.ralph_loop;
   if (legacy === undefined)
@@ -107789,11 +107665,12 @@ function validatePluginConfig(directory, environment2 = process.env) {
   const firstView = views[0];
   const userConfig = parseConfig(chain.protectedUserView);
   const config4 = applyDisabledProviders(materializeAgentModelChains(protectUserFields(mergeViews(views), userConfig)));
+  warnLegacyUlwExecuteKey(chain.views);
   return {
     valid: messages.length === 0,
     messages,
     path: chainMessages.length > 0 ? chain.diagnostics[0]?.path ?? null : firstFailingView?.path ?? firstView?.path ?? null,
-    config: migrateRalphLoopConfig(config4)
+    config: migrateRalphLoopConfig(migrateLegacyUlwExecuteKey(config4))
   };
 }
 
@@ -111890,7 +111767,7 @@ var CODEX_BIN_NAMES = [
   "omo-lsp",
   "omo-comment-checker",
   "omo-ultrawork",
-  "omo-start-work-continuation",
+  "omo-ulw-execute-continuation",
   "omo-telemetry",
   "omo-git-bash-hook"
 ];

package/dist/config/schema/commands.d.ts

@@ -4,7 +4,7 @@ export declare const BuiltinCommandNameSchema: z.ZodEnum<{
     hyperplan: "hyperplan";
     refactor: "refactor";
     "remove-ai-slops": "remove-ai-slops";
-    "start-work": "start-work";
     "stop-continuation": "stop-continuation";
+    "ulw-execute": "ulw-execute";
 }>;
 export type BuiltinCommandName = z.infer<typeof BuiltinCommandNameSchema>;

package/dist/config/schema/hooks.d.ts

@@ -42,7 +42,6 @@ export declare const HookNameSchema: z.ZodEnum<{
     "runtime-fallback": "runtime-fallback";
     "session-notification": "session-notification";
     "sisyphus-junior-notepad": "sisyphus-junior-notepad";
-    "start-work": "start-work";
     "startup-toast": "startup-toast";
     "stop-continuation-guard": "stop-continuation-guard";
     "task-resume-info": "task-resume-info";
@@ -53,6 +52,7 @@ export declare const HookNameSchema: z.ZodEnum<{
     "todo-description-override": "todo-description-override";
     "tool-output-truncator": "tool-output-truncator";
     "tool-pair-validator": "tool-pair-validator";
+    "ulw-execute": "ulw-execute";
     "unstable-agent-babysitter": "unstable-agent-babysitter";
     "webfetch-redirect-guard": "webfetch-redirect-guard";
     "write-existing-file-guard": "write-existing-file-guard";

package/dist/config/schema/oh-my-opencode-config.d.ts

@@ -14,8 +14,8 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
         hyperplan: "hyperplan";
         refactor: "refactor";
         "remove-ai-slops": "remove-ai-slops";
-        "start-work": "start-work";
         "stop-continuation": "stop-continuation";
+        "ulw-execute": "ulw-execute";
     }>>>;
     disabled_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     disabled_providers: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -3716,6 +3716,9 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
             claude_code_compat: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    ulw_execute: z.ZodOptional<z.ZodObject<{
+        auto_commit: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
     start_work: z.ZodOptional<z.ZodObject<{
         auto_commit: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;

package/dist/config/schema/ulw-execute.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export declare const UlwExecuteConfigSchema: z.ZodObject<{
+    auto_commit: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type UlwExecuteConfig = z.infer<typeof UlwExecuteConfigSchema>;

package/dist/config/validate.d.ts

@@ -6,4 +6,6 @@ export type PluginConfigValidation = {
     readonly path: string | null;
     readonly config: OhMyOpenCodeConfig;
 };
+export declare function _setDeprecationWarningSinkForTesting(sink: (message: string) => void): void;
+export declare function _resetDeprecationWarningSinkForTesting(): void;
 export declare function validatePluginConfig(directory: string, environment?: OmoConfigEnv): PluginConfigValidation;

package/dist/create-hooks.d.ts

@@ -14,6 +14,7 @@ export type DisposableCreatedHooks = {
     claudeCodeHooks?: DisposableHook;
     commentChecker?: DisposableHook;
     runtimeFallback?: DisposableHook;
+    atlasHook?: DisposableHook;
     todoContinuationEnforcer?: DisposableHook;
     autoSlashCommand?: DisposableHook;
     anthropicContextWindowLimitRecovery?: DisposableHook;
@@ -45,7 +46,7 @@ export declare function createHooks(args: {
     goal: ReturnType<typeof import("./hooks").createGoalHook> | null;
     editErrorRecovery: ReturnType<typeof import("./hooks").createEditErrorRecoveryHook> | null;
     delegateTaskRetry: ReturnType<typeof import("./hooks").createDelegateTaskRetryHook> | null;
-    startWork: ReturnType<typeof import("./hooks").createStartWorkHook> | null;
+    ulwExecute: ReturnType<typeof import("./hooks").createUlwExecuteHook> | null;
     prometheusMdOnly: ReturnType<typeof import("./hooks").createPrometheusMdOnlyHook> | null;
     sisyphusJuniorNotepad: ReturnType<typeof import("./hooks").createSisyphusJuniorNotepadHook> | null;
     noSisyphusGpt: ReturnType<typeof import("./hooks").createNoSisyphusGptHook> | null;

package/dist/features/builtin-commands/templates/ulw-execute.d.ts

@@ -0,0 +1 @@
+export declare const ULW_EXECUTE_TEMPLATE = "You are starting an Atlas work session.\n\n## ARGUMENTS\n\n- `/ulw-execute [plan-name] [--worktree <path>] [--make-pr] [--ship]`\n  - `plan-name` (optional): name or partial match of the plan to start\n  - `--worktree <path>` (optional): absolute path to an existing git worktree to work in\n    - If specified and valid: hook pre-sets worktree_path in boulder.json\n    - If specified but invalid: you must run `git worktree add <path> <branch>` first\n    - If omitted: work directly in the current project directory (no worktree)\n  - `--make-pr` (optional): deliver the work as a pull request. IMPLIES worktree mode - when `--worktree` is omitted, create a task-owned worktree before implementation. On completion push the branch, open a reviewer-readable PR, and hand off with the PR URL (merge only on explicit user ask)\n  - `--ship` (optional): full delivery lifecycle; implies `--make-pr`. After the PR opens, keep working until it is MERGED (CI + review gates, feedback addressed), then clean up the worktree and sync `.omo/` state back\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Prometheus-generated plan files at `.omo/plans/`\n\n2. **Check for active boulder state**: Read `.omo/boulder.json` if it exists\n\n3. **Decision logic**:\n   - If multiple active works are listed in your context:\n     - This means boulder.json has more than one work with status: `active` or `paused`\n     - Use the Question tool to ask the user which plan to resume\n     - Resume by running `/ulw-execute {plan-name}` for the selected plan\n     - If the user says \"start a new plan\", continue with cold-start auto-selection logic\n   - If exactly one active work is listed and the user did not name a plan:\n     - Auto-resume that single active work\n   - If no active plan OR plan is complete:\n     - List available plan files\n     - If ONE plan: auto-select it\n     - If MULTIPLE plans: show list with timestamps, ask user to select\n\n4. **Worktree Setup** (ONLY when `--worktree` was explicitly specified and `worktree_path` not already set in boulder.json):\n   1. `git worktree list --porcelain` - see available worktrees\n   2. Create: `git worktree add <absolute-path> <branch-or-HEAD>`\n   3. Update boulder.json to add `\"worktree_path\": \"<absolute-path>\"`\n   4. All work happens inside that worktree directory\n\n5. **Create/Update boulder.json**:\n   ```json\n   {\n     \"active_plan\": \"/absolute/path/to/plan.md\",\n     \"started_at\": \"ISO_TIMESTAMP\",\n     \"session_ids\": [\"session_id_1\", \"session_id_2\"],\n     \"plan_name\": \"plan-name\",\n     \"worktree_path\": \"/absolute/path/to/git/worktree\"\n   }\n   ```\n\n6. **Read the plan file** and start executing tasks according to atlas workflow\n\n## OUTPUT FORMAT\n\nWhen listing plans for selection:\n```\nAvailable Work Plans\n\nCurrent Time: {ISO timestamp}\nSession ID: {current session id}\n\n1. [plan-name-1.md] - Modified: {date} - Progress: 3/10 tasks\n2. [plan-name-2.md] - Modified: {date} - Progress: 0/5 tasks\n\nWhich plan would you like to work on? (Enter number or plan name)\n```\n\nWhen resuming existing work:\n```\nResuming Work Session\n\nActive Plan: {plan-name}\nProgress: {completed}/{total} tasks\nSessions: {count} (appending current session)\nWorktree: {worktree_path}\n\nReading plan and continuing from last incomplete task...\n```\n\nWhen auto-selecting single plan:\n```\nStarting Work Session\n\nPlan: {plan-name}\nSession ID: {session_id}\nStarted: {timestamp}\nWorktree: {worktree_path}\n\nReading plan and beginning execution...\n```\n\n## CRITICAL\n\n- The session_id is injected by the hook - use it directly\n- Always update boulder.json BEFORE starting work\n- If worktree_path is set in boulder.json, all work happens inside that worktree directory\n- Read the FULL plan file before delegating any tasks\n- Follow atlas delegation protocols (7-section format)\n\n## GOAL + TASK BREAKDOWN (MANDATORY)\n\nDo BOTH of these immediately after reading the plan file, BEFORE starting any work. Skipping either is a defect.\n\n**1. Set the goal, in detail.** When a goal tool is available (`create_goal`), call it with a DETAILED objective: the plan name and path, the concrete end state, the phase/task counts, the delivery mode (direct, `--make-pr`, or `--ship`), and how completion will be verified. One work session = one goal. No goal tool -> record the same objective as the first `.omo/ulw-execute/ledger.jsonl` entry.\n\n**2. Register every phase and task as todos.** Decompose every plan task into granular, implementation-level sub-steps and register ALL of them as task/todo items, grouped phase by phase (one phase per plan wave), BEFORE starting any work. Keep them current at every moment: mark in_progress when work dispatches and done immediately after its verification passes - never batch-complete at the end, never execute work that is not a registered todo. Discovered work is appended as a todo before it runs.\n\n**How to break down**:\n- Each plan checkbox item (e.g., `- [ ] Add user authentication`) must be split into concrete, actionable sub-tasks\n- Sub-tasks should be specific enough that each one touches a clear set of files/functions\n- Include: file to modify, what to change, expected behavior, and how to verify\n- Do NOT leave any task vague - \"implement feature X\" is NOT acceptable; \"add validateToken() to src/auth/middleware.ts that checks JWT expiry and returns 401\" IS acceptable\n\n**Example breakdown**:\nPlan task: `- [ ] Add rate limiting to API`\n\u2192 Todo items:\n  1. Create `src/middleware/rate-limiter.ts` with sliding window algorithm (max 100 req/min per IP)\n  2. Add RateLimiter middleware to `src/app.ts` router chain, before auth middleware\n  3. Add rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) to response in `rate-limiter.ts`\n  4. Add test: verify 429 response after exceeding limit in `src/middleware/rate-limiter.test.ts`\n  5. Add test: verify headers are present on normal responses\n\nRegister these as task/todo items so progress is tracked and visible throughout the session.\n\n## WORKTREE COMPLETION\n\nWhen working in a worktree (`worktree_path` is set in boulder.json) and ALL plan tasks are complete:\n1. Commit all remaining changes in the worktree\n2. **Sync .omo state back**: Copy `.omo/` from the worktree to the main repo before removal.\n   This is CRITICAL when `.omo/` is gitignored - state written during worktree execution would otherwise be lost.\n   ```bash\n   cp -r <worktree-path>/.omo/* <main-repo>/.omo/ 2>/dev/null || true\n   ```\n3. Switch to the main working directory (the original repo, NOT the worktree)\n4. Merge the worktree branch into the current branch: `git merge <worktree-branch>`\n5. If merge succeeds, clean up: `git worktree remove <worktree-path>`\n6. Remove the boulder.json state\n\nThis is the DEFAULT behavior when `--worktree` was used alone. When `--make-pr` or `--ship` is active, skip the local merge and follow the PR Delivery Mode instructions in the session context instead: push the branch and open a PR (`--make-pr` hands off with the PR URL; `--ship` keeps working until the PR is merged), then clean up. Otherwise skip merge only if the user explicitly instructs otherwise (e.g., asks to create a PR instead).";

package/dist/features/builtin-commands/types.d.ts

@@ -1,5 +1,5 @@
 import type { CommandDefinition } from "../claude-code-command-loader";
-export type BuiltinCommandName = "goal" | "refactor" | "start-work" | "stop-continuation" | "handoff" | "remove-ai-slops" | "hyperplan";
+export type BuiltinCommandName = "goal" | "refactor" | "ulw-execute" | "stop-continuation" | "handoff" | "remove-ai-slops" | "hyperplan";
 export interface BuiltinCommandConfig {
     disabled_commands?: BuiltinCommandName[];
 }

package/dist/hooks/atlas/atlas-hook.d.ts

@@ -16,4 +16,5 @@ export declare function createAtlasHook(ctx: PluginInput, options?: AtlasHookOpt
         message?: string;
     }) => Promise<void>;
     "tool.execute.after": (toolInput: import("./types").ToolExecuteAfterInput, toolOutput: import("./types").ToolExecuteAfterOutput | undefined) => Promise<void>;
+    dispose: () => void;
 };

package/dist/hooks/atlas/atlas-lifecycle-store.d.ts

@@ -0,0 +1,50 @@
+import type { PendingTaskRef, SessionState } from "./types";
+export declare const ATLAS_SESSION_STATE_TTL_MS: number;
+export declare const ATLAS_SESSION_PRUNE_INTERVAL_MS: number;
+type PendingAtlasCall = {
+    readonly kind: "file";
+    readonly sessionID?: string;
+    readonly filePath: string;
+    readonly planSnapshot?: string;
+} | {
+    readonly kind: "task";
+    readonly sessionID?: string;
+    readonly task: PendingTaskRef;
+};
+export declare class AtlasLifecycleStore {
+    readonly sessions: Map<string, SessionState>;
+    readonly pendingFilePaths: Map<string, string>;
+    readonly pendingTaskRefs: Map<string, PendingTaskRef>;
+    readonly pendingPlanSnapshots: Map<string, string>;
+    readonly pendingCalls: Map<string, PendingAtlasCall>;
+    readonly sessionCallIDs: Map<string, Set<string>>;
+    private readonly lastAccessedAt;
+    private pruneInterval;
+    private disposed;
+    private readonly disposedState;
+    getExistingState(sessionID: string): SessionState | undefined;
+    getOrCreateState(sessionID: string): SessionState;
+    trackFileCall(callID: string, sessionID: string | undefined, filePath: string): void;
+    trackTaskCall(callID: string, sessionID: string | undefined, task: PendingTaskRef): void;
+    trackPlanSnapshot(callID: string, snapshot: string): void;
+    consumeFileCall(callID: string | undefined): Extract<PendingAtlasCall, {
+        kind: "file";
+    }> | undefined;
+    consumeTaskCall(callID: string | undefined): Extract<PendingAtlasCall, {
+        kind: "task";
+    }> | undefined;
+    clearPendingCall(callID: string | undefined): void;
+    cleanupSession(sessionID: string): void;
+    dispose(): void;
+    get sizes(): {
+        readonly sessions: number;
+        readonly pendingCalls: number;
+        readonly sessionIndexes: number;
+        readonly hasPruneInterval: boolean;
+    };
+    private replaceCall;
+    private removeSessionCallID;
+    private ensurePruneInterval;
+    private prune;
+}
+export {};

package/dist/hooks/atlas/event-handler.d.ts

@@ -5,6 +5,7 @@ export declare function createAtlasEventHandler(input: {
     options?: AtlasHookOptions;
     sessions: Map<string, SessionState>;
     getState: (sessionID: string) => SessionState;
+    cleanupSession: (sessionID: string) => void;
 }): (arg: {
     event: {
         type: string;

package/dist/hooks/atlas/tool-execute-before.d.ts

@@ -5,6 +5,9 @@ export declare function createToolExecuteBeforeHandler(input: {
     pendingFilePaths: Map<string, string>;
     pendingTaskRefs: Map<string, PendingTaskRef>;
     pendingPlanSnapshots?: Map<string, string>;
+    trackFileCall?: (callID: string, sessionID: string | undefined, filePath: string) => void;
+    trackTaskCall?: (callID: string, sessionID: string | undefined, task: PendingTaskRef) => void;
+    trackPlanSnapshot?: (callID: string, snapshot: string) => void;
     isCallerOrchestrator?: (sessionID: string | undefined) => Promise<boolean>;
 }): (toolInput: {
     tool: string;

package/dist/hooks/atlas/types.d.ts

@@ -43,6 +43,7 @@ export type PendingTaskRef = {
     task: TrackedTopLevelTaskRef;
 };
 export interface SessionState {
+    lifecycleActive?: boolean;
     lastEventWasAbortError?: boolean;
     skipNextIdleAfterRuntimeErrorRetry?: boolean;
     lastContinuationInjectedAt?: number;

package/dist/hooks/index.d.ts

@@ -36,7 +36,7 @@ export { createEditErrorRecoveryHook } from "./edit-error-recovery";
 export { createPrometheusMdOnlyHook } from "./prometheus-md-only";
 export { createSisyphusJuniorNotepadHook } from "./sisyphus-junior-notepad";
 export { createTaskResumeInfoHook } from "./task-resume-info";
-export { createStartWorkHook } from "./start-work";
+export { createUlwExecuteHook } from "./ulw-execute";
 export { createAtlasHook } from "./atlas";
 export { createTeamToolGating } from "./team-tool-gating";
 export { createDelegateTaskRetryHook } from "./delegate-task-retry";