@wolfx/oh-my-openagent 4.0.0 → 4.1.2

package/dist/hooks/atlas/system-reminder-templates.d.ts

@@ -1,5 +1,6 @@
 export declare const DIRECT_WORK_REMINDER: string;
 export declare const BOULDER_CONTINUATION_PROMPT: string;
+export declare const BOULDER_COMPLETE_PROMPT = "<system-reminder>\nBOULDER COMPLETE: plan \"{PLAN_NAME}\" is fully checked.\n\nTotal elapsed: {ELAPSED_HUMAN}\n\nPer-task breakdown:\n{TASK_BREAKDOWN}\n\nPer your <boulder_completion_response> instructions, print the final ORCHESTRATION COMPLETE summary in your next turn. This nudge fires at most once.\n</system-reminder>";
 export declare const VERIFICATION_REMINDER = "**THE SUBAGENT JUST CLAIMED THIS TASK IS DONE. THEY ARE PROBABLY LYING.**\n\nSubagents say \"done\" when code has errors, tests pass trivially, logic is wrong,\nor they quietly added features nobody asked for. This happens EVERY TIME.\nAssume the work is broken until YOU prove otherwise.\n\n---\n\n**PHASE 1: READ THE CODE FIRST (before running anything)**\n\nDo NOT run tests yet. Read the code FIRST so you know what you're testing.\n\n1. `Bash(\"git diff --stat -- ':!node_modules'\")` - see exactly which files changed. Any file outside expected scope = scope creep.\n2. `Read` EVERY changed file - no exceptions, no skimming.\n3. For EACH file, critically ask:\n   - Does this code ACTUALLY do what the task required? (Re-read the task, compare line by line)\n   - Any stubs, TODOs, placeholders, hardcoded values? (`Grep` for TODO, FIXME, HACK, xxx)\n   - Logic errors? Trace the happy path AND the error path in your head.\n   - Anti-patterns? (`Grep` for `as any`, `@ts-ignore`, empty catch, console.log in changed files)\n   - Scope creep? Did the subagent touch things or add features NOT in the task spec?\n4. Cross-check every claim:\n   - Said \"Updated X\" - READ X. Actually updated, or just superficially touched?\n   - Said \"Added tests\" - READ the tests. Do they test REAL behavior or just `expect(true).toBe(true)`?\n   - Said \"Follows patterns\" - OPEN a reference file. Does it ACTUALLY match?\n\n**If you cannot explain what every changed line does, you have NOT reviewed it.**\n\n**PHASE 2: RUN AUTOMATED CHECKS (targeted, then broad)**\n\nNow that you understand the code, verify mechanically:\n1. `lsp_diagnostics` on EACH changed file - ZERO new errors\n2. Run tests for changed modules FIRST, then full suite\n3. Build/typecheck - exit 0\n\nIf Phase 1 found issues but Phase 2 passes: Phase 2 is WRONG. The code has bugs that tests don't cover. Fix the code.\n\n**PHASE 3: HANDS-ON QA - ACTUALLY RUN IT (MANDATORY for user-facing changes)**\n\nTests and linters CANNOT catch: visual bugs, wrong CLI output, broken user flows, API response shape issues.\n\n**If this task produced anything a user would SEE or INTERACT with, you MUST launch it and verify yourself.**\n\n- **Frontend/UI**: `/playwright` skill - load the page, click through the flow, check console. Verify: page loads, interactions work, console clean, responsive.\n- **TUI/CLI**: `interactive_bash` - run the command, try good input, try bad input, try --help. Verify: command runs, output correct, error messages helpful, edge inputs handled.\n- **API/Backend**: `Bash` with curl - hit the endpoint, check response body, send malformed input. Verify: returns 200, body correct, error cases return proper errors.\n- **Config/Build**: Actually start the service or import the config. Verify: loads without error, backward compatible.\n\nThis is NOT optional \"if applicable\". If the deliverable is user-facing and you did not run it, you are shipping untested work.\n\n**PHASE 4: GATE DECISION - Should you proceed to the next task?**\n\nAnswer honestly:\n1. Can I explain what EVERY changed line does? (If no - back to Phase 1)\n2. Did I SEE it work with my own eyes? (If user-facing and no - back to Phase 3)\n3. Am I confident nothing existing is broken? (If no - run broader tests)\n\nALL three must be YES. \"Probably\" = NO. \"I think so\" = NO. Investigate until CERTAIN.\n\n- **All 3 YES** - Proceed: mark task complete, move to next.\n- **Any NO** - Reject: resume session with `session_id`, fix the specific issue.\n- **Unsure** - Reject: \"unsure\" = \"no\". Investigate until you have a definitive answer.\n\n**DO NOT proceed to the next task until all 4 phases are complete and the gate passes.**";
 export declare const VERIFICATION_REMINDER_GEMINI = "**THE SUBAGENT HAS FINISHED. THEIR WORK IS EXTREMELY SUSPICIOUS.**\n\nThe subagent CLAIMS this task is done. Based on thousands of executions, subagent claims are FALSE more often than true.\nThey ROUTINELY:\n- Ship code with syntax errors they didn't bother to check\n- Create stub implementations with TODOs and call it \"done\"\n- Write tests that pass trivially (testing nothing meaningful)\n- Implement logic that does NOT match what was requested\n- Add features nobody asked for and call it \"improvement\"\n- Report \"all tests pass\" when they didn't run any tests\n\n**This is NOT a theoretical warning. This WILL happen on this task. Assume the work is BROKEN.**\n\n**YOU MUST VERIFY WITH ACTUAL TOOL CALLS. NOT REASONING. TOOL CALLS.**\nThinking \"it looks correct\" is NOT verification. Running `lsp_diagnostics` IS.\n\n---\n\n**PHASE 1: READ THE CODE FIRST (DO NOT SKIP - DO NOT RUN TESTS YET)**\n\nRead the code FIRST so you know what you're testing.\n\n1. `Bash(\"git diff --stat -- ':!node_modules'\")` - see exactly which files changed.\n2. `Read` EVERY changed file - no exceptions, no skimming.\n3. For EACH file:\n   - Does this code ACTUALLY do what the task required? RE-READ the task spec.\n   - Any stubs, TODOs, placeholders? `Grep` for TODO, FIXME, HACK, xxx\n   - Anti-patterns? `Grep` for `as any`, `@ts-ignore`, empty catch\n   - Scope creep? Did the subagent add things NOT in the task spec?\n4. Cross-check EVERY claim against actual code.\n\n**If you cannot explain what every changed line does, GO BACK AND READ AGAIN.**\n\n**PHASE 2: RUN AUTOMATED CHECKS**\n\n1. `lsp_diagnostics` on EACH changed file - ZERO new errors. ACTUALLY RUN THIS.\n2. Run tests for changed modules, then full suite. ACTUALLY RUN THESE.\n3. Build/typecheck - exit 0.\n\nIf Phase 1 found issues but Phase 2 passes: Phase 2 is WRONG. Fix the code.\n\n**PHASE 3: HANDS-ON QA (MANDATORY for user-facing changes)**\n\n- **Frontend/UI**: `/playwright`\n- **TUI/CLI**: `interactive_bash`\n- **API/Backend**: `Bash` with curl\n\n**If user-facing and you did not run it, you are shipping UNTESTED BROKEN work.**\n\n**PHASE 4: GATE DECISION**\n\n1. Can I explain what EVERY changed line does? (If no \u2192 Phase 1)\n2. Did I SEE it work via tool calls? (If user-facing and no \u2192 Phase 3)\n3. Am I confident nothing is broken? (If no \u2192 broader tests)\n\nALL three must be YES. \"Probably\" = NO. \"I think so\" = NO.\n\n**DO NOT proceed to the next task until all 4 phases are complete.**";
 export declare const ORCHESTRATOR_DELEGATION_REQUIRED: string;

package/dist/hooks/atlas/tool-execute-after.d.ts

@@ -5,6 +5,7 @@ export declare function createToolExecuteAfterHandler(input: {
     ctx: PluginInput;
     pendingFilePaths: Map<string, string>;
     pendingTaskRefs: Map<string, PendingTaskRef>;
+    pendingPlanSnapshots?: Map<string, string>;
     autoCommit: boolean;
     getState: (sessionID: string) => SessionState;
     isCallerOrchestrator?: (sessionID: string | undefined) => Promise<boolean>;

package/dist/hooks/atlas/tool-execute-before.d.ts

@@ -4,6 +4,7 @@ export declare function createToolExecuteBeforeHandler(input: {
     ctx: PluginInput;
     pendingFilePaths: Map<string, string>;
     pendingTaskRefs: Map<string, PendingTaskRef>;
+    pendingPlanSnapshots?: Map<string, string>;
     isCallerOrchestrator?: (sessionID: string | undefined) => Promise<boolean>;
 }): (toolInput: {
     tool: string;

package/dist/hooks/atlas/types.d.ts

@@ -16,6 +16,7 @@ export interface AtlasHookOptions {
     isContinuationStopped?: (sessionID: string) => boolean;
     isCallerOrchestrator?: (sessionID: string | undefined) => Promise<boolean>;
     agentOverrides?: AgentOverrides;
+    idleSettleMs?: number;
     /** Enable auto-commit after each atomic task completion (default: true) */
     autoCommit?: boolean;
 }
@@ -52,4 +53,5 @@ export interface SessionState {
     waitingForFinalWaveApproval?: boolean;
     pendingFinalWaveTaskCount?: number;
     approvedFinalWaveTaskCount?: number;
+    boulderCompletionNudgedAt?: Record<string, number>;
 }

package/dist/hooks/compaction-context-injector/recovery.d.ts

@@ -1,6 +1,6 @@
 import type { CompactionContextClient } from "./types";
 import type { TailMonitorState } from "./tail-monitor";
 export declare function createRecoveryLogic(ctx: CompactionContextClient | undefined, getTailState: (sessionID: string) => TailMonitorState): {
-    recoverCheckpointedAgentConfig: (sessionID: string, reason: "session.compacted" | "no-text-tail") => Promise<boolean>;
+    recoverCheckpointedAgentConfig: (sessionID: string, reason: "compaction.autocontinue" | "session.compacted" | "no-text-tail") => Promise<boolean>;
     maybeWarnAboutNoTextTail: (sessionID: string) => Promise<void>;
 };

package/dist/hooks/compaction-context-injector/types.d.ts

@@ -1,5 +1,6 @@
 export interface CompactionContextInjector {
     capture: (sessionID: string) => Promise<void>;
+    restore: (sessionID: string) => Promise<boolean>;
     inject: (sessionID?: string) => string;
     event: (input: {
         event: {

package/dist/hooks/compaction-todo-preserver/hook.d.ts

@@ -1,11 +1,22 @@
 import type { PluginInput } from "@opencode-ai/plugin";
+type ToolExecuteBeforeInput = {
+    tool: string;
+    sessionID: string;
+    callID: string;
+};
+type ToolExecuteBeforeOutput = {
+    args: Record<string, unknown>;
+};
 export interface CompactionTodoPreserver {
     capture: (sessionID: string) => Promise<void>;
+    restore: (sessionID: string) => Promise<void>;
     event: (input: {
         event: {
             type: string;
             properties?: unknown;
         };
     }) => Promise<void>;
+    "tool.execute.before": (input: ToolExecuteBeforeInput, output: ToolExecuteBeforeOutput) => Promise<void>;
 }
 export declare function createCompactionTodoPreserverHook(ctx: PluginInput): CompactionTodoPreserver;
+export {};

package/dist/hooks/fsync-skip-warning/index.d.ts

@@ -0,0 +1,18 @@
+type ToolExecuteInput = {
+    tool: string;
+    sessionID: string;
+    callID: string;
+};
+type ToolBeforeOutput = {
+    args: Record<string, unknown>;
+};
+type ToolAfterOutput = {
+    title: string;
+    output: string;
+    metadata: unknown;
+};
+export declare function createFsyncSkipWarningHook(): {
+    "tool.execute.before": (input: ToolExecuteInput, _output: ToolBeforeOutput) => Promise<void>;
+    "tool.execute.after": (input: ToolExecuteInput, output: ToolAfterOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/index.d.ts

@@ -55,3 +55,4 @@ export { createReadImageResizerHook } from "./read-image-resizer";
 export { createTodoDescriptionOverrideHook } from "./todo-description-override";
 export { createWebFetchRedirectGuardHook } from "./webfetch-redirect-guard";
 export { createLegacyPluginToastHook } from "./legacy-plugin-toast";
+export { createFsyncSkipWarningHook } from "./fsync-skip-warning";

package/dist/hooks/ralph-loop/continuation-prompt-injector.d.ts

@@ -1,8 +1,14 @@
 import type { PluginInput } from "@opencode-ai/plugin";
+export type ContinuationPromptResult = {
+    status: "dispatched";
+} | {
+    status: "rejected";
+    error: Error;
+};
 export declare function injectContinuationPrompt(ctx: PluginInput, options: {
     sessionID: string;
     prompt: string;
     directory: string;
     apiTimeoutMs: number;
     inheritFromSessionID?: string;
-}): Promise<void>;
+}): Promise<ContinuationPromptResult>;

package/dist/hooks/ralph-loop/iteration-continuation.d.ts

@@ -8,5 +8,14 @@ type ContinuationOptions = {
         setSessionID: (sessionID: string) => RalphLoopState | null;
     };
 };
-export declare function continueIteration(ctx: PluginInput, state: RalphLoopState, options: ContinuationOptions): Promise<void>;
+export type ContinuationResult = {
+    status: "dispatched";
+    sessionID: string;
+} | {
+    status: "session_creation_rejected";
+} | {
+    status: "dispatch_rejected";
+    error: unknown;
+};
+export declare function continueIteration(ctx: PluginInput, state: RalphLoopState, options: ContinuationOptions): Promise<ContinuationResult>;
 export {};

package/dist/hooks/ralph-loop/loop-state-controller.d.ts

@@ -1,4 +1,4 @@
-import type { RalphLoopOptions, RalphLoopState } from "./types";
+import type { IterationCommitExpectation, RalphLoopOptions, RalphLoopState } from "./types";
 export declare function createLoopStateController(options: {
     directory: string;
     stateDir: string | undefined;
@@ -14,10 +14,11 @@ export declare function createLoopStateController(options: {
     cancelLoop(sessionID: string): boolean;
     getState(): RalphLoopState | null;
     clear(): boolean;
-    incrementIteration(): RalphLoopState | null;
+    incrementIteration(expected?: IterationCommitExpectation): RalphLoopState | null;
     setSessionID(sessionID: string): RalphLoopState | null;
-    setMessageCountAtStart(sessionID: string, messageCountAtStart: number): RalphLoopState | null;
+    setMessageCountAtStart(sessionID: string, messageCountAtStart: number, expectedStartedAt?: string): RalphLoopState | null;
     markVerificationPending(sessionID: string): RalphLoopState | null;
     setVerificationSessionID(sessionID: string, verificationSessionID: string): RalphLoopState | null;
     restartAfterFailedVerification(sessionID: string, messageCountAtStart?: number): RalphLoopState | null;
+    clearVerificationState(sessionID: string, messageCountAtStart?: number): RalphLoopState | null;
 };

package/dist/hooks/ralph-loop/pending-verification-handler.d.ts

@@ -1,7 +1,11 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 import type { RalphLoopState } from "./types";
+import type { IterationCommitExpectation } from "./types";
 type LoopStateController = {
     restartAfterFailedVerification: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
+    clearVerificationState: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
+    incrementIteration: (expected?: IterationCommitExpectation) => RalphLoopState | null;
+    clear: () => boolean;
     setVerificationSessionID: (sessionID: string, verificationSessionID: string) => RalphLoopState | null;
 };
 export declare function handlePendingVerification(ctx: PluginInput, input: {

package/dist/hooks/ralph-loop/ralph-loop-event-handler.d.ts

@@ -1,17 +1,19 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-import type { RalphLoopOptions, RalphLoopState } from "./types";
+import type { IterationCommitExpectation, RalphLoopOptions, RalphLoopState } from "./types";
 type LoopStateController = {
     getState: () => RalphLoopState | null;
     clear: () => boolean;
-    incrementIteration: () => RalphLoopState | null;
+    incrementIteration: (expected?: IterationCommitExpectation) => RalphLoopState | null;
     setSessionID: (sessionID: string) => RalphLoopState | null;
     markVerificationPending: (sessionID: string) => RalphLoopState | null;
     setVerificationSessionID: (sessionID: string, verificationSessionID: string) => RalphLoopState | null;
     restartAfterFailedVerification: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
+    clearVerificationState: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
 };
 type RalphLoopEventHandlerOptions = {
     directory: string;
     apiTimeoutMs: number;
+    idleSettleMs: number;
     getTranscriptPath: (sessionID: string) => string | undefined;
     checkSessionExists?: RalphLoopOptions["checkSessionExists"];
     backgroundManager?: RalphLoopOptions["backgroundManager"];

package/dist/hooks/ralph-loop/storage.d.ts

@@ -1,6 +1,6 @@
-import type { RalphLoopState } from "./types";
+import type { IterationCommitExpectation, RalphLoopState } from "./types";
 export declare function getStateFilePath(directory: string, customPath?: string): string;
 export declare function readState(directory: string, customPath?: string): RalphLoopState | null;
 export declare function writeState(directory: string, state: RalphLoopState, customPath?: string): boolean;
 export declare function clearState(directory: string, customPath?: string): boolean;
-export declare function incrementIteration(directory: string, customPath?: string): RalphLoopState | null;
+export declare function incrementIteration(directory: string, customPath?: string, expected?: IterationCommitExpectation): RalphLoopState | null;

package/dist/hooks/ralph-loop/types.d.ts

@@ -15,10 +15,15 @@ export interface RalphLoopState {
     verification_pending?: boolean;
     strategy?: "reset" | "continue";
 }
+export interface IterationCommitExpectation {
+    iteration: number;
+    sessionID: string;
+}
 export interface RalphLoopOptions {
     config?: RalphLoopConfig;
     getTranscriptPath?: (sessionId: string) => string;
     apiTimeout?: number;
+    idleSettleMs?: number;
     checkSessionExists?: (sessionId: string) => Promise<boolean>;
     backgroundManager?: {
         getTasksByParentSession: (sessionId: string) => Array<{

package/dist/hooks/ralph-loop/verification-failure-handler.d.ts

@@ -1,7 +1,9 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-import type { RalphLoopState } from "./types";
+import type { IterationCommitExpectation, RalphLoopState } from "./types";
 type LoopStateController = {
-    restartAfterFailedVerification: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
+    clearVerificationState: (sessionID: string, messageCountAtStart?: number) => RalphLoopState | null;
+    incrementIteration: (expected?: IterationCommitExpectation) => RalphLoopState | null;
+    clear: () => boolean;
 };
 export declare function handleFailedVerification(ctx: PluginInput, input: {
     state: RalphLoopState;

package/dist/hooks/shared/session-idle-settle.d.ts

@@ -0,0 +1,11 @@
+export declare const DEFAULT_SESSION_IDLE_SETTLE_MS = 150;
+export declare function settleAfterSessionIdle(ms?: number): Promise<void>;
+type SessionStatusClient = {
+    session?: {
+        status?: () => Promise<unknown>;
+    };
+};
+export declare function isActiveSessionStatusType(statusType: string): boolean;
+export declare function isSessionActive(client: SessionStatusClient, sessionID: string): Promise<boolean>;
+export declare function shouldPromptAfterSessionIdle(client: SessionStatusClient, sessionID: string, settleMs?: number): Promise<boolean>;
+export {};

package/dist/hooks/team-session-events/team-idle-wake-hint.d.ts

@@ -24,6 +24,7 @@ type TeamIdleWakeHintContext = {
     client: {
         session: {
             promptAsync?: (input: PromptAsyncInput) => Promise<unknown>;
+            status?: () => Promise<unknown>;
         };
     };
 };
@@ -34,5 +35,8 @@ type HookInput = {
     };
 };
 export type HookImpl = (input: HookInput) => Promise<void>;
-export declare function createTeamIdleWakeHint(ctx: TeamIdleWakeHintContext, config: TeamModeConfig): HookImpl;
+type TeamIdleWakeHintOptions = {
+    idleSettleMs?: number;
+};
+export declare function createTeamIdleWakeHint(ctx: TeamIdleWakeHintContext, config: TeamModeConfig, options?: TeamIdleWakeHintOptions): HookImpl;
 export {};

package/dist/hooks/todo-description-override/description.d.ts

@@ -1 +1 @@
-export declare const TODOWRITE_DESCRIPTION = "Use this tool to create and manage a structured task list for tracking progress on multi-step work.\n\n## Todo Format (MANDATORY)\n\nEach todo title MUST encode four elements: WHERE, WHY, HOW, and EXPECTED RESULT.\n\nFormat: \"[WHERE] [HOW] to [WHY] - expect [RESULT]\"\n\nGOOD:\n- \"src/utils/validation.ts: Add validateEmail() for input sanitization - returns boolean\"\n- \"UserService.create(): Call validateEmail() before DB insert - rejects invalid emails with 400\"\n- \"validation.test.ts: Add test for missing @ sign - expect validateEmail('foo') to return false\"\n\nBAD:\n- \"Implement email validation\" (where? how? what result?)\n- \"Add dark mode\" (feature, not a todo)\n- \"Fix auth\" (what file? what changes? what's expected?)\n\n## Granularity Rules\n\nEach todo MUST be a single atomic action completable in 1-3 tool calls. If it needs more, split it.\n\n**Size test**: Can you complete this todo by editing one file or running one command? If not, it's too big.\n\n## Task Management\n- One in_progress at a time. Complete it before starting the next.\n- Mark completed immediately after finishing each item.\n- Skip this tool for single trivial tasks (one-step, obvious action).";
+export declare const TODOWRITE_DESCRIPTION = "Use this tool to create and manage a structured task list for tracking progress on multi-step work.\n\n## OpenCode Schema Contract\n\nThe upstream OpenCode `todowrite` schema expects each todo item to include:\n\n- `content`: string\n- `status`: string, one of `pending`, `in_progress`, `completed`, `cancelled`\n- `priority`: string, one of `high`, `medium`, `low`\n\n`priority` is a string field. Never send numeric priorities such as `0`, `1`, `2`, or labels such as `P0`, `P1`, `P2`.\n\n## Todo Format (MANDATORY)\n\nEach todo title MUST encode four elements: WHERE, WHY, HOW, and EXPECTED RESULT.\n\nFormat: \"[WHERE] [HOW] to [WHY] - expect [RESULT]\"\n\nGOOD:\n- \"src/utils/validation.ts: Add validateEmail() for input sanitization - returns boolean\"\n- \"UserService.create(): Call validateEmail() before DB insert - rejects invalid emails with 400\"\n- \"validation.test.ts: Add test for missing @ sign - expect validateEmail('foo') to return false\"\n\nBAD:\n- \"Implement email validation\" (where? how? what result?)\n- \"Add dark mode\" (feature, not a todo)\n- \"Fix auth\" (what file? what changes? what's expected?)\n\n## Granularity Rules\n\nEach todo MUST be a single atomic action completable in 1-3 tool calls. If it needs more, split it.\n\n**Size test**: Can you complete this todo by editing one file or running one command? If not, it's too big.\n\n## Task Management\n- One in_progress at a time. Complete it before starting the next.\n- Mark completed immediately after finishing each item.\n- Skip this tool for single trivial tasks (one-step, obvious action).";

package/dist/hooks/unstable-agent-babysitter/unstable-agent-babysitter-hook.d.ts

@@ -55,12 +55,14 @@ type BabysitterContext = {
                     directory?: string;
                 };
             }) => Promise<unknown>;
+            status?: () => Promise<unknown>;
         };
     };
 };
 type BabysitterOptions = {
     backgroundManager: Pick<BackgroundManager, "getTasksByParentSession">;
     config?: BabysittingConfig;
+    idleSettleMs?: number;
 };
 export declare function createUnstableAgentBabysitterHook(ctx: BabysitterContext, options: BabysitterOptions): {
     event: ({ event }: {