oh-my-opencode 5.0.0-beta.2 → 5.0.0-beta.21

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;
@@ -75,6 +76,7 @@ export declare function createHooks(args: {
     planFormatValidator: ReturnType<typeof import("./hooks").createPlanFormatValidatorHook> | null;
     claudeCodeHooks: ReturnType<typeof import("./hooks").createClaudeCodeHooksHook> | null;
     keywordDetector: ReturnType<typeof import("./hooks").createKeywordDetectorHook> | null;
+    btwSideContextInjector: ReturnType<typeof import("./features/btw-side").createBtwSideContextInjectorHook>;
     contextInjectorMessagesTransform: ReturnType<typeof import("./features/context-injector").createContextInjectorMessagesTransformHook>;
     teamModeStatusInjector: ReturnType<typeof import("./hooks").createTeamModeStatusInjector> | null;
     teamMailboxInjector: ReturnType<typeof import("./hooks").createTeamMailboxInjector> | null;

package/dist/features/btw-side/btw-command-draft.d.ts

@@ -0,0 +1,7 @@
+import type { BtwSessionMessage } from "./tui-controller-types";
+export declare function isBtwCommandDraft(input: string): boolean;
+export declare function parseBtwQuestion(input: string): {
+    consumeDraft: boolean;
+    question: string;
+};
+export declare function findBtwBoundaryMessageID(messages: BtwSessionMessage[]): string | undefined;

package/dist/features/btw-side/context-injector.d.ts

@@ -0,0 +1,15 @@
+import type { Message, Part } from "@opencode-ai/sdk";
+import type { PluginContext } from "../../plugin/types";
+export declare const BTW_BOUNDARY_SENTINEL = "<omo-btw-boundary>";
+export { BTW_PARENT_CONTEXT_MAX_BYTES, BTW_PARENT_CONTEXT_MAX_MESSAGES, } from "./parent-context-budget";
+type MessageWithParts = {
+    info: Message;
+    parts: Part[];
+};
+export declare function createBtwSideContextInjectorHook(args: {
+    client: PluginContext["client"];
+}): {
+    "experimental.chat.messages.transform": (_input: Record<string, never>, output: {
+        messages: MessageWithParts[];
+    }) => Promise<void>;
+};

package/dist/features/btw-side/index.d.ts

@@ -0,0 +1,8 @@
+export { BTW_BOUNDARY_SENTINEL, createBtwSideContextInjectorHook, } from "./context-injector";
+export { BTW_SIDE_METADATA_KEY, BTW_SIDE_METADATA_VERSION, createBtwSideMetadata, getBtwSideMetadata, parseBtwSideMetadata, } from "./metadata";
+export type { BtwSideMetadata } from "./metadata";
+export { createBtwSideController } from "./tui-controller";
+export { isBtwCommandDraft } from "./btw-command-draft";
+export type { BtwCreateSessionInput, BtwPromptRef, BtwSession, BtwSessionMessage, BtwSideControllerDependencies, BtwSideState, } from "./tui-controller-types";
+export { forgetBtwSideSession, isTrackedBtwSideSession, markBtwSideSession, resetBtwSideSessionRegistryForTesting, trackBtwSideSession, } from "./server-session-registry";
+export { registerBtwSideTui } from "./tui-wiring";

package/dist/features/btw-side/metadata.d.ts

@@ -0,0 +1,15 @@
+export declare const BTW_SIDE_METADATA_KEY = "omo_btw_side";
+export declare const BTW_SIDE_METADATA_VERSION = 1;
+export type BtwSideMetadata = {
+    version: typeof BTW_SIDE_METADATA_VERSION;
+    parent_session_id: string;
+    boundary_message_id: string;
+};
+export declare function createBtwSideMetadata(args: {
+    parentSessionID: string;
+    boundaryMessageID: string;
+}): BtwSideMetadata;
+export declare function parseBtwSideMetadata(value: unknown): BtwSideMetadata | undefined;
+export declare function getBtwSideMetadata(session: {
+    metadata?: Record<string, unknown>;
+} | undefined): BtwSideMetadata | undefined;

package/dist/features/btw-side/parent-context-budget.d.ts

@@ -0,0 +1,9 @@
+import type { Message, Part } from "@opencode-ai/sdk";
+export declare const BTW_PARENT_CONTEXT_MAX_BYTES: number;
+export declare const BTW_PARENT_CONTEXT_MAX_MESSAGES = 64;
+type MessageWithParts = {
+    info: Message;
+    parts: Part[];
+};
+export declare function boundBtwParentContext(messages: MessageWithParts[]): MessageWithParts[];
+export {};

package/dist/features/btw-side/server-session-registry.d.ts

@@ -0,0 +1,8 @@
+export declare function trackBtwSideSession(session: {
+    id: string;
+    metadata?: Record<string, unknown>;
+}): boolean;
+export declare function markBtwSideSession(sessionID: string): void;
+export declare function forgetBtwSideSession(sessionID: string): boolean;
+export declare function isTrackedBtwSideSession(sessionID: string): boolean;
+export declare function resetBtwSideSessionRegistryForTesting(): void;

package/dist/features/btw-side/tui-adoption-cache.d.ts

@@ -0,0 +1,13 @@
+import type { BtwSideMetadata } from "./metadata";
+type CachedAdoption = {
+    hydrated: false;
+} | {
+    hydrated: true;
+    metadata?: BtwSideMetadata;
+};
+export declare function createBtwAdoptionCache(): {
+    read: (sessionID: string) => CachedAdoption;
+    write: (sessionID: string, metadata: BtwSideMetadata | undefined) => void;
+    removeForDeletion: (sessionID: string) => void;
+};
+export {};

package/dist/features/btw-side/tui-adoption-guard.d.ts

@@ -0,0 +1,5 @@
+export declare function createBtwAdoptionGuard(currentSessionID: () => string | undefined): {
+    canApply: (sessionID: string, parentSessionID?: string) => boolean;
+    markDeleted: (sessionID: string) => void;
+    dispose: () => void;
+};

package/dist/features/btw-side/tui-controller-types.d.ts

@@ -0,0 +1,68 @@
+export type BtwPromptRef = {
+    readonly hasAttachments: boolean;
+    readonly input: string;
+    set: (input: string) => void;
+    submit: () => void;
+};
+export type BtwSession = {
+    id: string;
+    title: string;
+    agent?: string;
+    model?: {
+        providerID: string;
+        id: string;
+    };
+};
+export type BtwSessionMessage = {
+    info: {
+        id: string;
+        role: "user" | "assistant";
+        time?: {
+            completed?: number;
+        };
+    };
+};
+export type BtwCreateSessionInput = {
+    title: string;
+    agent?: string;
+    model?: {
+        providerID: string;
+        id: string;
+    };
+    metadata: Record<string, unknown>;
+};
+export type BtwSideControllerDependencies = {
+    getCurrentSessionID: () => string | undefined;
+    getSession: (sessionID: string) => BtwSession | undefined;
+    getMessages: (sessionID: string) => BtwSessionMessage[];
+    createSession: (input: BtwCreateSessionInput) => Promise<{
+        id: string;
+        title: string;
+    }>;
+    navigateSession: (sessionID: string) => void;
+    abortSession: (sessionID: string) => Promise<void>;
+    deleteSession: (sessionID: string) => Promise<void>;
+    showToast: (message: string) => void;
+    requestRender: () => void;
+};
+export type BtwSideState = {
+    phase: "closed";
+} | {
+    phase: "creating";
+    parentSessionID: string;
+} | {
+    phase: "open";
+    parentSessionID: string;
+    sideSessionID: string;
+    owned: boolean;
+} | {
+    phase: "closing";
+    parentSessionID: string;
+    sideSessionID: string;
+    owned: boolean;
+};
+export type BtwSideRecord = {
+    parentSessionID: string;
+    sideSessionID: string;
+    owned: boolean;
+};

package/dist/features/btw-side/tui-controller.d.ts

@@ -0,0 +1,19 @@
+import type { BtwPromptRef, BtwSideControllerDependencies, BtwSideRecord, BtwSideState } from "./tui-controller-types";
+export declare function createBtwSideController(dependencies: BtwSideControllerDependencies): {
+    state: () => BtwSideState;
+    sides: () => BtwSideRecord[];
+    side: (sessionID: string) => BtwSideRecord | undefined;
+    sideNumber: (sessionID: string) => number | undefined;
+    rootParent: (sessionID: string) => string;
+    startFromPrompt: (promptRef: BtwPromptRef, parentSessionID?: string | undefined) => Promise<boolean>;
+    attachPromptRef: (sessionID: string, promptRef: BtwPromptRef | undefined) => void;
+    toggle: () => void;
+    close: () => Promise<void>;
+    returnToParent: () => void;
+    handleNavigation: (sessionID: string) => Promise<void>;
+    handleSessionDeleted: (sessionID: string) => void;
+    canCloseCurrentSide: () => boolean;
+    adopt: (parentSessionID: string, sideSessionID: string, sideNumber?: number) => void;
+    waitUntilClosed: () => Promise<void>;
+    dispose: () => Promise<void>;
+};

package/dist/features/btw-side/tui-escape-return.d.ts

@@ -0,0 +1,12 @@
+import type { KeyEvent } from "@opentui/core";
+import type { KeyInputContext } from "@opentui/keymap";
+export declare function createBtwEscapeReturn(args: {
+    isCurrentSideIdle: () => boolean;
+    isDialogOpen: () => boolean;
+    clearPending: () => void;
+    returnToParent: () => void;
+    now?: () => number;
+}): {
+    handle: (context: KeyInputContext<KeyEvent>) => void;
+    reset: () => void;
+};

package/dist/features/btw-side/tui-keymap.d.ts

@@ -0,0 +1,17 @@
+import type { TuiPluginApi, TuiPromptRef } from "@opencode-ai/plugin/tui";
+import type { createBtwSideController } from "./tui-controller";
+type BtwSideController = ReturnType<typeof createBtwSideController>;
+export type BtwSideKeymapRegistration = {
+    unregister: Array<() => void>;
+    resetEscapeSequence: () => void;
+};
+export declare function registerBtwSideKeymap(args: {
+    api: TuiPluginApi;
+    controller: BtwSideController;
+    activePromptRef: () => TuiPromptRef | undefined;
+    openBtw: () => Promise<void>;
+    openPicker: () => Promise<void>;
+    isCurrentSideIdle: () => boolean;
+    returnToParent: () => void;
+}): BtwSideKeymapRegistration;
+export {};

package/dist/features/btw-side/tui-parent-validator.d.ts

@@ -0,0 +1,6 @@
+export declare function createBtwParentValidator(dependencies: {
+    fetchStatus: (sessionID: string) => Promise<"exists" | "missing" | "retry">;
+}): {
+    exists: (sessionID: string) => Promise<boolean>;
+    markDeleted: (sessionID: string) => void;
+};

package/dist/features/btw-side/tui-picker-options.d.ts

@@ -0,0 +1,20 @@
+import type { BtwSessionCatalog } from "./tui-session-catalog";
+export type BtwPickerOption = {
+    title: string;
+    value: string;
+    description: string;
+    category: string;
+    disabled?: boolean;
+};
+export type BtwPickerSelection = {
+    type: "session";
+    sessionID: string;
+} | {
+    type: "new";
+    parentSessionID: string;
+};
+export declare function parseBtwPickerValue(value: string): BtwPickerSelection | undefined;
+export declare function buildBtwPickerOptions(catalog: BtwSessionCatalog, currentSessionID: string): {
+    options: BtwPickerOption[];
+    current: string;
+};

package/dist/features/btw-side/tui-picker.d.ts

@@ -0,0 +1,9 @@
+import type { TuiPluginApi, TuiPromptRef } from "@opencode-ai/plugin/tui";
+import type { createBtwSideController } from "./tui-controller";
+type BtwSideController = ReturnType<typeof createBtwSideController>;
+export declare function openBtwPicker(args: {
+    api: TuiPluginApi;
+    controller: BtwSideController;
+    activePromptRef: () => TuiPromptRef | undefined;
+}): Promise<boolean>;
+export {};

package/dist/features/btw-side/tui-prompt-queue.d.ts

@@ -0,0 +1,8 @@
+import type { BtwPromptRef } from "./tui-controller-types";
+export declare function createBtwPromptQueue(): {
+    attach(sessionID: string, promptRef: BtwPromptRef | undefined): void;
+    queue(sessionID: string, question: string): void;
+    input(sessionID: string): string;
+    hasAttachments(sessionID: string): boolean;
+    clear(sessionID: string): void;
+};

package/dist/features/btw-side/tui-session-bridge.d.ts

@@ -0,0 +1,11 @@
+import type { TuiPluginApi, TuiPromptRef } from "@opencode-ai/plugin/tui";
+import type { BtwPromptRef, BtwSideControllerDependencies } from "./tui-controller-types";
+export declare function unwrapTuiData<T>(response: {
+    data?: T;
+    error?: unknown;
+}, message: string): T;
+export declare function currentTuiSessionID(api: TuiPluginApi): string | undefined;
+export declare function isCurrentTuiSession(api: TuiPluginApi, sessionID: string | undefined): boolean;
+export declare function adaptTuiPromptRef(promptRef: TuiPromptRef): BtwPromptRef;
+export declare function parentTuiStatusLabel(api: TuiPluginApi, parentSessionID: string): string;
+export declare function createBtwControllerDependencies(api: TuiPluginApi): BtwSideControllerDependencies;

package/dist/features/btw-side/tui-session-catalog.d.ts

@@ -0,0 +1,35 @@
+export type BtwCatalogSession = {
+    id: string;
+    title: string;
+    metadata?: Record<string, unknown>;
+    time: {
+        created: number;
+        updated: number;
+    };
+};
+export type BtwSessionCatalog = {
+    main: BtwCatalogSession;
+    sides: BtwCatalogSession[];
+};
+type BtwSessionListInput = {
+    directory: string;
+    roots: false;
+    limit: number;
+};
+type BtwSessionListResponse = {
+    data?: BtwCatalogSession[];
+    error?: unknown;
+};
+type LoadBtwSessionCatalogInput = {
+    currentSessionID: string;
+    directory: string;
+    listSessions: (input: BtwSessionListInput) => Promise<BtwSessionListResponse>;
+    initialLimit?: number;
+    maximumLimit?: number;
+};
+export declare function classifyBtwSessionCatalog(sessions: BtwCatalogSession[], currentSessionID: string): BtwSessionCatalog | undefined;
+export declare function loadBtwSessionCatalog(input: LoadBtwSessionCatalogInput): Promise<{
+    catalog: BtwSessionCatalog | undefined;
+    truncated: boolean;
+}>;
+export {};

package/dist/features/btw-side/tui-side-removal.d.ts

@@ -0,0 +1,11 @@
+export declare function abortBtwSide(args: {
+    sessionID: string;
+    abortSession: (sessionID: string) => Promise<void>;
+    showToast: (message: string) => void;
+}): Promise<void>;
+export declare function deleteBtwSide(args: {
+    sessionID: string;
+    deleteSession: (sessionID: string) => Promise<void>;
+    showToast: (message: string) => void;
+    failureMessage: string;
+}): Promise<boolean>;

package/dist/features/btw-side/tui-side-start.d.ts

@@ -0,0 +1,9 @@
+import type { BtwCreateSessionInput, BtwPromptRef, BtwSideControllerDependencies } from "./tui-controller-types";
+export type PreparedBtwSideStart = {
+    parentSessionID: string;
+    originalDraft: string;
+    consumeDraft: boolean;
+    question: string;
+    createInput: BtwCreateSessionInput;
+};
+export declare function prepareBtwSideStart(dependencies: BtwSideControllerDependencies, promptRef: BtwPromptRef, parentSessionID?: string | undefined): PreparedBtwSideStart | undefined;

package/dist/features/btw-side/tui-wiring.d.ts

@@ -0,0 +1,8 @@
+import type { TuiPluginApi } from "@opencode-ai/plugin/tui";
+type SolidRuntime<Node> = {
+    readonly createElement: (tag: string) => Node;
+    readonly insert: (parent: Node, child: unknown, marker?: unknown, initial?: unknown) => unknown;
+    readonly setProp: (node: Node, name: string, value: unknown, previous?: unknown) => unknown;
+};
+export declare function registerBtwSideTui<Node>(api: TuiPluginApi, solid: SolidRuntime<Node>): Promise<void>;
+export {};

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/features/opengateway-provider/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Injects OpenGateway into opencode's live config so its models appear without
+ * the user hand-writing a provider block.
+ *
+ * opencode activates every `config.provider` entry regardless of credentials, so
+ * the injection is gated on an actual credential: the API key env var, or an
+ * `opengateway` entry in opencode's auth.json. Without one, the config is left
+ * exactly as it came in.
+ */
+export declare const OPENGATEWAY_PROVIDER_ID = "opengateway";
+export declare const OPENGATEWAY_BASE_URL = "https://apis.opengateway.ai/v1";
+export declare const OPENGATEWAY_ENV_VAR = "OPENGATEWAY_API_KEY";
+export declare function applyOpenGatewayProviderConfig(config: Record<string, unknown>): void;

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/final-wave-approval-gate.test-support.d.ts

@@ -0,0 +1,50 @@
+import { mock } from "bun:test";
+import type { createAtlasHook } from "./index";
+import type { createToolExecuteAfterHandler } from "./tool-execute-after";
+import type { SessionState, ToolExecuteAfterOutput } from "./types";
+type AtlasHookContext = Parameters<typeof createAtlasHook>[0];
+type PromptMock = ReturnType<typeof mock>;
+export type FinalWaveMockPluginInput = AtlasHookContext & {
+    _promptMock: PromptMock;
+};
+export type FinalWaveAfterHandlerHarness = {
+    sessionState: SessionState;
+    run: (toolOutput: ToolExecuteAfterOutput) => Promise<void>;
+};
+/**
+ * Builds a mock plugin input with a recording prompt mock. `resolveParentSessionID`
+ * maps a subagent task session id to the orchestrator session the task belongs to.
+ */
+export declare function createFinalWaveMockPluginInput(options: {
+    directory: string;
+    resolveParentSessionID: (taskSessionID: string) => string;
+}): FinalWaveMockPluginInput;
+/**
+ * Registers per-test temp-directory lifecycle hooks (`.omo` scaffold + boulder state
+ * cleanup) and exposes the current directory. `resetAgentRegistration` also resets
+ * the shared claude-code session-state registry between tests.
+ */
+export declare function registerFinalWaveTestEnvironment(options?: {
+    resetAgentRegistration?: boolean;
+}): {
+    readonly directory: string;
+};
+/** Writes the plan markdown plus the boulder state pointing the session at it. */
+export declare function writeFinalWavePlanState(options: {
+    directory: string;
+    sessionID: string;
+    planName: string;
+    planContent: string;
+}): string;
+/**
+ * Wraps `createToolExecuteAfterHandler` with a shared in-memory session-state map so
+ * tests can assert pause/count flags. The handler factory is passed in explicitly:
+ * suites that mock modules (`mock.module`) must hand over their post-mock import so
+ * the harness runs against the same module instance the suite asserts on.
+ */
+export declare function createFinalWaveAfterHandlerHarness(options: {
+    ctx: AtlasHookContext;
+    sessionID: string;
+    createHandler: typeof createToolExecuteAfterHandler;
+}): FinalWaveAfterHandlerHarness;
+export {};

package/dist/hooks/atlas/system-reminder-templates.d.ts

@@ -2,6 +2,5 @@ export declare const DIRECT_WORK_REMINDER: string;
 export declare const BOULDER_CONTINUATION_PROMPT: string;
 export declare const BOULDER_COMPLETE_PROMPT = "<system-reminder>\nBOULDER COMPLETE: plan \"{PLAN_NAME}\" is fully checked.\n\nTotal elapsed: {ELAPSED_HUMAN}\n\nPer-task breakdown:\n{TASK_BREAKDOWN}\n\nPer your <boulder_completion_response> instructions, print the final ORCHESTRATION COMPLETE summary in your next turn. This nudge fires at most once.\n</system-reminder>";
 export declare const VERIFICATION_REMINDER = "**THE SUBAGENT JUST CLAIMED THIS TASK IS DONE. THEY ARE PROBABLY LYING.**\n\nSubagents say \"done\" when code has errors, tests pass trivially, logic is wrong,\nor they quietly added features nobody asked for. This happens EVERY TIME.\nAssume the work is broken until YOU prove otherwise.\n\n---\n\n**PHASE 1: READ THE CODE FIRST (before running anything)**\n\nDo NOT run tests yet. Read the code FIRST so you know what you're testing.\n\n1. `Bash(\"git diff --stat -- ':!node_modules'\")` - see exactly which files changed. Any file outside expected scope = scope creep.\n2. `Read` EVERY changed file - no exceptions, no skimming.\n3. For EACH file, critically ask:\n   - Does this code ACTUALLY do what the task required? (Re-read the task, compare line by line)\n   - Any stubs, TODOs, placeholders, hardcoded values? (`Grep` for TODO, FIXME, HACK, xxx)\n   - Logic errors? Trace the happy path AND the error path in your head.\n   - Anti-patterns? (`Grep` for `as any`, `@ts-ignore`, empty catch, console.log in changed files)\n   - Scope creep? Did the subagent touch things or add features NOT in the task spec?\n4. Cross-check every claim:\n   - Said \"Updated X\" - READ X. Actually updated, or just superficially touched?\n   - Said \"Added tests\" - READ the tests. Do they test REAL behavior or just `expect(true).toBe(true)`?\n   - Said \"Follows patterns\" - OPEN a reference file. Does it ACTUALLY match?\n\n**If you cannot explain what every changed line does, you have NOT reviewed it.**\n\n**PHASE 2: RUN AUTOMATED CHECKS (targeted, then broad)**\n\nNow that you understand the code, verify mechanically:\n1. `lsp_diagnostics` on EACH changed file - ZERO new errors\n2. Run tests for changed modules FIRST, then full suite\n3. Build/typecheck - exit 0\n\nIf Phase 1 found issues but Phase 2 passes: Phase 2 is WRONG. The code has bugs that tests don't cover. Fix the code.\n\n**PHASE 3: HANDS-ON QA - ACTUALLY RUN IT (MANDATORY for user-facing changes)**\n\nTests and linters CANNOT catch: visual bugs, wrong CLI output, broken user flows, API response shape issues.\n\n**If this task produced anything a user would SEE or INTERACT with, you MUST launch it and verify yourself.**\n\n- **Frontend/UI**: `/playwright` skill - load the page, click through the flow, check console. Verify: page loads, interactions work, console clean, responsive.\n- **TUI/CLI**: `interactive_bash` - run the command, try good input, try bad input, try --help. Verify: command runs, output correct, error messages helpful, edge inputs handled.\n- **API/Backend**: `Bash` with curl - hit the endpoint, check response body, send malformed input. Verify: returns 200, body correct, error cases return proper errors.\n- **Config/Build**: Actually start the service or import the config. Verify: loads without error, backward compatible.\n\nThis is NOT optional \"if applicable\". If the deliverable is user-facing and you did not run it, you are shipping untested work.\n\n**PHASE 4: GATE DECISION - Should you proceed to the next task?**\n\nAnswer honestly:\n1. Can I explain what EVERY changed line does? (If no - back to Phase 1)\n2. Did I SEE it work with my own eyes? (If user-facing and no - back to Phase 3)\n3. Am I confident nothing existing is broken? (If no - run broader tests)\n\nALL three must be YES. \"Probably\" = NO. \"I think so\" = NO. Investigate until CERTAIN.\n\n- **All 3 YES** - Proceed: mark task complete, move to next.\n- **Any NO** - Reject: resume with `task_id`, fix the specific issue.\n- **Unsure** - Reject: \"unsure\" = \"no\". Investigate until you have a definitive answer.\n\n**DO NOT proceed to the next task until all 4 phases are complete and the gate passes.**";
-export declare const VERIFICATION_REMINDER_GEMINI = "**THE SUBAGENT HAS FINISHED. THEIR WORK IS EXTREMELY SUSPICIOUS.**\n\nThe subagent CLAIMS this task is done. Based on thousands of executions, subagent claims are FALSE more often than true.\nThey ROUTINELY:\n- Ship code with syntax errors they didn't bother to check\n- Create stub implementations with TODOs and call it \"done\"\n- Write tests that pass trivially (testing nothing meaningful)\n- Implement logic that does NOT match what was requested\n- Add features nobody asked for and call it \"improvement\"\n- Report \"all tests pass\" when they didn't run any tests\n\n**This is NOT a theoretical warning. This WILL happen on this task. Assume the work is BROKEN.**\n\n**YOU MUST VERIFY WITH ACTUAL TOOL CALLS. NOT REASONING. TOOL CALLS.**\nThinking \"it looks correct\" is NOT verification. Running `lsp_diagnostics` IS.\n\n---\n\n**PHASE 1: READ THE CODE FIRST (DO NOT SKIP - DO NOT RUN TESTS YET)**\n\nRead the code FIRST so you know what you're testing.\n\n1. `Bash(\"git diff --stat -- ':!node_modules'\")` - see exactly which files changed.\n2. `Read` EVERY changed file - no exceptions, no skimming.\n3. For EACH file:\n   - Does this code ACTUALLY do what the task required? RE-READ the task spec.\n   - Any stubs, TODOs, placeholders? `Grep` for TODO, FIXME, HACK, xxx\n   - Anti-patterns? `Grep` for `as any`, `@ts-ignore`, empty catch\n   - Scope creep? Did the subagent add things NOT in the task spec?\n4. Cross-check EVERY claim against actual code.\n\n**If you cannot explain what every changed line does, GO BACK AND READ AGAIN.**\n\n**PHASE 2: RUN AUTOMATED CHECKS**\n\n1. `lsp_diagnostics` on EACH changed file - ZERO new errors. ACTUALLY RUN THIS.\n2. Run tests for changed modules, then full suite. ACTUALLY RUN THESE.\n3. Build/typecheck - exit 0.\n\nIf Phase 1 found issues but Phase 2 passes: Phase 2 is WRONG. Fix the code.\n\n**PHASE 3: HANDS-ON QA (MANDATORY for user-facing changes)**\n\n- **Frontend/UI**: `/playwright`\n- **TUI/CLI**: `interactive_bash`\n- **API/Backend**: `Bash` with curl\n\n**If user-facing and you did not run it, you are shipping UNTESTED BROKEN work.**\n\n**PHASE 4: GATE DECISION**\n\n1. Can I explain what EVERY changed line does? (If no \u2192 Phase 1)\n2. Did I SEE it work via tool calls? (If user-facing and no \u2192 Phase 3)\n3. Am I confident nothing is broken? (If no \u2192 broader tests)\n\nALL three must be YES. \"Probably\" = NO. \"I think so\" = NO.\n\n**DO NOT proceed to the next task until all 4 phases are complete.**";
 export declare const ORCHESTRATOR_DELEGATION_REQUIRED: string;
 export declare const SINGLE_TASK_DIRECTIVE: 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;