opencode-matrixx 2.6.8 → 2.6.10

package/README.md

@@ -357,7 +357,7 @@ Every agent, model, temperature, and permission is fully customizable. [**Meet t
 | **Developer Tools** | LSP (goto def, rename, diagnostics), AST-Grep (search & replace), Tmux terminal |
 | **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 |
+| **Curated MCPs** | Exa (web search), Context7 (official docs), Document Reader + native `github_search` (local gh/git/rg) |
 | **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 |
 ||| **Assembly Tool** | Multi-model debate that spawns 3-5 parallel voters from different providers, collects independent reasoning, and synthesizes unified decisions with confidence scoring |

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

@@ -31,10 +31,13 @@ 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 buildArchitectReferralSection(): string;
 export declare function buildHardBlocksSection(): string;
 export declare function buildAntiPatternsSection(): string;
 export declare function _resetDisciplineCacheForTesting(): void;
 export declare function hasGrepGlobToolNames(toolNames: readonly string[]): boolean;
+export declare function fallbackFullDiscipline(hasGrepGlob: boolean): string;
+export declare function fallbackCompactDiscipline(hasGrepGlob: boolean): string;
 export declare function buildContextDisciplineSection(hasContextMode?: boolean, hasGrepGlob?: boolean): string;
 export declare function buildHeadroomSection(hasHeadroom?: boolean): string;
 export declare function buildCompactContextDisciplineSection(hasContextMode?: boolean, hasGrepGlob?: boolean): string;

package/dist/cli.js

@@ -15635,7 +15635,7 @@ function date4(params) {
 // node_modules/zod/v4/classic/external.js
 config(en_default());
 // src/mcp/types.ts
-var McpNameSchema = exports_external.enum(["websearch", "context7", "white_rabbit", "document_reader"]);
+var McpNameSchema = exports_external.enum(["websearch", "context7", "document_reader"]);
 var AnyMcpNameSchema = exports_external.string().min(1);
 
 // src/config/schema/agent-definitions.ts
@@ -16254,6 +16254,7 @@ var HookNameEnum = exports_external.enum([
   "context-mode-enforcer",
   "context-mode-enforcer",
   "task-edit-guard",
+  "document-reader-guard",
   "failure-counter"
 ]);
 var HookNameSchema = exports_external.union([

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

@@ -61,6 +61,7 @@ export declare const HookNameSchema: z.ZodUnion<readonly [z.ZodEnum<{
     "evolution-hitl": "evolution-hitl";
     "context-mode-enforcer": "context-mode-enforcer";
     "task-edit-guard": "task-edit-guard";
+    "document-reader-guard": "document-reader-guard";
     "failure-counter": "failure-counter";
 }>, z.ZodPipe<z.ZodLiteral<"anthropic-context-window-limit-recovery">, z.ZodTransform<"context-window-limit-recovery", "anthropic-context-window-limit-recovery">>]>;
 export type HookName = z.infer<typeof HookNameSchema>;

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

@@ -134,6 +134,7 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         "evolution-hitl": "evolution-hitl";
         "context-mode-enforcer": "context-mode-enforcer";
         "task-edit-guard": "task-edit-guard";
+        "document-reader-guard": "document-reader-guard";
         "failure-counter": "failure-counter";
     }>, z.ZodPipe<z.ZodLiteral<"anthropic-context-window-limit-recovery">, z.ZodTransform<"context-window-limit-recovery", "anthropic-context-window-limit-recovery">>]>>>;
     disabled_commands: z.ZodOptional<z.ZodArray<z.ZodEnum<{

package/dist/create-hooks.d.ts

@@ -53,6 +53,7 @@ export declare function createHooks(args: {
     qualityGate: ReturnType<typeof import("./hooks").createQualityGateHook> | null;
     taskNotepad: ReturnType<typeof import("./hooks").createTaskNotepadHook> | null;
     taskEditGuard: ReturnType<typeof import("./hooks").createTaskEditGuardHook> | null;
+    documentReaderGuard: ReturnType<typeof import("./hooks").createDocumentReaderGuardHook> | null;
     evolutionWatcher: ReturnType<typeof import("./hooks").createEvolutionWatcherHook> | null;
     contextWindowMonitor: ReturnType<typeof import("./hooks").createContextWindowMonitorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("./hooks").createPreemptiveCompactionHook> | null;

package/dist/hooks/directory-agents-injector/hook.d.ts

@@ -1,6 +1,25 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 export declare function createDirectoryAgentsInjectorHook(ctx: PluginInput): {
-    "tool.execute.before": (input: import("../directory-injector/factory").ToolExecuteInput, output: import("../directory-injector/factory").ToolExecuteBeforeOutput) => Promise<void>;
-    "tool.execute.after": (input: import("../directory-injector/factory").ToolExecuteInput, output: import("../directory-injector/factory").ToolExecuteOutput) => Promise<void>;
-    event: ({ event }: import("../directory-injector/factory").EventInput) => Promise<void>;
+    "tool.execute.before": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        args: unknown;
+    }) => Promise<void>;
+    "tool.execute.after": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+    event: ({ event }: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
 };

package/dist/hooks/document-reader-guard/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const HOOK_NAME = "document-reader-guard";
+export declare const BINARY_EXTENSIONS: readonly [".pdf", ".docx", ".doc", ".xlsx", ".xls", ".pptx", ".ppt", ".jpg", ".jpeg", ".png", ".gif", ".webp", ".mp3", ".wav"];
+export declare const BLOCKED_PATTERNS: RegExp[];
+export declare const READ_BLOCK_MESSAGE: string;
+export declare const BASH_BLOCK_MESSAGE: string;

package/dist/hooks/document-reader-guard/hook.d.ts

@@ -0,0 +1,2 @@
+import type { Hooks, PluginInput } from "@opencode-ai/plugin";
+export declare function createDocumentReaderGuardHook(ctx: PluginInput): Hooks;

package/dist/hooks/document-reader-guard/index.d.ts

@@ -0,0 +1,2 @@
+export { BASH_BLOCK_MESSAGE, BINARY_EXTENSIONS, BLOCKED_PATTERNS, HOOK_NAME, READ_BLOCK_MESSAGE } from "./constants";
+export { createDocumentReaderGuardHook } from "./hook";

package/dist/hooks/index.d.ts

@@ -15,6 +15,7 @@ export { createContextWindowMonitorHook } from "./context-window-monitor";
 export { createDelegateTaskRetryHook } from "./delegate-task-retry";
 export { createDesignIntentPreserverHook } from "./design-intent-preserver";
 export { createDirectoryAgentsInjectorHook } from "./directory-agents-injector";
+export { createDocumentReaderGuardHook } from "./document-reader-guard";
 export { createEditErrorRecoveryHook } from "./edit-error-recovery";
 export { createEmptyTaskResponseDetectorHook } from "./empty-task-response-detector";
 export { createEnvContextInjectorHook } from "./env-context-injector";
@@ -35,6 +36,7 @@ export { createMouseNotepadHook } from "./mouse-notepad";
 export { createNonInteractiveEnvHook } from "./non-interactive-env";
 export { createOracleMdOnlyHook } from "./oracle-md-only";
 export { createPlanPersister } from "./plan-persister";
+export { createPostReadInjectorHook } from "./post-read-injector";
 export { createPreemptiveCompactionHook } from "./preemptive-compaction";
 export { createQualityGateHook } from "./quality-gate/hook";
 export { createReadImageResizerHook } from "./read-image-resizer";

package/dist/hooks/json-error-recovery/hook.d.ts

@@ -1,5 +1,5 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-export declare const JSON_ERROR_TOOL_EXCLUDE_LIST: readonly ["bash", "read", "glob", "grep", "webfetch", "look_at", "white_rabbit_searchgithub", "websearch_web_search_exa"];
+export declare const JSON_ERROR_TOOL_EXCLUDE_LIST: readonly ["bash", "read", "glob", "grep", "webfetch", "look_at", "github_search", "websearch_web_search_exa"];
 export declare const JSON_ERROR_PATTERNS: readonly RegExp[];
 export declare const JSON_ERROR_REMINDER = "\n[JSON PARSE ERROR - IMMEDIATE ACTION REQUIRED]\n\nYou sent invalid JSON arguments to a tool. STOP and do this NOW:\n\n1. DO NOT retry with the same malformed JSON\n2. CORRECT the JSON syntax \u2014 check for: missing quotes, trailing commas, unmatched braces\n3. RETRY the tool call with valid JSON arguments\n\nThis usually means you garbled a string parameter or forgot to escape a character.\n";
 export declare function createJsonErrorRecoveryHook(_ctx: PluginInput): {

package/dist/hooks/post-read-injector/block.d.ts

@@ -0,0 +1 @@
+export declare function buildDirectoryContextBlock(sections: string[]): string;

package/dist/hooks/post-read-injector/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const MAX_DIRECTORY_CONTEXT_BYTES = 6144;
+export declare const DIRECTORY_CONTEXT_HEADER = "Directory Context";
+export declare const DIRECTORY_CONTEXT_SEPARATOR = "\n---\n";
+export declare function buildTruncationMarker(omittedChars: number): string;

package/dist/hooks/post-read-injector/hook.d.ts

@@ -0,0 +1,27 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function createPostReadInjectorHook(ctx: PluginInput, options?: {
+    trackedTools?: string[];
+}): {
+    "tool.execute.before": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        args: unknown;
+    }) => Promise<void>;
+    "tool.execute.after": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+    event: ({ event }: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+};

package/dist/hooks/post-read-injector/index.d.ts

@@ -0,0 +1,8 @@
+export { buildDirectoryContextBlock } from "./block";
+export { buildTruncationMarker, DIRECTORY_CONTEXT_HEADER, DIRECTORY_CONTEXT_SEPARATOR, MAX_DIRECTORY_CONTEXT_BYTES, } from "./constants";
+export { createPostReadInjectorHook } from "./hook";
+export type { UnifiedTruncator } from "./injector";
+export { createUnifiedPostReadProcessor } from "./injector";
+export type { RulesCache } from "./sections";
+export { readAgentsSection, readRuleSection } from "./sections";
+export { collectAncestorDirs } from "./unified-walk";

package/dist/hooks/post-read-injector/injector.d.ts

@@ -0,0 +1,18 @@
+export type UnifiedTruncator = {
+    truncate: (sessionID: string, content: string) => Promise<{
+        result: string;
+        truncated: boolean;
+    }>;
+};
+export declare function createUnifiedPostReadProcessor(deps: {
+    workspaceDirectory: string;
+    truncator: UnifiedTruncator;
+    onVisitDir?: (dir: string) => void;
+}): {
+    processFilePathForInjection: (filePath: string, sessionID: string, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+    clearSessionCache: (sessionID: string) => void;
+};

package/dist/hooks/post-read-injector/sections.d.ts

@@ -0,0 +1,7 @@
+import type { UnifiedTruncator } from "./injector";
+export type RulesCache = {
+    contentHashes: Set<string>;
+    realPaths: Set<string>;
+};
+export declare function readAgentsSection(agentsPath: string, sessionID: string, truncator: UnifiedTruncator): Promise<string | null>;
+export declare function readRuleSection(candidate: string, rel: string, reason: string, sessionID: string, truncator: UnifiedTruncator, rulesCache: RulesCache): Promise<string | null>;

package/dist/hooks/post-read-injector/unified-walk.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Single upward walk from the file's directory toward the filesystem root.
+ * Visits each ancestor exactly once (leaf-first) and reports visits via onVisit.
+ * rootDir/projectRoot only document the shared prefix — the walk itself is one loop.
+ */
+export declare function collectAncestorDirs(filePath: string, rootDir?: string | ((dir: string) => void), projectRoot?: string | ((dir: string) => void) | null, onVisit?: (dir: string) => void): string[];

package/dist/hooks/rules-injector/hook.d.ts

@@ -1,26 +1,25 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-interface ToolExecuteInput {
-    tool: string;
-    sessionID: string;
-    callID: string;
-}
-interface ToolExecuteOutput {
-    title: string;
-    output: string;
-    metadata: unknown;
-}
-interface ToolExecuteBeforeOutput {
-    args: unknown;
-}
-interface EventInput {
-    event: {
-        type: string;
-        properties?: unknown;
-    };
-}
 export declare function createRulesInjectorHook(ctx: PluginInput): {
-    "tool.execute.before": (input: ToolExecuteInput, output: ToolExecuteBeforeOutput) => Promise<void>;
-    "tool.execute.after": (input: ToolExecuteInput, output: ToolExecuteOutput) => Promise<void>;
-    event: ({ event }: EventInput) => Promise<void>;
+    "tool.execute.before": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        args: unknown;
+    }) => Promise<void>;
+    "tool.execute.after": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+    event: ({ event }: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
 };
-export {};