opencode-matrixx 2.5.0 → 2.6.1

package/dist/config/index.d.ts

@@ -1,3 +1,3 @@
 export { expandPreset, PRESET_NAMES, type PresetName } from "./presets";
-export type { AgentDefinitions, AgentName, AgentOverrideConfig, AgentOverrides, BuiltinCommandName, EnvFileGuardConfig, ExperimentalConfig, HookName, MatrixLoopConfig, MatrixxConfig, McpName, ModelCapabilitiesConfig, MorpheusAgentConfig, MorpheusConfig, MorpheusTasksConfig, RuntimeFallbackConfig, SecretScanningConfig, SecurityConfig, TmuxConfig, TmuxLayout, } from "./schema";
+export type { AgentDefinitions, AgentName, AgentOverrideConfig, AgentOverrides, BuiltinCommandName, EnvFileGuardConfig, ExperimentalConfig, HookName, MatrixLoopConfig, MatrixxConfig, McpName, MorpheusAgentConfig, MorpheusConfig, MorpheusTasksConfig, RuntimeFallbackConfig, SecretScanningConfig, SecurityConfig, TmuxConfig, TmuxLayout, } from "./schema";
 export { AgentOverrideConfigSchema, AgentOverridesSchema, BuiltinCommandNameSchema, ExperimentalConfigSchema, HookNameSchema, MatrixLoopConfigSchema, MatrixxConfigSchema, McpNameSchema, MorpheusAgentConfigSchema, RuntimeFallbackConfigSchema, SecurityConfigSchema, TmuxConfigSchema, TmuxLayoutSchema, } from "./schema";

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

@@ -0,0 +1,89 @@
+import { z } from "zod";
+export declare const EvolutionWatcherConfigSchema: z.ZodDefault<z.ZodObject<{
+    maxArgChars: z.ZodDefault<z.ZodNumber>;
+    maxOutputChars: z.ZodDefault<z.ZodNumber>;
+    skipTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+export type EvolutionWatcherConfig = z.infer<typeof EvolutionWatcherConfigSchema>;
+export declare const EvolutionCompressorConfigSchema: z.ZodDefault<z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<{
+        llm: "llm";
+        "dspy-gepa": "dspy-gepa";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    minTraces: z.ZodDefault<z.ZodNumber>;
+    maxInputTokens: z.ZodDefault<z.ZodNumber>;
+    trigger: z.ZodDefault<z.ZodEnum<{
+        compacting: "compacting";
+        idle: "idle";
+        both: "both";
+    }>>;
+}, z.core.$strip>>;
+export type EvolutionCompressorConfig = z.infer<typeof EvolutionCompressorConfigSchema>;
+export declare const EvolutionWriterConfigSchema: z.ZodDefault<z.ZodObject<{
+    outputDir: z.ZodDefault<z.ZodString>;
+    globalSkills: z.ZodDefault<z.ZodBoolean>;
+    allowToolGeneration: z.ZodDefault<z.ZodBoolean>;
+    allowAgentGeneration: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>>;
+export type EvolutionWriterConfig = z.infer<typeof EvolutionWriterConfigSchema>;
+export declare const EvolutionGovernanceConfigSchema: z.ZodDefault<z.ZodObject<{
+    requireApproval: z.ZodDefault<z.ZodBoolean>;
+    autoPromote: z.ZodDefault<z.ZodBoolean>;
+    autoPromoteThreshold: z.ZodDefault<z.ZodNumber>;
+    minConfidence: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export type EvolutionGovernanceConfig = z.infer<typeof EvolutionGovernanceConfigSchema>;
+export declare const EvolutionRetentionConfigSchema: z.ZodDefault<z.ZodObject<{
+    traceDays: z.ZodDefault<z.ZodNumber>;
+    maxPending: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export type EvolutionRetentionConfig = z.infer<typeof EvolutionRetentionConfigSchema>;
+export declare const EvolutionBudgetConfigSchema: z.ZodDefault<z.ZodObject<{
+    maxCompressionsPerHour: z.ZodDefault<z.ZodNumber>;
+    maxCostCentsPerDay: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export type EvolutionBudgetConfig = z.infer<typeof EvolutionBudgetConfigSchema>;
+export declare const EvolutionConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    watcher: z.ZodDefault<z.ZodObject<{
+        maxArgChars: z.ZodDefault<z.ZodNumber>;
+        maxOutputChars: z.ZodDefault<z.ZodNumber>;
+        skipTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    compressor: z.ZodDefault<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodEnum<{
+            llm: "llm";
+            "dspy-gepa": "dspy-gepa";
+        }>>;
+        model: z.ZodOptional<z.ZodString>;
+        minTraces: z.ZodDefault<z.ZodNumber>;
+        maxInputTokens: z.ZodDefault<z.ZodNumber>;
+        trigger: z.ZodDefault<z.ZodEnum<{
+            compacting: "compacting";
+            idle: "idle";
+            both: "both";
+        }>>;
+    }, z.core.$strip>>;
+    writer: z.ZodDefault<z.ZodObject<{
+        outputDir: z.ZodDefault<z.ZodString>;
+        globalSkills: z.ZodDefault<z.ZodBoolean>;
+        allowToolGeneration: z.ZodDefault<z.ZodBoolean>;
+        allowAgentGeneration: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    governance: z.ZodDefault<z.ZodObject<{
+        requireApproval: z.ZodDefault<z.ZodBoolean>;
+        autoPromote: z.ZodDefault<z.ZodBoolean>;
+        autoPromoteThreshold: z.ZodDefault<z.ZodNumber>;
+        minConfidence: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    retention: z.ZodDefault<z.ZodObject<{
+        traceDays: z.ZodDefault<z.ZodNumber>;
+        maxPending: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    budget: z.ZodDefault<z.ZodObject<{
+        maxCompressionsPerHour: z.ZodDefault<z.ZodNumber>;
+        maxCostCentsPerDay: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type EvolutionConfig = z.infer<typeof EvolutionConfigSchema>;

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

@@ -4,7 +4,7 @@ export declare const ExperimentalConfigSchema: z.ZodObject<{
     auto_resume: z.ZodOptional<z.ZodBoolean>;
     preemptive_compaction: z.ZodOptional<z.ZodBoolean>;
     truncate_all_tool_outputs: z.ZodOptional<z.ZodBoolean>;
-    task_system: z.ZodOptional<z.ZodBoolean>;
+    task_system: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     plugin_load_timeout_ms: z.ZodOptional<z.ZodNumber>;
     safe_hook_creation: z.ZodOptional<z.ZodBoolean>;
     hashline_edit: z.ZodOptional<z.ZodBoolean>;

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

@@ -0,0 +1,23 @@
+import { z } from "zod";
+/**
+ * Headroom network-proxy compression configuration.
+ *
+ * Headroom is an external network-proxy that compresses LLM traffic
+ * (CacheAligner → ContentRouter → CCR pipeline). Matrixx does NOT
+ * implement compression itself — it only detects/disciplines when
+ * Headroom is active.
+ *
+ * - Opt-in via `enabled: true` (default: false).
+ * - Recommended usage is `HEADROOM_WRAP=1 headroom wrap -- <command>`
+ *   so the proxy sits transparently in front of the transport.
+ * - Native transport integration is deferred until the compaction hook
+ *   stabilizes (Headroom #76 collision risk with
+ *   anthropic-context-window-limit-recovery).
+ */
+export declare const HeadroomConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    proxyUrl: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+    backend: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HeadroomConfig = z.infer<typeof HeadroomConfigSchema>;

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

@@ -4,6 +4,9 @@ export declare const HookNameSchema: z.ZodEnum<{
     "quality-gate": "quality-gate";
     "matrix-loop": "matrix-loop";
     "start-work": "start-work";
+    "evolution-watcher": "evolution-watcher";
+    "evolution-compressor": "evolution-compressor";
+    "task-continuation-enforcer": "task-continuation-enforcer";
     "todo-continuation-enforcer": "todo-continuation-enforcer";
     "context-window-monitor": "context-window-monitor";
     "session-recovery": "session-recovery";
@@ -48,7 +51,6 @@ export declare const HookNameSchema: z.ZodEnum<{
     "env-file-write-guard": "env-file-write-guard";
     "json-error-recovery": "json-error-recovery";
     "bash-file-read-guard": "bash-file-read-guard";
-    "todo-description-override": "todo-description-override";
     "runtime-fallback": "runtime-fallback";
     "read-image-resizer": "read-image-resizer";
     "webfetch-redirect-guard": "webfetch-redirect-guard";
@@ -57,5 +59,9 @@ export declare const HookNameSchema: z.ZodEnum<{
     "task-notepad": "task-notepad";
     "design-intent-preserver": "design-intent-preserver";
     "rtk-bash-rewriter": "rtk-bash-rewriter";
+    "mcp-startup-notification": "mcp-startup-notification";
+    "evolution-quality-gate": "evolution-quality-gate";
+    "evolution-hitl": "evolution-hitl";
+    "task-edit-guard": "task-edit-guard";
 }>;
 export type HookName = z.infer<typeof HookNameSchema>;

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

@@ -72,6 +72,9 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         "quality-gate": "quality-gate";
         "matrix-loop": "matrix-loop";
         "start-work": "start-work";
+        "evolution-watcher": "evolution-watcher";
+        "evolution-compressor": "evolution-compressor";
+        "task-continuation-enforcer": "task-continuation-enforcer";
         "todo-continuation-enforcer": "todo-continuation-enforcer";
         "context-window-monitor": "context-window-monitor";
         "session-recovery": "session-recovery";
@@ -116,7 +119,6 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         "env-file-write-guard": "env-file-write-guard";
         "json-error-recovery": "json-error-recovery";
         "bash-file-read-guard": "bash-file-read-guard";
-        "todo-description-override": "todo-description-override";
         "runtime-fallback": "runtime-fallback";
         "read-image-resizer": "read-image-resizer";
         "webfetch-redirect-guard": "webfetch-redirect-guard";
@@ -125,6 +127,10 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         "task-notepad": "task-notepad";
         "design-intent-preserver": "design-intent-preserver";
         "rtk-bash-rewriter": "rtk-bash-rewriter";
+        "mcp-startup-notification": "mcp-startup-notification";
+        "evolution-quality-gate": "evolution-quality-gate";
+        "evolution-hitl": "evolution-hitl";
+        "task-edit-guard": "task-edit-guard";
     }>>>;
     disabled_commands: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         "bdd-contract": "bdd-contract";
@@ -1682,7 +1688,7 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         auto_resume: z.ZodOptional<z.ZodBoolean>;
         preemptive_compaction: z.ZodOptional<z.ZodBoolean>;
         truncate_all_tool_outputs: z.ZodOptional<z.ZodBoolean>;
-        task_system: z.ZodOptional<z.ZodBoolean>;
+        task_system: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         plugin_load_timeout_ms: z.ZodOptional<z.ZodNumber>;
         safe_hook_creation: z.ZodOptional<z.ZodBoolean>;
         hashline_edit: z.ZodOptional<z.ZodBoolean>;
@@ -1852,6 +1858,10 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
             storage_path: z.ZodOptional<z.ZodString>;
             task_list_id: z.ZodOptional<z.ZodString>;
             claude_code_compat: z.ZodDefault<z.ZodBoolean>;
+            scope: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                project: "project";
+                global: "global";
+            }>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     assembly: z.ZodOptional<z.ZodObject<{
@@ -1892,21 +1902,63 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         notify_on_fallback: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, z.core.$strip>>;
     agent_definitions: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-    model_capabilities: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodOptional<z.ZodBoolean>;
-        auto_refresh_on_start: z.ZodOptional<z.ZodBoolean>;
-        refresh_timeout_ms: z.ZodOptional<z.ZodNumber>;
-        source_url: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
     matrixx_self_config: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         proactive: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
+    headroom: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        proxyUrl: z.ZodOptional<z.ZodString>;
+        project: z.ZodOptional<z.ZodString>;
+        backend: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     rtk: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         binary_path: z.ZodOptional<z.ZodString>;
         timeout_ms: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    evolution: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        watcher: z.ZodDefault<z.ZodObject<{
+            maxArgChars: z.ZodDefault<z.ZodNumber>;
+            maxOutputChars: z.ZodDefault<z.ZodNumber>;
+            skipTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        compressor: z.ZodDefault<z.ZodObject<{
+            provider: z.ZodDefault<z.ZodEnum<{
+                llm: "llm";
+                "dspy-gepa": "dspy-gepa";
+            }>>;
+            model: z.ZodOptional<z.ZodString>;
+            minTraces: z.ZodDefault<z.ZodNumber>;
+            maxInputTokens: z.ZodDefault<z.ZodNumber>;
+            trigger: z.ZodDefault<z.ZodEnum<{
+                compacting: "compacting";
+                idle: "idle";
+                both: "both";
+            }>>;
+        }, z.core.$strip>>;
+        writer: z.ZodDefault<z.ZodObject<{
+            outputDir: z.ZodDefault<z.ZodString>;
+            globalSkills: z.ZodDefault<z.ZodBoolean>;
+            allowToolGeneration: z.ZodDefault<z.ZodBoolean>;
+            allowAgentGeneration: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        governance: z.ZodDefault<z.ZodObject<{
+            requireApproval: z.ZodDefault<z.ZodBoolean>;
+            autoPromote: z.ZodDefault<z.ZodBoolean>;
+            autoPromoteThreshold: z.ZodDefault<z.ZodNumber>;
+            minConfidence: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        retention: z.ZodDefault<z.ZodObject<{
+            traceDays: z.ZodDefault<z.ZodNumber>;
+            maxPending: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        budget: z.ZodDefault<z.ZodObject<{
+            maxCompressionsPerHour: z.ZodDefault<z.ZodNumber>;
+            maxCostCentsPerDay: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     _migrations: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type MatrixxConfig = z.infer<typeof MatrixxConfigSchema>;

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

@@ -3,12 +3,20 @@ declare const MorpheusTasksConfigSchema: z.ZodObject<{
     storage_path: z.ZodOptional<z.ZodString>;
     task_list_id: z.ZodOptional<z.ZodString>;
     claude_code_compat: z.ZodDefault<z.ZodBoolean>;
+    scope: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        project: "project";
+        global: "global";
+    }>>>;
 }, z.core.$strip>;
 export declare const MorpheusConfigSchema: z.ZodObject<{
     tasks: z.ZodOptional<z.ZodObject<{
         storage_path: z.ZodOptional<z.ZodString>;
         task_list_id: z.ZodOptional<z.ZodString>;
         claude_code_compat: z.ZodDefault<z.ZodBoolean>;
+        scope: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            project: "project";
+            global: "global";
+        }>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type MorpheusTasksConfig = z.infer<typeof MorpheusTasksConfigSchema>;

package/dist/config/schema.d.ts

@@ -8,15 +8,15 @@ export * from "./schema/background-task";
 export * from "./schema/browser-automation";
 export * from "./schema/categories";
 export * from "./schema/commands";
-export * from "./schema/commands";
 export * from "./schema/comment-checker";
 export * from "./schema/dcp";
+export * from "./schema/evolution";
 export * from "./schema/experimental";
-export * from "./schema/experimental";
+export * from "./schema/headroom";
 export * from "./schema/hooks";
 export * from "./schema/matrix-loop";
 export * from "./schema/matrixx-config";
-export * from "./schema/model-capabilities";
+export * from "./schema/matrixx-self-config";
 export * from "./schema/morpheus";
 export * from "./schema/morpheus-agent";
 export * from "./schema/notification";

package/dist/create-hooks.d.ts

@@ -19,10 +19,13 @@ export declare function createHooks(args: {
     compactionContextInjector: ReturnType<typeof import("./hooks").createCompactionContextInjector> | null;
     compactionTodoPreserver: ReturnType<typeof import("./hooks").createCompactionTodoPreserverHook> | null;
     todoContinuationEnforcer: ReturnType<typeof import("./hooks").createTodoContinuationEnforcer> | null;
+    taskContinuationEnforcer: ReturnType<typeof import("./hooks").createTaskContinuationEnforcer> | null;
     unstableAgentBabysitter: ReturnType<typeof import("./plugin/unstable-agent-babysitter").createUnstableAgentBabysitter> | null;
     backgroundNotificationHook: ReturnType<typeof import("./hooks").createBackgroundNotificationHook> | null;
     architectHook: ReturnType<typeof import("./hooks").createArchitectHook> | null;
     planPersister: ReturnType<typeof import("./hooks").createPlanPersister> | null;
+    evolutionCompressor: ReturnType<typeof import("./hooks").createEvolutionCompressorHook> | null;
+    evolutionHitl: ReturnType<typeof import("./hooks").createEvolutionHitlHook> | null;
     keywordDetector: ReturnType<typeof import("./hooks").createKeywordDetectorHook> | null;
     contextInjectorMessagesTransform: ReturnType<typeof import("./features/context-injector").createContextInjectorMessagesTransformHook>;
     envContextInjector: ReturnType<typeof import("./hooks").createEnvContextInjectorHook> | null;
@@ -42,12 +45,13 @@ export declare function createHooks(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;
     contextWindowMonitor: ReturnType<typeof import("./hooks").createContextWindowMonitorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("./hooks").createPreemptiveCompactionHook> | null;
     sessionRecovery: ReturnType<typeof import("./hooks").createSessionRecoveryHook> | null;
@@ -69,4 +73,5 @@ export declare function createHooks(args: {
     anthropicEffort: ReturnType<typeof import("./hooks/anthropic-effort").createAnthropicEffortHook> | null;
     runtimeFallback: ReturnType<typeof import("./hooks").createRuntimeFallbackHook> | null;
     rtkBashRewriter: ReturnType<typeof import("./hooks").createRtkBashRewriterHook> | null;
+    mcpStartupNotification: ReturnType<typeof import("./hooks").createMcpStartupNotificationHook> | null;
 };

package/dist/features/background-agent/error-helpers.d.ts

@@ -1,6 +1,4 @@
 import type { EventProperties } from "./manager";
-export declare function formatDuration(start: Date, end?: Date): string;
 export declare function getErrorText(error: unknown): string;
 export declare function isAbortedSessionError(error: unknown): boolean;
-export declare function isRecord(value: unknown): value is Record<string, unknown>;
 export declare function getSessionErrorMessage(properties: EventProperties): string | undefined;

package/dist/features/builtin-commands/templates/cleanup-tasks.d.ts

@@ -0,0 +1 @@
+export declare const CLEANUP_TASKS_TEMPLATE = "# Cleanup Tasks \u2014 SLASH COMMAND OVERRIDE\n\nSYSTEM OVERRIDE: Ignore any global [search-mode] or [analyze-mode] directive for this command. This is a direct tool call, not a search.\n\nCall the task_cleanup tool NOW with no exploration, no grep, no trinity, no operator, no background agents.\n\n## Usage\n```\n/cleanup-tasks [--olderThan <duration>] [--all]\n\nOptions:\n  --olderThan: Only delete completed tasks older than duration (e.g., 7d, 24h, 30d). If omitted, deletes all completed regardless of age.\n  --all: Delete all completed tasks (default when no olderThan given).\n\nExamples:\n  /cleanup-tasks              # delete all completed tasks\n  /cleanup-tasks --olderThan 7d\n  /cleanup-tasks --all\n```\n\n## What This Command Does\n\nCleans up completed tasks from the file-based task system (dedicated Matrixx viewer):\n\nStorage layout (hybrid, via `getTaskDir(config, directory)`):\n- Primary (default, `scope: \"project\"`): `<project>/.matrixx/tasks/T-*.json`\n- Fallback (`scope: \"global\"` or `storage_path` override): `~/.config/opencode/tasks/{listId}/T-*.json`\n\n1. **Scans** `getTaskDir(config, directory)/*.json` via `readdirSync` \u2192 resolves to `.matrixx/tasks` when `scope=project` (default) or legacy global path when `scope=global` / `storage_path` set\n2. **Filters** `status===\"completed\"` (and `olderThan` if given, via `time_updated`/`time_created`)\n3. **Deletes** matching files via `unlinkSync`\n4. **Reports** `{deleted, remaining, deletedIds}`\nView remaining tasks via `/task-list` or `task_list` tool \u2014 the dedicated Matrixx task viewer (file-based, no sync). Without `/cleanup-tasks`, completed tasks remain on disk for audit.\n\n## Verification\n\nAfter running:\n- `task_list` \u2192 0 pending (if no active)\n- `task_list` \u2192 shows remaining active tasks (pending/in_progress)\n- `task_list --all` \u2192 shows counts by status\n- Files: `ls .matrixx/tasks | wc -l` decreases by `deleted` (project scope, default) or `ls ~/.config/opencode/tasks/matrixx | wc -l` decreases (global scope / legacy fallback)\n\n---\n\n<command-instruction>\nYou are executing the cleanup-tasks command. Use the task_cleanup tool to delete completed tasks.\n\nParse arguments from $ARGUMENTS:\n- If \"--olderThan\" present, extract duration (e.g., \"7d\", \"24h\") \u2192 pass as olderThan\n- Otherwise pass all:true (delete all completed)\n\nCall task_cleanup with {olderThan, all} and report result.\n</command-instruction>\n\n<user-request>\n$ARGUMENTS\n</user-request>\n";

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

@@ -0,0 +1 @@
+export declare const EVOLUTION_TEMPLATE = "# Evolution Command\n\n## Purpose\n\nManage self-evolution proposals staged in `.matrixx/evolution/pending`.\n\n## Commands\n\n- `/evolution list` \u2014 list pending proposals\n- `/evolution approve <slug>` \u2014 promote pending skill to `.opencode/skills/<slug>/SKILL.md`\n- `/evolution reject <slug>` \u2014 discard pending proposal\n- `/evolution audit` \u2014 show last 20 audit entries\n\n---\n\n# PHASE 1: PARSE ARGUMENTS\n\nArguments: $ARGUMENTS\n\n- If empty or \"list\": list pending\n- If \"approve <slug>\" or \"approve <slug> --global\": promote\n- If \"reject <slug>\": discard\n- If \"audit\" or \"log\": show audit\n- Otherwise: show help and list pending\n\n---\n\n# PHASE 2: EXECUTE\n\n## List\n\nUse bash: `ls -1 .matrixx/evolution/pending/*.md 2>/dev/null | xargs -I {} basename {} .md` or `rtk ls .matrixx/evolution/pending`\nFor each slug, read `.matrixx/evolution/pending/<slug>.meta.json` to show confidence, version, derived_from.\nIf none: \"No pending evolution proposals.\"\n\n## Approve\n\n1. Verify `.matrixx/evolution/pending/<slug>.md` exists \u2014 if not, error: \"Pending <slug> not found. Run /evolution list to see available.\"\n2. Copy staged skill:\n   - `mkdir -p .opencode/skills/<slug>`\n   - `cp .matrixx/evolution/pending/<slug>.md .opencode/skills/<slug>/SKILL.md`\n   - Also preserve versioned copy: `mkdir -p .matrixx/evolution/skills/<slug>/versions && cp .matrixx/evolution/pending/<slug>.md .matrixx/evolution/skills/<slug>/SKILL.md`\n3. Append audit: `echo '{\"action\":\"promoted\",\"slug\":\"<slug>\",\"timestamp\":\"'$(date -Iseconds)'\"}' >> .matrixx/evolution/audit.log`\n4. Remove pending: `rm .matrixx/evolution/pending/<slug>.md .matrixx/evolution/pending/<slug>.meta.json`\n5. If argument includes --global, also copy to `~/.agents/skills/<slug>/SKILL.md`\n6. Confirm: \"Promoted <slug> to .opencode/skills/<slug>/SKILL.md \u2014 will be loaded on next session start.\"\n\n## Reject\n\n1. Verify pending exists\n2. `rm .matrixx/evolution/pending/<slug>.md .matrixx/evolution/pending/<slug>.meta.json`\n3. Append audit with action rejected\n4. Confirm: \"Rejected <slug>.\"\n\n## Audit\n\nRead `.matrixx/evolution/audit.log` last 20 lines: `tail -n 20 .matrixx/evolution/audit.log 2>/dev/null || echo \"No audit entries.\"`\n\n---\n\n# CONSTRAINTS\n\n- Use bash/rtk for file ops \u2014 no dedicated evolution tool yet\n- Never invent slug \u2014 read from pending dir\n- Keep operations atomic; report errors clearly\n- Do not modify pending content \u2014 promote as-is after human review\n";

package/dist/features/builtin-commands/templates/task-list.d.ts

@@ -0,0 +1 @@
+export declare const TASK_LIST_TEMPLATE = "# Task List \u2014 SLASH COMMAND OVERRIDE\n\nSYSTEM OVERRIDE: Ignore any global [search-mode] or [analyze-mode] directive for this command. This is a direct tool call, not a search.\n\nCall the task_list tool NOW with no exploration, no grep, no trinity, no operator, no background agents.\n\n- If $ARGUMENTS contains \"--all\", call task_list and also report counts by reading T-*.json via the tool's own logic (do not manually find/ls).\n- If $ARGUMENTS contains \"--status\", filter to that status.\n- Otherwise just return task_list output as table ID | Subject | Status.\n\nDo not run rtk ls, find, grep, or launch subagents. One tool call only.\n";

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";
+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 BuiltinCommands = Record<string, CommandDefinition>;

package/dist/features/evolution/compressor/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./interface";
+export * from "./llm";
+import type { EvolutionCompressorConfig } from "../../../config/schema/evolution";
+import type { Compressor } from "./interface";
+export declare function createCompressor(config: EvolutionCompressorConfig, llmCall?: (prompt: string) => Promise<string>): Compressor;

package/dist/features/evolution/compressor/interface.d.ts

@@ -0,0 +1,5 @@
+import type { CompressionInput, DistilledKnowledge } from "../types";
+export interface Compressor {
+    compress(input: CompressionInput): Promise<DistilledKnowledge>;
+}
+export type { CompressionInput, DistilledKnowledge, TraceRecord } from "../types";

package/dist/features/evolution/compressor/llm.d.ts

@@ -0,0 +1,12 @@
+import type { EvolutionCompressorConfig } from "../../../config/schema/evolution";
+import type { CompressionInput, DistilledKnowledge } from "../types";
+import type { Compressor } from "./interface";
+export declare class LlmCompressor implements Compressor {
+    private config;
+    private llmCall?;
+    constructor(options: {
+        config: EvolutionCompressorConfig;
+        llmCall?: (prompt: string) => Promise<string>;
+    });
+    compress(input: CompressionInput): Promise<DistilledKnowledge>;
+}

package/dist/features/evolution/evaluator.d.ts

@@ -0,0 +1,11 @@
+import type { SkillMeta } from "./types";
+export declare function containsSecretForEval(text: string): boolean;
+export type EvalResult = {
+    score: number;
+    demoted: boolean;
+};
+export declare function readMeta(slug: string, projectRoot?: string): Promise<SkillMeta | null>;
+export declare function evaluateSkill(slug: string, opts?: {
+    threshold?: number;
+    projectRoot?: string;
+}): Promise<EvalResult>;

package/dist/features/evolution/index.d.ts

@@ -0,0 +1,7 @@
+export { createCompressor } from "./compressor";
+export { LlmCompressor } from "./compressor/llm";
+export * from "./evaluator";
+export * from "./pipeline";
+export * from "./store";
+export * from "./types";
+export * from "./writer";

package/dist/features/evolution/pipeline.d.ts

@@ -0,0 +1,7 @@
+import type { EvolutionConfig } from "../../config/schema/evolution";
+import type { CompressionInput } from "./types";
+export declare function runEvolutionPipeline(input: CompressionInput, config: EvolutionConfig): Promise<{
+    staged?: string;
+    promoted?: string;
+    reason?: string;
+}>;

package/dist/features/evolution/store.d.ts

@@ -0,0 +1,22 @@
+import type { EvolutionState, TraceRecord } from "./types";
+export declare const EVOLUTION_DIR = ".matrixx/evolution";
+export declare const TRACES_DIR = ".matrixx/evolution/traces";
+export declare const DISTILLED_DIR = ".matrixx/evolution/distilled";
+export declare const SKILLS_DIR = ".matrixx/evolution/skills";
+export declare const PENDING_DIR = ".matrixx/evolution/pending";
+export declare const STATE_FILE = ".matrixx/evolution/state.json";
+export declare const AUDIT_FILE = ".matrixx/evolution/audit.log";
+export declare class TraceStore {
+    private ringBuffer;
+    private evolutionDir;
+    constructor(evolutionDir?: string);
+    append(record: TraceRecord): Promise<void>;
+    getRecent(count?: number): TraceRecord[];
+    readSession(sessionID: string): Promise<TraceRecord[]>;
+    getAllTraces(sessionID: string): Promise<TraceRecord[]>;
+    cleanup(retentionDays: number): Promise<void>;
+    getState(): Promise<EvolutionState>;
+    updateState(patch: Partial<EvolutionState>): Promise<void>;
+    appendAudit(entry: Record<string, unknown>): Promise<void>;
+}
+export declare const traceStore: TraceStore;

package/dist/features/evolution/types.d.ts

@@ -0,0 +1,51 @@
+export type TraceRecord = {
+    id: string;
+    sessionID: string;
+    callID: string;
+    timestamp: string;
+    agent: string;
+    tool: string;
+    args: unknown;
+    output: string;
+    durationMs: number;
+    success: boolean;
+    errorType?: string;
+    model?: string;
+};
+export type DistilledKnowledge = {
+    title: string;
+    summary: string;
+    patterns: string[];
+    pitfalls: string[];
+    prerequisites: string[];
+    skillDraft?: string;
+    confidence: number;
+    sourceSessionIDs: string[];
+};
+export type CompressionInput = {
+    sessionID: string;
+    traces: TraceRecord[];
+    messages?: unknown[];
+    notepads?: string[];
+    handoff?: unknown;
+    taskHistory?: unknown[];
+};
+export interface Compressor {
+    compress(input: CompressionInput): Promise<DistilledKnowledge>;
+}
+export type EvolutionState = {
+    totalTraces: number;
+    totalCompressions: number;
+    lastCompressionAt?: string;
+    lastPromptAt?: string;
+};
+export type SkillMeta = {
+    name: string;
+    version: string;
+    derived_from: string[];
+    created_at: string;
+    confidence: number;
+    eval_score?: number | null;
+    tags?: string[];
+    prerequisites?: string[];
+};

package/dist/features/evolution/writer.d.ts

@@ -0,0 +1,20 @@
+import type { EvolutionWriterConfig } from "../../config/schema/evolution";
+import type { DistilledKnowledge } from "./types";
+export declare class EvolutionWriter {
+    private pendingDir;
+    private skillsDir;
+    private promotedBase;
+    private globalBase?;
+    constructor(config: EvolutionWriterConfig, projectRoot?: string);
+    stage(knowledge: DistilledKnowledge): Promise<{
+        slug: string;
+        pendingPath: string;
+        metaPath: string;
+    }>;
+    promote(slug: string): Promise<{
+        promotedPath: string;
+    }>;
+    reject(slug: string): Promise<void>;
+    listPending(): Promise<string[]>;
+    listPromoted(): Promise<string[]>;
+}

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

@@ -1,12 +1,22 @@
 import type { z } from "zod";
 import type { MatrixxConfig } from "../../config/schema";
-export declare function getTaskDir(config?: Partial<MatrixxConfig>): string;
+export declare function getProjectTaskDir(directory: string): string;
+export declare function getTaskDir(config?: Partial<MatrixxConfig>, directory?: string): string;
 export declare function sanitizePathSegment(value: string): string;
 export declare function resolveTaskListId(config?: Partial<MatrixxConfig>): string;
 export declare function readJsonSafe<T>(filePath: string, schema: z.ZodType<T>): T | null;
 export declare function writeJsonAtomic(filePath: string, data: unknown): void;
+export declare function acquireLockWithRetry(dirPath: string, retries?: number): Promise<{
+    acquired: boolean;
+    release: () => void;
+}>;
 export declare function generateTaskId(): string;
-export declare function listTaskFiles(config?: Partial<MatrixxConfig>): string[];
+export declare function listTaskFiles(config?: Partial<MatrixxConfig>, directory?: string): string[];
+export declare function migrateLegacyTasksIfNeeded(config: Partial<MatrixxConfig>, directory: string): {
+    migrated: number;
+    legacyDir: string;
+    projectDir: string;
+};
 export declare function acquireLock(dirPath: string): {
     acquired: boolean;
     release: () => void;

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

@@ -1,8 +1,8 @@
 import { z } from "zod";
 export declare const TaskStatusSchema: z.ZodEnum<{
     deleted: "deleted";
-    completed: "completed";
     pending: "pending";
+    completed: "completed";
     in_progress: "in_progress";
 }>;
 export type TaskStatus = z.infer<typeof TaskStatusSchema>;
@@ -12,8 +12,8 @@ export declare const TaskSchema: z.ZodObject<{
     description: z.ZodString;
     status: z.ZodEnum<{
         deleted: "deleted";
-        completed: "completed";
         pending: "pending";
+        completed: "completed";
         in_progress: "in_progress";
     }>;
     activeForm: z.ZodOptional<z.ZodString>;
@@ -21,5 +21,6 @@ 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>>;
+    projectRoot: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type Task = z.infer<typeof TaskSchema>;

package/dist/features/task-toast-manager/types.d.ts

@@ -1,9 +1,9 @@
-import type { ModelSource } from "../../shared/model-resolver";
+import type { ModelResolutionProvenance } from "../../shared/model-resolution-pipeline";
 export type TaskStatus = "running" | "queued" | "completed" | "error";
 export interface ModelFallbackInfo {
     model: string;
     type: "user-defined" | "inherited" | "category-default" | "system-default";
-    source?: ModelSource;
+    source?: ModelResolutionProvenance;
 }
 export interface TrackedTask {
     id: string;

package/dist/hooks/anthropic-context-window-limit-recovery/message-builder.d.ts

@@ -2,6 +2,5 @@ import type { PluginInput } from "@opencode-ai/plugin";
 export declare const PLACEHOLDER_TEXT = "[user interrupted]";
 type OpencodeClient = PluginInput["client"];
 export declare function sanitizeEmptyMessagesBeforeSummarize(sessionID: string, client?: OpencodeClient): Promise<number>;
-export declare function formatBytes(bytes: number): string;
 export declare function getLastAssistant(sessionID: string, client: OpencodeClient, directory: string): Promise<Record<string, unknown> | null>;
 export {};

package/dist/hooks/anthropic-context-window-limit-recovery/tool-part-types.d.ts

@@ -1,3 +1,4 @@
+import type { TaskStatus } from "../../shared/status-types";
 export interface StoredToolPart {
     id: string;
     sessionID: string;
@@ -6,7 +7,7 @@ export interface StoredToolPart {
     callID: string;
     tool: string;
     state: {
-        status: "pending" | "running" | "completed" | "error";
+        status: TaskStatus;
         input: Record<string, unknown>;
         output?: string;
         error?: string;