opencode-matrixx 2.6.4 → 2.6.6

package/dist/config/schema/model-config.d.ts

@@ -5,28 +5,6 @@ export declare const ModelFallbackEntrySchema: z.ZodObject<{
     variant: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ModelFallbackEntry = z.infer<typeof ModelFallbackEntrySchema>;
-export declare const TierSpecSchema: z.ZodObject<{
-    providerPriority: z.ZodArray<z.ZodString>;
-    modelPattern: z.ZodString;
-    fallbackTier: z.ZodOptional<z.ZodString>;
-    fallback: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        providers: z.ZodArray<z.ZodString>;
-        model: z.ZodString;
-        variant: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-export type TierSpec = z.infer<typeof TierSpecSchema>;
-export declare const TiersSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
-    providerPriority: z.ZodArray<z.ZodString>;
-    modelPattern: z.ZodString;
-    fallbackTier: z.ZodOptional<z.ZodString>;
-    fallback: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        providers: z.ZodArray<z.ZodString>;
-        model: z.ZodString;
-        variant: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>>;
-export type Tiers = z.infer<typeof TiersSchema>;
 export declare const ComplexityDowngradesSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>;
 export type ComplexityDowngrades = z.infer<typeof ComplexityDowngradesSchema>;
 export declare const AgentModelRequirementsSchema: z.ZodObject<{

package/dist/config/schema/model-presets.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+/** A single model assignment inside a preset (agent or category). */
+export declare const ModelPresetEntrySchema: z.ZodObject<{
+    model: z.ZodString;
+    variant: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ModelPresetEntry = z.infer<typeof ModelPresetEntrySchema>;
+/**
+ * A named static model preset — explicit provider/model bundles per
+ * agent/category. Applied with fill-in semantics (never overwrites an
+ * explicit `model` on the target config entry).
+ */
+export declare const ModelPresetSchema: z.ZodObject<{
+    default_model: z.ZodOptional<z.ZodString>;
+    agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        model: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    categories: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        model: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ModelPreset = z.infer<typeof ModelPresetSchema>;
+/** Registry of named presets keyed by preset name. */
+export declare const ModelPresetsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    default_model: z.ZodOptional<z.ZodString>;
+    agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        model: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    categories: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        model: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>>;
+export type ModelPresets = z.infer<typeof ModelPresetsSchema>;
+/** Name of the active preset in `model_presets`. */
+export declare const ActivePresetSchema: z.ZodString;
+export type ActivePreset = z.infer<typeof ActivePresetSchema>;

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

@@ -0,0 +1,6 @@
+import { z } from "zod";
+/** Task system configuration schema */
+export declare const TaskConfigSchema: z.ZodObject<{
+    pollTimeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type TaskConfig = z.infer<typeof TaskConfigSchema>;

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

@@ -0,0 +1,25 @@
+import { z } from "zod";
+/**
+ * Canonical task-system configuration. Single home for everything
+ * task-related: master switch, storage, enforcer behavior, poll timeout.
+ *
+ * Legacy locations still parse (backward compat) and act as fallback
+ * with LOWER precedence — explicit `tasks.*` always wins:
+ * - `experimental.task_system` / `new_task_system_enabled` → `tasks.enabled`
+ * - `morpheus.tasks.*` → `tasks.*` (same key names)
+ * - `task.pollTimeoutMs` → `tasks.pollTimeoutMs`
+ * See `resolveTasksConfig()` in `src/shared/task-system-gating.ts`.
+ */
+export declare const TasksConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    scope: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        project: "project";
+        global: "global";
+    }>>>;
+    storage_path: z.ZodOptional<z.ZodString>;
+    task_list_id: z.ZodOptional<z.ZodString>;
+    stale_after_hours: z.ZodOptional<z.ZodNumber>;
+    session_scoped: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    pollTimeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type TasksConfig = z.infer<typeof TasksConfigSchema>;

package/dist/config/schema.d.ts

@@ -20,6 +20,7 @@ export * from "./schema/matrix-loop";
 export * from "./schema/matrixx-config";
 export * from "./schema/matrixx-self-config";
 export * from "./schema/model-config";
+export * from "./schema/model-presets";
 export * from "./schema/morpheus";
 export * from "./schema/morpheus-agent";
 export * from "./schema/notification";
@@ -27,6 +28,8 @@ export * from "./schema/rtk";
 export * from "./schema/runtime-fallback";
 export * from "./schema/security";
 export * from "./schema/skills";
+export * from "./schema/task";
+export * from "./schema/tasks";
 export * from "./schema/tdd-enforcer";
 export * from "./schema/tmux";
 export * from "./schema/websearch";

package/dist/create-hooks.d.ts

@@ -33,6 +33,7 @@ export declare function createHooks(args: {
     thinkingBlockValidator: ReturnType<typeof import("./hooks").createThinkingBlockValidatorHook> | null;
     toolPairValidator: ReturnType<typeof import("./hooks").createToolPairValidatorHook> | null;
     designIntentPreserver: ReturnType<typeof import("./hooks").createDesignIntentPreserverHook> | null;
+    backgroundTaskBlocker: ReturnType<typeof import("./hooks").createBackgroundTaskBlockerHook> | null;
     commentChecker: ReturnType<typeof import("./hooks").createCommentCheckerHooks> | null;
     toolOutputTruncator: ReturnType<typeof import("./hooks").createToolOutputTruncatorHook> | null;
     directoryAgentsInjector: ReturnType<typeof import("./hooks").createDirectoryAgentsInjectorHook> | null;

package/dist/features/background-agent/handle-index.d.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import type { BackgroundTask } from "./types";
+/**
+ * File-backed handle index for background tasks.
+ *
+ * Mirrors the `task-storage` pattern: one file per handle under a
+ * project-scoped `.matrixx/bg-handles/` directory, written atomically via
+ * `tmp + renameSync`. Only a lightweight index is persisted — prompts,
+ * progress, results, errors and tool-call windows stay ephemeral.
+ *
+ * This lets a freshly-created `BackgroundManager` recover previously-created
+ * `bg_*` handles after a plugin/process restart.
+ */
+export declare const BG_HANDLE_DIR_NAME = "bg-handles";
+export declare const BG_HANDLE_FILE_PREFIX = "bg_";
+export declare const BgHandleSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    parentSessionID: z.ZodString;
+    parentMessageID: z.ZodString;
+    description: z.ZodString;
+    agent: z.ZodString;
+    status: z.ZodEnum<{
+        error: "error";
+        cancelled: "cancelled";
+        interrupt: "interrupt";
+        pending: "pending";
+        running: "running";
+        completed: "completed";
+    }>;
+    model: z.ZodOptional<z.ZodObject<{
+        providerID: z.ZodString;
+        modelID: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    category: z.ZodOptional<z.ZodString>;
+    concurrencyGroup: z.ZodOptional<z.ZodString>;
+    queuedAt: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    completedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type BgHandle = z.infer<typeof BgHandleSchema>;
+/** Project-scoped handle directory: `<project>/.matrixx/bg-handles`. */
+export declare function getBgHandleDir(directory: string): string;
+/** One file per handle id: `<project>/.matrixx/bg-handles/<taskId>.json`. */
+export declare function getHandlePath(directory: string, taskId: string): string;
+/** Project a full task onto the lightweight, persistable handle index. */
+export declare function toHandle(task: BackgroundTask): BgHandle;
+/**
+ * Atomically persist a handle: write to a temp file then rename into place.
+ * Throws on write failure; callers decide how to surface it.
+ */
+export declare function writeHandle(directory: string, task: BackgroundTask): void;
+/** Read and validate every persisted handle. Invalid/corrupt files are skipped. */
+export declare function readHandles(directory: string): BgHandle[];
+/** Remove the handle file for a task id. Returns true when a file was deleted. */
+export declare function deleteHandleFile(directory: string, taskId: string): boolean;
+/**
+ * Bounded TTL sweep: delete handle files whose most recent timestamp is older
+ * than `ttlMs` (default 30 min). Corrupt/unreadable files are swept too so the
+ * directory cannot grow without bound. Returns the number of files removed.
+ */
+export declare function sweepStaleHandles(directory: string, ttlMs?: number, now?: number): number;

package/dist/features/background-agent/handle-index.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -1,4 +1,5 @@
 export { ConcurrencyManager } from "./concurrency";
+export { BG_HANDLE_FILE_PREFIX, type BgHandle, BgHandleSchema, deleteHandleFile, getBgHandleDir, getHandlePath, readHandles, sweepStaleHandles, toHandle, writeHandle, } from "./handle-index";
 export { BackgroundManager, type OnSubagentSessionCreated, type SubagentSessionCreatedEvent } from "./manager";
 export { TaskStateManager } from "./state";
 export { TaskHistory, type TaskHistoryEntry } from "./task-history";

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

@@ -0,0 +1 @@
+export {};

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

@@ -51,6 +51,18 @@ export declare class BackgroundManager {
         onShutdown?: () => void;
         enableParentSessionNotifications?: boolean;
     });
+    /**
+     * Persist a lightweight handle for the given task. Called on running and
+     * terminal transitions only — never on intermediate progress updates (C8).
+     * Best-effort: write failures are logged and never break task lifecycle.
+     */
+    private persistHandle;
+    /**
+     * Recover handles persisted by a previous manager/process. Sweeps stale
+     * handles first, then loads the remainder into memory. Running handles are
+     * marked `"interrupt"` (C6) and no concurrency is re-acquired (C7).
+     */
+    restoreHandles(): Promise<void>;
     launch(input: LaunchInput): Promise<BackgroundTask>;
     private processKey;
     private startTask;

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

@@ -0,0 +1 @@
+export declare const PRESET_TEMPLATE = "You are managing the active model preset.\n\nThis command is provided by the Matrixx plugin. It uses the built-in `preset` tool to list, show, or switch model presets \u2014 no external scripts or direct config edits needed.\n\n## Usage\n\n```\n/preset                  \u2192 List available presets and mark the active one\n/preset list             \u2192 List available presets\n/preset show [<name>]    \u2192 Show a preset's agent/category model assignments (defaults to active)\n/preset set <name>       \u2192 Switch the active preset for the current session (live)\n/preset set <name> --save [--global|--project] \u2192 Also persist active_preset to config\n```\n\n## Step 1: Determine the action\n\nParse the arguments passed to this command:\n\n- No arguments or `list` \u2192 call `preset` with `action: \"list\"`.\n- `show` \u2192 call `preset` with `action: \"show\"` (optionally `name`).\n- `set <name>` \u2192 call `preset` with `action: \"set\"`, `name: \"<name>\"`.\n- `set <name> --save` \u2192 also pass `save: true`; `--global` \u2192 `scope: \"global\"`, `--project` (default) \u2192 `scope: \"project\"`.\n\n## Step 2: Call the built-in `preset` tool\n\nUse the `preset` tool with the resolved arguments. The tool validates the preset name, applies the session overlay (delegate-task categories switch immediately), and \u2014 with `--save` \u2014 persists `active_preset` to the project (`.opencode/matrixx.jsonc`) or global (`~/.config/opencode/matrixx.jsonc`) config.\n\nThe tool handles all validation and file operations \u2014 do NOT edit config files directly.\n\n## Step 3: Confirm and instruct\n\nAfter a successful switch:\n\n1. Report the tool's output to the user.\n2. Note that delegate-task categories use the new preset immediately (session-scoped live switch).\n3. If `--save` was used, tell the user the persisted `active_preset` takes effect for builtin agents on the next session.\n\n## Important constraints\n\n- Use the built-in `preset` tool. Do NOT bypass it by editing config files directly.\n- Do not invent preset names \u2014 if the requested name is unknown, report the available presets and stop.\n- `--save` without a scope defaults to project scope.";

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

@@ -1,3 +1,3 @@
 import type { CommandDefinition } from "../command-loader";
-export type BuiltinCommandName = "init-deep" | "matrix-loop" | "cancel-loop" | "ulw-loop" | "refactor" | "start-work" | "stop-continuation" | "handoff" | "pickup" | "remove-deadcode" | "profile" | "end-ultrawork" | "research" | "assembly" | "ultrawork" | "bdd-backend" | "bdd-contract" | "bdd-frontend" | "bdd-pipeline" | "bdd-tests" | "dcp-profile" | "evolution" | "cleanup-tasks" | "task-list";
+export type BuiltinCommandName = "init-deep" | "matrix-loop" | "cancel-loop" | "ulw-loop" | "refactor" | "start-work" | "stop-continuation" | "handoff" | "pickup" | "remove-deadcode" | "preset" | "end-ultrawork" | "research" | "assembly" | "ultrawork" | "bdd-backend" | "bdd-contract" | "bdd-frontend" | "bdd-pipeline" | "bdd-tests" | "dcp-profile" | "evolution" | "cleanup-tasks" | "task-list";
 export type BuiltinCommands = Record<string, CommandDefinition>;

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

@@ -0,0 +1 @@
+export { _resetPresetStateForTesting, clearSessionPreset, getSessionPreset, setSessionPreset, } from "./manager";

package/dist/features/preset-state/manager.d.ts

@@ -0,0 +1,5 @@
+export declare function setSessionPreset(sessionID: string, presetName: string): void;
+export declare function getSessionPreset(sessionID: string): string | undefined;
+export declare function clearSessionPreset(sessionID: string): void;
+/** @internal */
+export declare function _resetPresetStateForTesting(): void;

package/dist/features/session-state/state.d.ts

@@ -1,6 +1,12 @@
 export declare const subagentSessions: Set<string>;
 export declare function registerSubagentSession(sessionID: string, parentSessionID: string): void;
+export declare function unregisterSubagentSession(sessionID: string): void;
 export declare function getParentSessionID(subagentSessionID: string): string | undefined;
+/**
+ * Live subagent session IDs registered under the given parent session.
+ * Only sessions still present in `subagentSessions` (i.e. not yet
+ * unregistered on task end) are returned.
+ */
 export declare function getSubagentSessionIDs(parentSessionID: string): string[];
 export declare function setMainSession(id: string | undefined): void;
 export declare function getMainSessionID(): string | undefined;

package/dist/features/task-storage/types.d.ts

@@ -21,6 +21,8 @@ export declare const TaskSchema: z.ZodObject<{
     blockedBy: z.ZodArray<z.ZodString>;
     owner: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    repoURL: z.ZodOptional<z.ZodString>;
+    parentID: z.ZodOptional<z.ZodString>;
     threadID: z.ZodOptional<z.ZodString>;
     projectRoot: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;

package/dist/hooks/background-task-blocker/hook.d.ts

@@ -0,0 +1,10 @@
+export declare function createBackgroundTaskBlockerHook(): {
+    "tool.execute.before": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, _output: {
+        args: Record<string, unknown>;
+        message?: string;
+    }) => Promise<void>;
+};

package/dist/hooks/background-task-blocker/index.d.ts

@@ -0,0 +1 @@
+export { createBackgroundTaskBlockerHook } from "./hook";

package/dist/hooks/index.d.ts

@@ -3,6 +3,7 @@ export { createArchitectHook } from "./architect";
 export { createAutoSlashCommandHook } from "./auto-slash-command";
 export { createAutoUpdateCheckerHook } from "./auto-update-checker";
 export { createBackgroundNotificationHook } from "./background-notification";
+export { createBackgroundTaskBlockerHook } from "./background-task-blocker";
 export { createBashFileReadGuardHook } from "./bash-file-read-guard";
 export { createCategorySkillReminderHook } from "./category-skill-reminder";
 export { createCommentCheckerHooks } from "./comment-checker";

package/dist/hooks/json-error-recovery/hook.d.ts

@@ -1,5 +1,5 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-export declare const JSON_ERROR_TOOL_EXCLUDE_LIST: readonly ["bash", "read", "glob", "grep", "webfetch", "look_at", "grep_app_searchgithub", "websearch_web_search_exa"];
+export declare const JSON_ERROR_TOOL_EXCLUDE_LIST: readonly ["bash", "read", "glob", "grep", "webfetch", "look_at", "white_rabbit_searchgithub", "websearch_web_search_exa"];
 export declare const JSON_ERROR_PATTERNS: readonly RegExp[];
 export declare const JSON_ERROR_REMINDER = "\n[JSON PARSE ERROR - IMMEDIATE ACTION REQUIRED]\n\nYou sent invalid JSON arguments to a tool. STOP and do this NOW:\n\n1. DO NOT retry with the same malformed JSON\n2. CORRECT the JSON syntax \u2014 check for: missing quotes, trailing commas, unmatched braces\n3. RETRY the tool call with valid JSON arguments\n\nThis usually means you garbled a string parameter or forgot to escape a character.\n";
 export declare function createJsonErrorRecoveryHook(_ctx: PluginInput): {

package/dist/hooks/task-continuation-enforcer/continuation-injection.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/task-continuation-enforcer/staleness.d.ts

@@ -1,8 +1,9 @@
 import type { MatrixxConfig } from "../../config/schema";
+import type { Task } from "../../features/task-storage/types";
 export declare const DEFAULT_STALE_AFTER_HOURS = 24;
 /**
  * Resolve the stale threshold (ms) from plugin config.
- * `morpheus.tasks.stale_after_hours` (default 24h) — a pending task whose
+ * `tasks.stale_after_hours` (default 24h, legacy `morpheus.tasks.stale_after_hours`) — a pending task whose
  * task file has had no write activity for longer than this is "stale".
  */
 export declare function getStaleAfterMs(config?: Partial<MatrixxConfig>): number;
@@ -12,5 +13,10 @@ export declare function getStaleAfterMs(config?: Partial<MatrixxConfig>): number
  */
 export declare function getTaskAgeMs(taskPath: string): number | null;
 export declare function isTaskStale(taskPath: string, staleAfterMs: number): boolean;
+/**
+ * Filter incomplete tasks down to the ones that are still fresh (not stale).
+ * A task whose file cannot be stat'ed is treated as fresh (not stale).
+ */
+export declare function filterFreshIncompleteTasks(tasks: Task[], taskDir: string, staleAfterMs: number): Task[];
 /** Human-readable age, e.g. "3h", "2d". */
 export declare function formatTaskAge(ageMs: number): string;

package/dist/hooks/task-continuation-enforcer/todo.d.ts

@@ -6,9 +6,17 @@ export declare function getIncompleteTasks(tasks: Task[]): Task[];
 export declare function getIncompleteTaskCount(tasks: Task[]): number;
 export interface SessionFilterOptions {
     sessionID: string;
+    /** LIVE subagent session ids (dead/unregistered subagents are excluded). */
     subagentIDs: string[];
     sessionScoped?: boolean;
 }
+/**
+ * Drop subtasks whose parent task is already resolved (completed/deleted).
+ * A task is dropped only when its `parentID` resolves to a task in the full
+ * input array whose status is "completed" or "deleted". Tasks without a
+ * parentID, or whose parent is missing from the input, are kept.
+ */
+export declare function dropSubtasksWithResolvedParent(tasks: Task[]): Task[];
 /**
  * Filter tasks by session scope.
  * - When sessionScoped=false: all tasks pass through (opt-out / legacy behavior)

package/dist/hooks/task-continuation-enforcer/todo.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/tasks-todowrite-disabler/constants.d.ts

@@ -1,3 +1,3 @@
 export declare const HOOK_NAME = "tasks-todowrite-disabler";
 export declare const BLOCKED_TOOLS: string[];
-export declare const REPLACEMENT_MESSAGE = "TodoRead/TodoWrite are DISABLED because experimental.task_system is enabled.\n\n**ACTION REQUIRED**: RE-REGISTER what you were about to write as Todo using Task tools NOW. Then ASSIGN yourself and START WORKING immediately.\n\n**Use these tools instead:**\n- TaskCreate: Create new task with auto-generated ID\n- TaskUpdate: Update status, assign owner, add dependencies\n- TaskList: List active tasks with dependency info\n- TaskGet: Get full task details\n\n**Workflow:**\n1. TaskCreate({ subject: \"your task description\" })\n2. TaskUpdate({ id: \"T-xxx\", status: \"in_progress\", owner: \"your-thread-id\" })\n3. DO THE WORK\n4. TaskUpdate({ id: \"T-xxx\", status: \"completed\" })\n\nCRITICAL: 1 task = 1 task. Fire independent tasks concurrently.\n\n**STOP! DO NOT START WORKING DIRECTLY - NO MATTER HOW SMALL THE TASK!**\nEven if the task seems trivial (1 line fix, simple edit, quick change), you MUST:\n1. FIRST register it with TaskCreate\n2. THEN mark it in_progress\n3. ONLY THEN do the actual work\n4. FINALLY mark it completed\n\n**WHY?** Task tracking = visibility = accountability. Skipping registration = invisible work = chaos.\n\nDO NOT retry TodoWrite. Convert to TaskCreate NOW.";
+export declare const REPLACEMENT_MESSAGE = "TodoRead/TodoWrite are DISABLED because tasks.enabled is true.\n\n**ACTION REQUIRED**: RE-REGISTER what you were about to write as Todo using Task tools NOW. Then ASSIGN yourself and START WORKING immediately.\n\n**Use these tools instead:**\n- TaskCreate: Create new task with auto-generated ID\n- TaskUpdate: Update status, assign owner, add dependencies\n- TaskList: List active tasks with dependency info\n- TaskGet: Get full task details\n\n**Workflow:**\n1. TaskCreate({ subject: \"your task description\" })\n2. TaskUpdate({ id: \"T-xxx\", status: \"in_progress\", owner: \"your-thread-id\" })\n3. DO THE WORK\n4. TaskUpdate({ id: \"T-xxx\", status: \"completed\" })\n\nCRITICAL: 1 task = 1 task. Fire independent tasks concurrently.\n\n**STOP! DO NOT START WORKING DIRECTLY - NO MATTER HOW SMALL THE TASK!**\nEven if the task seems trivial (1 line fix, simple edit, quick change), you MUST:\n1. FIRST register it with TaskCreate\n2. THEN mark it in_progress\n3. ONLY THEN do the actual work\n4. FINALLY mark it completed\n\n**WHY?** Task tracking = visibility = accountability. Skipping registration = invisible work = chaos.\n\nDO NOT retry TodoWrite. Convert to TaskCreate NOW.";