opencode-matrixx 2.6.2 → 2.6.3

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

@@ -1,13 +1,6 @@
 /**
  * Default ultrawork message optimized for Claude series models.
- *
- * Key characteristics:
- * - Natural tool-like usage of explore/librarian agents (run_in_background=true)
- * - Parallel execution emphasized - fire agents and continue working
- * - Survey skills first methodology
- * - Goal registration, scenario contracts, durable notepad
- * - TDD workflow with RED→GREEN→SURFACE→REFACTOR→REGRESSION
- * - Manual QA mandate with cleanup receipts
+ * Condensed v2: ~9k chars (was 19k) to reduce token pressure.
  */
-export declare const ULTRAWORK_DEFAULT_MESSAGE: string;
+export declare const ULTRAWORK_DEFAULT_MESSAGE = "<ultrawork-mode>\n\n**MANDATORY**: You MUST say \"ULTRAWORK MODE ENABLED!\" to the user as your first response when this mode activates. This is non-negotiable.\n\n[CODE RED] Maximum precision required. Ultrathink before acting.\n\n## ABSOLUTE CERTAINTY REQUIRED\n\n**YOU MUST NOT START IMPLEMENTATION UNTIL 100% CERTAIN.** You must: FULLY UNDERSTAND intent, EXPLORE codebase patterns, HAVE CRYSTAL CLEAR PLAN, RESOLVE ALL AMBIGUITY.\n\n### MANDATORY CERTAINTY PROTOCOL\n1. **THINK DEEPLY** - What is user's TRUE intent?\n2. **EXPLORE THOROUGHLY** - Fire trinity/operator agents (see below)\n3. **CONSULT SPECIALISTS** - Oracle (conventional), Matrix-bend (non-conventional)\n4. **ASK USER** - Only if ambiguity remains after exploration\n\n**NOT READY if:** assuming requirements, unsure files, \"probably\"/\"maybe\" in plan, can't explain exact steps.\n\n**WHEN IN DOUBT:**\ntask(subagent_type=\"trinity\", load_skills=[], prompt=\"I'm implementing [TASK] and need [KNOWLEDGE GAP]. Find [X] patterns \u2014 file paths, approach, conventions. Focus src/, skip tests. Return paths + descriptions.\", run_in_background=true)\ntask(subagent_type=\"operator\", load_skills=[], prompt=\"I'm working with [LIBRARY] and need [INFO]. Find docs + production examples \u2014 API, config, pitfalls. Skip tutorials.\", run_in_background=true)\ntask(subagent_type=\"oracle\", load_skills=[], prompt=\"Review my approach to [TASK]: [PLAN + FILES + CHANGES]. Concerns: [UNCERTAINTIES]. Evaluate correctness, missing issues, better alternatives.\", run_in_background=false)\n\n**ONLY AFTER** gathering context, resolving ambiguity, having precise step-by-step plan with 100% confidence \u2014 THEN implement.\n\n---\n\n## NO EXCUSES. DELIVER EXACTLY X.\n\n| Violation | Consequence |\n| \"I couldn't because...\" | UNACCEPTABLE \u2014 Find way or ask |\n| \"Simplified version...\" | UNACCEPTABLE \u2014 Deliver FULL |\n| \"You can extend later...\" | UNACCEPTABLE \u2014 Finish NOW |\n\n**IF BLOCKED:** Consult specialists, ask user, explore alternatives \u2014 never give up or deliver compromised version.\n\n\nTHE USER'S ORIGINAL REQUEST IS SACRED \u2014 deliver exactly X, no subset, no demo.\n\nSURVEY THE SKILLS \u2014 enumerate every skill, read descriptions, pick every relevant one, state choices with one-line reasons before acting.\n\n## MANDATORY: ACCEPTANCE CRITERIA + QA EXECUTION (NON-NEGOTIABLE)\nBEFORE writing ANY code, output an Acceptance Criteria block.\n1. [CRITERION]: [Observable, binary pass/fail condition] \u2014 PASS or FAIL\n2. Minimum 3 criteria (correctness, no regression, typecheck/lint)\n### Verification Commands:\n- [Exact command to run] -> [Expected output]\n3. Run every verification command, report \u2705/\u274C per criterion, fix and re-run ALL if any fail \u2014 NO EVIDENCE = NOT VERIFIED = NOT DONE\n\n---\n\nYOU MUST LEVERAGE ALL AVAILABLE AGENTS / CATEGORY + SKILLS TO THEIR FULLEST POTENTIAL.\n\n**SURVEY THE SKILLS FIRST:** Enumerate every skill, read descriptions, pick every genuinely relevant one, use them rather than working raw. State chosen skills with one-line reasons before acting.\n\n## MANDATORY: PLAN AGENT INVOCATION\n\n**SIZE SCOPE FIRST.** 2+ steps / multi-file / unclear-scope / architecture = MUST call plan agent.\n\n| Task has 2+ steps | MUST call plan agent |\n| Task scope unclear | MUST call plan agent |\n| Implementation required | MUST call plan agent |\n| Architecture needed | MUST call plan agent |\n\nAfter plan returns, execute in EXACT wave order and verification it specifies.\n\ntask(subagent_type=\"oracle\", load_skills=[], prompt=\"<gathered context + user request>\")\n\n**WHY:** Plan agent analyzes dependencies, outputs parallel task graph with waves, provides structured TODOs with category+skills.\n\n### SESSION CONTINUITY\n- Plan asks questions \u2192 task(session_id=\"{id}\", prompt=\"<answer>\")\n- Refine plan \u2192 task(session_id=\"{id}\", prompt=\"Adjust: <feedback>\")\n\n**FAILURE TO CALL PLAN = INCOMPLETE WORK.**\n\n---\n\n## AGENT UTILIZATION\n\n| Type | Action | Why |\n| Codebase exploration | task(subagent_type=\"trinity\", run_in_background=true) | Parallel, context-efficient |\n| Docs lookup | task(subagent_type=\"operator\", run_in_background=true) | Specialized knowledge |\n| Planning | task(subagent_type=\"oracle\") | Parallel task graph |\n| Hard problem | task(subagent_type=\"oracle\" or category=\"matrix-bend\") | Architecture/debugging |\n| Implementation | task(category=\"...\", load_skills=[...]) | Domain-optimized |\n\n**DELEGATE BY DEFAULT. DO IT YOURSELF only if <10 lines, single file, obvious pattern, full context loaded.**\n\n---\n\n## EXPLORER COMPLETION PROTOCOL (MANDATORY \u2014 FIXES STALL)\n\nAfter firing 3 parallel explorers with run_in_background=true:\n\n1. **POLL RESULTS:** Immediately call background_output(task_id=\"...\") for each explorer \u2014 wait max 30s per explorer\n2. **USE Promise.allSettled:** Never halt waiting for one explorer \u2014 collect what you can, note gaps\n3. **ALWAYS INVOKE PLAN:** Even if 0/3 explorers succeed, UNCONDITIONALLY call task(subagent_type=\"oracle\", ...) in finally block\n4. **TIMEOUT FALLBACK:** If background tasks still running after 30s, proceed with partial context and document missing areas as assumptions\n5. **NEVER STALL:** The session idle handler will bootstrap you to plan if you fail \u2014 but don't rely on it; invoke plan yourself\n\n```javascript\n// CORRECT \u2014 always reaches plan\nconst ids = [];\nids.push((await task(trinity, run_in_background=true)).task_id);\nids.push((await task(trinity, run_in_background=true)).task_id);\nids.push((await task(operator, run_in_background=true)).task_id);\n// poll\nconst results = await Promise.allSettled(ids.map(id => background_output(id)));\n// ALWAYS plan\nawait task(subagent_type=\"oracle\", prompt=\"...with explorer results: \"+JSON.stringify(results));\n```\n\n---\n\n## VERIFICATION GUARANTEE\n\n**NOTHING done without PROOF.**\n\n### Goal Registration\nRegister via todowrite: objective + 3+ scenarios (happy/edge/regression) + \"I'll stop when <observable>\"\n\n### Scenario Contract (3+ required)\n- Binary pass condition (\"returns 200 + body matches schema\")\n- Real surface (curl/CLI/browser), not just \"tests pass\"\n- Test file + test id (RED \u2192 GREEN)\n\n### Durable Notepad\n`# Ultrawork Notepad - <goal>\n## Plan\n## Scenarios\n## Now\n## Todo\n## Findings\n## Learnings`\n\n### TDD: RED \u2192 GREEN \u2192 SURFACE \u2192 REFACTOR \u2192 REGRESSION\n\n### QA Protocol\nRun every verification command, report \u2705/\u274C per criterion, fix and re-run ALL if any fail.\n\n## QA Report\n| # | Criterion | Result | Evidence |\n| 1 | ... | \u2705 PASS | ... |\n\n**Overall: X/Y PASS \u2014 ACCEPTED/NEEDS FIX**\n\n### Reviewer Gate\nTrigger: strictly/rigorously, 3+ files, 20+ turns, 30+ min, refactor/security. Spawn reviewer, fix criterion-cited blockers, re-submit max 2x.\n\n## EXECUTION RULES\n- TODO: `path: <action> for <scenario-id> \u2014 verify by <check>` \u2014 ONE in_progress at a time\n- PARALLEL: task(run_in_background=true) \u2014 NEVER sequential, never parallelise RED/GREEN\n- VERIFY: Re-read request, check every scenario PASS with both artifacts\n- DELEGATE: Orchestrate, don't do everything yourself\n\n## WORKFLOW\n1. Analyze request \u2192 2. Spawn explorers+direct tools IN PARALLEL \u2192 3. Plan agent \u2192 4. Execute with verification\n\n## ZERO TOLERANCE\n- NO Scope Reduction, NO MockUp, NO Partial \u2014 deliver FULL 100%\n- NO TEST DELETION \u2014 fix code, not tests\n\n1. EXPLORES + LIBRARIANS (parallel background)\n2. GATHER \u2192 PLAN AGENT\n3. WORK BY DELEGATING\n\nNOW.\n\n</ultrawork-mode>\n\n---\n";
 export declare function getDefaultUltraworkMessage(): string;

package/dist/hooks/preemptive-compaction-trigger.d.ts

@@ -1,5 +1,5 @@
 import type { MatrixxConfig } from "../config";
-import { type ContextLimitModelCacheState } from "../shared/context-limit-resolver";
+import { type ContextLimitModelCacheState } from "../shared/context-limits";
 import type { CachedCompactionState, PreemptiveCompactionContext } from "./preemptive-compaction-types";
 export declare function runPreemptiveCompactionIfNeeded(args: {
     ctx: PreemptiveCompactionContext;

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

@@ -3,5 +3,4 @@ export declare const PROJECT_MARKERS: string[];
 export declare const PROJECT_RULE_SUBDIRS: [string, string][];
 export declare const PROJECT_RULE_FILES: string[];
 export declare const GITHUB_INSTRUCTIONS_PATTERN: RegExp;
-export declare const USER_RULE_DIR = ".claude/rules";
 export declare const RULE_EXTENSIONS: string[];

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

@@ -13,7 +13,6 @@ interface RuleFrontmatterResult {
  *     - "**\/*.py"
  *     - "src/**\/*.ts"
  * - Comma-separated: globs: "**\/*.py, src/**\/*.ts"
- * - Claude Code 'paths' field (alias for globs)
  */
 export declare function parseRuleFrontmatter(content: string): RuleFrontmatterResult;
 export {};

package/dist/hooks/rules-injector/rule-file-finder.d.ts

@@ -1,15 +1,13 @@
 import type { RuleFileCandidate } from "./types";
 /**
  * Find all rule files for a given context.
- * Searches from currentFile upward to projectRoot for rule directories,
- * then user-level directory (~/.claude/rules).
+ * Searches from currentFile upward to projectRoot for rule directories.
  *
  * IMPORTANT: This searches EVERY directory from file to project root.
  * Not just the project root itself.
  *
  * @param projectRoot - Project root path (or null if outside any project)
- * @param homeDir - User home directory
  * @param currentFile - Current file being edited (for distance calculation)
  * @returns Array of rule file candidates sorted by distance
  */
-export declare function findRuleFiles(projectRoot: string | null, homeDir: string, currentFile: string): RuleFileCandidate[];
+export declare function findRuleFiles(projectRoot: string | null, currentFile: string): RuleFileCandidate[];

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

@@ -1,7 +1,6 @@
 /**
- * Rule file metadata (Claude Code style frontmatter)
- * Supports both Claude Code format (globs, paths) and GitHub Copilot format (applyTo)
- * @see https://docs.anthropic.com/en/docs/claude-code/settings#rule-files
+ * Rule file metadata (frontmatter)
+ * Supports globs format and GitHub Copilot format (applyTo)
  * @see https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot
  */
 export interface RuleMetadata {

package/dist/hooks/task-continuation-enforcer/constants.d.ts

@@ -1,6 +1,7 @@
 export declare const HOOK_NAME = "task-continuation-enforcer";
 export declare const DEFAULT_SKIP_AGENTS: string[];
 export declare const CONTINUATION_PROMPT: string;
+export declare const BOOTSTRAP_PROMPT: string;
 export declare const COUNTDOWN_SECONDS = 2;
 export declare const TOAST_DURATION_MS = 900;
 export declare const COUNTDOWN_GRACE_PERIOD_MS = 500;

package/dist/hooks/task-continuation-enforcer/ulw-bootstrap.test.d.ts

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