opencode-matrixx 2.5.0 → 2.6.0

package/dist/config/index.d.ts

@@ -1,3 +1,3 @@
 export { expandPreset, PRESET_NAMES, type PresetName } from "./presets";
-export type { AgentDefinitions, AgentName, AgentOverrideConfig, AgentOverrides, BuiltinCommandName, EnvFileGuardConfig, ExperimentalConfig, HookName, MatrixLoopConfig, MatrixxConfig, McpName, ModelCapabilitiesConfig, MorpheusAgentConfig, MorpheusConfig, MorpheusTasksConfig, RuntimeFallbackConfig, SecretScanningConfig, SecurityConfig, TmuxConfig, TmuxLayout, } from "./schema";
+export type { AgentDefinitions, AgentName, AgentOverrideConfig, AgentOverrides, BuiltinCommandName, EnvFileGuardConfig, ExperimentalConfig, HookName, MatrixLoopConfig, MatrixxConfig, McpName, MorpheusAgentConfig, MorpheusConfig, MorpheusTasksConfig, RuntimeFallbackConfig, SecretScanningConfig, SecurityConfig, TmuxConfig, TmuxLayout, } from "./schema";
 export { AgentOverrideConfigSchema, AgentOverridesSchema, BuiltinCommandNameSchema, ExperimentalConfigSchema, HookNameSchema, MatrixLoopConfigSchema, MatrixxConfigSchema, McpNameSchema, MorpheusAgentConfigSchema, RuntimeFallbackConfigSchema, SecurityConfigSchema, TmuxConfigSchema, TmuxLayoutSchema, } from "./schema";

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

@@ -0,0 +1,89 @@
+import { z } from "zod";
+export declare const EvolutionWatcherConfigSchema: z.ZodDefault<z.ZodObject<{
+    maxArgChars: z.ZodDefault<z.ZodNumber>;
+    maxOutputChars: z.ZodDefault<z.ZodNumber>;
+    skipTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+export type EvolutionWatcherConfig = z.infer<typeof EvolutionWatcherConfigSchema>;
+export declare const EvolutionCompressorConfigSchema: z.ZodDefault<z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<{
+        llm: "llm";
+        "dspy-gepa": "dspy-gepa";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    minTraces: z.ZodDefault<z.ZodNumber>;
+    maxInputTokens: z.ZodDefault<z.ZodNumber>;
+    trigger: z.ZodDefault<z.ZodEnum<{
+        compacting: "compacting";
+        idle: "idle";
+        both: "both";
+    }>>;
+}, z.core.$strip>>;
+export type EvolutionCompressorConfig = z.infer<typeof EvolutionCompressorConfigSchema>;
+export declare const EvolutionWriterConfigSchema: z.ZodDefault<z.ZodObject<{
+    outputDir: z.ZodDefault<z.ZodString>;
+    globalSkills: z.ZodDefault<z.ZodBoolean>;
+    allowToolGeneration: z.ZodDefault<z.ZodBoolean>;
+    allowAgentGeneration: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>>;
+export type EvolutionWriterConfig = z.infer<typeof EvolutionWriterConfigSchema>;
+export declare const EvolutionGovernanceConfigSchema: z.ZodDefault<z.ZodObject<{
+    requireApproval: z.ZodDefault<z.ZodBoolean>;
+    autoPromote: z.ZodDefault<z.ZodBoolean>;
+    autoPromoteThreshold: z.ZodDefault<z.ZodNumber>;
+    minConfidence: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export type EvolutionGovernanceConfig = z.infer<typeof EvolutionGovernanceConfigSchema>;
+export declare const EvolutionRetentionConfigSchema: z.ZodDefault<z.ZodObject<{
+    traceDays: z.ZodDefault<z.ZodNumber>;
+    maxPending: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export type EvolutionRetentionConfig = z.infer<typeof EvolutionRetentionConfigSchema>;
+export declare const EvolutionBudgetConfigSchema: z.ZodDefault<z.ZodObject<{
+    maxCompressionsPerHour: z.ZodDefault<z.ZodNumber>;
+    maxCostCentsPerDay: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export type EvolutionBudgetConfig = z.infer<typeof EvolutionBudgetConfigSchema>;
+export declare const EvolutionConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    watcher: z.ZodDefault<z.ZodObject<{
+        maxArgChars: z.ZodDefault<z.ZodNumber>;
+        maxOutputChars: z.ZodDefault<z.ZodNumber>;
+        skipTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    compressor: z.ZodDefault<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodEnum<{
+            llm: "llm";
+            "dspy-gepa": "dspy-gepa";
+        }>>;
+        model: z.ZodOptional<z.ZodString>;
+        minTraces: z.ZodDefault<z.ZodNumber>;
+        maxInputTokens: z.ZodDefault<z.ZodNumber>;
+        trigger: z.ZodDefault<z.ZodEnum<{
+            compacting: "compacting";
+            idle: "idle";
+            both: "both";
+        }>>;
+    }, z.core.$strip>>;
+    writer: z.ZodDefault<z.ZodObject<{
+        outputDir: z.ZodDefault<z.ZodString>;
+        globalSkills: z.ZodDefault<z.ZodBoolean>;
+        allowToolGeneration: z.ZodDefault<z.ZodBoolean>;
+        allowAgentGeneration: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    governance: z.ZodDefault<z.ZodObject<{
+        requireApproval: z.ZodDefault<z.ZodBoolean>;
+        autoPromote: z.ZodDefault<z.ZodBoolean>;
+        autoPromoteThreshold: z.ZodDefault<z.ZodNumber>;
+        minConfidence: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    retention: z.ZodDefault<z.ZodObject<{
+        traceDays: z.ZodDefault<z.ZodNumber>;
+        maxPending: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    budget: z.ZodDefault<z.ZodObject<{
+        maxCompressionsPerHour: z.ZodDefault<z.ZodNumber>;
+        maxCostCentsPerDay: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type EvolutionConfig = z.infer<typeof EvolutionConfigSchema>;

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

@@ -0,0 +1,23 @@
+import { z } from "zod";
+/**
+ * Headroom network-proxy compression configuration.
+ *
+ * Headroom is an external network-proxy that compresses LLM traffic
+ * (CacheAligner → ContentRouter → CCR pipeline). Matrixx does NOT
+ * implement compression itself — it only detects/disciplines when
+ * Headroom is active.
+ *
+ * - Opt-in via `enabled: true` (default: false).
+ * - Recommended usage is `HEADROOM_WRAP=1 headroom wrap -- <command>`
+ *   so the proxy sits transparently in front of the transport.
+ * - Native transport integration is deferred until the compaction hook
+ *   stabilizes (Headroom #76 collision risk with
+ *   anthropic-context-window-limit-recovery).
+ */
+export declare const HeadroomConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    proxyUrl: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+    backend: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HeadroomConfig = z.infer<typeof HeadroomConfigSchema>;

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

@@ -4,6 +4,8 @@ export declare const HookNameSchema: z.ZodEnum<{
     "quality-gate": "quality-gate";
     "matrix-loop": "matrix-loop";
     "start-work": "start-work";
+    "evolution-watcher": "evolution-watcher";
+    "evolution-compressor": "evolution-compressor";
     "todo-continuation-enforcer": "todo-continuation-enforcer";
     "context-window-monitor": "context-window-monitor";
     "session-recovery": "session-recovery";
@@ -55,7 +57,11 @@ export declare const HookNameSchema: z.ZodEnum<{
     "hashline-edit-diff-enhancer": "hashline-edit-diff-enhancer";
     "tool-pair-validator": "tool-pair-validator";
     "task-notepad": "task-notepad";
+    "task-todo-mirror": "task-todo-mirror";
     "design-intent-preserver": "design-intent-preserver";
     "rtk-bash-rewriter": "rtk-bash-rewriter";
+    "mcp-startup-notification": "mcp-startup-notification";
+    "evolution-quality-gate": "evolution-quality-gate";
+    "evolution-hitl": "evolution-hitl";
 }>;
 export type HookName = z.infer<typeof HookNameSchema>;

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

@@ -72,6 +72,8 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         "quality-gate": "quality-gate";
         "matrix-loop": "matrix-loop";
         "start-work": "start-work";
+        "evolution-watcher": "evolution-watcher";
+        "evolution-compressor": "evolution-compressor";
         "todo-continuation-enforcer": "todo-continuation-enforcer";
         "context-window-monitor": "context-window-monitor";
         "session-recovery": "session-recovery";
@@ -123,8 +125,12 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         "hashline-edit-diff-enhancer": "hashline-edit-diff-enhancer";
         "tool-pair-validator": "tool-pair-validator";
         "task-notepad": "task-notepad";
+        "task-todo-mirror": "task-todo-mirror";
         "design-intent-preserver": "design-intent-preserver";
         "rtk-bash-rewriter": "rtk-bash-rewriter";
+        "mcp-startup-notification": "mcp-startup-notification";
+        "evolution-quality-gate": "evolution-quality-gate";
+        "evolution-hitl": "evolution-hitl";
     }>>>;
     disabled_commands: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         "bdd-contract": "bdd-contract";
@@ -1892,21 +1898,63 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         notify_on_fallback: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, z.core.$strip>>;
     agent_definitions: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-    model_capabilities: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodOptional<z.ZodBoolean>;
-        auto_refresh_on_start: z.ZodOptional<z.ZodBoolean>;
-        refresh_timeout_ms: z.ZodOptional<z.ZodNumber>;
-        source_url: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
     matrixx_self_config: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         proactive: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
+    headroom: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        proxyUrl: z.ZodOptional<z.ZodString>;
+        project: z.ZodOptional<z.ZodString>;
+        backend: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     rtk: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         binary_path: z.ZodOptional<z.ZodString>;
         timeout_ms: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    evolution: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        watcher: z.ZodDefault<z.ZodObject<{
+            maxArgChars: z.ZodDefault<z.ZodNumber>;
+            maxOutputChars: z.ZodDefault<z.ZodNumber>;
+            skipTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        compressor: z.ZodDefault<z.ZodObject<{
+            provider: z.ZodDefault<z.ZodEnum<{
+                llm: "llm";
+                "dspy-gepa": "dspy-gepa";
+            }>>;
+            model: z.ZodOptional<z.ZodString>;
+            minTraces: z.ZodDefault<z.ZodNumber>;
+            maxInputTokens: z.ZodDefault<z.ZodNumber>;
+            trigger: z.ZodDefault<z.ZodEnum<{
+                compacting: "compacting";
+                idle: "idle";
+                both: "both";
+            }>>;
+        }, z.core.$strip>>;
+        writer: z.ZodDefault<z.ZodObject<{
+            outputDir: z.ZodDefault<z.ZodString>;
+            globalSkills: z.ZodDefault<z.ZodBoolean>;
+            allowToolGeneration: z.ZodDefault<z.ZodBoolean>;
+            allowAgentGeneration: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        governance: z.ZodDefault<z.ZodObject<{
+            requireApproval: z.ZodDefault<z.ZodBoolean>;
+            autoPromote: z.ZodDefault<z.ZodBoolean>;
+            autoPromoteThreshold: z.ZodDefault<z.ZodNumber>;
+            minConfidence: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        retention: z.ZodDefault<z.ZodObject<{
+            traceDays: z.ZodDefault<z.ZodNumber>;
+            maxPending: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        budget: z.ZodDefault<z.ZodObject<{
+            maxCompressionsPerHour: z.ZodDefault<z.ZodNumber>;
+            maxCostCentsPerDay: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     _migrations: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type MatrixxConfig = z.infer<typeof MatrixxConfigSchema>;

package/dist/config/schema.d.ts

@@ -8,15 +8,15 @@ export * from "./schema/background-task";
 export * from "./schema/browser-automation";
 export * from "./schema/categories";
 export * from "./schema/commands";
-export * from "./schema/commands";
 export * from "./schema/comment-checker";
 export * from "./schema/dcp";
+export * from "./schema/evolution";
 export * from "./schema/experimental";
-export * from "./schema/experimental";
+export * from "./schema/headroom";
 export * from "./schema/hooks";
 export * from "./schema/matrix-loop";
 export * from "./schema/matrixx-config";
-export * from "./schema/model-capabilities";
+export * from "./schema/matrixx-self-config";
 export * from "./schema/morpheus";
 export * from "./schema/morpheus-agent";
 export * from "./schema/notification";

package/dist/create-hooks.d.ts

@@ -23,6 +23,8 @@ export declare function createHooks(args: {
     backgroundNotificationHook: ReturnType<typeof import("./hooks").createBackgroundNotificationHook> | null;
     architectHook: ReturnType<typeof import("./hooks").createArchitectHook> | null;
     planPersister: ReturnType<typeof import("./hooks").createPlanPersister> | null;
+    evolutionCompressor: ReturnType<typeof import("./hooks").createEvolutionCompressorHook> | null;
+    evolutionHitl: ReturnType<typeof import("./hooks").createEvolutionHitlHook> | null;
     keywordDetector: ReturnType<typeof import("./hooks").createKeywordDetectorHook> | null;
     contextInjectorMessagesTransform: ReturnType<typeof import("./features/context-injector").createContextInjectorMessagesTransformHook>;
     envContextInjector: ReturnType<typeof import("./hooks").createEnvContextInjectorHook> | null;
@@ -48,6 +50,8 @@ export declare function createHooks(args: {
     hashlineEditDiffEnhancer: ReturnType<typeof import("./hooks").createHashlineEditDiffEnhancerHook> | null;
     qualityGate: ReturnType<typeof import("./hooks").createQualityGateHook> | null;
     taskNotepad: ReturnType<typeof import("./hooks").createTaskNotepadHook> | null;
+    evolutionWatcher: ReturnType<typeof import("./hooks").createEvolutionWatcherHook> | null;
+    taskTodoMirror: ReturnType<typeof import("./hooks").createTaskTodoMirrorHook> | null;
     contextWindowMonitor: ReturnType<typeof import("./hooks").createContextWindowMonitorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("./hooks").createPreemptiveCompactionHook> | null;
     sessionRecovery: ReturnType<typeof import("./hooks").createSessionRecoveryHook> | null;
@@ -69,4 +73,5 @@ export declare function createHooks(args: {
     anthropicEffort: ReturnType<typeof import("./hooks/anthropic-effort").createAnthropicEffortHook> | null;
     runtimeFallback: ReturnType<typeof import("./hooks").createRuntimeFallbackHook> | null;
     rtkBashRewriter: ReturnType<typeof import("./hooks").createRtkBashRewriterHook> | null;
+    mcpStartupNotification: ReturnType<typeof import("./hooks").createMcpStartupNotificationHook> | null;
 };

package/dist/features/background-agent/error-helpers.d.ts

@@ -1,6 +1,4 @@
 import type { EventProperties } from "./manager";
-export declare function formatDuration(start: Date, end?: Date): string;
 export declare function getErrorText(error: unknown): string;
 export declare function isAbortedSessionError(error: unknown): boolean;
-export declare function isRecord(value: unknown): value is Record<string, unknown>;
 export declare function getSessionErrorMessage(properties: EventProperties): string | undefined;

package/dist/features/builtin-commands/templates/evolution.d.ts

@@ -0,0 +1 @@
+export declare const EVOLUTION_TEMPLATE = "# Evolution Command\n\n## Purpose\n\nManage self-evolution proposals staged in `.matrixx/evolution/pending`.\n\n## Commands\n\n- `/evolution list` \u2014 list pending proposals\n- `/evolution approve <slug>` \u2014 promote pending skill to `.opencode/skills/<slug>/SKILL.md`\n- `/evolution reject <slug>` \u2014 discard pending proposal\n- `/evolution audit` \u2014 show last 20 audit entries\n\n---\n\n# PHASE 1: PARSE ARGUMENTS\n\nArguments: $ARGUMENTS\n\n- If empty or \"list\": list pending\n- If \"approve <slug>\" or \"approve <slug> --global\": promote\n- If \"reject <slug>\": discard\n- If \"audit\" or \"log\": show audit\n- Otherwise: show help and list pending\n\n---\n\n# PHASE 2: EXECUTE\n\n## List\n\nUse bash: `ls -1 .matrixx/evolution/pending/*.md 2>/dev/null | xargs -I {} basename {} .md` or `rtk ls .matrixx/evolution/pending`\nFor each slug, read `.matrixx/evolution/pending/<slug>.meta.json` to show confidence, version, derived_from.\nIf none: \"No pending evolution proposals.\"\n\n## Approve\n\n1. Verify `.matrixx/evolution/pending/<slug>.md` exists \u2014 if not, error: \"Pending <slug> not found. Run /evolution list to see available.\"\n2. Copy staged skill:\n   - `mkdir -p .opencode/skills/<slug>`\n   - `cp .matrixx/evolution/pending/<slug>.md .opencode/skills/<slug>/SKILL.md`\n   - Also preserve versioned copy: `mkdir -p .matrixx/evolution/skills/<slug>/versions && cp .matrixx/evolution/pending/<slug>.md .matrixx/evolution/skills/<slug>/SKILL.md`\n3. Append audit: `echo '{\"action\":\"promoted\",\"slug\":\"<slug>\",\"timestamp\":\"'$(date -Iseconds)'\"}' >> .matrixx/evolution/audit.log`\n4. Remove pending: `rm .matrixx/evolution/pending/<slug>.md .matrixx/evolution/pending/<slug>.meta.json`\n5. If argument includes --global, also copy to `~/.agents/skills/<slug>/SKILL.md`\n6. Confirm: \"Promoted <slug> to .opencode/skills/<slug>/SKILL.md \u2014 will be loaded on next session start.\"\n\n## Reject\n\n1. Verify pending exists\n2. `rm .matrixx/evolution/pending/<slug>.md .matrixx/evolution/pending/<slug>.meta.json`\n3. Append audit with action rejected\n4. Confirm: \"Rejected <slug>.\"\n\n## Audit\n\nRead `.matrixx/evolution/audit.log` last 20 lines: `tail -n 20 .matrixx/evolution/audit.log 2>/dev/null || echo \"No audit entries.\"`\n\n---\n\n# CONSTRAINTS\n\n- Use bash/rtk for file ops \u2014 no dedicated evolution tool yet\n- Never invent slug \u2014 read from pending dir\n- Keep operations atomic; report errors clearly\n- Do not modify pending content \u2014 promote as-is after human review\n";

package/dist/features/builtin-commands/types.d.ts

@@ -1,3 +1,3 @@
 import type { CommandDefinition } from "../command-loader";
-export type BuiltinCommandName = "init-deep" | "matrix-loop" | "cancel-loop" | "ulw-loop" | "refactor" | "start-work" | "stop-continuation" | "handoff" | "pickup" | "remove-deadcode" | "profile" | "end-ultrawork" | "research" | "assembly" | "ultrawork" | "bdd-backend" | "bdd-contract" | "bdd-frontend" | "bdd-pipeline" | "bdd-tests" | "dcp-profile";
+export type BuiltinCommandName = "init-deep" | "matrix-loop" | "cancel-loop" | "ulw-loop" | "refactor" | "start-work" | "stop-continuation" | "handoff" | "pickup" | "remove-deadcode" | "profile" | "end-ultrawork" | "research" | "assembly" | "ultrawork" | "bdd-backend" | "bdd-contract" | "bdd-frontend" | "bdd-pipeline" | "bdd-tests" | "dcp-profile" | "evolution";
 export type BuiltinCommands = Record<string, CommandDefinition>;

package/dist/features/evolution/compressor/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./interface";
+export * from "./llm";
+import type { EvolutionCompressorConfig } from "../../../config/schema/evolution";
+import type { Compressor } from "./interface";
+export declare function createCompressor(config: EvolutionCompressorConfig, llmCall?: (prompt: string) => Promise<string>): Compressor;

package/dist/features/evolution/compressor/interface.d.ts

@@ -0,0 +1,5 @@
+import type { CompressionInput, DistilledKnowledge } from "../types";
+export interface Compressor {
+    compress(input: CompressionInput): Promise<DistilledKnowledge>;
+}
+export type { CompressionInput, DistilledKnowledge, TraceRecord } from "../types";

package/dist/features/evolution/compressor/llm.d.ts

@@ -0,0 +1,12 @@
+import type { EvolutionCompressorConfig } from "../../../config/schema/evolution";
+import type { CompressionInput, DistilledKnowledge } from "../types";
+import type { Compressor } from "./interface";
+export declare class LlmCompressor implements Compressor {
+    private config;
+    private llmCall?;
+    constructor(options: {
+        config: EvolutionCompressorConfig;
+        llmCall?: (prompt: string) => Promise<string>;
+    });
+    compress(input: CompressionInput): Promise<DistilledKnowledge>;
+}

package/dist/features/evolution/evaluator.d.ts

@@ -0,0 +1,11 @@
+import type { SkillMeta } from "./types";
+export declare function containsSecretForEval(text: string): boolean;
+export type EvalResult = {
+    score: number;
+    demoted: boolean;
+};
+export declare function readMeta(slug: string, projectRoot?: string): Promise<SkillMeta | null>;
+export declare function evaluateSkill(slug: string, opts?: {
+    threshold?: number;
+    projectRoot?: string;
+}): Promise<EvalResult>;

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

@@ -0,0 +1,7 @@
+export { createCompressor } from "./compressor";
+export { LlmCompressor } from "./compressor/llm";
+export * from "./evaluator";
+export * from "./pipeline";
+export * from "./store";
+export * from "./types";
+export * from "./writer";

package/dist/features/evolution/pipeline.d.ts

@@ -0,0 +1,7 @@
+import type { EvolutionConfig } from "../../config/schema/evolution";
+import type { CompressionInput } from "./types";
+export declare function runEvolutionPipeline(input: CompressionInput, config: EvolutionConfig): Promise<{
+    staged?: string;
+    promoted?: string;
+    reason?: string;
+}>;

package/dist/features/evolution/store.d.ts

@@ -0,0 +1,22 @@
+import type { EvolutionState, TraceRecord } from "./types";
+export declare const EVOLUTION_DIR = ".matrixx/evolution";
+export declare const TRACES_DIR = ".matrixx/evolution/traces";
+export declare const DISTILLED_DIR = ".matrixx/evolution/distilled";
+export declare const SKILLS_DIR = ".matrixx/evolution/skills";
+export declare const PENDING_DIR = ".matrixx/evolution/pending";
+export declare const STATE_FILE = ".matrixx/evolution/state.json";
+export declare const AUDIT_FILE = ".matrixx/evolution/audit.log";
+export declare class TraceStore {
+    private ringBuffer;
+    private evolutionDir;
+    constructor(evolutionDir?: string);
+    append(record: TraceRecord): Promise<void>;
+    getRecent(count?: number): TraceRecord[];
+    readSession(sessionID: string): Promise<TraceRecord[]>;
+    getAllTraces(sessionID: string): Promise<TraceRecord[]>;
+    cleanup(retentionDays: number): Promise<void>;
+    getState(): Promise<EvolutionState>;
+    updateState(patch: Partial<EvolutionState>): Promise<void>;
+    appendAudit(entry: Record<string, unknown>): Promise<void>;
+}
+export declare const traceStore: TraceStore;

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

@@ -0,0 +1,51 @@
+export type TraceRecord = {
+    id: string;
+    sessionID: string;
+    callID: string;
+    timestamp: string;
+    agent: string;
+    tool: string;
+    args: unknown;
+    output: string;
+    durationMs: number;
+    success: boolean;
+    errorType?: string;
+    model?: string;
+};
+export type DistilledKnowledge = {
+    title: string;
+    summary: string;
+    patterns: string[];
+    pitfalls: string[];
+    prerequisites: string[];
+    skillDraft?: string;
+    confidence: number;
+    sourceSessionIDs: string[];
+};
+export type CompressionInput = {
+    sessionID: string;
+    traces: TraceRecord[];
+    messages?: unknown[];
+    notepads?: string[];
+    handoff?: unknown;
+    taskHistory?: unknown[];
+};
+export interface Compressor {
+    compress(input: CompressionInput): Promise<DistilledKnowledge>;
+}
+export type EvolutionState = {
+    totalTraces: number;
+    totalCompressions: number;
+    lastCompressionAt?: string;
+    lastPromptAt?: string;
+};
+export type SkillMeta = {
+    name: string;
+    version: string;
+    derived_from: string[];
+    created_at: string;
+    confidence: number;
+    eval_score?: number | null;
+    tags?: string[];
+    prerequisites?: string[];
+};

package/dist/features/evolution/writer.d.ts

@@ -0,0 +1,20 @@
+import type { EvolutionWriterConfig } from "../../config/schema/evolution";
+import type { DistilledKnowledge } from "./types";
+export declare class EvolutionWriter {
+    private pendingDir;
+    private skillsDir;
+    private promotedBase;
+    private globalBase?;
+    constructor(config: EvolutionWriterConfig, projectRoot?: string);
+    stage(knowledge: DistilledKnowledge): Promise<{
+        slug: string;
+        pendingPath: string;
+        metaPath: string;
+    }>;
+    promote(slug: string): Promise<{
+        promotedPath: string;
+    }>;
+    reject(slug: string): Promise<void>;
+    listPending(): Promise<string[]>;
+    listPromoted(): Promise<string[]>;
+}

package/dist/features/task-storage/types.d.ts

@@ -1,8 +1,8 @@
 import { z } from "zod";
 export declare const TaskStatusSchema: z.ZodEnum<{
     deleted: "deleted";
-    completed: "completed";
     pending: "pending";
+    completed: "completed";
     in_progress: "in_progress";
 }>;
 export type TaskStatus = z.infer<typeof TaskStatusSchema>;
@@ -12,8 +12,8 @@ export declare const TaskSchema: z.ZodObject<{
     description: z.ZodString;
     status: z.ZodEnum<{
         deleted: "deleted";
-        completed: "completed";
         pending: "pending";
+        completed: "completed";
         in_progress: "in_progress";
     }>;
     activeForm: z.ZodOptional<z.ZodString>;

package/dist/features/task-toast-manager/types.d.ts

@@ -1,9 +1,9 @@
-import type { ModelSource } from "../../shared/model-resolver";
+import type { ModelResolutionProvenance } from "../../shared/model-resolution-pipeline";
 export type TaskStatus = "running" | "queued" | "completed" | "error";
 export interface ModelFallbackInfo {
     model: string;
     type: "user-defined" | "inherited" | "category-default" | "system-default";
-    source?: ModelSource;
+    source?: ModelResolutionProvenance;
 }
 export interface TrackedTask {
     id: string;

package/dist/hooks/anthropic-context-window-limit-recovery/message-builder.d.ts

@@ -2,6 +2,5 @@ import type { PluginInput } from "@opencode-ai/plugin";
 export declare const PLACEHOLDER_TEXT = "[user interrupted]";
 type OpencodeClient = PluginInput["client"];
 export declare function sanitizeEmptyMessagesBeforeSummarize(sessionID: string, client?: OpencodeClient): Promise<number>;
-export declare function formatBytes(bytes: number): string;
 export declare function getLastAssistant(sessionID: string, client: OpencodeClient, directory: string): Promise<Record<string, unknown> | null>;
 export {};

package/dist/hooks/anthropic-context-window-limit-recovery/tool-part-types.d.ts

@@ -1,3 +1,4 @@
+import type { TaskStatus } from "../../shared/status-types";
 export interface StoredToolPart {
     id: string;
     sessionID: string;
@@ -6,7 +7,7 @@ export interface StoredToolPart {
     callID: string;
     tool: string;
     state: {
-        status: "pending" | "running" | "completed" | "error";
+        status: TaskStatus;
         input: Record<string, unknown>;
         output?: string;
         error?: string;

package/dist/hooks/evolution-compressor/index.d.ts

@@ -0,0 +1,15 @@
+import type { EvolutionConfig } from "../../config/schema/evolution";
+import type { PluginContext } from "../../plugin/types";
+export declare function createEvolutionCompressorHook(a?: PluginContext | EvolutionConfig, b?: EvolutionConfig): {
+    event: (input: {
+        event: {
+            type: string;
+            properties?: Record<string, unknown>;
+        };
+    }) => Promise<void>;
+    "experimental.session.compacting": (input: {
+        sessionID: string;
+    }, _output: {
+        context: string[];
+    }) => Promise<void>;
+};

package/dist/hooks/evolution-hitl/index.d.ts

@@ -0,0 +1,12 @@
+import type { Message, Part } from "@opencode-ai/sdk";
+type MessageWithParts = {
+    info: Message;
+    parts: Part[];
+};
+type TransformOutput = {
+    messages: MessageWithParts[];
+};
+export declare function createEvolutionHitlHook(a?: unknown, b?: unknown): {
+    "experimental.chat.messages.transform": (_input: Record<string, never>, output: TransformOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/evolution-quality-gate/index.d.ts

@@ -0,0 +1,6 @@
+import type { EvolutionGovernanceConfig } from "../../config/schema/evolution";
+import type { DistilledKnowledge } from "../../features/evolution/types";
+export declare function passesQualityGate(knowledge: DistilledKnowledge, config: EvolutionGovernanceConfig): {
+    pass: boolean;
+    reason?: string;
+};

package/dist/hooks/evolution-watcher/index.d.ts

@@ -0,0 +1,21 @@
+import type { EvolutionConfig } from "../../config/schema/evolution";
+import type { PluginContext } from "../../plugin/types";
+export { classifySuccess, truncate } from "./utils";
+export declare function createEvolutionWatcherHook(a?: PluginContext | EvolutionConfig, b?: EvolutionConfig): {
+    "tool.execute.before": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        args: Record<string, unknown>;
+    }) => Promise<void>;
+    "tool.execute.after": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: Record<string, unknown>;
+    }) => Promise<void>;
+};

package/dist/hooks/evolution-watcher/utils.d.ts

@@ -0,0 +1,5 @@
+export declare function truncate(value: string, maxChars: number): string;
+export declare function classifySuccess(tool: string, output: string): {
+    success: boolean;
+    errorType?: string;
+};

package/dist/hooks/index.d.ts

@@ -18,12 +18,17 @@ export { createEditErrorRecoveryHook } from "./edit-error-recovery";
 export { createEmptyTaskResponseDetectorHook } from "./empty-task-response-detector";
 export { createEnvContextInjectorHook } from "./env-context-injector";
 export { createEnvFileWriteGuardHook } from "./env-file-write-guard";
+export { createEvolutionCompressorHook } from "./evolution-compressor";
+export { createEvolutionHitlHook } from "./evolution-hitl";
+export { passesQualityGate } from "./evolution-quality-gate";
+export { createEvolutionWatcherHook } from "./evolution-watcher";
 export { createHashlineEditDiffEnhancerHook } from "./hashline-edit-diff-enhancer";
 export { createHashlineReadEnhancerHook } from "./hashline-read-enhancer";
 export { createInteractiveBashSessionHook } from "./interactive-bash-session";
 export { createJsonErrorRecoveryHook } from "./json-error-recovery";
 export { createKeywordDetectorHook } from "./keyword-detector";
 export { createMatrixLoopHook, type MatrixLoopHook } from "./matrix-loop";
+export { createMcpStartupNotificationHook } from "./mcp-startup-notification";
 export { createMouseNotepadHook } from "./mouse-notepad";
 export { createNonInteractiveEnvHook } from "./non-interactive-env";
 export { createOracleMdOnlyHook } from "./oracle-md-only";
@@ -46,6 +51,7 @@ export { createStartWorkHook } from "./start-work";
 export { createStopContinuationGuardHook, type StopContinuationGuard } from "./stop-continuation-guard";
 export { createTaskNotepadHook } from "./task-notepad";
 export { createTaskResumeInfoHook } from "./task-resume-info";
+export { createTaskTodoMirrorHook } from "./task-todo-mirror";
 export { createTasksTodowriteDisablerHook } from "./tasks-todowrite-disabler";
 export { createThinkModeHook } from "./think-mode";
 export { createThinkingBlockValidatorHook } from "./thinking-block-validator";

package/dist/hooks/keyword-detector/analyze/default.d.ts

@@ -9,4 +9,4 @@
  * - Vietnamese: phân tích, điều tra, nghiên cứu, kiểm tra, xem xét, chẩn đoán, giải thích, tìm hiểu, gỡ lỗi, tại sao
  */
 export declare const ANALYZE_PATTERN: RegExp;
-export declare const ANALYZE_MESSAGE = "[analyze-mode]\nANALYSIS MODE. Gather context before diving deep:\n\nCONTEXT GATHERING (parallel):\n- 1-2 explore agents (codebase patterns, implementations)\n- 1-2 librarian agents (if external library involved)\n- Direct tools: Grep, AST-grep, LSP for targeted searches\n\nIF COMPLEX - DO NOT STRUGGLE ALONE. Consult specialists:\n- **Oracle**: Conventional problems (architecture, debugging, complex logic)\n- **Artistry**: Non-conventional problems (different approach needed)\n\nSYNTHESIZE findings before proceeding.";
+export declare const ANALYZE_MESSAGE = "[analyze-mode]\nANALYSIS MODE. Gather context before diving deep:\n\nCONTEXT GATHERING (parallel):\n- 1-2 trinity agents (codebase patterns, implementations)\n- 1-2 operator agents (if external library involved)\n- Direct tools: Grep, AST-grep, LSP for targeted searches\n\nIF COMPLEX - DO NOT STRUGGLE ALONE. Consult specialists:\n- **Oracle**: Conventional problems (architecture, debugging, complex logic)\n- **Matrix-bend**: Non-conventional problems (different approach needed)\n\nSYNTHESIZE findings before proceeding.";

package/dist/hooks/keyword-detector/constants.d.ts

@@ -1,4 +1,4 @@
-export { CODE_BLOCK_PATTERN, INLINE_CODE_PATTERN } from "../../shared";
+export { CODE_BLOCK_PATTERN, INLINE_CODE_PATTERN } from "../../shared/code-patterns";
 export { ANALYZE_MESSAGE, ANALYZE_PATTERN } from "./analyze";
 export { SEARCH_MESSAGE, SEARCH_PATTERN } from "./search";
 export { getUltraworkMessage, isPlannerAgent } from "./ultrawork";

package/dist/hooks/keyword-detector/search/default.d.ts

@@ -9,4 +9,4 @@
  * - Vietnamese: tìm kiếm, tra cứu, định vị, quét, phát hiện, truy tìm, tìm ra, ở đâu, liệt kê
  */
 export declare const SEARCH_PATTERN: RegExp;
-export declare const SEARCH_MESSAGE = "[search-mode]\nMAXIMIZE SEARCH EFFORT. Launch multiple background agents IN PARALLEL:\n- explore agents (codebase patterns, file structures, ast-grep)\n- librarian agents (remote repos, official docs, GitHub examples)\nPlus direct tools: Grep, ripgrep (rg), ast-grep (sg)\nNEVER stop at first result - be exhaustive.";
+export declare const SEARCH_MESSAGE = "[search-mode]\nMAXIMIZE SEARCH EFFORT. Launch multiple background agents IN PARALLEL:\n- trinity agents (codebase patterns, file structures, ast-grep)\n- operator agents (remote repos, official docs, GitHub examples)\nPlus direct tools: Grep, ripgrep (rg), ast-grep (sg)\nNEVER stop at first result - be exhaustive.";