oh-my-opencode 2.12.4 → 2.13.1

package/dist/cli/index.js

@@ -2657,7 +2657,7 @@ var require_napi = __commonJS((exports, module) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "oh-my-opencode",
-    version: "2.12.3",
+    version: "2.13.0",
     description: "OpenCode plugin - custom agents (oracle, librarian) and enhanced features",
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -6972,13 +6972,9 @@ function getConfigJson() {
 function getConfigJsonc() {
   return getConfigContext().paths.configJsonc;
 }
-function getPackageJson() {
-  return getConfigContext().paths.packageJson;
-}
 function getOmoConfig() {
   return getConfigContext().paths.omoConfig;
 }
-var CHATGPT_HOTFIX_REPO = "code-yeongyu/opencode-openai-codex-auth#fix/orphaned-function-call-output-with-tools";
 var BUN_INSTALL_TIMEOUT_SECONDS = 60;
 var BUN_INSTALL_TIMEOUT_MS = BUN_INSTALL_TIMEOUT_SECONDS * 1000;
 function isPermissionError(err) {
@@ -7134,28 +7130,27 @@ function generateOmoConfig(installConfig) {
   }
   const agents = {};
   if (!installConfig.hasClaude) {
-    agents["Sisyphus"] = { model: "opencode/big-pickle" };
+    agents["Sisyphus"] = { model: "opencode/glm-4.7-free" };
   }
+  agents["librarian"] = { model: "opencode/glm-4.7-free" };
   if (installConfig.hasGemini) {
-    agents["librarian"] = { model: "google/gemini-3-flash" };
-    agents["explore"] = { model: "google/gemini-3-flash" };
+    agents["explore"] = { model: "google/antigravity-gemini-3-flash" };
   } else if (installConfig.hasClaude && installConfig.isMax20) {
     agents["explore"] = { model: "anthropic/claude-haiku-4-5" };
   } else {
-    agents["librarian"] = { model: "opencode/big-pickle" };
-    agents["explore"] = { model: "opencode/big-pickle" };
+    agents["explore"] = { model: "opencode/glm-4.7-free" };
   }
   if (!installConfig.hasChatGPT) {
     agents["oracle"] = {
-      model: installConfig.hasClaude ? "anthropic/claude-opus-4-5" : "opencode/big-pickle"
+      model: installConfig.hasClaude ? "anthropic/claude-opus-4-5" : "opencode/glm-4.7-free"
     };
   }
   if (installConfig.hasGemini) {
-    agents["frontend-ui-ux-engineer"] = { model: "google/gemini-3-pro-high" };
-    agents["document-writer"] = { model: "google/gemini-3-flash" };
-    agents["multimodal-looker"] = { model: "google/gemini-3-flash" };
+    agents["frontend-ui-ux-engineer"] = { model: "google/antigravity-gemini-3-pro-high" };
+    agents["document-writer"] = { model: "google/antigravity-gemini-3-flash" };
+    agents["multimodal-looker"] = { model: "google/antigravity-gemini-3-flash" };
   } else {
-    const fallbackModel = installConfig.hasClaude ? "anthropic/claude-opus-4-5" : "opencode/big-pickle";
+    const fallbackModel = installConfig.hasClaude ? "anthropic/claude-opus-4-5" : "opencode/glm-4.7-free";
     agents["frontend-ui-ux-engineer"] = { model: fallbackModel };
     agents["document-writer"] = { model: fallbackModel };
     agents["multimodal-looker"] = { model: fallbackModel };
@@ -7276,119 +7271,29 @@ async function addAuthPlugins(config) {
     return { success: false, configPath: path2, error: formatErrorWithSuggestion(err, "add auth plugins to config") };
   }
 }
-function setupChatGPTHotfix() {
-  try {
-    ensureConfigDir();
-  } catch (err) {
-    return { success: false, configPath: getConfigDir(), error: formatErrorWithSuggestion(err, "create config directory") };
-  }
-  const packageJsonPath = getPackageJson();
-  try {
-    let packageJson = {};
-    if (existsSync3(packageJsonPath)) {
-      try {
-        const stat = statSync(packageJsonPath);
-        const content = readFileSync2(packageJsonPath, "utf-8");
-        if (stat.size > 0 && !isEmptyOrWhitespace(content)) {
-          packageJson = JSON.parse(content);
-          if (typeof packageJson !== "object" || packageJson === null || Array.isArray(packageJson)) {
-            packageJson = {};
-          }
-        }
-      } catch (parseErr) {
-        if (parseErr instanceof SyntaxError) {
-          packageJson = {};
-        } else {
-          throw parseErr;
-        }
-      }
-    }
-    const deps = packageJson.dependencies ?? {};
-    deps["opencode-openai-codex-auth"] = CHATGPT_HOTFIX_REPO;
-    packageJson.dependencies = deps;
-    writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + `
-`);
-    return { success: true, configPath: packageJsonPath };
-  } catch (err) {
-    return { success: false, configPath: packageJsonPath, error: formatErrorWithSuggestion(err, "setup ChatGPT hotfix in package.json") };
-  }
-}
-async function runBunInstall() {
-  const result = await runBunInstallWithDetails();
-  return result.success;
-}
-async function runBunInstallWithDetails() {
-  try {
-    const proc = Bun.spawn(["bun", "install"], {
-      cwd: getConfigDir(),
-      stdout: "pipe",
-      stderr: "pipe"
-    });
-    const timeoutPromise = new Promise((resolve) => setTimeout(() => resolve("timeout"), BUN_INSTALL_TIMEOUT_MS));
-    const exitPromise = proc.exited.then(() => "completed");
-    const result = await Promise.race([exitPromise, timeoutPromise]);
-    if (result === "timeout") {
-      try {
-        proc.kill();
-      } catch {}
-      return {
-        success: false,
-        timedOut: true,
-        error: `bun install timed out after ${BUN_INSTALL_TIMEOUT_SECONDS} seconds. Try running manually: cd ~/.config/opencode && bun i`
-      };
-    }
-    if (proc.exitCode !== 0) {
-      const stderr = await new Response(proc.stderr).text();
-      return {
-        success: false,
-        error: stderr.trim() || `bun install failed with exit code ${proc.exitCode}`
-      };
-    }
-    return { success: true };
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return {
-      success: false,
-      error: `bun install failed: ${message}. Is bun installed? Try: curl -fsSL https://bun.sh/install | bash`
-    };
-  }
-}
 var ANTIGRAVITY_PROVIDER_CONFIG = {
   google: {
     name: "Google",
     models: {
-      "gemini-3-pro-high": {
+      "antigravity-gemini-3-pro-high": {
         name: "Gemini 3 Pro High (Antigravity)",
         thinking: true,
         attachment: true,
         limit: { context: 1048576, output: 65535 },
         modalities: { input: ["text", "image", "pdf"], output: ["text"] }
       },
-      "gemini-3-pro-medium": {
-        name: "Gemini 3 Pro Medium (Antigravity)",
-        thinking: true,
-        attachment: true,
-        limit: { context: 1048576, output: 65535 },
-        modalities: { input: ["text", "image", "pdf"], output: ["text"] }
-      },
-      "gemini-3-pro-low": {
+      "antigravity-gemini-3-pro-low": {
         name: "Gemini 3 Pro Low (Antigravity)",
         thinking: true,
         attachment: true,
         limit: { context: 1048576, output: 65535 },
         modalities: { input: ["text", "image", "pdf"], output: ["text"] }
       },
-      "gemini-3-flash": {
+      "antigravity-gemini-3-flash": {
         name: "Gemini 3 Flash (Antigravity)",
         attachment: true,
         limit: { context: 1048576, output: 65536 },
         modalities: { input: ["text", "image", "pdf"], output: ["text"] }
-      },
-      "gemini-3-flash-lite": {
-        name: "Gemini 3 Flash Lite (Antigravity)",
-        attachment: true,
-        limit: { context: 1048576, output: 65536 },
-        modalities: { input: ["text", "image", "pdf"], output: ["text"] }
       }
     }
   }
@@ -7396,12 +7301,48 @@ var ANTIGRAVITY_PROVIDER_CONFIG = {
 var CODEX_PROVIDER_CONFIG = {
   openai: {
     name: "OpenAI",
-    api: "codex",
+    options: {
+      reasoningEffort: "medium",
+      reasoningSummary: "auto",
+      textVerbosity: "medium",
+      include: ["reasoning.encrypted_content"],
+      store: false
+    },
     models: {
-      "gpt-5.2": { name: "GPT-5.2" },
-      o3: { name: "o3", thinking: true },
-      "o4-mini": { name: "o4-mini", thinking: true },
-      "codex-1": { name: "Codex-1" }
+      "gpt-5.2": {
+        name: "GPT 5.2 (OAuth)",
+        limit: { context: 272000, output: 128000 },
+        modalities: { input: ["text", "image"], output: ["text"] },
+        variants: {
+          none: { reasoningEffort: "none", reasoningSummary: "auto", textVerbosity: "medium" },
+          low: { reasoningEffort: "low", reasoningSummary: "auto", textVerbosity: "medium" },
+          medium: { reasoningEffort: "medium", reasoningSummary: "auto", textVerbosity: "medium" },
+          high: { reasoningEffort: "high", reasoningSummary: "detailed", textVerbosity: "medium" },
+          xhigh: { reasoningEffort: "xhigh", reasoningSummary: "detailed", textVerbosity: "medium" }
+        }
+      },
+      "gpt-5.2-codex": {
+        name: "GPT 5.2 Codex (OAuth)",
+        limit: { context: 272000, output: 128000 },
+        modalities: { input: ["text", "image"], output: ["text"] },
+        variants: {
+          low: { reasoningEffort: "low", reasoningSummary: "auto", textVerbosity: "medium" },
+          medium: { reasoningEffort: "medium", reasoningSummary: "auto", textVerbosity: "medium" },
+          high: { reasoningEffort: "high", reasoningSummary: "detailed", textVerbosity: "medium" },
+          xhigh: { reasoningEffort: "xhigh", reasoningSummary: "detailed", textVerbosity: "medium" }
+        }
+      },
+      "gpt-5.1-codex-max": {
+        name: "GPT 5.1 Codex Max (OAuth)",
+        limit: { context: 272000, output: 128000 },
+        modalities: { input: ["text", "image"], output: ["text"] },
+        variants: {
+          low: { reasoningEffort: "low", reasoningSummary: "detailed", textVerbosity: "medium" },
+          medium: { reasoningEffort: "medium", reasoningSummary: "detailed", textVerbosity: "medium" },
+          high: { reasoningEffort: "high", reasoningSummary: "detailed", textVerbosity: "medium" },
+          xhigh: { reasoningEffort: "xhigh", reasoningSummary: "detailed", textVerbosity: "medium" }
+        }
+      }
     }
   }
 };
@@ -7482,16 +7423,16 @@ function detectCurrentConfig() {
       return result;
     }
     const agents = omoConfig.agents ?? {};
-    if (agents["Sisyphus"]?.model === "opencode/big-pickle") {
+    if (agents["Sisyphus"]?.model === "opencode/glm-4.7-free") {
       result.hasClaude = false;
       result.isMax20 = false;
-    } else if (agents["librarian"]?.model === "opencode/big-pickle") {
+    } else if (agents["librarian"]?.model === "opencode/glm-4.7-free") {
       result.hasClaude = true;
       result.isMax20 = false;
     }
     if (agents["oracle"]?.model?.startsWith("anthropic/")) {
       result.hasChatGPT = false;
-    } else if (agents["oracle"]?.model === "opencode/big-pickle") {
+    } else if (agents["oracle"]?.model === "opencode/glm-4.7-free") {
       result.hasChatGPT = false;
     }
     if (omoConfig.google_auth === false) {
@@ -7530,10 +7471,10 @@ function formatConfigSummary(config) {
   lines.push("");
   lines.push(import_picocolors2.default.bold(import_picocolors2.default.white("Agent Configuration")));
   lines.push("");
-  const sisyphusModel = config.hasClaude ? "claude-opus-4-5" : "big-pickle";
-  const oracleModel = config.hasChatGPT ? "gpt-5.2" : config.hasClaude ? "claude-opus-4-5" : "big-pickle";
-  const librarianModel = config.hasClaude && config.isMax20 ? "claude-sonnet-4-5" : "big-pickle";
-  const frontendModel = config.hasGemini ? "gemini-3-pro-high" : config.hasClaude ? "claude-opus-4-5" : "big-pickle";
+  const sisyphusModel = config.hasClaude ? "claude-opus-4-5" : "glm-4.7-free";
+  const oracleModel = config.hasChatGPT ? "gpt-5.2" : config.hasClaude ? "claude-opus-4-5" : "glm-4.7-free";
+  const librarianModel = "glm-4.7-free";
+  const frontendModel = config.hasGemini ? "antigravity-gemini-3-pro-high" : config.hasClaude ? "claude-opus-4-5" : "glm-4.7-free";
   lines.push(`  ${SYMBOLS.bullet} Sisyphus     ${SYMBOLS.arrow} ${import_picocolors2.default.cyan(sisyphusModel)}`);
   lines.push(`  ${SYMBOLS.bullet} Oracle       ${SYMBOLS.arrow} ${import_picocolors2.default.cyan(oracleModel)}`);
   lines.push(`  ${SYMBOLS.bullet} Librarian    ${SYMBOLS.arrow} ${import_picocolors2.default.cyan(librarianModel)}`);
@@ -7625,7 +7566,7 @@ async function runTuiMode(detected) {
   const claude = await ve({
     message: "Do you have a Claude Pro/Max subscription?",
     options: [
-      { value: "no", label: "No", hint: "Will use opencode/big-pickle as fallback" },
+      { value: "no", label: "No", hint: "Will use opencode/glm-4.7-free as fallback" },
       { value: "yes", label: "Yes (standard)", hint: "Claude Opus 4.5 for orchestration" },
       { value: "max20", label: "Yes (max20 mode)", hint: "Full power with Claude Sonnet 4.5 for Librarian" }
     ],
@@ -7723,24 +7664,6 @@ async function runNonTuiInstall(args) {
   } else {
     step += 2;
   }
-  if (config.hasChatGPT) {
-    printStep(step++, totalSteps, "Setting up ChatGPT hotfix...");
-    const hotfixResult = setupChatGPTHotfix();
-    if (!hotfixResult.success) {
-      printError(`Failed: ${hotfixResult.error}`);
-      return 1;
-    }
-    printSuccess(`Hotfix configured ${SYMBOLS.arrow} ${import_picocolors2.default.dim(hotfixResult.configPath)}`);
-    printInfo("Installing dependencies with bun...");
-    const bunSuccess = await runBunInstall();
-    if (bunSuccess) {
-      printSuccess("Dependencies installed");
-    } else {
-      printWarning("bun install failed - run manually: cd ~/.config/opencode && bun i");
-    }
-  } else {
-    step++;
-  }
   printStep(step++, totalSteps, "Writing oh-my-opencode configuration...");
   const omoResult = writeOmoConfig(config);
   if (!omoResult.success) {
@@ -7750,7 +7673,7 @@ async function runNonTuiInstall(args) {
   printSuccess(`Config written ${SYMBOLS.arrow} ${import_picocolors2.default.dim(omoResult.configPath)}`);
   printBox(formatConfigSummary(config), isUpdate ? "Updated Configuration" : "Installation Complete");
   if (!config.hasClaude && !config.hasChatGPT && !config.hasGemini) {
-    printWarning("No model providers configured. Using opencode/big-pickle as fallback.");
+    printWarning("No model providers configured. Using opencode/glm-4.7-free as fallback.");
   }
   if ((config.hasClaude || config.hasChatGPT || config.hasGemini) && !args.skipAuth) {
     console.log(import_picocolors2.default.bold("Next Steps - Authenticate your providers:"));
@@ -7831,23 +7754,6 @@ async function install(args) {
     }
     s.stop(`Provider config added to ${import_picocolors2.default.cyan(providerResult.configPath)}`);
   }
-  if (config.hasChatGPT) {
-    s.start("Setting up ChatGPT hotfix");
-    const hotfixResult = setupChatGPTHotfix();
-    if (!hotfixResult.success) {
-      s.stop(`Failed to setup hotfix: ${hotfixResult.error}`);
-      Se(import_picocolors2.default.red("Installation failed."));
-      return 1;
-    }
-    s.stop(`Hotfix configured in ${import_picocolors2.default.cyan(hotfixResult.configPath)}`);
-    s.start("Installing dependencies with bun");
-    const bunSuccess = await runBunInstall();
-    if (bunSuccess) {
-      s.stop("Dependencies installed");
-    } else {
-      s.stop(import_picocolors2.default.yellow("bun install failed - run manually: cd ~/.config/opencode && bun i"));
-    }
-  }
   s.start("Writing oh-my-opencode configuration");
   const omoResult = writeOmoConfig(config);
   if (!omoResult.success) {
@@ -7857,7 +7763,7 @@ async function install(args) {
   }
   s.stop(`Config written to ${import_picocolors2.default.cyan(omoResult.configPath)}`);
   if (!config.hasClaude && !config.hasChatGPT && !config.hasGemini) {
-    M2.warn("No model providers configured. Using opencode/big-pickle as fallback.");
+    M2.warn("No model providers configured. Using opencode/glm-4.7-free as fallback.");
   }
   Me(formatConfigSummary(config), isUpdate ? "Updated Configuration" : "Installation Complete");
   if ((config.hasClaude || config.hasChatGPT || config.hasGemini) && !args.skipAuth) {
@@ -22612,7 +22518,8 @@ function date4(params) {
 // node_modules/zod/v4/classic/external.js
 config(en_default());
 // src/mcp/types.ts
-var McpNameSchema = exports_external.enum(["websearch_exa", "context7", "grep_app"]);
+var McpNameSchema = exports_external.enum(["context7", "grep_app"]);
+var AnyMcpNameSchema = exports_external.string().min(1);
 
 // src/config/schema.ts
 var PermissionValue = exports_external.enum(["ask", "allow", "deny"]);
@@ -22810,7 +22717,7 @@ var RalphLoopConfigSchema = exports_external.object({
 });
 var OhMyOpenCodeConfigSchema = exports_external.object({
   $schema: exports_external.string().optional(),
-  disabled_mcps: exports_external.array(McpNameSchema).optional(),
+  disabled_mcps: exports_external.array(AnyMcpNameSchema).optional(),
   disabled_agents: exports_external.array(BuiltinAgentNameSchema).optional(),
   disabled_skills: exports_external.array(BuiltinSkillNameSchema).optional(),
   disabled_hooks: exports_external.array(HookNameSchema).optional(),
@@ -23373,7 +23280,7 @@ function getLspCheckDefinition() {
 import { existsSync as existsSync9, readFileSync as readFileSync7 } from "fs";
 import { homedir as homedir6 } from "os";
 import { join as join7 } from "path";
-var BUILTIN_MCP_SERVERS = ["context7", "websearch_exa", "grep_app"];
+var BUILTIN_MCP_SERVERS = ["context7", "grep_app"];
 var MCP_CONFIG_PATHS = [
   join7(homedir6(), ".claude", ".mcp.json"),
   join7(process.cwd(), ".mcp.json"),

package/dist/config/schema.d.ts

@@ -772,11 +772,7 @@ export declare const RalphLoopConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
-    disabled_mcps: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        websearch_exa: "websearch_exa";
-        context7: "context7";
-        grep_app: "grep_app";
-    }>>>;
+    disabled_mcps: z.ZodOptional<z.ZodArray<z.ZodString>>;
     disabled_agents: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         Sisyphus: "Sisyphus";
         oracle: "oracle";
@@ -1437,4 +1433,4 @@ export type DynamicContextPruningConfig = z.infer<typeof DynamicContextPruningCo
 export type SkillsConfig = z.infer<typeof SkillsConfigSchema>;
 export type SkillDefinition = z.infer<typeof SkillDefinitionSchema>;
 export type RalphLoopConfig = z.infer<typeof RalphLoopConfigSchema>;
-export { McpNameSchema, type McpName } from "../mcp/types";
+export { AnyMcpNameSchema, type AnyMcpName, McpNameSchema, type McpName } from "../mcp/types";

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

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

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

@@ -0,0 +1 @@
+export declare const REFACTOR_TEMPLATE = "# Intelligent Refactor Command\n\n## Usage\n```\n/refactor <refactoring-target> [--scope=<file|module|project>] [--strategy=<safe|aggressive>]\n\nArguments:\n  refactoring-target: What to refactor. Can be:\n    - File path: src/auth/handler.ts\n    - Symbol name: \"AuthService class\"\n    - Pattern: \"all functions using deprecated API\"\n    - Description: \"extract validation logic into separate module\"\n\nOptions:\n  --scope: Refactoring scope (default: module)\n    - file: Single file only\n    - module: Module/directory scope\n    - project: Entire codebase\n\n  --strategy: Risk tolerance (default: safe)\n    - safe: Conservative, maximum test coverage required\n    - aggressive: Allow broader changes with adequate coverage\n```\n\n## What This Command Does\n\nPerforms intelligent, deterministic refactoring with full codebase awareness. Unlike blind search-and-replace, this command:\n\n1. **Understands your intent** - Analyzes what you actually want to achieve\n2. **Maps the codebase** - Builds a definitive codemap before touching anything\n3. **Assesses risk** - Evaluates test coverage and determines verification strategy\n4. **Plans meticulously** - Creates a detailed plan with Plan agent\n5. **Executes precisely** - Step-by-step refactoring with LSP and AST-grep\n6. **Verifies constantly** - Runs tests after each change to ensure zero regression\n\n---\n\n# PHASE 0: INTENT GATE (MANDATORY FIRST STEP)\n\n**BEFORE ANY ACTION, classify and validate the request.**\n\n## Step 0.1: Parse Request Type\n\n| Signal | Classification | Action |\n|--------|----------------|--------|\n| Specific file/symbol | Explicit | Proceed to codebase analysis |\n| \"Refactor X to Y\" | Clear transformation | Proceed to codebase analysis |\n| \"Improve\", \"Clean up\" | Open-ended | **MUST ask**: \"What specific improvement?\" |\n| Ambiguous scope | Uncertain | **MUST ask**: \"Which modules/files?\" |\n| Missing context | Incomplete | **MUST ask**: \"What's the desired outcome?\" |\n\n## Step 0.2: Validate Understanding\n\nBefore proceeding, confirm:\n- [ ] Target is clearly identified\n- [ ] Desired outcome is understood\n- [ ] Scope is defined (file/module/project)\n- [ ] Success criteria can be articulated\n\n**If ANY of above is unclear, ASK CLARIFYING QUESTION:**\n\n```\nI want to make sure I understand the refactoring goal correctly.\n\n**What I understood**: [interpretation]\n**What I'm unsure about**: [specific ambiguity]\n\nOptions I see:\n1. [Option A] - [implications]\n2. [Option B] - [implications]\n\n**My recommendation**: [suggestion with reasoning]\n\nShould I proceed with [recommendation], or would you prefer differently?\n```\n\n## Step 0.3: Create Initial Todos\n\n**IMMEDIATELY after understanding the request, create todos:**\n\n```\nTodoWrite([\n  {\"id\": \"phase-1\", \"content\": \"PHASE 1: Codebase Analysis - launch parallel explore agents\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-2\", \"content\": \"PHASE 2: Build Codemap - map dependencies and impact zones\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-3\", \"content\": \"PHASE 3: Test Assessment - analyze test coverage and verification strategy\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-4\", \"content\": \"PHASE 4: Plan Generation - invoke Plan agent for detailed refactoring plan\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-5\", \"content\": \"PHASE 5: Execute Refactoring - step-by-step with continuous verification\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-6\", \"content\": \"PHASE 6: Final Verification - full test suite and regression check\", \"status\": \"pending\", \"priority\": \"high\"}\n])\n```\n\n---\n\n# PHASE 1: CODEBASE ANALYSIS (PARALLEL EXPLORATION)\n\n**Mark phase-1 as in_progress.**\n\n## 1.1: Launch Parallel Explore Agents (BACKGROUND)\n\nFire ALL of these simultaneously using `call_omo_agent`:\n\n```\n// Agent 1: Find the refactoring target\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find all occurrences and definitions of [TARGET]. \n  Report: file paths, line numbers, usage patterns.\"\n)\n\n// Agent 2: Find related code\ncall_omo_agent(\n  subagent_type=\"explore\", \n  run_in_background=true,\n  prompt=\"Find all code that imports, uses, or depends on [TARGET].\n  Report: dependency chains, import graphs.\"\n)\n\n// Agent 3: Find similar patterns\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find similar code patterns to [TARGET] in the codebase.\n  Report: analogous implementations, established conventions.\"\n)\n\n// Agent 4: Find tests\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find all test files related to [TARGET].\n  Report: test file paths, test case names, coverage indicators.\"\n)\n\n// Agent 5: Architecture context\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find architectural patterns and module organization around [TARGET].\n  Report: module boundaries, layer structure, design patterns in use.\"\n)\n```\n\n## 1.2: Direct Tool Exploration (WHILE AGENTS RUN)\n\nWhile background agents are running, use direct tools:\n\n### LSP Tools for Precise Analysis:\n\n```typescript\n// Get symbol information at target location\nlsp_hover(filePath, line, character)  // Type info, docs, signatures\n\n// Find definition(s)\nlsp_goto_definition(filePath, line, character)  // Where is it defined?\n\n// Find ALL usages across workspace\nlsp_find_references(filePath, line, character, includeDeclaration=true)\n\n// Get file structure\nlsp_document_symbols(filePath)  // Hierarchical outline\n\n// Search symbols by name\nlsp_workspace_symbols(filePath, query=\"[target_symbol]\")\n\n// Get current diagnostics\nlsp_diagnostics(filePath)  // Errors, warnings before we start\n```\n\n### AST-Grep for Pattern Analysis:\n\n```typescript\n// Find structural patterns\nast_grep_search(\n  pattern=\"function $NAME($$$) { $$$ }\",  // or relevant pattern\n  lang=\"typescript\",  // or relevant language\n  paths=[\"src/\"]\n)\n\n// Preview refactoring (DRY RUN)\nast_grep_replace(\n  pattern=\"[old_pattern]\",\n  rewrite=\"[new_pattern]\",\n  lang=\"[language]\",\n  dryRun=true  // ALWAYS preview first\n)\n```\n\n### Grep for Text Patterns:\n\n```\ngrep(pattern=\"[search_term]\", path=\"src/\", include=\"*.ts\")\n```\n\n## 1.3: Collect Background Results\n\n```\nbackground_output(task_id=\"[agent_1_id]\")\nbackground_output(task_id=\"[agent_2_id]\")\n...\n```\n\n**Mark phase-1 as completed after all results collected.**\n\n---\n\n# PHASE 2: BUILD CODEMAP (DEPENDENCY MAPPING)\n\n**Mark phase-2 as in_progress.**\n\n## 2.1: Construct Definitive Codemap\n\nBased on Phase 1 results, build:\n\n```\n## CODEMAP: [TARGET]\n\n### Core Files (Direct Impact)\n- `path/to/file.ts:L10-L50` - Primary definition\n- `path/to/file2.ts:L25` - Key usage\n\n### Dependency Graph\n```\n[TARGET] \n\u251C\u2500\u2500 imports from: \n\u2502   \u251C\u2500\u2500 module-a (types)\n\u2502   \u2514\u2500\u2500 module-b (utils)\n\u251C\u2500\u2500 imported by:\n\u2502   \u251C\u2500\u2500 consumer-1.ts\n\u2502   \u251C\u2500\u2500 consumer-2.ts\n\u2502   \u2514\u2500\u2500 consumer-3.ts\n\u2514\u2500\u2500 used by:\n    \u251C\u2500\u2500 handler.ts (direct call)\n    \u2514\u2500\u2500 service.ts (dependency injection)\n```\n\n### Impact Zones\n| Zone | Risk Level | Files Affected | Test Coverage |\n|------|------------|----------------|---------------|\n| Core | HIGH | 3 files | 85% covered |\n| Consumers | MEDIUM | 8 files | 70% covered |\n| Edge | LOW | 2 files | 50% covered |\n\n### Established Patterns\n- Pattern A: [description] - used in N places\n- Pattern B: [description] - established convention\n```\n\n## 2.2: Identify Refactoring Constraints\n\nBased on codemap:\n- **MUST follow**: [existing patterns identified]\n- **MUST NOT break**: [critical dependencies]\n- **Safe to change**: [isolated code zones]\n- **Requires migration**: [breaking changes impact]\n\n**Mark phase-2 as completed.**\n\n---\n\n# PHASE 3: TEST ASSESSMENT (VERIFICATION STRATEGY)\n\n**Mark phase-3 as in_progress.**\n\n## 3.1: Detect Test Infrastructure\n\n```bash\n# Check for test commands\ncat package.json | jq '.scripts | keys[] | select(test(\"test\"))'\n\n# Or for Python\nls -la pytest.ini pyproject.toml setup.cfg\n\n# Or for Go\nls -la *_test.go\n```\n\n## 3.2: Analyze Test Coverage\n\n```\n// Find all tests related to target\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=false,  // Need this synchronously\n  prompt=\"Analyze test coverage for [TARGET]:\n  1. Which test files cover this code?\n  2. What test cases exist?\n  3. Are there integration tests?\n  4. What edge cases are tested?\n  5. Estimated coverage percentage?\"\n)\n```\n\n## 3.3: Determine Verification Strategy\n\nBased on test analysis:\n\n| Coverage Level | Strategy |\n|----------------|----------|\n| HIGH (>80%) | Run existing tests after each step |\n| MEDIUM (50-80%) | Run tests + add safety assertions |\n| LOW (<50%) | **PAUSE**: Propose adding tests first |\n| NONE | **BLOCK**: Refuse aggressive refactoring |\n\n**If coverage is LOW or NONE, ask user:**\n\n```\nTest coverage for [TARGET] is [LEVEL].\n\n**Risk Assessment**: Refactoring without adequate tests is dangerous.\n\nOptions:\n1. Add tests first, then refactor (RECOMMENDED)\n2. Proceed with extra caution, manual verification required\n3. Abort refactoring\n\nWhich approach do you prefer?\n```\n\n## 3.4: Document Verification Plan\n\n```\n## VERIFICATION PLAN\n\n### Test Commands\n- Unit: `bun test` / `npm test` / `pytest` / etc.\n- Integration: [command if exists]\n- Type check: `tsc --noEmit` / `pyright` / etc.\n\n### Verification Checkpoints\nAfter each refactoring step:\n1. lsp_diagnostics \u2192 zero new errors\n2. Run test command \u2192 all pass\n3. Type check \u2192 clean\n\n### Regression Indicators\n- [Specific test that must pass]\n- [Behavior that must be preserved]\n- [API contract that must not change]\n```\n\n**Mark phase-3 as completed.**\n\n---\n\n# PHASE 4: PLAN GENERATION (PLAN AGENT)\n\n**Mark phase-4 as in_progress.**\n\n## 4.1: Invoke Plan Agent\n\n```\nTask(\n  subagent_type=\"plan\",\n  prompt=\"Create a detailed refactoring plan:\n\n  ## Refactoring Goal\n  [User's original request]\n\n  ## Codemap (from Phase 2)\n  [Insert codemap here]\n\n  ## Test Coverage (from Phase 3)\n  [Insert verification plan here]\n\n  ## Constraints\n  - MUST follow existing patterns: [list]\n  - MUST NOT break: [critical paths]\n  - MUST run tests after each step\n\n  ## Requirements\n  1. Break down into atomic refactoring steps\n  2. Each step must be independently verifiable\n  3. Order steps by dependency (what must happen first)\n  4. Specify exact files and line ranges for each step\n  5. Include rollback strategy for each step\n  6. Define commit checkpoints\"\n)\n```\n\n## 4.2: Review and Validate Plan\n\nAfter receiving plan from Plan agent:\n\n1. **Verify completeness**: All identified files addressed?\n2. **Verify safety**: Each step reversible?\n3. **Verify order**: Dependencies respected?\n4. **Verify verification**: Test commands specified?\n\n## 4.3: Register Detailed Todos\n\nConvert Plan agent output into granular todos:\n\n```\nTodoWrite([\n  // Each step from the plan becomes a todo\n  {\"id\": \"refactor-1\", \"content\": \"Step 1: [description]\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"verify-1\", \"content\": \"Verify Step 1: run tests\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"refactor-2\", \"content\": \"Step 2: [description]\", \"status\": \"pending\", \"priority\": \"medium\"},\n  {\"id\": \"verify-2\", \"content\": \"Verify Step 2: run tests\", \"status\": \"pending\", \"priority\": \"medium\"},\n  // ... continue for all steps\n])\n```\n\n**Mark phase-4 as completed.**\n\n---\n\n# PHASE 5: EXECUTE REFACTORING (DETERMINISTIC EXECUTION)\n\n**Mark phase-5 as in_progress.**\n\n## 5.1: Execution Protocol\n\nFor EACH refactoring step:\n\n### Pre-Step\n1. Mark step todo as `in_progress`\n2. Read current file state\n3. Verify lsp_diagnostics is baseline\n\n### Execute Step\nUse appropriate tool:\n\n**For Symbol Renames:**\n```typescript\nlsp_prepare_rename(filePath, line, character)  // Validate rename is possible\nlsp_rename(filePath, line, character, newName)  // Execute rename\n```\n\n**For Pattern Transformations:**\n```typescript\n// Preview first\nast_grep_replace(pattern, rewrite, lang, dryRun=true)\n\n// If preview looks good, execute\nast_grep_replace(pattern, rewrite, lang, dryRun=false)\n```\n\n**For Structural Changes:**\n```typescript\n// Use Edit tool for precise changes\nedit(filePath, oldString, newString)\n```\n\n### Post-Step Verification (MANDATORY)\n\n```typescript\n// 1. Check diagnostics\nlsp_diagnostics(filePath)  // Must be clean or same as baseline\n\n// 2. Run tests\nbash(\"bun test\")  // Or appropriate test command\n\n// 3. Type check\nbash(\"tsc --noEmit\")  // Or appropriate type check\n```\n\n### Step Completion\n1. If verification passes \u2192 Mark step todo as `completed`\n2. If verification fails \u2192 **STOP AND FIX**\n\n## 5.2: Failure Recovery Protocol\n\nIf ANY verification fails:\n\n1. **STOP** immediately\n2. **REVERT** the failed change\n3. **DIAGNOSE** what went wrong\n4. **OPTIONS**:\n   - Fix the issue and retry\n   - Skip this step (if optional)\n   - Consult oracle agent for help\n   - Ask user for guidance\n\n**NEVER proceed to next step with broken tests.**\n\n## 5.3: Commit Checkpoints\n\nAfter each logical group of changes:\n\n```bash\ngit add [changed-files]\ngit commit -m \"refactor(scope): description\n\n[details of what was changed and why]\"\n```\n\n**Mark phase-5 as completed when all refactoring steps done.**\n\n---\n\n# PHASE 6: FINAL VERIFICATION (REGRESSION CHECK)\n\n**Mark phase-6 as in_progress.**\n\n## 6.1: Full Test Suite\n\n```bash\n# Run complete test suite\nbun test  # or npm test, pytest, go test, etc.\n```\n\n## 6.2: Type Check\n\n```bash\n# Full type check\ntsc --noEmit  # or equivalent\n```\n\n## 6.3: Lint Check\n\n```bash\n# Run linter\neslint .  # or equivalent\n```\n\n## 6.4: Build Verification (if applicable)\n\n```bash\n# Ensure build still works\nbun run build  # or npm run build, etc.\n```\n\n## 6.5: Final Diagnostics\n\n```typescript\n// Check all changed files\nfor (file of changedFiles) {\n  lsp_diagnostics(file)  // Must all be clean\n}\n```\n\n## 6.6: Generate Summary\n\n```markdown\n## Refactoring Complete\n\n### What Changed\n- [List of changes made]\n\n### Files Modified\n- `path/to/file.ts` - [what changed]\n- `path/to/file2.ts` - [what changed]\n\n### Verification Results\n- Tests: PASSED (X/Y passing)\n- Type Check: CLEAN\n- Lint: CLEAN\n- Build: SUCCESS\n\n### No Regressions Detected\nAll existing tests pass. No new errors introduced.\n```\n\n**Mark phase-6 as completed.**\n\n---\n\n# CRITICAL RULES\n\n## NEVER DO\n- Skip lsp_diagnostics check after changes\n- Proceed with failing tests\n- Make changes without understanding impact\n- Use `as any`, `@ts-ignore`, `@ts-expect-error`\n- Delete tests to make them pass\n- Commit broken code\n- Refactor without understanding existing patterns\n\n## ALWAYS DO\n- Understand before changing\n- Preview before applying (ast_grep dryRun=true)\n- Verify after every change\n- Follow existing codebase patterns\n- Keep todos updated in real-time\n- Commit at logical checkpoints\n- Report issues immediately\n\n## ABORT CONDITIONS\nIf any of these occur, **STOP and consult user**:\n- Test coverage is zero for target code\n- Changes would break public API\n- Refactoring scope is unclear\n- 3 consecutive verification failures\n- User-defined constraints violated\n\n---\n\n# Tool Usage Philosophy\n\nYou already know these tools. Use them intelligently:\n\n## LSP Tools\nLeverage the full LSP toolset (`lsp_*`) for precision analysis. Key patterns:\n- **Understand before changing**: `lsp_hover`, `lsp_goto_definition` to grasp context\n- **Impact analysis**: `lsp_find_references` to map all usages before modification\n- **Safe refactoring**: `lsp_prepare_rename` \u2192 `lsp_rename` for symbol renames\n- **Continuous verification**: `lsp_diagnostics` after every change\n\n## AST-Grep\nUse `ast_grep_search` and `ast_grep_replace` for structural transformations.\n**Critical**: Always `dryRun=true` first, review, then execute.\n\n## Agents\n- `explore`: Parallel codebase pattern discovery\n- `plan`: Detailed refactoring plan generation\n- `oracle`: Consult for complex architectural decisions\n- `librarian`: **Use proactively** when encountering deprecated methods or library migration tasks. Query official docs and OSS examples for modern replacements.\n\n## Deprecated Code & Library Migration\nWhen you encounter deprecated methods/APIs during refactoring:\n1. Fire `librarian` to find the recommended modern alternative\n2. **DO NOT auto-upgrade to latest version** unless user explicitly requests migration\n3. If user requests library migration, use `librarian` to fetch latest API docs before making changes\n\n---\n\n**Remember: Refactoring without tests is reckless. Refactoring without understanding is destructive. This command ensures you do neither.**\n\n<user-request>\n$ARGUMENTS\n</user-request>\n";

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

@@ -1,5 +1,5 @@
 import type { CommandDefinition } from "../claude-code-command-loader";
-export type BuiltinCommandName = "init-deep" | "ralph-loop" | "cancel-ralph";
+export type BuiltinCommandName = "init-deep" | "ralph-loop" | "cancel-ralph" | "refactor";
 export interface BuiltinCommandConfig {
     disabled_commands?: BuiltinCommandName[];
 }

package/dist/features/claude-code-command-loader/loader.d.ts

@@ -1,10 +1,6 @@
 import type { CommandDefinition } from "./types";
-export declare function loadUserCommands(): Record<string, CommandDefinition>;
-export declare function loadProjectCommands(): Record<string, CommandDefinition>;
-export declare function loadOpencodeGlobalCommands(): Record<string, CommandDefinition>;
-export declare function loadOpencodeProjectCommands(): Record<string, CommandDefinition>;
-export declare function loadUserCommandsAsync(): Promise<Record<string, CommandDefinition>>;
-export declare function loadProjectCommandsAsync(): Promise<Record<string, CommandDefinition>>;
-export declare function loadOpencodeGlobalCommandsAsync(): Promise<Record<string, CommandDefinition>>;
-export declare function loadOpencodeProjectCommandsAsync(): Promise<Record<string, CommandDefinition>>;
-export declare function loadAllCommandsAsync(): Promise<Record<string, CommandDefinition>>;
+export declare function loadUserCommands(): Promise<Record<string, CommandDefinition>>;
+export declare function loadProjectCommands(): Promise<Record<string, CommandDefinition>>;
+export declare function loadOpencodeGlobalCommands(): Promise<Record<string, CommandDefinition>>;
+export declare function loadOpencodeProjectCommands(): Promise<Record<string, CommandDefinition>>;
+export declare function loadAllCommands(): Promise<Record<string, CommandDefinition>>;

package/dist/features/opencode-skill-loader/loader.d.ts

@@ -1,46 +1,16 @@
 import type { CommandDefinition } from "../claude-code-command-loader/types";
 import type { LoadedSkill } from "./types";
-/**
- * Load skills from Claude Code user directory (~/.claude/skills/)
- */
-export declare function loadUserSkills(): Record<string, CommandDefinition>;
-/**
- * Load skills from Claude Code project directory (.claude/skills/)
- */
-export declare function loadProjectSkills(): Record<string, CommandDefinition>;
-/**
- * Load skills from OpenCode global directory (~/.config/opencode/skill/)
- */
-export declare function loadOpencodeGlobalSkills(): Record<string, CommandDefinition>;
-/**
- * Load skills from OpenCode project directory (.opencode/skill/)
- */
-export declare function loadOpencodeProjectSkills(): Record<string, CommandDefinition>;
-/**
- * Discover all skills from all sources with priority ordering.
- * Priority order: opencode-project > project > opencode > user
- *
- * @returns Array of LoadedSkill objects for use in slashcommand discovery
- */
-export declare function discoverAllSkills(): LoadedSkill[];
+export declare function loadUserSkills(): Promise<Record<string, CommandDefinition>>;
+export declare function loadProjectSkills(): Promise<Record<string, CommandDefinition>>;
+export declare function loadOpencodeGlobalSkills(): Promise<Record<string, CommandDefinition>>;
+export declare function loadOpencodeProjectSkills(): Promise<Record<string, CommandDefinition>>;
 export interface DiscoverSkillsOptions {
     includeClaudeCodePaths?: boolean;
 }
-/**
- * Discover skills with optional filtering.
- * When includeClaudeCodePaths is false, only loads from OpenCode paths.
- */
-export declare function discoverSkills(options?: DiscoverSkillsOptions): LoadedSkill[];
-/**
- * Get a skill by name from all available sources.
- */
-export declare function getSkillByName(name: string, options?: DiscoverSkillsOptions): LoadedSkill | undefined;
-export declare function discoverUserClaudeSkills(): LoadedSkill[];
-export declare function discoverProjectClaudeSkills(): LoadedSkill[];
-export declare function discoverOpencodeGlobalSkills(): LoadedSkill[];
-export declare function discoverOpencodeProjectSkills(): LoadedSkill[];
-export declare function discoverUserClaudeSkillsAsync(): Promise<LoadedSkill[]>;
-export declare function discoverProjectClaudeSkillsAsync(): Promise<LoadedSkill[]>;
-export declare function discoverOpencodeGlobalSkillsAsync(): Promise<LoadedSkill[]>;
-export declare function discoverOpencodeProjectSkillsAsync(): Promise<LoadedSkill[]>;
-export declare function discoverAllSkillsAsync(options?: DiscoverSkillsOptions): Promise<LoadedSkill[]>;
+export declare function discoverAllSkills(): Promise<LoadedSkill[]>;
+export declare function discoverSkills(options?: DiscoverSkillsOptions): Promise<LoadedSkill[]>;
+export declare function getSkillByName(name: string, options?: DiscoverSkillsOptions): Promise<LoadedSkill | undefined>;
+export declare function discoverUserClaudeSkills(): Promise<LoadedSkill[]>;
+export declare function discoverProjectClaudeSkills(): Promise<LoadedSkill[]>;
+export declare function discoverOpencodeGlobalSkills(): Promise<LoadedSkill[]>;
+export declare function discoverOpencodeProjectSkills(): Promise<LoadedSkill[]>;

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

@@ -1,6 +1,12 @@
 export declare const CODE_BLOCK_PATTERN: RegExp;
 export declare const INLINE_CODE_PATTERN: RegExp;
+/**
+ * Generates the ultrawork message based on agent context.
+ * Planner agents get context-gathering focused instructions.
+ * Other agents get the original strong agent utilization instructions.
+ */
+export declare function getUltraworkMessage(agentName?: string): string;
 export declare const KEYWORD_DETECTORS: Array<{
     pattern: RegExp;
-    message: string;
+    message: string | ((agentName?: string) => string);
 }>;

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

@@ -3,8 +3,8 @@ export interface DetectedKeyword {
     message: string;
 }
 export declare function removeCodeBlocks(text: string): string;
-export declare function detectKeywords(text: string): string[];
-export declare function detectKeywordsWithType(text: string): DetectedKeyword[];
+export declare function detectKeywords(text: string, agentName?: string): string[];
+export declare function detectKeywordsWithType(text: string, agentName?: string): DetectedKeyword[];
 export declare function extractPromptText(parts: Array<{
     type: string;
     text?: string;