opencode-matrixx-v2 1.2.0 → 1.2.2

package/README.md

@@ -1,17 +1,15 @@
-[![Matrixx](./.github/assets/orchestrator-niobe.png?v=3)](https://github.com/klpanagi/opencode-matrixx)
-
 <div align="center">
 
 # Matrixx
 
 [![npm](https://img.shields.io/npm/v/opencode-matrixx.svg)](https://www.npmjs.com/package/opencode-matrixx)
-[![License: SUL-1.0](https://img.shields.io/badge/license-SUL--1.0-blue.svg)](https://github.com/klpanagi/opencode-matrixx/blob/master/LICENSE)
+[![License: SUL-1.0](https://img.shields.io/badge/license-SUL--1.0-blue.svg)](https://github.com/klpanagi/opencode-matrixx-2/blob/dev/LICENSE.md)
 [![OpenCode](https://img.shields.io/badge/built_for-OpenCode-black.svg)](https://opencode.ai/docs)
 
 **Multi-model agent orchestration for [OpenCode](https://github.com/sst/opencode).**<br/>
-**17 specialized agents. 65 lifecycle hooks. 30 tools. 50 skills. One plugin.**
+**13 specialized agents. 65 lifecycle hooks. 31 tool dirs. 70 skills. 24 commands. One plugin.**
 
-> **OpenCode v2-only.** Matrixx v2 requires OpenCode v2 (OpenCode-v2-only line). Version restart: `2.6.18` was the last legacy v1 release; v2 restarts at `3.0.0` (`2.6.18` was the last legacy v1 release).
+> **OpenCode v2-only.** Matrixx v2 requires OpenCode v2. Current release: `1.2.1`.
 
 [Quick Start](#quick-start) · [Why Matrixx?](#why-matrixx) · [How It Works](#how-it-works) · [Features](#features) · [Comparison](#how-matrixx-compares) · [Docs](docs/README.md)
 
@@ -38,10 +36,10 @@ Morpheus                    → Plans the implementation
 
 | Problem with single-agent coding | What Matrixx does |
 |----------------------------------|-------------------|
-| One model does everything averagely | **14 specialists** — orchestration, planning, implementation, security, frontend, DSL, research, search |
+| One model does everything averagely | **13 specialists** — orchestration, planning, implementation, security, frontend, DSL, research, search |
 | Agent forgets what it was doing after `/clear` | **Persistent tasks** — file-backed `.matrixx/tasks`, survives compaction and restarts |
 | Slow sequential tool calls | **Parallel background agents** — 5+ running simultaneously, optional tmux visibility |
-| AI code looks like AI code | **Quality gates** — comment checking, TDD/BDD pipeline, 5-agent review |
+| AI code looks like AI code | **Quality gates** — comment checking, TDD/BDD pipeline, 6-agent review |
 | Context window fills up fast | **5-layer context stack** — native recovery + RTK + context-mode + DCP + Headroom |
 | Fragile refactoring | **Deterministic tools** — LSP (goto-def, rename, diagnostics) + AST-Grep (structural search & replace) |
 | Secrets leak into commits | **Security by default** — secret scanning + env-file guards + read-only auditor |
@@ -78,17 +76,17 @@ Full workflows: [Overview](docs/guide/overview.md) · [Orchestration](docs/orche
 
 | Area | What you get | Details |
 |------|--------------|---------|
-| **Agent Orchestration** | 17 agents, category routing (`source`, `deep-jack`, …), session continuity, parallel background execution | [Agents](docs/agents.md) |
+| **Agent Orchestration** | 13 agents, category routing (`source`, `deep-jack`, …), session continuity, parallel background execution | [Agents](docs/agents.md) |
 | **Developer Tools** | LSP, AST-Grep search & replace, tmux terminal, task tools, assembly (multi-model debate) | [Features](docs/features.md) |
-| **Lifecycle Hooks (65-enum)** | Context injection, think mode, task/todo continuation, error recovery, quality gates, session recovery | [Hooks](docs/hooks.md) |
-| **Skills (50)** | DSL engineering (11), security (9), frontend (7), BDD (4 + pipeline), git, browser, TDD, research, AI-slop removal | [Skills](docs/category-skill-guide.md) |
+| **Lifecycle Hooks (65-enum)** | Context injection, think mode, task completion notifications, error recovery, quality gates, session recovery | [Hooks](docs/hooks.md) |
+| **Skills (70)** | DSL engineering (11), security (9), frontend (7), BDD (4 + pipeline), git, browser, TDD, research, AI-slop removal | [Skills](docs/category-skill-guide.md) |
 | **Software Dev Pipeline** | 6-phase PLAN → BUILD → VERIFY → REVIEW → SECURE → SHIP with 5 team roles, adaptive to task size | [Quality](docs/quality.md) |
 | **Context Management (L0–L4)** | Native recovery + RTK (60–90% bash savings) + context-mode sandbox + DCP pruning + Headroom proxy (60–95% JSON) | [Context](docs/context-management.md) |
 | **Security** | Secret-leak guard (gitleaks), env-file write guard, read-only Sentinel auditor with CWE-rated findings | [Hooks](docs/hooks.md) · [Agents](docs/agents.md) |
 | **Knowledge & Research** | Saturation `/research` swarms, Context7 docs, Exa web search, `github_search`, document reader, external knowledge hubs | [Features](docs/features.md) |
 | **Configurability** | Every agent, model, temperature, and hook tunable via `matrixx.jsonc` with JSON schema + Config Studio UI | [Configuration](docs/configurations.md) |
 
-Counts are schema-official: 17 agents (`BuiltinAgentNameSchema`), 50 skills (skills schema), 65-enum hooks (`src/config/schema/hooks.ts`, 72 accepted incl. 7 literals), 23 commands (23 names / 21 templates), 2 MCPs (`context7`, `document_reader`), 30 tool dirs, 23 features. The roster lives in docs — this page links, never duplicates: [Agents](docs/agents.md) · [Hooks](docs/hooks.md) · [Skills](docs/category-skill-guide.md) · [Commands](docs/command-reference.md).
+Counts are schema-official: **13 agents** (`BuiltinAgentNameSchema`), **70 skills** (`BuiltinSkillNameSchema`), **65 live hooks** (`HookNameEnum` in `src/config/schema/hooks.ts`; 73 names parse when the 7 retained-deprecated no-op literals and 1 alias are included), **24 commands** (`src/features/builtin-commands/commands.ts`), **2 MCPs** (`context7`, `document_reader`), **31 tool directories**, and **21 feature modules**. The roster lives in docs — this page links, never duplicates: [Agents](docs/agents.md) · [Hooks](docs/hooks.md) · [Skills](docs/category-skill-guide.md) · [Commands](docs/command-reference.md).
 
 ### Session memory (new, EXPERIMENTAL)
 
@@ -156,7 +154,7 @@ Full setup, CI mode, troubleshooting, and uninstall: [Installation guide](docs/g
 **Trade-offs to know**
 
 - **OpenCode-only.** Matrixx is a plugin, not a standalone agent or IDE. You adopt OpenCode to use it.
-- **Learning curve.** 17 agents, 8 categories, 50 skills, 23 commands — `ultrawork` hides this well, but mastery takes time.
+- **Learning curve.** 13 agents, 8 categories, 70 skills, 24 commands — `ultrawork` hides this well, but mastery takes time.
 - **Multiple providers help.** It runs on one provider, but the multi-model value shows with two or more connected (or the OpenCode free tier).
 - **Orchestration overhead.** Delegation costs extra tokens on trivial one-line tasks — use direct mode for those.
 - **Pinned toolchain.** Bun 1.4.4 and recent OpenCode are required; bleeding-edge OpenCode versions can break the plugin temporarily.
@@ -168,7 +166,7 @@ Full setup, CI mode, troubleshooting, and uninstall: [Installation guide](docs/g
 
 | Tool | Approach | Where Matrixx differs |
 |------|----------|-----------------------|
-| **Vanilla OpenCode** | Single powerful agent + tools | Matrixx adds the team layer: specialists, persistent tasks, 65-enum hooks, skills, and context compression. Same base, orchestrated. |
+| **Vanilla OpenCode** | Single powerful agent + tools | Matrixx adds the team layer: specialists, persistent tasks, 65 lifecycle hooks, skills, and context compression. Same base, orchestrated. |
 | **Claude Code** | Polished single-vendor agent (Anthropic models) | Matrixx is provider-agnostic and multi-model by design — mix Claude, OpenAI, Gemini, local models per role instead of one vendor. More setup, more control. |
 | **Cursor / Windsurf** | IDE-integrated agent with proprietary models | Matrixx lives in the terminal (OpenCode TUI), is fully open and configurable, and exposes its orchestration as code. No IDE lock-in, no black-box model routing. |
 | **Cline / Roo Code** | IDE-based autonomous agents, mode switching | Similar autonomy ethos; Matrixx goes further on parallelism (background swarms), persistent cross-session tasks, and deterministic refactoring tools (LSP/AST-Grep). |
@@ -191,14 +189,6 @@ Full setup, CI mode, troubleshooting, and uninstall: [Installation guide](docs/g
 Full index: [docs/README.md](docs/README.md)
 
 
-## Acknowledgment
-
-Matrixx is developed at and supported by the [Information Systems & Software Engineering Laboratory (ISSEL)](https://issel.ee.auth.gr/), Department of Electrical and Computer Engineering, Aristotle University of Thessaloniki.
-
-Research, development, and infrastructure behind Matrixx are powered, and practically funded, by ISSEL. Thank you to the lab, its members, and its students for making this work possible.
-
----
-
 If this saves you time, a ⭐ goes a long way.
 
 <sub>Productivity might spike too hard. Don't let your coworker notice. Actually, let's see who wins.</sub>

package/dist/agents/agent-config.d.ts

@@ -7,9 +7,9 @@
  * `request`, and the model is a reference rather than a "provider/model" string.
  * Building that shape here keeps the translation out of the registration path.
  */
-import type { PermissionRule } from "../shared/permission-compat";
-export type { PermissionEffect, PermissionRule } from "../shared/permission-compat";
-export { rule } from "../shared/permission-compat";
+import type { PermissionRule } from "../shared/agent/permission-compat";
+export type { PermissionEffect, PermissionRule } from "../shared/agent/permission-compat";
+export { rule } from "../shared/agent/permission-compat";
 /**
  * Agent mode determines UI model selection behavior:
  * - "primary": Respects user's UI-selected model (morpheus, niobe)

package/dist/agents/dynamic-agent-prompt-builder.d.ts

@@ -1,4 +1,4 @@
-import { type DcpCompressionMode } from "../shared/dcp-guidance";
+import { type DcpCompressionMode } from "../shared/policy/dcp-guidance";
 import type { AgentPromptMetadata } from "./types";
 export interface AvailableAgent {
     name: string;
@@ -32,6 +32,7 @@ export declare function buildDelegationTable(agents: AvailableAgent[]): string;
 export declare function formatCustomSkillsBlock(customRows: string[], customSkills: AvailableSkill[], headerLevel?: "####" | "**"): string;
 export declare function buildCategorySkillsDelegationGuide(categories: AvailableCategory[], skills: AvailableSkill[]): string;
 export declare function buildOracleSection(agents: AvailableAgent[]): string;
+export declare function buildSmithSection(agents: AvailableAgent[]): string;
 export declare function buildNiobeReferralSection(): string;
 export declare function buildHardBlocksSection(): string;
 export declare function buildAntiPatternsSection(): string;

package/dist/agents/oracle/system-prompt.d.ts

@@ -1,4 +1,4 @@
-import type { PermissionRule } from "../../shared/permission-compat";
+import type { PermissionRule } from "../../shared/agent/permission-compat";
 /**
  * Combined Oracle system prompt.
  * Assembled from modular sections for maintainability.

package/dist/cli.js

@@ -102,11 +102,87 @@ import { existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
 import { homedir as homedir3 } from "os";
 import { join as join5 } from "path";
 
-// src/shared/connected-providers-cache.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { join as join3 } from "path";
+// src/shared/config/opencode-config-dir.ts
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join, resolve } from "path";
+var TAURI_APP_IDENTIFIER = "ai.opencode.desktop";
+var TAURI_APP_IDENTIFIER_DEV = "ai.opencode.desktop.dev";
+function isDevBuild(version) {
+  if (!version)
+    return false;
+  return version.includes("-dev") || version.includes(".dev");
+}
+function getTauriConfigDir(identifier) {
+  const platform = process.platform;
+  switch (platform) {
+    case "darwin":
+      return join(homedir(), "Library", "Application Support", identifier);
+    case "win32": {
+      const appData = process.env.APPDATA || join(homedir(), "AppData", "Roaming");
+      return join(appData, identifier);
+    }
+    default: {
+      const xdgConfig = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
+      return join(xdgConfig, identifier);
+    }
+  }
+}
+function getCliConfigDir() {
+  const envConfigDir = process.env.OPENCODE_CONFIG_DIR?.trim();
+  if (envConfigDir) {
+    return resolve(envConfigDir);
+  }
+  if (process.platform === "win32") {
+    const crossPlatformDir = join(homedir(), ".config", "opencode");
+    const crossPlatformConfig = join(crossPlatformDir, "opencode.json");
+    if (existsSync(crossPlatformConfig)) {
+      return crossPlatformDir;
+    }
+    const appData = process.env.APPDATA || join(homedir(), "AppData", "Roaming");
+    const appdataDir = join(appData, "opencode");
+    const appdataConfig = join(appdataDir, "opencode.json");
+    if (existsSync(appdataConfig)) {
+      return appdataDir;
+    }
+    return crossPlatformDir;
+  }
+  const xdgConfig = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
+  return join(xdgConfig, "opencode");
+}
+function getOpenCodeConfigDir(options) {
+  const { binary, version, checkExisting = true } = options;
+  if (binary === "opencode") {
+    return getCliConfigDir();
+  }
+  const identifier = isDevBuild(version) ? TAURI_APP_IDENTIFIER_DEV : TAURI_APP_IDENTIFIER;
+  const tauriDir = getTauriConfigDir(identifier);
+  if (checkExisting) {
+    const legacyDir = getCliConfigDir();
+    const legacyConfig = join(legacyDir, "opencode.json");
+    const legacyConfigC = join(legacyDir, "opencode.jsonc");
+    if (existsSync(legacyConfig) || existsSync(legacyConfigC)) {
+      return legacyDir;
+    }
+  }
+  return tauriDir;
+}
+function getOpenCodeConfigPaths(options) {
+  const configDir = getOpenCodeConfigDir(options);
+  return {
+    configDir,
+    configJson: join(configDir, "opencode.json"),
+    configJsonc: join(configDir, "opencode.jsonc"),
+    packageJson: join(configDir, "package.json"),
+    matrixxConfig: join(configDir, "matrixx.json")
+  };
+}
+
+// src/shared/model/connected-providers-cache.ts
+import { existsSync as existsSync2, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join as join4 } from "path";
 
-// src/shared/data-path.ts
+// src/shared/config/data-path.ts
 import * as os from "os";
 import * as path from "path";
 function getCacheDir() {
@@ -119,7 +195,7 @@ function getOpenCodeCacheDir() {
   return path.join(getCacheDir(), "opencode");
 }
 
-// src/shared/logger.ts
+// src/shared/runtime/logger.ts
 import { createRequire } from "module";
 import * as os2 from "os";
 import * as path2 from "path";
@@ -134,15 +210,15 @@ function log(message, data) {
   } catch {}
 }
 
-// src/shared/connected-providers-cache.ts
+// src/shared/model/connected-providers-cache.ts
 var CONNECTED_PROVIDERS_CACHE_FILE = "connected-providers.json";
 var PROVIDER_MODELS_CACHE_FILE = "provider-models.json";
 function getCacheFilePath(filename) {
-  return join3(getOmoOpenCodeCacheDir(), filename);
+  return join4(getOmoOpenCodeCacheDir(), filename);
 }
 function readConnectedProvidersCache() {
   const cacheFile = getCacheFilePath(CONNECTED_PROVIDERS_CACHE_FILE);
-  if (!existsSync(cacheFile)) {
+  if (!existsSync2(cacheFile)) {
     log("[connected-providers-cache] Cache file not found", { cacheFile });
     return null;
   }
@@ -158,7 +234,7 @@ function readConnectedProvidersCache() {
 }
 function readProviderModelsCache() {
   const cacheFile = getCacheFilePath(PROVIDER_MODELS_CACHE_FILE);
-  if (!existsSync(cacheFile)) {
+  if (!existsSync2(cacheFile)) {
     log("[connected-providers-cache] Provider-models cache file not found", { cacheFile });
     return null;
   }
@@ -176,8 +252,8 @@ function readProviderModelsCache() {
   }
 }
 
-// src/shared/jsonc-parser.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+// src/shared/text/jsonc-parser.ts
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
 
 // node_modules/jsonc-parser/lib/esm/impl/scanner.js
 function createScanner(text, ignoreTrivia = false) {
@@ -1020,7 +1096,7 @@ function printParseErrorCode(code) {
   return "<unknown ParseErrorCode>";
 }
 
-// src/shared/jsonc-parser.ts
+// src/shared/text/jsonc-parser.ts
 function parseJsonc(content) {
   const errors = [];
   const result = parse2(content, errors, {
@@ -1059,91 +1135,15 @@ function readJsoncFile(filePath) {
 function detectConfigFile(basePath) {
   const jsoncPath = `${basePath}.jsonc`;
   const jsonPath = `${basePath}.json`;
-  if (existsSync2(jsoncPath)) {
+  if (existsSync3(jsoncPath)) {
     return { format: "jsonc", path: jsoncPath };
   }
-  if (existsSync2(jsonPath)) {
+  if (existsSync3(jsonPath)) {
     return { format: "json", path: jsonPath };
   }
   return { format: "none", path: jsonPath };
 }
 
-// src/shared/opencode-config-dir.ts
-import { existsSync as existsSync3 } from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join4, resolve } from "path";
-var TAURI_APP_IDENTIFIER = "ai.opencode.desktop";
-var TAURI_APP_IDENTIFIER_DEV = "ai.opencode.desktop.dev";
-function isDevBuild(version) {
-  if (!version)
-    return false;
-  return version.includes("-dev") || version.includes(".dev");
-}
-function getTauriConfigDir(identifier) {
-  const platform = process.platform;
-  switch (platform) {
-    case "darwin":
-      return join4(homedir2(), "Library", "Application Support", identifier);
-    case "win32": {
-      const appData = process.env.APPDATA || join4(homedir2(), "AppData", "Roaming");
-      return join4(appData, identifier);
-    }
-    default: {
-      const xdgConfig = process.env.XDG_CONFIG_HOME || join4(homedir2(), ".config");
-      return join4(xdgConfig, identifier);
-    }
-  }
-}
-function getCliConfigDir() {
-  const envConfigDir = process.env.OPENCODE_CONFIG_DIR?.trim();
-  if (envConfigDir) {
-    return resolve(envConfigDir);
-  }
-  if (process.platform === "win32") {
-    const crossPlatformDir = join4(homedir2(), ".config", "opencode");
-    const crossPlatformConfig = join4(crossPlatformDir, "opencode.json");
-    if (existsSync3(crossPlatformConfig)) {
-      return crossPlatformDir;
-    }
-    const appData = process.env.APPDATA || join4(homedir2(), "AppData", "Roaming");
-    const appdataDir = join4(appData, "opencode");
-    const appdataConfig = join4(appdataDir, "opencode.json");
-    if (existsSync3(appdataConfig)) {
-      return appdataDir;
-    }
-    return crossPlatformDir;
-  }
-  const xdgConfig = process.env.XDG_CONFIG_HOME || join4(homedir2(), ".config");
-  return join4(xdgConfig, "opencode");
-}
-function getOpenCodeConfigDir(options) {
-  const { binary, version, checkExisting = true } = options;
-  if (binary === "opencode") {
-    return getCliConfigDir();
-  }
-  const identifier = isDevBuild(version) ? TAURI_APP_IDENTIFIER_DEV : TAURI_APP_IDENTIFIER;
-  const tauriDir = getTauriConfigDir(identifier);
-  if (checkExisting) {
-    const legacyDir = getCliConfigDir();
-    const legacyConfig = join4(legacyDir, "opencode.json");
-    const legacyConfigC = join4(legacyDir, "opencode.jsonc");
-    if (existsSync3(legacyConfig) || existsSync3(legacyConfigC)) {
-      return legacyDir;
-    }
-  }
-  return tauriDir;
-}
-function getOpenCodeConfigPaths(options) {
-  const configDir = getOpenCodeConfigDir(options);
-  return {
-    configDir,
-    configJson: join4(configDir, "opencode.json"),
-    configJsonc: join4(configDir, "opencode.jsonc"),
-    packageJson: join4(configDir, "package.json"),
-    matrixxConfig: join4(configDir, "matrixx.json")
-  };
-}
-
 // src/cli/doctor/checks/auth.ts
 var ENV_PREFIX_MAP = { ANTHROPIC: "anthropic", OPENAI: "openai", GEMINI: "google", GOOGLE: "google", GITHUB: "github-copilot", ZAI: "zai-coding-plan", COPILOT: "github-copilot", VERTEX: "google" };
 function mapEnvPrefix(rawPrefix) {
@@ -5917,10 +5917,11 @@ var BuiltinAgentNameSchema = _enum([
 var BuiltinSkillNameSchema = _enum([
   "playwright",
   "agent-browser",
-  "dev-browser",
+  "playwright-cli",
   "frontend-ui-ux",
-  "git-master",
   "docker-master",
+  "git-master",
+  "dev-browser",
   "dsl-core",
   "dsl-grammar",
   "dsl-codegen",
@@ -5932,12 +5933,25 @@ var BuiltinSkillNameSchema = _enum([
   "dsl-testing",
   "dsl-validation",
   "dsl-composition",
+  "frontend-a11y",
+  "bdd-backend",
+  "bdd-contract",
+  "bdd-frontend",
+  "bdd-tests",
+  "frontend-build-tooling",
+  "frontend-perf",
+  "frontend-state-data",
+  "frontend-testing",
+  "react-nextjs-patterns",
+  "svelte-sveltekit-patterns",
+  "document-reader",
   "security-core",
   "security-secrets",
   "security-sast",
   "security-dast",
   "security-dependencies",
   "security-api",
+  "security-audit",
   "security-crypto",
   "security-infra",
   "security-review",
@@ -5948,10 +5962,13 @@ var BuiltinSkillNameSchema = _enum([
   "matrixx-self-config",
   "ulw-research",
   "remove-ai-slops",
-  "bdd-backend",
-  "bdd-contract",
-  "bdd-frontend",
-  "bdd-tests",
+  "zeromq-core",
+  "zeromq-sockets-patterns",
+  "zeromq-advanced-reqrep",
+  "zeromq-reliability",
+  "zeromq-pubsub",
+  "zeromq-architecture",
+  "zeromq-frameworks",
   "python-asyncio",
   "ccxt-rest",
   "ccxt-pro-websockets",
@@ -5964,8 +5981,9 @@ var BuiltinSkillNameSchema = _enum([
   "grafana-dashboards",
   "telegram-bot",
   "resilience-error-taxonomy",
-  "silent-failure-detection",
   "resilience-failure-hunting",
+  "silent-failure-detection",
+  "systematic-debugging",
   "data-quality-observability"
 ]);
 
@@ -6135,7 +6153,7 @@ var CommentCheckerConfigSchema = object({
   custom_prompt: string2().optional()
 });
 
-// src/shared/context-mode-enforcement.ts
+// src/shared/policy/context-mode-enforcement.ts
 import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
 import { createRequire as createRequire2 } from "module";
 import { homedir as homedir4 } from "os";
@@ -6415,7 +6433,6 @@ var HeadroomConfigSchema = object({
 
 // src/config/schema/hooks.ts
 var HookNameEnum = _enum([
-  "task-continuation-enforcer",
   "context-window-monitor",
   "session-recovery",
   "session-notification",
@@ -6489,6 +6506,7 @@ var HookNameSchema = union([
   literal("compaction-todo-preserver"),
   literal("tasks-todowrite-disabler"),
   literal("task-notepad"),
+  literal("task-continuation-enforcer"),
   literal("preemptive-compaction"),
   literal("evolution-compressor")
 ]);
@@ -7675,11 +7693,11 @@ var optionalToolsCheck = {
 import { existsSync as existsSync12, readFileSync as readFileSync10 } from "fs";
 import { join as join13 } from "path";
 
-// src/shared/sentinels.ts
+// src/shared/outcome/sentinels.ts
 var NOT_CACHED = Symbol("NOT_CACHED");
 var FALSE_PENDING_RETRY = Symbol("FALSE_PENDING_RETRY");
 
-// src/shared/opencode-version.ts
+// src/shared/config/opencode-version.ts
 function parseVersion(version) {
   const cleaned = version.replace(/^v/, "").split("-")[0];
   return cleaned.split(".").map((n) => parseInt(n, 10) || 0);
@@ -9571,7 +9589,7 @@ import { existsSync as existsSync19, readFileSync as readFileSync17 } from "fs";
 import { existsSync as existsSync16, mkdirSync as mkdirSync3, readFileSync as readFileSync14, writeFileSync as writeFileSync3 } from "fs";
 import { dirname as dirname2, join as join17 } from "path";
 
-// src/shared/deep-merge.ts
+// src/shared/config/deep-merge.ts
 var DANGEROUS_KEYS = new Set(["__proto__", "constructor", "prototype"]);
 var MAX_DEPTH = 50;
 function isPlainObject2(value) {
@@ -9761,11 +9779,11 @@ async function syncOpencodePlugins(state, opts) {
 `);
 }
 
-// src/shared/model-availability.ts
+// src/shared/model/model-availability.ts
 import { existsSync as existsSync18, readFileSync as readFileSync16 } from "fs";
 import { join as join19 } from "path";
 
-// src/shared/unwrap-list.ts
+// src/shared/runtime/unwrap-list.ts
 function unwrapList(value) {
   if (Array.isArray(value)) {
     return value;
@@ -9779,7 +9797,7 @@ function unwrapList(value) {
   return [];
 }
 
-// src/shared/model-availability.ts
+// src/shared/model/model-availability.ts
 async function getConnectedProviders(client) {
   if (!client?.provider?.list) {
     log("[getConnectedProviders] client.provider.list not available");

package/dist/config/schema/agent-names.d.ts

@@ -1,14 +1,14 @@
 import { z } from "zod";
 export declare const BuiltinAgentNameSchema: z.ZodEnum<{
-    trinity: "trinity";
-    operator: "operator";
-    merovingian: "merovingian";
-    seraph: "seraph";
-    smith: "smith";
-    construct: "construct";
     morpheus: "morpheus";
     keymaker: "keymaker";
     oracle: "oracle";
+    merovingian: "merovingian";
+    operator: "operator";
+    trinity: "trinity";
+    construct: "construct";
+    seraph: "seraph";
+    smith: "smith";
     niobe: "niobe";
     cipher: "cipher";
     sentinel: "sentinel";
@@ -17,10 +17,11 @@ export declare const BuiltinAgentNameSchema: z.ZodEnum<{
 export declare const BuiltinSkillNameSchema: z.ZodEnum<{
     playwright: "playwright";
     "agent-browser": "agent-browser";
-    "dev-browser": "dev-browser";
+    "playwright-cli": "playwright-cli";
     "frontend-ui-ux": "frontend-ui-ux";
-    "git-master": "git-master";
     "docker-master": "docker-master";
+    "git-master": "git-master";
+    "dev-browser": "dev-browser";
     "dsl-core": "dsl-core";
     "dsl-grammar": "dsl-grammar";
     "dsl-codegen": "dsl-codegen";
@@ -32,12 +33,25 @@ export declare const BuiltinSkillNameSchema: z.ZodEnum<{
     "dsl-testing": "dsl-testing";
     "dsl-validation": "dsl-validation";
     "dsl-composition": "dsl-composition";
+    "frontend-a11y": "frontend-a11y";
+    "bdd-backend": "bdd-backend";
+    "bdd-contract": "bdd-contract";
+    "bdd-frontend": "bdd-frontend";
+    "bdd-tests": "bdd-tests";
+    "frontend-build-tooling": "frontend-build-tooling";
+    "frontend-perf": "frontend-perf";
+    "frontend-state-data": "frontend-state-data";
+    "frontend-testing": "frontend-testing";
+    "react-nextjs-patterns": "react-nextjs-patterns";
+    "svelte-sveltekit-patterns": "svelte-sveltekit-patterns";
+    "document-reader": "document-reader";
     "security-core": "security-core";
     "security-secrets": "security-secrets";
     "security-sast": "security-sast";
     "security-dast": "security-dast";
     "security-dependencies": "security-dependencies";
     "security-api": "security-api";
+    "security-audit": "security-audit";
     "security-crypto": "security-crypto";
     "security-infra": "security-infra";
     "security-review": "security-review";
@@ -48,10 +62,13 @@ export declare const BuiltinSkillNameSchema: z.ZodEnum<{
     "matrixx-self-config": "matrixx-self-config";
     "ulw-research": "ulw-research";
     "remove-ai-slops": "remove-ai-slops";
-    "bdd-backend": "bdd-backend";
-    "bdd-contract": "bdd-contract";
-    "bdd-frontend": "bdd-frontend";
-    "bdd-tests": "bdd-tests";
+    "zeromq-core": "zeromq-core";
+    "zeromq-sockets-patterns": "zeromq-sockets-patterns";
+    "zeromq-advanced-reqrep": "zeromq-advanced-reqrep";
+    "zeromq-reliability": "zeromq-reliability";
+    "zeromq-pubsub": "zeromq-pubsub";
+    "zeromq-architecture": "zeromq-architecture";
+    "zeromq-frameworks": "zeromq-frameworks";
     "python-asyncio": "python-asyncio";
     "ccxt-rest": "ccxt-rest";
     "ccxt-pro-websockets": "ccxt-pro-websockets";
@@ -64,8 +81,9 @@ export declare const BuiltinSkillNameSchema: z.ZodEnum<{
     "grafana-dashboards": "grafana-dashboards";
     "telegram-bot": "telegram-bot";
     "resilience-error-taxonomy": "resilience-error-taxonomy";
-    "silent-failure-detection": "silent-failure-detection";
     "resilience-failure-hunting": "resilience-failure-hunting";
+    "silent-failure-detection": "silent-failure-detection";
+    "systematic-debugging": "systematic-debugging";
     "data-quality-observability": "data-quality-observability";
 }>;
 export type AgentName = z.infer<typeof BuiltinAgentNameSchema>;

package/dist/config/schema/browser-automation.d.ts

@@ -2,15 +2,15 @@ import { z } from "zod";
 export declare const BrowserAutomationProviderSchema: z.ZodEnum<{
     playwright: "playwright";
     "agent-browser": "agent-browser";
-    "dev-browser": "dev-browser";
     "playwright-cli": "playwright-cli";
+    "dev-browser": "dev-browser";
 }>;
 export declare const BrowserAutomationConfigSchema: z.ZodObject<{
     provider: z.ZodDefault<z.ZodEnum<{
         playwright: "playwright";
         "agent-browser": "agent-browser";
-        "dev-browser": "dev-browser";
         "playwright-cli": "playwright-cli";
+        "dev-browser": "dev-browser";
     }>>;
 }, z.core.$strip>;
 export type BrowserAutomationProvider = z.infer<typeof BrowserAutomationProviderSchema>;

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

@@ -3,12 +3,12 @@ export declare const ContextModeConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     enforce: z.ZodDefault<z.ZodBoolean>;
     blocked_tools: z.ZodDefault<z.ZodArray<z.ZodEnum<{
-        read: "read";
         grep: "grep";
         glob: "glob";
         webfetch: "webfetch";
         bash: "bash";
         shell: "shell";
+        read: "read";
     }>>>;
 }, z.core.$strip>;
 export type ContextModeConfig = z.infer<typeof ContextModeConfigSchema>;

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

@@ -5,7 +5,6 @@ export declare const HookNameSchema: z.ZodUnion<readonly [z.ZodEnum<{
     "matrix-loop": "matrix-loop";
     "start-work": "start-work";
     "evolution-watcher": "evolution-watcher";
-    "task-continuation-enforcer": "task-continuation-enforcer";
     "context-window-monitor": "context-window-monitor";
     "session-recovery": "session-recovery";
     "session-notification": "session-notification";
@@ -66,5 +65,5 @@ export declare const HookNameSchema: z.ZodUnion<readonly [z.ZodEnum<{
     "task-notepad-writer": "task-notepad-writer";
     "session-memory": "session-memory";
     "subagent-block": "subagent-block";
-}>, z.ZodPipe<z.ZodLiteral<"anthropic-context-window-limit-recovery">, z.ZodTransform<"context-window-limit-recovery", "anthropic-context-window-limit-recovery">>, z.ZodLiteral<"todo-continuation-enforcer">, z.ZodLiteral<"compaction-todo-preserver">, z.ZodLiteral<"tasks-todowrite-disabler">, z.ZodLiteral<"task-notepad">, z.ZodLiteral<"preemptive-compaction">, z.ZodLiteral<"evolution-compressor">]>;
+}>, z.ZodPipe<z.ZodLiteral<"anthropic-context-window-limit-recovery">, z.ZodTransform<"context-window-limit-recovery", "anthropic-context-window-limit-recovery">>, z.ZodLiteral<"todo-continuation-enforcer">, z.ZodLiteral<"compaction-todo-preserver">, z.ZodLiteral<"tasks-todowrite-disabler">, z.ZodLiteral<"task-notepad">, z.ZodLiteral<"task-continuation-enforcer">, z.ZodLiteral<"preemptive-compaction">, z.ZodLiteral<"evolution-compressor">]>;
 export type HookName = z.infer<typeof HookNameSchema>;