@hiai-gg/hiai-opencode 0.2.0 → 0.2.2

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

@@ -1153,134 +1153,6 @@ export declare const AgentOverridesSchema: z.ZodObject<{
             variant: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-    multimodal: z.ZodOptional<z.ZodObject<{
-        model: z.ZodOptional<z.ZodString>;
-        fallback_models: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
-            model: z.ZodString;
-            variant: z.ZodOptional<z.ZodString>;
-            reasoningEffort: z.ZodOptional<z.ZodEnum<{
-                none: "none";
-                minimal: "minimal";
-                low: "low";
-                medium: "medium";
-                high: "high";
-                xhigh: "xhigh";
-            }>>;
-            temperature: z.ZodOptional<z.ZodNumber>;
-            top_p: z.ZodOptional<z.ZodNumber>;
-            maxTokens: z.ZodOptional<z.ZodNumber>;
-            thinking: z.ZodOptional<z.ZodObject<{
-                type: z.ZodEnum<{
-                    enabled: "enabled";
-                    disabled: "disabled";
-                }>;
-                budgetTokens: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            model: z.ZodString;
-            variant: z.ZodOptional<z.ZodString>;
-            reasoningEffort: z.ZodOptional<z.ZodEnum<{
-                none: "none";
-                minimal: "minimal";
-                low: "low";
-                medium: "medium";
-                high: "high";
-                xhigh: "xhigh";
-            }>>;
-            temperature: z.ZodOptional<z.ZodNumber>;
-            top_p: z.ZodOptional<z.ZodNumber>;
-            maxTokens: z.ZodOptional<z.ZodNumber>;
-            thinking: z.ZodOptional<z.ZodObject<{
-                type: z.ZodEnum<{
-                    enabled: "enabled";
-                    disabled: "disabled";
-                }>;
-                budgetTokens: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>]>>]>>;
-        variant: z.ZodOptional<z.ZodString>;
-        category: z.ZodOptional<z.ZodString>;
-        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        temperature: z.ZodOptional<z.ZodNumber>;
-        top_p: z.ZodOptional<z.ZodNumber>;
-        prompt: z.ZodOptional<z.ZodString>;
-        prompt_append: z.ZodOptional<z.ZodString>;
-        tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
-        disable: z.ZodOptional<z.ZodBoolean>;
-        description: z.ZodOptional<z.ZodString>;
-        mode: z.ZodOptional<z.ZodEnum<{
-            primary: "primary";
-            subagent: "subagent";
-            all: "all";
-        }>>;
-        color: z.ZodOptional<z.ZodString>;
-        permission: z.ZodOptional<z.ZodObject<{
-            edit: z.ZodOptional<z.ZodEnum<{
-                allow: "allow";
-                deny: "deny";
-                ask: "ask";
-            }>>;
-            bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                allow: "allow";
-                deny: "deny";
-                ask: "ask";
-            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
-                allow: "allow";
-                deny: "deny";
-                ask: "ask";
-            }>>]>>;
-            webfetch: z.ZodOptional<z.ZodEnum<{
-                allow: "allow";
-                deny: "deny";
-                ask: "ask";
-            }>>;
-            task: z.ZodOptional<z.ZodEnum<{
-                allow: "allow";
-                deny: "deny";
-                ask: "ask";
-            }>>;
-            doom_loop: z.ZodOptional<z.ZodEnum<{
-                allow: "allow";
-                deny: "deny";
-                ask: "ask";
-            }>>;
-            external_directory: z.ZodOptional<z.ZodEnum<{
-                allow: "allow";
-                deny: "deny";
-                ask: "ask";
-            }>>;
-        }, z.core.$strip>>;
-        maxTokens: z.ZodOptional<z.ZodNumber>;
-        thinking: z.ZodOptional<z.ZodObject<{
-            type: z.ZodEnum<{
-                enabled: "enabled";
-                disabled: "disabled";
-            }>;
-            budgetTokens: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-        reasoningEffort: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            minimal: "minimal";
-            low: "low";
-            medium: "medium";
-            high: "high";
-            xhigh: "xhigh";
-        }>>;
-        textVerbosity: z.ZodOptional<z.ZodEnum<{
-            low: "low";
-            medium: "medium";
-            high: "high";
-        }>>;
-        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        ultrawork: z.ZodOptional<z.ZodObject<{
-            model: z.ZodOptional<z.ZodString>;
-            variant: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-        compaction: z.ZodOptional<z.ZodObject<{
-            model: z.ZodOptional<z.ZodString>;
-            variant: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
     "quality-guardian": z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
         fallback_models: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{

package/dist/config/schema/hiai-opencode-config.d.ts

@@ -1057,134 +1057,6 @@ export declare const HiaiOpenCodeConfigSchema: z.ZodObject<{
                 variant: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
-        multimodal: z.ZodOptional<z.ZodObject<{
-            model: z.ZodOptional<z.ZodString>;
-            fallback_models: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
-                model: z.ZodString;
-                variant: z.ZodOptional<z.ZodString>;
-                reasoningEffort: z.ZodOptional<z.ZodEnum<{
-                    none: "none";
-                    minimal: "minimal";
-                    low: "low";
-                    medium: "medium";
-                    high: "high";
-                    xhigh: "xhigh";
-                }>>;
-                temperature: z.ZodOptional<z.ZodNumber>;
-                top_p: z.ZodOptional<z.ZodNumber>;
-                maxTokens: z.ZodOptional<z.ZodNumber>;
-                thinking: z.ZodOptional<z.ZodObject<{
-                    type: z.ZodEnum<{
-                        enabled: "enabled";
-                        disabled: "disabled";
-                    }>;
-                    budgetTokens: z.ZodOptional<z.ZodNumber>;
-                }, z.core.$strip>>;
-            }, z.core.$strip>>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-                model: z.ZodString;
-                variant: z.ZodOptional<z.ZodString>;
-                reasoningEffort: z.ZodOptional<z.ZodEnum<{
-                    none: "none";
-                    minimal: "minimal";
-                    low: "low";
-                    medium: "medium";
-                    high: "high";
-                    xhigh: "xhigh";
-                }>>;
-                temperature: z.ZodOptional<z.ZodNumber>;
-                top_p: z.ZodOptional<z.ZodNumber>;
-                maxTokens: z.ZodOptional<z.ZodNumber>;
-                thinking: z.ZodOptional<z.ZodObject<{
-                    type: z.ZodEnum<{
-                        enabled: "enabled";
-                        disabled: "disabled";
-                    }>;
-                    budgetTokens: z.ZodOptional<z.ZodNumber>;
-                }, z.core.$strip>>;
-            }, z.core.$strip>]>>]>>;
-            variant: z.ZodOptional<z.ZodString>;
-            category: z.ZodOptional<z.ZodString>;
-            skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            temperature: z.ZodOptional<z.ZodNumber>;
-            top_p: z.ZodOptional<z.ZodNumber>;
-            prompt: z.ZodOptional<z.ZodString>;
-            prompt_append: z.ZodOptional<z.ZodString>;
-            tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
-            disable: z.ZodOptional<z.ZodBoolean>;
-            description: z.ZodOptional<z.ZodString>;
-            mode: z.ZodOptional<z.ZodEnum<{
-                primary: "primary";
-                subagent: "subagent";
-                all: "all";
-            }>>;
-            color: z.ZodOptional<z.ZodString>;
-            permission: z.ZodOptional<z.ZodObject<{
-                edit: z.ZodOptional<z.ZodEnum<{
-                    allow: "allow";
-                    deny: "deny";
-                    ask: "ask";
-                }>>;
-                bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                    allow: "allow";
-                    deny: "deny";
-                    ask: "ask";
-                }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
-                    allow: "allow";
-                    deny: "deny";
-                    ask: "ask";
-                }>>]>>;
-                webfetch: z.ZodOptional<z.ZodEnum<{
-                    allow: "allow";
-                    deny: "deny";
-                    ask: "ask";
-                }>>;
-                task: z.ZodOptional<z.ZodEnum<{
-                    allow: "allow";
-                    deny: "deny";
-                    ask: "ask";
-                }>>;
-                doom_loop: z.ZodOptional<z.ZodEnum<{
-                    allow: "allow";
-                    deny: "deny";
-                    ask: "ask";
-                }>>;
-                external_directory: z.ZodOptional<z.ZodEnum<{
-                    allow: "allow";
-                    deny: "deny";
-                    ask: "ask";
-                }>>;
-            }, z.core.$strip>>;
-            maxTokens: z.ZodOptional<z.ZodNumber>;
-            thinking: z.ZodOptional<z.ZodObject<{
-                type: z.ZodEnum<{
-                    enabled: "enabled";
-                    disabled: "disabled";
-                }>;
-                budgetTokens: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>;
-            reasoningEffort: z.ZodOptional<z.ZodEnum<{
-                none: "none";
-                minimal: "minimal";
-                low: "low";
-                medium: "medium";
-                high: "high";
-                xhigh: "xhigh";
-            }>>;
-            textVerbosity: z.ZodOptional<z.ZodEnum<{
-                low: "low";
-                medium: "medium";
-                high: "high";
-            }>>;
-            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            ultrawork: z.ZodOptional<z.ZodObject<{
-                model: z.ZodOptional<z.ZodString>;
-                variant: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>;
-            compaction: z.ZodOptional<z.ZodObject<{
-                model: z.ZodOptional<z.ZodString>;
-                variant: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
         "quality-guardian": z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
             fallback_models: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{

package/dist/config/types.d.ts

@@ -22,9 +22,9 @@ export interface ModelSlotsConfig {
     vision?: ModelSlotConfig;
     sub?: ModelSlotConfig;
 }
-export declare const CANONICAL_AGENT_NAMES: readonly ["bob", "manager", "strategist", "critic", "coder", "designer", "sub", "researcher", "multimodal", "quality-guardian", "writer", "agent-skills"];
+export declare const CANONICAL_AGENT_NAMES: readonly ["bob", "manager", "strategist", "critic", "coder", "designer", "sub", "researcher", "vision", "quality-guardian", "writer", "agent-skills"];
 export type CanonicalAgentName = (typeof CANONICAL_AGENT_NAMES)[number];
-export declare const LEGACY_AGENT_ALIAS_NAMES: readonly ["general", "zoe", "build", "pre-plan", "vision", "logician", "librarian", "explore", "ui", "code-reviewer", "systematic-debugger", "mindmodel", "ledger-creator", "bootstrapper", "project-initializer", "guard", "brainstormer"];
+export declare const LEGACY_AGENT_ALIAS_NAMES: readonly ["general", "zoe", "build", "pre-plan", "multimodal", "ui", "logician", "librarian", "explore", "code-reviewer", "systematic-debugger", "mindmodel", "ledger-creator", "bootstrapper", "project-initializer", "guard", "brainstormer"];
 export type LegacyAgentAliasName = (typeof LEGACY_AGENT_ALIAS_NAMES)[number];
 export declare const LEGACY_AGENT_ALIAS_TO_CANONICAL: Record<LegacyAgentAliasName, CanonicalAgentName>;
 export type KnownAgentName = CanonicalAgentName | LegacyAgentAliasName;

package/dist/features/background-agent/error-classifier.d.ts

@@ -1,5 +1,6 @@
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
 export declare function isAbortedSessionError(error: unknown): boolean;
+export declare function isRecoverablePromptInjectionError(error: unknown): boolean;
 export declare function getErrorText(error: unknown): string;
 export declare function extractErrorName(error: unknown): string | undefined;
 export declare function extractErrorMessage(error: unknown): string | undefined;

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

@@ -0,0 +1,46 @@
+import type { BackgroundTask } from "./types";
+import type { BackgroundTaskNotificationTask } from "./background-task-notification-template";
+export interface NotifierAdapter {
+    client: {
+        session: {
+            messages: (input: {
+                path: {
+                    id: string;
+                };
+            }) => Promise<unknown>;
+            promptAsync: (input: {
+                path: {
+                    id: string;
+                };
+                body: {
+                    noReply?: boolean;
+                    agent?: string;
+                    model?: {
+                        providerID: string;
+                        modelID: string;
+                    };
+                    variant?: string;
+                    tools?: Record<string, boolean | "allow" | "deny" | "ask">;
+                    parts: Array<{
+                        type: "text";
+                        text: string;
+                    }>;
+                };
+            }) => Promise<unknown>;
+        };
+    };
+    directory: string;
+    enableParentSessionNotifications: boolean;
+    tasks: Map<string, BackgroundTask>;
+    completedTaskSummaries: Map<string, BackgroundTaskNotificationTask[]>;
+    pendingByParent: Map<string, Set<string>>;
+    pendingNotifications: Map<string, string[]>;
+    notificationQueueByParent: Map<string, Promise<void>>;
+    queuePendingNotification: (parentSessionID: string, notification: string) => void;
+    scheduleTaskRemoval: (taskId: string, rescheduleCount?: number) => void;
+    clearNotificationsForTask: (taskId: string) => void;
+    cleanupPendingByParent: (task: BackgroundTask) => void;
+    getTasksByParentSession: (sessionID: string) => BackgroundTask[];
+}
+export declare function enqueueNotificationForParent(adapter: NotifierAdapter, parentSessionID: string | undefined, operation: () => Promise<void>): Promise<void>;
+export declare function notifyParentSession(adapter: NotifierAdapter, task: BackgroundTask): Promise<void>;

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

@@ -0,0 +1,40 @@
+import type { BackgroundTask, LaunchInput } from "./types";
+export interface MessagePartInfo {
+    id?: string;
+    sessionID?: string;
+    type?: string;
+    tool?: string;
+    state?: {
+        status?: string;
+        input?: Record<string, unknown>;
+    };
+}
+export interface EventProperties {
+    sessionID?: string;
+    info?: {
+        id?: string;
+    };
+    [key: string]: unknown;
+}
+export interface BackgroundEvent {
+    type: string;
+    properties?: EventProperties;
+}
+export interface Todo {
+    content: string;
+    status: string;
+    priority: string;
+    id: string;
+}
+export interface QueueItem {
+    task: BackgroundTask;
+    input: LaunchInput;
+}
+export interface SubagentSessionCreatedEvent {
+    sessionID: string;
+    parentID: string;
+    title: string;
+}
+export type OnSubagentSessionCreated = (event: SubagentSessionCreatedEvent) => Promise<void>;
+export declare const MAX_TASK_REMOVAL_RESCHEDULES = 6;
+export declare function resolveMessagePartInfo(properties: EventProperties | undefined): MessagePartInfo | undefined;

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

@@ -3,23 +3,8 @@ import type { BackgroundTask, LaunchInput, ResumeInput } from "./types";
 import { TaskHistory } from "./task-history";
 import type { BackgroundTaskConfig, TmuxConfig } from "../../config/schema";
 import { type SubagentSpawnContext } from "./subagent-spawn-limits";
-interface EventProperties {
-    sessionID?: string;
-    info?: {
-        id?: string;
-    };
-    [key: string]: unknown;
-}
-interface Event {
-    type: string;
-    properties?: EventProperties;
-}
-export interface SubagentSessionCreatedEvent {
-    sessionID: string;
-    parentID: string;
-    title: string;
-}
-export type OnSubagentSessionCreated = (event: SubagentSessionCreatedEvent) => Promise<void>;
+import type { OnSubagentSessionCreated, BackgroundEvent } from "./manager-types";
+export type { SubagentSessionCreatedEvent, OnSubagentSessionCreated } from "./manager-types";
 export declare class BackgroundManager {
     private tasks;
     private notifications;
@@ -94,7 +79,7 @@ export declare class BackgroundManager {
     private clearSessionOutputObserved;
     private clearSessionTodoObservation;
     private hasOutputSignalFromPart;
-    handleEvent(event: Event): void;
+    handleEvent(event: BackgroundEvent): void;
     private handleSessionErrorEvent;
     private tryFallbackRetry;
     markForNotification(task: BackgroundTask): void;
@@ -164,4 +149,3 @@ export declare class BackgroundManager {
     shutdown(): Promise<void>;
     private enqueueNotificationForParent;
 }
-export {};

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

@@ -0,0 +1,51 @@
+import type { BackgroundTaskConfig } from "../../config/schema";
+import type { ConcurrencyManager } from "./concurrency";
+import type { TaskHistory } from "./task-history";
+import { checkAndInterruptStaleTasks } from "./task-poller";
+import type { BackgroundTask, LaunchInput } from "./types";
+type OpencodeClient = Parameters<typeof checkAndInterruptStaleTasks>[0]["client"];
+interface QueueItem {
+    task: BackgroundTask;
+    input: LaunchInput;
+}
+export interface PollingManagerAdapter {
+    readonly tasks: Map<string, BackgroundTask>;
+    readonly notifications: Map<string, BackgroundTask[]>;
+    readonly client: OpencodeClient;
+    readonly directory: string;
+    readonly config?: BackgroundTaskConfig;
+    readonly concurrencyManager: ConcurrencyManager;
+    readonly taskHistory: TaskHistory;
+    readonly queuesByKey: Map<string, QueueItem[]>;
+    readonly completionTimers: Map<string, ReturnType<typeof setTimeout>>;
+    readonly idleDeferralTimers: Map<string, ReturnType<typeof setTimeout>>;
+    tryFallbackRetry(task: BackgroundTask, errorInfo: {
+        name?: string;
+        message?: string;
+    }, source: string): Promise<boolean>;
+    tryCompleteTask(task: BackgroundTask, source: string): Promise<boolean>;
+    validateSessionHasOutput(sessionID: string): Promise<boolean>;
+    checkSessionTodos(sessionID: string): Promise<boolean>;
+    enqueueNotificationForParent(parentSessionID: string | undefined, operation: () => Promise<void>): Promise<void>;
+    notifyParentSession(task: BackgroundTask): Promise<void>;
+    unregisterRootDescendant(rootSessionID: string): void;
+    cleanupPendingByParent(task: BackgroundTask): void;
+    clearNotificationsForTask(taskId: string): void;
+    scheduleTaskRemoval(taskId: string): void;
+    markForNotification(task: BackgroundTask): void;
+}
+export declare class TaskPollingManager {
+    private adapter;
+    private pollingInterval?;
+    private pollingInFlight;
+    constructor(adapter: PollingManagerAdapter);
+    startPolling(): void;
+    stopPolling(): void;
+    hasRunningTasks(): boolean;
+    private verifySessionExists;
+    private pruneStaleTasksAndNotifications;
+    private checkAndInterruptStaleTasks;
+    private failCrashedTask;
+    private pollRunningTasks;
+}
+export {};

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

@@ -8,3 +8,6 @@ export declare const NOTEPAD_DIR = "notepads";
 export declare const NOTEPAD_BASE_PATH = ".bob/notepads";
 /** Strategist plan directory pattern */
 export declare const STRATEGIST_PLANS_DIR = ".bob/plans";
+export declare const BOULDER_REGISTRY_DIR = ".bob/boulder-registry";
+export declare const WORKTREE_BASE_DIR = ".opencode/worktrees";
+export declare const LEGACY_BOULDER_FILE = "boulder.json";

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

@@ -4,8 +4,37 @@
  * Handles reading/writing boulder.json for active plan tracking.
  */
 import type { BoulderState, PlanProgress, TaskSessionState } from "./types";
+export declare function validatePlanName(planName: string): void;
 export declare function getBoulderFilePath(directory: string): string;
+/**
+ * Read boulder state — v2 compatible
+ *
+ * v2 behavior:
+ * 1. Check if registry exists and has entries
+ * 2. If exactly ONE plan exists, return that plan's state (single-plan mode)
+ * 3. If ZERO plans exist, check for legacy boulder.json (migration needed)
+ * 4. If MULTIPLE plans exist, return null (caller must use registry functions)
+ *
+ * @param directory - Root directory (where .bob/ lives)
+ * @returns BoulderState | null
+ *
+ * @deprecated For multi-plan scenarios, use readBoulderForPlan() directly
+ */
 export declare function readBoulderState(directory: string): BoulderState | null;
+/**
+ * Write boulder state — v2 compatible
+ *
+ * v2 behavior:
+ * 1. Ensure registry exists (triggers migration if legacy boulder.json found)
+ * 2. Write to registry using state.plan_name
+ * 3. If legacy boulder.json exists, migrate it
+ *
+ * @param directory - Root directory (where .bob/ lives)
+ * @param state - BoulderState to write
+ * @returns true on success, false on failure
+ *
+ * @deprecated For multi-plan scenarios, use writeBoulderForPlan() directly
+ */
 export declare function writeBoulderState(directory: string, state: BoulderState): boolean;
 export declare function appendSessionId(directory: string, sessionId: string, origin?: "direct" | "appended"): BoulderState | null;
 export declare function clearBoulderState(directory: string): boolean;
@@ -42,3 +71,69 @@ export declare function getPlanName(planPath: string): string;
  * Create a new boulder state for a plan.
  */
 export declare function createBoulderState(planPath: string, sessionId: string, agent?: string, worktreePath?: string): BoulderState;
+/**
+ * Get the boulder registry directory path
+ * @returns `{directory}/.bob/boulder-registry`
+ */
+export declare function getRegistryDir(directory: string): string;
+/**
+ * Read boulder state for a specific plan from registry
+ * @returns BoulderState | null if not found or invalid
+ */
+export declare function readBoulderForPlan(directory: string, planName: string): BoulderState | null;
+/**
+ * Write boulder state for a specific plan atomically
+ * Pattern: write to .tmp file, then rename (atomic on POSIX)
+ * @returns true on success, false on failure
+ */
+export declare function writeBoulderForPlan(directory: string, planName: string, state: BoulderState): boolean;
+/**
+ * Delete boulder state for a specific plan from registry
+ * @returns true on success, false if file doesn't exist or error
+ */
+export declare function deleteBoulderForPlan(directory: string, planName: string): boolean;
+/**
+ * Get list of all active plan names from registry
+ * @returns Array of plan names (without .json extension)
+ */
+export declare function getActivePlans(directory: string): string[];
+/**
+ * Get count of active plans
+ */
+export declare function getActivePlanCount(directory: string): number;
+/**
+ * Find which plan a session ID belongs to
+ * Searches all registry files for the session ID
+ * @returns Plan name or null if not found
+ */
+export declare function findPlanNameForSession(directory: string, sessionId: string): string | null;
+/**
+ * Check if there's a conflicting active plan (not the excluded one)
+ * @returns true if another plan exists
+ */
+export declare function hasConflictingPlan(directory: string, excludePlanName: string): boolean;
+/**
+ * Migrate v1 boulder.json to v2 registry format
+ * Reads old boulder.json, copies to boulder-registry/{plan_name}.json, renames to .bak
+ * @returns true on success or if already migrated, false on failure
+ */
+export declare function migrateV1ToV2(directory: string): boolean;
+/**
+ * Ensure registry directory exists, trigger migration if v1 found
+ */
+export declare function ensureRegistryExists(directory: string): void;
+/**
+ * Complete a plan: sync notepads from worktree, remove worktree, delete boulder from registry
+ * @param directory - Root directory (where registry lives)
+ * @param planName - Plan name to complete
+ * @param worktreePath - Optional worktree path to clean up
+ * @returns true on success
+ */
+export declare function completePlan(directory: string, planName: string, worktreePath?: string): boolean;
+/**
+ * Sync .bob/ directory from worktree back to root
+ * Copies notepads and other boulder state files
+ * @param rootDirectory - Main repo root
+ * @param worktreePath - Worktree path to sync from
+ */
+export declare function syncBoulderNotepadsFromWorktree(rootDirectory: string, worktreePath: string): void;

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

@@ -4,6 +4,23 @@
  * Manages the active work plan state for Bob orchestrator.
  * Named after Bob's boulder - the eternal task that must be rolled.
  */
+/**
+ * BoulderState - DO NOT MODIFY
+ *
+ * This type is used by 10+ consumer files across the codebase.
+ * Any changes require updating ALL consumers:
+ * - resolve-active-boulder-session.ts
+ * - idle-event.ts (lines 54, 162, 205)
+ * - boulder-continuation-injector.ts
+ * - tool-execute-after.ts
+ * - tool-execute-before.ts
+ * - agent-resolution.ts
+ * - boulder-session-lineage.ts
+ * - background-launch-session-tracking.ts
+ *
+ * For new fields, add to BoulderState interface here AND update all consumers.
+ * For registry-specific data, use separate BoulderRegistry type (not this one).
+ */
 export interface BoulderState {
     /** Absolute path to the active plan file */
     active_plan: string;

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

@@ -1 +1 @@
-export declare const DOCTOR_TEMPLATE = "# Hiai OpenCode Doctor Command\n\n## Purpose\n\nUse /doctor to run the hiai-opencode install/runtime diagnostic and report actionable setup issues.\n\n## Execute\n\nRun:\n\n```bash\nhiai-opencode doctor\n```\n\nIf the binary is not on PATH, try the package-local fallback:\n\n```bash\nnode ./node_modules/@hiai-gg/hiai-opencode/assets/cli/hiai-opencode.mjs doctor\n```\n\n## Report\n\nSummarize:\n\n- config path\n- enabled and disabled MCP servers\n- missing env vars by name only\n- static `.mcp.json` freshness and whether it is managed by hiai-opencode\n- OpenCode Connect visibility for configured model providers\n- OpenCode plugin registration sanity (including `plugin: [\"list\"]` misconfiguration warning)\n- skill materialization status from skill registry\n- agent count and naming summary\n- LSP runtime availability\n- MemPalace python source and selected interpreter (env/config/auto)\n- MCP tool probes (real connect + tools/list) for stdio and basic endpoint probes for remote MCP\n\nRules:\n\n- Do not print API key values.\n- Do not ask for model provider env vars such as OPENROUTER_API_KEY or OPENAI_API_KEY; normal model auth belongs to OpenCode Connect.\n- If `opencode mcp list` is empty but doctor/mcp-status sees servers, explain the runtime-vs-static config distinction and run `hiai-opencode export-mcp .mcp.json` if the user wants static visibility.\n- Do not run package installs unless the user explicitly asks.\n";
+export declare const DOCTOR_TEMPLATE = "# Hiai OpenCode Doctor Command\n\n## Purpose\n\nUse /doctor to run the hiai-opencode install/runtime diagnostic and report actionable setup issues.\n\n## Execute\n\nRun:\n\n```bash\nhiai-opencode doctor\n```\n\nIf the binary is not on PATH, try the package-local fallback:\n\n```bash\nnode ./node_modules/@hiai-gg/hiai-opencode/assets/cli/hiai-opencode.mjs doctor\n```\n\n## Report\n\nSummarize:\n\n- config path\n- enabled and disabled MCP servers\n- missing env vars by name only\n- static `.mcp.json` freshness and whether it is managed by hiai-opencode\n- OpenCode Connect visibility for configured model providers\n- OpenCode plugin registration sanity (including `plugin: [\"list\"]` misconfiguration warning)\n- skill materialization status from skill registry\n- agent count and naming summary\n- LSP runtime availability\n- MemPalace python source and selected interpreter (env/config/auto)\n- MCP tool probes (real connect + tools/list) for stdio and basic endpoint probes for remote MCP\n\nRules:\n\n- Do not print API key values.\n- Do not ask for model provider env vars such as OPENROUTER_API_KEY or OPENAI_API_KEY; normal model auth belongs to OpenCode Connect.\n- If `opencode mcp list` is empty but doctor/mcp-status sees servers, explain the runtime-vs-static config distinction and run `hiai-opencode export-mcp .opencode/.mcp.json` if the user wants static visibility.\n- Do not run package installs unless the user explicitly asks.\n";

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

@@ -0,0 +1,2 @@
+export declare const LOOP_COMMAND_TEMPLATE = "You are starting a Development Loop - a self-referential loop that runs until task completion.\n\n## How the Loop Works\n\n1. You will work on the task continuously\n2. When you believe the task is fully complete, output: `<promise>{{COMPLETION_PROMISE}}</promise>`\n3. If mode is \"ultrawork\", Critic must verify your work before the loop ends\n4. Maximum iterations: {{MAX_ITERATIONS}}\n\n## Modes\n\n| Mode | Max Iterations | Verification |\n|------|---------------|--------------|\n| normal | 100 | None |\n| ultrawork | 500 | Critic gate after first completion promise |\n\n## Exit Conditions\n\n1. **Normal mode**: Output `<promise>DONE</promise>` when fully complete\n2. **Ultrawork mode**: First `<promise>DONE</promise>` triggers Critic verification. Loop ends only after Critic verifies.\n3. **Max Iterations**: Loop stops automatically at limit\n4. **Cancel**: User runs `/cancel-loop` command\n\n## Your Task\n\nParse the arguments:\n- Task description (required)\n- --mode=normal|ultrawork (default: normal)\n- --completion-promise=TEXT (default: DONE)\n- --strategy=reset|continue (default: continue)\n\nBegin working on the task.";
+export declare const CANCEL_LOOP_TEMPLATE = "Cancel the currently active Development Loop.\n\nThis will:\n1. Stop the loop from continuing\n2. Clear the loop state file\n3. Allow the session to end normally\n\nCheck if a loop is active and cancel it. Inform the user of the result.";

package/dist/features/builtin-commands/templates/start-work.d.ts

@@ -1 +1 @@
-export declare const START_WORK_TEMPLATE = "You are starting a Bob 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: work directly in the current project directory (no worktree)\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Strategist-generated plan files at `.bob/plans/`\n\n2. **Check for active boulder state**: Read `.bob/boulder.json` if it exists\n\n3. **Decision logic**:\n   - If `.bob/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** (ONLY when `--worktree` was explicitly specified and `worktree_path` not already set in boulder.json):\n   1. `git worktree list --porcelain` - 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 guard 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- If worktree_path is set in boulder.json, all work happens inside that worktree directory\n- Read the FULL plan file before delegating any tasks\n- Follow guard delegation protocols (7-section format)\n\n## TASK BREAKDOWN (MANDATORY)\n\nAfter reading the plan file, you MUST decompose every plan task into granular, implementation-level sub-steps and register ALL of them as task/todo items BEFORE starting any work.\n\n**How to break down**:\n- Each plan checkbox item (e.g., `- [ ] Add user authentication`) must be split into concrete, actionable sub-tasks\n- Sub-tasks should be specific enough that each one touches a clear set of files/functions\n- Include: file to modify, what to change, expected behavior, and how to verify\n- Do NOT leave any task vague - \"implement feature X\" is NOT acceptable; \"add validateToken() to src/auth/middleware.ts that checks JWT expiry and returns 401\" IS acceptable\n\n**Example breakdown**:\nPlan task: `- [ ] Add rate limiting to API`\n\u2192 Todo items:\n  1. Create `src/middleware/rate-limiter.ts` with sliding window algorithm (max 100 req/min per IP)\n  2. Add RateLimiter middleware to `src/app.ts` router chain, before auth middleware\n  3. Add rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) to response in `rate-limiter.ts`\n  4. Add test: verify 429 response after exceeding limit in `src/middleware/rate-limiter.test.ts`\n  5. Add test: verify headers are present on normal responses\n\nRegister these as task/todo items so progress is tracked and visible throughout the session.\n\n## WORKTREE COMPLETION\n\nWhen working in a worktree (`worktree_path` is set in boulder.json) and ALL plan tasks are complete:\n1. Commit all remaining changes in the worktree\n2. **Sync .bob state back**: Copy `.bob/` from the worktree to the main repo before removal.\n   This is CRITICAL when `.bob/` is gitignored - state written during worktree execution would otherwise be lost.\n   ```bash\n   cp -r <worktree-path>/.bob/* <main-repo>/.bob/ 2>/dev/null || true\n   ```\n3. Switch to the main working directory (the original repo, NOT the worktree)\n4. Merge the worktree branch into the current branch: `git merge <worktree-branch>`\n5. If merge succeeds, clean up: `git worktree remove <worktree-path>`\n6. Remove the boulder.json state\n\nThis is the DEFAULT behavior when `--worktree` was used. Skip merge only if the user explicitly instructs otherwise (e.g., asks to create a PR instead).";
+export declare const START_WORK_TEMPLATE = "You are starting an orchestration work session.\n\n**Orchestrator agent**: Bob is the primary orchestrator. For complex/waved plans, Bob dispatches Manager as a subagent for parallel wave coordination. For simple plans, Bob executes directly without dispatching Manager.\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 the active boulder registry entry\n    - If specified but invalid: you must run `git worktree add <path> <branch>` first\n    - If omitted: work directly in the current project directory (no worktree)\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Strategist-generated plan files at `.bob/plans/`\n\n2. **Check for active boulder state**: Read `.bob/boulder-registry/` for active plans\n\n3. **Decision logic**:\n   - If the plan already exists in `.bob/boulder-registry/` AND is NOT complete:\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** (ONLY when `--worktree` was explicitly specified and `worktree_path` not already set in the active registry entry):\n   1. `git worktree list --porcelain` - see available worktrees\n   2. Create: `git worktree add <absolute-path> <branch-or-HEAD>`\n   3. Update the active registry entry to add `\"worktree_path\": \"<absolute-path>\"`\n   4. All work happens inside that worktree directory\n\n5. **Create/Update active boulder registry entry**:\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 guard 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 the active boulder registry entry BEFORE starting work\n- If `worktree_path` is set in the active registry entry, all work happens inside that worktree directory\n- Read the FULL plan file before delegating any tasks\n- Follow guard delegation protocols (7-section format)\n\n## TASK BREAKDOWN (MANDATORY)\n\nAfter reading the plan file, you MUST decompose every plan task into granular, implementation-level sub-steps and register ALL of them as task/todo items BEFORE starting any work.\n\n**How to break down**:\n- Each plan checkbox item (e.g., `- [ ] Add user authentication`) must be split into concrete, actionable sub-tasks\n- Sub-tasks should be specific enough that each one touches a clear set of files/functions\n- Include: file to modify, what to change, expected behavior, and how to verify\n- Do NOT leave any task vague - \"implement feature X\" is NOT acceptable; \"add validateToken() to src/auth/middleware.ts that checks JWT expiry and returns 401\" IS acceptable\n\n**Example breakdown**:\nPlan task: `- [ ] Add rate limiting to API`\n\u2192 Todo items:\n  1. Create `src/middleware/rate-limiter.ts` with sliding window algorithm (max 100 req/min per IP)\n  2. Add RateLimiter middleware to `src/app.ts` router chain, before auth middleware\n  3. Add rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) to response in `rate-limiter.ts`\n  4. Add test: verify 429 response after exceeding limit in `src/middleware/rate-limiter.test.ts`\n  5. Add test: verify headers are present on normal responses\n\nRegister these as task/todo items so progress is tracked and visible throughout the session.\n\n## WORKTREE COMPLETION\n\nWhen ALL plan tasks are complete:\n1. Commit remaining changes in the worktree\n2. The plugin auto-syncs `.bob/notepads/` back to the main repo\n3. The worktree is auto-removed via `git worktree remove`\n4. The plan is deregistered from `boulder-registry/`\n\nDo NOT manually copy `.bob/` -- the plugin handles this.\n\n## PARALLEL PLANS\n\nMultiple plans can run simultaneously. Each plan lives in its own git worktree\nat `.opencode/worktrees/<plan-name>/` for complete filesystem isolation.\n\n- Auto-worktree: created automatically when a second plan starts - no `--worktree` needed\n- Manual worktree: `--worktree <path>` overrides the default location\n- Registry: `.bob/boulder-registry/{plan-name}.json` tracks each plan independently\n- Stop-continuation: only affects the calling session's plan, not other active plans\n";