@hiai-gg/hiai-opencode 0.1.1 → 0.1.3

package/src/hooks/directory-readme-injector/storage.ts

@@ -1,8 +1,8 @@
-import { README_INJECTOR_STORAGE } from "./constants";
-import { createInjectedPathsStorage } from "../../shared/session-injected-paths";
-
-export const {
-  loadInjectedPaths,
-  saveInjectedPaths,
-  clearInjectedPaths,
-} = createInjectedPathsStorage(README_INJECTOR_STORAGE);
+import { README_INJECTOR_STORAGE } from "./constants";
+import { createInjectedPathsStorage } from "../../shared/session-injected-paths";
+
+export const {
+  loadInjectedPaths,
+  saveInjectedPaths,
+  clearInjectedPaths,
+} = createInjectedPathsStorage(README_INJECTOR_STORAGE);

package/src/hooks/edit-error-recovery/hook.ts

@@ -1,58 +1,58 @@
-import type { PluginInput } from "@opencode-ai/plugin"
-
-/**
- * Known Edit tool error patterns that indicate the AI made a mistake
- */
-export const EDIT_ERROR_PATTERNS = [
-  "oldString and newString must be different",
-  "oldString not found",
-  "oldString found multiple times",
-] as const
-
-/**
- * System reminder injected when Edit tool fails due to AI mistake
- * Short, direct, and commanding - forces immediate corrective action
- */
-export const EDIT_ERROR_REMINDER = `
-[EDIT ERROR - IMMEDIATE ACTION REQUIRED]
-
-You made an Edit mistake. STOP and do this NOW:
-
-1. READ the file immediately to see its ACTUAL current state
-2. VERIFY what the content really looks like (your assumption was wrong)
-3. APOLOGIZE briefly to the user for the error
-4. CONTINUE with corrected action based on the real file content
-
-DO NOT attempt another edit until you've read and verified the file state.
-`
-
-/**
- * Detects Edit tool errors caused by AI mistakes and injects a recovery reminder
- *
- * This hook catches common Edit tool failures:
- * - oldString and newString must be different (trying to "edit" to same content)
- * - oldString not found (wrong assumption about file content)
- * - oldString found multiple times (ambiguous match, need more context)
- *
- * @see https://github.com/sst/opencode/issues/4718
- */
-export function createEditErrorRecoveryHook(_ctx: PluginInput) {
-  return {
-    "tool.execute.after": async (
-      input: { tool: string; sessionID: string; callID: string },
-      output: { title: string; output: string; metadata: unknown }
-    ) => {
-      if (input.tool.toLowerCase() !== "edit") return
-      if (typeof output.output !== "string") return
-
-      const outputLower = (output.output ?? "").toLowerCase()
-      const hasEditError = EDIT_ERROR_PATTERNS.some((pattern) =>
-        outputLower.includes(pattern.toLowerCase())
-      )
-
-      if (hasEditError) {
-        output.output += `\n${EDIT_ERROR_REMINDER}`
-      }
-    },
-  }
-}
+import type { PluginInput } from "@opencode-ai/plugin"
+
+/**
+ * Known Edit tool error patterns that indicate the AI made a mistake
+ */
+export const EDIT_ERROR_PATTERNS = [
+  "oldString and newString must be different",
+  "oldString not found",
+  "oldString found multiple times",
+] as const
+
+/**
+ * System reminder injected when Edit tool fails due to AI mistake
+ * Short, direct, and commanding - forces immediate corrective action
+ */
+export const EDIT_ERROR_REMINDER = `
+[EDIT ERROR - IMMEDIATE ACTION REQUIRED]
+
+You made an Edit mistake. STOP and do this NOW:
+
+1. READ the file immediately to see its ACTUAL current state
+2. VERIFY what the content really looks like (your assumption was wrong)
+3. APOLOGIZE briefly to the user for the error
+4. CONTINUE with corrected action based on the real file content
+
+DO NOT attempt another edit until you've read and verified the file state.
+`
+
+/**
+ * Detects Edit tool errors caused by AI mistakes and injects a recovery reminder
+ *
+ * This hook catches common Edit tool failures:
+ * - oldString and newString must be different (trying to "edit" to same content)
+ * - oldString not found (wrong assumption about file content)
+ * - oldString found multiple times (ambiguous match, need more context)
+ *
+ * @see https://github.com/sst/opencode/issues/4718
+ */
+export function createEditErrorRecoveryHook(_ctx: PluginInput) {
+  return {
+    "tool.execute.after": async (
+      input: { tool: string; sessionID: string; callID: string },
+      output: { title: string; output: string; metadata: unknown }
+    ) => {
+      if (input.tool.toLowerCase() !== "edit") return
+      if (typeof output.output !== "string") return
+
+      const outputLower = (output.output ?? "").toLowerCase()
+      const hasEditError = EDIT_ERROR_PATTERNS.some((pattern) =>
+        outputLower.includes(pattern.toLowerCase())
+      )
+
+      if (hasEditError) {
+        output.output += `\n${EDIT_ERROR_REMINDER}`
+      }
+    },
+  }
+}

package/src/hooks/edit-error-recovery/index.ts

@@ -1,5 +1,5 @@
-export {
-  createEditErrorRecoveryHook,
-  EDIT_ERROR_PATTERNS,
-  EDIT_ERROR_REMINDER,
-} from "./hook";
+export {
+  createEditErrorRecoveryHook,
+  EDIT_ERROR_PATTERNS,
+  EDIT_ERROR_REMINDER,
+} from "./hook";

package/src/hooks/empty-task-response-detector.ts

@@ -1,27 +1,27 @@
-import type { PluginInput } from "@opencode-ai/plugin"
-
-const EMPTY_RESPONSE_WARNING = `[Task Empty Response Warning]
-
-Task invocation completed but returned no response. This indicates the agent either:
-- Failed to execute properly
-- Did not terminate correctly
-- Returned an empty result
-
-Note: The call has already completed - you are NOT waiting for a response. Proceed accordingly.`
-
-export function createEmptyTaskResponseDetectorHook(_ctx: PluginInput) {
-  return {
-    "tool.execute.after": async (
-      input: { tool: string; sessionID: string; callID: string },
-      output: { title: string; output: string; metadata: unknown }
-    ) => {
-      if (input.tool !== "Task" && input.tool !== "task") return
-
-      const responseText = output.output?.trim() ?? ""
-
-      if (responseText === "") {
-        output.output = EMPTY_RESPONSE_WARNING
-      }
-    },
-  }
-}
+import type { PluginInput } from "@opencode-ai/plugin"
+
+const EMPTY_RESPONSE_WARNING = `[Task Empty Response Warning]
+
+Task invocation completed but returned no response. This indicates the agent either:
+- Failed to execute properly
+- Did not terminate correctly
+- Returned an empty result
+
+Note: The call has already completed - you are NOT waiting for a response. Proceed accordingly.`
+
+export function createEmptyTaskResponseDetectorHook(_ctx: PluginInput) {
+  return {
+    "tool.execute.after": async (
+      input: { tool: string; sessionID: string; callID: string },
+      output: { title: string; output: string; metadata: unknown }
+    ) => {
+      if (input.tool !== "Task" && input.tool !== "task") return
+
+      const responseText = output.output?.trim() ?? ""
+
+      if (responseText === "") {
+        output.output = EMPTY_RESPONSE_WARNING
+      }
+    },
+  }
+}

package/src/hooks/fast-apply/hook.ts

@@ -1,11 +1,11 @@
-import type { Hooks, PluginInput } from "@opencode-ai/plugin"
-import type { FastApplyConfig } from "../../config"
-import { handleFastApplyToolExecuteBefore } from "./tool-execute-before-handler"
-
-export function createFastApplyHook(config: FastApplyConfig): Hooks {
-  return {
-    "tool.execute.before": async (input, output) => {
-      await handleFastApplyToolExecuteBefore({ input, output, config })
-    },
-  }
-}
+import type { Hooks, PluginInput } from "@opencode-ai/plugin"
+import type { FastApplyConfig } from "../../config"
+import { handleFastApplyToolExecuteBefore } from "./tool-execute-before-handler"
+
+export function createFastApplyHook(config: FastApplyConfig): Hooks {
+  return {
+    "tool.execute.before": async (input, output) => {
+      await handleFastApplyToolExecuteBefore({ input, output, config })
+    },
+  }
+}

package/src/hooks/fast-apply/index.ts

@@ -1 +1 @@
-export { createFastApplyHook } from "./hook"
+export { createFastApplyHook } from "./hook"

package/src/hooks/fast-apply/ollama-client.ts

@@ -1,53 +1,53 @@
-import type { FastApplyConfig } from "../../config"
-
-export async function queryOllama(args: {
-  originalContent: string
-  patch: string
-  config: FastApplyConfig
-}): Promise<string> {
-  const { originalContent, patch, config } = args
-  const url = `${config.ollama_url}/api/generate`
-  const timeout = config.timeout
-
-  const prompt = [
-    "You are a code editor. Given the original file content and a patch/diff description, produce the full updated file content.",
-    "Return ONLY the updated file content, nothing else. No explanations, no markdown fences.",
-    "",
-    "=== ORIGINAL FILE ===",
-    originalContent,
-    "",
-    "=== PATCH ===",
-    patch,
-    "",
-    "=== UPDATED FILE ===",
-  ].join("\n")
-
-  const controller = new AbortController()
-  const timer = setTimeout(() => controller.abort(), timeout)
-
-  try {
-    const response = await fetch(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        model: config.model,
-        prompt,
-        stream: false,
-      }),
-      signal: controller.signal,
-    })
-
-    if (!response.ok) {
-      throw new Error(`Ollama returned ${response.status}: ${response.statusText}`)
-    }
-
-    const data = await response.json() as { response?: string }
-    if (!data.response) {
-      throw new Error("Ollama returned empty response")
-    }
-
-    return data.response
-  } finally {
-    clearTimeout(timer)
-  }
-}
+import type { FastApplyConfig } from "../../config"
+
+export async function queryOllama(args: {
+  originalContent: string
+  patch: string
+  config: FastApplyConfig
+}): Promise<string> {
+  const { originalContent, patch, config } = args
+  const url = `${config.ollama_url}/api/generate`
+  const timeout = config.timeout
+
+  const prompt = [
+    "You are a code editor. Given the original file content and a patch/diff description, produce the full updated file content.",
+    "Return ONLY the updated file content, nothing else. No explanations, no markdown fences.",
+    "",
+    "=== ORIGINAL FILE ===",
+    originalContent,
+    "",
+    "=== PATCH ===",
+    patch,
+    "",
+    "=== UPDATED FILE ===",
+  ].join("\n")
+
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), timeout)
+
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        model: config.model,
+        prompt,
+        stream: false,
+      }),
+      signal: controller.signal,
+    })
+
+    if (!response.ok) {
+      throw new Error(`Ollama returned ${response.status}: ${response.statusText}`)
+    }
+
+    const data = await response.json() as { response?: string }
+    if (!data.response) {
+      throw new Error("Ollama returned empty response")
+    }
+
+    return data.response
+  } finally {
+    clearTimeout(timer)
+  }
+}

package/src/hooks/fast-apply/tool-execute-before-handler.ts

@@ -1,86 +1,86 @@
-import type { FastApplyConfig } from "../../config"
-import { queryOllama } from "./ollama-client"
-import { log } from "../../shared"
-import { existsSync, readFileSync } from "fs"
-
-export async function handleFastApplyToolExecuteBefore(args: {
-  input: { tool: string; sessionID: string; callID: string }
-  output: { args: Record<string, unknown> }
-  config: FastApplyConfig
-}): Promise<void> {
-  const { input, output, config } = args
-  const normalizedTool = input.tool.toLowerCase()
-
-  if (normalizedTool !== "apply_patch" && normalizedTool !== "applypatch") {
-    return
-  }
-
-  const patchArgs = output.args as { filePath?: string; path?: string; file_path?: string; patch?: string }
-  const filePath = patchArgs.filePath ?? patchArgs.path ?? patchArgs.file_path
-  const patch = patchArgs.patch
-
-  if (!filePath || !patch) {
-    log("[fast-apply] Skipping: missing filePath or patch", {
-      sessionID: input.sessionID,
-      callID: input.callID,
-      hasFilePath: !!filePath,
-      hasPatch: !!patch,
-    })
-    return
-  }
-
-  if (!existsSync(filePath)) {
-    log("[fast-apply] Skipping: file does not exist (new file)", {
-      sessionID: input.sessionID,
-      callID: input.callID,
-      filePath,
-    })
-    return
-  }
-
-  let originalContent: string
-  try {
-    originalContent = readFileSync(filePath, "utf-8")
-  } catch (err) {
-    log("[fast-apply] Failed to read file, falling back to default", {
-      sessionID: input.sessionID,
-      callID: input.callID,
-      filePath,
-      error: String(err),
-    })
-    return
-  }
-
-  try {
-    log("[fast-apply] Sending to Ollama", {
-      sessionID: input.sessionID,
-      callID: input.callID,
-      filePath,
-      model: config.model,
-    })
-
-    const newContent = await queryOllama({
-      originalContent,
-      patch,
-      config,
-    })
-
-    output.args.content = newContent
-    output.args.patch = undefined
-
-    log("[fast-apply] Patch replaced with Ollama result", {
-      sessionID: input.sessionID,
-      callID: input.callID,
-      filePath,
-      originalLength: originalContent.length,
-      newLength: newContent.length,
-    })
-  } catch (err) {
-    log("[fast-apply] Ollama failed, falling back to default apply_patch", {
-      sessionID: input.sessionID,
-      callID: input.callID,
-      filePath,
-      error: String(err),
-    })
-  }
-}
+import type { FastApplyConfig } from "../../config"
+import { queryOllama } from "./ollama-client"
+import { log } from "../../shared"
+import { existsSync, readFileSync } from "fs"
+
+export async function handleFastApplyToolExecuteBefore(args: {
+  input: { tool: string; sessionID: string; callID: string }
+  output: { args: Record<string, unknown> }
+  config: FastApplyConfig
+}): Promise<void> {
+  const { input, output, config } = args
+  const normalizedTool = input.tool.toLowerCase()
+
+  if (normalizedTool !== "apply_patch" && normalizedTool !== "applypatch") {
+    return
+  }
+
+  const patchArgs = output.args as { filePath?: string; path?: string; file_path?: string; patch?: string }
+  const filePath = patchArgs.filePath ?? patchArgs.path ?? patchArgs.file_path
+  const patch = patchArgs.patch
+
+  if (!filePath || !patch) {
+    log("[fast-apply] Skipping: missing filePath or patch", {
+      sessionID: input.sessionID,
+      callID: input.callID,
+      hasFilePath: !!filePath,
+      hasPatch: !!patch,
+    })
+    return
+  }
+
+  if (!existsSync(filePath)) {
+    log("[fast-apply] Skipping: file does not exist (new file)", {
+      sessionID: input.sessionID,
+      callID: input.callID,
+      filePath,
+    })
+    return
+  }
+
+  let originalContent: string
+  try {
+    originalContent = readFileSync(filePath, "utf-8")
+  } catch (err) {
+    log("[fast-apply] Failed to read file, falling back to default", {
+      sessionID: input.sessionID,
+      callID: input.callID,
+      filePath,
+      error: String(err),
+    })
+    return
+  }
+
+  try {
+    log("[fast-apply] Sending to Ollama", {
+      sessionID: input.sessionID,
+      callID: input.callID,
+      filePath,
+      model: config.model,
+    })
+
+    const newContent = await queryOllama({
+      originalContent,
+      patch,
+      config,
+    })
+
+    output.args.content = newContent
+    output.args.patch = undefined
+
+    log("[fast-apply] Patch replaced with Ollama result", {
+      sessionID: input.sessionID,
+      callID: input.callID,
+      filePath,
+      originalLength: originalContent.length,
+      newLength: newContent.length,
+    })
+  } catch (err) {
+    log("[fast-apply] Ollama failed, falling back to default apply_patch", {
+      sessionID: input.sessionID,
+      callID: input.callID,
+      filePath,
+      error: String(err),
+    })
+  }
+}

package/src/hooks/guard/AGENTS.md

@@ -1,64 +1,64 @@
-# src/hooks/guard/ — Master Boulder Orchestrator
-
-**Generated:** 2026-04-11
-
-## OVERVIEW
-
-17 files (~1976 LOC). The `guardHook` — Continuation Tier hook that monitors session.idle events and forces continuation when boulder sessions (ralph-loop, task-spawned agents) have incomplete work. Also enforces write/edit policies for subagent sessions.
-
-## WHAT ATLAS DOES
-
-Guard is the "keeper of sessions" — it tracks every session and decides:
-1. Should this session be forced to continue? (if boulder session with incomplete todos)
-2. Should write/edit be blocked? (policy enforcement for certain session types)
-3. Should a verification reminder be injected? (after tool execution)
-
-## DECISION GATE (session.idle)
-
-```
-session.idle event
-  → Is this a boulder/ralph/guard session? (session-last-agent.ts)
-  → Is there an abort signal? (is-abort-error.ts)
-  → Failure count < max? (state.promptFailureCount)
-  → No running background tasks?
-  → Agent matches expected? (recent-model-resolver.ts)
-  → Plan complete? (todo status)
-  → Cooldown passed? (5s between injections)
-  → Inject continuation prompt (boulder-continuation-injector.ts)
-```
-
-## KEY FILES
-
-| File | Purpose |
-|------|---------|
-| `guard-hook.ts` | `createGuardHook()` — composes event + tool handlers, maintains session state |
-| `event-handler.ts` | `createGuardEventHandler()` — decision gate for session.idle events |
-| `boulder-continuation-injector.ts` | Build + inject continuation prompt into session |
-| `system-reminder-templates.ts` | Templates for continuation reminder messages |
-| `tool-execute-before.ts` | Block write/edit based on session policy |
-| `tool-execute-after.ts` | Inject verification reminders post-tool |
-| `write-edit-tool-policy.ts` | Policy: which sessions can write/edit? |
-| `verification-reminders.ts` | Reminder content for verifying work |
-| `session-last-agent.ts` | Determine which agent owns the session |
-| `recent-model-resolver.ts` | Resolve model used in recent messages |
-| `subagent-session-id.ts` | Detect if session is a subagent session |
-| `bob-path.ts` | Resolve `.bob/` directory path |
-| `is-abort-error.ts` | Detect abort signals in session output |
-| `types.ts` | `SessionState`, `GuardHookOptions`, `GuardContext` |
-
-## STATE PER SESSION
-
-```typescript
-interface SessionState {
-  promptFailureCount: number  // Increments on failed continuations
-  // Resets on successful continuation
-}
-```
-
-Max consecutive failures before 5min pause: 5 (exponential backoff in todo-continuation-enforcer).
-
-## RELATIONSHIP TO OTHER HOOKS
-
-- **guardHook** (Continuation Tier): Master orchestrator, handles boulder sessions
-- **todoContinuationEnforcer** (Continuation Tier): "Boulder" mechanism for main Bob sessions
-- Both inject into session.idle but serve different session types
+# src/hooks/guard/ — Master Boulder Orchestrator
+
+**Generated:** 2026-04-11
+
+## OVERVIEW
+
+17 files (~1976 LOC). The `guardHook` — Continuation Tier hook that monitors session.idle events and forces continuation when boulder sessions (ralph-loop, task-spawned agents) have incomplete work. Also enforces write/edit policies for subagent sessions.
+
+## WHAT ATLAS DOES
+
+Guard is the "keeper of sessions" — it tracks every session and decides:
+1. Should this session be forced to continue? (if boulder session with incomplete todos)
+2. Should write/edit be blocked? (policy enforcement for certain session types)
+3. Should a verification reminder be injected? (after tool execution)
+
+## DECISION GATE (session.idle)
+
+```
+session.idle event
+  → Is this a boulder/ralph/guard session? (session-last-agent.ts)
+  → Is there an abort signal? (is-abort-error.ts)
+  → Failure count < max? (state.promptFailureCount)
+  → No running background tasks?
+  → Agent matches expected? (recent-model-resolver.ts)
+  → Plan complete? (todo status)
+  → Cooldown passed? (5s between injections)
+  → Inject continuation prompt (boulder-continuation-injector.ts)
+```
+
+## KEY FILES
+
+| File | Purpose |
+|------|---------|
+| `guard-hook.ts` | `createGuardHook()` — composes event + tool handlers, maintains session state |
+| `event-handler.ts` | `createGuardEventHandler()` — decision gate for session.idle events |
+| `boulder-continuation-injector.ts` | Build + inject continuation prompt into session |
+| `system-reminder-templates.ts` | Templates for continuation reminder messages |
+| `tool-execute-before.ts` | Block write/edit based on session policy |
+| `tool-execute-after.ts` | Inject verification reminders post-tool |
+| `write-edit-tool-policy.ts` | Policy: which sessions can write/edit? |
+| `verification-reminders.ts` | Reminder content for verifying work |
+| `session-last-agent.ts` | Determine which agent owns the session |
+| `recent-model-resolver.ts` | Resolve model used in recent messages |
+| `subagent-session-id.ts` | Detect if session is a subagent session |
+| `bob-path.ts` | Resolve `.bob/` directory path |
+| `is-abort-error.ts` | Detect abort signals in session output |
+| `types.ts` | `SessionState`, `GuardHookOptions`, `GuardContext` |
+
+## STATE PER SESSION
+
+```typescript
+interface SessionState {
+  promptFailureCount: number  // Increments on failed continuations
+  // Resets on successful continuation
+}
+```
+
+Max consecutive failures before 5min pause: 5 (exponential backoff in todo-continuation-enforcer).
+
+## RELATIONSHIP TO OTHER HOOKS
+
+- **guardHook** (Continuation Tier): Master orchestrator, handles boulder sessions
+- **todoContinuationEnforcer** (Continuation Tier): "Boulder" mechanism for main Bob sessions
+- Both inject into session.idle but serve different session types