@s_s/harmonia 1.2.0 → 1.4.0

package/build/tools/loop-done.js.map

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

package/build/tools/patch-start.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MCP Tool: patch_start
+ * Start a new patch for a registered project.
+ *
+ * Creates the patch directory (patch-N/), initializes state.json with
+ * node-based workflow state, type=patch.
+ * Optionally links to an issue via issue_id.
+ *
+ * After initialization, starts the workflow engine and returns initial nextAction.
+ *
+ * Guards:
+ * - Project must be registered (use project_init first)
+ * - At least one iteration must have been started (patches fix existing work)
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPatchStart(server: McpServer, workflowsDir: string): void;

package/build/tools/patch-start.js

@@ -0,0 +1,122 @@
+/**
+ * MCP Tool: patch_start
+ * Start a new patch for a registered project.
+ *
+ * Creates the patch directory (patch-N/), initializes state.json with
+ * node-based workflow state, type=patch.
+ * Optionally links to an issue via issue_id.
+ *
+ * After initialization, starts the workflow engine and returns initial nextAction.
+ *
+ * Guards:
+ * - Project must be registered (use project_init first)
+ * - At least one iteration must have been started (patches fix existing work)
+ */
+import { z } from 'zod';
+import { getProject, startPatch, getPatchDir } from '../core/registry.js';
+import { loadWorkflow } from '../core/plugin.js';
+import { initWorkflowState, persistState } from '../core/state.js';
+import { startWorkflow } from '../core/workflow-engine.js';
+import { formatNextAction } from './engine-helpers.js';
+export function registerPatchStart(server, workflowsDir) {
+    server.tool('patch_start', 'Start a new patch for a registered project. Patches are lightweight fix cycles for bug fixes and small improvements. Use this for resolving issues found during testing or from user feedback.', {
+        project_name: z.string().describe('项目名称'),
+        description: z.string().optional().describe('补丁描述（简要说明修复内容）'),
+        issue_id: z.string().optional().describe('关联的 issue ID（如果是修复某个 issue）'),
+    }, async ({ project_name, description, issue_id }) => {
+        try {
+            // Guard: project must be registered
+            const entry = await getProject(project_name);
+            if (!entry) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `项目 "${project_name}" 未注册。请先调用 project_init 注册项目。`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Guard: at least one iteration must exist (patches fix existing work)
+            if (entry.totalIterations === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: [
+                                `项目 "${project_name}" 尚未有任何迭代。`,
+                                `补丁用于修复已有工作，请先调用 iteration_start 开始第一轮迭代。`,
+                            ].join('\n'),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Start new patch (creates directory, updates registry)
+            const newPatch = await startPatch(project_name);
+            // Load workflow and initialize state in patch mode
+            const wf = await loadWorkflow(workflowsDir, entry.workflow);
+            const patchDir = getPatchDir(project_name, newPatch);
+            const state = await initWorkflowState(project_name, entry.dir, wf, newPatch, 'patch', patchDir);
+            // Persist patch metadata (issue_id, description)
+            if (issue_id || description) {
+                state.meta = {
+                    ...(description ? { description } : {}),
+                    ...(issue_id ? { issueId: issue_id } : {}),
+                };
+                await persistState(project_name, newPatch, state, patchDir);
+            }
+            // Start the workflow engine
+            const emptyGate = {
+                artifactExists: () => false,
+                artifactApproved: () => false,
+                artifactField: () => undefined,
+            };
+            const engineCtx = {
+                gate: emptyGate,
+                getRolePrompt: (role) => {
+                    const roleDef = wf.roles[role];
+                    return roleDef?.prompt ?? `Role "${role}" prompt not found`;
+                },
+            };
+            const result = startWorkflow(wf.definition, state, engineCtx);
+            await persistState(project_name, newPatch, result.state, patchDir);
+            const nextActionText = formatNextAction(result.nextAction);
+            const descLine = description ? `描述: ${description}` : '';
+            const issueLine = issue_id ? `关联 issue: ${issue_id}` : '';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            `补丁 patch-${newPatch} 已开始。`,
+                            ``,
+                            `项目: ${project_name}`,
+                            `源代码目录: ${entry.dir}`,
+                            `工作流: ${wf.definition.name}`,
+                            descLine,
+                            issueLine,
+                            ``,
+                            nextActionText,
+                        ]
+                            .filter(Boolean)
+                            .join('\n'),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=patch-start.js.map

package/build/tools/patch-start.js.map

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

package/build/tools/project-init.d.ts

@@ -1,14 +1,14 @@
 /**
  * MCP Tool: project_init
- * Register a new Harmonia project in the global registry.
+ * Register a new Harmonia project in the global registry and install workflow hooks.
  *
- * This tool ONLY registers the project — it does NOT create iteration directories
- * or initialize state. After registration, call `iteration_start` to begin the
- * first iteration.
+ * This tool registers the project AND installs workflow-defined hooks for the
+ * detected agent. It does NOT create iteration directories or initialize state.
+ * After registration, call `iteration_start` to begin the first iteration.
  *
  * Supports an optional `workflow` parameter. When multiple workflows are
  * available and none is specified, returns an error with the available list
  * so the agent can re-call with a specific choice.
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerProjectInit(server: McpServer, builtinDir: string, customDir: string): void;
+export declare function registerProjectInit(server: McpServer, workflowsDir: string): void;

package/build/tools/project-init.js

@@ -1,19 +1,23 @@
 /**
  * MCP Tool: project_init
- * Register a new Harmonia project in the global registry.
+ * Register a new Harmonia project in the global registry and install workflow hooks.
  *
- * This tool ONLY registers the project — it does NOT create iteration directories
- * or initialize state. After registration, call `iteration_start` to begin the
- * first iteration.
+ * This tool registers the project AND installs workflow-defined hooks for the
+ * detected agent. It does NOT create iteration directories or initialize state.
+ * After registration, call `iteration_start` to begin the first iteration.
  *
  * Supports an optional `workflow` parameter. When multiple workflows are
  * available and none is specified, returns an error with the available list
  * so the agent can re-call with a specific choice.
  */
 import { z } from 'zod';
-import { loadWorkflow, listWorkflows } from '../core/workflow.js';
-import { registerProject, getProject } from '../core/registry.js';
-export function registerProjectInit(server, builtinDir, customDir) {
+import { createKit, defineHooks } from '@s_s/agent-kit';
+import { loadWorkflow, listWorkflows } from '../core/plugin.js';
+import { registerProject, getProject, getGlobalDir } from '../core/registry.js';
+import { detectHostAgent } from '../setup/inject.js';
+/** Shared kit instance for hook installation */
+const kit = createKit('harmonia');
+export function registerProjectInit(server, workflowsDir) {
     server.tool('project_init', 'Register a new Harmonia project. Creates the project entry in the global registry and the project source directory. Does NOT start an iteration — call iteration_start after registration to begin the first iteration.', {
         project_name: z
             .string()
@@ -33,9 +37,9 @@ export function registerProjectInit(server, builtinDir, customDir) {
         // Check if already registered
         const existing = await getProject(project_name);
         if (existing) {
-            const iterInfo = existing.currentIteration > 0
-                ? `当前迭代: iter-${existing.currentIteration} (共 ${existing.totalIterations} 轮)`
-                : '尚未开始迭代';
+            const contextInfo = existing.activeContext
+                ? `活跃上下文: ${existing.activeContext}`
+                : '尚未开始迭代或补丁';
             return {
                 content: [
                     {
@@ -45,14 +49,12 @@ export function registerProjectInit(server, builtinDir, customDir) {
                             ``,
                             `源代码目录: ${existing.dir}`,
                             `工作流: ${existing.workflow}`,
-                            `${iterInfo}`,
+                            `迭代: ${existing.totalIterations} 轮，补丁: ${existing.totalPatches} 个`,
+                            `${contextInfo}`,
                             ``,
-                            existing.currentIteration > 0
+                            existing.activeContext
                                 ? `如需查看当前状态，请调用 project_status(project_name="${project_name}")。`
                                 : `请调用 iteration_start(project_name="${project_name}") 开始第一轮迭代。`,
-                            existing.currentIteration > 0
-                                ? `如需开始新一轮迭代，请调用 iteration_start(project_name="${project_name}")。`
-                                : '',
                         ]
                             .filter(Boolean)
                             .join('\n'),
@@ -61,7 +63,7 @@ export function registerProjectInit(server, builtinDir, customDir) {
             };
         }
         // Resolve workflow name
-        const available = await listWorkflows(builtinDir, customDir);
+        const available = await listWorkflows(workflowsDir);
         if (available.length === 0) {
             return {
                 content: [
@@ -99,7 +101,7 @@ export function registerProjectInit(server, builtinDir, customDir) {
             const descriptions = [];
             for (const name of available) {
                 try {
-                    const wf = await loadWorkflow(builtinDir, customDir, name);
+                    const wf = await loadWorkflow(workflowsDir, name);
                     descriptions.push(`- ${name}: ${wf.definition.description}`);
                 }
                 catch {
@@ -123,9 +125,35 @@ export function registerProjectInit(server, builtinDir, customDir) {
             };
         }
         // Load workflow definition (validate it loads correctly)
-        const wf = await loadWorkflow(builtinDir, customDir, workflowName);
+        const wf = await loadWorkflow(workflowsDir, workflowName);
         // Register project (creates global data dir + project source dir)
         await registerProject(project_name, project_dir, workflowName);
+        // Install workflow hooks if the plugin provides a hook creator
+        let hookMessage = '';
+        if (wf.hooks) {
+            try {
+                const agentType = await detectHostAgent(project_dir);
+                const context = {
+                    defineHooks,
+                    dataDir: getGlobalDir(),
+                    projectName: project_name,
+                };
+                const hookSet = wf.hooks(agentType, context);
+                const hookResult = await kit.installHooks(agentType, hookSet);
+                if (hookResult.success) {
+                    hookMessage = `\nHooks 已安装 (${hookResult.filesWritten.length} 个文件)`;
+                    if (hookResult.warnings.length > 0) {
+                        hookMessage += `\n警告: ${hookResult.warnings.join('; ')}`;
+                    }
+                }
+                else {
+                    hookMessage = `\n[warn] Hook 安装失败: ${hookResult.error ?? '未知错误'}`;
+                }
+            }
+            catch (err) {
+                hookMessage = `\n[warn] Hook 安装出错: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        }
         return {
             content: [
                 {
@@ -136,6 +164,7 @@ export function registerProjectInit(server, builtinDir, customDir) {
                         `源代码目录: ${project_dir}`,
                         `工作流: ${wf.definition.name} (${wf.definition.description})`,
                         `可用角色: ${Object.keys(wf.roles).join(', ')}`,
+                        hookMessage,
                         ``,
                         `下一步: 调用 iteration_start(project_name="${project_name}") 开始第一轮迭代。`,
                     ].join('\n'),

package/build/tools/project-init.js.map

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

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

@@ -0,0 +1,55 @@
+/**
+ * MCP Tool: role_dispatch
+ *
+ * Prepare all data needed to hand off a task to a team member role.
+ * Returns: role prompt (with overrides injected), session guidance,
+ * input artifacts, task brief, and dispatch tracking info.
+ *
+ * Node-based architecture: validates against workflow node states.
+ * Accepts an optional node_id parameter to target a specific task node.
+ *
+ * Session/parallel behavior is enforced by Core:
+ * - session: none → never searches for idle sessions
+ * - session: persistent → searches for idle sessions, directs reuse
+ * - session: optional → searches for idle sessions, suggests reuse
+ * - parallel: true + running dispatch → forces new session
+ *
+ * Automatically:
+ * - Creates a dispatch record for tracking
+ * - Enforces session/parallel strategy from role frontmatter
+ * - Triggers a dispatch_requested engine event
+ * - Returns nextAction from the workflow engine
+ *
+ * This tool does NOT launch agents — it only prepares the data.
+ * The coordinator decides how to pass this to the team member.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ArtifactIOContext } from '../core/artifacts.js';
+import type { WorkflowPlugin } from '../core/types.js';
+/**
+ * Get file extension from artifact definition format.
+ * - 'html' → '.html'
+ * - 'json' → '.json'
+ * - 'md' or undefined → '.md'
+ */
+export declare function getFormatExtension(format?: 'md' | 'html' | 'json'): string;
+/** A resolved input artifact reference */
+export interface InputReference {
+    /** Artifact ID */
+    id: string;
+    /** Human-readable name from artifact definition */
+    name: string;
+    /** Resolved file path (managed) or directory path (unmanaged) */
+    path: string;
+    /** Whether this artifact was found on disk */
+    found: boolean;
+}
+/**
+ * Resolve an artifact ID to a name + path reference.
+ *
+ * - Managed artifacts: resolves to full file path via format → extension mapping
+ * - Unmanaged artifacts: resolves to the output directory
+ * - Unknown artifacts: returns not-found
+ */
+export declare function resolveInputReference(artifactId: string, wf: WorkflowPlugin, ioCtx: ArtifactIOContext, existingArtifacts: Set<string>): InputReference;
+export declare function registerDispatchRole(server: McpServer, workflowsDir: string): void;