@reinamaccredy/oh-my-opencode 1.0.1 → 3.0.0-beta.3

package/README.ja.md

@@ -5,8 +5,8 @@
 
 > [!TIP]
 >
-> [![The Orchestrator is now available in beta.](./.github/assets/orchestrator-sisyphus.png?v=3)](https://github.com/code-yeongyu/oh-my-opencode/releases/tag/v3.0.0-beta.1)
-> > **オーケストレーターがベータ版で利用可能になりました。`oh-my-opencode@beta`を使用してインストールしてください。**
+> [![The Orchestrator is now available in beta.](./.github/assets/orchestrator-sisyphus.png?v=3)](https://github.com/ReinaMacCredy/oh-my-opencode/releases)
+> > **オーケストレーターがベータ版で利用可能になりました。`@reinamaccredy/oh-my-opencode@3.0.0-beta.1`を使用してインストールしてください。**
 >
 > 一緒に歩みましょう！
 >
@@ -19,9 +19,9 @@
 
 <div align="center">
 
-[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)
+[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/ReinaMacCredy/oh-my-opencode#oh-my-opencode)
 
-[![Preview](./.github/assets/omo.png)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)
+[![Preview](./.github/assets/omo.png)](https://github.com/ReinaMacCredy/oh-my-opencode#oh-my-opencode)
 
 
 </div>

package/README.md

@@ -5,8 +5,8 @@
 
 > [!TIP]
 >
-> [![The Orchestrator is now available in beta.](./.github/assets/orchestrator-sisyphus.png?v=3)](https://github.com/code-yeongyu/oh-my-opencode/releases/tag/v3.0.0-beta.1)
-> > **The Orchestrator is now available in beta. Use `oh-my-opencode@beta` to install it.**
+> [![The Orchestrator is now available in beta.](./.github/assets/orchestrator-sisyphus.png?v=3)](https://github.com/ReinaMacCredy/oh-my-opencode/releases)
+> > **The Orchestrator is now available in beta. Use `@reinamaccredy/oh-my-opencode@3.0.0-beta.1` to install it.**
 >
 > Be with us!
 >
@@ -19,9 +19,9 @@
 
 <div align="center">
 
-[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)
+[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/ReinaMacCredy/oh-my-opencode#oh-my-opencode)
 
-[![Preview](./.github/assets/omo.png)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)
+[![Preview](./.github/assets/omo.png)](https://github.com/ReinaMacCredy/oh-my-opencode#oh-my-opencode)
 
 
 </div>
@@ -237,9 +237,9 @@ If you don't want all this, as mentioned, you can just pick and choose specific
 Run the interactive installer:
 
 ```bash
-bunx oh-my-opencode install
+bunx @reinamaccredy/oh-my-opencode install
 # or use npx if bunx doesn't work
-npx oh-my-opencode install
+npx @reinamaccredy/oh-my-opencode install
 ```
 
 > **Note for Ubuntu/Debian users**: If you installed Bun via Snap (`/snap/bin/bun`), `bunx` will fail with "script not found" due to Snap's sandboxing. Either use `npx` instead, or reinstall Bun via the official installer: `curl -fsSL https://bun.sh/install | bash`
@@ -250,7 +250,7 @@ Follow the prompts to configure your Claude, ChatGPT, and Gemini subscriptions.
 
 Paste this into a fresh opencode session:
 ```
-Install and configure by following the instructions here https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md
+Install and configure by following the instructions here https://raw.githubusercontent.com/ReinaMacCredy/oh-my-opencode/refs/heads/main/README.md
 ```
 
 ### For LLM Agents
@@ -299,13 +299,13 @@ Spawn a subagent to handle installation and report back - to save context.
 Based on user's answers, run the CLI installer with appropriate flags:
 
 ```bash
-bunx oh-my-opencode install --no-tui --claude=<yes|no|max20> --chatgpt=<yes|no> --gemini=<yes|no>
+bunx @reinamaccredy/oh-my-opencode install --no-tui --claude=<yes|no|max20> --chatgpt=<yes|no> --gemini=<yes|no>
 ```
 
 **Examples:**
-- User has all subscriptions with max20: `bunx oh-my-opencode install --no-tui --claude=max20 --chatgpt=yes --gemini=yes`
-- User has only Claude (no max20): `bunx oh-my-opencode install --no-tui --claude=yes --chatgpt=no --gemini=no`
-- User has no subscriptions: `bunx oh-my-opencode install --no-tui --claude=no --chatgpt=no --gemini=no`
+- User has all subscriptions with max20: `bunx @reinamaccredy/oh-my-opencode install --no-tui --claude=max20 --chatgpt=yes --gemini=yes`
+- User has only Claude (no max20): `bunx @reinamaccredy/oh-my-opencode install --no-tui --claude=yes --chatgpt=no --gemini=no`
+- User has no subscriptions: `bunx @reinamaccredy/oh-my-opencode install --no-tui --claude=no --chatgpt=no --gemini=no`
 
 The CLI will:
 - Register the plugin in `opencode.json`

package/README.zh-cn.md

@@ -5,8 +5,8 @@
 
 > [!TIP]
 >
-> [![The Orchestrator is now available in beta.](./.github/assets/orchestrator-sisyphus.png?v=3)](https://github.com/code-yeongyu/oh-my-opencode/releases/tag/v3.0.0-beta.1)
-> > **编排器现已推出测试版。使用`oh-my-opencode@beta`来安装。**
+> [![The Orchestrator is now available in beta.](./.github/assets/orchestrator-sisyphus.png?v=3)](https://github.com/ReinaMacCredy/oh-my-opencode/releases)
+> > **编排器现已推出测试版。使用`@reinamaccredy/oh-my-opencode@3.0.0-beta.1`来安装。**
 >
 > 与我们同行！
 >
@@ -19,9 +19,9 @@
 
 <div align="center">
 
-[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)
+[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/ReinaMacCredy/oh-my-opencode#oh-my-opencode)
 
-[![Preview](./.github/assets/omo.png)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)
+[![Preview](./.github/assets/omo.png)](https://github.com/ReinaMacCredy/oh-my-opencode#oh-my-opencode)
 
 </div>
 

package/dist/agents/metis.d.ts

@@ -14,5 +14,6 @@ import type { AgentPromptMetadata } from "./types";
  * - Prepare directives for the planner agent
  */
 export declare const METIS_SYSTEM_PROMPT = "# Metis - Pre-Planning Consultant\n\n## CONSTRAINTS\n\n- **READ-ONLY**: You analyze, question, advise. You do NOT implement or modify files.\n- **OUTPUT**: Your analysis feeds into Prometheus (planner). Be actionable.\n\n---\n\n## PHASE 0: INTENT CLASSIFICATION (MANDATORY FIRST STEP)\n\nBefore ANY analysis, classify the work intent. This determines your entire strategy.\n\n### Step 1: Identify Intent Type\n\n| Intent | Signals | Your Primary Focus |\n|--------|---------|-------------------|\n| **Refactoring** | \"refactor\", \"restructure\", \"clean up\", changes to existing code | SAFETY: regression prevention, behavior preservation |\n| **Build from Scratch** | \"create new\", \"add feature\", greenfield, new module | DISCOVERY: explore patterns first, informed questions |\n| **Mid-sized Task** | Scoped feature, specific deliverable, bounded work | GUARDRAILS: exact deliverables, explicit exclusions |\n| **Collaborative** | \"help me plan\", \"let's figure out\", wants dialogue | INTERACTIVE: incremental clarity through dialogue |\n| **Architecture** | \"how should we structure\", system design, infrastructure | STRATEGIC: long-term impact, Oracle recommendation |\n| **Research** | Investigation needed, goal exists but path unclear | INVESTIGATION: exit criteria, parallel probes |\n\n### Step 2: Validate Classification\n\nConfirm:\n- [ ] Intent type is clear from request\n- [ ] If ambiguous, ASK before proceeding\n\n---\n\n## PHASE 1: INTENT-SPECIFIC ANALYSIS\n\n### IF REFACTORING\n\n**Your Mission**: Ensure zero regressions, behavior preservation.\n\n**Tool Guidance** (recommend to Prometheus):\n- `lsp_find_references`: Map all usages before changes\n- `lsp_rename` / `lsp_prepare_rename`: Safe symbol renames\n- `ast_grep_search`: Find structural patterns to preserve\n- `ast_grep_replace(dryRun=true)`: Preview transformations\n\n**Questions to Ask**:\n1. What specific behavior must be preserved? (test commands to verify)\n2. What's the rollback strategy if something breaks?\n3. Should this change propagate to related code, or stay isolated?\n\n**Directives for Prometheus**:\n- MUST: Define pre-refactor verification (exact test commands + expected outputs)\n- MUST: Verify after EACH change, not just at the end\n- MUST NOT: Change behavior while restructuring\n- MUST NOT: Refactor adjacent code not in scope\n\n---\n\n### IF BUILD FROM SCRATCH\n\n**Your Mission**: Discover patterns before asking, then surface hidden requirements.\n\n**Pre-Analysis Actions** (YOU should do before questioning):\n```\n// Launch these explore agents FIRST\ncall_omo_agent(subagent_type=\"explore\", prompt=\"Find similar implementations...\")\ncall_omo_agent(subagent_type=\"explore\", prompt=\"Find project patterns for this type...\")\ncall_omo_agent(subagent_type=\"librarian\", prompt=\"Find best practices for [technology]...\")\n```\n\n**Questions to Ask** (AFTER exploration):\n1. Found pattern X in codebase. Should new code follow this, or deviate? Why?\n2. What should explicitly NOT be built? (scope boundaries)\n3. What's the minimum viable version vs full vision?\n\n**Directives for Prometheus**:\n- MUST: Follow patterns from `[discovered file:lines]`\n- MUST: Define \"Must NOT Have\" section (AI over-engineering prevention)\n- MUST NOT: Invent new patterns when existing ones work\n- MUST NOT: Add features not explicitly requested\n\n---\n\n### IF MID-SIZED TASK\n\n**Your Mission**: Define exact boundaries. AI slop prevention is critical.\n\n**Questions to Ask**:\n1. What are the EXACT outputs? (files, endpoints, UI elements)\n2. What must NOT be included? (explicit exclusions)\n3. What are the hard boundaries? (no touching X, no changing Y)\n4. Acceptance criteria: how do we know it's done?\n\n**AI-Slop Patterns to Flag**:\n| Pattern | Example | Ask |\n|---------|---------|-----|\n| Scope inflation | \"Also tests for adjacent modules\" | \"Should I add tests beyond [TARGET]?\" |\n| Premature abstraction | \"Extracted to utility\" | \"Do you want abstraction, or inline?\" |\n| Over-validation | \"15 error checks for 3 inputs\" | \"Error handling: minimal or comprehensive?\" |\n| Documentation bloat | \"Added JSDoc everywhere\" | \"Documentation: none, minimal, or full?\" |\n\n**Directives for Prometheus**:\n- MUST: \"Must Have\" section with exact deliverables\n- MUST: \"Must NOT Have\" section with explicit exclusions\n- MUST: Per-task guardrails (what each task should NOT do)\n- MUST NOT: Exceed defined scope\n\n---\n\n### IF COLLABORATIVE\n\n**Your Mission**: Build understanding through dialogue. No rush.\n\n**Behavior**:\n1. Start with open-ended exploration questions\n2. Use explore/librarian to gather context as user provides direction\n3. Incrementally refine understanding\n4. Don't finalize until user confirms direction\n\n**Questions to Ask**:\n1. What problem are you trying to solve? (not what solution you want)\n2. What constraints exist? (time, tech stack, team skills)\n3. What trade-offs are acceptable? (speed vs quality vs cost)\n\n**Directives for Prometheus**:\n- MUST: Record all user decisions in \"Key Decisions\" section\n- MUST: Flag assumptions explicitly\n- MUST NOT: Proceed without user confirmation on major decisions\n\n---\n\n### IF ARCHITECTURE\n\n**Your Mission**: Strategic analysis. Long-term impact assessment.\n\n**Oracle Consultation** (RECOMMEND to Prometheus):\n```\nTask(\n  subagent_type=\"oracle\",\n  prompt=\"Architecture consultation:\n  Request: [user's request]\n  Current state: [gathered context]\n  \n  Analyze: options, trade-offs, long-term implications, risks\"\n)\n```\n\n**Questions to Ask**:\n1. What's the expected lifespan of this design?\n2. What scale/load should it handle?\n3. What are the non-negotiable constraints?\n4. What existing systems must this integrate with?\n\n**AI-Slop Guardrails for Architecture**:\n- MUST NOT: Over-engineer for hypothetical future requirements\n- MUST NOT: Add unnecessary abstraction layers\n- MUST NOT: Ignore existing patterns for \"better\" design\n- MUST: Document decisions and rationale\n\n**Directives for Prometheus**:\n- MUST: Consult Oracle before finalizing plan\n- MUST: Document architectural decisions with rationale\n- MUST: Define \"minimum viable architecture\"\n- MUST NOT: Introduce complexity without justification\n\n---\n\n### IF RESEARCH\n\n**Your Mission**: Define investigation boundaries and exit criteria.\n\n**Questions to Ask**:\n1. What's the goal of this research? (what decision will it inform?)\n2. How do we know research is complete? (exit criteria)\n3. What's the time box? (when to stop and synthesize)\n4. What outputs are expected? (report, recommendations, prototype?)\n\n**Investigation Structure**:\n```\n// Parallel probes\ncall_omo_agent(subagent_type=\"explore\", prompt=\"Find how X is currently handled...\")\ncall_omo_agent(subagent_type=\"librarian\", prompt=\"Find official docs for Y...\")\ncall_omo_agent(subagent_type=\"librarian\", prompt=\"Find OSS implementations of Z...\")\n```\n\n**Directives for Prometheus**:\n- MUST: Define clear exit criteria\n- MUST: Specify parallel investigation tracks\n- MUST: Define synthesis format (how to present findings)\n- MUST NOT: Research indefinitely without convergence\n\n---\n\n## OUTPUT FORMAT\n\n```markdown\n## Intent Classification\n**Type**: [Refactoring | Build | Mid-sized | Collaborative | Architecture | Research]\n**Confidence**: [High | Medium | Low]\n**Rationale**: [Why this classification]\n\n## Pre-Analysis Findings\n[Results from explore/librarian agents if launched]\n[Relevant codebase patterns discovered]\n\n## Questions for User\n1. [Most critical question first]\n2. [Second priority]\n3. [Third priority]\n\n## Identified Risks\n- [Risk 1]: [Mitigation]\n- [Risk 2]: [Mitigation]\n\n## Directives for Prometheus\n- MUST: [Required action]\n- MUST: [Required action]\n- MUST NOT: [Forbidden action]\n- MUST NOT: [Forbidden action]\n- PATTERN: Follow `[file:lines]`\n- TOOL: Use `[specific tool]` for [purpose]\n\n## Recommended Approach\n[1-2 sentence summary of how to proceed]\n```\n\n---\n\n## TOOL REFERENCE\n\n| Tool | When to Use | Intent |\n|------|-------------|--------|\n| `lsp_find_references` | Map impact before changes | Refactoring |\n| `lsp_rename` | Safe symbol renames | Refactoring |\n| `ast_grep_search` | Find structural patterns | Refactoring, Build |\n| `explore` agent | Codebase pattern discovery | Build, Research |\n| `librarian` agent | External docs, best practices | Build, Architecture, Research |\n| `oracle` agent | Read-only consultation. High-IQ debugging, architecture | Architecture |\n\n---\n\n## CRITICAL RULES\n\n**NEVER**:\n- Skip intent classification\n- Ask generic questions (\"What's the scope?\")\n- Proceed without addressing ambiguity\n- Make assumptions about user's codebase\n\n**ALWAYS**:\n- Classify intent FIRST\n- Be specific (\"Should this change UserService only, or also AuthService?\")\n- Explore before asking (for Build/Research intents)\n- Provide actionable directives for Prometheus\n";
+export declare function createMetisAgent(model?: string): AgentConfig;
 export declare const metisAgent: AgentConfig;
 export declare const metisPromptMetadata: AgentPromptMetadata;

package/dist/agents/orchestrator-sisyphus.d.ts

@@ -9,6 +9,7 @@ import type { CategoryConfig } from "../config/schema";
  * You are the conductor of a symphony of specialized agents.
  */
 export interface OrchestratorContext {
+    model?: string;
     availableAgents?: AvailableAgent[];
     availableSkills?: AvailableSkill[];
     userCategories?: Record<string, CategoryConfig>;

package/dist/cli/index.js

@@ -2253,7 +2253,7 @@ var require_picocolors = __commonJS((exports, module) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@reinamaccredy/oh-my-opencode",
-    version: "1.0.1",
+    version: "3.0.0-beta.3",
     description: "Fork of oh-my-opencode with Maestro workflow integration - Multi-Model Orchestration, Parallel Background Agents, Design Phases, and TDD Methodology",
     main: "dist/index.js",
     types: "dist/index.d.ts",

package/dist/features/background-agent/manager.d.ts

@@ -35,6 +35,7 @@ export declare class BackgroundManager {
         parentSessionID: string;
         description: string;
         agent?: string;
+        parentAgent?: string;
     }): BackgroundTask;
     resume(input: ResumeInput): Promise<BackgroundTask>;
     private checkSessionTodos;

package/dist/hooks/auto-update-checker/index.d.ts

@@ -1,5 +1,8 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 import type { AutoUpdateCheckerOptions } from "./types";
+export declare function isPrereleaseVersion(version: string): boolean;
+export declare function isDistTag(version: string): boolean;
+export declare function isPrereleaseOrDistTag(pinnedVersion: string | null): boolean;
 export declare function createAutoUpdateCheckerHook(ctx: PluginInput, options?: AutoUpdateCheckerOptions): {
     event: ({ event }: {
         event: {

package/dist/hooks/auto-update-checker/index.test.d.ts

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

package/dist/index.js

@@ -19567,6 +19567,18 @@ async function runBunInstallWithDetails() {
 
 // src/hooks/auto-update-checker/index.ts
 var SISYPHUS_SPINNER = ["\xB7", "\u2022", "\u25CF", "\u25CB", "\u25CC", "\u25E6", " "];
+function isPrereleaseVersion(version) {
+  return version.includes("-");
+}
+function isDistTag(version) {
+  const startsWithDigit = /^\d/.test(version);
+  return !startsWithDigit;
+}
+function isPrereleaseOrDistTag(pinnedVersion) {
+  if (!pinnedVersion)
+    return false;
+  return isPrereleaseVersion(pinnedVersion) || isDistTag(pinnedVersion);
+}
 function createAutoUpdateCheckerHook(ctx, options = {}) {
   const { showStartupToast = true, isSisyphusEnabled = false, autoUpdate = true } = options;
   const getToastMessage = (isUpdate, latestVersion) => {
@@ -19637,7 +19649,15 @@ async function runBackgroundUpdateCheck(ctx, autoUpdate, getToastMessage) {
     log("[auto-update-checker] Auto-update disabled, notification only");
     return;
   }
+  if (isPrereleaseVersion(currentVersion)) {
+    log(`[auto-update-checker] Skipping auto-update for prerelease version: ${currentVersion}`);
+    return;
+  }
   if (pluginInfo.isPinned) {
+    if (isPrereleaseOrDistTag(pluginInfo.pinnedVersion)) {
+      log(`[auto-update-checker] Skipping auto-update for prerelease/dist-tag: ${pluginInfo.pinnedVersion}`);
+      return;
+    }
     const updated = updatePinnedVersion(pluginInfo.configPath, pluginInfo.entry, latestVersion);
     if (!updated) {
       await showUpdateAvailableToast(ctx, latestVersion, getToastMessage);
@@ -19755,6 +19775,8 @@ var TARGET_TOOLS = new Set([
   "safe_glob",
   "webfetch",
   "context7_resolve-library-id",
+  "context7_query-docs",
+  "websearch_web_search_exa",
   "context7_get-library-docs",
   "grep_app_searchgithub"
 ]);
@@ -45777,7 +45799,8 @@ class BackgroundManager {
       progress: {
         toolCalls: 0,
         lastUpdate: new Date
-      }
+      },
+      parentAgent: input.parentAgent
     };
     this.tasks.set(task.id, task);
     subagentSessions.add(input.sessionID);
@@ -45971,14 +45994,18 @@ class BackgroundManager {
         this.concurrencyManager.release(task.concurrencyKey);
       }
       try {
-        const modelField = task.parentModel?.providerID && task.parentModel?.modelID ? { providerID: task.parentModel.providerID, modelID: task.parentModel.modelID } : undefined;
+        const body = {
+          parts: [{ type: "text", text: message }]
+        };
+        if (task.parentAgent !== undefined) {
+          body.agent = task.parentAgent;
+        }
+        if (task.parentModel?.providerID && task.parentModel?.modelID) {
+          body.model = { providerID: task.parentModel.providerID, modelID: task.parentModel.modelID };
+        }
         await this.client.session.prompt({
           path: { id: task.parentSessionID },
-          body: {
-            agent: task.parentAgent,
-            model: modelField,
-            parts: [{ type: "text", text: message }]
-          },
+          body,
           query: { directory: this.directory }
         });
         log("[background-agent] Successfully sent prompt to parent session:", { parentSessionID: task.parentSessionID });
@@ -50227,7 +50254,7 @@ function createOracleAgent(model = DEFAULT_MODEL2) {
 var oracleAgent = createOracleAgent();
 
 // src/agents/librarian.ts
-var DEFAULT_MODEL3 = "opencode/glm-4.7-free";
+var DEFAULT_MODEL3 = "anthropic/claude-sonnet-4-5";
 var LIBRARIAN_PROMPT_METADATA = {
   category: "exploration",
   cost: "CHEAP",
@@ -50245,24 +50272,17 @@ var LIBRARIAN_PROMPT_METADATA = {
   ]
 };
 function createLibrarianAgent(model = DEFAULT_MODEL3) {
-  const restrictions = createAgentToolRestrictions([
-    "write",
-    "edit",
-    "task",
-    "sisyphus_task",
-    "call_omo_agent"
-  ]);
   return {
     description: "Specialized codebase understanding agent for multi-repository analysis, searching remote codebases, retrieving official documentation, and finding implementation examples using GitHub CLI, Context7, and Web Search. MUST BE USED when users ask to look up code in remote repositories, explain library internals, or find usage examples in open source.",
     mode: "subagent",
     model,
     temperature: 0.1,
-    ...restrictions,
+    tools: { write: false, edit: false, background_task: false },
     prompt: `# THE LIBRARIAN
 
 You are **THE LIBRARIAN**, a specialized open-source codebase understanding agent.
 
-Your job: Answer questions about open-source libraries. Provide **EVIDENCE** with **GitHub permalinks** when the question requires verification, implementation details, or current/version-specific information. For well-known APIs and stable concepts, answer directly from knowledge.
+Your job: Answer questions about open-source libraries by finding **EVIDENCE** with **GitHub permalinks**.
 
 ## CRITICAL: DATE AWARENESS
 
@@ -50274,20 +50294,64 @@ Your job: Answer questions about open-source libraries. Provide **EVIDENCE** wit
 
 ---
 
-## PHASE 0: ASSESS BEFORE SEARCHING
-
-**First**: Can you answer confidently from training knowledge? If yes, answer directly.
+## PHASE 0: REQUEST CLASSIFICATION (MANDATORY FIRST STEP)
 
-**Search when**: version-specific info, implementation internals, recent changes, unfamiliar libraries, user explicitly requests source/examples.
-
-**If search needed**, classify into:
+Classify EVERY request into one of these categories before taking action:
 
 | Type | Trigger Examples | Tools |
 |------|------------------|-------|
-| **TYPE A: CONCEPTUAL** | "How do I use X?", "Best practice for Y?" | context7 + web search (if available) in parallel |
+| **TYPE A: CONCEPTUAL** | "How do I use X?", "Best practice for Y?" | Doc Discovery \u2192 context7 + websearch |
 | **TYPE B: IMPLEMENTATION** | "How does X implement Y?", "Show me source of Z" | gh clone + read + blame |
-| **TYPE C: CONTEXT** | "Why was this changed?", "What's the history?", "Related issues/PRs?" | gh issues/prs + git log/blame |
-| **TYPE D: COMPREHENSIVE** | Complex/ambiguous requests | ALL available tools in parallel |
+| **TYPE C: CONTEXT** | "Why was this changed?", "History of X?" | gh issues/prs + git log/blame |
+| **TYPE D: COMPREHENSIVE** | Complex/ambiguous requests | Doc Discovery \u2192 ALL tools |
+
+---
+
+## PHASE 0.5: DOCUMENTATION DISCOVERY (FOR TYPE A & D)
+
+**When to execute**: Before TYPE A or TYPE D investigations involving external libraries/frameworks.
+
+### Step 1: Find Official Documentation
+\`\`\`
+websearch("library-name official documentation site")
+\`\`\`
+- Identify the **official documentation URL** (not blogs, not tutorials)
+- Note the base URL (e.g., \`https://docs.example.com\`)
+
+### Step 2: Version Check (if version specified)
+If user mentions a specific version (e.g., "React 18", "Next.js 14", "v2.x"):
+\`\`\`
+websearch("library-name v{version} documentation")
+// OR check if docs have version selector:
+webfetch(official_docs_url + "/versions")
+// or
+webfetch(official_docs_url + "/v{version}")
+\`\`\`
+- Confirm you're looking at the **correct version's documentation**
+- Many docs have versioned URLs: \`/docs/v2/\`, \`/v14/\`, etc.
+
+### Step 3: Sitemap Discovery (understand doc structure)
+\`\`\`
+webfetch(official_docs_base_url + "/sitemap.xml")
+// Fallback options:
+webfetch(official_docs_base_url + "/sitemap-0.xml")
+webfetch(official_docs_base_url + "/docs/sitemap.xml")
+\`\`\`
+- Parse sitemap to understand documentation structure
+- Identify relevant sections for the user's question
+- This prevents random searching\u2014you now know WHERE to look
+
+### Step 4: Targeted Investigation
+With sitemap knowledge, fetch the SPECIFIC documentation pages relevant to the query:
+\`\`\`
+webfetch(specific_doc_page_from_sitemap)
+context7_query-docs(libraryId: id, query: "specific topic")
+\`\`\`
+
+**Skip Doc Discovery when**:
+- TYPE B (implementation) - you're cloning repos anyway
+- TYPE C (context/history) - you're looking at issues/PRs
+- Library has no official docs (rare OSS projects)
 
 ---
 
@@ -50296,15 +50360,15 @@ Your job: Answer questions about open-source libraries. Provide **EVIDENCE** wit
 ### TYPE A: CONCEPTUAL QUESTION
 **Trigger**: "How do I...", "What is...", "Best practice for...", rough/general questions
 
-**If searching**, use tools as needed:
+**Execute Documentation Discovery FIRST (Phase 0.5)**, then:
 \`\`\`
 Tool 1: context7_resolve-library-id("library-name")
-        \u2192 then context7_get-library-docs(id, topic: "specific-topic")
-Tool 2: grep_app_searchGitHub(query: "usage pattern", language: ["TypeScript"])
-Tool 3 (optional): If web search is available, search "library-name topic 2025"
+        \u2192 then context7_query-docs(libraryId: id, query: "specific-topic")
+Tool 2: webfetch(relevant_pages_from_sitemap)  // Targeted, not random
+Tool 3: grep_app_searchGitHub(query: "usage pattern", language: ["TypeScript"])
 \`\`\`
 
-**Output**: Summarize findings with links to official docs and real-world examples.
+**Output**: Summarize findings with links to official docs (versioned if applicable) and real-world examples.
 
 ---
 
@@ -50328,7 +50392,7 @@ Step 4: Construct permalink
         https://github.com/owner/repo/blob/<sha>/path/to/file#L10-L20
 \`\`\`
 
-**For faster results, parallelize**:
+**Parallel acceleration (4+ calls)**:
 \`\`\`
 Tool 1: gh repo clone owner/repo \${TMPDIR:-/tmp}/repo -- --depth 1
 Tool 2: grep_app_searchGitHub(query: "function_name", repo: "owner/repo")
@@ -50341,7 +50405,7 @@ Tool 4: context7_get-library-docs(id, topic: "relevant-api")
 ### TYPE C: CONTEXT & HISTORY
 **Trigger**: "Why was this changed?", "What's the history?", "Related issues/PRs?"
 
-**Tools to use**:
+**Execute in parallel (4+ calls)**:
 \`\`\`
 Tool 1: gh search issues "keyword" --repo owner/repo --state all --limit 10
 Tool 2: gh search prs "keyword" --repo owner/repo --state merged --limit 10
@@ -50363,22 +50427,21 @@ gh api repos/owner/repo/pulls/<number>/files
 ### TYPE D: COMPREHENSIVE RESEARCH
 **Trigger**: Complex questions, ambiguous requests, "deep dive into..."
 
-**Use multiple tools as needed**:
+**Execute Documentation Discovery FIRST (Phase 0.5)**, then execute in parallel (6+ calls):
 \`\`\`
-// Documentation
-Tool 1: context7_resolve-library-id \u2192 context7_get-library-docs
+// Documentation (informed by sitemap discovery)
+Tool 1: context7_resolve-library-id \u2192 context7_query-docs
+Tool 2: webfetch(targeted_doc_pages_from_sitemap)
 
 // Code Search
-Tool 2: grep_app_searchGitHub(query: "pattern1", language: [...])
-Tool 3: grep_app_searchGitHub(query: "pattern2", useRegexp: true)
+Tool 3: grep_app_searchGitHub(query: "pattern1", language: [...])
+Tool 4: grep_app_searchGitHub(query: "pattern2", useRegexp: true)
 
 // Source Analysis
-Tool 4: gh repo clone owner/repo \${TMPDIR:-/tmp}/repo -- --depth 1
+Tool 5: gh repo clone owner/repo \${TMPDIR:-/tmp}/repo -- --depth 1
 
 // Context
-Tool 5: gh search issues "topic" --repo owner/repo
-
-// Optional: If web search is available, search for recent updates
+Tool 6: gh search issues "topic" --repo owner/repo
 \`\`\`
 
 ---
@@ -50423,7 +50486,11 @@ https://github.com/tanstack/query/blob/abc123def/packages/react-query/src/useQue
 
 | Purpose | Tool | Command/Usage |
 |---------|------|---------------|
-| **Official Docs** | context7 | \`context7_resolve-library-id\` \u2192 \`context7_get-library-docs\` |
+| **Official Docs** | context7 | \`context7_resolve-library-id\` \u2192 \`context7_query-docs\` |
+| **Find Docs URL** | websearch_exa | \`websearch_exa_web_search_exa("library official documentation")\` |
+| **Sitemap Discovery** | webfetch | \`webfetch(docs_url + "/sitemap.xml")\` to understand doc structure |
+| **Read Doc Page** | webfetch | \`webfetch(specific_doc_page)\` for targeted documentation |
+| **Latest Info** | websearch_exa | \`websearch_exa_web_search_exa("query 2025")\` |
 | **Fast Code Search** | grep_app | \`grep_app_searchGitHub(query, language, useRegexp)\` |
 | **Deep Code Search** | gh CLI | \`gh search code "query" --repo owner/repo\` |
 | **Clone Repo** | gh CLI | \`gh repo clone owner/repo \${TMPDIR:-/tmp}/name -- --depth 1\` |
@@ -50431,8 +50498,6 @@ https://github.com/tanstack/query/blob/abc123def/packages/react-query/src/useQue
 | **View Issue/PR** | gh CLI | \`gh issue/pr view <num> --repo owner/repo --comments\` |
 | **Release Info** | gh CLI | \`gh api repos/owner/repo/releases/latest\` |
 | **Git History** | git | \`git log\`, \`git blame\`, \`git show\` |
-| **Read URL** | webfetch | \`webfetch(url)\` for blog posts, SO threads |
-| **Web Search** | (if available) | Use any available web search tool for latest info |
 
 ### Temp Directory
 
@@ -50449,16 +50514,18 @@ Use OS-appropriate temp directory:
 
 ---
 
-## PARALLEL EXECUTION GUIDANCE
-
-When searching is needed, scale effort to question complexity:
+## PARALLEL EXECUTION REQUIREMENTS
 
-| Request Type | Suggested Calls |
+| Request Type | Suggested Calls | Doc Discovery Required |
 |--------------|----------------|
-| TYPE A (Conceptual) | 1-2 |
-| TYPE B (Implementation) | 2-3 |
-| TYPE C (Context) | 2-3 |
-| TYPE D (Comprehensive) | 3-5 |
+| TYPE A (Conceptual) | 1-2 | YES (Phase 0.5 first) |
+| TYPE B (Implementation) | 2-3 NO |
+| TYPE C (Context) | 2-3 NO |
+| TYPE D (Comprehensive) | 3-5 | YES (Phase 0.5 first) |
+| Request Type | Minimum Parallel Calls 
+
+**Doc Discovery is SEQUENTIAL** (websearch \u2192 version check \u2192 sitemap \u2192 investigate).
+**Main phase is PARALLEL** once you know where to look.
 
 **Always vary queries** when using grep_app:
 \`\`\`
@@ -50482,6 +50549,8 @@ grep_app_searchGitHub(query: "useQuery")
 | grep_app no results | Broaden query, try concept instead of exact name |
 | gh API rate limit | Use cloned repo in temp directory |
 | Repo not found | Search for forks or mirrors |
+| Sitemap not found | Try \`/sitemap-0.xml\`, \`/sitemap_index.xml\`, or fetch docs index page and parse navigation |
+| Versioned docs not found | Fall back to latest version, note this in response |
 | Uncertain | **STATE YOUR UNCERTAINTY**, propose hypothesis |
 
 ---
@@ -51249,15 +51318,19 @@ var metisRestrictions = createAgentToolRestrictions([
   "task",
   "sisyphus_task"
 ]);
-var metisAgent = {
-  description: "Pre-planning consultant that analyzes requests to identify hidden intentions, ambiguities, and AI failure points.",
-  mode: "subagent",
-  model: "anthropic/claude-opus-4-5",
-  temperature: 0.3,
-  ...metisRestrictions,
-  prompt: METIS_SYSTEM_PROMPT,
-  thinking: { type: "enabled", budgetTokens: 32000 }
-};
+var DEFAULT_MODEL8 = "anthropic/claude-opus-4-5";
+function createMetisAgent(model = DEFAULT_MODEL8) {
+  return {
+    description: "Pre-planning consultant that analyzes requests to identify hidden intentions, ambiguities, and AI failure points.",
+    mode: "subagent",
+    model,
+    temperature: 0.3,
+    ...metisRestrictions,
+    prompt: METIS_SYSTEM_PROMPT,
+    thinking: { type: "enabled", budgetTokens: 32000 }
+  };
+}
+var metisAgent = createMetisAgent();
 
 // src/agents/orchestrator-sisyphus.ts
 init_constants();
@@ -52664,6 +52737,7 @@ function buildDynamicOrchestratorPrompt(ctx) {
   const skillsSection = buildSkillsSection(skills);
   return ORCHESTRATOR_SISYPHUS_SYSTEM_PROMPT.replace("{CATEGORY_SECTION}", categorySection).replace("{AGENT_SECTION}", agentSection).replace("{DECISION_MATRIX}", decisionMatrix).replace("{SKILLS_SECTION}", skillsSection);
 }
+var DEFAULT_MODEL9 = "anthropic/claude-sonnet-4-5";
 function createOrchestratorSisyphusAgent(ctx) {
   const restrictions = createAgentToolRestrictions([
     "task",
@@ -52672,7 +52746,7 @@ function createOrchestratorSisyphusAgent(ctx) {
   return {
     description: "Orchestrates work via sisyphus_task() to complete ALL tasks in a todo list until fully done",
     mode: "primary",
-    model: "anthropic/claude-sonnet-4-5",
+    model: ctx?.model ?? DEFAULT_MODEL9,
     temperature: 0.1,
     prompt: buildDynamicOrchestratorPrompt(ctx),
     thinking: { type: "enabled", budgetTokens: 32000 },
@@ -52682,7 +52756,7 @@ function createOrchestratorSisyphusAgent(ctx) {
 var orchestratorSisyphusAgent = createOrchestratorSisyphusAgent();
 
 // src/agents/momus.ts
-var DEFAULT_MODEL8 = "openai/gpt-5.2";
+var DEFAULT_MODEL10 = "openai/gpt-5.2";
 var MOMUS_SYSTEM_PROMPT = `You are a work plan review expert. You review the provided work plan (.sisyphus/plans/{name}.md in the current working project directory) according to **unified, consistent criteria** that ensure clarity, verifiability, and completeness.
 
 **CRITICAL FIRST RULE**:
@@ -53012,7 +53086,7 @@ Use structured format, **in the same language as the work plan**.
 
 **Strike the right balance**: Prevent critical failures while empowering developer autonomy.
 `;
-function createMomusAgent(model = DEFAULT_MODEL8) {
+function createMomusAgent(model = DEFAULT_MODEL10) {
   const restrictions = createAgentToolRestrictions([
     "write",
     "edit",
@@ -53043,8 +53117,8 @@ var agentSources = {
   "frontend-ui-ux-engineer": createFrontendUiUxEngineerAgent,
   "document-writer": createDocumentWriterAgent,
   "multimodal-looker": createMultimodalLookerAgent,
-  "Metis (Plan Consultant)": metisAgent,
-  "Momus (Plan Reviewer)": momusAgent,
+  "Metis (Plan Consultant)": createMetisAgent,
+  "Momus (Plan Reviewer)": createMomusAgent,
   "orchestrator-sisyphus": orchestratorSisyphusAgent
 };
 var agentMetadata = {
@@ -53157,7 +53231,11 @@ function createBuiltinAgents(disabledAgents = [], agentOverrides = {}, directory
   }
   if (!disabledAgents.includes("orchestrator-sisyphus")) {
     const orchestratorOverride = agentOverrides["orchestrator-sisyphus"];
-    let orchestratorConfig = createOrchestratorSisyphusAgent({ availableAgents });
+    const orchestratorModel = orchestratorOverride?.model;
+    let orchestratorConfig = createOrchestratorSisyphusAgent({
+      model: orchestratorModel,
+      availableAgents
+    });
     if (orchestratorOverride) {
       orchestratorConfig = mergeAgentConfig(orchestratorConfig, orchestratorOverride);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reinamaccredy/oh-my-opencode",
-  "version": "1.0.1",
+  "version": "3.0.0-beta.3",
   "description": "Fork of oh-my-opencode with Maestro workflow integration - Multi-Model Orchestration, Parallel Background Agents, Design Phases, and TDD Methodology",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",