@s_s/harmonia 1.2.0 → 1.4.0

package/build/core/workflow.js

@@ -1,140 +0,0 @@
-/**
- * Workflow loader — two-layer resolution for workflow definitions.
- *
- * Lookup priority:
- *   1. <data_dir>/.workflows/<name>/   (user custom — can override built-in)
- *   2. <package>/workflows/<name>/      (built-in fallback)
- */
-import { readFile, readdir, access } from 'node:fs/promises';
-import { join, parse } from 'node:path';
-import YAML from 'yaml';
-// ─── Errors ───
-export class WorkflowNotFoundError extends Error {
-    constructor(name, searched) {
-        const dirs = searched.map((d) => `  - ${d}`).join('\n');
-        super(`工作流 "${name}" 不存在。已搜索:\n${dirs}`);
-        this.name = 'WorkflowNotFoundError';
-    }
-}
-// ─── Internal helpers ───
-/**
- * Check if a file exists (async, no throw).
- */
-async function fileExists(path) {
-    try {
-        await access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Resolve the actual directory for a workflow name.
- * Custom dir takes priority over built-in dir.
- * Returns the resolved directory path.
- */
-export async function resolveWorkflowDir(builtinDir, customDir, name) {
-    const customPath = join(customDir, name, 'workflow.json');
-    if (await fileExists(customPath)) {
-        return join(customDir, name);
-    }
-    const builtinPath = join(builtinDir, name, 'workflow.json');
-    if (await fileExists(builtinPath)) {
-        return join(builtinDir, name);
-    }
-    throw new WorkflowNotFoundError(name, [join(customDir, name), join(builtinDir, name)]);
-}
-/**
- * Parse a role markdown file.
- * Format: YAML frontmatter (---\n...\n---) followed by markdown prompt.
- */
-function parseRoleFile(id, content) {
-    const fmRegex = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
-    const match = content.match(fmRegex);
-    if (!match) {
-        return {
-            id,
-            frontmatter: { model: 'medium', session: 'none', parallel: false },
-            prompt: content.trim(),
-        };
-    }
-    const yamlBlock = match[1];
-    const prompt = match[2].trim();
-    const parsed = YAML.parse(yamlBlock);
-    const fm = parsed ?? {};
-    const capabilities = Array.isArray(fm.capabilities) ? fm.capabilities : undefined;
-    const frontmatter = {
-        model: fm.model ?? 'medium',
-        session: fm.session ?? 'none',
-        parallel: fm.parallel ?? false,
-        ...(capabilities ? { capabilities } : {}),
-    };
-    return { id, frontmatter, prompt };
-}
-// ─── Public API ───
-/**
- * Load a single workflow by name using two-layer resolution.
- *
- * @param builtinDir - Package built-in workflows directory
- * @param customDir  - User custom workflows directory (<data_dir>/.workflows)
- * @param name       - Workflow name (directory name)
- */
-export async function loadWorkflow(builtinDir, customDir, name) {
-    const workflowDir = await resolveWorkflowDir(builtinDir, customDir, name);
-    // Load workflow.json
-    const workflowJson = await readFile(join(workflowDir, 'workflow.json'), 'utf-8');
-    const definition = JSON.parse(workflowJson);
-    // Load roles
-    const rolesDir = join(workflowDir, 'roles');
-    let roleFiles = [];
-    try {
-        roleFiles = await readdir(rolesDir);
-    }
-    catch {
-        // roles/ directory is optional for custom workflows
-    }
-    const roles = {};
-    for (const file of roleFiles) {
-        if (!file.endsWith('.md'))
-            continue;
-        const roleId = parse(file).name;
-        const content = await readFile(join(rolesDir, file), 'utf-8');
-        roles[roleId] = parseRoleFile(roleId, content);
-    }
-    return { definition, roles };
-}
-/**
- * List all available workflow names, merging custom and built-in.
- * Custom workflows override built-in ones with the same name.
- *
- * @param builtinDir - Package built-in workflows directory
- * @param customDir  - User custom workflows directory (<data_dir>/.workflows)
- */
-export async function listWorkflows(builtinDir, customDir) {
-    const names = new Set();
-    // Built-in workflows
-    try {
-        const entries = await readdir(builtinDir, { withFileTypes: true });
-        for (const e of entries) {
-            if (e.isDirectory())
-                names.add(e.name);
-        }
-    }
-    catch {
-        // built-in dir missing is unexpected but not fatal
-    }
-    // Custom workflows (can add new or override built-in)
-    try {
-        const entries = await readdir(customDir, { withFileTypes: true });
-        for (const e of entries) {
-            if (e.isDirectory())
-                names.add(e.name);
-        }
-    }
-    catch {
-        // custom dir doesn't exist yet — that's fine
-    }
-    return [...names].sort();
-}
-//# sourceMappingURL=workflow.js.map

package/build/core/workflow.js.map

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

package/build/hooks/claude-code.d.ts

@@ -1,20 +0,0 @@
-/**
- * Claude Code / Codex hook definitions.
- *
- * Claude Code hooks are shell scripts that receive JSON via stdin.
- * They can block tool calls via exit code 2 or JSON { decision: "block" }.
- * UserPromptSubmit stdout is injected as context visible to Claude.
- *
- * Hooks:
- * 1. PreToolUse — boundary guard: block code edits and dev commands
- * 2. UserPromptSubmit — proactive reminders: dispatch timeout, idle phase, 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 Claude Code hook definitions using agent-kit's defineHooks.
- */
-export declare function createClaudeCodeHooks(params: HookParams): import("@s_s/agent-kit").HookSet<"claude-code">;

package/build/hooks/claude-code.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/hooks/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;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;;;;;;;;;;;GAWG;AACH,SAAS,wBAAwB,CAAC,OAAmB;IACjD,MAAM,eAAe,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtE,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,oBAAoB,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5G,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8BH,eAAe;;;;;;;;;;;;;;;;;;EAkBrB,iBAAiB;;;;;;;;;;;CAWlB,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,8BAA8B,CAAC,MAAkB;IACtD,OAAO;;;;;YAKC,MAAM,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCA+BU,wBAAwB;;;;;;;;;;;;;;;;;;;oCAmBxB,8BAA8B;;;;;;;;kEAQA,8BAA8B;;;;;;;;;;;;;;iCAc/D,0BAA0B;;;;;;;;;;;;;;;;;;;;;CAqB1D,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAkB;IACpD,OAAO,WAAW,CAAC,aAAa,EAAE;QAC9B;YACI,MAAM,EAAE,CAAC,YAAY,CAAC;YACtB,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC;SAC5C;QACD;YACI,MAAM,EAAE,CAAC,kBAAkB,CAAC;YAC5B,OAAO,EAAE,8BAA8B,CAAC,MAAM,CAAC;SAClD;KACJ,CAAC,CAAC;AACP,CAAC"}

package/build/hooks/content.d.ts

@@ -1,43 +0,0 @@
-/**
- * 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.
- */
-/**
- * Parameters needed to generate hook content.
- * Passed at install time and embedded into the generated scripts.
- */
-export interface HookParams {
-    /** Harmonia data directory (absolute path) */
-    dataDir: string;
-}
-/**
- * Tool names that PM should not call directly (code modification tools).
- * These are the standard agent tool names across different platforms.
- */
-export declare const BLOCKED_TOOLS: readonly ["Write", "Edit", "MultiEdit", "write", "edit", "Bash", "bash", "Terminal", "terminal"];
-/**
- * Shell commands that indicate development work (PM should not run these).
- */
-export declare const BLOCKED_COMMANDS: readonly ["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 declare const CODE_EXTENSIONS: readonly [".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 declare const HARMONIA_TOOLS: readonly ["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"];
-/** Dispatch running timeout — warn after this many minutes */
-export declare const DISPATCH_TIMEOUT_MINUTES = 30;
-/** Phase idle timeout — warn after this many minutes with no tool calls */
-export declare const PHASE_IDLE_TIMEOUT_MINUTES = 15;
-/** Review pending timeout — warn after this many minutes */
-export declare const REVIEW_PENDING_TIMEOUT_MINUTES = 10;

package/build/hooks/content.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,40 +0,0 @@
-/**
- * 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

@@ -1,63 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,24 +0,0 @@
-/**
- * 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.map

@@ -1 +0,0 @@
-{"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

@@ -1,29 +0,0 @@
-/**
- * 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">;

package/build/hooks/opencode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/hooks/opencode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;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,sBAAsB,CAAC,MAAkB;IAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAEzD,0EAA0E;IAC1E,+CAA+C;IAC/C,OAAO;;;;;mBAKQ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;;6CAEJ,YAAY;8CACX,eAAe;mCAC1B,wBAAwB;qCACtB,0BAA0B;yCACtB,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqKtE,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IAClD,OAAO,WAAW,CAAC,UAAU,EAAE;QAC3B,MAAM,EAAE,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;QACvE,OAAO,EAAE,sBAAsB,CAAC,MAAM,CAAC;KAC1C,CAAC,CAAC;AACP,CAAC"}

package/build/tools/approve-doc.d.ts

@@ -1,6 +0,0 @@
-/**
- * MCP Tool: doc_approve / review_list
- * Approve or reject a document that is pending review.
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerApproveDoc(server: McpServer): void;

package/build/tools/approve-doc.js

@@ -1,108 +0,0 @@
-/**
- * MCP Tool: doc_approve / review_list
- * Approve or reject a document that is pending review.
- */
-import { z } from 'zod';
-import { resolveReview, getPendingReviews } from '../core/reviews.js';
-import { getProject } from '../core/registry.js';
-export function registerApproveDoc(server) {
-    server.tool('doc_approve', 'Approve or reject a document pending review. Call this after the user has reviewed the document and confirmed (or requested changes).', {
-        project_name: z.string().describe('Project name'),
-        doc_id: z.string().describe('Document ID to approve/reject'),
-        approved: z.boolean().describe('true = approved, false = rejected (needs revision)'),
-        comment: z.string().optional().describe('Optional comment — user feedback or reason for rejection'),
-    }, async ({ project_name, doc_id, approved, comment }) => {
-        try {
-            // Resolve current iteration
-            const entry = await getProject(project_name);
-            if (!entry || entry.currentIteration === 0) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `项目 "${project_name}" 未找到或尚未开始迭代。`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            const iteration = entry.currentIteration;
-            const status = approved ? 'approved' : 'rejected';
-            const review = await resolveReview(project_name, iteration, doc_id, status, comment);
-            if (approved) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Document "${doc_id}" approved. You may proceed with the workflow.`,
-                        },
-                    ],
-                };
-            }
-            else {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: [
-                                `Document "${doc_id}" rejected.`,
-                                comment ? `User feedback: ${comment}` : '',
-                                `Please revise the document based on the feedback and call doc_write again.`,
-                            ].join('\n'),
-                        },
-                    ],
-                };
-            }
-        }
-        catch (err) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-    server.tool('review_list', 'List all documents currently pending user review.', {
-        project_name: z.string().describe('Project name'),
-    }, async ({ project_name }) => {
-        // Resolve current iteration
-        const entry = await getProject(project_name);
-        if (!entry || entry.currentIteration === 0) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `项目 "${project_name}" 未找到或尚未开始迭代。`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const iteration = entry.currentIteration;
-        const pending = await getPendingReviews(project_name, iteration);
-        if (pending.length === 0) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'No documents pending review.',
-                    },
-                ],
-            };
-        }
-        const list = pending.map((r) => `- ${r.docId} (submitted: ${r.submittedAt})`).join('\n');
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Documents pending review:\n${list}`,
-                },
-            ],
-        };
-    });
-}
-//# sourceMappingURL=approve-doc.js.map

package/build/tools/approve-doc.js.map

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

package/build/tools/dispatch-role.d.ts

@@ -1,16 +0,0 @@
-/**
- * MCP Tool: role_dispatch
- *
- * Prepare all data needed to hand off a task to a team member role.
- * Returns: role prompt (with overrides injected), frontmatter config,
- * input documents, task brief, and dispatch tracking info.
- *
- * Automatically:
- * - Creates a dispatch record for tracking
- * - Searches for reusable idle sessions and provides guidance
- *
- * This tool does NOT launch agents — it only prepares the data.
- * The host agent (PM) decides how to pass this to the team member.
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerDispatchRole(server: McpServer, builtinDir: string, customDir: string): void;