oh-my-opencode 4.0.0 → 4.1.1

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

@@ -52,6 +52,7 @@ export declare const HookNameSchema: z.ZodEnum<{
     "read-image-resizer": "read-image-resizer";
     "todo-description-override": "todo-description-override";
     "webfetch-redirect-guard": "webfetch-redirect-guard";
+    "fsync-skip-warning": "fsync-skip-warning";
     "legacy-plugin-toast": "legacy-plugin-toast";
 }>;
 export type HookName = z.infer<typeof HookNameSchema>;

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

@@ -3,6 +3,7 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
     new_task_system_enabled: z.ZodOptional<z.ZodBoolean>;
     default_run_agent: z.ZodOptional<z.ZodString>;
+    agent_order: z.ZodOptional<z.ZodArray<z.ZodString>>;
     agent_definitions: z.ZodOptional<z.ZodArray<z.ZodString>>;
     disabled_mcps: z.ZodOptional<z.ZodArray<z.ZodString>>;
     disabled_agents: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/create-hooks.d.ts

@@ -60,6 +60,7 @@ export declare function createHooks(args: {
     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;
     contextWindowMonitor: ReturnType<typeof import("./hooks").createContextWindowMonitorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("./hooks").createPreemptiveCompactionHook> | null;

package/dist/create-managers.d.ts

@@ -3,6 +3,7 @@ import type { ModelCacheState } from "./plugin-state";
 import type { PluginContext, TmuxConfig } from "./plugin/types";
 import { BackgroundManager } from "./features/background-agent";
 import { SkillMcpManager } from "./features/skill-mcp-manager";
+import { cleanupSessionTeamRuns } from "./features/team-mode/team-runtime/session-cleanup";
 import { initTaskToastManager } from "./features/task-toast-manager";
 import { TmuxSessionManager } from "./features/tmux-subagent";
 import { registerManagerForCleanup } from "./features/background-agent/process-cleanup";
@@ -15,6 +16,7 @@ type CreateManagersDeps = {
     TmuxSessionManagerClass: typeof TmuxSessionManager;
     initTaskToastManagerFn: typeof initTaskToastManager;
     registerManagerForCleanupFn: typeof registerManagerForCleanup;
+    cleanupSessionTeamRunsFn: typeof cleanupSessionTeamRuns;
     createConfigHandlerFn: typeof createConfigHandler;
     markServerRunningInProcessFn: typeof markServerRunningInProcess;
 };

package/dist/features/background-agent/manager.d.ts

@@ -9,6 +9,7 @@ interface EventProperties {
     sessionID?: string;
     info?: {
         id?: string;
+        sessionID?: string;
     };
     [key: string]: unknown;
 }
@@ -51,9 +52,12 @@ export declare class BackgroundManager {
     private queuesByKey;
     private processingKeys;
     private completionTimers;
+    private completedTaskArchive;
     private completedTaskSummaries;
     private idleDeferralTimers;
     private notificationQueueByParent;
+    private pendingParentWakes;
+    private pendingParentWakeTimers;
     private observedOutputSessions;
     private observedIncompleteTodosBySession;
     private rootDescendantCounts;
@@ -80,6 +84,7 @@ export declare class BackgroundManager {
     private rollbackPreStartDescendantReservation;
     private addTask;
     private removeTask;
+    private archiveCompletedTask;
     private updateTaskParent;
     private removeTaskFromParentIndex;
     launch(input: LaunchInput): Promise<BackgroundTask>;
@@ -167,6 +172,11 @@ export declare class BackgroundManager {
      */
     private tryCompleteTask;
     private notifyParentSession;
+    private isSessionActive;
+    private queuePendingParentWake;
+    private flushPendingParentWake;
+    private schedulePendingParentWakeFlush;
+    private clearPendingParentWakeTimer;
     private hasRunningTasks;
     private pruneStaleTasksAndNotifications;
     private checkAndInterruptStaleTasks;

package/dist/features/background-agent/spawner.d.ts

@@ -3,7 +3,9 @@ import type { OpencodeClient, OnSubagentSessionCreated, QueueItem } from "./cons
 import type { ConcurrencyManager } from "./concurrency";
 export declare const FALLBACK_AGENT = "general";
 export declare function isAgentNotFoundError(error: unknown): boolean;
-export declare function buildFallbackBody(originalBody: Record<string, unknown>, fallbackAgent: string): Record<string, unknown>;
+export declare function buildFallbackBody(originalBody: Record<string, unknown>, fallbackAgent: string, options?: {
+    includeTeamToolDenylist?: boolean;
+}): Record<string, unknown>;
 export interface SpawnerContext {
     client: OpencodeClient;
     directory: string;
@@ -14,4 +16,4 @@ export interface SpawnerContext {
 }
 export declare function createTask(input: LaunchInput): BackgroundTask;
 export declare function startTask(item: QueueItem, ctx: SpawnerContext): Promise<void>;
-export declare function resumeTask(task: BackgroundTask, input: ResumeInput, ctx: Pick<SpawnerContext, "client" | "concurrencyManager" | "onTaskError">): Promise<void>;
+export declare function resumeTask(task: BackgroundTask, input: ResumeInput, ctx: Pick<SpawnerContext, "client" | "concurrencyManager" | "directory" | "onTaskError">): Promise<void>;

package/dist/features/background-agent/task-poller.d.ts

@@ -7,6 +7,7 @@ export declare function pruneStaleTasksAndNotifications(args: {
     notifications: Map<string, BackgroundTask[]>;
     onTaskPruned: (taskId: string, task: BackgroundTask, errorMessage: string) => void;
     taskTtlMs?: number;
+    sessionStatuses?: SessionStatusMap;
 }): void;
 export type SessionStatusMap = Record<string, {
     type: string;

package/dist/features/background-agent/types.d.ts

@@ -68,6 +68,7 @@ export interface BackgroundTask {
     isUnstableAgent?: boolean;
     /** Category used for this task (e.g., 'quick', 'visual-engineering') */
     category?: string;
+    onSessionCreated?: (sessionId: string) => void | Promise<void>;
     /** Pending retry notification details for the next spawned retry session */
     retryNotification?: {
         previousSessionID?: string;

package/dist/features/boulder-state/format-duration.d.ts

@@ -0,0 +1 @@
+export declare function formatDurationHuman(milliseconds: number): string;

package/dist/features/boulder-state/index.d.ts

@@ -2,3 +2,4 @@ export * from "./types";
 export * from "./constants";
 export * from "./storage";
 export * from "./top-level-task";
+export * from "./format-duration";

package/dist/features/boulder-state/storage.d.ts

@@ -3,7 +3,7 @@
  *
  * Handles reading/writing boulder.json for active plan tracking.
  */
-import type { BoulderState, PlanProgress, TaskSessionState } from "./types";
+import type { BoulderSessionOrigin, BoulderState, BoulderWorkResumeOption, BoulderWorkState, PlanProgress, TaskSessionState } from "./types";
 export declare function getBoulderFilePath(directory: string): string;
 export declare function resolveBoulderPlanPath(directory: string, state: Pick<BoulderState, "active_plan" | "worktree_path">): string;
 export declare function readBoulderState(directory: string): BoulderState | null;
@@ -43,3 +43,41 @@ export declare function getPlanName(planPath: string): string;
  * Create a new boulder state for a plan.
  */
 export declare function createBoulderState(planPath: string, sessionId: string, agent?: string, worktreePath?: string): BoulderState;
+export declare function generateWorkId(planName: string): string;
+export declare function getBoulderWorks(state: BoulderState): BoulderWorkState[];
+export declare function getActiveWorks(directory: string): BoulderWorkState[];
+export declare function getWorkById(directory: string, workId: string): BoulderWorkState | null;
+export declare function getWorkByPlanName(directory: string, planName: string, options?: {
+    worktreePath?: string;
+}): BoulderWorkState | null;
+export declare function getWorkForSession(directory: string, sessionId: string): BoulderWorkState | null;
+export declare function resolveBoulderPlanPathForWork(directory: string, work: Pick<BoulderWorkState, "active_plan" | "worktree_path">): string;
+export declare function getWorkResumeOptions(directory: string): BoulderWorkResumeOption[];
+export declare function selectActiveWork(directory: string, workId: string): BoulderState | null;
+export declare function addBoulderWork(directory: string, input: {
+    planPath: string;
+    sessionId: string;
+    agent?: string;
+    worktreePath?: string;
+    startedAt?: string;
+}): BoulderState | null;
+export declare function appendSessionIdForWork(directory: string, workId: string, sessionId: string, origin?: BoulderSessionOrigin): BoulderState | null;
+export declare function upsertTaskSessionStateForWork(directory: string, workId: string, input: {
+    taskKey: string;
+    taskLabel: string;
+    taskTitle: string;
+    sessionId: string;
+    agent?: string;
+    category?: string;
+}): BoulderState | null;
+export declare function startTaskTimer(directory: string, workId: string, input: {
+    taskKey: string;
+    taskLabel: string;
+    taskTitle: string;
+    sessionId: string;
+    agent?: string;
+    category?: string;
+    startedAt?: string;
+}): BoulderState | null;
+export declare function endTaskTimer(directory: string, workId: string, taskKey: string, endedAt?: string): BoulderState | null;
+export declare function completeBoulder(directory: string, workId?: string, endedAt?: string): BoulderState | null;

package/dist/features/boulder-state/types.d.ts

@@ -5,10 +5,17 @@
  * Named after Sisyphus's boulder - the eternal task that must be rolled.
  */
 export interface BoulderState {
+    schema_version?: 2;
+    active_work_id?: string;
+    works?: Record<string, BoulderWorkState>;
     /** Absolute path to the active plan file */
     active_plan: string;
     /** ISO timestamp when work started */
     started_at: string;
+    ended_at?: string;
+    elapsed_ms?: number;
+    status?: BoulderWorkStatus;
+    updated_at?: string;
     /** Session IDs that have worked on this plan */
     session_ids: string[];
     session_origins?: Record<string, "direct" | "appended">;
@@ -21,6 +28,24 @@ export interface BoulderState {
     /** Preferred reusable subagent sessions keyed by current top-level plan task */
     task_sessions?: Record<string, TaskSessionState>;
 }
+export type BoulderSessionOrigin = "direct" | "appended";
+export type BoulderWorkStatus = "active" | "completed" | "paused" | "abandoned";
+export type BoulderTaskStatus = "running" | "completed" | "cancelled";
+export interface BoulderWorkState {
+    work_id: string;
+    active_plan: string;
+    plan_name: string;
+    status?: BoulderWorkStatus;
+    started_at: string;
+    ended_at?: string;
+    elapsed_ms?: number;
+    updated_at?: string;
+    session_ids: string[];
+    session_origins?: Record<string, BoulderSessionOrigin>;
+    agent?: string;
+    worktree_path?: string;
+    task_sessions?: Record<string, TaskSessionState>;
+}
 export interface PlanProgress {
     /** Total number of checkboxes */
     total: number;
@@ -42,9 +67,27 @@ export interface TaskSessionState {
     agent?: string;
     /** Category associated with the task session, when known */
     category?: string;
+    started_at?: string;
+    ended_at?: string;
+    elapsed_ms?: number;
+    status?: BoulderTaskStatus;
     /** Last update timestamp */
     updated_at: string;
 }
+export interface BoulderWorkResumeOption {
+    work_id: string;
+    plan_name: string;
+    active_plan: string;
+    worktree_path?: string;
+    status: BoulderWorkStatus;
+    started_at: string;
+    updated_at: string;
+    ended_at?: string;
+    elapsed_ms?: number;
+    session_count: number;
+    progress: PlanProgress;
+    is_current_mirror: boolean;
+}
 export interface TopLevelTaskRef {
     /** Stable identifier for the current top-level plan task */
     key: string;

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

@@ -1 +1 @@
-export declare const START_WORK_TEMPLATE = "You are starting a Sisyphus 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 `.sisyphus/plans/`\n\n2. **Check for active boulder state**: Read `.sisyphus/boulder.json` if it exists\n\n3. **Decision logic**:\n   - If `.sisyphus/boulder.json` exists AND plan is NOT complete (has unchecked boxes):\n     - **APPEND** current session to session_ids\n     - Continue work on existing plan\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 .sisyphus state back**: Copy `.sisyphus/` from the worktree to the main repo before removal.\n   This is CRITICAL when `.sisyphus/` is gitignored - state written during worktree execution would otherwise be lost.\n   ```bash\n   cp -r <worktree-path>/.sisyphus/* <main-repo>/.sisyphus/ 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 a Sisyphus 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 `.sisyphus/plans/`\n\n2. **Check for active boulder state**: Read `.sisyphus/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 .sisyphus state back**: Copy `.sisyphus/` from the worktree to the main repo before removal.\n   This is CRITICAL when `.sisyphus/` is gitignored - state written during worktree execution would otherwise be lost.\n   ```bash\n   cp -r <worktree-path>/.sisyphus/* <main-repo>/.sisyphus/ 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).";

package/dist/features/team-mode/team-runtime/session-cleanup.d.ts

@@ -0,0 +1,21 @@
+import type { TeamModeConfig } from "../../../config/schema/team-mode";
+import { log } from "../../../shared/logger";
+import type { BackgroundManager } from "../../background-agent/manager";
+import type { TmuxSessionManager } from "../../tmux-subagent/manager";
+import { deleteTeam } from "./delete-team";
+export { clearSessionTeamRunCleanupRegistry, getSessionCreatedTeamRunIds, registerTeamRunForSessionCleanup, unregisterTeamRunForSessionCleanup, } from "./session-team-run-registry";
+export type SessionTeamCleanupReport = {
+    cleanedTeamRunIds: string[];
+    removedLayoutTeamRunIds: string[];
+    errors: string[];
+};
+export type SessionTeamCleanupDeps = {
+    deleteTeam: typeof deleteTeam;
+    log: typeof log;
+};
+export declare function cleanupSessionTeamRuns(args: {
+    config: TeamModeConfig;
+    tmuxMgr?: TmuxSessionManager;
+    bgMgr?: BackgroundManager;
+    deps?: SessionTeamCleanupDeps;
+}): Promise<SessionTeamCleanupReport>;

package/dist/features/team-mode/team-runtime/session-team-run-registry.d.ts

@@ -0,0 +1,4 @@
+export declare function registerTeamRunForSessionCleanup(teamRunId: string): void;
+export declare function unregisterTeamRunForSessionCleanup(teamRunId: string): void;
+export declare function getSessionCreatedTeamRunIds(): string[];
+export declare function clearSessionTeamRunCleanupRegistry(): void;

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

@@ -0,0 +1,10 @@
+import type { TmuxConfig } from "../../config/schema";
+import type { TrackedSession } from "./types";
+export declare function cleanupTmuxSessions(params: {
+    tmuxConfig: TmuxConfig;
+    directory: string;
+    serverUrl: string;
+    sourcePaneId: string | undefined;
+    sessions: Map<string, TrackedSession>;
+    stopPolling: () => void;
+}): Promise<void>;

package/dist/features/tmux-subagent/session-created-handler.d.ts

@@ -0,0 +1,23 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { TmuxConfig } from "../../config/schema";
+import type { CapacityConfig, TrackedSession } from "./types";
+import { type SessionMapping } from "./decision-engine";
+import type { SessionCreatedEvent } from "./session-created-event";
+type OpencodeClient = PluginInput["client"];
+export interface SessionCreatedHandlerDeps {
+    client: OpencodeClient;
+    tmuxConfig: TmuxConfig;
+    directory: string;
+    serverUrl: string;
+    sourcePaneId: string | undefined;
+    sessions: Map<string, TrackedSession>;
+    pendingSessions: Set<string>;
+    isInsideTmux: () => boolean;
+    isEnabled: () => boolean;
+    getCapacityConfig: () => CapacityConfig;
+    getSessionMappings: () => SessionMapping[];
+    waitForSessionReady: (sessionId: string) => Promise<boolean>;
+    startPolling: () => void;
+}
+export declare function handleSessionCreated(deps: SessionCreatedHandlerDeps, event: SessionCreatedEvent): Promise<void>;
+export {};

package/dist/features/tmux-subagent/session-deleted-handler.d.ts

@@ -0,0 +1,16 @@
+import type { TmuxConfig } from "../../config/schema";
+import type { TrackedSession } from "./types";
+import { type SessionMapping } from "./decision-engine";
+export interface SessionDeletedHandlerDeps {
+    tmuxConfig: TmuxConfig;
+    directory: string;
+    serverUrl: string;
+    sourcePaneId: string | undefined;
+    sessions: Map<string, TrackedSession>;
+    isEnabled: () => boolean;
+    getSessionMappings: () => SessionMapping[];
+    stopPolling: () => void;
+}
+export declare function handleSessionDeleted(deps: SessionDeletedHandlerDeps, event: {
+    sessionID: string;
+}): Promise<void>;

package/dist/hooks/atlas/boulder-continuation-injector.d.ts

@@ -1,6 +1,6 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 import type { BackgroundTaskStatusProvider, SessionState } from "./types";
-export type BoulderContinuationResult = "injected" | "skipped_background_tasks" | "skipped_agent_unavailable" | "failed";
+export type BoulderContinuationResult = "injected" | "skipped_active_session" | "skipped_background_tasks" | "skipped_agent_unavailable" | "failed";
 export declare function injectBoulderContinuation(input: {
     ctx: PluginInput;
     sessionID: string;

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

@@ -1,5 +1,6 @@
 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 session with `session_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;

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

@@ -5,6 +5,7 @@ export declare function createToolExecuteAfterHandler(input: {
     ctx: PluginInput;
     pendingFilePaths: Map<string, string>;
     pendingTaskRefs: Map<string, PendingTaskRef>;
+    pendingPlanSnapshots?: Map<string, string>;
     autoCommit: boolean;
     getState: (sessionID: string) => SessionState;
     isCallerOrchestrator?: (sessionID: string | undefined) => Promise<boolean>;

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

@@ -4,6 +4,7 @@ export declare function createToolExecuteBeforeHandler(input: {
     ctx: PluginInput;
     pendingFilePaths: Map<string, string>;
     pendingTaskRefs: Map<string, PendingTaskRef>;
+    pendingPlanSnapshots?: Map<string, string>;
     isCallerOrchestrator?: (sessionID: string | undefined) => Promise<boolean>;
 }): (toolInput: {
     tool: string;

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

@@ -16,6 +16,7 @@ export interface AtlasHookOptions {
     isContinuationStopped?: (sessionID: string) => boolean;
     isCallerOrchestrator?: (sessionID: string | undefined) => Promise<boolean>;
     agentOverrides?: AgentOverrides;
+    idleSettleMs?: number;
     /** Enable auto-commit after each atomic task completion (default: true) */
     autoCommit?: boolean;
 }
@@ -52,4 +53,5 @@ export interface SessionState {
     waitingForFinalWaveApproval?: boolean;
     pendingFinalWaveTaskCount?: number;
     approvedFinalWaveTaskCount?: number;
+    boulderCompletionNudgedAt?: Record<string, number>;
 }

package/dist/hooks/compaction-context-injector/recovery.d.ts

@@ -1,6 +1,6 @@
 import type { CompactionContextClient } from "./types";
 import type { TailMonitorState } from "./tail-monitor";
 export declare function createRecoveryLogic(ctx: CompactionContextClient | undefined, getTailState: (sessionID: string) => TailMonitorState): {
-    recoverCheckpointedAgentConfig: (sessionID: string, reason: "session.compacted" | "no-text-tail") => Promise<boolean>;
+    recoverCheckpointedAgentConfig: (sessionID: string, reason: "compaction.autocontinue" | "session.compacted" | "no-text-tail") => Promise<boolean>;
     maybeWarnAboutNoTextTail: (sessionID: string) => Promise<void>;
 };

package/dist/hooks/compaction-context-injector/types.d.ts

@@ -1,5 +1,6 @@
 export interface CompactionContextInjector {
     capture: (sessionID: string) => Promise<void>;
+    restore: (sessionID: string) => Promise<boolean>;
     inject: (sessionID?: string) => string;
     event: (input: {
         event: {

package/dist/hooks/compaction-todo-preserver/hook.d.ts

@@ -1,11 +1,22 @@
 import type { PluginInput } from "@opencode-ai/plugin";
+type ToolExecuteBeforeInput = {
+    tool: string;
+    sessionID: string;
+    callID: string;
+};
+type ToolExecuteBeforeOutput = {
+    args: Record<string, unknown>;
+};
 export interface CompactionTodoPreserver {
     capture: (sessionID: string) => Promise<void>;
+    restore: (sessionID: string) => Promise<void>;
     event: (input: {
         event: {
             type: string;
             properties?: unknown;
         };
     }) => Promise<void>;
+    "tool.execute.before": (input: ToolExecuteBeforeInput, output: ToolExecuteBeforeOutput) => Promise<void>;
 }
 export declare function createCompactionTodoPreserverHook(ctx: PluginInput): CompactionTodoPreserver;
+export {};

package/dist/hooks/fsync-skip-warning/index.d.ts

@@ -0,0 +1,18 @@
+type ToolExecuteInput = {
+    tool: string;
+    sessionID: string;
+    callID: string;
+};
+type ToolBeforeOutput = {
+    args: Record<string, unknown>;
+};
+type ToolAfterOutput = {
+    title: string;
+    output: string;
+    metadata: unknown;
+};
+export declare function createFsyncSkipWarningHook(): {
+    "tool.execute.before": (input: ToolExecuteInput, _output: ToolBeforeOutput) => Promise<void>;
+    "tool.execute.after": (input: ToolExecuteInput, output: ToolAfterOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/index.d.ts

@@ -55,3 +55,4 @@ export { createReadImageResizerHook } from "./read-image-resizer";
 export { createTodoDescriptionOverrideHook } from "./todo-description-override";
 export { createWebFetchRedirectGuardHook } from "./webfetch-redirect-guard";
 export { createLegacyPluginToastHook } from "./legacy-plugin-toast";
+export { createFsyncSkipWarningHook } from "./fsync-skip-warning";

package/dist/hooks/ralph-loop/continuation-prompt-injector.d.ts

@@ -1,8 +1,14 @@
 import type { PluginInput } from "@opencode-ai/plugin";
+export type ContinuationPromptResult = {
+    status: "dispatched";
+} | {
+    status: "rejected";
+    error: Error;
+};
 export declare function injectContinuationPrompt(ctx: PluginInput, options: {
     sessionID: string;
     prompt: string;
     directory: string;
     apiTimeoutMs: number;
     inheritFromSessionID?: string;
-}): Promise<void>;
+}): Promise<ContinuationPromptResult>;

package/dist/hooks/ralph-loop/iteration-continuation.d.ts

@@ -8,5 +8,13 @@ type ContinuationOptions = {
         setSessionID: (sessionID: string) => RalphLoopState | null;
     };
 };
-export declare function continueIteration(ctx: PluginInput, state: RalphLoopState, options: ContinuationOptions): Promise<void>;
+export type ContinuationResult = {
+    status: "dispatched";
+} | {
+    status: "session_creation_rejected";
+} | {
+    status: "dispatch_rejected";
+    error: unknown;
+};
+export declare function continueIteration(ctx: PluginInput, state: RalphLoopState, options: ContinuationOptions): Promise<ContinuationResult>;
 export {};

package/dist/hooks/ralph-loop/loop-state-controller.d.ts

@@ -20,4 +20,5 @@ export declare function createLoopStateController(options: {
     markVerificationPending(sessionID: string): RalphLoopState | null;
     setVerificationSessionID(sessionID: string, verificationSessionID: string): RalphLoopState | null;
     restartAfterFailedVerification(sessionID: string, messageCountAtStart?: number): RalphLoopState | null;
+    clearVerificationState(sessionID: string, messageCountAtStart?: number): RalphLoopState | null;
 };

package/dist/hooks/ralph-loop/pending-verification-handler.d.ts

@@ -2,6 +2,9 @@ import type { PluginInput } from "@opencode-ai/plugin";
 import type { RalphLoopState } from "./types";
 type LoopStateController = {
     restartAfterFailedVerification: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
+    clearVerificationState: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
+    incrementIteration: () => RalphLoopState | null;
+    clear: () => boolean;
     setVerificationSessionID: (sessionID: string, verificationSessionID: string) => RalphLoopState | null;
 };
 export declare function handlePendingVerification(ctx: PluginInput, input: {

package/dist/hooks/ralph-loop/ralph-loop-event-handler.d.ts

@@ -8,10 +8,12 @@ type LoopStateController = {
     markVerificationPending: (sessionID: string) => RalphLoopState | null;
     setVerificationSessionID: (sessionID: string, verificationSessionID: string) => RalphLoopState | null;
     restartAfterFailedVerification: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
+    clearVerificationState: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
 };
 type RalphLoopEventHandlerOptions = {
     directory: string;
     apiTimeoutMs: number;
+    idleSettleMs: number;
     getTranscriptPath: (sessionID: string) => string | undefined;
     checkSessionExists?: RalphLoopOptions["checkSessionExists"];
     backgroundManager?: RalphLoopOptions["backgroundManager"];

package/dist/hooks/ralph-loop/types.d.ts

@@ -19,6 +19,7 @@ export interface RalphLoopOptions {
     config?: RalphLoopConfig;
     getTranscriptPath?: (sessionId: string) => string;
     apiTimeout?: number;
+    idleSettleMs?: number;
     checkSessionExists?: (sessionId: string) => Promise<boolean>;
     backgroundManager?: {
         getTasksByParentSession: (sessionId: string) => Array<{

package/dist/hooks/ralph-loop/verification-failure-handler.d.ts

@@ -1,7 +1,9 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 import type { RalphLoopState } from "./types";
 type LoopStateController = {
-    restartAfterFailedVerification: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
+    clearVerificationState: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
+    incrementIteration: () => RalphLoopState | null;
+    clear: () => boolean;
 };
 export declare function handleFailedVerification(ctx: PluginInput, input: {
     state: RalphLoopState;

package/dist/hooks/shared/session-idle-settle.d.ts

@@ -0,0 +1,11 @@
+export declare const DEFAULT_SESSION_IDLE_SETTLE_MS = 150;
+export declare function settleAfterSessionIdle(ms?: number): Promise<void>;
+type SessionStatusClient = {
+    session?: {
+        status?: () => Promise<unknown>;
+    };
+};
+export declare function isActiveSessionStatusType(statusType: string): boolean;
+export declare function isSessionActive(client: SessionStatusClient, sessionID: string): Promise<boolean>;
+export declare function shouldPromptAfterSessionIdle(client: SessionStatusClient, sessionID: string, settleMs?: number): Promise<boolean>;
+export {};

package/dist/hooks/team-session-events/team-idle-wake-hint.d.ts

@@ -24,6 +24,7 @@ type TeamIdleWakeHintContext = {
     client: {
         session: {
             promptAsync?: (input: PromptAsyncInput) => Promise<unknown>;
+            status?: () => Promise<unknown>;
         };
     };
 };
@@ -34,5 +35,8 @@ type HookInput = {
     };
 };
 export type HookImpl = (input: HookInput) => Promise<void>;
-export declare function createTeamIdleWakeHint(ctx: TeamIdleWakeHintContext, config: TeamModeConfig): HookImpl;
+type TeamIdleWakeHintOptions = {
+    idleSettleMs?: number;
+};
+export declare function createTeamIdleWakeHint(ctx: TeamIdleWakeHintContext, config: TeamModeConfig, options?: TeamIdleWakeHintOptions): HookImpl;
 export {};

package/dist/hooks/todo-description-override/description.d.ts

@@ -1 +1 @@
-export declare const TODOWRITE_DESCRIPTION = "Use this tool to create and manage a structured task list for tracking progress on multi-step work.\n\n## Todo Format (MANDATORY)\n\nEach todo title MUST encode four elements: WHERE, WHY, HOW, and EXPECTED RESULT.\n\nFormat: \"[WHERE] [HOW] to [WHY] - expect [RESULT]\"\n\nGOOD:\n- \"src/utils/validation.ts: Add validateEmail() for input sanitization - returns boolean\"\n- \"UserService.create(): Call validateEmail() before DB insert - rejects invalid emails with 400\"\n- \"validation.test.ts: Add test for missing @ sign - expect validateEmail('foo') to return false\"\n\nBAD:\n- \"Implement email validation\" (where? how? what result?)\n- \"Add dark mode\" (feature, not a todo)\n- \"Fix auth\" (what file? what changes? what's expected?)\n\n## Granularity Rules\n\nEach todo MUST be a single atomic action completable in 1-3 tool calls. If it needs more, split it.\n\n**Size test**: Can you complete this todo by editing one file or running one command? If not, it's too big.\n\n## Task Management\n- One in_progress at a time. Complete it before starting the next.\n- Mark completed immediately after finishing each item.\n- Skip this tool for single trivial tasks (one-step, obvious action).";
+export declare const TODOWRITE_DESCRIPTION = "Use this tool to create and manage a structured task list for tracking progress on multi-step work.\n\n## OpenCode Schema Contract\n\nThe upstream OpenCode `todowrite` schema expects each todo item to include:\n\n- `content`: string\n- `status`: string, one of `pending`, `in_progress`, `completed`, `cancelled`\n- `priority`: string, one of `high`, `medium`, `low`\n\n`priority` is a string field. Never send numeric priorities such as `0`, `1`, `2`, or labels such as `P0`, `P1`, `P2`.\n\n## Todo Format (MANDATORY)\n\nEach todo title MUST encode four elements: WHERE, WHY, HOW, and EXPECTED RESULT.\n\nFormat: \"[WHERE] [HOW] to [WHY] - expect [RESULT]\"\n\nGOOD:\n- \"src/utils/validation.ts: Add validateEmail() for input sanitization - returns boolean\"\n- \"UserService.create(): Call validateEmail() before DB insert - rejects invalid emails with 400\"\n- \"validation.test.ts: Add test for missing @ sign - expect validateEmail('foo') to return false\"\n\nBAD:\n- \"Implement email validation\" (where? how? what result?)\n- \"Add dark mode\" (feature, not a todo)\n- \"Fix auth\" (what file? what changes? what's expected?)\n\n## Granularity Rules\n\nEach todo MUST be a single atomic action completable in 1-3 tool calls. If it needs more, split it.\n\n**Size test**: Can you complete this todo by editing one file or running one command? If not, it's too big.\n\n## Task Management\n- One in_progress at a time. Complete it before starting the next.\n- Mark completed immediately after finishing each item.\n- Skip this tool for single trivial tasks (one-step, obvious action).";