opencode-matrixx 1.0.2 → 1.1.0

package/dist/config/index.d.ts

@@ -1,4 +1,4 @@
 export { expandProfile, PROFILE_NAMES } from "./profiles";
 export type { ProfileName } from "./profiles";
-export { MatrixxConfigSchema, AgentOverrideConfigSchema, AgentOverridesSchema, McpNameSchema, AgentNameSchema, HookNameSchema, BuiltinCommandNameSchema, MorpheusAgentConfigSchema, ExperimentalConfigSchema, MatrixLoopConfigSchema, SecurityConfigSchema, TmuxConfigSchema, TmuxLayoutSchema, } from "./schema";
-export type { MatrixxConfig, AgentOverrideConfig, AgentOverrides, McpName, AgentName, HookName, BuiltinCommandName, MorpheusAgentConfig, ExperimentalConfig, DynamicContextPruningConfig, MatrixLoopConfig, SecurityConfig, SecretScanningConfig, EnvFileGuardConfig, DependencyAuditConfig, TmuxConfig, TmuxLayout, MorpheusConfig, MorpheusTasksConfig, } from "./schema";
+export { MatrixxConfigSchema, AgentOverrideConfigSchema, AgentOverridesSchema, McpNameSchema, AgentNameSchema, HookNameSchema, BuiltinCommandNameSchema, MorpheusAgentConfigSchema, ExperimentalConfigSchema, MatrixLoopConfigSchema, SecurityConfigSchema, TmuxConfigSchema, TmuxLayoutSchema, RuntimeFallbackConfigSchema, } from "./schema";
+export type { MatrixxConfig, AgentOverrideConfig, AgentOverrides, McpName, AgentName, HookName, BuiltinCommandName, MorpheusAgentConfig, ExperimentalConfig, DynamicContextPruningConfig, MatrixLoopConfig, SecurityConfig, SecretScanningConfig, EnvFileGuardConfig, DependencyAuditConfig, TmuxConfig, TmuxLayout, MorpheusConfig, MorpheusTasksConfig, RuntimeFallbackConfig, AgentDefinitions, ModelCapabilitiesConfig, } from "./schema";

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

@@ -0,0 +1,4 @@
+import { z } from "zod";
+export declare const AgentDefinitionPathSchema: z.ZodString;
+export declare const AgentDefinitionsConfigSchema: z.ZodOptional<z.ZodArray<z.ZodString>>;
+export type AgentDefinitions = z.infer<typeof AgentDefinitionsConfigSchema>;

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

@@ -12,6 +12,7 @@ export declare const BuiltinAgentNameSchema: z.ZodEnum<{
     cipher: "cipher";
     niobe: "niobe";
     sentinel: "sentinel";
+    zion: "zion";
     oracle: "oracle";
 }>;
 export declare const BuiltinSkillNameSchema: z.ZodEnum<{
@@ -52,6 +53,10 @@ export declare const BuiltinSkillNameSchema: z.ZodEnum<{
     "security-crypto": "security-crypto";
     "security-infra": "security-infra";
     "security-review": "security-review";
+    "crypto-market-analysis": "crypto-market-analysis";
+    "crypto-trading": "crypto-trading";
+    "crypto-onchain": "crypto-onchain";
+    "tdd-enforcer": "tdd-enforcer";
 }>;
 export declare const OverridableAgentNameSchema: z.ZodEnum<{
     morpheus: "morpheus";
@@ -66,6 +71,7 @@ export declare const OverridableAgentNameSchema: z.ZodEnum<{
     cipher: "cipher";
     niobe: "niobe";
     sentinel: "sentinel";
+    zion: "zion";
     build: "build";
     oracle: "oracle";
     plan: "plan";
@@ -85,6 +91,7 @@ export declare const AgentNameSchema: z.ZodEnum<{
     cipher: "cipher";
     niobe: "niobe";
     sentinel: "sentinel";
+    zion: "zion";
     oracle: "oracle";
 }>;
 export type AgentName = z.infer<typeof AgentNameSchema>;

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

@@ -28,6 +28,7 @@ export declare const CategoryConfigSchema: z.ZodObject<{
     prompt_append: z.ZodOptional<z.ZodString>;
     is_unstable_agent: z.ZodOptional<z.ZodBoolean>;
     disable: z.ZodOptional<z.ZodBoolean>;
+    fallback_models: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
 }, z.core.$strip>;
 export declare const BuiltinCategoryNameSchema: z.ZodEnum<{
     construct: "construct";
@@ -68,6 +69,7 @@ export declare const CategoriesConfigSchema: z.ZodRecord<z.ZodString, z.ZodObjec
     prompt_append: z.ZodOptional<z.ZodString>;
     is_unstable_agent: z.ZodOptional<z.ZodBoolean>;
     disable: z.ZodOptional<z.ZodBoolean>;
+    fallback_models: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
 }, z.core.$strip>>;
 export type CategoryConfig = z.infer<typeof CategoryConfigSchema>;
 export type CategoriesConfig = z.infer<typeof CategoriesConfigSchema>;

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

@@ -47,5 +47,11 @@ export declare const HookNameSchema: z.ZodEnum<{
     "env-file-write-guard": "env-file-write-guard";
     "json-error-recovery": "json-error-recovery";
     "bash-file-read-guard": "bash-file-read-guard";
+    "todo-description-override": "todo-description-override";
+    "runtime-fallback": "runtime-fallback";
+    "read-image-resizer": "read-image-resizer";
+    "webfetch-redirect-guard": "webfetch-redirect-guard";
+    "hashline-edit-diff-enhancer": "hashline-edit-diff-enhancer";
+    "tool-pair-validator": "tool-pair-validator";
 }>;
 export type HookName = z.infer<typeof HookNameSchema>;

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

@@ -23,6 +23,7 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         cipher: "cipher";
         niobe: "niobe";
         sentinel: "sentinel";
+        zion: "zion";
         oracle: "oracle";
     }>>>;
     disabled_skills: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -63,6 +64,10 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         "security-crypto": "security-crypto";
         "security-infra": "security-infra";
         "security-review": "security-review";
+        "crypto-market-analysis": "crypto-market-analysis";
+        "crypto-trading": "crypto-trading";
+        "crypto-onchain": "crypto-onchain";
+        "tdd-enforcer": "tdd-enforcer";
     }>>>;
     disabled_hooks: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         architect: "architect";
@@ -112,6 +117,12 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         "env-file-write-guard": "env-file-write-guard";
         "json-error-recovery": "json-error-recovery";
         "bash-file-read-guard": "bash-file-read-guard";
+        "todo-description-override": "todo-description-override";
+        "runtime-fallback": "runtime-fallback";
+        "read-image-resizer": "read-image-resizer";
+        "webfetch-redirect-guard": "webfetch-redirect-guard";
+        "hashline-edit-diff-enhancer": "hashline-edit-diff-enhancer";
+        "tool-pair-validator": "tool-pair-validator";
     }>>>;
     disabled_commands: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         "init-deep": "init-deep";
@@ -1514,6 +1525,7 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         prompt_append: z.ZodOptional<z.ZodString>;
         is_unstable_agent: z.ZodOptional<z.ZodBoolean>;
         disable: z.ZodOptional<z.ZodBoolean>;
+        fallback_models: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     }, z.core.$strip>>>;
     claude_code: z.ZodOptional<z.ZodObject<{
         mcp: z.ZodOptional<z.ZodBoolean>;
@@ -1620,6 +1632,9 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
         commit_footer: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
         include_co_authored_by: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
+    tdd_enforcer: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
     browser_automation_engine: z.ZodOptional<z.ZodObject<{
         provider: z.ZodDefault<z.ZodEnum<{
             playwright: "playwright";
@@ -1673,6 +1688,21 @@ export declare const MatrixxConfigSchema: z.ZodObject<{
             on_package_change: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    runtime_fallback: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        retry_on_errors: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodNumber>>>;
+        max_fallback_attempts: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        cooldown_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        timeout_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        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>>;
     _migrations: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type MatrixxConfig = z.infer<typeof MatrixxConfigSchema>;

package/dist/config/schema/model-capabilities.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export declare const ModelCapabilitiesConfigSchema: 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>;
+export type ModelCapabilitiesConfig = z.infer<typeof ModelCapabilitiesConfigSchema>;

package/dist/config/schema/runtime-fallback.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const RuntimeFallbackConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    retry_on_errors: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodNumber>>>;
+    max_fallback_attempts: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    cooldown_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    timeout_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    notify_on_fallback: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type RuntimeFallbackConfig = z.infer<typeof RuntimeFallbackConfigSchema>;

package/dist/config/schema/tdd-enforcer.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export declare const TddEnforcerConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TddEnforcerConfig = z.infer<typeof TddEnforcerConfigSchema>;

package/dist/config/schema.d.ts

@@ -10,6 +10,7 @@ export * from "./schema/commands";
 export * from "./schema/dynamic-context-pruning";
 export * from "./schema/experimental";
 export * from "./schema/git-master";
+export * from "./schema/tdd-enforcer";
 export * from "./schema/hooks";
 export * from "./schema/notification";
 export * from "./schema/matrixx-config";
@@ -20,4 +21,7 @@ export * from "./schema/morpheus-agent";
 export * from "./schema/tmux";
 export * from "./schema/security";
 export * from "./schema/websearch";
+export * from "./schema/runtime-fallback";
+export * from "./schema/agent-definitions";
+export * from "./schema/model-capabilities";
 export { AnyMcpNameSchema, type AnyMcpName, McpNameSchema, type McpName } from "../mcp/types";

package/dist/create-hooks.d.ts

@@ -26,6 +26,7 @@ export declare function createHooks(args: {
     keywordDetector: ReturnType<typeof import("./hooks").createKeywordDetectorHook> | null;
     contextInjectorMessagesTransform: ReturnType<typeof import("./features/context-injector").createContextInjectorMessagesTransformHook>;
     thinkingBlockValidator: ReturnType<typeof import("./hooks").createThinkingBlockValidatorHook> | null;
+    toolPairValidator: ReturnType<typeof import("./hooks").createToolPairValidatorHook> | null;
     commentChecker: ReturnType<typeof import("./hooks").createCommentCheckerHooks> | null;
     toolOutputTruncator: ReturnType<typeof import("./hooks").createToolOutputTruncatorHook> | null;
     directoryAgentsInjector: ReturnType<typeof import("./hooks").createDirectoryAgentsInjectorHook> | null;
@@ -39,6 +40,10 @@ export declare function createHooks(args: {
     envFileWriteGuard: ReturnType<typeof import("./hooks").createEnvFileWriteGuardHook> | null;
     jsonErrorRecovery: ReturnType<typeof import("./hooks").createJsonErrorRecoveryHook> | null;
     bashFileReadGuard: ReturnType<typeof import("./hooks").createBashFileReadGuardHook> | null;
+    todoDescriptionOverride: ReturnType<typeof import("./hooks").createTodoDescriptionOverrideHook> | null;
+    readImageResizer: ReturnType<typeof import("./hooks").createReadImageResizerHook> | null;
+    webfetchRedirectGuard: ReturnType<typeof import("./hooks").createWebFetchRedirectGuardHook> | null;
+    hashlineEditDiffEnhancer: ReturnType<typeof import("./hooks").createHashlineEditDiffEnhancerHook> | null;
     contextWindowMonitor: ReturnType<typeof import("./hooks").createContextWindowMonitorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("./hooks").createPreemptiveCompactionHook> | null;
     sessionRecovery: ReturnType<typeof import("./hooks").createSessionRecoveryHook> | null;
@@ -58,4 +63,5 @@ export declare function createHooks(args: {
     questionLabelTruncator: ReturnType<typeof import("./hooks").createQuestionLabelTruncatorHook>;
     taskResumeInfo: ReturnType<typeof import("./hooks").createTaskResumeInfoHook>;
     anthropicEffort: ReturnType<typeof import("./hooks/anthropic-effort").createAnthropicEffortHook> | null;
+    runtimeFallback: ReturnType<typeof import("./hooks").createRuntimeFallbackHook> | null;
 };

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

@@ -1 +1 @@
-export declare const HANDOFF_TEMPLATE = "# Handoff Command\n\n## Purpose\n\nUse /handoff when:\n- The current session context is getting too long and quality is degrading\n- You want to start fresh while preserving essential context from this session\n- The context window is approaching capacity\n\nThis creates a detailed context summary that can be used to continue work in a new session.\n\n---\n\n# PHASE 0: VALIDATE REQUEST\n\nBefore proceeding, confirm:\n- [ ] There is meaningful work or context in this session to preserve\n- [ ] The user wants to create a handoff summary (not just asking about it)\n\nIf the session is nearly empty or has no meaningful context, inform the user there is nothing substantial to hand off.\n\n---\n\n# PHASE 1: GATHER PROGRAMMATIC CONTEXT\n\nExecute these tools to gather concrete data:\n\n1. session_read({ session_id: \"$SESSION_ID\" }) \u2014 full session history\n2. todoread() \u2014 current task progress\n3. Bash({ command: \"git diff --stat HEAD~10..HEAD\" }) \u2014 recent file changes\n4. Bash({ command: \"git status --porcelain\" }) \u2014 uncommitted changes\n\nSuggested execution order:\n\n```\nsession_read({ session_id: \"$SESSION_ID\" })\ntodoread()\nBash({ command: \"git diff --stat HEAD~10..HEAD\" })\nBash({ command: \"git status --porcelain\" })\n```\n\nAnalyze the gathered outputs to understand:\n- What the user asked for (exact wording)\n- What work was completed\n- What tasks remain incomplete (include todo state)\n- What decisions were made\n- What files were modified or discussed (include git diff/stat + status)\n- What patterns, constraints, or preferences were established\n\n---\n\n# PHASE 2: EXTRACT CONTEXT\n\nWrite the context summary from first person perspective (\"I did...\", \"I told you...\").\n\nFocus on:\n- Capabilities and behavior, not file-by-file implementation details\n- What matters for continuing the work\n- Avoiding excessive implementation details (variable names, storage keys, constants) unless critical\n- USER REQUESTS (AS-IS) must be verbatim (do not paraphrase)\n- EXPLICIT CONSTRAINTS must be verbatim only (do not invent)\n\nQuestions to consider when extracting:\n- What did I just do or implement?\n- What instructions did I already give which are still relevant (e.g. follow patterns in the codebase)?\n- What files did I tell you are important or that I am working on?\n- Did I provide a plan or spec that should be included?\n- What did I already tell you that is important (libraries, patterns, constraints, preferences)?\n- What important technical details did I discover (APIs, methods, patterns)?\n- What caveats, limitations, or open questions did I find?\n\n---\n\n# PHASE 3: FORMAT OUTPUT\n\nGenerate a handoff summary. WRITE the summary to .matrix/handoff.md using the Write tool. Use this exact format:\n\n```\nHANDOFF CONTEXT\n===============\n\nUSER REQUESTS (AS-IS)\n---------------------\n- [Exact verbatim user requests - NOT paraphrased]\n\nGOAL\n----\n[One sentence describing what should be done next]\n\nWORK COMPLETED\n--------------\n- [First person bullet points of what was done]\n- [Include specific file paths when relevant]\n- [Note key implementation decisions]\n\nCURRENT STATE\n-------------\n- [Current state of the codebase or task]\n- [Build/test status if applicable]\n- [Any environment or configuration state]\n\nPENDING TASKS\n-------------\n- [Tasks that were planned but not completed]\n- [Next logical steps to take]\n- [Any blockers or issues encountered]\n- [Include current todo state from todoread()]\n\nKEY FILES\n---------\n- [path/to/file1] - [brief role description]\n- [path/to/file2] - [brief role description]\n(Maximum 10 files, prioritized by importance)\n- (Include files from git diff/stat and git status)\n\nIMPORTANT DECISIONS\n-------------------\n- [Technical decisions that were made and why]\n- [Trade-offs that were considered]\n- [Patterns or conventions established]\n\nEXPLICIT CONSTRAINTS\n--------------------\n- [Verbatim constraints only - from user or existing AGENTS.md]\n- If none, write: None\n\nCONTEXT FOR CONTINUATION\n------------------------\n- [What the next session needs to know to continue]\n- [Warnings or gotchas to be aware of]\n- [References to documentation if relevant]\n```\n\nWrite this content to .matrix/handoff.md using the Write tool. This file will be automatically loaded when a new session starts.\n\nRules for the summary:\n- Plain text with bullets\n- No markdown headers with # (use the format above with dashes)\n- No bold, italic, or code fences within content\n- Use workspace-relative paths for files\n- Keep it focused - only include what matters for continuation\n- Pick an appropriate length based on complexity\n- USER REQUESTS (AS-IS) and EXPLICIT CONSTRAINTS must be verbatim only\n\n---\n\n# PHASE 4: PROVIDE INSTRUCTIONS\n\nAfter writing the file, inform the user:\n\n```\n---\n\nHANDOFF COMPLETE:\n\nContext saved to .matrix/handoff.md\n\nTo continue in a new session:\n1. Press 'n' in OpenCode TUI to open a new session, or run 'opencode' in a new terminal\n2. Your context will be loaded automatically \u2014 no copy-paste needed\n3. Start with your next task: \"Continue from where I left off. [Your next task]\"\n```\n\n---\n\n# IMPORTANT CONSTRAINTS\n\n- DO NOT attempt to programmatically create new sessions (no API available to agents)\n- DO provide a self-contained summary in the .matrix/handoff.md file\n- DO include workspace-relative file paths\n- DO NOT include sensitive information (API keys, credentials, secrets)\n- DO NOT exceed 10 files in the KEY FILES section\n- DO keep the GOAL section to a single sentence or short paragraph\n\n---\n\n# EXECUTE NOW\n\nBegin by gathering programmatic context, then synthesize the handoff summary.\n";
+export declare const HANDOFF_TEMPLATE = "# Handoff Command\n\n## Purpose\n\nUse /handoff when:\n- The current session context is getting too long and quality is degrading\n- You want to start fresh while preserving essential context from this session\n- The context window is approaching capacity\n\nThis creates a detailed context summary that can be used to continue work in a new session.\n\n---\n\n# PHASE 0: VALIDATE REQUEST\n\nBefore proceeding, confirm:\n- [ ] There is meaningful work or context in this session to preserve\n- [ ] The user wants to create a handoff summary (not just asking about it)\n\nIf the session is nearly empty or has no meaningful context, inform the user there is nothing substantial to hand off.\n\n---\n\n# PHASE 1: GATHER PROGRAMMATIC CONTEXT\n\nExecute these tools to gather concrete data:\n\n1. session_read({ session_id: \"$SESSION_ID\" }) \u2014 full session history\n2. todoread() \u2014 current task progress\n3. Bash({ command: \"git diff --stat HEAD~10..HEAD\" }) \u2014 recent file changes\n4. Bash({ command: \"git status --porcelain\" }) \u2014 uncommitted changes\n\nSuggested execution order:\n\n```\nsession_read({ session_id: \"$SESSION_ID\" })\ntodoread()\nBash({ command: \"git diff --stat HEAD~10..HEAD\" })\nBash({ command: \"git status --porcelain\" })\n```\n\nAnalyze the gathered outputs to understand:\n- What the user asked for (exact wording)\n- What work was completed\n- What tasks remain incomplete (include todo state)\n- What decisions were made\n- What files were modified or discussed (include git diff/stat + status)\n- What patterns, constraints, or preferences were established\n\n---\n\n# PHASE 2: EXTRACT CONTEXT\n\nWrite the context summary from first person perspective (\"I did...\", \"I told you...\").\n\nFocus on:\n- Capabilities and behavior, not file-by-file implementation details\n- What matters for continuing the work\n- Avoiding excessive implementation details (variable names, storage keys, constants) unless critical\n- USER REQUESTS (AS-IS) must be verbatim (do not paraphrase)\n- EXPLICIT CONSTRAINTS must be verbatim only (do not invent)\n\nQuestions to consider when extracting:\n- What did I just do or implement?\n- What instructions did I already give which are still relevant (e.g. follow patterns in the codebase)?\n- What files did I tell you are important or that I am working on?\n- Did I provide a plan or spec that should be included?\n- What did I already tell you that is important (libraries, patterns, constraints, preferences)?\n- What important technical details did I discover (APIs, methods, patterns)?\n- What caveats, limitations, or open questions did I find?\n\n---\n\n# PHASE 3: FORMAT OUTPUT\n\nGenerate a handoff summary. WRITE the summary to .matrixx/handoff.md using the Write tool. Use this exact format:\n\n```\nHANDOFF CONTEXT\n===============\n\nUSER REQUESTS (AS-IS)\n---------------------\n- [Exact verbatim user requests - NOT paraphrased]\n\nGOAL\n----\n[One sentence describing what should be done next]\n\nWORK COMPLETED\n--------------\n- [First person bullet points of what was done]\n- [Include specific file paths when relevant]\n- [Note key implementation decisions]\n\nCURRENT STATE\n-------------\n- [Current state of the codebase or task]\n- [Build/test status if applicable]\n- [Any environment or configuration state]\n\nPENDING TASKS\n-------------\n- [Tasks that were planned but not completed]\n- [Next logical steps to take]\n- [Any blockers or issues encountered]\n- [Include current todo state from todoread()]\n\nKEY FILES\n---------\n- [path/to/file1] - [brief role description]\n- [path/to/file2] - [brief role description]\n(Maximum 10 files, prioritized by importance)\n- (Include files from git diff/stat and git status)\n\nIMPORTANT DECISIONS\n-------------------\n- [Technical decisions that were made and why]\n- [Trade-offs that were considered]\n- [Patterns or conventions established]\n\nEXPLICIT CONSTRAINTS\n--------------------\n- [Verbatim constraints only - from user or existing AGENTS.md]\n- If none, write: None\n\nCONTEXT FOR CONTINUATION\n------------------------\n- [What the next session needs to know to continue]\n- [Warnings or gotchas to be aware of]\n- [References to documentation if relevant]\n```\n\nWrite this content to .matrixx/handoff.md using the Write tool. This file will be automatically loaded when a new session starts.\n\nRules for the summary:\n- Plain text with bullets\n- No markdown headers with # (use the format above with dashes)\n- No bold, italic, or code fences within content\n- Use workspace-relative paths for files\n- Keep it focused - only include what matters for continuation\n- Pick an appropriate length based on complexity\n- USER REQUESTS (AS-IS) and EXPLICIT CONSTRAINTS must be verbatim only\n\n---\n\n# PHASE 4: PROVIDE INSTRUCTIONS\n\nAfter writing the file, inform the user:\n\n```\n---\n\nHANDOFF COMPLETE:\n\nContext saved to .matrixx/handoff.md\n\nTo continue in a new session:\n1. Press 'n' in OpenCode TUI to open a new session, or run 'opencode' in a new terminal\n2. Your context will be loaded automatically \u2014 no copy-paste needed\n3. Start with your next task: \"Continue from where I left off. [Your next task]\"\n```\n\n---\n\n# IMPORTANT CONSTRAINTS\n\n- DO NOT attempt to programmatically create new sessions (no API available to agents)\n- DO provide a self-contained summary in the .matrixx/handoff.md file\n- DO include workspace-relative file paths\n- DO NOT include sensitive information (API keys, credentials, secrets)\n- DO NOT exceed 10 files in the KEY FILES section\n- DO keep the GOAL section to a single sentence or short paragraph\n\n---\n\n# EXECUTE NOW\n\nBegin by gathering programmatic context, then synthesize the handoff summary.\n";

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

@@ -1 +1 @@
-export declare const PICKUP_TEMPLATE = "# Pickup Command\n\n## Purpose\n\nUse /pickup to load handoff context from a previous session.\nThis reads the .matrix/handoff.md file created by /handoff and uses it as context for this session.\n\n---\n\n# PHASE 1: LOAD HANDOFF FILE\n\n1. Read the file .matrix/handoff.md using the Read tool\n2. If the file does not exist, inform the user:\n   \"No handoff context found. Run /handoff in a previous session first to create one.\"\n   Then STOP \u2014 do not proceed to Phase 2.\n\n---\n\n# PHASE 2: ARCHIVE THE FILE\n\nAfter successfully reading the handoff content:\n\n1. Rename .matrix/handoff.md to .matrix/handoff.consumed.md using Bash:\n   Bash({ command: \"mv .matrix/handoff.md .matrix/handoff.consumed.md\" })\n\nThis prevents the same handoff from being picked up again.\n\n---\n\n# PHASE 3: APPLY CONTEXT\n\n1. Acknowledge the loaded context to the user with a brief summary:\n   - What the previous session was working on (from GOAL section)\n   - What was completed (from WORK COMPLETED section)\n   - What remains (from PENDING TASKS section)\n\n2. State: \"Handoff context loaded. Ready to continue.\"\n\n3. If the user provided additional instructions with the /pickup command, begin working on those immediately using the handoff context.\n\n---\n\n# IMPORTANT CONSTRAINTS\n\n- DO read the handoff file using the Read tool \u2014 do not guess or fabricate context\n- DO archive the file after reading to prevent duplicate pickups\n- DO NOT modify the handoff content \u2014 use it as-is for context\n- DO NOT attempt to load handoff.consumed.md \u2014 that is a previously consumed handoff\n- DO summarize the context briefly \u2014 the user wants to know what was picked up\n- DO begin working immediately if the user provided a task alongside /pickup\n";
+export declare const PICKUP_TEMPLATE = "# Pickup Command\n\n## Purpose\n\nUse /pickup to load handoff context from a previous session.\nThis reads the .matrixx/handoff.md file created by /handoff and uses it as context for this session.\n\n---\n\n# PHASE 1: LOAD HANDOFF FILE\n\n1. Read the file .matrixx/handoff.md using the Read tool\n2. If the file does not exist, inform the user:\n   \"No handoff context found. Run /handoff in a previous session first to create one.\"\n   Then STOP \u2014 do not proceed to Phase 2.\n\n---\n\n# PHASE 2: ARCHIVE THE FILE\n\nAfter successfully reading the handoff content:\n\n1. Rename .matrixx/handoff.md to .matrixx/handoff.consumed.md using Bash:\n   Bash({ command: \"mv .matrixx/handoff.md .matrixx/handoff.consumed.md\" })\n\nThis prevents the same handoff from being picked up again.\n\n---\n\n# PHASE 3: APPLY CONTEXT\n\n1. Acknowledge the loaded context to the user with a brief summary:\n   - What the previous session was working on (from GOAL section)\n   - What was completed (from WORK COMPLETED section)\n   - What remains (from PENDING TASKS section)\n\n2. State: \"Handoff context loaded. Ready to continue.\"\n\n3. If the user provided additional instructions with the /pickup command, begin working on those immediately using the handoff context.\n\n---\n\n# IMPORTANT CONSTRAINTS\n\n- DO read the handoff file using the Read tool \u2014 do not guess or fabricate context\n- DO archive the file after reading to prevent duplicate pickups\n- DO NOT modify the handoff content \u2014 use it as-is for context\n- DO NOT attempt to load handoff.consumed.md \u2014 that is a previously consumed handoff\n- DO summarize the context briefly \u2014 the user wants to know what was picked up\n- DO begin working immediately if the user provided a task alongside /pickup\n";

package/dist/features/builtin-commands/templates/start-work.d.ts

@@ -1 +1 @@
-export declare const START_WORK_TEMPLATE = "You are starting a Morpheus work session.\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Oracle-generated plan files at `.matrix/plans/`\n\n2. **Check for active mission state**: Read `.matrix/mission.json` if it exists\n\n3. **Decision logic**:\n   - If `.matrix/mission.json` exists AND plan is NOT complete (has unchecked boxes):\n     - **APPEND** current session to session_ids\n     - Continue work on existing plan\n   - If no active plan OR plan is complete:\n     - List available plan files\n     - If ONE plan: auto-select it\n     - If MULTIPLE plans: show list with timestamps, ask user to select\n\n4. **Create/Update mission.json**:\n   ```json\n   {\n     \"active_plan\": \"/absolute/path/to/plan.md\",\n     \"started_at\": \"ISO_TIMESTAMP\",\n     \"session_ids\": [\"session_id_1\", \"session_id_2\"],\n     \"plan_name\": \"plan-name\"\n   }\n   ```\n\n5. **Read the plan file** and start executing tasks according to atlas workflow\n\n## OUTPUT FORMAT\n\nWhen listing plans for selection:\n```\nAvailable Work Plans\n\nCurrent Time: {ISO timestamp}\nSession ID: {current session id}\n\n1. [plan-name-1.md] - Modified: {date} - Progress: 3/10 tasks\n2. [plan-name-2.md] - Modified: {date} - Progress: 0/5 tasks\n\nWhich plan would you like to work on? (Enter number or plan name)\n```\n\nWhen resuming existing work:\n```\nResuming Work Session\n\nActive Plan: {plan-name}\nProgress: {completed}/{total} tasks\nSessions: {count} (appending current session)\n\nReading plan and continuing from last incomplete task...\n```\n\nWhen auto-selecting single plan:\n```\nStarting Work Session\n\nPlan: {plan-name}\nSession ID: {session_id}\nStarted: {timestamp}\n\nReading plan and beginning execution...\n```\n\n## CRITICAL\n\n- The session_id is injected by the hook - use it directly\n- Always update mission.json BEFORE starting work\n- Read the FULL plan file before delegating any tasks\n- Follow atlas delegation protocols (7-section format)";
+export declare const START_WORK_TEMPLATE = "You are starting a Morpheus work session.\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Oracle-generated plan files at `.matrixx/plans/`\n\n2. **Check for active mission state**: Read `.matrixx/mission.json` if it exists\n\n3. **Decision logic**:\n   - If `.matrixx/mission.json` exists AND plan is NOT complete (has unchecked boxes):\n     - **APPEND** current session to session_ids\n     - Continue work on existing plan\n   - If no active plan OR plan is complete:\n     - List available plan files\n     - If ONE plan: auto-select it\n     - If MULTIPLE plans: show list with timestamps, ask user to select\n\n4. **Create/Update mission.json**:\n   ```json\n   {\n     \"active_plan\": \"/absolute/path/to/plan.md\",\n     \"started_at\": \"ISO_TIMESTAMP\",\n     \"session_ids\": [\"session_id_1\", \"session_id_2\"],\n     \"plan_name\": \"plan-name\"\n   }\n   ```\n\n5. **Read the plan file** and start executing tasks according to atlas workflow\n\n## OUTPUT FORMAT\n\nWhen listing plans for selection:\n```\nAvailable Work Plans\n\nCurrent Time: {ISO timestamp}\nSession ID: {current session id}\n\n1. [plan-name-1.md] - Modified: {date} - Progress: 3/10 tasks\n2. [plan-name-2.md] - Modified: {date} - Progress: 0/5 tasks\n\nWhich plan would you like to work on? (Enter number or plan name)\n```\n\nWhen resuming existing work:\n```\nResuming Work Session\n\nActive Plan: {plan-name}\nProgress: {completed}/{total} tasks\nSessions: {count} (appending current session)\n\nReading plan and continuing from last incomplete task...\n```\n\nWhen auto-selecting single plan:\n```\nStarting Work Session\n\nPlan: {plan-name}\nSession ID: {session_id}\nStarted: {timestamp}\n\nReading plan and beginning execution...\n```\n\n## CRITICAL\n\n- The session_id is injected by the hook - use it directly\n- Always update mission.json BEFORE starting work\n- Read the FULL plan file before delegating any tasks\n- Follow atlas delegation protocols (7-section format)";

package/dist/features/builtin-skills/skills/crypto-market-analysis.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinSkill } from "../types";
+export declare const CRYPTO_MARKET_ANALYSIS_SKILL_NAME = "crypto-market-analysis";
+export declare const CRYPTO_MARKET_ANALYSIS_SKILL_DESCRIPTION = "Professional crypto market analysis: technical analysis (RSI, MACD, Bollinger Bands, volume, Fibonacci), chart patterns, market structure (S/R, order blocks, FVG), candlestick patterns, multi-timeframe analysis. Triggers: 'technical analysis', 'TA', 'chart', 'indicators', 'price action', 'market structure', 'support resistance'.";
+export declare const cryptoMarketAnalysisSkill: BuiltinSkill;

package/dist/features/builtin-skills/skills/crypto-onchain.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinSkill } from "../types";
+export declare const CRYPTO_ONCHAIN_SKILL_NAME = "crypto-onchain";
+export declare const CRYPTO_ONCHAIN_SKILL_DESCRIPTION = "Crypto on-chain analysis and DeFi expertise: MVRV, NVT, SOPR, exchange flows, whale tracking, network health metrics, tokenomics analysis, DeFi protocol assessment (TVL, yield, impermanent loss, protocol risk), and blockchain fundamentals. Triggers: 'on-chain', 'onchain', 'blockchain metrics', 'DeFi', 'TVL', 'tokenomics', 'whale', 'exchange inflow', 'MVRV', 'NVT'.";
+export declare const cryptoOnchainSkill: BuiltinSkill;

package/dist/features/builtin-skills/skills/crypto-trading.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinSkill } from "../types";
+export declare const CRYPTO_TRADING_SKILL_NAME = "crypto-trading";
+export declare const CRYPTO_TRADING_SKILL_DESCRIPTION = "Professional crypto trading strategies and risk management: trend following, mean reversion, breakout, swing/scalping, position sizing, stop-loss placement, portfolio allocation, futures/perpetuals (funding rates, basis), options strategies. Triggers: 'trading strategy', 'position sizing', 'risk management', 'futures', 'perpetuals', 'stop loss', 'take profit', 'entry exit'.";
+export declare const cryptoTradingSkill: BuiltinSkill;

package/dist/features/builtin-skills/skills/index.d.ts

@@ -36,3 +36,8 @@ export { securityCryptoSkill } from "./security-crypto";
 export { securityInfraSkill } from "./security-infra";
 export { securityReviewSkill } from "./security-review";
 export { documentReaderSkill } from "./document-reader";
+export { cryptoMarketAnalysisSkill } from "./crypto-market-analysis";
+export { cryptoTradingSkill } from "./crypto-trading";
+export { cryptoOnchainSkill } from "./crypto-onchain";
+export { tddEnforcerSkill } from "./tdd-enforcer";
+export { reviewWorkSkill } from "./review-work";

package/dist/features/builtin-skills/skills/review-work.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinSkill } from "../types";
+export declare const REVIEW_WORK_SKILL_NAME = "review-work";
+export declare const REVIEW_WORK_SKILL_DESCRIPTION = "Post-implementation review orchestrator. Launches 5 parallel background sub-agents: Oracle (goal/constraint verification), Oracle (code quality), Oracle (security), unspecified-high (hands-on QA execution), unspecified-high (context mining from GitHub/git/Slack/Notion). All must pass for review to pass. MUST USE after completing any significant implementation work. Triggers: 'review work', 'review my work', 'review changes', 'QA my work', 'verify implementation', 'check my work', 'validate changes', 'post-implementation review'.";
+export declare const reviewWorkSkill: BuiltinSkill;

package/dist/features/builtin-skills/skills/tdd-enforcer.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinSkill } from "../types";
+export declare const TDD_ENFORCER_SKILL_NAME = "tdd-enforcer";
+export declare const TDD_ENFORCER_SKILL_DESCRIPTION = "Test-Driven Development enforcement: RED-GREEN-REFACTOR cycle, mandatory test-first for every fix/feature/refactor, bun test conventions, BDD comment patterns, unit vs integration test strategy, evidence requirements. Triggers: 'write tests', 'TDD', 'test first', 'unit test', 'integration test', 'test coverage', 'testing', 'failing test', 'test suite'.";
+export declare const tddEnforcerSkill: BuiltinSkill;

package/dist/features/mission-state/constants.d.ts

@@ -1,10 +1,10 @@
 /**
  * Mission State Constants
  */
-export declare const MISSION_DIR = ".matrix";
+export declare const MISSION_DIR = ".matrixx";
 export declare const MISSION_FILE = "mission.json";
-export declare const MISSION_STATE_PATH = ".matrix/mission.json";
+export declare const MISSION_STATE_PATH = ".matrixx/mission.json";
 export declare const NOTEPAD_DIR = "notepads";
-export declare const NOTEPAD_BASE_PATH = ".matrix/notepads";
+export declare const NOTEPAD_BASE_PATH = ".matrixx/notepads";
 /** Oracle planner plan directory pattern */
-export declare const ORACLE_PLANS_DIR = ".matrix/plans";
+export declare const ORACLE_PLANS_DIR = ".matrixx/plans";

package/dist/features/mission-state/storage.d.ts

@@ -11,7 +11,7 @@ export declare function appendSessionId(directory: string, sessionId: string): M
 export declare function clearMissionState(directory: string): boolean;
 /**
  * Find Oracle plan files for this project.
- * Oracle stores plans at: {project}/.matrix/plans/{name}.md
+ * Oracle stores plans at: {project}/.matrixx/plans/{name}.md
  */
 export declare function findOraclePlans(directory: string): string[];
 /**

package/dist/features/run-continuation-state/constants.d.ts

@@ -0,0 +1 @@
+export declare const CONTINUATION_MARKER_DIR = ".matrixx/run-continuation";

package/dist/features/run-continuation-state/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./constants";
+export * from "./storage";

package/dist/features/run-continuation-state/storage.d.ts

@@ -0,0 +1,6 @@
+import type { ContinuationMarker, ContinuationMarkerSource, ContinuationMarkerState } from "./types";
+export declare function readContinuationMarker(directory: string, sessionID: string): ContinuationMarker | null;
+export declare function setContinuationMarkerSource(directory: string, sessionID: string, source: ContinuationMarkerSource, state: ContinuationMarkerState, reason?: string): ContinuationMarker;
+export declare function clearContinuationMarker(directory: string, sessionID: string): void;
+export declare function isContinuationMarkerActive(marker: ContinuationMarker): boolean;
+export declare function getActiveContinuationMarkerReason(marker: ContinuationMarker): string | null;

package/dist/features/run-continuation-state/types.d.ts

@@ -0,0 +1,12 @@
+export type ContinuationMarkerSource = "todo" | "stop";
+export type ContinuationMarkerState = "idle" | "active" | "stopped";
+export interface ContinuationMarkerSourceEntry {
+    state: ContinuationMarkerState;
+    reason?: string;
+    updatedAt: string;
+}
+export interface ContinuationMarker {
+    sessionID: string;
+    updatedAt: string;
+    sources: Partial<Record<ContinuationMarkerSource, ContinuationMarkerSourceEntry>>;
+}

package/dist/features/team-mode/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./team-worktree";

package/dist/features/team-mode/team-layout-tmux/index.d.ts

@@ -0,0 +1 @@
+export { canVisualize, createTeamLayout, removeTeamLayout } from "./layout";

package/dist/features/team-mode/team-layout-tmux/layout.d.ts

@@ -0,0 +1,15 @@
+import type { TmuxSessionManager } from "../../tmux-subagent/manager";
+type TeamLayoutMember = {
+    name: string;
+    sessionId: string;
+    color?: string;
+};
+type TeamLayoutResult = {
+    focusWindowId: string;
+    gridWindowId: string;
+    panesByMember: Record<string, string>;
+};
+export declare function canVisualize(): boolean;
+export declare function createTeamLayout(teamRunId: string, members: Array<TeamLayoutMember>, tmuxMgr: TmuxSessionManager): Promise<TeamLayoutResult | null>;
+export declare function removeTeamLayout(teamRunId: string, tmuxMgr: TmuxSessionManager): Promise<void>;
+export {};

package/dist/features/team-mode/team-worktree/cleanup.d.ts

@@ -0,0 +1,3 @@
+import type { TeamModeConfig } from "./manager";
+export declare function removeWorktree(worktreePath: string): Promise<void>;
+export declare function findOrphanWorktrees(baseDir: string, _config: TeamModeConfig): Promise<string[]>;

package/dist/features/team-mode/team-worktree/index.d.ts

@@ -0,0 +1,2 @@
+export { GitUnavailableError, createWorktree, isGitAvailable, validateWorktreeSpec } from "./manager";
+export { findOrphanWorktrees, removeWorktree } from "./cleanup";

package/dist/features/team-mode/team-worktree/manager.d.ts

@@ -0,0 +1,15 @@
+export type TeamModeConfig = {
+    worktreeBaseDir?: string;
+};
+export declare class GitUnavailableError extends Error {
+    constructor();
+}
+declare function runGit(args: string[], cwd?: string): Promise<{
+    code: number;
+    stderr: string;
+}>;
+export declare function setGitCommandRunnerForTests(runner: typeof runGit): void;
+export declare function isGitAvailable(): Promise<boolean>;
+export declare function validateWorktreeSpec(spec: string): void;
+export declare function createWorktree(repoRoot: string, _teamRunId: string, _memberName: string, worktreePath: string, _config: TeamModeConfig): Promise<string>;
+export {};