oh-my-opencode 4.2.3 → 4.3.0

package/dist/features/background-agent/parent-wake-notifier.d.ts

@@ -34,6 +34,7 @@ type ParentWakeNotifierOptions = {
      * inside OpenCode's `@parcel/watcher` TSFN callback path. See issue #4120.
      */
     userMessageInProgressWindowMs: number;
+    parentSessionActivityInProgressWindowMs?: number;
 };
 export declare class ParentWakeNotifier {
     private readonly deps;
@@ -42,11 +43,13 @@ export declare class ParentWakeNotifier {
     private pendingParentWakeTimers;
     private dispatchedParentWakes;
     private dispatchedParentWakeTimers;
+    private recentParentSessionActivity;
     constructor(deps: ParentWakeNotifierDeps, options: ParentWakeNotifierOptions);
     getPendingParentWakes(): Map<string, PendingParentWake>;
     getPendingParentWakeTimers(): Map<string, ReturnType<typeof setTimeout>>;
     getDispatchedParentWakes(): Map<string, PendingParentWake>;
     getDispatchedParentWakeTimers(): Map<string, ReturnType<typeof setTimeout>>;
+    recordParentSessionActivity(sessionID: string): void;
     queuePendingParentWake(sessionID: string, notification: string, promptContext: ParentWakePromptContext, shouldReply: boolean, delayMs?: number): void;
     flushPendingParentWake(sessionID: string): Promise<void>;
     clearDispatchedParentWake(sessionID: string): void;
@@ -55,6 +58,7 @@ export declare class ParentWakeNotifier {
     clearPendingParentWakeTimer(sessionID: string): void;
     shutdown(): void;
     private isSessionActive;
+    private hasRecentParentSessionActivity;
     private resolveParentWakePromptContext;
     private cloneParentWake;
     private trackDispatchedParentWake;

package/dist/features/background-agent/session-activity.d.ts

@@ -0,0 +1,12 @@
+import type { OpencodeClient } from "./opencode-client";
+export type SessionActivityLookup = {
+    readonly type: "activity";
+    readonly activity: Date;
+} | {
+    readonly type: "missing";
+} | {
+    readonly type: "unavailable";
+};
+export type SessionActivityResolver = (sessionID: string) => Promise<SessionActivityLookup>;
+export declare function extractSessionActivityDate(sessionInfo: unknown): Date | undefined;
+export declare function getSessionActivityFromClient(client: OpencodeClient, sessionID: string, directory?: string): Promise<SessionActivityLookup>;

package/dist/features/background-agent/session-existence.d.ts

@@ -1,3 +1,5 @@
 import type { OpencodeClient } from "./opencode-client";
 export declare const MIN_SESSION_GONE_POLLS = 3;
+export type SessionExistenceStatus = "exists" | "missing" | "unknown";
+export declare function checkSessionExistence(client: OpencodeClient, sessionID: string, directory?: string): Promise<SessionExistenceStatus>;
 export declare function verifySessionExists(client: OpencodeClient, sessionID: string, directory?: string): Promise<boolean>;

package/dist/features/background-agent/session-stream-activity.d.ts

@@ -0,0 +1,18 @@
+export declare const SESSION_NEXT_EVENT_PREFIX = "session.next.";
+export interface MessagePartInfo {
+    readonly id: string | undefined;
+    readonly sessionID: string | undefined;
+    readonly type: string | undefined;
+    readonly tool: string | undefined;
+    readonly input: Record<string, unknown> | undefined;
+    readonly state: {
+        readonly status: string | undefined;
+        readonly input: Record<string, unknown> | undefined;
+    } | undefined;
+    readonly field: string | undefined;
+    readonly activityTime: Date | undefined;
+}
+export declare function resolveMessagePartInfo(properties: unknown): MessagePartInfo | undefined;
+export declare function resolveSessionNextPartInfo(eventType: string, properties: unknown): MessagePartInfo | undefined;
+export declare function isMessagePartForSession(partInfo: MessagePartInfo | undefined, sessionID: string): boolean;
+export declare function hasOutputSignalFromPart(partInfo: MessagePartInfo | undefined, sessionID?: string): boolean;

package/dist/features/background-agent/task-activity-refresh.d.ts

@@ -0,0 +1,11 @@
+import type { SessionActivityResolver } from "./session-activity";
+import type { BackgroundTask } from "./types";
+export type TaskActivityRefreshResult = {
+    readonly type: "activity";
+    readonly activityTime: number;
+} | {
+    readonly type: "missing";
+} | {
+    readonly type: "unavailable";
+};
+export declare function refreshTaskActivityFromSession(task: BackgroundTask, getSessionActivity: SessionActivityResolver): Promise<TaskActivityRefreshResult>;

package/dist/features/background-agent/task-poller.d.ts

@@ -2,6 +2,7 @@ import type { BackgroundTaskConfig } from "../../config/schema";
 import type { BackgroundTask } from "./types";
 import type { ConcurrencyManager } from "./concurrency";
 import type { OpencodeClient } from "./opencode-client";
+import { type SessionActivityResolver } from "./session-activity";
 export declare function pruneStaleTasksAndNotifications(args: {
     tasks: Map<string, BackgroundTask>;
     notifications: Map<string, BackgroundTask[]>;
@@ -21,4 +22,5 @@ export declare function checkAndInterruptStaleTasks(args: {
     notifyParentSession: (task: BackgroundTask) => Promise<void>;
     sessionStatuses?: SessionStatusMap;
     onTaskInterrupted?: (task: BackgroundTask) => void;
+    getSessionActivity?: SessionActivityResolver;
 }): Promise<void>;

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

@@ -1,10 +1 @@
-/**
- * Boulder State Constants
- */
-export declare const BOULDER_DIR = ".omo";
-export declare const BOULDER_FILE = "boulder.json";
-export declare const BOULDER_STATE_PATH = ".omo/boulder.json";
-export declare const NOTEPAD_DIR = "notepads";
-export declare const NOTEPAD_BASE_PATH = ".omo/notepads";
-/** Prometheus plan directory pattern */
-export declare const PROMETHEUS_PLANS_DIR = ".omo/plans";
+export { BOULDER_DIR, BOULDER_FILE, BOULDER_STATE_PATH, NOTEPAD_BASE_PATH, NOTEPAD_DIR, PROMETHEUS_PLANS_DIR, } from "@oh-my-opencode/boulder-state";

package/dist/features/boulder-state/format-duration.d.ts

@@ -1 +1 @@
-export declare function formatDurationHuman(milliseconds: number): string;
+export { formatDurationHuman } from "@oh-my-opencode/utils";

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

@@ -1,83 +1 @@
-/**
- * Boulder State Storage
- *
- * Handles reading/writing boulder.json for active plan tracking.
- */
-import type { BoulderSessionOrigin, BoulderState, BoulderWorkResumeOption, BoulderWorkState, PlanProgress, TaskSessionState } from "./types";
-export declare function getBoulderFilePath(directory: string): string;
-export declare function resolveBoulderPlanPath(directory: string, state: Pick<BoulderState, "active_plan" | "worktree_path">): string;
-export declare function readBoulderState(directory: string): BoulderState | null;
-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;
-export declare function getTaskSessionState(directory: string, taskKey: string): TaskSessionState | null;
-export declare function upsertTaskSessionState(directory: string, input: {
-    taskKey: string;
-    taskLabel: string;
-    taskTitle: string;
-    sessionId: string;
-    agent?: string;
-    category?: string;
-}): BoulderState | null;
-/**
- * Find Prometheus plan files for this project.
- * Prometheus stores plans at: {project}/.omo/plans/{name}.md
- */
-export declare function findPrometheusPlans(directory: string): string[];
-/**
- * Parse a plan file and count checkbox progress.
- *
- * Only top-level (zero-indent) checkboxes under `## TODOs` and
- * `## Final Verification Wave` sections are counted. The checkbox
- * body must carry a valid task label (`N.` for TODOs, `FN.` for
- * Final Verification Wave). Nested acceptance-criteria checkboxes
- * and checkboxes in other sections are intentionally ignored so
- * that progress tracking stays aligned with `readCurrentTopLevelTask`.
- */
-export declare function getPlanProgress(planPath: string): PlanProgress;
-/**
- * Extract plan name from file path.
- */
-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;
-export declare function generateWorkId(planName: string): string;
-export declare function getBoulderWorks(state: BoulderState): BoulderWorkState[];
-export declare function getActiveWorks(directory: string): BoulderWorkState[];
-export declare function getWorkById(directory: string, workId: string): BoulderWorkState | null;
-export declare function getWorkByPlanName(directory: string, planName: string, options?: {
-    worktreePath?: string;
-}): BoulderWorkState | null;
-export declare function getWorkForSession(directory: string, sessionId: string): BoulderWorkState | null;
-export declare function resolveBoulderPlanPathForWork(directory: string, work: Pick<BoulderWorkState, "active_plan" | "worktree_path">): string;
-export declare function getWorkResumeOptions(directory: string): BoulderWorkResumeOption[];
-export declare function selectActiveWork(directory: string, workId: string): BoulderState | null;
-export declare function addBoulderWork(directory: string, input: {
-    planPath: string;
-    sessionId: string;
-    agent?: string;
-    worktreePath?: string;
-    startedAt?: string;
-}): BoulderState | null;
-export declare function appendSessionIdForWork(directory: string, workId: string, sessionId: string, origin?: BoulderSessionOrigin): BoulderState | null;
-export declare function upsertTaskSessionStateForWork(directory: string, workId: string, input: {
-    taskKey: string;
-    taskLabel: string;
-    taskTitle: string;
-    sessionId: string;
-    agent?: string;
-    category?: string;
-}): BoulderState | null;
-export declare function startTaskTimer(directory: string, workId: string, input: {
-    taskKey: string;
-    taskLabel: string;
-    taskTitle: string;
-    sessionId: string;
-    agent?: string;
-    category?: string;
-    startedAt?: string;
-}): BoulderState | null;
-export declare function endTaskTimer(directory: string, workId: string, taskKey: string, endedAt?: string): BoulderState | null;
-export declare function completeBoulder(directory: string, workId?: string, endedAt?: string): BoulderState | null;
+export { addBoulderWork, appendSessionId, appendSessionIdForWork, clearBoulderState, completeBoulder, createBoulderState, endTaskTimer, findPrometheusPlans, generateWorkId, getActiveWorks, getBoulderFilePath, getBoulderWorks, getPlanName, getPlanProgress, getTaskSessionState, getWorkById, getWorkByPlanName, getWorkForSession, getWorkResumeOptions, readBoulderState, resolveBoulderPlanPath, resolveBoulderPlanPathForWork, selectActiveWork, startTaskTimer, upsertTaskSessionState, upsertTaskSessionStateForWork, writeBoulderState, } from "@oh-my-opencode/boulder-state";

package/dist/features/boulder-state/top-level-task.d.ts

@@ -1,2 +1 @@
-import type { TopLevelTaskRef } from "./types";
-export declare function readCurrentTopLevelTask(planPath: string): TopLevelTaskRef | null;
+export { readCurrentTopLevelTask } from "@oh-my-opencode/boulder-state";

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

@@ -1,100 +1 @@
-/**
- * Boulder State Types
- *
- * Manages the active work plan state for Sisyphus orchestrator.
- * Named after Sisyphus's boulder - the eternal task that must be rolled.
- */
-export interface BoulderState {
-    schema_version?: 2;
-    active_work_id?: string;
-    works?: Record<string, BoulderWorkState>;
-    /** Absolute path to the active plan file */
-    active_plan: string;
-    /** ISO timestamp when work started */
-    started_at: string;
-    ended_at?: string;
-    elapsed_ms?: number;
-    status?: BoulderWorkStatus;
-    updated_at?: string;
-    /** Session IDs that have worked on this plan */
-    session_ids: string[];
-    session_origins?: Record<string, "direct" | "appended">;
-    /** Plan name derived from filename */
-    plan_name: string;
-    /** Agent type to use when resuming (e.g., 'atlas') */
-    agent?: string;
-    /** Absolute path to the git worktree root where work happens */
-    worktree_path?: string;
-    /** Preferred reusable subagent sessions keyed by current top-level plan task */
-    task_sessions?: Record<string, TaskSessionState>;
-}
-export type BoulderSessionOrigin = "direct" | "appended";
-export type BoulderWorkStatus = "active" | "completed" | "paused" | "abandoned";
-export type BoulderTaskStatus = "running" | "completed" | "cancelled";
-export interface BoulderWorkState {
-    work_id: string;
-    active_plan: string;
-    plan_name: string;
-    status?: BoulderWorkStatus;
-    started_at: string;
-    ended_at?: string;
-    elapsed_ms?: number;
-    updated_at?: string;
-    session_ids: string[];
-    session_origins?: Record<string, BoulderSessionOrigin>;
-    agent?: string;
-    worktree_path?: string;
-    task_sessions?: Record<string, TaskSessionState>;
-}
-export interface PlanProgress {
-    /** Total number of checkboxes */
-    total: number;
-    /** Number of completed checkboxes */
-    completed: number;
-    /** Whether all tasks are done */
-    isComplete: boolean;
-}
-export interface TaskSessionState {
-    /** Stable identifier for the current top-level plan task (e.g. todo:1 / final-wave:F1) */
-    task_key: string;
-    /** Original task label from the plan file */
-    task_label: string;
-    /** Full task title from the plan file */
-    task_title: string;
-    /** Preferred reusable subagent session */
-    session_id: string;
-    /** Agent associated with the task session, when known */
-    agent?: string;
-    /** Category associated with the task session, when known */
-    category?: string;
-    started_at?: string;
-    ended_at?: string;
-    elapsed_ms?: number;
-    status?: BoulderTaskStatus;
-    /** Last update timestamp */
-    updated_at: string;
-}
-export interface BoulderWorkResumeOption {
-    work_id: string;
-    plan_name: string;
-    active_plan: string;
-    worktree_path?: string;
-    status: BoulderWorkStatus;
-    started_at: string;
-    updated_at: string;
-    ended_at?: string;
-    elapsed_ms?: number;
-    session_count: number;
-    progress: PlanProgress;
-    is_current_mirror: boolean;
-}
-export interface TopLevelTaskRef {
-    /** Stable identifier for the current top-level plan task */
-    key: string;
-    /** Task section in the Prometheus plan */
-    section: "todo" | "final-wave";
-    /** Original label token (e.g. 1 / F1) */
-    label: string;
-    /** Full task title extracted from the checkbox line */
-    title: string;
-}
+export type { BoulderSessionOrigin, BoulderState, BoulderTaskStatus, BoulderWorkResumeOption, BoulderWorkState, BoulderWorkStatus, PlanProgress, TaskSessionState, TopLevelTaskRef, } from "@oh-my-opencode/boulder-state";

package/dist/features/task-toast-manager/manager.d.ts

@@ -1,6 +1,6 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-import type { TrackedTask, TaskStatus, ModelFallbackInfo } from "./types";
 import type { ConcurrencyManager } from "../background-agent/concurrency";
+import type { ModelFallbackInfo, TaskStatus, TrackedTask } from "./types";
 type OpencodeClient = PluginInput["client"];
 export declare class TaskToastManager {
     private tasks;

package/dist/features/team-mode/team-state-store/locks.d.ts

@@ -1,12 +1,15 @@
-import { rename } from "node:fs/promises";
+import { open, rename, rm } from "node:fs/promises";
 type LockOptions = {
     staleAfterMs?: number;
     ownerTag?: string;
 };
+type AtomicWriteDeps = {
+    open?: typeof open;
+    rename?: typeof rename;
+    rm?: typeof rm;
+};
 export declare function withLock<T>(lockPath: string, fn: () => Promise<T>, opts?: LockOptions): Promise<T>;
 export declare function detectStaleLock(lockPath: string, staleAfterMs: number): Promise<boolean>;
 export declare function reapStaleLock(lockPath: string): Promise<void>;
-export declare function atomicWrite(filePath: string, content: string | Buffer, deps?: {
-    rename: typeof rename;
-}): Promise<void>;
+export declare function atomicWrite(filePath: string, content: string | Buffer, deps?: AtomicWriteDeps): Promise<void>;
 export {};

package/dist/features/tmux-subagent/manager.d.ts

@@ -31,6 +31,7 @@ export declare class TmuxSessionManager {
     private tmuxConfig;
     private projectDirectory;
     private serverUrl;
+    private ctxServerUrl;
     private sourcePaneId;
     private sessions;
     private pendingSessions;
@@ -60,6 +61,7 @@ export declare class TmuxSessionManager {
     private getSessionMappings;
     getTrackedPaneId(sessionId: string): string | undefined;
     getServerUrl(): string;
+    getCtxServerUrl(): string | undefined;
     private removeTrackedSession;
     private reassignIsolatedContainerAnchor;
     private cleanupIsolatedContainerAfterSessionDeletion;

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

@@ -1,7 +1,7 @@
 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 = "**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 with `task_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;
 export declare const SINGLE_TASK_DIRECTIVE: string;

package/dist/hooks/claude-code-hooks/config-loader.d.ts

@@ -3,7 +3,14 @@ export interface DisabledHooksConfig {
     Stop?: string[];
     PreToolUse?: string[];
     PostToolUse?: string[];
+    PostToolUseFailure?: string[];
+    PermissionRequest?: string[];
     UserPromptSubmit?: string[];
+    Notification?: string[];
+    SubagentStart?: string[];
+    SubagentStop?: string[];
+    SessionStart?: string[];
+    SessionEnd?: string[];
     PreCompact?: string[];
 }
 export interface PluginExtendedConfig {

package/dist/hooks/claude-code-hooks/config.d.ts

@@ -1,4 +1,7 @@
-import type { ClaudeHooksConfig } from "./types";
+import type { ClaudeHooksConfig, PluginHooksConfig } from "./types";
 export declare function getClaudeSettingsPaths(customPath?: string): string[];
 export declare function clearClaudeHooksConfigCache(): void;
+export declare function resetPluginHooksState(): void;
+export declare function setPluginHooksConfigs(directory: string, configs: PluginHooksConfig[]): void;
+export declare function mergePluginHooksConfigs(base: ClaudeHooksConfig, pluginHooksConfigs: PluginHooksConfig[]): ClaudeHooksConfig;
 export declare function loadClaudeHooksConfig(customSettingsPath?: string): Promise<ClaudeHooksConfig | null>;

package/dist/hooks/claude-code-hooks/types.d.ts

@@ -2,7 +2,7 @@
  * Claude Code Hooks Type Definitions
  * Maps Claude Code hook concepts to OpenCode plugin events
  */
-export type ClaudeHookEvent = "PreToolUse" | "PostToolUse" | "UserPromptSubmit" | "Stop" | "PreCompact";
+export type ClaudeHookEvent = "PreToolUse" | "PostToolUse" | "PostToolUseFailure" | "PermissionRequest" | "UserPromptSubmit" | "Notification" | "Stop" | "SubagentStart" | "SubagentStop" | "SessionStart" | "SessionEnd" | "PreCompact";
 export interface HookMatcher {
     matcher: string;
     hooks: HookAction[];
@@ -10,6 +10,8 @@ export interface HookMatcher {
 export interface HookCommand {
     type: "command";
     command: string;
+    /** Env vars allowed to pass through to the spawned process (plugin-sourced hooks are intersected with mcp_env_allowlist) */
+    allowedEnvVars?: string[];
 }
 export interface HookHttp {
     type: "http";
@@ -22,8 +24,15 @@ export type HookAction = HookCommand | HookHttp;
 export interface ClaudeHooksConfig {
     PreToolUse?: HookMatcher[];
     PostToolUse?: HookMatcher[];
+    PostToolUseFailure?: HookMatcher[];
+    PermissionRequest?: HookMatcher[];
     UserPromptSubmit?: HookMatcher[];
+    Notification?: HookMatcher[];
     Stop?: HookMatcher[];
+    SubagentStart?: HookMatcher[];
+    SubagentStop?: HookMatcher[];
+    SessionStart?: HookMatcher[];
+    SessionEnd?: HookMatcher[];
     PreCompact?: HookMatcher[];
 }
 export interface PreToolUseInput {
@@ -189,3 +198,10 @@ export interface PluginConfig {
     disabledHooks?: boolean | ClaudeHookEvent[];
     keywordDetectorDisabled?: boolean;
 }
+/**
+ * Plugin hooks configuration shape.
+ * Replaces the loose `Array<{ hooks?: Record<string, unknown> }>` with a proper typed interface.
+ */
+export interface PluginHooksConfig {
+    hooks?: Partial<Record<ClaudeHookEvent, unknown[]>>;
+}

package/dist/hooks/comment-checker/cli.d.ts

@@ -1,3 +1,4 @@
+import { type CheckResult, type HookInput } from "@oh-my-opencode/comment-checker-core";
 /**
  * Asynchronously get comment-checker binary path.
  * Will trigger lazy download if binary not found.
@@ -13,28 +14,7 @@ export declare function getCommentCheckerPathSync(): string | null;
  * Call this early to trigger download while other init happens.
  */
 export declare function startBackgroundInit(): void;
-export interface HookInput {
-    session_id: string;
-    tool_name: string;
-    transcript_path: string;
-    cwd: string;
-    hook_event_name: string;
-    tool_input: {
-        file_path?: string;
-        content?: string;
-        old_string?: string;
-        new_string?: string;
-        edits?: Array<{
-            old_string: string;
-            new_string: string;
-        }>;
-    };
-    tool_response?: unknown;
-}
-export interface CheckResult {
-    hasComments: boolean;
-    message: string;
-}
+export type { HookInput, CheckResult };
 /**
  * Run comment-checker CLI with given input.
  * @param input Hook input to check

package/dist/hooks/comment-checker/types.d.ts

@@ -1,31 +1 @@
-export type CommentType = "line" | "block" | "docstring";
-export interface CommentInfo {
-    text: string;
-    lineNumber: number;
-    filePath: string;
-    commentType: CommentType;
-    isDocstring: boolean;
-    metadata?: Record<string, string>;
-}
-export interface PendingCall {
-    filePath: string;
-    content?: string;
-    oldString?: string;
-    newString?: string;
-    edits?: Array<{
-        old_string: string;
-        new_string: string;
-    }>;
-    tool: "write" | "edit" | "multiedit";
-    sessionID: string;
-    timestamp: number;
-}
-export interface FileComments {
-    filePath: string;
-    comments: CommentInfo[];
-}
-export interface FilterResult {
-    shouldSkip: boolean;
-    reason?: string;
-}
-export type CommentFilter = (comment: CommentInfo) => FilterResult;
+export type { ApplyPatchAccumulator, ApplyPatchFileMetadata, CheckResult, CheckerEdit, CommentFilter, CommentInfo, CommentType, FileComments, FilterResult, HookInput, PendingCall, ResolveCommentCheckerBinaryInput, RunCommentCheckerInput, RunCommentCheckerOptions, SpawnFn, SpawnProcess, SpawnSignal, } from "@oh-my-opencode/comment-checker-core";

package/dist/hooks/directory-agents-injector/finder.d.ts

@@ -1,7 +1,2 @@
-import type { AgentsMdCache } from "@oh-my-opencode/rules-core";
-export declare function resolveFilePath(rootDirectory: string, path: string): string | null;
-export declare function findAgentsMdUp(input: {
-    readonly startDir: string;
-    readonly rootDir: string;
-    readonly cache?: AgentsMdCache;
-}): Promise<string[]>;
+export { resolveFilePath } from "@oh-my-opencode/agents-md-core";
+export { findAgentsMdUp } from "@oh-my-opencode/rules-engine";

package/dist/hooks/directory-agents-injector/injector.d.ts

@@ -1,18 +1 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-import type { AgentsMdCache } from "@oh-my-opencode/rules-core";
-import type { createDynamicTruncator } from "../../shared/dynamic-truncator";
-type DynamicTruncator = ReturnType<typeof createDynamicTruncator>;
-export declare function processFilePathForAgentsInjection(input: {
-    ctx: PluginInput;
-    truncator: DynamicTruncator;
-    sessionCaches: Map<string, Set<string>>;
-    agentsMdCache?: AgentsMdCache;
-    filePath: string;
-    sessionID: string;
-    output: {
-        title: string;
-        output: string;
-        metadata: unknown;
-    };
-}): Promise<void>;
-export {};
+export { processFilePathForAgentsInjection } from "@oh-my-opencode/agents-md-core";

package/dist/hooks/index.d.ts

@@ -56,3 +56,5 @@ export { createTodoDescriptionOverrideHook } from "./todo-description-override";
 export { createWebFetchRedirectGuardHook } from "./webfetch-redirect-guard";
 export { createLegacyPluginToastHook } from "./legacy-plugin-toast";
 export { createFsyncSkipWarningHook } from "./fsync-skip-warning";
+export { createNotepadWriteGuardHook } from "./notepad-write-guard";
+export { createPlanFormatValidatorHook } from "./plan-format-validator";

package/dist/hooks/keyword-detector/analyze/default.d.ts

@@ -9,4 +9,4 @@
  * - Vietnamese: phân tích, điều tra, nghiên cứu, kiểm tra, xem xét, chẩn đoán, giải thích, tìm hiểu, gỡ lỗi, tại sao
  */
 export declare const ANALYZE_PATTERN: RegExp;
-export declare const ANALYZE_MESSAGE = "[analyze-mode]\nANALYSIS MODE. Gather context before diving deep:\n\nCONTEXT GATHERING (parallel):\n- 1-2 explore agents (codebase patterns, implementations)\n- 1-2 librarian agents (if external library involved)\n- Direct tools: Grep, AST-grep, LSP for targeted searches\n\nIF COMPLEX - DO NOT STRUGGLE ALONE. Consult specialists:\n- **Oracle**: Conventional problems (architecture, debugging, complex logic)\n- **Artistry**: Non-conventional problems (different approach needed)\n\nSYNTHESIZE findings before proceeding.";
+export declare const ANALYZE_MESSAGE = "[analyze-mode]\nANALYSIS MODE. Gather context before diving deep:\n\nCONTEXT GATHERING (parallel):\n- 1-2 explore agents (codebase patterns, implementations)\n- 1-2 librarian agents (if external library involved)\n- Direct tools: Grep, AST-grep, LSP for targeted searches\n\nIF COMPLEX - DO NOT STRUGGLE ALONE. Consult specialists:\n- **Oracle**: Conventional problems (architecture, debugging, complex logic)\n- **Artistry**: Non-conventional problems (different approach needed)\n\nSYNTHESIZE findings before proceeding.\n---\nMANDATORY delegate_task params: ALWAYS include load_skills and run_in_background when calling delegate_task. Evaluate available skills before dispatch - pass task-appropriate skills when relevant, pass [] ONLY when no skill matches the task domain.\nExample: delegate_task(subagent_type=\"explore\", prompt=\"...\", run_in_background=true, load_skills=[])";

package/dist/hooks/keyword-detector/constants.d.ts

@@ -1,11 +1,16 @@
 export declare const CODE_BLOCK_PATTERN: RegExp;
 export declare const INLINE_CODE_PATTERN: RegExp;
-export { isPlannerAgent, isNonOmoAgent, getUltraworkMessage } from "./ultrawork";
-export { SEARCH_PATTERN, SEARCH_MESSAGE } from "./search";
-export { ANALYZE_PATTERN, ANALYZE_MESSAGE } from "./analyze";
-export { TEAM_PATTERN, TEAM_MESSAGE } from "./team";
-export { HYPERPLAN_PATTERN, HYPERPLAN_MESSAGE } from "./hyperplan";
 import type { KeywordType } from "../../config/schema/keyword-detector";
+import { getUltraworkMessage, isPlannerAgent, isNonOmoAgent } from "./ultrawork";
+import { SEARCH_PATTERN, SEARCH_MESSAGE } from "./search";
+import { ANALYZE_PATTERN, ANALYZE_MESSAGE } from "./analyze";
+import { TEAM_PATTERN, TEAM_MESSAGE } from "./team";
+import { HYPERPLAN_PATTERN, HYPERPLAN_MESSAGE } from "./hyperplan";
+export { isPlannerAgent, isNonOmoAgent, getUltraworkMessage };
+export { SEARCH_PATTERN, SEARCH_MESSAGE };
+export { ANALYZE_PATTERN, ANALYZE_MESSAGE };
+export { TEAM_PATTERN, TEAM_MESSAGE };
+export { HYPERPLAN_PATTERN, HYPERPLAN_MESSAGE };
 export declare const HYPERPLAN_ULTRAWORK_PATTERN: RegExp;
 export declare function getHyperplanUltraworkMessage(agentName?: string, modelID?: string): string;
 export type KeywordDetector = {

package/dist/hooks/keyword-detector/detector.d.ts

@@ -5,8 +5,8 @@ export interface DetectedKeyword {
 }
 export declare function removeCodeBlocks(text: string): string;
 export declare function looksLikeSlashCommand(text: string): boolean;
-export declare function detectKeywords(text: string, agentName?: string, modelID?: string, disabledKeywords?: ReadonlyArray<KeywordType>): string[];
-export declare function detectKeywordsWithType(text: string, agentName?: string, modelID?: string, disabledKeywords?: ReadonlyArray<KeywordType>): DetectedKeyword[];
+export declare function detectKeywords(text: string, agentName?: string, modelID?: string, disabledKeywords?: ReadonlyArray<KeywordType>, enabledExpansions?: ReadonlyArray<KeywordType>): string[];
+export declare function detectKeywordsWithType(text: string, agentName?: string, modelID?: string, disabledKeywords?: ReadonlyArray<KeywordType>, enabledExpansions?: ReadonlyArray<KeywordType>): DetectedKeyword[];
 export declare function extractPromptText(parts: Array<{
     type: string;
     text?: string;

package/dist/hooks/keyword-detector/hook.d.ts

@@ -1,8 +1,9 @@
 import type { PluginInput } from "@opencode-ai/plugin";
+import type { DefaultModeConfig } from "../../config/schema/default-mode";
 import type { KeywordDetectorConfig } from "../../config/schema/keyword-detector";
 import type { ContextCollector } from "../../features/context-injector";
 import type { RalphLoopHook } from "../ralph-loop";
-export declare function createKeywordDetectorHook(ctx: PluginInput, _collector?: ContextCollector, _ralphLoop?: Pick<RalphLoopHook, "startLoop">, config?: KeywordDetectorConfig): {
+export declare function createKeywordDetectorHook(ctx: PluginInput, _collector?: ContextCollector, _ralphLoop?: Pick<RalphLoopHook, "startLoop">, config?: KeywordDetectorConfig, defaultMode?: DefaultModeConfig): {
     "chat.message": (input: {
         sessionID: string;
         agent?: string;

package/dist/hooks/keyword-detector/hyperplan/default.d.ts

@@ -8,6 +8,11 @@
  *
  * The detector injects a thin wrapper that loads the `hyperplan` skill, which
  * carries the full orchestration instructions for the 5-member adversarial team.
+ *
+ * The `hpp` shorthand uses an extra negative-lookbehind so that the very common
+ * C++ header-file extension `.hpp` (e.g. `interface.hpp`, `src/buffer.hpp`)
+ * does NOT falsely trigger hyperplan mode. A leading `.` would otherwise
+ * satisfy `\b` because the dot is a non-word character. See issue #4215.
  */
 export declare const HYPERPLAN_PATTERN: RegExp;
 export declare const HYPERPLAN_MESSAGE = "<hyperplan-mode>\n**MANDATORY**: Say \"HYPERPLAN MODE ENABLED!\" as your first response, exactly once.\n\nThe user invoked **hyperplan mode** \u2014 adversarial multi-agent planning via team-mode.\n\nLOAD THE HYPERPLAN SKILL IMMEDIATELY:\n\n```\nskill(name=\"hyperplan\")\n```\n\nAfter loading, follow the skill's full workflow EXACTLY:\n1. Acknowledge and capture the planning request\n2. Spawn the adversarial team via `team_create` with category members `unspecified-low`, `unspecified-high`, `ultrabrain`, and `artistry`; include `deep` only if the category is enabled\n3. Round 1 \u2014 Independent analysis (each member produces findings)\n4. Round 2 \u2014 Cross-attack (each member ruthlessly attacks the other 4's findings)\n5. Round 3 \u2014 Defend, refine, or concede\n6. Distill defensible insights into a structured bundle (Lead does NOT write the plan)\n7. MANDATORY: hand the bundle to the `plan` agent via `task(subagent_type=\"plan\", ...)` \u2014 the plan agent owns sequencing, parallelization, and verification gates\n8. Present the plan agent's output verbatim with provenance line, then clean up the team\n\nDo NOT improvise. Do NOT skip rounds. Do NOT write the plan yourself in step 6 \u2014 the handoff to the plan agent in step 7 is non-negotiable. Be the lead orchestrator and let the adversarial members do the cross-critique.\n\nIf team-mode is unavailable (`team_*` tools missing), instruct the user to set `team_mode.enabled: true` in `~/.config/opencode/oh-my-opencode.jsonc` and restart opencode.\n</hyperplan-mode>";

package/dist/hooks/notepad-write-guard/index.d.ts

@@ -0,0 +1,2 @@
+import type { Hooks } from "@opencode-ai/plugin";
+export declare function createNotepadWriteGuardHook(): Hooks;