oh-my-opencode 4.19.1 → 4.19.3

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

@@ -1,33 +1,33 @@
 import { z } from "zod";
 import type { TmuxConfig, TmuxIsolation, TmuxLayout } from "@oh-my-opencode/tmux-core";
 export declare const TmuxLayoutSchema: z.ZodEnum<{
+    "even-horizontal": "even-horizontal";
+    "even-vertical": "even-vertical";
     "main-horizontal": "main-horizontal";
     "main-vertical": "main-vertical";
     tiled: "tiled";
-    "even-horizontal": "even-horizontal";
-    "even-vertical": "even-vertical";
 }>;
 export declare const TmuxIsolationSchema: z.ZodEnum<{
+    inline: "inline";
     session: "session";
     window: "window";
-    inline: "inline";
 }>;
 export declare const TmuxConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     layout: z.ZodDefault<z.ZodEnum<{
+        "even-horizontal": "even-horizontal";
+        "even-vertical": "even-vertical";
         "main-horizontal": "main-horizontal";
         "main-vertical": "main-vertical";
         tiled: "tiled";
-        "even-horizontal": "even-horizontal";
-        "even-vertical": "even-vertical";
     }>>;
     main_pane_size: z.ZodDefault<z.ZodNumber>;
     main_pane_min_width: z.ZodDefault<z.ZodNumber>;
     agent_pane_min_width: z.ZodDefault<z.ZodNumber>;
     isolation: z.ZodDefault<z.ZodEnum<{
+        inline: "inline";
         session: "session";
         window: "window";
-        inline: "inline";
     }>>;
 }, z.core.$strip>;
 export type { TmuxConfig, TmuxIsolation, TmuxLayout };

package/dist/config/validate.d.ts

@@ -1,3 +1,4 @@
+import type { OmoConfigEnv } from "@oh-my-opencode/omo-config-core";
 import { type OhMyOpenCodeConfig } from "./schema";
 export type PluginConfigValidation = {
     readonly valid: boolean;
@@ -5,4 +6,4 @@ export type PluginConfigValidation = {
     readonly path: string | null;
     readonly config: OhMyOpenCodeConfig;
 };
-export declare function validatePluginConfig(directory: string): PluginConfigValidation;
+export declare function validatePluginConfig(directory: string, environment?: OmoConfigEnv): PluginConfigValidation;

package/dist/config-migration/deep-diff.d.ts

@@ -0,0 +1 @@
+export declare function deepDifference(base: Readonly<Record<string, unknown>>, profile: Readonly<Record<string, unknown>>): Record<string, unknown>;

package/dist/config-migration/discovery-paths.d.ts

@@ -0,0 +1,11 @@
+import { type ConfigMigrationDiscoveryOptions, type ConfigMigrationPathOperations } from "./types";
+export declare const CONFIG_FILE_NAMES: readonly ["oh-my-openagent.jsonc", "oh-my-openagent.json", "oh-my-opencode.jsonc", "oh-my-opencode.json"];
+export declare function isWindowsPathOperations(options: ConfigMigrationDiscoveryOptions): boolean;
+export declare function discoveryFileSystem(options: ConfigMigrationDiscoveryOptions): import("./types").ConfigMigrationDiscoveryFileSystem;
+export declare function usesWindowsPathSemantics(options: ConfigMigrationDiscoveryOptions): boolean;
+export declare function hostPathOperations(options: ConfigMigrationDiscoveryOptions): ConfigMigrationPathOperations;
+export declare function canonicalPath(path: string, options: ConfigMigrationDiscoveryOptions): string;
+export declare function pathKey(path: string, options: ConfigMigrationDiscoveryOptions): string;
+export declare function configPaths(directory: string, options: ConfigMigrationDiscoveryOptions): readonly string[];
+export declare function profileDirectories(root: string, options: ConfigMigrationDiscoveryOptions): readonly string[];
+export declare function projectDirectories(options: ConfigMigrationDiscoveryOptions): readonly string[];

package/dist/config-migration/discovery-roots.d.ts

@@ -0,0 +1,7 @@
+import type { ConfigMigrationDiscoveryOptions } from "./types";
+export type ConfigRoot = {
+    readonly activeProfile?: string;
+    readonly path: string;
+    readonly precedence: number;
+};
+export declare function configRoots(options: ConfigMigrationDiscoveryOptions): readonly ConfigRoot[];

package/dist/config-migration/discovery.d.ts

@@ -0,0 +1,4 @@
+import { type ConfigMigrationDiscoveryOptions, type LegacyConfigMigrationGroup } from "./types";
+export declare const OPENCODE_CONFIG_MIGRATION_ID = "2026-07-opencode-config-unification";
+export declare const CONFIG_JSONC_MIGRATION_ID = "2026-07-codex-config-jsonc";
+export declare function discoverLegacyConfigGroups(options: ConfigMigrationDiscoveryOptions): readonly LegacyConfigMigrationGroup[];

package/dist/config-migration/index.d.ts

@@ -0,0 +1,9 @@
+export { CONFIG_JSONC_MIGRATION_ID, OPENCODE_CONFIG_MIGRATION_ID, discoverLegacyConfigGroups, } from "./discovery";
+export { createLegacyConfigMigrationPlans, } from "./migration-plans";
+export { executeLegacyConfigMigrationPlan } from "./migration-executor";
+export { transformConfigJsoncSources } from "./transform-config-jsonc";
+export { transformOpenCodeSources } from "./transform-opencode";
+export type { ExecuteLegacyConfigMigrationPlanOptions } from "./migration-executor";
+export type { CreateLegacyConfigMigrationPlansOptions, LegacyConfigMigrationPlan, } from "./migration-plans";
+export type { ConfigMigrationTransformResult, LoadedLegacyConfigSource, OpenCodeTransformScope, TransformConfigJsoncSourcesInput, TransformOpenCodeSourcesInput, } from "./transform-types";
+export type { ConfigMigrationDiscoveryFileSystem, ConfigMigrationDiscoveryOptions, ConfigMigrationPathOperations, DiscoveredLegacyConfigSource, LegacyConfigMigrationGroup, LegacyConfigSourceKind, } from "./types";

package/dist/config-migration/legacy-history.d.ts

@@ -0,0 +1,3 @@
+import type { DiscoveredLegacyConfigSource } from "./types";
+import type { LoadedLegacyConfigSource } from "./transform-types";
+export declare function legacyMigrationHistory(discovered: readonly DiscoveredLegacyConfigSource[], loaded: readonly LoadedLegacyConfigSource[]): Record<string, readonly string[]>;

package/dist/config-migration/migration-executor.d.ts

@@ -0,0 +1,4 @@
+import { type MigrationRunResult, type RunMigrationOptions } from "@oh-my-opencode/omo-config-core";
+import type { LegacyConfigMigrationPlan } from "./migration-plans";
+export type ExecuteLegacyConfigMigrationPlanOptions = Omit<RunMigrationOptions, "id" | "sources" | "targetPath" | "transform">;
+export declare function executeLegacyConfigMigrationPlan(plan: LegacyConfigMigrationPlan, options?: ExecuteLegacyConfigMigrationPlanOptions): MigrationRunResult;

package/dist/config-migration/migration-plans.d.ts

@@ -0,0 +1,14 @@
+import type { MigrationSourceDescriptor, MigrationTransform } from "@oh-my-opencode/omo-config-core";
+import type { ConfigMigrationDiscoveryOptions } from "./types";
+import type { ConfigMigrationTransformResult } from "./transform-types";
+export type LegacyConfigMigrationPlan = {
+    readonly id: string;
+    readonly inspect: (sources: Parameters<MigrationTransform>[0]) => ConfigMigrationTransformResult;
+    readonly sources: readonly MigrationSourceDescriptor[];
+    readonly targetPath: string;
+    readonly transform: MigrationTransform;
+};
+export type CreateLegacyConfigMigrationPlansOptions = ConfigMigrationDiscoveryOptions & {
+    readonly backupTimestamp?: string;
+};
+export declare function createLegacyConfigMigrationPlans(options: CreateLegacyConfigMigrationPlansOptions): readonly LegacyConfigMigrationPlan[];

package/dist/config-migration/record-values.d.ts

@@ -0,0 +1,4 @@
+export declare function isPlainRecord(value: unknown): value is Record<string, unknown>;
+export declare function copyRecord(value: Readonly<Record<string, unknown>>): Record<string, unknown>;
+export declare function mergeRecords(base: Readonly<Record<string, unknown>>, override: Readonly<Record<string, unknown>>): Record<string, unknown>;
+export declare function withoutLegacyMetadata(value: Readonly<Record<string, unknown>>): Record<string, unknown>;

package/dist/config-migration/schema-url.d.ts

@@ -0,0 +1 @@
+export declare const OMO_SCHEMA_URL = "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/omo.schema.json";

package/dist/config-migration/transform-config-jsonc.d.ts

@@ -0,0 +1,2 @@
+import type { ConfigMigrationTransformResult, TransformConfigJsoncSourcesInput } from "./transform-types";
+export declare function transformConfigJsoncSources(input: TransformConfigJsoncSourcesInput): ConfigMigrationTransformResult;

package/dist/config-migration/transform-opencode.d.ts

@@ -0,0 +1,2 @@
+import type { TransformOpenCodeSourcesInput, ConfigMigrationTransformResult } from "./transform-types";
+export declare function transformOpenCodeSources(input: TransformOpenCodeSourcesInput): ConfigMigrationTransformResult;

package/dist/config-migration/transform-types.d.ts

@@ -0,0 +1,24 @@
+import type { DiscoveredLegacyConfigSource } from "./types";
+export type LoadedLegacyConfigSource = {
+    readonly path: string;
+    readonly value: unknown;
+};
+export type ConfigMigrationTransformResult = {
+    readonly diagnostics: readonly string[];
+    readonly document: Record<string, unknown>;
+};
+export type OpenCodeTransformScope = {
+    readonly kind: "user";
+} | {
+    readonly kind: "project";
+    readonly projectRoot: string;
+};
+export type TransformOpenCodeSourcesInput = {
+    readonly discovered: readonly DiscoveredLegacyConfigSource[];
+    readonly scope: OpenCodeTransformScope;
+    readonly sources: readonly LoadedLegacyConfigSource[];
+};
+export type TransformConfigJsoncSourcesInput = {
+    readonly discovered: readonly DiscoveredLegacyConfigSource[];
+    readonly sources: readonly LoadedLegacyConfigSource[];
+};

package/dist/config-migration/types.d.ts

@@ -0,0 +1,39 @@
+export type ConfigMigrationPathOperations = {
+    readonly basename: (path: string) => string;
+    readonly dirname: (path: string) => string;
+    readonly isAbsolute: (path: string) => boolean;
+    readonly join: (...paths: string[]) => string;
+    readonly normalize: (path: string) => string;
+    readonly relative: (from: string, to: string) => string;
+    readonly resolve: (...paths: string[]) => string;
+};
+export type ConfigMigrationDiscoveryFileSystem = {
+    readonly existsSync: (path: string) => boolean;
+    readonly readdirSync: (path: string) => string[];
+    readonly realpathSync: (path: string) => string;
+};
+export declare const DEFAULT_DISCOVERY_FILE_SYSTEM: ConfigMigrationDiscoveryFileSystem;
+export type LegacyConfigSourceKind = "config-jsonc" | "migration-sidecar" | "profile-config" | "project-config" | "user-config";
+export type DiscoveredLegacyConfigSource = {
+    readonly baseRoot?: string;
+    readonly configPath: string;
+    readonly isActiveProfile?: boolean;
+    readonly kind: LegacyConfigSourceKind;
+    readonly path: string;
+    readonly precedence: number;
+    readonly profile?: string;
+    readonly projectRoot?: string;
+};
+export type LegacyConfigMigrationGroup = {
+    readonly id: string;
+    readonly sources: readonly DiscoveredLegacyConfigSource[];
+};
+export type ConfigMigrationDiscoveryOptions = {
+    readonly cwd: string;
+    readonly environment?: Readonly<Record<string, string | undefined>>;
+    readonly fileSystem?: ConfigMigrationDiscoveryFileSystem;
+    readonly homeDir: string;
+    readonly pathOperations: ConfigMigrationPathOperations;
+    readonly platform?: NodeJS.Platform;
+    readonly tauriConfigDirs?: readonly string[];
+};

package/dist/create-hooks.d.ts

@@ -31,41 +31,6 @@ export declare function createHooks(args: {
     mergedSkills: LoadedSkill[];
     availableSkills: AvailableSkill[];
 }): {
-    disposeHooks: () => void;
-    categorySkillReminder: ReturnType<typeof import("./hooks").createCategorySkillReminderHook> | null;
-    autoSlashCommand: ReturnType<typeof import("./hooks").createAutoSlashCommandHook> | null;
-    stopContinuationGuard: ReturnType<typeof import("./hooks").createStopContinuationGuardHook> | null;
-    compactionContextInjector: ReturnType<typeof import("./hooks").createCompactionContextInjector> | null;
-    compactionTodoPreserver: ReturnType<typeof import("./hooks").createCompactionTodoPreserverHook> | null;
-    todoContinuationEnforcer: ReturnType<typeof import("./hooks").createTodoContinuationEnforcer> | null;
-    unstableAgentBabysitter: ReturnType<typeof import("./plugin/unstable-agent-babysitter").createUnstableAgentBabysitter> | null;
-    backgroundNotificationHook: ReturnType<typeof import("./hooks").createBackgroundNotificationHook> | null;
-    atlasHook: ReturnType<typeof import("./hooks").createAtlasHook> | null;
-    claudeCodeHooks: ReturnType<typeof import("./hooks").createClaudeCodeHooksHook> | null;
-    keywordDetector: ReturnType<typeof import("./hooks").createKeywordDetectorHook> | null;
-    contextInjectorMessagesTransform: ReturnType<typeof import("./features/context-injector").createContextInjectorMessagesTransformHook>;
-    teamModeStatusInjector: ReturnType<typeof import("./hooks").createTeamModeStatusInjector> | null;
-    teamMailboxInjector: ReturnType<typeof import("./hooks").createTeamMailboxInjector> | null;
-    toolPairValidator: ReturnType<typeof import("./hooks").createToolPairValidatorHook> | null;
-    monitorStatusInjector: ReturnType<typeof import("./hooks").createMonitorStatusInjectorHook> | null;
-    commentChecker: ReturnType<typeof import("./hooks").createCommentCheckerHooks> | null;
-    toolOutputTruncator: ReturnType<typeof import("./hooks").createToolOutputTruncatorHook> | null;
-    directoryAgentsInjector: ReturnType<typeof import("./hooks").createDirectoryAgentsInjectorHook> | null;
-    directoryReadmeInjector: ReturnType<typeof import("./hooks").createDirectoryReadmeInjectorHook> | null;
-    emptyTaskResponseDetector: ReturnType<typeof import("./hooks").createEmptyTaskResponseDetectorHook> | null;
-    rulesInjector: ReturnType<typeof import("./hooks").createRulesInjectorHook> | null;
-    tasksTodowriteDisabler: ReturnType<typeof import("./hooks").createTasksTodowriteDisablerHook> | null;
-    writeExistingFileGuard: ReturnType<typeof import("./hooks").createWriteExistingFileGuardHook> | null;
-    bashFileReadGuard: ReturnType<typeof import("./hooks").createBashFileReadGuardHook> | null;
-    hashlineReadEnhancer: ReturnType<typeof import("./hooks").createHashlineReadEnhancerHook> | null;
-    jsonErrorRecovery: ReturnType<typeof import("./hooks").createJsonErrorRecoveryHook> | null;
-    readImageResizer: ReturnType<typeof import("./hooks").createReadImageResizerHook> | null;
-    todoDescriptionOverride: ReturnType<typeof import("./hooks").createTodoDescriptionOverrideHook> | null;
-    webfetchRedirectGuard: ReturnType<typeof import("./hooks").createWebFetchRedirectGuardHook> | null;
-    fsyncSkipWarning: ReturnType<typeof import("./hooks").createFsyncSkipWarningHook> | null;
-    teamToolGating: ReturnType<typeof import("./hooks").createTeamToolGating> | null;
-    notepadWriteGuard: ReturnType<typeof import("./hooks").createNotepadWriteGuardHook> | null;
-    planFormatValidator: ReturnType<typeof import("./hooks").createPlanFormatValidatorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("./hooks").createPreemptiveCompactionHook> | null;
     sessionNotification: ReturnType<typeof import("./hooks").createSessionNotification> | null;
     thinkMode: ReturnType<typeof import("./hooks").createThinkModeHook> | null;
@@ -90,5 +55,40 @@ export declare function createHooks(args: {
     taskResumeInfo: ReturnType<typeof import("./hooks").createTaskResumeInfoHook> | null;
     runtimeFallback: ReturnType<typeof import("./hooks").createRuntimeFallbackHook> | null;
     legacyPluginToast: ReturnType<typeof import("./hooks").createLegacyPluginToastHook> | null;
+    commentChecker: ReturnType<typeof import("./hooks").createCommentCheckerHooks> | null;
+    toolOutputTruncator: ReturnType<typeof import("./hooks").createToolOutputTruncatorHook> | null;
+    directoryAgentsInjector: ReturnType<typeof import("./hooks").createDirectoryAgentsInjectorHook> | null;
+    directoryReadmeInjector: ReturnType<typeof import("./hooks").createDirectoryReadmeInjectorHook> | null;
+    emptyTaskResponseDetector: ReturnType<typeof import("./hooks").createEmptyTaskResponseDetectorHook> | null;
+    rulesInjector: ReturnType<typeof import("./hooks").createRulesInjectorHook> | null;
+    tasksTodowriteDisabler: ReturnType<typeof import("./hooks").createTasksTodowriteDisablerHook> | null;
+    writeExistingFileGuard: ReturnType<typeof import("./hooks").createWriteExistingFileGuardHook> | null;
+    bashFileReadGuard: ReturnType<typeof import("./hooks").createBashFileReadGuardHook> | null;
+    hashlineReadEnhancer: ReturnType<typeof import("./hooks").createHashlineReadEnhancerHook> | null;
+    jsonErrorRecovery: ReturnType<typeof import("./hooks").createJsonErrorRecoveryHook> | null;
+    readImageResizer: ReturnType<typeof import("./hooks").createReadImageResizerHook> | null;
+    todoDescriptionOverride: ReturnType<typeof import("./hooks").createTodoDescriptionOverrideHook> | null;
+    webfetchRedirectGuard: ReturnType<typeof import("./hooks").createWebFetchRedirectGuardHook> | null;
+    fsyncSkipWarning: ReturnType<typeof import("./hooks").createFsyncSkipWarningHook> | null;
+    teamToolGating: ReturnType<typeof import("./hooks").createTeamToolGating> | null;
+    notepadWriteGuard: ReturnType<typeof import("./hooks").createNotepadWriteGuardHook> | null;
+    planFormatValidator: ReturnType<typeof import("./hooks").createPlanFormatValidatorHook> | null;
+    claudeCodeHooks: ReturnType<typeof import("./hooks").createClaudeCodeHooksHook> | null;
+    keywordDetector: ReturnType<typeof import("./hooks").createKeywordDetectorHook> | null;
+    contextInjectorMessagesTransform: ReturnType<typeof import("./features/context-injector").createContextInjectorMessagesTransformHook>;
+    teamModeStatusInjector: ReturnType<typeof import("./hooks").createTeamModeStatusInjector> | null;
+    teamMailboxInjector: ReturnType<typeof import("./hooks").createTeamMailboxInjector> | null;
+    toolPairValidator: ReturnType<typeof import("./hooks").createToolPairValidatorHook> | null;
+    monitorStatusInjector: ReturnType<typeof import("./hooks").createMonitorStatusInjectorHook> | null;
+    stopContinuationGuard: ReturnType<typeof import("./hooks").createStopContinuationGuardHook> | null;
+    compactionContextInjector: ReturnType<typeof import("./hooks").createCompactionContextInjector> | null;
+    compactionTodoPreserver: ReturnType<typeof import("./hooks").createCompactionTodoPreserverHook> | null;
+    todoContinuationEnforcer: ReturnType<typeof import("./hooks").createTodoContinuationEnforcer> | null;
+    unstableAgentBabysitter: ReturnType<typeof import("./plugin/unstable-agent-babysitter").createUnstableAgentBabysitter> | null;
+    backgroundNotificationHook: ReturnType<typeof import("./hooks").createBackgroundNotificationHook> | null;
+    atlasHook: ReturnType<typeof import("./hooks").createAtlasHook> | null;
+    categorySkillReminder: ReturnType<typeof import("./hooks").createCategorySkillReminderHook> | null;
+    autoSlashCommand: ReturnType<typeof import("./hooks").createAutoSlashCommandHook> | null;
+    disposeHooks: () => void;
 };
 export {};

package/dist/features/background-agent/spawner/tmux-callback-invoker.d.ts

@@ -0,0 +1,11 @@
+import type { OnSubagentSessionCreated } from "../constants";
+export interface TmuxCallbackInvocation {
+    callback: OnSubagentSessionCreated | undefined;
+    tmuxEnabled: boolean;
+    suppress: boolean;
+    sessionID: string;
+    parentID: string;
+    title: string;
+    log: (message: string, data?: unknown) => void;
+}
+export declare function invokeTmuxSessionCreatedCallback(invocation: TmuxCallbackInvocation): void;

package/dist/features/builtin-commands/templates/hyperplan.d.ts

@@ -1 +1 @@
-export declare const HYPERPLAN_TEMPLATE = "You are running the `/hyperplan` command \u2014 adversarial multi-agent planning via team-mode.\n\nLOAD THE HYPERPLAN SKILL IMMEDIATELY:\n\n```\nskill(name=\"hyperplan\")\n```\n\nAfter loading the skill, follow its 7-phase workflow EXACTLY using this user request.\n\nRoster contract: call `team_create` with category members `unspecified-low`, `unspecified-high`, `ultrabrain`, and `artistry`. Include `deep` only if the category is enabled; if `deep` is disabled or unavailable, retry without only that member and state the degraded roster.\n\n<user-request>\n$ARGUMENTS\n</user-request>\n\nIf team-mode is unavailable (`team_*` tools missing), instruct the user to set `team_mode.enabled: true` in `~/.config/opencode/oh-my-opencode.jsonc` and restart opencode.";
+export declare const HYPERPLAN_TEMPLATE = "You are running the `/hyperplan` command \u2014 adversarial multi-agent planning via team-mode.\n\nLOAD THE HYPERPLAN SKILL IMMEDIATELY:\n\n```\nskill(name=\"hyperplan\")\n```\n\nAfter loading the skill, follow its 7-phase workflow EXACTLY using this user request.\n\nRoster contract: call `team_create` with category members `unspecified-low`, `unspecified-high`, `ultrabrain`, and `artistry`. Include `deep` only if the category is enabled; if `deep` is disabled or unavailable, retry without only that member and state the degraded roster.\n\n<user-request>\n$ARGUMENTS\n</user-request>\n\nIf team-mode is unavailable (`team_*` tools missing), instruct the user to set `team_mode.enabled: true` in `~/.omo/omo.jsonc` and restart opencode.";

package/dist/features/builtin-commands/templates/start-work.d.ts

@@ -1 +1 @@
-export declare const START_WORK_TEMPLATE = "You are starting an Atlas work session.\n\n## ARGUMENTS\n\n- `/start-work [plan-name] [--worktree <path>]`\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\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 `/start-work {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## TASK BREAKDOWN (MANDATORY)\n\nAfter reading the plan file, you MUST decompose every plan task into granular, implementation-level sub-steps and register ALL of them as task/todo items BEFORE starting any work.\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. Skip merge only if the user explicitly instructs otherwise (e.g., asks to create a PR instead).";
+export declare const START_WORK_TEMPLATE = "You are starting an Atlas work session.\n\n## ARGUMENTS\n\n- `/start-work [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 `/start-work {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/start-work/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/claude-tasks/types.d.ts

@@ -1,9 +1,9 @@
 import { z } from "zod";
 export declare const TaskStatusSchema: z.ZodEnum<{
-    deleted: "deleted";
     completed: "completed";
-    pending: "pending";
+    deleted: "deleted";
     in_progress: "in_progress";
+    pending: "pending";
 }>;
 export type TaskStatus = z.infer<typeof TaskStatusSchema>;
 export declare const TaskSchema: z.ZodObject<{
@@ -11,10 +11,10 @@ export declare const TaskSchema: z.ZodObject<{
     subject: z.ZodString;
     description: z.ZodString;
     status: z.ZodEnum<{
-        deleted: "deleted";
         completed: "completed";
-        pending: "pending";
+        deleted: "deleted";
         in_progress: "in_progress";
+        pending: "pending";
     }>;
     activeForm: z.ZodOptional<z.ZodString>;
     blocks: z.ZodArray<z.ZodString>;

package/dist/features/team-mode/team-runtime/shutdown-helpers.d.ts

@@ -1,5 +1,5 @@
 import type { Message, RuntimeState } from "../types";
-export declare const DELETABLE_MEMBER_STATUSES: Set<"running" | "completed" | "pending" | "idle" | "shutdown_approved" | "errored">;
+export declare const DELETABLE_MEMBER_STATUSES: Set<"completed" | "errored" | "idle" | "pending" | "running" | "shutdown_approved">;
 export declare function createShutdownMessage(from: string, to: string, kind: Message["kind"], body: string): Message;
 export declare function getRuntimeMember(runtimeState: RuntimeState, memberName: string): RuntimeState["members"][number];
 export declare function getLeadMemberName(runtimeState: RuntimeState): string;

package/dist/features/team-mode/team-runtime/shutdown-test-fixtures.d.ts

@@ -17,14 +17,14 @@ export declare function readInboxMessages(teamRunId: string, memberName: string,
     messageId: string;
     from: string;
     to: string;
-    kind: "message" | "shutdown_request" | "shutdown_approved" | "shutdown_rejected" | "announcement";
+    kind: "announcement" | "message" | "shutdown_approved" | "shutdown_rejected" | "shutdown_request";
     body: string;
-    timestamp: number;
     summary?: string | undefined;
     references?: {
         path: string;
         description?: string | undefined;
     }[] | undefined;
+    timestamp: number;
     correlationId?: string | undefined;
     color?: string | undefined;
 }[]>;
@@ -33,14 +33,14 @@ export declare function createTestMessage(overrides?: Partial<Parameters<typeof
     messageId: string;
     from: string;
     to: string;
-    kind: "message" | "shutdown_request" | "shutdown_approved" | "shutdown_rejected" | "announcement";
+    kind: "announcement" | "message" | "shutdown_approved" | "shutdown_rejected" | "shutdown_request";
     body: string;
-    timestamp: number;
     summary?: string | undefined;
     references?: {
         path: string;
         description?: string | undefined;
     }[] | undefined;
+    timestamp: number;
     correlationId?: string | undefined;
     color?: string | undefined;
 };

package/dist/features/team-mode/tools/lifecycle-test-fixture.d.ts

@@ -11,17 +11,23 @@ export declare const createTeamRunMock: import("bun:test").Mock<(spec: TeamSpec,
     version: 1;
     teamRunId: string;
     teamName: string;
-    specSource: "user" | "project";
+    specSource: "project" | "user";
     createdAt: number;
-    status: "failed" | "deleted" | "active" | "creating" | "shutdown_requested" | "deleting" | "orphaned";
+    status: "active" | "creating" | "deleted" | "deleting" | "failed" | "orphaned" | "shutdown_requested";
+    leadSessionId?: string | undefined;
+    tmuxLayout?: {
+        ownedSession: boolean;
+        targetSessionId: string;
+        focusWindowId?: string | undefined;
+        gridWindowId?: string | undefined;
+        paneIds?: string[] | undefined;
+    } | undefined;
     members: {
         name: string;
-        agentType: "leader" | "general-purpose";
-        status: "running" | "completed" | "pending" | "idle" | "shutdown_approved" | "errored";
-        pendingInjectedMessageIds: string[];
         sessionId?: string | undefined;
         tmuxPaneId?: string | undefined;
         tmuxGridPaneId?: string | undefined;
+        agentType: "general-purpose" | "leader";
         subagent_type?: string | undefined;
         category?: string | undefined;
         model?: {
@@ -33,13 +39,15 @@ export declare const createTeamRunMock: import("bun:test").Mock<(spec: TeamSpec,
             top_p?: number | undefined;
             maxTokens?: number | undefined;
             thinking?: {
-                type: "enabled" | "disabled";
+                type: "disabled" | "enabled";
                 budgetTokens?: number | undefined;
             } | undefined;
         } | undefined;
+        status: "completed" | "errored" | "idle" | "pending" | "running" | "shutdown_approved";
         color?: string | undefined;
         worktreePath?: string | undefined;
         lastInjectedTurnMarker?: string | undefined;
+        pendingInjectedMessageIds: string[];
     }[];
     shutdownRequests: {
         memberId: string;
@@ -56,14 +64,6 @@ export declare const createTeamRunMock: import("bun:test").Mock<(spec: TeamSpec,
         maxWallClockMinutes: number;
         maxMemberTurns: number;
     };
-    leadSessionId?: string | undefined;
-    tmuxLayout?: {
-        ownedSession: boolean;
-        targetSessionId: string;
-        focusWindowId?: string | undefined;
-        gridWindowId?: string | undefined;
-        paneIds?: string[] | undefined;
-    } | undefined;
 }>>;
 export declare const deleteTeamMock: import("bun:test").Mock<(teamRunId: string, _config?: unknown, _tmuxMgr?: unknown, _bgMgr?: unknown, options?: {
     force?: boolean;
@@ -77,57 +77,63 @@ export declare const rejectShutdownMock: import("bun:test").Mock<(teamRunId: str
 export declare const loadTeamSpecMock: import("bun:test").Mock<() => Promise<{
     version: 1;
     name: string;
+    description?: string | undefined;
     createdAt: number;
+    leadAgentId?: string | undefined;
+    teamAllowedPaths?: string[] | undefined;
+    sessionPermission?: string | undefined;
     members: ({
         name: string;
+        cwd?: string | undefined;
+        worktreePath?: string | undefined;
+        subscriptions?: string[] | undefined;
         backendType: "in-process" | "tmux";
+        color?: string | undefined;
         isActive: boolean;
         kind: "category";
         category: string;
         prompt: string;
+    } | {
+        name: string;
         cwd?: string | undefined;
         worktreePath?: string | undefined;
         subscriptions?: string[] | undefined;
-        color?: string | undefined;
-    } | {
-        name: string;
         backendType: "in-process" | "tmux";
+        color?: string | undefined;
         isActive: boolean;
         kind: "subagent_type";
         subagent_type: string;
-        cwd?: string | undefined;
-        worktreePath?: string | undefined;
-        subscriptions?: string[] | undefined;
-        color?: string | undefined;
         prompt?: string | undefined;
     })[];
-    description?: string | undefined;
-    leadAgentId?: string | undefined;
-    teamAllowedPaths?: string[] | undefined;
-    sessionPermission?: string | undefined;
 }>>;
 export declare const listActiveTeamsMock: import("bun:test").Mock<() => Promise<{
     teamRunId: string;
     teamName: string;
-    status: "failed" | "deleted" | "active" | "creating" | "shutdown_requested" | "deleting" | "orphaned";
+    status: "active" | "creating" | "deleted" | "deleting" | "failed" | "orphaned" | "shutdown_requested";
     memberCount: number;
-    scope: "user" | "project";
+    scope: "project" | "user";
 }[]>>;
 export declare const loadRuntimeStateMock: import("bun:test").Mock<(teamRunId: string) => Promise<{
     version: 1;
     teamRunId: string;
     teamName: string;
-    specSource: "user" | "project";
+    specSource: "project" | "user";
     createdAt: number;
-    status: "failed" | "deleted" | "active" | "creating" | "shutdown_requested" | "deleting" | "orphaned";
+    status: "active" | "creating" | "deleted" | "deleting" | "failed" | "orphaned" | "shutdown_requested";
+    leadSessionId?: string | undefined;
+    tmuxLayout?: {
+        ownedSession: boolean;
+        targetSessionId: string;
+        focusWindowId?: string | undefined;
+        gridWindowId?: string | undefined;
+        paneIds?: string[] | undefined;
+    } | undefined;
     members: {
         name: string;
-        agentType: "leader" | "general-purpose";
-        status: "running" | "completed" | "pending" | "idle" | "shutdown_approved" | "errored";
-        pendingInjectedMessageIds: string[];
         sessionId?: string | undefined;
         tmuxPaneId?: string | undefined;
         tmuxGridPaneId?: string | undefined;
+        agentType: "general-purpose" | "leader";
         subagent_type?: string | undefined;
         category?: string | undefined;
         model?: {
@@ -139,13 +145,15 @@ export declare const loadRuntimeStateMock: import("bun:test").Mock<(teamRunId: s
             top_p?: number | undefined;
             maxTokens?: number | undefined;
             thinking?: {
-                type: "enabled" | "disabled";
+                type: "disabled" | "enabled";
                 budgetTokens?: number | undefined;
             } | undefined;
         } | undefined;
+        status: "completed" | "errored" | "idle" | "pending" | "running" | "shutdown_approved";
         color?: string | undefined;
         worktreePath?: string | undefined;
         lastInjectedTurnMarker?: string | undefined;
+        pendingInjectedMessageIds: string[];
     }[];
     shutdownRequests: {
         memberId: string;
@@ -162,14 +170,6 @@ export declare const loadRuntimeStateMock: import("bun:test").Mock<(teamRunId: s
         maxWallClockMinutes: number;
         maxMemberTurns: number;
     };
-    leadSessionId?: string | undefined;
-    tmuxLayout?: {
-        ownedSession: boolean;
-        targetSessionId: string;
-        focusWindowId?: string | undefined;
-        gridWindowId?: string | undefined;
-        paneIds?: string[] | undefined;
-    } | undefined;
 }>>;
 export declare const config: {
     enabled: boolean;
@@ -179,10 +179,10 @@ export declare const config: {
     max_messages_per_run: number;
     max_wall_clock_minutes: number;
     max_member_turns: number;
+    base_dir?: string | undefined;
     message_payload_max_bytes: number;
     recipient_unread_max_bytes: number;
     mailbox_poll_interval_ms: number;
-    base_dir?: string | undefined;
 };
 export declare const mockClient: OpencodeClient;
 export declare const backgroundManager: BackgroundManager;

package/dist/features/tmux-subagent/environment-eligibility.d.ts

@@ -0,0 +1,2 @@
+import type { TmuxConfig } from "../../config/schema";
+export declare function selectTmuxManagerEnvironmentPredicate(isolation: TmuxConfig["isolation"]): () => boolean;

package/dist/features/tmux-subagent/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./manager";
+export * from "./environment-eligibility";
 export * from "./event-handlers";
 export * from "./polling";
 export * from "./session-created-event";

package/dist/features/tmux-subagent/tracked-session-state.d.ts

@@ -4,5 +4,6 @@ export declare function createTrackedSession(params: {
     paneId: string;
     description: string;
     now?: Date;
+    attachActivated?: boolean;
 }): TrackedSession;
 export declare function markTrackedSessionClosePending(tracked: TrackedSession): TrackedSession;