opencode-matrixx 2.6.0 → 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 |
@@ -100,6 +100,9 @@ Create `matrixx.jsonc` in your project root:
 }
 ```
 
+> **Full example:** See [`matrixx.example.jsonc`](./matrixx.example.jsonc) — a fully annotated reference covering every configuration parameter (agents, categories, **headroom**, **context-mode** (external), DCP, RTK, security, tmux, assembly, evolution, and more) with inline comments and defaults. Copy the sections you need into your project `.opencode/matrixx.jsonc` or user `~/.config/opencode/matrixx.jsonc` (both support JSONC comments).
+> Full guide: [Configuration →](docs/configurations.md) · [Context Management (5 layers) →](docs/context-management.md)
+
 ### Authenticate
 
 ```bash
@@ -157,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.
 
 ---
 
@@ -352,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 |
@@ -376,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 |
 
@@ -386,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 |
@@ -662,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/doctor/checks/context-mode.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const contextModeCheck: DoctorCheck;

package/dist/cli/doctor/checks/dcp.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const dcpCheck: DoctorCheck;

package/dist/cli/doctor/checks/docker.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const dockerCheck: DoctorCheck;

package/dist/cli/doctor/checks/headroom.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const headroomCheck: DoctorCheck;

package/dist/cli/doctor/checks/helpers.d.ts

@@ -0,0 +1,2 @@
+export declare function readMatrixxConfig(): Record<string, unknown> | null;
+export declare function getNested<T>(obj: Record<string, unknown> | null, path: string): T | undefined;

package/dist/cli/doctor/checks/index.d.ts

@@ -4,7 +4,13 @@ export declare function getChecksByCategory(category: string): DoctorCheck[];
 export declare function getCategories(): string[];
 export { authCheck } from "./auth";
 export { configValidationCheck } from "./config";
+export { contextModeCheck } from "./context-mode";
+export { dcpCheck } from "./dcp";
+export { dockerCheck } from "./docker";
+export { headroomCheck } from "./headroom";
 export { mcpPrerequisitesCheck } from "./mcp";
 export { optionalToolsCheck } from "./optional";
 export { pluginInstallationCheck } from "./plugin";
+export { rtkCheck } from "./rtk";
 export { runtimeDepsCheck } from "./runtime";
+export { tmuxCheck } from "./tmux";

package/dist/cli/doctor/checks/rtk.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const rtkCheck: DoctorCheck;

package/dist/cli/doctor/checks/tmux.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const tmuxCheck: DoctorCheck;

package/dist/cli/doctor/types.d.ts

@@ -6,7 +6,7 @@ export interface CheckResult {
     category?: string;
     detail?: string;
 }
-export type CheckCategory = "installation" | "configuration" | "authentication" | "dependencies" | "tools" | "updates";
+export type CheckCategory = "installation" | "configuration" | "authentication" | "dependencies" | "tools" | "integrations" | "updates";
 export interface DoctorCheck {
     name: string;
     category: CheckCategory;

package/dist/cli/index.d.ts

@@ -5,6 +5,7 @@
  * Commands:
  *   doctor    - Environment diagnostics and health checks
  *   install   - Interactive setup wizard (--no-tui for CI)
+ *   setup     - Standalone setup wizard for deps + matrixx.jsonc generation
  *   version   - Display version information
  *   help      - Display help information
  */

package/dist/cli/setup/config-writer.d.ts

@@ -0,0 +1,12 @@
+import { type MatrixxConfig } from "../../config/schema/matrixx-config";
+import type { SetupState } from "./types";
+export declare function resolveMatrixxConfigPath(): {
+    format: "json" | "jsonc" | "none";
+    path: string;
+};
+export declare function buildMatrixxConfig(state: SetupState, existing: MatrixxConfig | null): MatrixxConfig;
+export declare function previewDiff(existing: string, next: string): string;
+export declare function writeMatrixxConfig(targetPath: string, config: MatrixxConfig, opts: {
+    dryRun: boolean;
+    backup: boolean;
+}): Promise<void>;

package/dist/cli/setup/config-writer.test.d.ts

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

package/dist/cli/setup/constants.d.ts

@@ -0,0 +1,8 @@
+import type { Platform } from "./types";
+export declare const REQUIRED_DEPS: readonly ["bun", "opencode", "git"];
+export declare const OPTIONAL_DEPS: readonly ["headroom", "rtk", "dcp", "gitleaks", "ast-grep", "playwright"];
+export type InstallCommandMap = Record<string, Record<Platform | "all", string> | Record<string, string>>;
+export declare const PLATFORM_INSTALL_COMMANDS: Record<string, Partial<Record<Platform | "all", string>>>;
+export declare function getDcpInstallHint(): string;
+export declare function configDirHint(): string;
+export declare function dcpPluginDirHint(): string;

package/dist/cli/setup/deps.d.ts

@@ -0,0 +1,8 @@
+import { type DepStatus, type Platform } from "./types";
+export declare function isBunVersionOk(found: string): boolean;
+export declare function isOpenCodeVersionOk(found: string): boolean;
+export declare function getPlatform(): Platform;
+export declare function getInstallCommand(dep: string, platform: Platform): string;
+export declare function checkRequiredDeps(): DepStatus[];
+export declare function checkOptionalDeps(): DepStatus[];
+export declare function formatDepReport(statuses: DepStatus[]): string;

package/dist/cli/setup/deps.test.d.ts

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

package/dist/cli/setup/index.d.ts

@@ -0,0 +1,8 @@
+export { PLATFORM_INSTALL_COMMANDS } from "./constants";
+export { checkOptionalDeps, checkRequiredDeps, formatDepReport, getInstallCommand, getPlatform, isBunVersionOk, isOpenCodeVersionOk } from "./deps";
+export { runSetupPrompts } from "./prompts";
+export type { DepStatus, Platform, SetupState } from "./types";
+export declare function executeSetup(opts: {
+    dryRun: boolean;
+    yes: boolean;
+}): Promise<string>;

package/dist/cli/setup/index.test.d.ts

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

package/dist/cli/setup/opencode-sync.d.ts

@@ -0,0 +1,9 @@
+import type { SetupState } from "./types";
+export declare function resolveOpencodeConfigPath(): {
+    format: "json" | "jsonc" | "none";
+    path: string;
+};
+export declare function syncOpencodePlugins(state: SetupState, opts: {
+    dryRun: boolean;
+}): Promise<void>;
+export declare function hasContextModePlugin(plugins: string[]): boolean;

package/dist/cli/setup/opencode-sync.test.d.ts

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

package/dist/cli/setup/prompts.d.ts

@@ -0,0 +1,4 @@
+import type { DepStatus, SetupState } from "./types";
+export declare function runSetupPrompts(deps: DepStatus[], opts: {
+    yes: boolean;
+}): Promise<SetupState>;

package/dist/cli/setup/prompts.test.d.ts

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

package/dist/cli/setup/types.d.ts

@@ -0,0 +1,26 @@
+export type Platform = "darwin" | "linux" | "win32";
+export type DepStatus = {
+    name: string;
+    required: boolean;
+    found: boolean;
+    version?: string;
+    installHint: string;
+};
+export type SetupState = {
+    taskSystem: boolean;
+    headroom: {
+        enabled: boolean;
+        proxyUrl?: string;
+        project?: string;
+    };
+    rtk: {
+        enabled: boolean;
+        binaryPath?: string;
+    };
+    dcp: {
+        enabled: boolean;
+    };
+    contextMode: boolean;
+};
+export declare const BUN_REQUIRED = "1.4.0";
+export declare const OPENCODE_MIN = "1.0.150";