@s_s/harmonia 1.2.0 → 1.4.0

package/build/tools/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s_s/harmonia",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Multi-agent orchestration MCP server with pluggable workflows",
   "type": "module",
   "main": "./build/index.js",

package/{build/hooks/claude-code.js → workflows/dev/hooks/claude.js}

@@ -7,14 +7,21 @@
  *
  * Hooks:
  * 1. PreToolUse — boundary guard: block code edits and dev commands
- * 2. UserPromptSubmit — proactive reminders: dispatch timeout, idle phase, pending reviews
+ * 2. UserPromptSubmit — proactive reminders: dispatch timeout, idle timeout, 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 { 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';
+
+import {
+    BLOCKED_COMMANDS,
+    CODE_EXTENSIONS,
+    DISPATCH_TIMEOUT_MINUTES,
+    WORKFLOW_IDLE_TIMEOUT_MINUTES,
+    REVIEW_PENDING_TIMEOUT_MINUTES,
+} from './content.js';
+
 /**
  * Generate Claude Code PreToolUse hook script.
  *
@@ -30,9 +37,10 @@ import { BLOCKED_COMMANDS, CODE_EXTENSIONS, DISPATCH_TIMEOUT_MINUTES, PHASE_IDLE
 function generatePreToolUseScript(_params) {
     const codeExtsPattern = CODE_EXTENSIONS.map((e) => `*${e}`).join('|');
     const blockedCmdsChecks = BLOCKED_COMMANDS.map((cmd) => `  *"${cmd}"*) BLOCKED_CMD="${cmd}" ;;`).join('\n');
+
     return `#!/bin/bash
-# Harmonia PM boundary guard — PreToolUse hook
-# Prevents PM from directly modifying code or running dev commands.
+# Harmonia coordinator boundary guard — PreToolUse hook
+# Prevents coordinator from directly modifying code or running dev commands.
 # Generated by Harmonia setup. Do not edit manually.
 
 set -euo pipefail
@@ -61,7 +69,7 @@ case "$TOOL_NAME" in
     # Block writes to code files (by extension)
     case "$FILE_PATH" in
       ${codeExtsPattern})
-        block "PM 不应直接修改代码文件。请通过 role_dispatch 将编码任务分配给 developer。文件: $FILE_PATH"
+        block "Coordinator 不应直接修改代码文件。请通过 role_dispatch 将编码任务分配给 developer。文件: $FILE_PATH"
         ;;
     esac
     ;;
@@ -82,7 +90,7 @@ ${blockedCmdsChecks}
     esac
 
     if [ -n "$BLOCKED_CMD" ]; then
-      block "PM 不应直接执行开发命令 ($BLOCKED_CMD...)。请通过 role_dispatch 将任务分配给相应角色（developer/tester）。"
+      block "Coordinator 不应直接执行开发命令 ($BLOCKED_CMD...)。请通过 role_dispatch 将任务分配给相应角色（developer/tester）。"
     fi
     ;;
 esac
@@ -91,13 +99,14 @@ esac
 exit 0
 `;
 }
+
 /**
  * Generate Claude Code UserPromptSubmit hook script.
  *
  * Scans all projects under DATA_DIR for:
  * - Running dispatches that exceed timeout
- * - Idle phase warning
- * - Pending document reviews
+ * - Idle timeout warning
+ * - Pending artifact reviews
  */
 function generateUserPromptSubmitScript(params) {
     return `#!/bin/bash
@@ -143,42 +152,41 @@ if [ -d "$DATA_DIR" ]; then
       done <<< "$RUNNING"
     fi
 
-    # ── Check 2: Pending document reviews ──
+    # ── Check 2: Pending artifact reviews ──
     REVIEWS_FILE="$PROJECT_DATA/reviews.json"
     if [ -f "$REVIEWS_FILE" ]; then
       PENDING=$(jq -r 'to_entries[] | select(.value.status == "pending") | "\\(.key)|\\(.value.submittedAt)"' "$REVIEWS_FILE" 2>/dev/null || true)
       PENDING_COUNT=0
-      PENDING_DOCS=""
+      PENDING_ARTIFACTS=""
       
-      while IFS='|' read -r DOC_ID SUBMITTED_AT; do
-        [ -z "$DOC_ID" ] && continue
+      while IFS='|' read -r ARTIFACT_ID SUBMITTED_AT; do
+        [ -z "$ARTIFACT_ID" ] && continue
         SUBMITTED_EPOCH=$(date -j -f "%Y-%m-%dT%H:%M:%S" "$(echo "$SUBMITTED_AT" | cut -c1-19)" +%s 2>/dev/null || echo "0")
         if [ "$SUBMITTED_EPOCH" != "0" ]; then
           ELAPSED_MIN=$(( (NOW_EPOCH - SUBMITTED_EPOCH) / 60 ))
           if [ "$ELAPSED_MIN" -ge ${REVIEW_PENDING_TIMEOUT_MINUTES} ]; then
             PENDING_COUNT=$((PENDING_COUNT + 1))
-            PENDING_DOCS="$PENDING_DOCS $DOC_ID"
+            PENDING_ARTIFACTS="$PENDING_ARTIFACTS $ARTIFACT_ID"
           fi
         fi
       done <<< "$PENDING"
       
       if [ "$PENDING_COUNT" -gt 0 ]; then
-        add_reminder "- [$PROJECT_NAME] $PENDING_COUNT 份文档待审核超过 ${REVIEW_PENDING_TIMEOUT_MINUTES} 分钟:$PENDING_DOCS — 请尽快处理（doc_approve / reject_doc）"
+        add_reminder "- [$PROJECT_NAME] $PENDING_COUNT 份产出待审核超过 ${REVIEW_PENDING_TIMEOUT_MINUTES} 分钟:$PENDING_ARTIFACTS — 请尽快处理（artifact_approve）"
       fi
     fi
 
-    # ── Check 3: Phase idle check ──
+    # ── Check 3: Workflow idle check ──
     STATE_FILE="$PROJECT_DATA/state.json"
     if [ -f "$STATE_FILE" ]; then
       UPDATED_AT=$(jq -r '.updatedAt // empty' "$STATE_FILE" 2>/dev/null || true)
-      CURRENT_PHASE=$(jq -r '.currentPhase // empty' "$STATE_FILE" 2>/dev/null || true)
       
-      if [ -n "$UPDATED_AT" ] && [ -n "$CURRENT_PHASE" ]; then
+      if [ -n "$UPDATED_AT" ]; then
         STATE_EPOCH=$(date -j -f "%Y-%m-%dT%H:%M:%S" "$(echo "$UPDATED_AT" | cut -c1-19)" +%s 2>/dev/null || echo "0")
         if [ "$STATE_EPOCH" != "0" ]; then
           IDLE_MIN=$(( (NOW_EPOCH - STATE_EPOCH) / 60 ))
-          if [ "$IDLE_MIN" -ge ${PHASE_IDLE_TIMEOUT_MINUTES} ]; then
-            add_reminder "- [$PROJECT_NAME] 当前阶段 ($CURRENT_PHASE) 已空闲 $IDLE_MIN 分钟，建议调用 project_status 检查项目状态"
+          if [ "$IDLE_MIN" -ge ${WORKFLOW_IDLE_TIMEOUT_MINUTES} ]; then
+            add_reminder "- [$PROJECT_NAME] 工作流已空闲 $IDLE_MIN 分钟，建议调用 project_status 检查项目状态"
           fi
         fi
       fi
@@ -200,10 +208,14 @@ fi
 exit 0
 `;
 }
+
 /**
- * Create Claude Code hook definitions using agent-kit's defineHooks.
+ * Create Claude Code hook definitions using defineHooks from context.
+ *
+ * @param {Function} defineHooks - defineHooks function from agent-kit (passed via context)
+ * @param {{ dataDir: string }} params - Parameters to bake into hook content
  */
-export function createClaudeCodeHooks(params) {
+export function createClaudeCodeHooks(defineHooks, params) {
     return defineHooks('claude-code', [
         {
             events: ['PreToolUse'],
@@ -215,4 +227,3 @@ export function createClaudeCodeHooks(params) {
         },
     ]);
 }
-//# sourceMappingURL=claude-code.js.map

package/{build → workflows/dev}/hooks/content.js

@@ -1,5 +1,5 @@
 /**
- * Hook content generation — shared configuration and rule definitions.
+ * Hook content — 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:
@@ -9,9 +9,11 @@
  * 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).
+ * Tool names that coordinator should not call directly (code modification tools).
  * These are the standard agent tool names across different platforms.
  */
 export const BLOCKED_TOOLS = [
@@ -27,8 +29,9 @@ export const BLOCKED_TOOLS = [
     'Terminal',
     'terminal',
 ];
+
 /**
- * Shell commands that indicate development work (PM should not run these).
+ * Shell commands that indicate development work (coordinator should not run these).
  */
 export const BLOCKED_COMMANDS = [
     'npm run',
@@ -52,8 +55,9 @@ export const BLOCKED_COMMANDS = [
     'mvn ',
     'gradle ',
 ];
+
 /**
- * File extensions that indicate source code (PM should not modify these).
+ * File extensions that indicate source code (coordinator should not modify these).
  */
 export const CODE_EXTENSIONS = [
     '.ts',
@@ -78,32 +82,37 @@ export const CODE_EXTENSIONS = [
     '.vue',
     '.svelte',
 ];
+
 /**
- * Harmonia MCP tool names — these are always allowed since PM uses them
+ * Harmonia MCP tool names — these are always allowed since coordinator uses them
  * through Harmonia's own tool system.
  */
 export const HARMONIA_TOOLS = [
     'project_init',
-    'project_set_scale',
     'project_status',
-    'phase_update',
+    'iteration_start',
+    'patch_start',
     'role_dispatch',
     'dispatch_report',
-    'doc_write',
-    'doc_read',
-    'doc_list',
-    'doc_approve',
-    'reject_doc',
-    'guard_set',
-    'guard_get',
-    'review_set_rule',
+    'artifact_write',
+    'artifact_read',
+    'artifact_list',
+    'artifact_approve',
+    'artifact_schema',
     'review_list',
+    'role_prompt',
+    'issue_create',
+    'issue_update',
+    'issue_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;
+
+/** Workflow idle timeout — warn after this many minutes with no tool calls */
+export const WORKFLOW_IDLE_TIMEOUT_MINUTES = 15;
+
 /** Review pending timeout — warn after this many minutes */
 export const REVIEW_PENDING_TIMEOUT_MINUTES = 10;
-//# sourceMappingURL=content.js.map

package/workflows/dev/hooks/index.js

@@ -0,0 +1,52 @@
+/**
+ * Dev workflow plugin — hook creator.
+ *
+ * Entry point for hook creation. All hook generation logic lives in
+ * sibling files within this directory — no cross-directory imports.
+ *
+ * The defineHooks function is received from Core via context — this module
+ * does NOT directly depend on @s_s/agent-kit.
+ */
+
+import { createClaudeCodeHooks } from './claude.js';
+import { createOpenCodeHooks } from './opencode.js';
+import { createOpenClawHooks } from './openclaw.js';
+
+/**
+ * Create hook definitions for a specific agent type.
+ *
+ * Routes to the appropriate agent-specific hook generator,
+ * passing through the defineHooks function from context.
+ *
+ * @param {Function} defineHooks - defineHooks function from agent-kit (passed via context)
+ * @param {string} agentType - Agent type (opencode, claude-code, openclaw, codex)
+ * @param {{ dataDir: string }} params - Parameters to bake into hook content
+ * @returns {import('@s_s/agent-kit').HookSet} Hook set for the agent
+ */
+function createHooksForAgent(defineHooks, agentType, params) {
+    switch (agentType) {
+        case 'claude-code':
+        case 'codex':
+            return createClaudeCodeHooks(defineHooks, params);
+        case 'opencode':
+            return createOpenCodeHooks(defineHooks, params);
+        case 'openclaw':
+            return createOpenClawHooks(defineHooks, params);
+        default:
+            throw new Error(`Unsupported agent type: ${agentType}`);
+    }
+}
+
+/**
+ * Create hooks for the dev workflow.
+ *
+ * Matches the HookCreator signature: (agentType, context) => HookSet.
+ * Called by the plugin system during project_init.
+ *
+ * @param {string} agentType - Agent type (opencode, claude-code, openclaw, codex)
+ * @param {{ defineHooks: Function, dataDir: string, projectName: string }} context
+ * @returns {import('@s_s/agent-kit').HookSet} Hook set for the agent
+ */
+export function createHooks(agentType, context) {
+    return createHooksForAgent(context.defineHooks, agentType, { dataDir: context.dataDir });
+}

package/{build → workflows/dev}/hooks/openclaw.js

@@ -15,18 +15,26 @@
  * - 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';
+
+import {
+    BLOCKED_COMMANDS,
+    CODE_EXTENSIONS,
+    DISPATCH_TIMEOUT_MINUTES,
+    WORKFLOW_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
+ * 2. message_received — proactive reminders: dispatch timeout, idle timeout, 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';
 
@@ -36,7 +44,7 @@ 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 WORKFLOW_IDLE_TIMEOUT_MINUTES = ${WORKFLOW_IDLE_TIMEOUT_MINUTES};
 const REVIEW_PENDING_TIMEOUT_MINUTES = ${REVIEW_PENDING_TIMEOUT_MINUTES};
 
 // ── Helpers ──
@@ -99,7 +107,7 @@ function handleBeforeToolCall(event: any): any {
         if (filePath && isCodeFile(filePath)) {
             return {
                 block: true,
-                reason: \`PM 不应直接修改代码文件。请通过 role_dispatch 将编码任务分配给 developer。文件: \${filePath}\`,
+                reason: \`Coordinator 不应直接修改代码文件。请通过 role_dispatch 将编码任务分配给 developer。文件: \${filePath}\`,
             };
         }
     }
@@ -112,7 +120,7 @@ function handleBeforeToolCall(event: any): any {
             if (blocked) {
                 return {
                     block: true,
-                    reason: \`PM 不应直接执行开发命令 (\${blocked}...)。请通过 role_dispatch 将任务分配给相应角色（developer/tester）。\`,
+                    reason: \`Coordinator 不应直接执行开发命令 (\${blocked}...)。请通过 role_dispatch 将任务分配给相应角色（developer/tester）。\`,
                 };
             }
         }
@@ -143,32 +151,32 @@ function handleMessageReceived(): any {
             }
         }
 
-        // Check 2: Pending document reviews
+        // Check 2: Pending artifact 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)) {
+            const pendingArtifacts: string[] = [];
+            for (const [artifactId, 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);
+                        pendingArtifacts.push(artifactId);
                     }
                 }
             }
-            if (pendingDocs.length > 0) {
+            if (pendingArtifacts.length > 0) {
                 reminders.push(
-                    \`- [\${proj.name}] \${pendingDocs.length} 份文档待审核超过 \${REVIEW_PENDING_TIMEOUT_MINUTES} 分钟: \${pendingDocs.join(', ')} — 请尽快处理（doc_approve / reject_doc）\`,
+                    \`- [\${proj.name}] \${pendingArtifacts.length} 份产出待审核超过 \${REVIEW_PENDING_TIMEOUT_MINUTES} 分钟: \${pendingArtifacts.join(', ')} — 请尽快处理（artifact_approve）\`,
                 );
             }
         }
 
-        // Check 3: Phase idle check
+        // Check 3: Workflow idle check
         const state = readJsonSafe(resolve(proj.path, 'state.json'));
-        if (state && state.updatedAt && state.currentPhase) {
+        if (state && state.updatedAt) {
             const idle = minutesSince(state.updatedAt);
-            if (idle >= PHASE_IDLE_TIMEOUT_MINUTES) {
+            if (idle >= WORKFLOW_IDLE_TIMEOUT_MINUTES) {
                 reminders.push(
-                    \`- [\${proj.name}] 当前阶段 (\${state.currentPhase}) 已空闲 \${idle} 分钟，建议调用 project_status 检查项目状态\`,
+                    \`- [\${proj.name}] 工作流已空闲 \${idle} 分钟，建议调用 project_status 检查项目状态\`,
                 );
             }
         }
@@ -204,16 +212,19 @@ export default async function handler(event: any) {
 }
 `;
 }
+
 /**
- * Create OpenClaw hook definitions using agent-kit's defineHooks.
+ * Create OpenClaw hook definitions using defineHooks from context.
  *
  * Single definition with two events (OpenClaw only supports one HookDefinition).
+ *
+ * @param {Function} defineHooks - defineHooks function from agent-kit (passed via context)
+ * @param {{ dataDir: string }} params - Parameters to bake into hook content
  */
-export function createOpenClawHooks(params) {
+export function createOpenClawHooks(defineHooks, params) {
     return defineHooks('openclaw', {
         events: ['message_received', 'before_tool_call'],
         content: generateOpenClawHandler(params),
-        description: 'Harmonia PM 边界守卫与状态提醒',
+        description: 'Harmonia coordinator 边界守卫与状态提醒',
     });
 }
-//# sourceMappingURL=openclaw.js.map

package/{build → workflows/dev}/hooks/opencode.js

@@ -13,14 +13,21 @@
  *    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.
+ *    reminders about dispatch timeouts, idle timeouts, 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 { 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';
+
+import {
+    BLOCKED_COMMANDS,
+    CODE_EXTENSIONS,
+    DISPATCH_TIMEOUT_MINUTES,
+    WORKFLOW_IDLE_TIMEOUT_MINUTES,
+    REVIEW_PENDING_TIMEOUT_MINUTES,
+} from './content.js';
+
 /**
  * Generate the OpenCode plugin TypeScript source code.
  *
@@ -31,6 +38,7 @@ import { BLOCKED_COMMANDS, CODE_EXTENSIONS, DISPATCH_TIMEOUT_MINUTES, PHASE_IDLE
 function generateOpenCodePlugin(params) {
     const codeExtsJson = JSON.stringify(CODE_EXTENSIONS);
     const blockedCmdsJson = JSON.stringify(BLOCKED_COMMANDS);
+
     // We generate raw TS source as a string. All values from params/constants
     // are baked in as literals at generation time.
     return `import type { Plugin } from 'opencode';
@@ -43,7 +51,7 @@ 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 WORKFLOW_IDLE_TIMEOUT_MINUTES = ${WORKFLOW_IDLE_TIMEOUT_MINUTES};
 const REVIEW_PENDING_TIMEOUT_MINUTES = ${REVIEW_PENDING_TIMEOUT_MINUTES};
 
 // ── Helpers ──
@@ -112,7 +120,7 @@ export default {
                     // Neutralize: replace content with warning
                     output.args = {
                         ...args,
-                        content: \`[HARMONIA 拦截] PM 不应直接修改代码文件。请通过 role_dispatch 将编码任务分配给 developer。\\n原目标文件: \${filePath}\`,
+                        content: \`[HARMONIA 拦截] Coordinator 不应直接修改代码文件。请通过 role_dispatch 将编码任务分配给 developer。\\n原目标文件: \${filePath}\`,
                         oldString: '__HARMONIA_BLOCKED_EDIT__',
                         newString: '__HARMONIA_BLOCKED_EDIT__',
                     };
@@ -128,8 +136,8 @@ export default {
                     if (blocked) {
                         output.args = {
                             ...args,
-                            command: \`echo "[HARMONIA 拦截] PM 不应直接执行开发命令 (\${blocked}...)。请通过 role_dispatch 将任务分配给相应角色（developer/tester）。"\`,
-                            cmd: \`echo "[HARMONIA 拦截] PM 不应直接执行开发命令 (\${blocked}...)。请通过 role_dispatch 将任务分配给相应角色（developer/tester）。"\`,
+                            command: \`echo "[HARMONIA 拦截] Coordinator 不应直接执行开发命令 (\${blocked}...)。请通过 role_dispatch 将任务分配给相应角色（developer/tester）。"\`,
+                            cmd: \`echo "[HARMONIA 拦截] Coordinator 不应直接执行开发命令 (\${blocked}...)。请通过 role_dispatch 将任务分配给相应角色（developer/tester）。"\`,
                         };
                         return;
                     }
@@ -160,32 +168,32 @@ export default {
                     }
                 }
 
-                // Check 2: Pending document reviews
+                // Check 2: Pending artifact 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)) {
+                    const pendingArtifacts: string[] = [];
+                    for (const [artifactId, 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);
+                                pendingArtifacts.push(artifactId);
                             }
                         }
                     }
-                    if (pendingDocs.length > 0) {
+                    if (pendingArtifacts.length > 0) {
                         reminders.push(
-                            \`- [\${proj.name}] \${pendingDocs.length} 份文档待审核超过 \${REVIEW_PENDING_TIMEOUT_MINUTES} 分钟: \${pendingDocs.join(', ')} — 请尽快处理（doc_approve / reject_doc）\`,
+                            \`- [\${proj.name}] \${pendingArtifacts.length} 份产出待审核超过 \${REVIEW_PENDING_TIMEOUT_MINUTES} 分钟: \${pendingArtifacts.join(', ')} — 请尽快处理（artifact_approve）\`,
                         );
                     }
                 }
 
-                // Check 3: Phase idle check
+                // Check 3: Workflow idle check
                 const state = readJsonSafe(resolve(proj.path, 'state.json'));
-                if (state && state.updatedAt && state.currentPhase) {
+                if (state && state.updatedAt) {
                     const idle = minutesSince(state.updatedAt);
-                    if (idle >= PHASE_IDLE_TIMEOUT_MINUTES) {
+                    if (idle >= WORKFLOW_IDLE_TIMEOUT_MINUTES) {
                         reminders.push(
-                            \`- [\${proj.name}] 当前阶段 (\${state.currentPhase}) 已空闲 \${idle} 分钟，建议调用 project_status 检查项目状态\`,
+                            \`- [\${proj.name}] 工作流已空闲 \${idle} 分钟，建议调用 project_status 检查项目状态\`,
                         );
                     }
                 }
@@ -211,16 +219,19 @@ export default {
 } satisfies Plugin;
 `;
 }
+
 /**
- * Create OpenCode hook definitions using agent-kit's defineHooks.
+ * Create OpenCode hook definitions using defineHooks from context.
  *
  * Produces a single plugin file with both tool.execute.before and
  * experimental.chat.messages.transform hooks.
+ *
+ * @param {Function} defineHooks - defineHooks function from agent-kit (passed via context)
+ * @param {{ dataDir: string }} params - Parameters to bake into hook content
  */
-export function createOpenCodeHooks(params) {
+export function createOpenCodeHooks(defineHooks, params) {
     return defineHooks('opencode', {
         events: ['tool.execute.before', 'experimental.chat.messages.transform'],
         content: generateOpenCodePlugin(params),
     });
 }
-//# sourceMappingURL=opencode.js.map