drizzy-agent 0.6.3 → 0.7.1

package/README.md

@@ -16,7 +16,7 @@ DrizzyAgent provides **discipline agents** that work together to complete coding
 | **Oracle** | Architecture consultant - debugging, complex logic decisions | GPT-5.4 / Kimi K2.5 / Gemini 3.1 Pro / Claude Opus 4.6 |
 | **Librarian** | Documentation/code search - external references, OSS examples | Gemini 3 Flash / GLM-4.7 / Claude Sonnet 4.5 |
 | **Explore** | Fast codebase grep - pattern discovery, cross-layer search | Custom resolver (Claude / Copilot / OpenAI) |
-| **Atlas** | Plan executor - runs Planner-generated plans step by step | Kimi K2.5 / Claude Sonnet 4.6 / GPT-5.4 / Gemini 3.1 Pro |
+| **Orchestrator** | Runs Planner-generated plans step by step | Kimi K2.5 / Claude Sonnet 4.6 / GPT-5.4 / Gemini 3.1 Pro |
 | **Researcher** | Deep research orchestrator - multi-source investigation with cited reports | Gemini 3.1 Pro / Kimi K2.5 / Claude Sonnet 4.6 / GPT-5.4 / GLM-4.7 Free |
 | **Coder Junior** | Delegated sub-tasks from Coder via category system | Claude Sonnet 4.6 / GPT-5.4 / Gemini 3 Flash |
 | **Researcher Junior** | Focused web research subagent for parallel sub-topic investigation | Kimi K2.5 / Claude Sonnet 4.6 / GPT-5.4 / GLM-4.7 Free |
@@ -24,7 +24,7 @@ DrizzyAgent provides **discipline agents** that work together to complete coding
 | **Plan Reviewer** | Plan quality review - verifiability, completeness checks | GPT-5.4 / Kimi K2.5 / Claude Opus 4.6 / Gemini 3.1 Pro |
 | **Multimodal Looker** | Image and visual analysis | GPT-5.4 / Kimi K2.5 / Gemini 3 Flash |
 
-Main selectable agents: **Coder**, **GPTCoder**, **Planner**, **Atlas**, **Researcher**.
+Main selectable agents: **Coder**, **GPTCoder**, **Planner**, **Orchestrator**, **Researcher**.
 Subagent-only specialists include **Researcher Junior**, **Oracle**, **Librarian**, **Explore**, and other focused helpers.
 
 ## Key Features
@@ -214,7 +214,7 @@ bun test
 
 ```
 src/
-├── agents/          # 13 agents (Coder, GPTCoder, Oracle, Librarian, Explore, Atlas, Planner, Researcher, Researcher Junior, Plan Consultant, Plan Reviewer, Coder Junior, Multimodal Looker)
+├── agents/          # 13 agents (Coder, GPTCoder, Oracle, Librarian, Explore, Orchestrator, Planner, Researcher, Researcher Junior, Plan Consultant, Plan Reviewer, Coder Junior, Multimodal Looker)
 ├── hooks/           # 46 lifecycle hooks
 ├── tools/           # 26 built-in tools
 ├── features/        # Core feature modules

package/dist/agents/builtin-agents/{atlas-agent.d.ts → orchestrator-agent.d.ts}

@@ -2,7 +2,7 @@ import type { AgentConfig } from "@opencode-ai/sdk";
 import type { AgentOverrides } from "../types";
 import type { CategoriesConfig, CategoryConfig } from "../../config/schema";
 import type { AvailableAgent, AvailableSkill } from "../dynamic-agent-prompt-builder";
-export declare function maybeCreateAtlasConfig(input: {
+export declare function maybeCreateOrchestratorConfig(input: {
     disabledAgents: string[];
     agentOverrides: AgentOverrides;
     uiSelectedModel?: string;

package/dist/agents/coder-junior/gpt-5-3-codex.d.ts

@@ -3,6 +3,6 @@
  *
 * GPTCoder-style prompt adapted for a focused executor:
  * - Same autonomy, reporting, parallelism, and tool usage patterns
- * - CAN spawn explore/librarian via call_omo_agent for research
+ * - CAN spawn explore/librarian via call_drizzy_agent for research
  */
 export declare function buildGpt53CodexCoderJuniorPrompt(useTaskSystem: boolean, promptAppend?: string): string;

package/dist/agents/coder-junior/gpt-5-4.d.ts

@@ -6,6 +6,6 @@
  * - Deterministic tool usage (always/never, not try/maybe)
  * - Prose-first output style
  * - Nuanced autonomy (focus unless directly conflicting)
- * - CAN spawn explore/librarian via call_omo_agent for research
+ * - CAN spawn explore/librarian via call_drizzy_agent for research
  */
 export declare function buildGpt54CoderJuniorPrompt(useTaskSystem: boolean, promptAppend?: string): string;

package/dist/agents/coder-junior/gpt.d.ts

@@ -3,7 +3,7 @@
  *
 * GPTCoder-style prompt adapted for a focused executor:
  * - Same autonomy, reporting, parallelism, and tool usage patterns
- * - CAN spawn explore/librarian via call_omo_agent for research
+ * - CAN spawn explore/librarian via call_drizzy_agent for research
  * - Used as fallback for GPT models without a model-specific prompt
  */
 export declare function buildGptCoderJuniorPrompt(useTaskSystem: boolean, promptAppend?: string): string;

package/dist/agents/env-context.d.ts

@@ -1,5 +1,5 @@
 /**
- * Creates OmO-specific environment context (timezone, locale).
+ * Creates Drizzy-specific environment context (timezone, locale).
  * Note: Working directory, platform, and date are already provided by OpenCode's system.ts,
  * so we only include fields that OpenCode doesn't provide to avoid duplication.
  * See: https://github.com/code-yeongyu/oh-my-openagent/issues/379

package/dist/agents/{atlas → orchestrator}/agent.d.ts

@@ -1,5 +1,5 @@
 /**
- * Atlas - Master Orchestrator Agent
+ * Orchestrator - Master Orchestrator Agent
  *
  * Orchestrates work via task() to complete ALL tasks in a todo list until fully done.
  * You are the conductor of a symphony of specialized agents.
@@ -13,11 +13,11 @@ import type { AgentConfig } from "@opencode-ai/sdk";
 import type { AgentPromptMetadata } from "../types";
 import type { AvailableAgent, AvailableSkill } from "../dynamic-agent-prompt-builder";
 import type { CategoryConfig } from "../../config/schema";
-export type AtlasPromptSource = "default" | "gpt" | "gemini";
+export type OrchestratorPromptSource = "default" | "gpt" | "gemini";
 /**
- * Determines which Atlas prompt to use based on model.
+ * Determines which Orchestrator prompt to use based on model.
  */
-export declare function getAtlasPromptSource(model?: string): AtlasPromptSource;
+export declare function getOrchestratorPromptSource(model?: string): OrchestratorPromptSource;
 export interface OrchestratorContext {
     model?: string;
     availableAgents?: AvailableAgent[];
@@ -25,11 +25,11 @@ export interface OrchestratorContext {
     userCategories?: Record<string, CategoryConfig>;
 }
 /**
- * Gets the appropriate Atlas prompt based on model.
+ * Gets the appropriate Orchestrator prompt based on model.
  */
-export declare function getAtlasPrompt(model?: string): string;
-export declare function createAtlasAgent(ctx: OrchestratorContext): AgentConfig;
-export declare namespace createAtlasAgent {
+export declare function getOrchestratorPrompt(model?: string): string;
+export declare function createOrchestratorAgent(ctx: OrchestratorContext): AgentConfig;
+export declare namespace createOrchestratorAgent {
     var mode: "all";
 }
-export declare const atlasPromptMetadata: AgentPromptMetadata;
+export declare const orchestratorPromptMetadata: AgentPromptMetadata;

package/dist/agents/{atlas → orchestrator}/default.d.ts

@@ -1,5 +1,5 @@
 /**
- * Default Atlas system prompt optimized for Claude series models.
+ * Default Orchestrator system prompt optimized for Claude series models.
  *
  * Key characteristics:
  * - Optimized for Claude's tendency to be "helpful" by forcing explicit delegation
@@ -7,5 +7,5 @@
  * - Detailed workflow steps with narrative context
  * - Extended reasoning sections
  */
-export declare const ATLAS_SYSTEM_PROMPT: string;
-export declare function getDefaultAtlasPrompt(): string;
+export declare const ORCHESTRATOR_SYSTEM_PROMPT: string;
+export declare function getDefaultOrchestratorPrompt(): string;

package/dist/agents/{atlas → orchestrator}/gemini.d.ts

@@ -1,5 +1,5 @@
 /**
- * Gemini-optimized Atlas System Prompt
+ * Gemini-optimized Orchestrator System Prompt
  *
  * Key differences from Claude/GPT variants:
  * - EXTREME delegation enforcement (Gemini strongly prefers doing work itself)
@@ -7,5 +7,5 @@
  * - Repeated tool-call mandates (Gemini skips tool calls in favor of reasoning)
  * - Consequence-driven framing (Gemini ignores soft warnings)
  */
-export declare const ATLAS_GEMINI_SYSTEM_PROMPT: string;
-export declare function getGeminiAtlasPrompt(): string;
+export declare const ORCHESTRATOR_GEMINI_SYSTEM_PROMPT: string;
+export declare function getGeminiOrchestratorPrompt(): string;

package/dist/agents/{atlas → orchestrator}/gpt.d.ts

@@ -1,5 +1,5 @@
 /**
- * GPT-5.4 Optimized Atlas System Prompt
+ * GPT-5.4 Optimized Orchestrator System Prompt
  *
  * Tuned for GPT-5.4 system prompt design principles:
  * - Prose-first output style
@@ -7,5 +7,5 @@
  * - XML-style section tags for clear structure
  * - Scope discipline (no extra features)
  */
-export declare const ATLAS_GPT_SYSTEM_PROMPT: string;
-export declare function getGptAtlasPrompt(): string;
+export declare const ORCHESTRATOR_GPT_SYSTEM_PROMPT: string;
+export declare function getGptOrchestratorPrompt(): string;

package/dist/agents/orchestrator/index.d.ts

@@ -0,0 +1,2 @@
+export { createOrchestratorAgent, orchestratorPromptMetadata } from "./agent";
+export type { OrchestratorPromptSource, OrchestratorContext } from "./agent";

package/dist/agents/{atlas → orchestrator}/prompt-section-builder.d.ts

@@ -1,5 +1,5 @@
 /**
- * Atlas Orchestrator - Shared Utilities
+ * Orchestrator Orchestrator - Shared Utilities
  *
  * Common functions for building dynamic prompt sections used by both
  * default (Claude-optimized) and GPT-optimized prompts.

package/dist/agents/types.d.ts

@@ -1,7 +1,7 @@
 import type { AgentConfig } from "@opencode-ai/sdk";
 /**
  * Agent mode determines UI model selection behavior:
- * - "primary": Respects user's UI-selected model (coder, atlas)
+ * - "primary": Respects user's UI-selected model (coder, orchestrator)
  * - "subagent": Uses own fallback chain, ignores UI selection (oracle, explore, etc.)
  * - "all": Available in both contexts (OpenCode compatibility)
  */
@@ -56,7 +56,7 @@ export declare function isGptModel(model: string): boolean;
 export declare function isGpt5_4Model(model: string): boolean;
 export declare function isGpt5_3CodexModel(model: string): boolean;
 export declare function isGeminiModel(model: string): boolean;
-export type BuiltinAgentName = "coder" | "gptcoder" | "oracle" | "librarian" | "explore" | "multimodal-looker" | "plan-consultant" | "plan-reviewer" | "atlas" | "coder-junior" | "researcher" | "researcher-junior";
+export type BuiltinAgentName = "coder" | "gptcoder" | "oracle" | "librarian" | "explore" | "multimodal-looker" | "plan-consultant" | "plan-reviewer" | "orchestrator" | "coder-junior" | "researcher" | "researcher-junior";
 export type OverridableAgentName = "build" | BuiltinAgentName;
 export type AgentName = BuiltinAgentName;
 export type AgentOverrideConfig = Partial<AgentConfig> & {

package/dist/cli/index.js

@@ -3488,7 +3488,7 @@ var init_agent_model_defaults = __esm(() => {
       ],
       includeInInstall: true
     },
-    atlas: {
+    orchestrator: {
       chain: [{ providers: ["kimi-for-coding"], model: "k2p5" }, { providers: CLAUDE_PROVIDERS, model: "claude-sonnet-4-6" }, { providers: CLAUDE_PROVIDERS, model: "claude-sonnet-4-5" }, { providers: OPENAI_PROVIDERS, model: "gpt-5.4", variant: "medium" }, { providers: GEMINI_PROVIDERS, model: "gemini-3.1-pro" }],
       includeInInstall: true
     },
@@ -20813,7 +20813,7 @@ var BuiltinAgentNameSchema = exports_external.enum([
   "multimodal-looker",
   "plan-consultant",
   "plan-reviewer",
-  "atlas",
+  "orchestrator",
   "coder-junior",
   "researcher",
   "researcher-junior"
@@ -20839,7 +20839,7 @@ var OverridableAgentNameSchema = exports_external.enum([
   "librarian",
   "explore",
   "multimodal-looker",
-  "atlas"
+  "orchestrator"
 ]);
 // src/config/schema/fallback-models.ts
 var FallbackModelsSchema = exports_external.union([exports_external.string(), exports_external.array(exports_external.string())]);
@@ -20909,7 +20909,7 @@ var AgentOverridesSchema = exports_external.object({
   librarian: AgentOverrideConfigSchema.optional(),
   explore: AgentOverrideConfigSchema.optional(),
   "multimodal-looker": AgentOverrideConfigSchema.optional(),
-  atlas: AgentOverrideConfigSchema.optional(),
+  orchestrator: AgentOverrideConfigSchema.optional(),
   researcher: AgentOverrideConfigSchema.optional(),
   "researcher-junior": AgentOverrideConfigSchema.optional()
 });
@@ -21095,7 +21095,7 @@ var HookNameSchema = exports_external.enum([
   "no-coder-gpt",
   "no-gptcoder-non-gpt",
   "start-work",
-  "atlas",
+  "orchestrator",
   "unstable-agent-babysitter",
   "task-resume-info",
   "stop-continuation-guard",
@@ -24036,8 +24036,8 @@ var AGENT_NAME_MAP = {
   planner: "planner",
   "Prometheus (Planner)": "planner",
   prometheus: "planner",
-  Atlas: "atlas",
-  atlas: "atlas",
+  Orchestrator: "orchestrator",
+  orchestrator: "orchestrator",
   "Plan Consultant": "plan-consultant",
   metis: "plan-consultant",
   "plan-consultant": "plan-consultant",
@@ -24063,7 +24063,7 @@ var BUILTIN_AGENT_NAMES = new Set([
   "plan-reviewer",
   "planner",
   "prometheus",
-  "atlas",
+  "orchestrator",
   "build"
 ]);
 function migrateAgentNames(agents) {
@@ -24081,7 +24081,7 @@ function migrateAgentNames(agents) {
 // src/shared/migration/hook-names.ts
 var HOOK_NAME_MAP = {
   "anthropic-auto-compact": "anthropic-context-window-limit-recovery",
-  "coder-orchestrator": "atlas",
+  "coder-orchestrator": "orchestrator",
   "coder-gpt-hephaestus-reminder": "no-coder-gpt",
   "no-coder-gpt": "no-coder-gpt",
   "coder-junior-notepad": "coder-junior-notepad",
@@ -24271,7 +24271,7 @@ var AGENT_DISPLAY_NAMES = {
   coder: "Coder",
   gptcoder: "GPTCoder",
   planner: "Planner",
-  atlas: "Atlas (Plan Executor)",
+  orchestrator: "Orchestrator",
   "coder-junior": "Coder Junior",
   planConsultant: "Plan Consultant",
   planReviewer: "Plan Reviewer",
@@ -24319,8 +24319,8 @@ var LEGACY_AGENT_REQUIREMENT_OVERRIDES = {
   gptcoder: {
     requiresProvider: AGENT_MODEL_DEFAULTS.gptcoder.requiresAnyProvider
   },
-  atlas: {
-    fallbackChain: pickFallbackEntries(AGENT_MODEL_DEFAULTS.atlas.chain, ["claude-sonnet-4-6", "gpt-5.4"])
+  orchestrator: {
+    fallbackChain: pickFallbackEntries(AGENT_MODEL_DEFAULTS.orchestrator.chain, ["claude-sonnet-4-6", "gpt-5.4"])
   }
 };
 var LEGACY_CATEGORY_REQUIREMENT_OVERRIDES = {
@@ -26376,7 +26376,7 @@ async function executeOnCompleteHook(options) {
 
 // src/cli/run/agent-resolver.ts
 var import_picocolors13 = __toESM(require_picocolors(), 1);
-var CORE_AGENT_ORDER = ["coder", "gptcoder", "planner", "atlas", "researcher"];
+var CORE_AGENT_ORDER = ["coder", "gptcoder", "planner", "orchestrator", "researcher"];
 var DEFAULT_AGENT = "coder";
 var normalizeAgentName = (agent) => {
   if (!agent)
@@ -29286,7 +29286,7 @@ function createMcpOAuthCommand() {
 // package.json
 var package_default = {
   name: "drizzy-agent",
-  version: "0.6.3",
+  version: "0.7.1",
   description: "DrizzyAgent - AI agent plugin for OpenCode",
   main: "dist/index.js",
   types: "dist/index.d.ts",
@@ -29362,17 +29362,17 @@ var package_default = {
     typescript: "^5.7.3"
   },
   optionalDependencies: {
-    "drizzy-agent-darwin-arm64": "0.6.3",
-    "drizzy-agent-darwin-x64": "0.6.3",
-    "drizzy-agent-darwin-x64-baseline": "0.6.3",
-    "drizzy-agent-linux-arm64": "0.6.3",
-    "drizzy-agent-linux-arm64-musl": "0.6.3",
-    "drizzy-agent-linux-x64": "0.6.3",
-    "drizzy-agent-linux-x64-baseline": "0.6.3",
-    "drizzy-agent-linux-x64-musl": "0.6.3",
-    "drizzy-agent-linux-x64-musl-baseline": "0.6.3",
-    "drizzy-agent-windows-x64": "0.6.3",
-    "drizzy-agent-windows-x64-baseline": "0.6.3"
+    "drizzy-agent-darwin-arm64": "0.7.1",
+    "drizzy-agent-darwin-x64": "0.7.1",
+    "drizzy-agent-darwin-x64-baseline": "0.7.1",
+    "drizzy-agent-linux-arm64": "0.7.1",
+    "drizzy-agent-linux-arm64-musl": "0.7.1",
+    "drizzy-agent-linux-x64": "0.7.1",
+    "drizzy-agent-linux-x64-baseline": "0.7.1",
+    "drizzy-agent-linux-x64-musl": "0.7.1",
+    "drizzy-agent-linux-x64-musl-baseline": "0.7.1",
+    "drizzy-agent-windows-x64": "0.7.1",
+    "drizzy-agent-windows-x64-baseline": "0.7.1"
   },
   overrides: {
     "@opencode-ai/sdk": "^1.2.24"
@@ -29436,7 +29436,7 @@ Agent resolution order:
   4) Coder (fallback)
 
 Available core agents:
-  Coder, GPTCoder, Planner, Atlas, Researcher
+  Coder, GPTCoder, Planner, Orchestrator, Researcher
 
 Unlike 'opencode run', this command waits until:
   - All todos are completed or cancelled

package/dist/config/schema/agent-names.d.ts

@@ -7,7 +7,7 @@ export declare const BuiltinAgentNameSchema: z.ZodEnum<{
     librarian: "librarian";
     explore: "explore";
     "multimodal-looker": "multimodal-looker";
-    atlas: "atlas";
+    orchestrator: "orchestrator";
     "coder-junior": "coder-junior";
     researcher: "researcher";
     "researcher-junior": "researcher-junior";
@@ -29,7 +29,7 @@ export declare const OverridableAgentNameSchema: z.ZodEnum<{
     librarian: "librarian";
     explore: "explore";
     "multimodal-looker": "multimodal-looker";
-    atlas: "atlas";
+    orchestrator: "orchestrator";
     "coder-junior": "coder-junior";
     "plan-consultant": "plan-consultant";
     "plan-reviewer": "plan-reviewer";
@@ -45,7 +45,7 @@ export declare const AgentNameSchema: z.ZodEnum<{
     librarian: "librarian";
     explore: "explore";
     "multimodal-looker": "multimodal-looker";
-    atlas: "atlas";
+    orchestrator: "orchestrator";
     "coder-junior": "coder-junior";
     researcher: "researcher";
     "researcher-junior": "researcher-junior";

package/dist/config/schema/agent-overrides.d.ts

@@ -1177,7 +1177,7 @@ export declare const AgentOverridesSchema: z.ZodObject<{
             variant: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-    atlas: z.ZodOptional<z.ZodObject<{
+    orchestrator: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
         fallback_models: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
         variant: z.ZodOptional<z.ZodString>;

package/dist/config/schema/drizzy-agent-config.d.ts

@@ -13,7 +13,7 @@ export declare const DrizzyAgentConfigSchema: z.ZodObject<{
         "git-master": "git-master";
     }>>>;
     disabled_hooks: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        atlas: "atlas";
+        orchestrator: "orchestrator";
         "ralph-loop": "ralph-loop";
         "start-work": "start-work";
         "gpt-permission-continuation": "gpt-permission-continuation";
@@ -1169,7 +1169,7 @@ export declare const DrizzyAgentConfigSchema: z.ZodObject<{
                 variant: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
-        atlas: z.ZodOptional<z.ZodObject<{
+        orchestrator: z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
             fallback_models: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
             variant: z.ZodOptional<z.ZodString>;

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

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export declare const HookNameSchema: z.ZodEnum<{
-    atlas: "atlas";
+    orchestrator: "orchestrator";
     "ralph-loop": "ralph-loop";
     "start-work": "start-work";
     "gpt-permission-continuation": "gpt-permission-continuation";

package/dist/create-hooks.d.ts

@@ -34,7 +34,7 @@ export declare function createHooks(args: {
     todoContinuationEnforcer: ReturnType<typeof import("./hooks").createTodoContinuationEnforcer> | null;
     unstableAgentBabysitter: ReturnType<typeof import("./plugin/unstable-agent-babysitter").createUnstableAgentBabysitter> | null;
     backgroundNotificationHook: ReturnType<typeof import("./hooks").createBackgroundNotificationHook> | null;
-    atlasHook: ReturnType<typeof import("./hooks").createAtlasHook> | null;
+    orchestratorHook: ReturnType<typeof import("./hooks").createOrchestratorHook> | null;
     claudeCodeHooks: ReturnType<typeof import("./hooks").createClaudeCodeHooksHook> | null;
     keywordDetector: ReturnType<typeof import("./hooks").createKeywordDetectorHook> | null;
     contextInjectorMessagesTransform: ReturnType<typeof import("./features/context-injector").createContextInjectorMessagesTransformHook>;

package/dist/drizzy-agent.schema.json

@@ -83,7 +83,7 @@
           "no-coder-gpt",
           "no-gptcoder-non-gpt",
           "start-work",
-          "atlas",
+          "orchestrator",
           "unstable-agent-babysitter",
           "task-resume-info",
           "stop-continuation-guard",
@@ -2977,7 +2977,7 @@
           },
           "additionalProperties": false
         },
-        "atlas": {
+        "orchestrator": {
           "type": "object",
           "properties": {
             "model": {

package/dist/features/boulder-state/types.d.ts

@@ -13,7 +13,7 @@ export interface BoulderState {
     session_ids: string[];
     /** Plan name derived from filename */
     plan_name: string;
-    /** Agent type to use when resuming (e.g., 'atlas') */
+    /** Agent type to use when resuming (e.g., 'orchestrator') */
     agent?: string;
     /** Absolute path to the git worktree root where work happens */
     worktree_path?: string;

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

@@ -1 +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// Find definition(s)\nLspGotoDefinition(filePath, line, character)  // Where is it defined?\n\n// Find ALL usages across workspace\nLspFindReferences(filePath, line, character, includeDeclaration=true)\n\n// Get file structure\nLspDocumentSymbols(filePath)  // Hierarchical outline\nLspWorkspaceSymbols(filePath, query=\"[target_symbol]\")  // Search by name\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 LSP tools for precision analysis. Key patterns:\n- **Understand before changing**: `LspGotoDefinition` to grasp context\n- **Impact analysis**: `LspFindReferences` 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`: Read-only consultation for complex architectural decisions and debugging\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";
+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_drizzy_agent`:\n\n```\n// Agent 1: Find the refactoring target\ncall_drizzy_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_drizzy_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_drizzy_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_drizzy_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_drizzy_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// Find definition(s)\nLspGotoDefinition(filePath, line, character)  // Where is it defined?\n\n// Find ALL usages across workspace\nLspFindReferences(filePath, line, character, includeDeclaration=true)\n\n// Get file structure\nLspDocumentSymbols(filePath)  // Hierarchical outline\nLspWorkspaceSymbols(filePath, query=\"[target_symbol]\")  // Search by name\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_drizzy_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 LSP tools for precision analysis. Key patterns:\n- **Understand before changing**: `LspGotoDefinition` to grasp context\n- **Impact analysis**: `LspFindReferences` 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`: Read-only consultation for complex architectural decisions and debugging\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/templates/start-work.d.ts

@@ -1 +1 @@
-export declare const START_WORK_TEMPLATE = "You are starting a Coder work session.\n\n## ARGUMENTS\n\n- `/start-work [plan-name] [--worktree <path>]`\n  - `plan-name` (optional): name or partial match of the plan to start\n  - `--worktree <path>` (optional): absolute path to an existing git worktree to work in\n    - If specified and valid: hook pre-sets worktree_path in boulder.json\n    - If specified but invalid: you must run `git worktree add <path> <branch>` first\n    - If omitted: you MUST choose or create a worktree (see Worktree Setup below)\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Planner-generated plan files at `.drizzy/plans/`\n\n2. **Check for active boulder state**: Read `.drizzy/boulder.json` if it exists\n\n3. **Decision logic**:\n   - If `.drizzy/boulder.json` exists AND plan is NOT complete (has unchecked boxes):\n     - **APPEND** current session to session_ids\n     - Continue work on existing plan\n   - If no active plan OR plan is complete:\n     - List available plan files\n     - If ONE plan: auto-select it\n     - If MULTIPLE plans: show list with timestamps, ask user to select\n\n4. **Worktree Setup** (when `worktree_path` not already set in boulder.json):\n   1. `git worktree list --porcelain` \u2014 see available worktrees\n   2. Create: `git worktree add <absolute-path> <branch-or-HEAD>`\n   3. Update boulder.json to add `\"worktree_path\": \"<absolute-path>\"`\n   4. All work happens inside that worktree directory\n\n5. **Create/Update boulder.json**:\n   ```json\n   {\n     \"active_plan\": \"/absolute/path/to/plan.md\",\n     \"started_at\": \"ISO_TIMESTAMP\",\n     \"session_ids\": [\"session_id_1\", \"session_id_2\"],\n     \"plan_name\": \"plan-name\",\n     \"worktree_path\": \"/absolute/path/to/git/worktree\"\n   }\n   ```\n\n6. **Read the plan file** and start executing tasks according to atlas workflow\n\n## OUTPUT FORMAT\n\nWhen listing plans for selection:\n```\nAvailable Work Plans\n\nCurrent Time: {ISO timestamp}\nSession ID: {current session id}\n\n1. [plan-name-1.md] - Modified: {date} - Progress: 3/10 tasks\n2. [plan-name-2.md] - Modified: {date} - Progress: 0/5 tasks\n\nWhich plan would you like to work on? (Enter number or plan name)\n```\n\nWhen resuming existing work:\n```\nResuming Work Session\n\nActive Plan: {plan-name}\nProgress: {completed}/{total} tasks\nSessions: {count} (appending current session)\nWorktree: {worktree_path}\n\nReading plan and continuing from last incomplete task...\n```\n\nWhen auto-selecting single plan:\n```\nStarting Work Session\n\nPlan: {plan-name}\nSession ID: {session_id}\nStarted: {timestamp}\nWorktree: {worktree_path}\n\nReading plan and beginning execution...\n```\n\n## CRITICAL\n\n- The session_id is injected by the hook - use it directly\n- Always update boulder.json BEFORE starting work\n- Always set worktree_path in boulder.json before executing any tasks\n- Read the FULL plan file before delegating any tasks\n- Follow atlas delegation protocols (7-section format)";
+export declare const START_WORK_TEMPLATE = "You are starting a Coder work session.\n\n## ARGUMENTS\n\n- `/start-work [plan-name] [--worktree <path>]`\n  - `plan-name` (optional): name or partial match of the plan to start\n  - `--worktree <path>` (optional): absolute path to an existing git worktree to work in\n    - If specified and valid: hook pre-sets worktree_path in boulder.json\n    - If specified but invalid: you must run `git worktree add <path> <branch>` first\n    - If omitted: you MUST choose or create a worktree (see Worktree Setup below)\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Planner-generated plan files at `.drizzy/plans/`\n\n2. **Check for active boulder state**: Read `.drizzy/boulder.json` if it exists\n\n3. **Decision logic**:\n   - If `.drizzy/boulder.json` exists AND plan is NOT complete (has unchecked boxes):\n     - **APPEND** current session to session_ids\n     - Continue work on existing plan\n   - If no active plan OR plan is complete:\n     - List available plan files\n     - If ONE plan: auto-select it\n     - If MULTIPLE plans: show list with timestamps, ask user to select\n\n4. **Worktree Setup** (when `worktree_path` not already set in boulder.json):\n   1. `git worktree list --porcelain` \u2014 see available worktrees\n   2. Create: `git worktree add <absolute-path> <branch-or-HEAD>`\n   3. Update boulder.json to add `\"worktree_path\": \"<absolute-path>\"`\n   4. All work happens inside that worktree directory\n\n5. **Create/Update boulder.json**:\n   ```json\n   {\n     \"active_plan\": \"/absolute/path/to/plan.md\",\n     \"started_at\": \"ISO_TIMESTAMP\",\n     \"session_ids\": [\"session_id_1\", \"session_id_2\"],\n     \"plan_name\": \"plan-name\",\n     \"worktree_path\": \"/absolute/path/to/git/worktree\"\n   }\n   ```\n\n6. **Read the plan file** and start executing tasks according to orchestrator workflow\n\n## OUTPUT FORMAT\n\nWhen listing plans for selection:\n```\nAvailable Work Plans\n\nCurrent Time: {ISO timestamp}\nSession ID: {current session id}\n\n1. [plan-name-1.md] - Modified: {date} - Progress: 3/10 tasks\n2. [plan-name-2.md] - Modified: {date} - Progress: 0/5 tasks\n\nWhich plan would you like to work on? (Enter number or plan name)\n```\n\nWhen resuming existing work:\n```\nResuming Work Session\n\nActive Plan: {plan-name}\nProgress: {completed}/{total} tasks\nSessions: {count} (appending current session)\nWorktree: {worktree_path}\n\nReading plan and continuing from last incomplete task...\n```\n\nWhen auto-selecting single plan:\n```\nStarting Work Session\n\nPlan: {plan-name}\nSession ID: {session_id}\nStarted: {timestamp}\nWorktree: {worktree_path}\n\nReading plan and beginning execution...\n```\n\n## CRITICAL\n\n- The session_id is injected by the hook - use it directly\n- Always update boulder.json BEFORE starting work\n- Always set worktree_path in boulder.json before executing any tasks\n- Read the FULL plan file before delegating any tasks\n- Follow orchestrator delegation protocols (7-section format)";

package/dist/features/hook-message-injector/injector.d.ts

@@ -52,7 +52,7 @@ export declare function generatePartId(): string;
  *
  * Features degraded on beta:
  * - Hook message injection (e.g., continuation prompts, context injection) won't persist
- * - Atlas hook's injected messages won't be visible in SQLite backend
+ * - Orchestrator hook's injected messages won't be visible in SQLite backend
  * - Todo continuation enforcer's injected prompts won't persist
  * - Ralph loop's continuation prompts won't persist
  *

package/dist/hooks/index.d.ts

@@ -35,7 +35,7 @@ export { createResearcherResearchOnlyHook } from "./researcher-research-only";
 export { createCoderJuniorNotepadHook } from "./coder-junior-notepad";
 export { createTaskResumeInfoHook } from "./task-resume-info";
 export { createStartWorkHook } from "./start-work";
-export { createAtlasHook } from "./atlas";
+export { createOrchestratorHook } from "./orchestrator";
 export { createDelegateTaskRetryHook } from "./delegate-task-retry";
 export { createQuestionLabelTruncatorHook } from "./question-label-truncator";
 export { createStopContinuationGuardHook, type StopContinuationGuard } from "./stop-continuation-guard";

package/dist/hooks/{atlas → orchestrator}/event-handler.d.ts

@@ -1,8 +1,8 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-import type { AtlasHookOptions, SessionState } from "./types";
-export declare function createAtlasEventHandler(input: {
+import type { OrchestratorHookOptions, SessionState } from "./types";
+export declare function createOrchestratorEventHandler(input: {
     ctx: PluginInput;
-    options?: AtlasHookOptions;
+    options?: OrchestratorHookOptions;
     sessions: Map<string, SessionState>;
     getState: (sessionID: string) => SessionState;
 }): (arg: {

package/dist/hooks/orchestrator/hook-name.d.ts

@@ -0,0 +1 @@
+export declare const HOOK_NAME = "orchestrator";

package/dist/hooks/orchestrator/idle-event.d.ts

@@ -0,0 +1,8 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { OrchestratorHookOptions, SessionState } from "./types";
+export declare function handleOrchestratorSessionIdle(input: {
+    ctx: PluginInput;
+    options?: OrchestratorHookOptions;
+    getState: (sessionID: string) => SessionState;
+    sessionID: string;
+}): Promise<void>;

package/dist/hooks/orchestrator/index.d.ts

@@ -0,0 +1,3 @@
+export { HOOK_NAME } from "./hook-name";
+export { createOrchestratorHook } from "./orchestrator-hook";
+export type { OrchestratorHookOptions } from "./types";

package/dist/hooks/{atlas/atlas-hook.d.ts → orchestrator/orchestrator-hook.d.ts}

@@ -1,6 +1,6 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-import type { AtlasHookOptions } from "./types";
-export declare function createAtlasHook(ctx: PluginInput, options?: AtlasHookOptions): {
+import type { OrchestratorHookOptions } from "./types";
+export declare function createOrchestratorHook(ctx: PluginInput, options?: OrchestratorHookOptions): {
     handler: (arg: {
         event: {
             type: string;