opencode-matrixx 2.6.1 → 2.6.2

package/README.md

@@ -13,7 +13,7 @@
 [![License: SUL-1.0](https://img.shields.io/badge/license-SUL--1.0-blue.svg)](https://github.com/klpanagi/opencode-matrixx/blob/master/LICENSE)
 
 **Multi-model agent orchestration for [OpenCode](https://github.com/sst/opencode).**<br/>
-**14 specialized agents. ~52 lifecycle hooks. 28 tools. One plugin.**
+**14 specialized agents. 64 lifecycle hooks. 22 tools. 36 skills. One plugin.**
 
 </div>
 
@@ -43,7 +43,7 @@ Morpheus (Claude Opus)     → Plans the implementation
 | Problem | Matrixx Solution |
 |---------|------------------|
 | One model does everything poorly | **14 specialists** — right model for the right job |
-| Agent forgets what it was doing | **Todo Continuation** — forces completion, no exceptions |
+| Agent forgets what it was doing | **Task Continuation** — `task-continuation-enforcer` (file-backed `.matrixx/tasks`, survives `/clear`, project-scoped) — forces completion |
 | Slow sequential tool calls | **Parallel background agents** — 5+ running simultaneously |
 | AI-generated code looks like AI | **Comment Checker** — code indistinguishable from human-written |
 | Context window fills up fast | **Aggressive delegation** — subagents carry the load |
@@ -160,7 +160,7 @@ Use `--json` for machine-readable output or `--category <name>` for a specific c
 
 **Model:** Claude Opus 4.6 · `temperature: 0.1`
 
-Plans, delegates, and executes. Fires background agents in parallel, leverages LSP and AST-Grep for surgical refactoring, and never stops until the TODO list is empty. Morpheus sees the code for what it truly is — and routes every task to the agent best suited for it.
+Plans, delegates, and executes. Fires background agents in parallel, leverages LSP and AST-Grep for surgical refactoring, and never stops until the task list is empty. Morpheus sees the code for what it truly is — and routes every task to the agent best suited for it.
 
 ---
 
@@ -355,10 +355,10 @@ Every agent, model, temperature, and permission is fully customizable. [**Meet t
 
 | | |
 |---|---|
-| **Agent Orchestration** | 15 agents (incl. **Mouse** dedicated executor, **Sati** frontend specialist, **Sentinel** security auditor, **Cipher** DSL expert), parallel background execution, category-based routing, session continuity |
+| **Agent Orchestration** | 14 agents (incl. **Mouse** task executor, **Sati** frontend specialist, **Sentinel** security auditor, **Cipher** DSL expert), parallel background execution, category-based routing (`source`/`deep-jack`/…), session continuity, file-backed tasks |
 | **Developer Tools** | LSP (goto def, rename, diagnostics), AST-Grep (search & replace), Tmux terminal |
-| **~52 Lifecycle Hooks** | Context injection, think mode, comment checking, todo enforcement, error recovery, quality gate |
-|| **33 Built-in Skills** | DSL engineering (11), security (9), browser, git, frontend (7 via **Sati**), saturation research, AI slop detection, software dev pipeline |
+| **64 Lifecycle Hooks** | Context injection, think mode, comment checking, task/todo continuation enforcement, error recovery, quality gate, preemptive compaction, session recovery |
+| **36 Built-in Skills** | DSL engineering (11), security (9), browser, git, frontend (7 via **Sati**), BDD (4: `bdd-contract`/`backend`/`frontend`/`tests` + pipeline), saturation research, AI slop detection, TDD (`tdd-enforcer` opt-in), software dev pipeline |
 | **Curated MCPs** | Exa (web search), Context7 (official docs), Grep.app (GitHub code search), Document Reader |
 | **Claude Code Compat** | Full compatibility — commands, agents, skills, MCPs, hooks from `settings.json` |
 | **Software Dev Pipeline** | 6-phase TDD workflow (PLAN→BUILD→VERIFY→REVIEW→SECURE→SHIP), 5 team roles, adaptive phases |
@@ -379,9 +379,9 @@ Matrixx includes a structured **6-phase development pipeline** that coordinates
 
 | Role | Agent | Skills | Purpose |
 |------|-------|--------|---------|
-| **Architect** | Oracle (Claude Opus) | — | System design, architecture decisions, task breakdown |
-| **Developer** | Source category | `git-master`, `tdd-enforcer` | Implementation code with TDD |
-| **Tester** | Source category | `tdd-enforcer`, `quality-gate` | Test authoring, coverage, verification |
+| **Architect** | Oracle (`claude-sonnet-4-6`) | — | System design, architecture decisions, plan (`/.matrixx/plans/*.md`) breakdown |
+| **Developer** | `category="source"` (Mouse) | `git-master`, `tdd-enforcer` (opt-in `tdd_enforcer.enabled=true`) | Implementation — RED→GREEN→REFACTOR per task |
+| **Tester** | `category="source"` (Mouse) | `tdd-enforcer`, `quality-gate` | Test authoring (`src/**/*.test.ts`, `//#given//#when//#then`), coverage |
 | **Quality Evaluator** | Red-pill category | `quality-gate`, `review-work` | Lint, typecheck, 5-agent code review |
 | **Security Expert** | Sentinel (Claude Opus) | `security-core`, `security-sast`, `security-api`, `security-dependencies` | Vulnerability scanning, CVE checks |
 
@@ -389,7 +389,7 @@ Matrixx includes a structured **6-phase development pipeline** that coordinates
 
 | Phase | Skip? | Role | Exit Criteria |
 |-------|-------|------|---------------|
-| **PLAN** | Small tasks | Architect | Approach defined, files listed, edge cases documented |
+| **PLAN** | Small tasks | Architect (Oracle) | Approach defined, files listed, edge cases + test decision (`TDD/tests-after/none`) documented |
 | **BUILD** | Never | Developer | TDD (RED→GREEN→REFACTOR), `bun test` passes |
 | **VERIFY** | Never | Quality | `lint` + `typecheck` + `test` + `build` — all pass |
 | **REVIEW** | Small tasks | Quality (5-agent) | All reviewers PASS, no CRITICAL/MAJOR issues |
@@ -665,6 +665,8 @@ To disable, set `headroom.enabled: false` or run OpenCode without `headroom wrap
 | [Orchestration](docs/orchestration-guide.md) | How agents coordinate, delegate, and recover |
 | [Categories & Skills](docs/category-skill-guide.md) | Task categories, skill injection, delegation patterns |
 | [Context Management](docs/context-management.md) | 5-layer context stack (Native, RTK, context-mode, DCP, Headroom) — setup, config, verification |
+| [Task System](docs/task-system.md) | File-backed execution substrate (`.matrixx/tasks/T-{uuid}.json`), dependency graph, `task-continuation-enforcer` |
+| [TDD](docs/tdd.md) | RED→GREEN→REFACTOR planning (Oracle) + enforcement (`tdd-enforcer` opt-in) |
 
 ---
 

package/dist/cli.js

@@ -15868,6 +15868,13 @@ var CommentCheckerConfigSchema = exports_external.object({
   custom_prompt: exports_external.string().optional()
 });
 
+// src/config/schema/context-mode.ts
+var ContextModeConfigSchema = exports_external.object({
+  enabled: exports_external.boolean().default(true),
+  enforce: exports_external.boolean().default(false),
+  blocked_tools: exports_external.array(exports_external.string()).default(["read", "grep", "glob"])
+});
+
 // src/config/schema/dcp.ts
 var DcpCompressOverrideSchema = exports_external.object({
   maxContextLimit: exports_external.union([exports_external.number(), exports_external.string().regex(/^\d+%$/)]).optional(),
@@ -16190,6 +16197,8 @@ var HookNameSchema = exports_external.enum([
   "evolution-compressor",
   "evolution-quality-gate",
   "evolution-hitl",
+  "context-mode-enforcer",
+  "task-edit-guard",
   "task-edit-guard"
 ]);
 
@@ -16381,6 +16390,7 @@ var MatrixxConfigSchema = exports_external.object({
   agent_definitions: AgentDefinitionsConfigSchema.optional(),
   matrixx_self_config: MatrixxSelfConfigSkillConfigSchema.optional(),
   headroom: HeadroomConfigSchema.optional(),
+  context_mode: ContextModeConfigSchema.optional(),
   rtk: RtkConfigSchema.optional(),
   evolution: EvolutionConfigSchema.optional(),
   _migrations: exports_external.array(exports_external.string()).optional()
@@ -16461,6 +16471,27 @@ var configValidationCheck = {
 // src/cli/doctor/checks/context-mode.ts
 import { existsSync as existsSync6, readFileSync as readFileSync5 } from "fs";
 import { join as join7 } from "path";
+function loadContextModeConfig() {
+  const dir = getOpenCodeConfigDir({ binary: "opencode" });
+  const bases = [join7(dir, "matrixx"), join7(process.cwd(), ".opencode", "matrixx"), join7(process.cwd(), "matrixx")];
+  for (const base of bases) {
+    for (const ext of [".jsonc", ".json"]) {
+      const p = `${base}${ext}`;
+      if (!existsSync6(p))
+        continue;
+      try {
+        const c = readFileSync5(p, "utf-8");
+        const parsed = parseJsoncSafe(c);
+        if (!parsed.data || parsed.errors.length > 0)
+          continue;
+        const cm = parsed.data.context_mode;
+        if (cm && typeof cm.enabled === "boolean")
+          return { enabled: cm.enabled };
+      } catch {}
+    }
+  }
+  return null;
+}
 function hasContextModePlugin() {
   const dir = getOpenCodeConfigDir({ binary: "opencode" });
   for (const name of ["opencode.jsonc", "opencode.json"]) {
@@ -16489,6 +16520,15 @@ var contextModeCheck = {
   name: "context-mode-integration",
   category: "integrations",
   check: () => {
+    const cfg = loadContextModeConfig();
+    if (cfg && !cfg.enabled) {
+      return {
+        name: "context-mode-integration",
+        status: "pass",
+        message: "context-mode disabled via matrixx.jsonc \u2014 skipping",
+        detail: "Set context_mode.enabled:true in matrixx.jsonc to enable discipline and enforcer"
+      };
+    }
     const hasPlugin = hasContextModePlugin();
     const cacheDir = getOmoOpenCodeCacheDir();
     const hasCache = existsSync6(cacheDir);

package/dist/config/schema/context-mode.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+export declare const ContextModeConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    enforce: z.ZodDefault<z.ZodBoolean>;
+    blocked_tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ContextModeConfig = z.infer<typeof ContextModeConfigSchema>;

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

@@ -62,6 +62,7 @@ export declare const HookNameSchema: z.ZodEnum<{
     "mcp-startup-notification": "mcp-startup-notification";
     "evolution-quality-gate": "evolution-quality-gate";
     "evolution-hitl": "evolution-hitl";
+    "context-mode-enforcer": "context-mode-enforcer";
     "task-edit-guard": "task-edit-guard";
 }>;
 export type HookName = z.infer<typeof HookNameSchema>;

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

@@ -130,6 +130,7 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         "mcp-startup-notification": "mcp-startup-notification";
         "evolution-quality-gate": "evolution-quality-gate";
         "evolution-hitl": "evolution-hitl";
+        "context-mode-enforcer": "context-mode-enforcer";
         "task-edit-guard": "task-edit-guard";
     }>>>;
     disabled_commands: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -1912,6 +1913,11 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         project: z.ZodOptional<z.ZodString>;
         backend: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    context_mode: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        enforce: z.ZodDefault<z.ZodBoolean>;
+        blocked_tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
     rtk: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         binary_path: z.ZodOptional<z.ZodString>;

package/dist/config/schema.d.ts

@@ -9,6 +9,7 @@ export * from "./schema/browser-automation";
 export * from "./schema/categories";
 export * from "./schema/commands";
 export * from "./schema/comment-checker";
+export * from "./schema/context-mode";
 export * from "./schema/dcp";
 export * from "./schema/evolution";
 export * from "./schema/experimental";

package/dist/create-hooks.d.ts

@@ -45,6 +45,7 @@ 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;
+    contextModeEnforcer: ReturnType<typeof import("./hooks").createContextModeEnforcerHook> | null;
     readImageResizer: ReturnType<typeof import("./hooks").createReadImageResizerHook> | null;
     webfetchRedirectGuard: ReturnType<typeof import("./hooks").createWebFetchRedirectGuardHook> | null;
     hashlineEditDiffEnhancer: ReturnType<typeof import("./hooks").createHashlineEditDiffEnhancerHook> | null;

package/dist/hooks/context-mode-enforcer/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const HOOK_NAME = "context-mode-enforcer";
+export declare const WARN_MESSAGE_READ = "Use ctx_search / ctx_batch_execute / ctx_execute for analysis \u2014 raw read/grep/glob bypasses FTS5 sandbox and pollutes context. Use Read only with hashline IDs for Edit.";
+export declare const BLOCK_MESSAGE_GREP_GLOB = "Blocked: raw grep/glob is forbidden when context-mode is enforced. Use ctx_search (indexed) \u2192 grep/glob fallback only when ctx_* unavailable, or ctx_batch_execute / ctx_execute for multi-file analysis.";
+export declare const WARN_MESSAGE_BASH_READ = "Use ctx_* / Read tool instead of `cat`/`head`/`tail`/`grep` via bash for analysis. Raw bash file reads bypass sandbox.";
+export declare const DEFAULT_BLOCKED_TOOLS: readonly ["grep", "glob"];
+export declare const WARN_ONLY_TOOLS: readonly ["read"];

package/dist/hooks/context-mode-enforcer/hook.d.ts

@@ -0,0 +1,3 @@
+import type { Hooks } from "@opencode-ai/plugin";
+import type { MatrixxConfig } from "../../config";
+export declare function createContextModeEnforcerHook(pluginConfig: MatrixxConfig): Hooks;

package/dist/hooks/context-mode-enforcer/index.d.ts

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

package/dist/hooks/index.d.ts

@@ -9,6 +9,7 @@ export { createCategorySkillReminderHook } from "./category-skill-reminder";
 export { createCommentCheckerHooks } from "./comment-checker";
 export { createCompactionContextInjector } from "./compaction-context-injector";
 export { createCompactionTodoPreserverHook } from "./compaction-todo-preserver";
+export { createContextModeEnforcerHook } from "./context-mode-enforcer";
 export { createContextWindowMonitorHook } from "./context-window-monitor";
 export { createDelegateTaskRetryHook } from "./delegate-task-retry";
 export { createDesignIntentPreserverHook } from "./design-intent-preserver";

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

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

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

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

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

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

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

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