micode 0.4.0 → 0.5.0

package/dist/index.js

@@ -16,14 +16,12 @@ var brainstormerAgent = {
   mode: "primary",
   model: "anthropic/claude-opus-4-5",
   temperature: 0.7,
-  tools: { ask: true },
   prompt: `<purpose>
 Turn ideas into fully formed designs through natural collaborative dialogue.
 This is DESIGN ONLY. The planner agent handles detailed implementation plans.
 </purpose>
 
 <critical-rules>
-  <rule>ASK TOOL: Use the ask tool for EVERY question to the user. Never ask in plain text.</rule>
   <rule>NO CODE: Never write code. Never provide code examples. Design only.</rule>
   <rule>SUBAGENTS: Spawn multiple in parallel for codebase analysis.</rule>
   <rule>TOOLS (grep, read, etc.): Do NOT use directly - use subagents instead.</rule>
@@ -54,8 +52,6 @@ This is DESIGN ONLY. The planner agent handles detailed implementation plans.
     - codebase-analyzer: "Analyze existing [related feature]"
     - pattern-finder: "Find patterns for [similar functionality]"
   </spawn-example>
-  <rule>Use the ask tool for EVERY question - never plain text</rule>
-  <rule>Always provide MULTIPLE CHOICE options in the ask tool</rule>
   <focus>purpose, constraints, success criteria</focus>
 </phase>
 
@@ -91,9 +87,7 @@ This is DESIGN ONLY. The planner agent handles detailed implementation plans.
   <principle name="design-only">NO CODE. Describe components, not implementations. Planner writes code.</principle>
   <principle name="subagents-first">ALWAYS use subagents for code analysis, NEVER tools directly</principle>
   <principle name="parallel-spawn">Spawn multiple subagents in a SINGLE message</principle>
-  <principle name="ask-tool-always">ALWAYS use the ask tool for questions - never plain text</principle>
-  <principle name="one-question">Ask ONE question at a time via ask tool. Wait for answer.</principle>
-  <principle name="multiple-choice">Present 3-5 options in ask tool questions</principle>
+  <principle name="one-question">Ask ONE question at a time. Wait for answer.</principle>
   <principle name="yagni">Remove unnecessary features from ALL designs</principle>
   <principle name="explore-alternatives">ALWAYS propose 2-3 approaches before settling</principle>
   <principle name="incremental-validation">Present in sections, validate each before proceeding</principle>
@@ -763,14 +757,22 @@ Batch 3 (parallel):
     Executes ONE task from the plan.
     Input: Single task with context (which files, what to do).
     Output: Changes made and verification results for that task.
+    Invoke with: Task tool, subagent_type="implementer"
   </subagent>
   <subagent name="reviewer" spawn="parallel-per-task">
     Reviews ONE task's implementation.
     Input: Single task's changes against its requirements.
     Output: APPROVED or CHANGES REQUESTED for that task.
+    Invoke with: Task tool, subagent_type="reviewer"
   </subagent>
 </available-subagents>
 
+<critical-instruction>
+You MUST use the Task tool to spawn implementer and reviewer subagents.
+Example: Task(description="Implement task 1", prompt="...", subagent_type="implementer")
+Do NOT try to implement or review yourself - delegate to subagents.
+</critical-instruction>
+
 <per-task-cycle>
 For each task:
 1. Spawn implementer with task details
@@ -782,18 +784,17 @@ For each task:
 </per-task-cycle>
 
 <parallel-spawning>
-Within a batch, spawn ALL implementers in a SINGLE message:
-
-Example for batch with tasks 1, 2, 3:
-- In ONE message, spawn:
-  - implementer: "Execute task 1: [details]"
-  - implementer: "Execute task 2: [details]"
-  - implementer: "Execute task 3: [details]"
-
-Then after all complete, in ONE message spawn:
-  - reviewer: "Review task 1 implementation"
-  - reviewer: "Review task 2 implementation"
-  - reviewer: "Review task 3 implementation"
+Within a batch, spawn ALL implementers in a SINGLE message using the Task tool:
+
+Example for batch with tasks 1, 2, 3 - call Task tool 3 times in ONE message:
+- Task(description="Task 1", prompt="Execute task 1: [details]", subagent_type="implementer")
+- Task(description="Task 2", prompt="Execute task 2: [details]", subagent_type="implementer")
+- Task(description="Task 3", prompt="Execute task 3: [details]", subagent_type="implementer")
+
+Then after all complete, in ONE message call Task tool for reviewers:
+- Task(description="Review 1", prompt="Review task 1 implementation", subagent_type="reviewer")
+- Task(description="Review 2", prompt="Review task 2 implementation", subagent_type="reviewer")
+- Task(description="Review 3", prompt="Review task 3 implementation", subagent_type="reviewer")
 </parallel-spawning>
 
 <rules>
@@ -858,10 +859,6 @@ If you want exception to ANY rule, STOP and get explicit permission first.
 Breaking the letter or spirit of the rules is failure.
 </rule>
 
-<rule priority="critical">
-ALWAYS use the ask tool when you need user input. Never ask questions in plain text.
-</rule>
-
 <values>
 <value>Honesty. If you lie, you'll be replaced.</value>
 <value>Do it right, not fast. Never skip steps or take shortcuts.</value>
@@ -877,8 +874,6 @@ ALWAYS use the ask tool when you need user input. Never ask questions in plain t
 <rule>If uncomfortable pushing back, say "Strange things are afoot at the Circle K"</rule>
 <rule>STOP and ask for clarification rather than making assumptions</rule>
 <rule>STOP and ask for help when human input would be valuable</rule>
-<rule>ALWAYS use the ask tool when asking questions - never plain text</rule>
-<rule>Provide multiple-choice options in the ask tool whenever possible</rule>
 </relationship>
 
 <proactiveness>
@@ -960,8 +955,7 @@ var primaryAgent = {
     budgetTokens: 32000
   },
   maxTokens: 64000,
-  prompt: PROMPT,
-  tools: { ask: true }
+  prompt: PROMPT
 };
 var PRIMARY_AGENT_NAME = process.env.OPENCODE_AGENT_NAME || "commander";
 
@@ -1032,17 +1026,25 @@ var PROMPT2 = `
     <subagent name="codebase-locator" spawn="multiple">
       Fast file/pattern finder. Spawn multiple with different queries.
       Examples: "Find all entry points", "Find all config files", "Find test directories"
+      Invoke with: Task tool, subagent_type="codebase-locator"
     </subagent>
     <subagent name="codebase-analyzer" spawn="multiple">
       Deep module analyzer. Spawn multiple for different areas.
       Examples: "Analyze src/core", "Analyze api layer", "Analyze database module"
+      Invoke with: Task tool, subagent_type="codebase-analyzer"
     </subagent>
     <subagent name="pattern-finder" spawn="multiple">
       Pattern extractor. Spawn for different pattern types.
       Examples: "Find naming patterns", "Find error handling patterns", "Find async patterns"
+      Invoke with: Task tool, subagent_type="pattern-finder"
     </subagent>
   </available-subagents>
 
+  <critical-instruction>
+  You MUST use the Task tool to spawn subagents. Call multiple Task tools in a SINGLE message for parallelism.
+  Example: Task(description="Find entry points", prompt="Find all entry points and main files", subagent_type="codebase-locator")
+  </critical-instruction>
+
   <language-detection>
     <rule>Identify language(s) by examining file extensions and config files</rule>
     <markers>
@@ -1136,22 +1138,19 @@ var PROMPT2 = `
 
   <execution-example>
     <step description="Start with maximum parallelism">
-      In a SINGLE message, spawn:
-      - codebase-locator: "Find all entry points and main files"
-      - codebase-locator: "Find all config files (linters, formatters, build)"
-      - codebase-locator: "Find test directories and test files"
-      - codebase-analyzer: "Analyze the directory structure and organization"
-      - pattern-finder: "Find naming conventions used across the codebase"
-
-      AND run tools:
+      In a SINGLE message, call Task tool multiple times AND run other tools:
+      - Task(description="Find entry points", prompt="Find all entry points and main files", subagent_type="codebase-locator")
+      - Task(description="Find configs", prompt="Find all config files (linters, formatters, build)", subagent_type="codebase-locator")
+      - Task(description="Find tests", prompt="Find test directories and test files", subagent_type="codebase-locator")
+      - Task(description="Analyze structure", prompt="Analyze the directory structure and organization", subagent_type="codebase-analyzer")
+      - Task(description="Find patterns", prompt="Find naming conventions used across the codebase", subagent_type="pattern-finder")
       - Glob: package.json, pyproject.toml, go.mod, Cargo.toml, etc.
       - Glob: README*, ARCHITECTURE*, docs/*
-      - Bash: ls -la (root directory)
     </step>
 
     <step description="Parallel deep analysis">
-      Based on discovery, in a SINGLE message spawn:
-      - codebase-analyzer for each major module found
+      Based on discovery, in a SINGLE message:
+      - Task for each major module: subagent_type="codebase-analyzer"
       - Read multiple source files simultaneously
       - Read multiple test files simultaneously
     </step>
@@ -13826,6 +13825,69 @@ ${output}`;
   }
 });
 
+// src/tools/btca/index.ts
+var {spawn: spawn2, which: which2 } = globalThis.Bun;
+async function checkBtcaAvailable() {
+  const btcaPath = which2("btca");
+  if (btcaPath) {
+    return { available: true };
+  }
+  return {
+    available: false,
+    message: `btca CLI not found. Library source code search will not work.
+` + `Install from: https://github.com/anthropics/btca
+` + "  cargo install btca"
+  };
+}
+var BTCA_TIMEOUT_MS = 120000;
+async function runBtca(args) {
+  try {
+    const proc = spawn2(["btca", ...args], {
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+    const timeoutPromise = new Promise((_, reject) => {
+      setTimeout(() => {
+        proc.kill();
+        reject(new Error("btca command timed out after 2 minutes"));
+      }, BTCA_TIMEOUT_MS);
+    });
+    const [stdout, stderr, exitCode] = await Promise.race([
+      Promise.all([new Response(proc.stdout).text(), new Response(proc.stderr).text(), proc.exited]),
+      timeoutPromise
+    ]);
+    if (exitCode !== 0) {
+      const errorMsg = stderr.trim() || `Exit code ${exitCode}`;
+      return { output: "", error: errorMsg };
+    }
+    return { output: stdout.trim() };
+  } catch (e) {
+    const err = e;
+    if (err.message?.includes("ENOENT")) {
+      return {
+        output: "",
+        error: `btca CLI not found. Install from: https://github.com/anthropics/btca
+` + "  cargo install btca"
+      };
+    }
+    return { output: "", error: err.message };
+  }
+}
+var btca_ask = tool({
+  description: "Ask questions about library/framework source code using btca. " + "Clones repos locally and searches source code to answer questions. " + "Use for understanding library internals, finding implementation details, or debugging.",
+  args: {
+    tech: tool.schema.string().describe("Resource name configured in btca (e.g., 'react', 'express')"),
+    question: tool.schema.string().describe("Question to ask about the library source code")
+  },
+  execute: async (args) => {
+    const result = await runBtca(["ask", "-t", args.tech, "-q", args.question]);
+    if (result.error) {
+      return `Error: ${result.error}`;
+    }
+    return result.output || "No answer found";
+  }
+});
+
 // src/tools/look-at.ts
 import { readFileSync, statSync } from "fs";
 import { extname, basename } from "path";
@@ -14850,20 +14912,22 @@ function createTokenAwareTruncationHook(ctx) {
   };
 }
 
-// src/hooks/context-window-monitor.ts
-var WARNING_THRESHOLD = 0.7;
-var CRITICAL_THRESHOLD = 0.85;
-var DEFAULT_CONTEXT_LIMIT2 = 200000;
+// src/utils/model-limits.ts
 var MODEL_CONTEXT_LIMITS = {
   "claude-opus": 200000,
   "claude-sonnet": 200000,
   "claude-haiku": 200000,
+  "claude-3": 200000,
+  "claude-4": 200000,
+  "gpt-4o": 128000,
+  "gpt-4-turbo": 128000,
   "gpt-4": 128000,
   "gpt-5": 200000,
   o1: 200000,
   o3: 200000,
   gemini: 1e6
 };
+var DEFAULT_CONTEXT_LIMIT2 = 200000;
 function getContextLimit(modelID) {
   const modelLower = modelID.toLowerCase();
   for (const [pattern, limit] of Object.entries(MODEL_CONTEXT_LIMITS)) {
@@ -14873,6 +14937,10 @@ function getContextLimit(modelID) {
   }
   return DEFAULT_CONTEXT_LIMIT2;
 }
+
+// src/hooks/context-window-monitor.ts
+var WARNING_THRESHOLD = 0.7;
+var CRITICAL_THRESHOLD = 0.85;
 var WARNING_COOLDOWN_MS = 120000;
 function createContextWindowMonitorHook(ctx) {
   const state = {
@@ -15151,33 +15219,9 @@ function createFileOpsTrackerHook(_ctx) {
 }
 
 // src/hooks/auto-clear-ledger.ts
-var MODEL_CONTEXT_LIMITS2 = {
-  "claude-opus": 200000,
-  "claude-sonnet": 200000,
-  "claude-haiku": 200000,
-  "claude-3": 200000,
-  "claude-4": 200000,
-  "gpt-4o": 128000,
-  "gpt-4-turbo": 128000,
-  "gpt-4": 128000,
-  "gpt-5": 200000,
-  o1: 200000,
-  o3: 200000,
-  gemini: 1e6
-};
-var DEFAULT_CONTEXT_LIMIT3 = 200000;
 var DEFAULT_THRESHOLD = 0.8;
 var MIN_TOKENS_FOR_CLEAR = 50000;
 var CLEAR_COOLDOWN_MS = 60000;
-function getContextLimit2(modelID) {
-  const modelLower = modelID.toLowerCase();
-  for (const [pattern, limit] of Object.entries(MODEL_CONTEXT_LIMITS2)) {
-    if (modelLower.includes(pattern)) {
-      return limit;
-    }
-  }
-  return DEFAULT_CONTEXT_LIMIT3;
-}
 function createAutoClearLedgerHook(ctx) {
   const state = {
     lastClearTime: new Map,
@@ -15212,7 +15256,7 @@ function createAutoClearLedgerHook(ctx) {
       if (totalUsed < MIN_TOKENS_FOR_CLEAR)
         return;
       const model = modelID || info?.modelID || "";
-      const contextLimit = getContextLimit2(model);
+      const contextLimit = getContextLimit(model);
       const usageRatio = totalUsed / contextLimit;
       if (usageRatio < DEFAULT_THRESHOLD)
         return;
@@ -15911,6 +15955,10 @@ var OpenCodeConfigPlugin = async (ctx) => {
   if (!astGrepStatus.available) {
     console.warn(`[micode] ${astGrepStatus.message}`);
   }
+  const btcaStatus = await checkBtcaAvailable();
+  if (!btcaStatus.available) {
+    console.warn(`[micode] ${btcaStatus.message}`);
+  }
   const userConfig = await loadMicodeConfig();
   if (userConfig?.agents) {
     console.log(`[micode] Loaded model overrides for: ${Object.keys(userConfig.agents).join(", ")}`);
@@ -15932,6 +15980,7 @@ var OpenCodeConfigPlugin = async (ctx) => {
     tool: {
       ast_grep_search,
       ast_grep_replace,
+      btca_ask,
       look_at,
       artifact_search,
       ...backgroundTaskTools
@@ -15947,11 +15996,13 @@ var OpenCodeConfigPlugin = async (ctx) => {
       };
       const mergedAgents = mergeAgentConfigs(agents, userConfig);
       config2.agent = {
-        [PRIMARY_AGENT_NAME]: mergedAgents[PRIMARY_AGENT_NAME],
-        ...Object.fromEntries(Object.entries(mergedAgents).filter(([k]) => k !== PRIMARY_AGENT_NAME)),
         ...config2.agent,
         build: { ...config2.agent?.build, mode: "subagent" },
-        plan: { ...config2.agent?.plan, mode: "subagent" }
+        plan: { ...config2.agent?.plan, mode: "subagent" },
+        triage: { ...config2.agent?.triage, mode: "subagent" },
+        docs: { ...config2.agent?.docs, mode: "subagent" },
+        ...Object.fromEntries(Object.entries(mergedAgents).filter(([k]) => k !== PRIMARY_AGENT_NAME)),
+        [PRIMARY_AGENT_NAME]: mergedAgents[PRIMARY_AGENT_NAME]
       };
       config2.mcp = {
         ...config2.mcp,

package/dist/tools/btca/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Check if btca CLI is available on the system.
+ * Returns installation instructions if not found.
+ */
+export declare function checkBtcaAvailable(): Promise<{
+    available: boolean;
+    message?: string;
+}>;
+export declare const btca_ask: {
+    description: string;
+    args: {
+        tech: import("zod").ZodString;
+        question: import("zod").ZodString;
+    };
+    execute(args: {
+        tech: string;
+        question: string;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};

package/dist/utils/model-limits.d.ts

@@ -0,0 +1,7 @@
+export declare const MODEL_CONTEXT_LIMITS: Record<string, number>;
+export declare const DEFAULT_CONTEXT_LIMIT = 200000;
+/**
+ * Get the context window limit for a given model ID.
+ * Matches against known patterns and falls back to default.
+ */
+export declare function getContextLimit(modelID: string): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "micode",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "OpenCode plugin with Brainstorm-Research-Plan-Implement workflow",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -44,7 +44,7 @@
     "url": "https://github.com/vtemian/micode/issues"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "1.0.207"
+    "@opencode-ai/plugin": "^1.0.219"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.10",