opencode-matrixx 2.0.0 → 2.1.0

package/dist/index.js

@@ -17496,7 +17496,8 @@ import * as fs4 from "fs";
 // src/shared/migration/hook-names.ts
 var HOOK_NAME_MAP = {
   "anthropic-auto-compact": "anthropic-context-window-limit-recovery",
-  "sisyphus-orchestrator": "atlas",
+  "sisyphus-orchestrator": "architect",
+  "sisyphus-junior-notepad": "mouse-notepad",
   "empty-message-sanitizer": null
 };
 function migrateHookNames(hooks) {
@@ -18876,7 +18877,7 @@ async function isCallerOrchestrator(sessionID, client) {
   if (isSqliteBackend() && client) {
     try {
       const nearest2 = await findNearestMessageWithFieldsFromSDK(client, sessionID);
-      return getAgentConfigKey(nearest2?.agent ?? "") === "atlas";
+      return getAgentConfigKey(nearest2?.agent ?? "") === "architect";
     } catch (error) {
       log("[session-utils] SDK orchestrator check failed", { sessionID, error: String(error) });
       return false;
@@ -21178,7 +21179,7 @@ You have an active work plan with incomplete tasks. Continue working.
 RULES:
 - **FIRST**: Read the plan file NOW to check exact current progress \u2014 count remaining \`- [ ]\` tasks
 - Proceed without asking for permission
-- Change \`- [ ]\` to \`- [x]\` in the plan file when done
+- **IMMEDIATELY AFTER COMPLETION**: Mark \`- [ ]\` \u2192 \`- [x]\` in the plan file. This is MANDATORY \u2014 unmarked checkboxes = lost progress.
 - Use the notepad at .matrixx/notepads/{PLAN_NAME}/ to record learnings
 - Do not stop until all tasks are complete
 - If blocked, document the blocker and move to the next task`;
@@ -21250,7 +21251,7 @@ ${createSystemDirective(SystemDirectiveTypes.DELEGATION_REQUIRED)}
 
 **STOP. YOU ARE VIOLATING ORCHESTRATOR PROTOCOL.**
 
-You (Atlas) are attempting to directly modify a file outside \`.matrixx/\`.
+You (Architect) are attempting to directly modify a file outside \`.matrixx/\`.
 
 **Path attempted:** $FILE_PATH
 
@@ -21376,7 +21377,7 @@ async function getLastAgentFromSession(sessionID, client) {
 
 // src/hooks/architect/event-handler.ts
 var CONTINUATION_COOLDOWN_MS = 5000;
-function createAtlasEventHandler(input) {
+function createArchitectEventHandler(input) {
   const { ctx, options, sessions, getState } = input;
   return async ({ event }) => {
     const props = event.properties;
@@ -21450,6 +21451,7 @@ function createAtlasEventHandler(input) {
       const progress = getPlanProgress(missionState.active_plan);
       if (progress.isComplete) {
         log(`[${HOOK_NAME}] Mission complete`, { sessionID, plan: missionState.plan_name });
+        clearMissionState(ctx.directory);
         return;
       }
       const now = Date.now();
@@ -21591,15 +21593,24 @@ Read(".matrixx/plans/${planName}.md")
 Count exactly: how many \`- [ ]\` remain? How many \`- [x]\` completed?
 This is YOUR ground truth. Use it to decide what comes next.
 
-**STEP 7: MARK COMPLETION IN PLAN FILE (IMMEDIATELY)**
+**STEP 7: MARK COMPLETION IN PLAN FILE (IMMEDIATELY \u2014 NON-NEGOTIABLE)**
 
-RIGHT NOW - Do not delay. Verification passed \u2192 Mark IMMEDIATELY.
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
 
-Update the plan file \`.matrixx/plans/${planName}.md\`:
-- Change \`- [ ]\` to \`- [x]\` for the completed task
-- Use \`Edit\` tool to modify the checkbox
+**CRITICAL: THIS STEP IS MANDATORY. Skipping it = progress lost.**
 
-**DO THIS BEFORE ANYTHING ELSE. Unmarked = Untracked = Lost progress.**
+RIGHT NOW \u2014 Do not delay. Verification passed \u2192 Mark IMMEDIATELY.
+
+1. Open plan file: \`.matrixx/plans/${planName}.md\`
+2. Find the \`- [ ]\` checkbox for the completed task
+3. Change \`- [ ]\` \u2192 \`- [x]\` using the \`Edit\` tool
+4. Verify the edit was applied
+
+**WARNING**: If you skip this step, the task appears UNDONE.
+The system counts \`- [x]\` checkboxes to track progress.
+No checkbox = No progress = Work wasted.
+
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
 
 **STEP 8: COMMIT ATOMIC UNIT**
 
@@ -21700,6 +21711,9 @@ function createToolExecuteAfterHandler(input) {
       const missionState = readMissionState(ctx.directory);
       if (missionState) {
         const progress = getPlanProgress(missionState.active_plan);
+        if (progress.isComplete) {
+          return;
+        }
         if (toolInput.sessionID && !missionState.session_ids?.includes(toolInput.sessionID)) {
           appendSessionId(ctx.directory, toolInput.sessionID);
           log(`[${HOOK_NAME}] Appended session to mission`, {
@@ -21778,8 +21792,8 @@ ${prompt}`;
   };
 }
 
-// src/hooks/architect/atlas-hook.ts
-function createAtlasHook(ctx, options) {
+// src/hooks/architect/architect-hook.ts
+function createArchitectHook(ctx, options) {
   const sessions = new Map;
   const pendingFilePaths = new Map;
   function getState(sessionID) {
@@ -21791,7 +21805,7 @@ function createAtlasHook(ctx, options) {
     return state3;
   }
   return {
-    handler: createAtlasEventHandler({ ctx, options, sessions, getState }),
+    handler: createArchitectEventHandler({ ctx, options, sessions, getState }),
     "tool.execute.before": createToolExecuteBeforeHandler({ ctx, pendingFilePaths }),
     "tool.execute.after": createToolExecuteAfterHandler({ ctx, pendingFilePaths })
   };
@@ -23466,7 +23480,7 @@ var START_WORK_TEMPLATE = `You are starting a Morpheus work session.
    }
    \`\`\`
 
-5. **Read the plan file** and start executing tasks according to atlas workflow
+5. **Read the plan file** and start executing tasks according to architect workflow
 
 ## OUTPUT FORMAT
 
@@ -23510,7 +23524,7 @@ Reading plan and beginning execution...
 - The session_id is injected by the hook - use it directly
 - Always update mission.json BEFORE starting work
 - Read the FULL plan file before delegating any tasks
-- Follow atlas delegation protocols (7-section format)`;
+- Follow architect delegation protocols (7-section format)`;
 
 // src/features/builtin-commands/templates/stop-continuation.ts
 var STOP_CONTINUATION_TEMPLATE = `Stop all continuation mechanisms for the current session.
@@ -50583,7 +50597,7 @@ function createMatrixLoopHook(ctx, options) {
 // src/hooks/matrix-loop/index.ts
 init_storage();
 // src/hooks/mouse-notepad/constants.ts
-var HOOK_NAME5 = "sisyphus-junior-notepad";
+var HOOK_NAME5 = "mouse-notepad";
 var NOTEPAD_DIRECTIVE = `
 <Work_Context>
 ## Notepad Location (for recording learnings)
@@ -50935,6 +50949,7 @@ function createPostCompactionDegradationMonitor(args) {
 
 // src/shared/context-limit-resolver.ts
 var DEFAULT_ANTHROPIC_ACTUAL_LIMIT = 200000;
+var DEFAULT_NON_ANTHROPIC_FALLBACK_LIMIT = 128000;
 function isAnthropicProvider2(providerID) {
   const normalized = providerID.toLowerCase();
   return normalized === "anthropic" || normalized === "google-vertex-anthropic" || normalized === "aws-bedrock-anthropic";
@@ -50955,7 +50970,7 @@ function resolveActualContextLimit(providerID, modelID, modelCacheState) {
       return cachedLimit;
     return DEFAULT_ANTHROPIC_ACTUAL_LIMIT;
   }
-  return modelCacheState?.modelContextLimitsCache?.get(`${providerID}/${modelID}`) ?? null;
+  return modelCacheState?.modelContextLimitsCache?.get(`${providerID}/${modelID}`) ?? DEFAULT_NON_ANTHROPIC_FALLBACK_LIMIT;
 }
 
 // src/hooks/preemptive-compaction-trigger.ts
@@ -57014,8 +57029,8 @@ function createWriteExistingFileGuardHook(ctx) {
       }
       const resolvedPath = normalize(isAbsolute5(filePath) ? filePath : resolve7(ctx.directory, filePath));
       if (existsSync40(resolvedPath)) {
-        const sisyphusRoot = join55(ctx.directory, ".matrixx") + sep;
-        const isMatrixMarkdown = resolvedPath.startsWith(sisyphusRoot) && resolvedPath.endsWith(".md");
+        const matrixxRoot = join55(ctx.directory, ".matrixx") + sep;
+        const isMatrixMarkdown = resolvedPath.startsWith(matrixxRoot) && resolvedPath.endsWith(".md");
         if (isMatrixMarkdown) {
           log("[write-existing-file-guard] Allowing .matrixx/*.md overwrite", {
             sessionID: input.sessionID,
@@ -57103,7 +57118,7 @@ function createContinuationHooks(args) {
     }
   }
   const backgroundNotificationHook = isHookEnabled("background-notification") ? safeHook("background-notification", () => createBackgroundNotificationHook(backgroundManager)) : null;
-  const atlasHook = isHookEnabled("architect") ? safeHook("architect", () => createAtlasHook(ctx, {
+  const architectHook = isHookEnabled("architect") ? safeHook("architect", () => createArchitectHook(ctx, {
     directory: ctx.directory,
     backgroundManager,
     isContinuationStopped: (sessionID) => stopContinuationGuard?.isStopped(sessionID) ?? false,
@@ -57116,7 +57131,7 @@ function createContinuationHooks(args) {
     todoContinuationEnforcer,
     unstableAgentBabysitter,
     backgroundNotificationHook,
-    atlasHook
+    architectHook
   };
 }
 
@@ -74591,7 +74606,7 @@ ${textContent || "(No text output)"}`;
 }
 
 // src/tools/background-task/create-background-output.ts
-var SISYPHUS_JUNIOR_AGENT = getAgentDisplayName("mouse");
+var MOUSE_AGENT = getAgentDisplayName("mouse");
 function resolveToolCallID(ctx) {
   if (typeof ctx.callID === "string" && ctx.callID.trim() !== "")
     return ctx.callID;
@@ -74602,7 +74617,7 @@ function resolveToolCallID(ctx) {
   return;
 }
 function formatResolvedTitle(task) {
-  const label = task.agent === SISYPHUS_JUNIOR_AGENT && task.category ? task.category : task.agent;
+  const label = task.agent === MOUSE_AGENT && task.category ? task.category : task.agent;
   return `${label} - ${task.description}`;
 }
 function isTaskActiveStatus(status) {
@@ -75370,11 +75385,11 @@ function parseModelString2(model) {
 }
 
 // src/tools/delegate-task/mouse-agent.ts
-var SISYPHUS_JUNIOR_AGENT2 = "mouse";
+var MOUSE_AGENT2 = "mouse";
 
 // src/tools/delegate-task/category-resolver.ts
 async function resolveCategoryExecution(args, executorCtx, inheritedModel, systemDefaultModel) {
-  const { client: client2, userCategories, sisyphusJuniorModel } = executorCtx;
+  const { client: client2, userCategories, mouseModel } = executorCtx;
   const availableModels = await getAvailableModelsForDelegateTask(client2);
   const categoryName = args.category;
   const enabledCategories = mergeCategories(userCategories);
@@ -75419,16 +75434,16 @@ Available categories: ${allCategoryNames}`
   let actualModel;
   let modelInfo;
   let categoryModel;
-  const overrideModel = sisyphusJuniorModel;
+  const overrideModel = mouseModel;
   const explicitCategoryModel = userCategories?.[args.category]?.model;
   if (!requirement) {
-    actualModel = explicitCategoryModel ?? overrideModel ?? resolved.model;
+    actualModel = explicitCategoryModel ?? resolved.model ?? overrideModel;
     if (actualModel) {
-      modelInfo = explicitCategoryModel || overrideModel ? { model: actualModel, type: "user-defined", source: "override" } : { model: actualModel, type: "system-default", source: "system-default" };
+      modelInfo = explicitCategoryModel ? { model: actualModel, type: "user-defined", source: "override" } : resolved.model ? { model: actualModel, type: "system-default", source: "system-default" } : { model: actualModel, type: "user-defined", source: "override" };
     }
   } else {
     const resolution = resolveModelForDelegateTask({
-      userModel: explicitCategoryModel ?? overrideModel,
+      userModel: explicitCategoryModel,
       categoryDefaultModel: resolved.model,
       fallbackChain: requirement.fallbackChain,
       availableModels,
@@ -75448,7 +75463,7 @@ Available categories: ${allCategoryNames}`
           error: `Invalid model format "${actualModel}". Expected "provider/model" format (e.g., "anthropic/claude-sonnet-4-5").`
         };
       }
-      const type = explicitCategoryModel || overrideModel ? "user-defined" : systemDefaultModel && actualModel === systemDefaultModel ? "system-default" : "category-default";
+      const type = explicitCategoryModel ? "user-defined" : systemDefaultModel && actualModel === systemDefaultModel ? "system-default" : "category-default";
       const source = type === "user-defined" ? "override" : type === "system-default" ? "system-default" : "category-default";
       modelInfo = { model: actualModel, type, source };
       const parsedModel = parseModelString2(actualModel);
@@ -75484,7 +75499,7 @@ Available categories: ${categoryNames.join(", ")}`
   const unstableModel = actualModel?.toLowerCase();
   const isUnstableAgent = resolved.config.is_unstable_agent === true || (unstableModel ? unstableModel.includes("gemini") || unstableModel.includes("minimax") : false);
   return {
-    agentToUse: SISYPHUS_JUNIOR_AGENT2,
+    agentToUse: MOUSE_AGENT2,
     categoryModel,
     categoryPromptAppend,
     modelInfo,
@@ -75544,11 +75559,11 @@ async function resolveSubagentExecution(args, executorCtx, parentAgent, category
     return { agentToUse: "", categoryModel: undefined, error: `Agent name cannot be empty.` };
   }
   const agentName = args.subagent_type.trim();
-  if (agentName.toLowerCase() === SISYPHUS_JUNIOR_AGENT2.toLowerCase()) {
+  if (agentName.toLowerCase() === MOUSE_AGENT2.toLowerCase()) {
     return {
       agentToUse: "",
       categoryModel: undefined,
-      error: `Cannot use subagent_type="${SISYPHUS_JUNIOR_AGENT2}" directly. Use category parameter instead (e.g., ${categoryExamples}).
+      error: `Cannot use subagent_type="${MOUSE_AGENT2}" directly. Use category parameter instead (e.g., ${categoryExamples}).
 
 Mouse is spawned automatically when you specify a category. Pick the appropriate category for your task domain.`
     };
@@ -76685,13 +76700,13 @@ Prompts MUST be in English.`;
     async execute(args, toolContext) {
       const ctx = toolContext;
       if (args.category) {
-        if (args.subagent_type && args.subagent_type !== SISYPHUS_JUNIOR_AGENT2) {
+        if (args.subagent_type && args.subagent_type !== MOUSE_AGENT2) {
           log("[task] category provided - overriding subagent_type to mouse", {
             category: args.category,
             subagent_type: args.subagent_type
           });
         }
-        args.subagent_type = SISYPHUS_JUNIOR_AGENT2;
+        args.subagent_type = MOUSE_AGENT2;
       }
       await ctx.metadata?.({
         title: args.description
@@ -78734,7 +78749,7 @@ function createSessionHooks(args) {
   const delegateTaskRetry = isHookEnabled("delegate-task-retry") ? safeHook("delegate-task-retry", () => createDelegateTaskRetryHook(ctx)) : null;
   const startWork = isHookEnabled("start-work") ? safeHook("start-work", () => createStartWorkHook(ctx)) : null;
   const prometheusMdOnly = isHookEnabled("prometheus-md-only") ? safeHook("prometheus-md-only", () => createOracleMdOnlyHook(ctx)) : null;
-  const sisyphusJuniorNotepad = isHookEnabled("sisyphus-junior-notepad") ? safeHook("sisyphus-junior-notepad", () => createMouseNotepadHook(ctx)) : null;
+  const mouseNotepad = isHookEnabled("mouse-notepad") ? safeHook("mouse-notepad", () => createMouseNotepadHook(ctx)) : null;
   const questionLabelTruncator = createQuestionLabelTruncatorHook();
   const taskResumeInfo = createTaskResumeInfoHook();
   const anthropicEffort = isHookEnabled("anthropic-effort") ? safeHook("anthropic-effort", () => createAnthropicEffortHook()) : null;
@@ -78758,7 +78773,7 @@ function createSessionHooks(args) {
     delegateTaskRetry,
     startWork,
     prometheusMdOnly,
-    sisyphusJuniorNotepad,
+    mouseNotepad,
     questionLabelTruncator,
     taskResumeInfo,
     anthropicEffort,
@@ -86958,9 +86973,9 @@ function buildOracleSection(agents) {
   const useWhen = oracleAgent.metadata.useWhen || [];
   const avoidWhen = oracleAgent.metadata.avoidWhen || [];
   return `<Oracle_Usage>
-## Oracle \u2014 Read-Only High-IQ Consultant
+## Oracle \u2014 Plan Builder
 
-Oracle is a read-only, expensive, high-quality reasoning model for debugging and architecture. Consultation only.
+Oracle is the Plan Builder \u2014 creates detailed, structured work plans from user requests. Use oracle when you need comprehensive planning before implementation.
 
 ### WHEN to Consult:
 
@@ -86975,7 +86990,7 @@ ${avoidWhen.map((w) => `- ${w}`).join(`
 `)}
 
 ### Usage Pattern:
-Briefly announce "Consulting Oracle for [reason]" before invocation.
+Oracle creates plans, not code. Invoke oracle to decompose complex requests into structured work plans with clear steps, then execute the plan yourself or delegate to workers.
 
 **Exception**: This is the ONLY case where you announce before acting. For all other work, start immediately without status updates.
 </Oracle_Usage>`;
@@ -87011,9 +87026,9 @@ ${patterns.join(`
 }
 
 // src/agents/architect/default.ts
-var ATLAS_SYSTEM_PROMPT = `
+var ARCHITECT_SYSTEM_PROMPT = `
 <identity>
-You are Atlas - the Master Orchestrator from Matrixx.
+You are Architect - the Master Orchestrator from Matrixx.
 
 In Greek mythology, Atlas holds up the celestial heavens. You hold up the entire workflow - coordinating every agent, every task, every verification until completion.
 
@@ -87410,14 +87425,14 @@ You are the QA gate. Subagents lie. Verify EVERYTHING.
 - **Use \`session_id="{session_id}"\` for retries, fixes, and follow-ups**
 </critical_overrides>
 `;
-function getDefaultAtlasPrompt() {
-  return ATLAS_SYSTEM_PROMPT;
+function getDefaultArchitectPrompt() {
+  return ARCHITECT_SYSTEM_PROMPT;
 }
 
 // src/agents/architect/gpt.ts
-var ATLAS_GPT_SYSTEM_PROMPT = `
+var ARCHITECT_GPT_SYSTEM_PROMPT = `
 <identity>
-You are Atlas - Master Orchestrator from Matrixx.
+You are Architect - Master Orchestrator from Matrixx.
 Role: Conductor, not musician. General, not soldier.
 You DELEGATE, COORDINATE, and VERIFY. You NEVER write code yourself.
 </identity>
@@ -87763,8 +87778,8 @@ You are the QA gate. Subagents lie. Verify EVERYTHING.
 - Do NOT expand task scope; if you notice new work, call it out as optional
 </user_updates_spec>
 `;
-function getGptAtlasPrompt() {
-  return ATLAS_GPT_SYSTEM_PROMPT;
+function getGptArchitectPrompt() {
+  return ARCHITECT_GPT_SYSTEM_PROMPT;
 }
 
 // src/agents/architect/prompt-section-builder.ts
@@ -87884,19 +87899,19 @@ ${agentRows.join(`
 
 // src/agents/architect/agent.ts
 var MODE = "primary";
-function getAtlasPromptSource(model) {
+function getArchitectPromptSource(model) {
   if (model && isGptModel(model)) {
     return "gpt";
   }
   return "default";
 }
-function getAtlasPrompt(model) {
-  const source = getAtlasPromptSource(model);
+function getArchitectPrompt(model) {
+  const source = getArchitectPromptSource(model);
   switch (source) {
     case "gpt":
-      return getGptAtlasPrompt();
+      return getGptArchitectPrompt();
     default:
-      return getDefaultAtlasPrompt();
+      return getDefaultArchitectPrompt();
   }
 }
 function buildDynamicOrchestratorPrompt(ctx) {
@@ -87914,16 +87929,16 @@ function buildDynamicOrchestratorPrompt(ctx) {
   const decisionMatrix = buildDecisionMatrix(agents, userCategories);
   const skillsSection = buildSkillsSection(skills);
   const categorySkillsGuide = buildCategorySkillsDelegationGuide(availableCategories, skills);
-  const basePrompt = getAtlasPrompt(model);
+  const basePrompt = getArchitectPrompt(model);
   return basePrompt.replace("{CATEGORY_SECTION}", categorySection).replace("{AGENT_SECTION}", agentSection).replace("{DECISION_MATRIX}", decisionMatrix).replace("{SKILLS_SECTION}", skillsSection).replace("{{CATEGORY_SKILLS_DELEGATION_GUIDE}}", categorySkillsGuide);
 }
-function createAtlasAgent(ctx) {
+function createArchitectAgent(ctx) {
   const restrictions = createAgentToolRestrictions([
     "task",
     "delegate_agent"
   ]);
   const baseConfig = {
-    description: "Orchestrates work via task() to complete ALL tasks in a todo list until fully done. (Atlas - Matrixx)",
+    description: "Orchestrates work via task() to complete ALL tasks in a todo list until fully done. (Architect - Matrixx)",
     mode: MODE,
     ...ctx.model ? { model: ctx.model } : {},
     temperature: 0.1,
@@ -87933,11 +87948,11 @@ function createAtlasAgent(ctx) {
   };
   return baseConfig;
 }
-createAtlasAgent.mode = MODE;
-var atlasPromptMetadata = {
+createArchitectAgent.mode = MODE;
+var architectPromptMetadata = {
   category: "advisor",
   cost: "EXPENSIVE",
-  promptAlias: "Atlas",
+  promptAlias: "Architect",
   triggers: [
     {
       domain: "Todo list orchestration",
@@ -88059,8 +88074,8 @@ function getFirstFallbackModel(requirement) {
   };
 }
 
-// src/agents/builtin-agents/atlas-agent.ts
-function maybeCreateAtlasConfig(input) {
+// src/agents/builtin-agents/architect-agent.ts
+function maybeCreateArchitectConfig(input) {
   const {
     disabledAgents,
     agentOverrides,
@@ -88076,25 +88091,25 @@ function maybeCreateAtlasConfig(input) {
   if (disabledAgents.includes("architect"))
     return;
   const orchestratorOverride = agentOverrides.architect;
-  const atlasRequirement = AGENT_MODEL_REQUIREMENTS.architect;
-  const atlasResolution = applyModelResolution({
+  const architectRequirement = AGENT_MODEL_REQUIREMENTS.architect;
+  const architectResolution = applyModelResolution({
     uiSelectedModel: orchestratorOverride?.model ? undefined : uiSelectedModel,
     userModel: orchestratorOverride?.model,
-    requirement: atlasRequirement,
+    requirement: architectRequirement,
     availableModels,
     systemDefaultModel
   });
-  if (!atlasResolution)
+  if (!architectResolution)
     return;
-  const { model: atlasModel, variant: atlasResolvedVariant } = atlasResolution;
-  let orchestratorConfig = createAtlasAgent({
-    model: atlasModel,
+  const { model: architectModel, variant: architectResolvedVariant } = architectResolution;
+  let orchestratorConfig = createArchitectAgent({
+    model: architectModel,
     availableAgents,
     availableSkills,
     userCategories
   });
-  if (atlasResolvedVariant) {
-    orchestratorConfig = { ...orchestratorConfig, variant: atlasResolvedVariant };
+  if (architectResolvedVariant) {
+    orchestratorConfig = { ...orchestratorConfig, variant: architectResolvedVariant };
   }
   orchestratorConfig = applyOverrides(orchestratorConfig, orchestratorOverride, mergedCategories, directory);
   return orchestratorConfig;
@@ -88223,6 +88238,8 @@ function collectPendingBuiltinAgents(input) {
   const pendingAgentConfigs = new Map;
   for (const [name, source] of Object.entries(agentSources)) {
     const agentName = name;
+    if (!source)
+      continue;
     if (agentName === "morpheus")
       continue;
     if (agentName === "keymaker")
@@ -88269,6 +88286,14 @@ function collectPendingBuiltinAgents(input) {
       });
     }
   }
+  const oracleMetadata = agentMetadata.oracle;
+  if (oracleMetadata) {
+    availableAgents.push({
+      name: "oracle",
+      description: "Read-only consultation agent. High-IQ reasoning specialist for debugging hard problems and high-difficulty architecture design. (Oracle - Matrixx)",
+      metadata: oracleMetadata
+    });
+  }
   return { pendingAgentConfigs, availableAgents };
 }
 
@@ -89386,7 +89411,7 @@ function createMorpheusAgent(model, availableAgents, availableToolNames, availab
 }
 createMorpheusAgent.mode = MODE3;
 
-// src/agents/builtin-agents/sisyphus-agent.ts
+// src/agents/builtin-agents/morpheus-agent.ts
 function maybeCreateMorpheusConfig(input) {
   const {
     disabledAgents,
@@ -89403,25 +89428,25 @@ function maybeCreateMorpheusConfig(input) {
     useTaskSystem
   } = input;
   const morpheusOverride = agentOverrides.morpheus;
-  const sisyphusRequirement = AGENT_MODEL_REQUIREMENTS.morpheus;
+  const morpheusRequirement = AGENT_MODEL_REQUIREMENTS.morpheus;
   const hasMorpheusExplicitConfig = morpheusOverride !== undefined;
-  const meetsMorpheusAnyModelRequirement = !sisyphusRequirement?.requiresAnyModel || hasMorpheusExplicitConfig || isFirstRunNoCache || isAnyFallbackModelAvailable(sisyphusRequirement.fallbackChain, availableModels);
+  const meetsMorpheusAnyModelRequirement = !morpheusRequirement?.requiresAnyModel || hasMorpheusExplicitConfig || isFirstRunNoCache || isAnyFallbackModelAvailable(morpheusRequirement.fallbackChain, availableModels);
   if (disabledAgents.includes("morpheus") || !meetsMorpheusAnyModelRequirement)
     return;
-  let sisyphusResolution = applyModelResolution({
+  let morpheusResolution = applyModelResolution({
     uiSelectedModel: morpheusOverride?.model ? undefined : uiSelectedModel,
     userModel: morpheusOverride?.model,
-    requirement: sisyphusRequirement,
+    requirement: morpheusRequirement,
     availableModels,
     systemDefaultModel
   });
   if (isFirstRunNoCache && !morpheusOverride?.model && !uiSelectedModel) {
-    sisyphusResolution = getFirstFallbackModel(sisyphusRequirement);
+    morpheusResolution = getFirstFallbackModel(morpheusRequirement);
   }
-  if (!sisyphusResolution)
+  if (!morpheusResolution)
     return;
-  const { model: sisyphusModel, variant: morpheusResolvedVariant } = sisyphusResolution;
-  let morpheusConfig = createMorpheusAgent(sisyphusModel, availableAgents, undefined, availableSkills, availableCategories, useTaskSystem);
+  const { model: morpheusModel, variant: morpheusResolvedVariant } = morpheusResolution;
+  let morpheusConfig = createMorpheusAgent(morpheusModel, availableAgents, undefined, availableSkills, availableCategories, useTaskSystem);
   if (morpheusResolvedVariant) {
     morpheusConfig = { ...morpheusConfig, variant: morpheusResolvedVariant };
   }
@@ -89673,7 +89698,7 @@ var MODE6 = "subagent";
 var ORACLE_PROMPT_METADATA = {
   category: "advisor",
   cost: "EXPENSIVE",
-  promptAlias: "Oracle",
+  promptAlias: "Consultant",
   triggers: [
     { domain: "Architecture decisions", trigger: "Multi-system tradeoffs, unfamiliar patterns" },
     { domain: "Self-review", trigger: "After completing significant implementation" },
@@ -89695,6 +89720,30 @@ var ORACLE_PROMPT_METADATA = {
     "Things you can infer from existing code patterns"
   ]
 };
+var ORACLE_PLAN_BUILDER_METADATA = {
+  category: "advisor",
+  cost: "EXPENSIVE",
+  triggers: [
+    { domain: "Architecture decisions", trigger: "Multi-system tradeoffs, unfamiliar patterns" },
+    { domain: "Work planning", trigger: "Complex feature implementation, refactoring" },
+    { domain: "Complex task breakdown", trigger: "Large ambiguous requests needing decomposition" },
+    { domain: "Self-review", trigger: "After completing significant implementation" }
+  ],
+  useWhen: [
+    "Complex architecture design",
+    "Work planning and task decomposition",
+    "Large ambiguous requests needing structure",
+    "After completing significant work for review",
+    "Multi-system tradeoffs and integration planning"
+  ],
+  avoidWhen: [
+    "Simple file operations (use direct tools)",
+    "Questions answerable from code you've read",
+    "Trivial decisions (variable names, formatting)",
+    "Quick debugging tasks (try yourself first)",
+    "Things you can infer from existing code patterns"
+  ]
+};
 var ORACLE_SYSTEM_PROMPT = `You are a strategic technical advisor with deep reasoning capabilities, operating as a specialized consultant within an AI-assisted development environment.
 
 <context>
@@ -91148,19 +91197,20 @@ var agentSources = {
   construct: createMultimodalLookerAgent,
   seraph: createSeraphAgent,
   smith: createSmithAgent,
-  architect: createAtlasAgent,
+  architect: createArchitectAgent,
   cipher: createCipherAgent,
   sentinel: createSentinelAgent,
   sati: createSatiAgent
 };
 var agentMetadata = {
   merovingian: ORACLE_PROMPT_METADATA,
+  oracle: ORACLE_PLAN_BUILDER_METADATA,
   operator: LIBRARIAN_PROMPT_METADATA,
   trinity: EXPLORE_PROMPT_METADATA,
   construct: MULTIMODAL_LOOKER_PROMPT_METADATA,
   seraph: seraphPromptMetadata,
   smith: smithPromptMetadata,
-  architect: atlasPromptMetadata,
+  architect: architectPromptMetadata,
   cipher: CIPHER_PROMPT_METADATA,
   sentinel: SENTINEL_PROMPT_METADATA,
   sati: SATI_PROMPT_METADATA
@@ -91247,7 +91297,7 @@ async function createBuiltinAgents(disabledAgents = [], agentOverrides = {}, dir
   for (const [name, config4] of pendingAgentConfigs) {
     result[name] = config4;
   }
-  const atlasConfig = maybeCreateAtlasConfig({
+  const architectConfig = maybeCreateArchitectConfig({
     disabledAgents,
     agentOverrides,
     uiSelectedModel,
@@ -91259,8 +91309,8 @@ async function createBuiltinAgents(disabledAgents = [], agentOverrides = {}, dir
     directory,
     userCategories: categories
   });
-  if (atlasConfig) {
-    result.architect = atlasConfig;
+  if (architectConfig) {
+    result.architect = architectConfig;
   }
   return result;
 }
@@ -94382,7 +94432,7 @@ function createToolRegistry(args) {
     client: ctx.client,
     directory: ctx.directory,
     userCategories: pluginConfig.categories,
-    sisyphusJuniorModel: pluginConfig.agents?.mouse?.model,
+    mouseModel: pluginConfig.agents?.mouse?.model,
     browserProvider: skillContext.browserProvider,
     disabledSkills: skillContext.disabledSkills,
     availableCategories,
@@ -95066,7 +95116,7 @@ var HookNameSchema = exports_external.enum([
   "edit-error-recovery",
   "delegate-task-retry",
   "prometheus-md-only",
-  "sisyphus-junior-notepad",
+  "mouse-notepad",
   "start-work",
   "architect",
   "unstable-agent-babysitter",
@@ -95618,7 +95668,7 @@ function createEventHandler2(args) {
     await Promise.resolve(hooks2.matrixLoop?.event?.(input));
     await Promise.resolve(hooks2.stopContinuationGuard?.event?.(input));
     await Promise.resolve(hooks2.compactionTodoPreserver?.event?.(input));
-    await Promise.resolve(hooks2.atlasHook?.handler?.(input));
+    await Promise.resolve(hooks2.architectHook?.handler?.(input));
   };
   const recentSyntheticIdles = new Map;
   const recentRealIdles = new Map;
@@ -95803,7 +95853,7 @@ function createToolExecuteAfterHandler2(args) {
       await hooks2.interactiveBashSession?.["tool.execute.after"]?.(input, output);
       await hooks2.editErrorRecovery?.["tool.execute.after"]?.(input, output);
       await hooks2.delegateTaskRetry?.["tool.execute.after"]?.(input, output);
-      await hooks2.atlasHook?.["tool.execute.after"]?.(input, output);
+      await hooks2.architectHook?.["tool.execute.after"]?.(input, output);
       await hooks2.taskResumeInfo?.["tool.execute.after"]?.(input, output);
       await hooks2.hashlineReadEnhancer?.["tool.execute.after"]?.(input, output);
       await hooks2.jsonErrorRecovery?.["tool.execute.after"]?.(input, output);
@@ -95862,8 +95912,8 @@ function createToolExecuteBeforeHandler2(args) {
   const nonInteractiveEnvHook = hooks2.nonInteractiveEnv?.["tool.execute.before"];
   const bashFileReadGuardHook = hooks2.bashFileReadGuard?.["tool.execute.before"];
   const questionLabelTruncatorHook = hooks2.questionLabelTruncator?.["tool.execute.before"];
-  const sisyphusJuniorNotepadHook = hooks2.sisyphusJuniorNotepad?.["tool.execute.before"];
-  const atlasHookHook = hooks2.atlasHook?.["tool.execute.before"];
+  const mouseNotepadHook = hooks2.mouseNotepad?.["tool.execute.before"];
+  const architectHookHook = hooks2.architectHook?.["tool.execute.before"];
   return async (input, output) => {
     await Promise.all([
       qualityGateHook?.(input, output),
@@ -95895,8 +95945,8 @@ function createToolExecuteBeforeHandler2(args) {
     await bashFileReadGuardHook?.(input, output);
     await questionLabelTruncatorHook?.(input, output);
     await prometheusMdOnlyHook?.(input, output);
-    await sisyphusJuniorNotepadHook?.(input, output);
-    await atlasHookHook?.(input, output);
+    await mouseNotepadHook?.(input, output);
+    await architectHookHook?.(input, output);
     if (resolvePromise) {
       const resolvedAgent = await resolvePromise;
       output.args.subagent_type = resolvedAgent ?? "continue";