@s_s/harmonia 1.0.0 → 1.1.1

package/build/hooks/content.js

@@ -0,0 +1,109 @@
+/**
+ * Hook content generation — shared configuration and rule definitions.
+ *
+ * Hook scripts run on the agent side (shell scripts for Claude Code,
+ * TS plugins for OpenCode, handlers for OpenClaw). They need to know:
+ *   - HARMONIA_DATA_DIR: where to read dispatches.json, state.json, etc.
+ *
+ * Project-specific info (name, dir) is NOT baked in — hooks are project-agnostic.
+ * Boundary guards work on tool names + code file extensions only.
+ * Proactive reminders scan all projects under the data directory.
+ */
+// ─── Boundary Rules ───
+/**
+ * Tool names that PM should not call directly (code modification tools).
+ * These are the standard agent tool names across different platforms.
+ */
+export const BLOCKED_TOOLS = [
+    // File writing tools
+    'Write',
+    'Edit',
+    'MultiEdit',
+    'write',
+    'edit',
+    // Bash/shell tools
+    'Bash',
+    'bash',
+    'Terminal',
+    'terminal',
+];
+/**
+ * Shell commands that indicate development work (PM should not run these).
+ */
+export const BLOCKED_COMMANDS = [
+    'npm run',
+    'npm test',
+    'npm start',
+    'npm run build',
+    'npx ',
+    'yarn ',
+    'pnpm ',
+    'bun ',
+    'node ',
+    'deno ',
+    'python ',
+    'cargo ',
+    'go run',
+    'go test',
+    'make ',
+    'gcc ',
+    'g++ ',
+    'javac ',
+    'mvn ',
+    'gradle ',
+];
+/**
+ * File extensions that indicate source code (PM should not modify these).
+ */
+export const CODE_EXTENSIONS = [
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.py',
+    '.rs',
+    '.go',
+    '.java',
+    '.c',
+    '.cpp',
+    '.h',
+    '.hpp',
+    '.cs',
+    '.rb',
+    '.php',
+    '.swift',
+    '.kt',
+    '.vue',
+    '.svelte',
+];
+/**
+ * Harmonia MCP tool names — these are always allowed since PM uses them
+ * through Harmonia's own tool system.
+ */
+export const HARMONIA_TOOLS = [
+    'project_init',
+    'project_set_scale',
+    'project_status',
+    'phase_update',
+    'role_dispatch',
+    'dispatch_report',
+    'doc_write',
+    'doc_read',
+    'doc_list',
+    'doc_approve',
+    'reject_doc',
+    'guard_set',
+    'guard_get',
+    'review_set_rule',
+    'review_list',
+];
+// ─── Timeout thresholds (minutes) ───
+/** Dispatch running timeout — warn after this many minutes */
+export const DISPATCH_TIMEOUT_MINUTES = 30;
+/** Phase idle timeout — warn after this many minutes with no tool calls */
+export const PHASE_IDLE_TIMEOUT_MINUTES = 15;
+/** Review pending timeout — warn after this many minutes */
+export const REVIEW_PENDING_TIMEOUT_MINUTES = 10;
+//# sourceMappingURL=content.js.map

package/build/hooks/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/hooks/content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,yBAAyB;AAEzB;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,qBAAqB;IACrB,OAAO;IACP,MAAM;IACN,WAAW;IACX,OAAO;IACP,MAAM;IACN,mBAAmB;IACnB,MAAM;IACN,MAAM;IACN,UAAU;IACV,UAAU;CACJ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,SAAS;IACT,UAAU;IACV,WAAW;IACX,eAAe;IACf,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,OAAO;IACP,OAAO;IACP,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO;IACP,MAAM;IACN,MAAM;IACN,QAAQ;IACR,MAAM;IACN,SAAS;CACH,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,OAAO;IACP,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,QAAQ;IACR,KAAK;IACL,MAAM;IACN,SAAS;CACH,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,cAAc;IACd,mBAAmB;IACnB,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,iBAAiB;IACjB,WAAW;IACX,UAAU;IACV,UAAU;IACV,aAAa;IACb,YAAY;IACZ,WAAW;IACX,WAAW;IACX,iBAAiB;IACjB,aAAa;CACP,CAAC;AAEX,uCAAuC;AAEvC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC"}

package/build/hooks/install.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Hook installation — entry point for installing/uninstalling agent hooks.
+ *
+ * Detects the host agent type and installs the appropriate hook definitions
+ * using agent-kit's installHooks API. Hook content is generated with baked-in
+ * data directory path. Hooks are project-agnostic.
+ */
+import { type AgentType, type HookInstallResult } from '@s_s/agent-kit';
+import type { HookParams } from './content.js';
+/**
+ * Install Harmonia hooks for the detected agent.
+ *
+ * Generates agent-specific hook content with baked-in data directory,
+ * then delegates to agent-kit for file writing and config merging.
+ *
+ * @param agentType - The host agent type (detected or user-specified)
+ * @param params - Parameters to bake into hook content (dataDir only)
+ * @returns Installation result from agent-kit
+ */
+export declare function installHooks(agentType: AgentType, params: HookParams): Promise<HookInstallResult>;
+/**
+ * Uninstall Harmonia hooks for the given agent.
+ *
+ * Removes hook files and config entries installed by Harmonia.
+ */
+export declare function uninstallHooks(agentType: AgentType): Promise<{
+    success: boolean;
+    removed: string[];
+    error?: string;
+}>;
+/**
+ * Check if Harmonia hooks are installed for the given agent.
+ */
+export declare function hasHooksInstalled(agentType: AgentType): Promise<boolean>;
+/**
+ * Create hook definitions for a specific agent type.
+ *
+ * @internal — exposed for testing
+ */
+export declare function createHooksForAgent(agentType: AgentType, params: HookParams): import("@s_s/agent-kit").HookSet<"claude-code"> | import("@s_s/agent-kit").HookSet<"opencode"> | import("@s_s/agent-kit").HookSet<"openclaw">;

package/build/hooks/install.js

@@ -0,0 +1,63 @@
+/**
+ * Hook installation — entry point for installing/uninstalling agent hooks.
+ *
+ * Detects the host agent type and installs the appropriate hook definitions
+ * using agent-kit's installHooks API. Hook content is generated with baked-in
+ * data directory path. Hooks are project-agnostic.
+ */
+import { createKit } from '@s_s/agent-kit';
+import { createClaudeCodeHooks } from './claude-code.js';
+import { createOpenCodeHooks } from './opencode.js';
+import { createOpenClawHooks } from './openclaw.js';
+/** Shared kit instance for hook management */
+const kit = createKit('harmonia');
+/**
+ * Install Harmonia hooks for the detected agent.
+ *
+ * Generates agent-specific hook content with baked-in data directory,
+ * then delegates to agent-kit for file writing and config merging.
+ *
+ * @param agentType - The host agent type (detected or user-specified)
+ * @param params - Parameters to bake into hook content (dataDir only)
+ * @returns Installation result from agent-kit
+ */
+export async function installHooks(agentType, params) {
+    const hooks = createHooksForAgent(agentType, params);
+    return kit.installHooks(agentType, hooks);
+}
+/**
+ * Uninstall Harmonia hooks for the given agent.
+ *
+ * Removes hook files and config entries installed by Harmonia.
+ */
+export async function uninstallHooks(agentType) {
+    return kit.uninstallHooks(agentType);
+}
+/**
+ * Check if Harmonia hooks are installed for the given agent.
+ */
+export async function hasHooksInstalled(agentType) {
+    return kit.hasHooksInstalled(agentType);
+}
+/**
+ * Create hook definitions for a specific agent type.
+ *
+ * @internal — exposed for testing
+ */
+export function createHooksForAgent(agentType, params) {
+    switch (agentType) {
+        case 'claude-code':
+        case 'codex':
+            return createClaudeCodeHooks(params);
+        case 'opencode':
+            return createOpenCodeHooks(params);
+        case 'openclaw':
+            return createOpenClawHooks(params);
+        default: {
+            // Exhaustive check — should never reach here
+            const _exhaustive = agentType;
+            throw new Error(`Unsupported agent type: ${_exhaustive}`);
+        }
+    }
+}
+//# sourceMappingURL=install.js.map

package/build/hooks/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/hooks/install.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAA0C,MAAM,gBAAgB,CAAC;AAEnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,8CAA8C;AAC9C,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;AAElC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAoB,EAAE,MAAkB;IACvE,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,SAAoB;IAEpB,OAAO,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAoB;IACxD,OAAO,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAoB,EAAE,MAAkB;IACxE,QAAQ,SAAS,EAAE,CAAC;QAChB,KAAK,aAAa,CAAC;QACnB,KAAK,OAAO;YACR,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACzC,KAAK,UAAU;YACX,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,UAAU;YACX,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACvC,OAAO,CAAC,CAAC,CAAC;YACN,6CAA6C;YAC7C,MAAM,WAAW,GAAU,SAAS,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,2BAA2B,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;IACL,CAAC;AACL,CAAC"}

package/build/hooks/openclaw.d.ts

@@ -0,0 +1,24 @@
+/**
+ * OpenClaw hook definitions.
+ *
+ * OpenClaw hooks use HOOK.md (YAML frontmatter) + handler.ts.
+ * agent-kit generates HOOK.md from events/description, user provides handler.ts content.
+ *
+ * Key capabilities:
+ * - `before_tool_call` — can BLOCK tool calls (return { block: true, reason })
+ * - `message_received` — fires on each user message (return { inject: '...' } for reminders)
+ *
+ * OpenClaw only supports a single HookDefinition (array takes first only),
+ * so we combine both events into one handler.
+ *
+ * Project-agnostic: no project name/dir baked in.
+ * - Boundary guard uses tool names + code file extensions only
+ * - Reminders scan all projects under DATA_DIR
+ */
+import type { HookParams } from './content.js';
+/**
+ * Create OpenClaw hook definitions using agent-kit's defineHooks.
+ *
+ * Single definition with two events (OpenClaw only supports one HookDefinition).
+ */
+export declare function createOpenClawHooks(params: HookParams): import("@s_s/agent-kit").HookSet<"openclaw">;

package/build/hooks/openclaw.js

@@ -0,0 +1,219 @@
+/**
+ * OpenClaw hook definitions.
+ *
+ * OpenClaw hooks use HOOK.md (YAML frontmatter) + handler.ts.
+ * agent-kit generates HOOK.md from events/description, user provides handler.ts content.
+ *
+ * Key capabilities:
+ * - `before_tool_call` — can BLOCK tool calls (return { block: true, reason })
+ * - `message_received` — fires on each user message (return { inject: '...' } for reminders)
+ *
+ * OpenClaw only supports a single HookDefinition (array takes first only),
+ * so we combine both events into one handler.
+ *
+ * Project-agnostic: no project name/dir baked in.
+ * - Boundary guard uses tool names + code file extensions only
+ * - Reminders scan all projects under DATA_DIR
+ */
+import { defineHooks } from '@s_s/agent-kit';
+import { BLOCKED_COMMANDS, CODE_EXTENSIONS, DISPATCH_TIMEOUT_MINUTES, PHASE_IDLE_TIMEOUT_MINUTES, REVIEW_PENDING_TIMEOUT_MINUTES, } from './content.js';
+/**
+ * Generate the OpenClaw handler.ts source code.
+ *
+ * Handles two events:
+ * 1. before_tool_call — boundary guard: block code edits and dev commands
+ * 2. message_received — proactive reminders: dispatch timeout, idle phase, pending reviews
+ */
+function generateOpenClawHandler(params) {
+    const codeExtsJson = JSON.stringify(CODE_EXTENSIONS);
+    const blockedCmdsJson = JSON.stringify(BLOCKED_COMMANDS);
+    return `import { readFileSync, readdirSync, statSync } from 'fs';
+import { resolve, join } from 'path';
+
+// ── Baked-in constants (generated by Harmonia setup) ──
+const DATA_DIR = ${JSON.stringify(params.dataDir)};
+
+const CODE_EXTENSIONS: readonly string[] = ${codeExtsJson};
+const BLOCKED_COMMANDS: readonly string[] = ${blockedCmdsJson};
+const DISPATCH_TIMEOUT_MINUTES = ${DISPATCH_TIMEOUT_MINUTES};
+const PHASE_IDLE_TIMEOUT_MINUTES = ${PHASE_IDLE_TIMEOUT_MINUTES};
+const REVIEW_PENDING_TIMEOUT_MINUTES = ${REVIEW_PENDING_TIMEOUT_MINUTES};
+
+// ── Helpers ──
+
+function isCodeFile(filePath: string): boolean {
+    return CODE_EXTENSIONS.some((ext) => filePath.endsWith(ext));
+}
+
+function hasBlockedCommand(command: string): string | null {
+    for (const cmd of BLOCKED_COMMANDS) {
+        if (command.includes(cmd)) return cmd;
+    }
+    return null;
+}
+
+function readJsonSafe(filePath: string): any {
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    } catch {
+        return null;
+    }
+}
+
+function minutesSince(isoDate: string): number {
+    const then = new Date(isoDate).getTime();
+    if (isNaN(then)) return 0;
+    return Math.floor((Date.now() - then) / 60000);
+}
+
+/** List project directories under DATA_DIR */
+function listProjectDirs(): Array<{ name: string; path: string }> {
+    try {
+        const entries = readdirSync(DATA_DIR);
+        const projects: Array<{ name: string; path: string }> = [];
+        for (const entry of entries) {
+            const full = join(DATA_DIR, entry);
+            try {
+                if (statSync(full).isDirectory()) {
+                    projects.push({ name: entry, path: full });
+                }
+            } catch {
+                // skip inaccessible entries
+            }
+        }
+        return projects;
+    } catch {
+        return [];
+    }
+}
+
+// ── Boundary guard (before_tool_call) ──
+
+function handleBeforeToolCall(event: any): any {
+    const toolName = event.tool_name || event.toolName || '';
+    const toolInput = event.tool_input || event.toolInput || {};
+
+    // Guard 1: Write/Edit tools — check file extension
+    if (['Write', 'Edit', 'MultiEdit', 'write', 'edit'].includes(toolName)) {
+        const filePath = toolInput.file_path || toolInput.filePath || toolInput.path || '';
+        if (filePath && isCodeFile(filePath)) {
+            return {
+                block: true,
+                reason: \`PM 不应直接修改代码文件。请通过 role_dispatch 将编码任务分配给 developer。文件: \${filePath}\`,
+            };
+        }
+    }
+
+    // Guard 2: Bash/Terminal — check for dev commands
+    if (['Bash', 'bash', 'Terminal', 'terminal'].includes(toolName)) {
+        const command = toolInput.command || toolInput.cmd || '';
+        if (command) {
+            const blocked = hasBlockedCommand(command);
+            if (blocked) {
+                return {
+                    block: true,
+                    reason: \`PM 不应直接执行开发命令 (\${blocked}...)。请通过 role_dispatch 将任务分配给相应角色（developer/tester）。\`,
+                };
+            }
+        }
+    }
+
+    return event;
+}
+
+// ── Proactive reminders (message_received) ──
+
+function handleMessageReceived(): any {
+    const reminders: string[] = [];
+    const projects = listProjectDirs();
+
+    for (const proj of projects) {
+        // Check 1: Running dispatch timeout
+        const dispatches = readJsonSafe(resolve(proj.path, 'dispatches.json'));
+        if (dispatches && Array.isArray(dispatches)) {
+            for (const d of dispatches) {
+                if ((d.status === 'running' || d.status === 'dispatched') && d.updatedAt) {
+                    const elapsed = minutesSince(d.updatedAt);
+                    if (elapsed >= DISPATCH_TIMEOUT_MINUTES) {
+                        reminders.push(
+                            \`- [\${proj.name}] dispatch \${d.id} (\${d.role}) 已运行 \${elapsed} 分钟，建议调用 project_status 检查进度\`,
+                        );
+                    }
+                }
+            }
+        }
+
+        // Check 2: Pending document reviews
+        const reviews = readJsonSafe(resolve(proj.path, 'reviews.json'));
+        if (reviews && typeof reviews === 'object') {
+            const pendingDocs: string[] = [];
+            for (const [docId, review] of Object.entries<any>(reviews)) {
+                if (review.status === 'pending' && review.submittedAt) {
+                    const elapsed = minutesSince(review.submittedAt);
+                    if (elapsed >= REVIEW_PENDING_TIMEOUT_MINUTES) {
+                        pendingDocs.push(docId);
+                    }
+                }
+            }
+            if (pendingDocs.length > 0) {
+                reminders.push(
+                    \`- [\${proj.name}] \${pendingDocs.length} 份文档待审核超过 \${REVIEW_PENDING_TIMEOUT_MINUTES} 分钟: \${pendingDocs.join(', ')} — 请尽快处理（doc_approve / reject_doc）\`,
+                );
+            }
+        }
+
+        // Check 3: Phase idle check
+        const state = readJsonSafe(resolve(proj.path, 'state.json'));
+        if (state && state.updatedAt && state.currentPhase) {
+            const idle = minutesSince(state.updatedAt);
+            if (idle >= PHASE_IDLE_TIMEOUT_MINUTES) {
+                reminders.push(
+                    \`- [\${proj.name}] 当前阶段 (\${state.currentPhase}) 已空闲 \${idle} 分钟，建议调用 project_status 检查项目状态\`,
+                );
+            }
+        }
+    }
+
+    if (reminders.length > 0) {
+        return {
+            inject: \`<harmonia-reminder>
+以下事项需要你的关注：
+
+\${reminders.join('\\n')}
+
+请根据提醒采取相应行动。
+</harmonia-reminder>\`,
+        };
+    }
+
+    return {};
+}
+
+// ── Main handler ──
+
+export default async function handler(event: any) {
+    if (event.type === 'before_tool_call') {
+        return handleBeforeToolCall(event);
+    }
+
+    if (event.type === 'message_received') {
+        return handleMessageReceived();
+    }
+
+    return event;
+}
+`;
+}
+/**
+ * Create OpenClaw hook definitions using agent-kit's defineHooks.
+ *
+ * Single definition with two events (OpenClaw only supports one HookDefinition).
+ */
+export function createOpenClawHooks(params) {
+    return defineHooks('openclaw', {
+        events: ['message_received', 'before_tool_call'],
+        content: generateOpenClawHandler(params),
+        description: 'Harmonia PM 边界守卫与状态提醒',
+    });
+}
+//# sourceMappingURL=openclaw.js.map

package/build/hooks/openclaw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw.js","sourceRoot":"","sources":["../../src/hooks/openclaw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EACH,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,GACjC,MAAM,cAAc,CAAC;AAEtB;;;;;;GAMG;AACH,SAAS,uBAAuB,CAAC,MAAkB;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAEzD,OAAO;;;;mBAIQ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;;6CAEJ,YAAY;8CACX,eAAe;mCAC1B,wBAAwB;qCACtB,0BAA0B;yCACtB,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqKtE,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IAClD,OAAO,WAAW,CAAC,UAAU,EAAE;QAC3B,MAAM,EAAE,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;QAChD,OAAO,EAAE,uBAAuB,CAAC,MAAM,CAAC;QACxC,WAAW,EAAE,uBAAuB;KACvC,CAAC,CAAC;AACP,CAAC"}

package/build/hooks/opencode.d.ts

@@ -0,0 +1,29 @@
+/**
+ * OpenCode hook definitions.
+ *
+ * OpenCode hooks are TypeScript plugins installed to ~/.config/opencode/plugins/.
+ * They export a Plugin object with hooks keyed by event name.
+ *
+ * Limitations vs Claude Code:
+ * - `tool.execute.before` can modify args but CANNOT block tool calls.
+ * - No true blocking mechanism (permission.ask is too coarse).
+ *
+ * Strategy: "soft interception + reminder injection"
+ * 1. tool.execute.before — detect boundary violations, replace args to neutralize
+ *    the operation (e.g., prepend echo to bash commands, empty write content)
+ *    and inject a warning message.
+ * 2. experimental.chat.messages.transform — read Harmonia data files, inject
+ *    reminders about dispatch timeouts, idle phases, pending reviews.
+ *
+ * Project-agnostic: no project name/dir baked in.
+ * - Boundary guard uses tool names + code file extensions only
+ * - Reminders scan all projects under DATA_DIR
+ */
+import type { HookParams } from './content.js';
+/**
+ * Create OpenCode hook definitions using agent-kit's defineHooks.
+ *
+ * Produces a single plugin file with both tool.execute.before and
+ * experimental.chat.messages.transform hooks.
+ */
+export declare function createOpenCodeHooks(params: HookParams): import("@s_s/agent-kit").HookSet<"opencode">;