opencode-matrixx 2.6.10 → 2.6.12

package/dist/matrixx.schema.json

@@ -209,7 +209,6 @@
               "runtime-fallback",
               "read-image-resizer",
               "webfetch-redirect-guard",
-              "hashline-edit-diff-enhancer",
               "tool-pair-validator",
               "quality-gate",
               "task-notepad",
@@ -221,7 +220,9 @@
               "context-mode-enforcer",
               "task-edit-guard",
               "document-reader-guard",
-              "failure-counter"
+              "knowledge-hub-guard",
+              "knowledge-hub-injector",
+              "knowledge-hub-search-nudge"
             ]
           },
           {}
@@ -246,12 +247,7 @@
           "research",
           "assembly",
           "ultrawork",
-          "bdd-backend",
-          "bdd-contract",
-          "bdd-frontend",
-          "bdd-pipeline",
-          "bdd-tests",
-          "dcp-profile"
+          "bdd-pipeline"
         ]
       }
     },
@@ -3976,117 +3972,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"
@@ -4651,51 +4537,86 @@
         }
       ]
     },
-    "matrix_loop": {
+    "knowledge": {
       "type": "object",
       "properties": {
-        "enabled": {
-          "default": false,
-          "type": "boolean"
-        },
-        "default_max_iterations": {
-          "default": 100,
-          "type": "number",
-          "minimum": 1,
-          "maximum": 1000
-        },
-        "state_dir": {
-          "type": "string"
+        "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": [
-        "enabled",
-        "default_max_iterations"
+        "hubs"
       ],
       "additionalProperties": false
     },
-    "failure_counter": {
+    "matrix_loop": {
       "type": "object",
       "properties": {
         "enabled": {
-          "default": true,
+          "default": false,
           "type": "boolean"
         },
-        "threshold": {
-          "default": 2,
+        "default_max_iterations": {
+          "default": 100,
           "type": "number",
           "minimum": 1,
-          "maximum": 10
+          "maximum": 1000
         },
-        "resetOnSuccess": {
-          "default": true,
-          "type": "boolean"
+        "state_dir": {
+          "type": "string"
         }
       },
       "required": [
         "enabled",
-        "threshold",
-        "resetOnSuccess"
+        "default_max_iterations"
       ],
       "additionalProperties": false
     },
@@ -4925,7 +4846,7 @@
       "type": "object",
       "properties": {
         "enabled": {
-          "default": false,
+          "default": true,
           "type": "boolean"
         }
       },
@@ -5095,6 +5016,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/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;
@@ -29,11 +30,12 @@ export declare function createCoreHooks(args: {
     contextModeEnforcer: ReturnType<typeof import("../../hooks").createContextModeEnforcerHook> | null;
     readImageResizer: ReturnType<typeof import("../../hooks").createReadImageResizerHook> | null;
     webfetchRedirectGuard: ReturnType<typeof import("../../hooks").createWebFetchRedirectGuardHook> | null;
-    hashlineEditDiffEnhancer: ReturnType<typeof import("../../hooks").createHashlineEditDiffEnhancerHook> | null;
     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;
@@ -48,7 +50,6 @@ export declare function createCoreHooks(args: {
     matrixLoop: ReturnType<typeof import("../../hooks").createMatrixLoopHook> | null;
     editErrorRecovery: ReturnType<typeof import("../../hooks").createEditErrorRecoveryHook> | null;
     delegateTaskRetry: ReturnType<typeof import("../../hooks").createDelegateTaskRetryHook> | null;
-    failureCounter: ReturnType<typeof import("../../hooks").createFailureCounterHook> | null;
     startWork: ReturnType<typeof import("../../hooks").createStartWorkHook> | null;
     oracleMdOnly: ReturnType<typeof import("../../hooks").createOracleMdOnlyHook> | null;
     mouseNotepad: ReturnType<typeof import("../../hooks").createMouseNotepadHook> | null;

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

@@ -1,5 +1,5 @@
 import type { HookName, MatrixxConfig } from "../../config";
-import { createAgentUsageReminderHook, createAutoUpdateCheckerHook, createContextWindowLimitRecoveryHook, createContextWindowMonitorHook, createDelegateTaskRetryHook, createEditErrorRecoveryHook, createFailureCounterHook, createInteractiveBashSessionHook, createMatrixLoopHook, createMouseNotepadHook, createNonInteractiveEnvHook, createOracleMdOnlyHook, createPreemptiveCompactionHook, createRtkBashRewriterHook, createRuntimeFallbackHook, createSessionNotification, createSessionRecoveryHook, createStartWorkHook, createTaskResumeInfoHook, createThinkModeHook } from "../../hooks";
+import { createAgentUsageReminderHook, createAutoUpdateCheckerHook, createContextWindowLimitRecoveryHook, createContextWindowMonitorHook, createDelegateTaskRetryHook, createEditErrorRecoveryHook, createInteractiveBashSessionHook, createMatrixLoopHook, createMouseNotepadHook, createNonInteractiveEnvHook, createOracleMdOnlyHook, createPreemptiveCompactionHook, createRtkBashRewriterHook, createRuntimeFallbackHook, createSessionNotification, createSessionRecoveryHook, createStartWorkHook, createTaskResumeInfoHook, createThinkModeHook } from "../../hooks";
 import { createAnthropicEffortHook } from "../../hooks/anthropic-effort";
 import type { PluginContext } from "../types";
 export type SessionHooks = {
@@ -16,7 +16,6 @@ export type SessionHooks = {
     matrixLoop: ReturnType<typeof createMatrixLoopHook> | null;
     editErrorRecovery: ReturnType<typeof createEditErrorRecoveryHook> | null;
     delegateTaskRetry: ReturnType<typeof createDelegateTaskRetryHook> | null;
-    failureCounter: ReturnType<typeof createFailureCounterHook> | null;
     startWork: ReturnType<typeof createStartWorkHook> | null;
     oracleMdOnly: ReturnType<typeof createOracleMdOnlyHook> | null;
     mouseNotepad: ReturnType<typeof createMouseNotepadHook> | 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, createDocumentReaderGuardHook, 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, 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;
@@ -18,11 +18,12 @@ export type ToolGuardHooks = {
     contextModeEnforcer: ReturnType<typeof createContextModeEnforcerHook> | null;
     readImageResizer: ReturnType<typeof createReadImageResizerHook> | null;
     webfetchRedirectGuard: ReturnType<typeof createWebFetchRedirectGuardHook> | null;
-    hashlineEditDiffEnhancer: ReturnType<typeof createHashlineEditDiffEnhancerHook> | null;
     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,35 @@
+/** 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;
+/** evolution tool: register iff evolution.enabled is true (default false). */
+export declare function shouldEnableEvolutionTool(enabled: 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/evolution/constants.d.ts

@@ -0,0 +1,24 @@
+/**
+ * evolution tool — description string and shared constants.
+ *
+ * The tool description is referenced by the tool factory and included in the
+ * LLM-facing tool schema, so keep it factual, concise, and triggerable.
+ */
+/** Tool description — governance plus read-only retrieval actions. */
+export declare const EVOLUTION_DESCRIPTION = "Govern self-evolution proposals staged in .matrixx/evolution/pending, and retrieve approved knowledge. Actions: 'list' (show pending proposals with version and confidence), 'get' (show a staged proposal), 'approve' (promote a pending skill and record the audit entry), 'reject' (discard a pending proposal), 'status' (state totals, pending count, and audit tail), 'search' (read-only scoped search over approved knowledge), 'get_context' (read-only scoped context, truncated at a char cap). Use this tool instead of shell commands for all evolution state.";
+/** Allowlisted actions: Wave1 governance plus read-only retrieval queries. */
+export declare const EVOLUTION_TOOL_ACTIONS: readonly ["list", "get", "approve", "reject", "status", "search", "get_context"];
+/** The read-only retrieval surface — no action here may mutate evolution state. */
+export declare const EVOLUTION_QUERY_ACTIONS: readonly ["search", "get_context"];
+/** How many audit lines `status` reports. */
+export declare const AUDIT_TAIL_LIMIT = 20;
+/** Hard char cap for `get_context` output; cut text gets a truncation marker. */
+export declare const GET_CONTEXT_CHAR_CAP = 4000;
+/** Max records `search` reports. */
+export declare const SEARCH_RESULT_LIMIT = 20;
+/** Message when the scoped query finds nothing. */
+export declare const NO_RETRIEVABLE_MESSAGE = "No retrievable knowledge for this scope.";
+/** Slugs must stay inside the pending dir — no separators, no traversal. */
+export declare const SLUG_PATTERN: RegExp;
+/** Message when nothing is staged. */
+export declare const NO_PENDING_MESSAGE = "No pending evolution proposals.";

package/dist/tools/evolution/index.d.ts

@@ -0,0 +1,3 @@
+export { AUDIT_TAIL_LIMIT, EVOLUTION_DESCRIPTION, EVOLUTION_QUERY_ACTIONS, EVOLUTION_TOOL_ACTIONS, GET_CONTEXT_CHAR_CAP, NO_PENDING_MESSAGE, NO_RETRIEVABLE_MESSAGE, SEARCH_RESULT_LIMIT, SLUG_PATTERN, } from "./constants";
+export { createEvolutionTool, type EvolutionToolOptions } from "./tools";
+export type { EvolutionToolAction, EvolutionToolArgs, PendingProposalSummary } from "./types";

package/dist/tools/evolution/query-actions.d.ts

@@ -0,0 +1,3 @@
+import type { EvolutionToolArgs } from "./types";
+export declare function handleSearch(projectRoot: string, args: EvolutionToolArgs): string;
+export declare function handleGetContext(projectRoot: string, args: EvolutionToolArgs): string;

package/dist/tools/evolution/query-actions.test.d.ts

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

package/dist/tools/evolution/tools.d.ts

@@ -0,0 +1,16 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+import { type EvolutionWriterConfig } from "../../config/schema/evolution";
+export type EvolutionToolOptions = {
+    writerConfig?: EvolutionWriterConfig;
+};
+/**
+ * `evolution` tool factory — governance + query host for self-evolution.
+ *
+ * Wave1 exposes the governance actions `list/get/approve/reject/status`,
+ * all delegated to the evolution store APIs (`EvolutionWriter`, `TraceStore`)
+ * so no shell command ever touches evolution state. T9 adds the read-only
+ * retrieval actions `search` and `get_context`, filtered through the T4a
+ * retrieval contract and scoped to the current project.
+ */
+export declare function createEvolutionTool(ctx: PluginInput, options?: EvolutionToolOptions): Record<string, ToolDefinition>;

package/dist/tools/evolution/tools.test.d.ts

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

package/dist/tools/evolution/types.d.ts

@@ -0,0 +1,20 @@
+import type { KnowledgeKind } from "../../features/evolution/types";
+import type { EVOLUTION_TOOL_ACTIONS } from "./constants";
+/** Allowlisted actions for the `evolution` tool. */
+export type EvolutionToolAction = (typeof EVOLUTION_TOOL_ACTIONS)[number];
+/** Flat args shape for the multi-action `evolution` tool. */
+export type EvolutionToolArgs = {
+    action: EvolutionToolAction;
+    slug?: string;
+    global?: boolean;
+    /** (action=search/get_context) Case-insensitive text match; absent returns all in scope. */
+    query?: string;
+    /** (action=search/get_context) Restrict results to one knowledge kind. */
+    kind?: KnowledgeKind;
+};
+/** Pending proposal summary shown by the `list` action. */
+export type PendingProposalSummary = {
+    slug: string;
+    version: string | null;
+    confidence: number | null;
+};