opencode-matrixx 2.6.9 → 2.6.11

package/dist/matrixx.schema.json

@@ -220,7 +220,11 @@
               "evolution-hitl",
               "context-mode-enforcer",
               "task-edit-guard",
-              "failure-counter"
+              "document-reader-guard",
+              "failure-counter",
+              "knowledge-hub-guard",
+              "knowledge-hub-injector",
+              "knowledge-hub-search-nudge"
             ]
           },
           {}
@@ -245,12 +249,7 @@
           "research",
           "assembly",
           "ultrawork",
-          "bdd-backend",
-          "bdd-contract",
-          "bdd-frontend",
-          "bdd-pipeline",
-          "bdd-tests",
-          "dcp-profile"
+          "bdd-pipeline"
         ]
       }
     },
@@ -3975,117 +3974,7 @@
           "type": "boolean"
         },
         "profiles": {
-          "default": {
-            "economy": {
-              "pruneNotification": "off",
-              "compress": {
-                "maxContextLimit": "30%",
-                "minContextLimit": "20%",
-                "nudgeFrequency": 2,
-                "nudgeForce": "strong",
-                "iterationNudgeThreshold": 7
-              },
-              "turnProtection": {
-                "enabled": false
-              },
-              "experimental": {
-                "allowSubAgents": false
-              },
-              "strategies": {
-                "purgeErrors": {
-                  "turns": 1
-                }
-              }
-            },
-            "balanced": {
-              "pruneNotification": "minimal",
-              "compress": {
-                "maxContextLimit": "60%",
-                "minContextLimit": "30%",
-                "nudgeFrequency": 3,
-                "nudgeForce": "strong",
-                "iterationNudgeThreshold": 10
-              },
-              "turnProtection": {
-                "enabled": true,
-                "turns": 2
-              },
-              "experimental": {
-                "allowSubAgents": true
-              },
-              "strategies": {
-                "purgeErrors": {
-                  "turns": 2
-                }
-              }
-            },
-            "performance": {
-              "pruneNotification": "minimal",
-              "compress": {
-                "maxContextLimit": "80%",
-                "minContextLimit": "35%",
-                "nudgeFrequency": 4,
-                "nudgeForce": "strong",
-                "iterationNudgeThreshold": 12
-              },
-              "turnProtection": {
-                "enabled": true,
-                "turns": 3
-              },
-              "experimental": {
-                "allowSubAgents": true
-              },
-              "strategies": {
-                "purgeErrors": {
-                  "turns": 2
-                }
-              }
-            },
-            "ultimate": {
-              "pruneNotification": "detailed",
-              "compress": {
-                "maxContextLimit": "85%",
-                "minContextLimit": "40%",
-                "nudgeFrequency": 5,
-                "nudgeForce": "strong",
-                "iterationNudgeThreshold": 15,
-                "protectTags": true
-              },
-              "turnProtection": {
-                "enabled": true,
-                "turns": 5
-              },
-              "experimental": {
-                "allowSubAgents": true
-              },
-              "strategies": {
-                "purgeErrors": {
-                  "turns": 4
-                }
-              }
-            },
-            "brutal": {
-              "pruneNotification": "off",
-              "compress": {
-                "maxContextLimit": "20%",
-                "minContextLimit": "10%",
-                "nudgeFrequency": 1,
-                "nudgeForce": "strong",
-                "iterationNudgeThreshold": 1
-              },
-              "turnProtection": {
-                "enabled": false
-              },
-              "experimental": {
-                "allowSubAgents": false
-              },
-              "strategies": {
-                "purgeErrors": {
-                  "turns": 1
-                }
-              }
-            }
-          },
+          "default": {},
           "type": "object",
           "propertyNames": {
             "type": "string"
@@ -4650,6 +4539,66 @@
         }
       ]
     },
+    "knowledge": {
+      "type": "object",
+      "properties": {
+        "hubs": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "path": {
+                "type": "string"
+              },
+              "index": {
+                "default": "_index.md",
+                "type": "string"
+              },
+              "scope": {
+                "default": "global",
+                "type": "string",
+                "enum": [
+                  "global",
+                  "project"
+                ]
+              },
+              "mode": {
+                "default": "router-only",
+                "type": "string",
+                "enum": [
+                  "router-only",
+                  "pinned"
+                ]
+              },
+              "exclude": {
+                "default": [],
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "name",
+              "path",
+              "index",
+              "scope",
+              "mode",
+              "exclude"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "hubs"
+      ],
+      "additionalProperties": false
+    },
     "matrix_loop": {
       "type": "object",
       "properties": {
@@ -4924,7 +4873,7 @@
       "type": "object",
       "properties": {
         "enabled": {
-          "default": false,
+          "default": true,
           "type": "boolean"
         }
       },
@@ -5094,6 +5043,28 @@
       ],
       "additionalProperties": false
     },
+    "tool_gating": {
+      "type": "object",
+      "properties": {
+        "bdd_tools": {
+          "type": "boolean"
+        },
+        "pdf_figures": {
+          "type": "boolean"
+        },
+        "look_at": {
+          "type": "boolean"
+        },
+        "preset_tools": {
+          "default": false,
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "preset_tools"
+      ],
+      "additionalProperties": false
+    },
     "security": {
       "type": "object",
       "properties": {

package/dist/mcp/types.d.ts

@@ -2,7 +2,6 @@ import { z } from "zod";
 export declare const McpNameSchema: z.ZodEnum<{
     websearch: "websearch";
     context7: "context7";
-    white_rabbit: "white_rabbit";
     document_reader: "document_reader";
 }>;
 export type McpName = z.infer<typeof McpNameSchema>;

package/dist/plugin/hooks/create-core-hooks.d.ts

@@ -9,6 +9,7 @@ export declare function createCoreHooks(args: {
     inputSecretGuard: ReturnType<typeof import("../../hooks").createInputSecretGuardHook> | null;
     keywordDetector: ReturnType<typeof import("../../hooks").createKeywordDetectorHook> | null;
     contextInjectorMessagesTransform: ReturnType<typeof import("../../features/context-injector").createContextInjectorMessagesTransformHook>;
+    knowledgeHubInjector: ReturnType<typeof import("../../hooks").createKnowledgeHubInjectorHook> | null;
     envContextInjector: ReturnType<typeof import("../../hooks").createEnvContextInjectorHook> | null;
     thinkingBlockValidator: ReturnType<typeof import("../../hooks").createThinkingBlockValidatorHook> | null;
     toolPairValidator: ReturnType<typeof import("../../hooks").createToolPairValidatorHook> | null;
@@ -33,6 +34,9 @@ export declare function createCoreHooks(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;
+    knowledgeHubGuard: ReturnType<typeof import("../../hooks").createKnowledgeHubGuardHook> | null;
+    knowledgeHubSearchNudge: ReturnType<typeof import("../../hooks").createKnowledgeHubSearchNudgeHook> | null;
     evolutionWatcher: ReturnType<typeof import("../../hooks").createEvolutionWatcherHook> | null;
     contextWindowMonitor: ReturnType<typeof import("../../hooks").createContextWindowMonitorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("../../hooks").createPreemptiveCompactionHook> | null;

package/dist/plugin/hooks/create-tool-guard-hooks.d.ts

@@ -1,5 +1,5 @@
 import type { HookName, MatrixxConfig } from "../../config";
-import { createBackgroundTaskBlockerHook, createBashFileReadGuardHook, createCommentCheckerHooks, createContextModeEnforcerHook, createDirectoryAgentsInjectorHook, createEmptyTaskResponseDetectorHook, createEnvFileWriteGuardHook, createEvolutionWatcherHook, createHashlineEditDiffEnhancerHook, createHashlineReadEnhancerHook, createJsonErrorRecoveryHook, createQualityGateHook, createReadImageResizerHook, createRulesInjectorHook, createSecretLeakGuardHook, createTaskEditGuardHook, createTaskNotepadHook, createTasksTodowriteDisablerHook, createToolOutputTruncatorHook, createWebFetchRedirectGuardHook, createWriteExistingFileGuardHook } from "../../hooks";
+import { createBackgroundTaskBlockerHook, createBashFileReadGuardHook, createCommentCheckerHooks, createContextModeEnforcerHook, createDirectoryAgentsInjectorHook, createDocumentReaderGuardHook, createEmptyTaskResponseDetectorHook, createEnvFileWriteGuardHook, createEvolutionWatcherHook, createHashlineEditDiffEnhancerHook, createHashlineReadEnhancerHook, createJsonErrorRecoveryHook, createKnowledgeHubGuardHook, createKnowledgeHubSearchNudgeHook, createQualityGateHook, createReadImageResizerHook, createRulesInjectorHook, createSecretLeakGuardHook, createTaskEditGuardHook, createTaskNotepadHook, createTasksTodowriteDisablerHook, createToolOutputTruncatorHook, createWebFetchRedirectGuardHook, createWriteExistingFileGuardHook } from "../../hooks";
 import type { PluginContext } from "../types";
 export type ToolGuardHooks = {
     backgroundTaskBlocker: ReturnType<typeof createBackgroundTaskBlockerHook> | null;
@@ -22,6 +22,9 @@ export type ToolGuardHooks = {
     qualityGate: ReturnType<typeof createQualityGateHook> | null;
     taskNotepad: ReturnType<typeof createTaskNotepadHook> | null;
     taskEditGuard: ReturnType<typeof createTaskEditGuardHook> | null;
+    documentReaderGuard: ReturnType<typeof createDocumentReaderGuardHook> | null;
+    knowledgeHubGuard: ReturnType<typeof createKnowledgeHubGuardHook> | null;
+    knowledgeHubSearchNudge: ReturnType<typeof createKnowledgeHubSearchNudgeHook> | null;
     evolutionWatcher: ReturnType<typeof createEvolutionWatcherHook> | null;
 };
 export declare function createToolGuardHooks(args: {

package/dist/plugin/hooks/create-transform-hooks.d.ts

@@ -1,12 +1,13 @@
 import type { MatrixxConfig } from "../../config";
 import { createContextInjectorMessagesTransformHook } from "../../features/context-injector";
-import { createDesignIntentPreserverHook, createEnvContextInjectorHook, createKeywordDetectorHook, createThinkingBlockValidatorHook, createToolPairValidatorHook } from "../../hooks";
+import { createDesignIntentPreserverHook, createEnvContextInjectorHook, createKeywordDetectorHook, createKnowledgeHubInjectorHook, createThinkingBlockValidatorHook, createToolPairValidatorHook } from "../../hooks";
 import { createInputSecretGuardHook } from "../../hooks/input-secret-guard";
 import type { PluginContext } from "../types";
 export type TransformHooks = {
     inputSecretGuard: ReturnType<typeof createInputSecretGuardHook> | null;
     keywordDetector: ReturnType<typeof createKeywordDetectorHook> | null;
     contextInjectorMessagesTransform: ReturnType<typeof createContextInjectorMessagesTransformHook>;
+    knowledgeHubInjector: ReturnType<typeof createKnowledgeHubInjectorHook> | null;
     envContextInjector: ReturnType<typeof createEnvContextInjectorHook> | null;
     thinkingBlockValidator: ReturnType<typeof createThinkingBlockValidatorHook> | null;
     toolPairValidator: ReturnType<typeof createToolPairValidatorHook> | null;

package/dist/plugin/tool-gating.d.ts

@@ -0,0 +1,33 @@
+/** Directories never descended into during the bounded startup scan. */
+export declare const TOOL_GATING_SKIP_DIRS: readonly string[];
+/** Maximum directory depth visited by the startup scan. */
+export declare const TOOL_GATING_MAX_DEPTH = 4;
+/** Maximum filesystem entries visited before the scan gives up. */
+export declare const TOOL_GATING_MAX_ENTRIES = 2000;
+/** File extensions that trigger look_at registration (lowercase, with leading dot). */
+export declare const LOOK_AT_MEDIA_EXTENSIONS: readonly string[];
+/** File extension that triggers BDD tool registration. */
+export declare const BDD_FILE_EXTENSION = ".feature";
+/** File extension that triggers pdf_extract_figures registration. */
+export declare const PDF_FILE_EXTENSION = ".pdf";
+/**
+ * Bounded sync scan: true when a file with one of the given extensions exists
+ * under the directory. Skips ignored dirs, caps depth and entries, exits early
+ * on the first match. Never throws — returns false on any filesystem error.
+ */
+export declare function directoryHasMatch(directory: string | undefined, extensions: readonly string[]): boolean;
+/** True unless the construct agent is listed in disabled_agents (case-insensitive). */
+export declare function isConstructAgentEnabled(disabledAgents: readonly string[] | undefined): boolean;
+/** BDD tools: explicit override wins, otherwise auto iff a *.feature file is found. */
+export declare function shouldEnableBddTools(directory: string | undefined, override: boolean | undefined): boolean;
+/** pdf_extract_figures: explicit override wins, otherwise auto iff a *.pdf file is found. */
+export declare function shouldEnablePdfFigures(directory: string | undefined, override: boolean | undefined): boolean;
+/**
+ * look_at: explicit true forces registration (bypasses both gates), explicit
+ * false forces skip, otherwise requires construct enabled AND a media file.
+ */
+export declare function shouldEnableLookAt(directory: string | undefined, constructEnabled: boolean, override: boolean | undefined): boolean;
+/** knowledge_hub_confirm: register iff at least one knowledge hub is configured. */
+export declare function shouldEnableKnowledgeHubConfirm(hubs: readonly unknown[] | undefined): boolean;
+/** preset: opt-in only, default false. */
+export declare function shouldEnablePresetTools(override: boolean | undefined): boolean;

package/dist/shared/dcp-guidance.d.ts

@@ -0,0 +1,16 @@
+/**
+ * How DCP compression is available. "guided" = DCP auto-mode (nudges drive
+ * DCP's `compress` tool); "manual" = DCP manualMode (tool exists,
+ * trigger-only, no nudges); "none" = no `compress` tool exists.
+ */
+export type DcpCompressionMode = "guided" | "manual" | "none";
+export declare function _setDcpConfigPathForTesting(p: string | null | undefined): void;
+export declare function _resetDcpGuidanceForTesting(): void;
+/**
+ * How DCP compression is available in this environment.
+ * True model (DCP owns the only `compress` tool — the host has none):
+ * - "guided": DCP auto-mode — never bare without message IDs; proactive on closed sections with IDs + usage signals.
+ * - "manual": DCP manualMode — call `compress` only after the manual trigger; no nudges.
+ * - "none": no `compress` tool exists — never call it.
+ */
+export declare function resolveDcpCompressionMode(): DcpCompressionMode;

package/dist/{tools/dcp-switch-profile/tools.d.ts → shared/dcp-switch-profile.d.ts}

@@ -1,5 +1,4 @@
-import { type ToolDefinition } from "@opencode-ai/plugin/tool";
-import type { DcpConfig } from "../../config/schema/dcp";
+import type { DcpConfig } from "../config/schema/dcp";
 export interface DcpSwitchProfileOptions {
     pluginConfig?: {
         dcp?: DcpConfig;
@@ -12,4 +11,3 @@ export declare function deepMergeProfile(builtin: Record<string, unknown>, overr
  * a full inline DCP config to ~/.config/opencode/dcp.jsonc.
  */
 export declare function switchProfile(profile: string, options?: DcpSwitchProfileOptions): string;
-export declare function createDcpSwitchProfileTool(options?: DcpSwitchProfileOptions): Record<string, ToolDefinition>;

package/dist/shared/index.d.ts

@@ -6,6 +6,7 @@ export * from "./config-errors";
 export * from "./connected-providers-cache";
 export * from "./context-mode-enforcement";
 export * from "./data-path";
+export * from "./dcp-switch-profile";
 export * from "./deep-merge";
 export * from "./delay";
 export * from "./dynamic-truncator";

package/dist/tools/background-task/constants.d.ts

@@ -1,3 +1,4 @@
 export declare const BACKGROUND_OUTPUT_DESCRIPTION = "Get output from background task. Use full_session=true to fetch session messages with filters. System notifies on completion, so block=true rarely needed.";
 export declare const BACKGROUND_CANCEL_DESCRIPTION = "Cancel running background task(s). Use all=true to cancel ALL before final answer.";
 export declare const BACKGROUND_REVIVE_DESCRIPTION = "Revive a retained terminal background task with a NEW instruction.\n\nCall with no arguments (or list=true) to DISCOVER revivable tasks.\n\nRevivable: cancelled, stopped, interrupt, error, completed \u2014 provided the task still has a session ID.\nNot revivable: pending/running (still active \u2014 use background_output), statusUncertain (unknown liveness \u2014 pass force=true to acknowledge), and tasks that never produced a session (e.g. queue-saturated).\n\nHandles are retained for 30 minutes, so revive works after a task was pruned or the plugin restarted.";
+export declare const BACKGROUND_WAIT_ALL_DESCRIPTION = "Wait for ALL running/pending background tasks in the current session to complete. Polls until all tasks reach a terminal state or timeout. Use this BEFORE background_cancel(all=true) to allow exploration tasks to finish and return their results.";

package/dist/tools/background-task/create-background-wait-all.d.ts

@@ -0,0 +1,3 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { BackgroundManager } from "../../features/background-agent";
+export declare function createBackgroundWaitAll(manager: BackgroundManager): ToolDefinition;

package/dist/tools/background-task/index.d.ts

@@ -1,3 +1,3 @@
 export * from "./constants";
-export { createBackgroundCancel, createBackgroundOutput, createBackgroundRevive, } from "./tools";
+export { createBackgroundCancel, createBackgroundOutput, createBackgroundRevive, createBackgroundWaitAll, } from "./tools";
 export type * from "./types";

package/dist/tools/background-task/tools.d.ts

@@ -2,3 +2,4 @@ export type { BackgroundCancelClient, BackgroundOutputClient, BackgroundOutputMa
 export { createBackgroundCancel } from "./create-background-cancel";
 export { createBackgroundOutput } from "./create-background-output";
 export { createBackgroundRevive } from "./create-background-revive";
+export { createBackgroundWaitAll } from "./create-background-wait-all";

package/dist/tools/background-task/types.d.ts

@@ -13,6 +13,9 @@ export interface BackgroundCancelArgs {
     taskId?: string;
     all?: boolean;
 }
+export interface BackgroundWaitAllArgs {
+    timeout?: number;
+}
 export interface BackgroundReviveArgs {
     taskId?: string;
     session_id?: string;

package/dist/tools/delegate-task/constants.d.ts

@@ -1,5 +1,11 @@
 import type { AvailableCategory, AvailableSkill } from "../../agents/dynamic-agent-prompt-builder";
 import type { CategoryConfig } from "../../config/schema";
+export declare const TDD_TEST_FIRST_APPEND = "<TDD_Test_First>\n**NO IMPLEMENTATION WITHOUT A FAILING TEST FIRST.**\n\nMandatory RED-GREEN-REFACTOR cycle:\n- RED: write a failing test first; run it and confirm it fails for the right reason.\n- GREEN: write the minimum code to make the test pass.\n- REFACTOR: clean up; tests stay green throughout.\n\nEvery test uses //#given (setup), //#when (action), //#then (assert) markers.\nVerify with `bun test` (0 failures) before reporting done.\n</TDD_Test_First>";
+/**
+ * Code-writing categories requiring TDD enforcement (issue #127).
+ * Single source of truth for banner gating + fail-closed guard.
+ */
+export declare function isCodeWritingCategory(category: string | undefined): boolean;
 export declare const DEFAULT_CATEGORIES: Record<string, CategoryConfig>;
 export declare const CATEGORY_PROMPT_APPENDS: Record<string, string>;
 export declare const CATEGORY_DESCRIPTIONS: Record<string, string>;

package/dist/tools/delegate-task/prompt-builder.d.ts

@@ -2,5 +2,6 @@ import type { BuildSystemContentInput } from "./types";
 /**
  * Build the system content to inject into the agent prompt.
  * Combines skill content, category prompt append, and plan agent system prepend.
+ * Appends the TDD test-first banner LAST only for code-writing categories.
  */
 export declare function buildSystemContent(input: BuildSystemContentInput): string | undefined;

package/dist/tools/delegate-task/prompt-builder.tdd.test.d.ts

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

package/dist/tools/delegate-task/tdd-enforcement.test.d.ts

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

package/dist/tools/delegate-task/tools.d.ts

@@ -3,4 +3,10 @@ import type { DelegateTaskToolOptions } from "./types";
 export { resolveCategoryConfig } from "./categories";
 export { buildSystemContent } from "./prompt-builder";
 export type { BuildSystemContentInput, DelegateTaskToolOptions, SyncSessionCreatedEvent } from "./types";
+/**
+ * Fail-closed TDD enforcement for code-writing delegations (issue #127).
+ * Returns a hard error string when the delegation must be rejected, else null.
+ * Complexity: 1 — single exception path (source without the skill).
+ */
+export declare function requireTddEnforcerForCodeWriting(category: string | undefined, loadSkills: string[]): string | null;
 export declare function createDelegateTask(options: DelegateTaskToolOptions): ToolDefinition;

package/dist/tools/delegate-task/types.d.ts

@@ -81,6 +81,7 @@ export interface BuildSystemContentInput {
     skillContent?: string;
     categoryPromptAppend?: string;
     agentName?: string;
+    category?: string;
     availableCategories?: AvailableCategory[];
     availableSkills?: AvailableSkill[];
 }

package/dist/tools/github-search/cli.d.ts

@@ -0,0 +1,7 @@
+import type { GithubSearchResult } from "./types";
+export declare function githubSearch(opts: {
+    query: string;
+    repo?: string;
+    language?: string;
+    limit?: number;
+}): Promise<GithubSearchResult>;

package/dist/tools/github-search/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const DEFAULT_TIMEOUT_MS = 60000;
+export declare const DEFAULT_MAX_OUTPUT_CHARS = 20000;
+export declare const DEFAULT_LIMIT = 10;
+export declare const MAX_LIMIT = 30;
+export declare const CLONE_DEPTH = 1;
+export declare const TMP_PREFIX = "matrixx-gh-";

package/dist/tools/github-search/index.d.ts

@@ -0,0 +1 @@
+export { createGithubSearchTools } from "./tools";

package/dist/tools/github-search/result-formatter.d.ts

@@ -0,0 +1,2 @@
+import type { GithubSearchResult } from "./types";
+export declare function formatGithubSearchResult(result: GithubSearchResult): string;

package/dist/tools/github-search/result-formatter.test.d.ts

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

package/dist/tools/github-search/tools.d.ts

@@ -0,0 +1,3 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+export declare function createGithubSearchTools(_ctx: PluginInput): Record<string, ToolDefinition>;

package/dist/tools/github-search/types.d.ts

@@ -0,0 +1,20 @@
+export interface GithubSearchHit {
+    repo: string;
+    path: string;
+    sha?: string;
+    line?: number;
+    text?: string;
+    url?: string;
+}
+export interface GithubSearchResult {
+    hits: GithubSearchHit[];
+    truncated: boolean;
+    mode: "code-search" | "clone-search";
+    error?: string;
+}
+export interface GithubSearchOptions {
+    query: string;
+    repo?: string;
+    language?: string;
+    limit?: number;
+}

package/dist/tools/index.d.ts

@@ -4,10 +4,12 @@ export { createBddCreateContractTool } from "./bdd-create-contract";
 export { createBddParseGherkinTool } from "./bdd-parse-gherkin";
 export { createBddPipelineTool } from "./bdd-pipeline";
 export { createBddValidateContractTool } from "./bdd-validate-contract";
+export { createGithubSearchTools } from "./github-search";
 export { createGlobTools } from "./glob";
 export { createGrepTools } from "./grep";
 export { createHandoffTools } from "./handoff";
 export { interactive_bash, startBackgroundCheck as startTmuxCheck } from "./interactive-bash";
+export { createKnowledgeHubConfirmTool } from "./knowledge-hub-confirm";
 export { createPdfExtractFiguresTool } from "./pdf-extract-figures";
 export { createPlanCreateTool } from "./plan/plan-create";
 export { createPlanDeleteTool } from "./plan/plan-delete";
@@ -24,7 +26,6 @@ import type { PluginInput, ToolDefinition } from "@opencode-ai/plugin";
 import type { BackgroundManager } from "../features/background-agent";
 type OpencodeClient = PluginInput["client"];
 export { createAssemblyTool } from "./assembly";
-export { createDcpSwitchProfileTool } from "./dcp-switch-profile";
 export { createDelegateTask } from "./delegate-task";
 export { createHashlineEditTool } from "./hashline-edit";
 export { createLookAt } from "./look-at";

package/dist/tools/knowledge-hub-confirm/index.d.ts

@@ -0,0 +1 @@
+export { createKnowledgeHubConfirmTool } from "./tools";

package/dist/tools/knowledge-hub-confirm/tools.d.ts

@@ -0,0 +1,12 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+/**
+ * `knowledge_hub_confirm` tool — records a user-confirmed override for the
+ * knowledge-hub read-only guard.
+ *
+ * Call this ONLY after the user explicitly approved the write via the
+ * question tool. It records a session-scoped approval (default TTL 10 min)
+ * for the resolved absolute path, then the agent retries the blocked write
+ * and the guard lets it through.
+ */
+export declare function createKnowledgeHubConfirmTool(ctx: PluginInput): ToolDefinition;

package/dist/tools/knowledge-hub-confirm/tools.test.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-matrixx",
-  "version": "2.6.9",
+  "version": "2.6.11",
   "description": "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/features/builtin-commands/templates/bdd-backend.d.ts

@@ -1 +0,0 @@
-export declare const BDD_BACKEND_TEMPLATE = "# /bdd-backend\n\nGenerate typed API services from one or more BDD Contract JSON files.\n\n## Usage\n\nSingle file:\n```\n/bdd-backend <contract.json> --out <out-dir>\n```\n\nBatch (directory or glob):\n```\n/bdd-backend <dir> --out <out-dir>\n/bdd-backend \"<dir>/**/*.contract.json\" --out <out-dir>\n```\n\n## Workflow\n\nSingle file:\n1. Read the Contract JSON\n2. Extract @api:endpoint and @api:response annotations\n3. Generate typed service files with Zod request/response schemas\n4. One service function per endpoint\n5. Report generated file paths\n\nBatch input (directory or glob):\n1. Expand the input into a list of .contract.json files\n2. For each contract, run the single-file workflow above\n3. Use background subagents (`task(run_in_background=true)`) to run each in parallel (up to 5 concurrent)\n4. Wait for all to finish, then collect results and report a summary\n\n## Output\n\nSingle file: TypeScript service files (.ts) with Zod validation schemas for each API endpoint.\n\nBatch: per-feature service subdirectory tree under `<out-dir>/<feature>/backend/`.\n\n## Git Actions (HARD RULE)\nNEVER run `git commit`, `git add`, `git push`, `git rebase`, `git reset`, `git tag`, or any other git command in this command context. The pipeline runner is responsible for version control. You may only create/edit the generated files in the target output directory.\n";

package/dist/features/builtin-commands/templates/bdd-contract.d.ts

@@ -1 +0,0 @@
-export declare const BDD_CONTRACT_TEMPLATE = "# /bdd-contract\n\nGenerate BDD Contract JSON from one or more Gherkin .feature files. The .feature file must be 100% pure Gherkin (no '# @annotation' comments). The bdd-contract agent infers all annotations (api/ui/state/assumptions) via LLM reasoning from feature content.\n\n## Usage\n\nSingle file:\n```\n/bdd-contract <feature-path> [--force]\n```\n\nBatch (directory or glob):\n```\n/bdd-contract <dir> [--force]\n/bdd-contract \"<dir>/**/*.feature\" [--force]\n```\n\n## Workflow\n\nSingle file:\n1. Parse the .feature file using bdd_parse_gherkin tool (deterministic AST)\n2. Create initial Contract JSON using bdd_create_contract tool (deterministic, empty annotations)\n3. ENRICH the Contract: the bdd-contract agent infers annotations (api/ui/state/assumptions) via LLM reasoning from feature content and edits the Contract JSON file in place\n4. **VALIDATE**: call bdd_validate_contract on the file -- if it returns errors, fix the contract and re-validate. The contract must conform to the strict ContractSchema (all annotation field names must match the required naming conventions: kebab-case for routes/testIds, camelCase for state variables, dotted kebab-case for string keys).\n5. Report the Contract file path, key features identified, and annotations inferred\n\nBatch input (directory or glob):\n1. Expand the input into a list of .feature files\n2. For each .feature file, run the single-file workflow above\n3. Report a summary of all generated contracts (count, paths, any failures)\n\n## Output\n\nSingle file: a `<file>.contract.json` alongside the source .feature file, conforming to ContractSchema v1 with schemaVersion: 1, scenarios, and LLM-inferred annotations.\n\nBatch: one contract file per source .feature, written next to each source file.\n\n## Git Actions (HARD RULE)\nNEVER run `git commit`, `git add`, `git push`, `git rebase`, `git reset`, `git tag`, or any other git command in this command context. The pipeline runner is responsible for version control. You may only create/edit the generated contract JSON.\n";

package/dist/features/builtin-commands/templates/bdd-frontend.d.ts

@@ -1 +0,0 @@
-export declare const BDD_FRONTEND_TEMPLATE = "# /bdd-frontend\n\nGenerate React components and a dev preview server from one or more BDD Contract JSON files.\n\n## Usage\n\nSingle file:\n```\n/bdd-frontend <contract.json>\n```\n\nBatch (directory or glob):\n```\n/bdd-frontend <dir> --out <out-dir>\n/bdd-frontend \"<dir>/**/*.contract.json\" --out <out-dir>\n```\n\n## Workflow\n\nSingle file:\n1. Read the Contract JSON\n2. Extract @ui:* annotations (routes, testIds, strings)\n3. Generate React components for each route/feature\n4. Implement form fields from state variables\n5. Apply test IDs and accessibility attributes\n6. Generate a preview-server.ts for visual review\n\nBatch input (directory or glob):\n1. Expand the input into a list of .contract.json files\n2. For each contract, run the single-file workflow above\n3. Use background subagents (`task(run_in_background=true)`) to run each in parallel (up to 5 concurrent)\n4. Wait for all to finish, then collect results and report a summary\n\n## Output\n\nSingle file: React component files (.tsx) with TypeScript props, design tokens, data-testid attributes, and a preview-server.ts for visual review.\n\nBatch: per-feature component subdirectory tree under `<out-dir>/<feature>/components/`, with one preview-server.ts per feature.\n\n## Git Actions (HARD RULE)\nNEVER run `git commit`, `git add`, `git push`, `git rebase`, `git reset`, `git tag`, or any other git command in this command context. The pipeline runner is responsible for version control. You may only create/edit the generated files in the target output directory.\n";

package/dist/features/builtin-commands/templates/bdd-tests.d.ts

@@ -1 +0,0 @@
-export declare const BDD_TESTS_TEMPLATE = "# /bdd-tests\n\nGenerate Cucumber step definitions and page objects from one or more BDD Contract JSON files.\n\n## Usage\n\nSingle file:\n```\n/bdd-tests <contract.json> --out <out-dir>\n```\n\nBatch (directory or glob):\n```\n/bdd-tests <dir> --out <out-dir>\n/bdd-tests \"<dir>/**/*.contract.json\" --out <out-dir>\n```\n\n## Workflow\n\nSingle file:\n1. Read the Contract JSON file\n2. Extract feature scenarios and their steps\n3. Generate Cucumber step definition files (Given/When/Then/And/But)\n4. Generate page object classes for UI interactions\n5. Generate `cucumber.cjs` (CommonJS, NOT `cucumber.js`) + a per-feature `Dockerfile` + `run-tests.sh` so the tests are runnable in CI and locally\n6. Verify with `npx cucumber-js` via bash (use the generated `run-tests.sh` if it exists, else invoke cucumber directly)\n\nBatch input (directory or glob):\n1. Expand the input into a list of .contract.json files\n2. For each contract, run the single-file workflow above (including the per-feature Dockerfile + run-tests.sh generation)\n3. Use background subagents (`task(run_in_background=true)`) to run each in parallel (up to 5 concurrent)\n4. Wait for all to finish and collect results\n5. AFTER all per-feature runs finish, generate TWO parent-shared files at the input directory root:\n   - `<input-dir>/Dockerfile` -- same base image as the per-feature one, CMD points to the parent run-tests.sh\n   - `<input-dir>/run-tests.sh` -- iterates every feature subdir that has a run-tests.sh and invokes it in sequence (with BDD_FEATURE filter support)\n6. Report a summary that lists the per-feature outputs AND the parent batch runner\n\n## Output\n\nSingle file: `<out-dir>/<feature>/` containing `cucumber.cjs`, `Dockerfile`, `run-tests.sh`, plus `tests/` (step definitions, page objects, world, hooks).\n\nBatch: per-feature subdirectory tree under `<input-dir>/<feature>/` with the same layout for each feature, PLUS parent-shared `<input-dir>/Dockerfile` and `<input-dir>/run-tests.sh` for running every feature in one go.\n\n## Git Actions (HARD RULE)\nNEVER run `git commit`, `git add`, `git push`, `git rebase`, `git reset`, `git tag`, or any other git command in this command context. The pipeline runner is responsible for version control. You may only create/edit the generated files in the target output directory.\n";

package/dist/features/builtin-commands/templates/dcp-profile.d.ts

@@ -1 +0,0 @@
-export declare const DCP_PROFILE_TEMPLATE = "You are switching the active DCP (Dynamic Context Pruning) profile tier.\n\nThis command is provided by the Matrixx plugin. It uses the built-in `dcp_switch_profile` tool to apply DCP profile configurations \u2014 no external scripts needed.\n\n## Step 1: Verify DCP is installed\n\nCheck whether the DCP plugin is installed at the standard OpenCode plugin location:\n\n```bash\nif [ ! -d \"$HOME/.config/opencode/node_modules/@tarquinen/opencode-dcp\" ]; then\n  echo \"DCP is not installed at the standard OpenCode plugin location.\" >&2\n  echo \"Install it with: npm install --prefix ~/.config/opencode @tarquinen/opencode-dcp\" >&2\n  exit 1\nfi\n```\n\nIf the directory does not exist, stop immediately and report the error to the user. Do not proceed.\n\n## Step 2: Determine the target profile\n\nParse the arguments passed to this command. The user invoked `/dcp-profile <arguments>` where `<arguments>` is the first positional argument.\n\n- If the argument is a known profile name (one of: economy, balanced, performance, ultimate), use it directly.\n- If the argument is empty or missing, read `dcp.default_profile` from the user's `matrixx.jsonc` config; if absent, default to `balanced`.\n- If the argument is not a recognized profile name, list the available profiles and stop. Do NOT guess or pass invalid names.\n\n## Step 3: Call the built-in `dcp_switch_profile` tool\n\nUse the `dcp_switch_profile` tool with the resolved profile name. This tool reads profile parameters from the Matrixx plugin configuration and writes the full inline DCP config to `~/.config/opencode/dcp.jsonc`.\n\nThe tool will handle all file operations \u2014 you do NOT need to run any external scripts or edit DCP config files directly.\n\n## Step 4: Confirm and instruct\n\nAfter a successful switch:\n\n1. Report the tool's output to the user.\n2. Tell the user that the new DCP configuration will take effect after they restart their OpenCode session (the active session has already loaded the previous config into memory).\n3. Do not attempt to reload DCP in-place; a session restart is required.\n\n## Important constraints\n\n- Use the built-in `dcp_switch_profile` tool. Do NOT bypass it by editing DCP config files directly.\n- Do not install, upgrade, or modify the DCP plugin from this command. If the user needs to install or upgrade DCP, instruct them to run `opencode plugin @tarquinen/opencode-dcp@<version>` (or use `npm install --prefix ~/.config/opencode` for cached installs).\n";

package/dist/mcp/white-rabbit.d.ts

@@ -1,6 +0,0 @@
-export declare const white_rabbit: {
-    type: "remote";
-    url: string;
-    enabled: boolean;
-    oauth: false;
-};

package/dist/tools/dcp-switch-profile/index.d.ts

@@ -1 +0,0 @@
-export { createDcpSwitchProfileTool } from "./tools";