opencode-matrixx 2.6.0 → 2.6.1

package/dist/matrixx.schema.json

@@ -106,6 +106,7 @@
       "items": {
         "type": "string",
         "enum": [
+          "task-continuation-enforcer",
           "todo-continuation-enforcer",
           "context-window-monitor",
           "session-recovery",
@@ -153,7 +154,6 @@
           "env-file-write-guard",
           "json-error-recovery",
           "bash-file-read-guard",
-          "todo-description-override",
           "runtime-fallback",
           "read-image-resizer",
           "webfetch-redirect-guard",
@@ -161,14 +161,14 @@
           "tool-pair-validator",
           "quality-gate",
           "task-notepad",
-          "task-todo-mirror",
           "design-intent-preserver",
           "rtk-bash-rewriter",
           "mcp-startup-notification",
           "evolution-watcher",
           "evolution-compressor",
           "evolution-quality-gate",
-          "evolution-hitl"
+          "evolution-hitl",
+          "task-edit-guard"
         ]
       }
     },
@@ -4063,6 +4063,7 @@
           "type": "boolean"
         },
         "task_system": {
+          "default": true,
           "type": "boolean"
         },
         "plugin_load_timeout_ms": {
@@ -4076,6 +4077,9 @@
           "type": "boolean"
         }
       },
+      "required": [
+        "task_system"
+      ],
       "additionalProperties": false
     },
     "dcp": {
@@ -4894,6 +4898,15 @@
             "claude_code_compat": {
               "default": false,
               "type": "boolean"
+            },
+            "scope": {
+              "description": "Task storage scope: project → .matrixx/tasks per project (default), global → ~/.config/opencode/tasks/{listId}",
+              "default": "project",
+              "type": "string",
+              "enum": [
+                "global",
+                "project"
+              ]
             }
           },
           "required": [

package/dist/plugin/hooks/create-continuation-hooks.d.ts

@@ -1,6 +1,6 @@
 import type { HookName, MatrixxConfig } from "../../config";
 import type { BackgroundManager } from "../../features/background-agent";
-import { createArchitectHook, createBackgroundNotificationHook, createCompactionContextInjector, createCompactionTodoPreserverHook, createEvolutionCompressorHook, createEvolutionHitlHook, createPlanPersister, createStopContinuationGuardHook, createTodoContinuationEnforcer } from "../../hooks";
+import { createArchitectHook, createBackgroundNotificationHook, createCompactionContextInjector, createCompactionTodoPreserverHook, createEvolutionCompressorHook, createEvolutionHitlHook, createPlanPersister, createStopContinuationGuardHook, createTaskContinuationEnforcer, createTodoContinuationEnforcer } from "../../hooks";
 import type { PluginContext } from "../types";
 import { createUnstableAgentBabysitter } from "../unstable-agent-babysitter";
 export type ContinuationHooks = {
@@ -8,6 +8,7 @@ export type ContinuationHooks = {
     compactionContextInjector: ReturnType<typeof createCompactionContextInjector> | null;
     compactionTodoPreserver: ReturnType<typeof createCompactionTodoPreserverHook> | null;
     todoContinuationEnforcer: ReturnType<typeof createTodoContinuationEnforcer> | null;
+    taskContinuationEnforcer: ReturnType<typeof createTaskContinuationEnforcer> | null;
     unstableAgentBabysitter: ReturnType<typeof createUnstableAgentBabysitter> | null;
     backgroundNotificationHook: ReturnType<typeof createBackgroundNotificationHook> | null;
     architectHook: ReturnType<typeof createArchitectHook> | null;

package/dist/plugin/hooks/create-core-hooks.d.ts

@@ -25,14 +25,13 @@ export declare function createCoreHooks(args: {
     envFileWriteGuard: ReturnType<typeof import("../../hooks").createEnvFileWriteGuardHook> | null;
     jsonErrorRecovery: ReturnType<typeof import("../../hooks").createJsonErrorRecoveryHook> | null;
     bashFileReadGuard: ReturnType<typeof import("../../hooks").createBashFileReadGuardHook> | null;
-    todoDescriptionOverride: ReturnType<typeof import("../../hooks").createTodoDescriptionOverrideHook> | null;
     readImageResizer: ReturnType<typeof import("../../hooks").createReadImageResizerHook> | null;
     webfetchRedirectGuard: ReturnType<typeof import("../../hooks").createWebFetchRedirectGuardHook> | null;
     hashlineEditDiffEnhancer: ReturnType<typeof import("../../hooks").createHashlineEditDiffEnhancerHook> | null;
     qualityGate: ReturnType<typeof import("../../hooks").createQualityGateHook> | null;
     taskNotepad: ReturnType<typeof import("../../hooks").createTaskNotepadHook> | null;
+    taskEditGuard: ReturnType<typeof import("../../hooks").createTaskEditGuardHook> | null;
     evolutionWatcher: ReturnType<typeof import("../../hooks").createEvolutionWatcherHook> | null;
-    taskTodoMirror: ReturnType<typeof import("../../hooks").createTaskTodoMirrorHook> | null;
     contextWindowMonitor: ReturnType<typeof import("../../hooks").createContextWindowMonitorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("../../hooks").createPreemptiveCompactionHook> | null;
     sessionRecovery: ReturnType<typeof import("../../hooks").createSessionRecoveryHook> | null;

package/dist/plugin/hooks/create-tool-guard-hooks.d.ts

@@ -1,5 +1,5 @@
 import type { HookName, MatrixxConfig } from "../../config";
-import { createBashFileReadGuardHook, createCommentCheckerHooks, createDirectoryAgentsInjectorHook, createDirectoryReadmeInjectorHook, createEmptyTaskResponseDetectorHook, createEnvFileWriteGuardHook, createEvolutionWatcherHook, createHashlineEditDiffEnhancerHook, createHashlineReadEnhancerHook, createJsonErrorRecoveryHook, createQualityGateHook, createReadImageResizerHook, createRulesInjectorHook, createSecretLeakGuardHook, createTaskNotepadHook, createTasksTodowriteDisablerHook, createTaskTodoMirrorHook, createTodoDescriptionOverrideHook, createToolOutputTruncatorHook, createWebFetchRedirectGuardHook, createWriteExistingFileGuardHook } from "../../hooks";
+import { createBashFileReadGuardHook, createCommentCheckerHooks, createDirectoryAgentsInjectorHook, createDirectoryReadmeInjectorHook, createEmptyTaskResponseDetectorHook, createEnvFileWriteGuardHook, createEvolutionWatcherHook, createHashlineEditDiffEnhancerHook, createHashlineReadEnhancerHook, createJsonErrorRecoveryHook, createQualityGateHook, createReadImageResizerHook, createRulesInjectorHook, createSecretLeakGuardHook, createTaskEditGuardHook, createTaskNotepadHook, createTasksTodowriteDisablerHook, createToolOutputTruncatorHook, createWebFetchRedirectGuardHook, createWriteExistingFileGuardHook } from "../../hooks";
 import type { PluginContext } from "../types";
 export type ToolGuardHooks = {
     commentChecker: ReturnType<typeof createCommentCheckerHooks> | null;
@@ -15,14 +15,13 @@ export type ToolGuardHooks = {
     envFileWriteGuard: ReturnType<typeof createEnvFileWriteGuardHook> | null;
     jsonErrorRecovery: ReturnType<typeof createJsonErrorRecoveryHook> | null;
     bashFileReadGuard: ReturnType<typeof createBashFileReadGuardHook> | null;
-    todoDescriptionOverride: ReturnType<typeof createTodoDescriptionOverrideHook> | null;
     readImageResizer: ReturnType<typeof createReadImageResizerHook> | null;
     webfetchRedirectGuard: ReturnType<typeof createWebFetchRedirectGuardHook> | null;
     hashlineEditDiffEnhancer: ReturnType<typeof createHashlineEditDiffEnhancerHook> | null;
     qualityGate: ReturnType<typeof createQualityGateHook> | null;
     taskNotepad: ReturnType<typeof createTaskNotepadHook> | null;
+    taskEditGuard: ReturnType<typeof createTaskEditGuardHook> | null;
     evolutionWatcher: ReturnType<typeof createEvolutionWatcherHook> | null;
-    taskTodoMirror: ReturnType<typeof createTaskTodoMirrorHook> | null;
 };
 export declare function createToolGuardHooks(args: {
     ctx: PluginContext;

package/dist/shared/system-directive.d.ts

@@ -34,6 +34,7 @@ export declare function hasSystemReminder(text: string): boolean;
 export declare function removeSystemReminders(text: string): string;
 export declare const SystemDirectiveTypes: {
     readonly TODO_CONTINUATION: "TODO CONTINUATION";
+    readonly TASK_CONTINUATION: "TASK CONTINUATION";
     readonly MATRIX_LOOP: "MATRIX LOOP";
     readonly MISSION_CONTINUATION: "MISSION CONTINUATION";
     readonly DELEGATION_REQUIRED: "DELEGATION REQUIRED";

package/dist/shared/task-system-gating.d.ts

@@ -0,0 +1,3 @@
+import type { MatrixxConfig } from "../config/schema";
+export declare const TASK_SYSTEM_DEFAULT: true;
+export declare function isTaskSystemEnabled(config: Partial<MatrixxConfig> | undefined | null): boolean;

package/dist/shared/task-system-gating.test.d.ts

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

package/dist/tools/index.d.ts

@@ -23,6 +23,6 @@ export { createDelegateAgent } from "./delegate-agent";
 export { createDelegateTask } from "./delegate-task";
 export { createHashlineEditTool } from "./hashline-edit";
 export { createLookAt } from "./look-at";
-export { createTaskCreateTool, createTaskGetTool, createTaskList, createTaskUpdateTool, } from "./task";
+export { createTaskCleanupTool, createTaskCreateTool, createTaskGetTool, createTaskList, createTaskUpdateTool, } from "./task";
 export declare function createBackgroundTools(manager: BackgroundManager, client: OpencodeClient): Record<string, ToolDefinition>;
 export declare const builtinTools: Record<string, ToolDefinition>;

package/dist/tools/task/index.d.ts

@@ -1,6 +1,6 @@
+export { createTaskCleanupTool } from "./task-cleanup";
 export { createTaskCreateTool } from "./task-create";
 export { createTaskGetTool } from "./task-get";
 export { createTaskList } from "./task-list";
 export { createTaskUpdateTool } from "./task-update";
-export type { TodoInfo } from "./todo-sync";
 export type { TaskCreateInput, TaskDeleteInput, TaskGetInput, TaskListInput, TaskObject, TaskStatus, TaskUpdateInput } from "./types";

package/dist/tools/task/task-cleanup.d.ts

@@ -0,0 +1,4 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+import type { MatrixxConfig } from "../../config/schema";
+export declare function createTaskCleanupTool(config: Partial<MatrixxConfig>, ctx?: PluginInput): ToolDefinition;

package/dist/tools/task/task-cleanup.test.d.ts

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

package/dist/tools/task/task-get.d.ts

@@ -1,3 +1,4 @@
+import type { PluginInput } from "@opencode-ai/plugin";
 import { type ToolDefinition } from "@opencode-ai/plugin/tool";
 import type { MatrixxConfig } from "../../config/schema";
-export declare function createTaskGetTool(config: Partial<MatrixxConfig>): ToolDefinition;
+export declare function createTaskGetTool(config: Partial<MatrixxConfig>, ctx?: PluginInput): ToolDefinition;

package/dist/tools/task/task-list.d.ts

@@ -1,3 +1,4 @@
+import type { PluginInput } from "@opencode-ai/plugin";
 import { type ToolDefinition } from "@opencode-ai/plugin/tool";
 import type { MatrixxConfig } from "../../config/schema";
-export declare function createTaskList(config: Partial<MatrixxConfig>): ToolDefinition;
+export declare function createTaskList(config: Partial<MatrixxConfig>, ctx?: PluginInput): ToolDefinition;

package/dist/tools/task/types.d.ts

@@ -24,6 +24,7 @@ export declare const TaskObjectSchema: z.ZodObject<{
     repoURL: z.ZodOptional<z.ZodString>;
     parentID: z.ZodOptional<z.ZodString>;
     threadID: z.ZodString;
+    projectRoot: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type TaskObject = z.infer<typeof TaskObjectSchema>;
 export declare const TaskSchema: z.ZodObject<{
@@ -44,6 +45,7 @@ export declare const TaskSchema: z.ZodObject<{
     repoURL: z.ZodOptional<z.ZodString>;
     parentID: z.ZodOptional<z.ZodString>;
     threadID: z.ZodString;
+    projectRoot: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type Task = TaskObject;
 export declare const TaskCreateInputSchema: z.ZodObject<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-matrixx",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,7 +21,7 @@
   },
   "scripts": {
     "build": "bun run build:plugin && bun run build:cli && tsc --emitDeclarationOnly && bun run build:schema",
-    "build:plugin": "bun build src/index.ts --outdir dist --target bun --format esm --external @ast-grep/napi --external \"opencode/*\" --external \"@opencode-ai/core/*\"",
+    "build:plugin": "bun build src/index.ts --outdir dist --target bun --format esm --external @ast-grep/napi --external \"opencode/*\" --external \"@opencode-ai/core/*\" --external effect --external \"effect/*\"",
     "build:cli": "bun build src/cli/index.ts --outfile dist/cli.js --target bun --format esm && chmod +x dist/cli.js",
     "build:schema": "bun run script/build-schema.ts",
     "clean": "rm -rf dist",
@@ -65,6 +65,7 @@
   "dependencies": {
     "@ast-grep/cli": "^0.40.0",
     "@ast-grep/napi": "^0.40.0",
+    "@clack/prompts": "^1.7.0",
     "@code-yeongyu/comment-checker": "^0.6.1",
     "@cucumber/gherkin": "^34.0.0",
     "@modelcontextprotocol/sdk": "^1.25.1",

package/dist/hooks/task-todo-mirror/constants.d.ts

@@ -1,3 +0,0 @@
-export declare const HOOK_NAME = "task-todo-mirror";
-export declare const TASK_TOOL_NAMES: Set<string>;
-export declare const DEBOUNCE_MS = 300;

package/dist/hooks/task-todo-mirror/hook.d.ts

@@ -1,43 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-import type { MatrixxConfig } from "../../config/schema";
-type TodoSyncCtx = PluginInput;
-export declare function createTaskTodoMirrorHook(ctx: TodoSyncCtx, pluginConfig: MatrixxConfig): {
-    "tool.execute.after": (input: {
-        tool: string;
-        sessionID: string;
-        callID: string;
-    }, _output: {
-        title: string;
-        output: string;
-        metadata: Record<string, unknown>;
-    } | undefined) => Promise<void>;
-    "chat.message": (input: {
-        sessionID: string;
-        agent?: string;
-        model?: {
-            providerID: string;
-            modelID: string;
-        };
-    }, _output: {
-        message: Record<string, unknown>;
-        parts: Array<{
-            type: string;
-            text?: string;
-        }>;
-    }) => Promise<void>;
-    "experimental.chat.messages.transform": (_input: Record<string, never>, output: {
-        messages: Array<{
-            info: {
-                sessionID?: string;
-            };
-        }>;
-    }) => Promise<void>;
-    event: (input: {
-        event: {
-            type: string;
-            properties?: unknown;
-        };
-    }) => Promise<void>;
-    _syncForSession: (sessionID: string | undefined) => Promise<void>;
-};
-export {};

package/dist/hooks/task-todo-mirror/index.d.ts

@@ -1,2 +0,0 @@
-export { DEBOUNCE_MS, HOOK_NAME, TASK_TOOL_NAMES } from "./constants";
-export { createTaskTodoMirrorHook } from "./hook";

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

@@ -1 +0,0 @@
-export declare const TODOWRITE_DESCRIPTION = "Manage your todo list with ATOMIC, single-responsibility items.\n\nRULES:\n- One todo = one specific, verifiable action (not \"Update everything\" or \"Fix issues\")\n- Each todo must be completable in isolation \u2014 no vague catch-alls\n- Todos must be nameable with a single precise phrase\n- Mark in_progress BEFORE starting work, completed IMMEDIATELY after finishing\n- Only ONE todo in_progress at a time\n\nANTI-PATTERNS (will be rejected by reviewers):\n- \"Update X and Y and Z\" \u2192 SPLIT into 3 separate todos\n- \"Fix issues\" \u2192 SPECIFY which file, function, or behavior\n- \"Refactor\" \u2192 SPECIFY what is being refactored and to what end\n- \"Improve\" \u2192 SPECIFY the measurable outcome\n\nSTATUS TRANSITIONS:\n  pending \u2192 in_progress \u2192 completed\n  pending \u2192 cancelled (if no longer needed)\n\nNever batch-complete todos. Mark each one complete the moment it is done.";

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

@@ -1,8 +0,0 @@
-export declare function createTodoDescriptionOverrideHook(): {
-    "tool.definition": (input: {
-        toolID: string;
-    }, output: {
-        description: string;
-        parameters: unknown;
-    }) => Promise<void>;
-};

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

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

package/dist/tools/task/todo-sync.d.ts

@@ -1,16 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-import type { Task } from "../../features/task-storage/types";
-export interface TodoInfo {
-    id?: string;
-    content: string;
-    status: "pending" | "in_progress" | "completed" | "cancelled";
-    priority?: "low" | "medium" | "high";
-}
-type TodoWriter = (input: {
-    sessionID: string;
-    todos: TodoInfo[];
-}) => Promise<void>;
-export declare function syncTaskToTodo(task: Task): TodoInfo | null;
-export declare function syncTaskTodoUpdate(ctx: PluginInput | undefined, task: Task, sessionID: string, writer?: TodoWriter): Promise<void>;
-export declare function syncAllTasksToTodos(ctx: PluginInput, tasks: Task[], sessionID?: string, writer?: TodoWriter): Promise<void>;
-export {};