@s_s/harmonia 1.2.0 → 1.4.0

package/build/index.js

@@ -10,11 +10,9 @@
  * Project source directories contain code only — no Harmonia artifacts.
  */
 import { fileURLToPath } from 'node:url';
-import { dirname, join, resolve } from 'node:path';
+import { dirname, join } from 'node:path';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-// Built-in workflows directory (package root, sibling to build/)
-const BUILTIN_WORKFLOWS_DIR = resolve(join(__dirname, '..', 'workflows'));
 const subcommand = process.argv[2];
 if (subcommand === 'setup') {
     // CLI mode — human-facing project setup
@@ -57,7 +55,7 @@ Harmonia — Multi-agent orchestration MCP server
 
 Usage:
   harmonia                    Start MCP stdio server
-  harmonia setup              Inject PM prompt + install hooks in current directory
+  harmonia setup              Inject coordinator prompt + install hooks in current directory
   harmonia unregister <name>  Remove project from registry and delete data (default)
   harmonia unregister <name> --keep-data  Remove from registry but keep data files
   harmonia --help             Show this help message
@@ -83,38 +81,43 @@ else if (subcommand === '--version' || subcommand === '-v') {
 }
 else {
     // Default: MCP stdio server mode
+    const { readFile } = await import('node:fs/promises');
     const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
     const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
     const { getGlobalDir } = await import('./core/registry.js');
     const { registerProjectInit } = await import('./tools/project-init.js');
     const { registerIterationStart } = await import('./tools/iteration-start.js');
-    const { registerSetScale } = await import('./tools/set-scale.js');
     const { registerGetRolePrompt } = await import('./tools/get-role-prompt.js');
-    const { registerUpdatePhase } = await import('./tools/update-phase.js');
-    const { registerDocTools } = await import('./tools/doc-tools.js');
+    const { registerArtifactTools } = await import('./tools/artifact-tools.js');
     const { registerGetProjectStatus } = await import('./tools/get-project-status.js');
-    const { registerApproveDoc } = await import('./tools/approve-doc.js');
-    const { registerOverrideTools } = await import('./tools/override-tools.js');
-    const { registerDispatchRole } = await import('./tools/dispatch-role.js');
-    const { registerReportDispatch } = await import('./tools/report-dispatch.js');
-    // Custom workflows directory: <data_dir>/.workflows
-    const CUSTOM_WORKFLOWS_DIR = join(getGlobalDir(), '.workflows');
+    const { registerApproveArtifact } = await import('./tools/artifact-approve.js');
+    const { registerDispatchRole } = await import('./tools/role-dispatch.js');
+    const { registerReportDispatch } = await import('./tools/dispatch-report.js');
+    const { registerPatchStart } = await import('./tools/patch-start.js');
+    const { registerIssueTools } = await import('./tools/issue-tools.js');
+    const { registerArtifactSchema } = await import('./tools/artifact-schema.js');
+    const { registerLoopDone } = await import('./tools/loop-done.js');
+    // Read version from package.json (single source of truth)
+    const pkg = JSON.parse(await readFile(join(__dirname, '..', 'package.json'), 'utf-8'));
+    // Workflows directory: <data_dir>/harmonia/.workflows
+    const WORKFLOWS_DIR = join(getGlobalDir(), '.workflows');
     const server = new McpServer({
         name: 'harmonia',
-        version: '0.1.0',
+        version: pkg.version,
     });
     // Register all tools
-    registerProjectInit(server, BUILTIN_WORKFLOWS_DIR, CUSTOM_WORKFLOWS_DIR);
-    registerIterationStart(server, BUILTIN_WORKFLOWS_DIR, CUSTOM_WORKFLOWS_DIR);
-    registerSetScale(server, BUILTIN_WORKFLOWS_DIR, CUSTOM_WORKFLOWS_DIR);
-    registerGetRolePrompt(server, BUILTIN_WORKFLOWS_DIR, CUSTOM_WORKFLOWS_DIR);
-    registerUpdatePhase(server, BUILTIN_WORKFLOWS_DIR, CUSTOM_WORKFLOWS_DIR);
-    registerDocTools(server, BUILTIN_WORKFLOWS_DIR, CUSTOM_WORKFLOWS_DIR);
-    registerGetProjectStatus(server, BUILTIN_WORKFLOWS_DIR, CUSTOM_WORKFLOWS_DIR);
-    registerApproveDoc(server);
-    registerOverrideTools(server);
-    registerDispatchRole(server, BUILTIN_WORKFLOWS_DIR, CUSTOM_WORKFLOWS_DIR);
-    registerReportDispatch(server, BUILTIN_WORKFLOWS_DIR, CUSTOM_WORKFLOWS_DIR);
+    registerProjectInit(server, WORKFLOWS_DIR);
+    registerIterationStart(server, WORKFLOWS_DIR);
+    registerGetRolePrompt(server, WORKFLOWS_DIR);
+    registerArtifactTools(server, WORKFLOWS_DIR);
+    registerGetProjectStatus(server, WORKFLOWS_DIR);
+    registerApproveArtifact(server, WORKFLOWS_DIR);
+    registerDispatchRole(server, WORKFLOWS_DIR);
+    registerReportDispatch(server, WORKFLOWS_DIR);
+    registerPatchStart(server, WORKFLOWS_DIR);
+    registerIssueTools(server);
+    registerArtifactSchema(server, WORKFLOWS_DIR);
+    registerLoopDone(server, WORKFLOWS_DIR);
     // Connect via stdio
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;IACzB,wCAAwC;IACxC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACpE,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC;KAAM,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;IACrC,oDAAoD;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,YAAY,WAAW,0BAA0B,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,iBAAiB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,YAAY,WAAW,uCAAuC,CAAC,CAAC;IAChF,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,GAAG,CAAC,YAAY,WAAW,kDAAkD,CAAC,CAAC;IAC3F,CAAC;AACL,CAAC;KAAM,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;CAYf,CAAC,CAAC;AACH,CAAC;KAAM,IAAI,UAAU,IAAI,UAAU,KAAK,WAAW,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;IACzE,OAAO,CAAC,KAAK,CAAC,oBAAoB,UAAU,oCAAoC,CAAC,CAAC;IAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;KAAM,IAAI,UAAU,KAAK,WAAW,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;IAC3D,iCAAiC;IACjC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACtD,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;AACL,CAAC;KAAM,CAAC;IACJ,iCAAiC;IACjC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACtD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,yCAAyC,CAAC,CAAC;IAC9E,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3F,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAE5D,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACxE,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAC9E,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAC7E,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAC5E,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;IACnF,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;IAChF,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC1E,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAC9E,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IACtE,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IACtE,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAC9E,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAElE,0DAA0D;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAEvF,sDAAsD;IACtD,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,EAAE,YAAY,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QACzB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,GAAG,CAAC,OAAO;KACvB,CAAC,CAAC;IAEH,qBAAqB;IACrB,mBAAmB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,sBAAsB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,qBAAqB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7C,qBAAqB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7C,wBAAwB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAChD,uBAAuB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC/C,oBAAoB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC5C,sBAAsB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,sBAAsB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,gBAAgB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAExC,oBAAoB;IACpB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC"}

package/build/setup/inject.d.ts

@@ -1,10 +1,10 @@
 /**
- * Setup injection — detect host agent type and inject PM guidance into config.
+ * Setup injection — detect host agent type and inject coordinator guidance into config.
  *
  * Delegates to @s_s/agent-kit for agent detection, prompt injection, and
  * marker management. Harmonia provides the prompt content via templates.ts.
  *
- * Always uses global scope — PM prompt is project-agnostic and should be
+ * Always uses global scope — coordinator prompt is project-agnostic and should be
  * written to the agent's global config directory (e.g. ~/.openclaw/workspace/AGENTS.md).
  */
 import { type AgentType } from '@s_s/agent-kit';
@@ -20,11 +20,11 @@ export declare const HARMONIA_MARKER_END = "<!-- harmonia:end -->";
  */
 export declare function detectHostAgent(projectDir: string): Promise<AgentType>;
 /**
- * Inject the Harmonia PM guidance block into the agent's **global** config file.
+ * Inject the Harmonia coordinator guidance block into the agent's **global** config file.
  * If a harmonia block already exists, it is replaced (idempotent).
  * If the file doesn't exist, it is created.
  *
- * Uses global scope because PM prompt is project-agnostic.
+ * Uses global scope because coordinator prompt is project-agnostic.
  * This writes to the agent's global config directory:
  *   - opencode:    ~/.config/opencode/AGENTS.md
  *   - claude-code: ~/.claude/CLAUDE.md

package/build/setup/inject.js

@@ -1,15 +1,15 @@
 /**
- * Setup injection — detect host agent type and inject PM guidance into config.
+ * Setup injection — detect host agent type and inject coordinator guidance into config.
  *
  * Delegates to @s_s/agent-kit for agent detection, prompt injection, and
  * marker management. Harmonia provides the prompt content via templates.ts.
  *
- * Always uses global scope — PM prompt is project-agnostic and should be
+ * Always uses global scope — coordinator prompt is project-agnostic and should be
  * written to the agent's global config directory (e.g. ~/.openclaw/workspace/AGENTS.md).
  */
 import { createKit, detectAgent } from '@s_s/agent-kit';
 import { readFile } from 'node:fs/promises';
-import { generatePmPrompt } from './templates.js';
+import { generateCoordinatorPrompt } from './templates.js';
 /** Shared kit instance — binds all marker tags to "harmonia" */
 const kit = createKit('harmonia');
 /** Marker constants for external use (tests, etc.) */
@@ -27,11 +27,11 @@ export async function detectHostAgent(projectDir) {
     return detected ?? 'opencode';
 }
 /**
- * Inject the Harmonia PM guidance block into the agent's **global** config file.
+ * Inject the Harmonia coordinator guidance block into the agent's **global** config file.
  * If a harmonia block already exists, it is replaced (idempotent).
  * If the file doesn't exist, it is created.
  *
- * Uses global scope because PM prompt is project-agnostic.
+ * Uses global scope because coordinator prompt is project-agnostic.
  * This writes to the agent's global config directory:
  *   - opencode:    ~/.config/opencode/AGENTS.md
  *   - claude-code: ~/.claude/CLAUDE.md
@@ -39,7 +39,7 @@ export async function detectHostAgent(projectDir) {
  *   - codex:       ~/.codex/AGENTS.md
  */
 export async function injectPrompt(agentType) {
-    const prompt = generatePmPrompt();
+    const prompt = generateCoordinatorPrompt();
     const globalScope = { scope: 'global' };
     // Check pre-existing state for return value
     const hasExisting = await kit.hasPromptInjected(agentType, globalScope);

package/build/setup/inject.js.map

@@ -1 +1 @@
-{"version":3,"file":"inject.js","sourceRoot":"","sources":["../../src/setup/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAkB,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,gEAAgE;AAChE,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;AAElC,sDAAsD;AACtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB;IACpD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO,QAAQ,IAAI,UAAU,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,SAAoB;IAEpB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,EAAE,KAAK,EAAE,QAAiB,EAAE,CAAC;IAEjD,4CAA4C;IAC5C,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAExE,6CAA6C;IAC7C,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAE1E,yDAAyD;IACzD,IAAI,UAAU,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC;QACD,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACL,UAAU,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,wEAAwE;IACxE,MAAM,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAEvD,OAAO;QACH,QAAQ;QACR,OAAO,EAAE,CAAC,UAAU;QACpB,QAAQ,EAAE,WAAW;KACxB,CAAC;AACN,CAAC"}
+{"version":3,"file":"inject.js","sourceRoot":"","sources":["../../src/setup/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAkB,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,gEAAgE;AAChE,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;AAElC,sDAAsD;AACtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB;IACpD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO,QAAQ,IAAI,UAAU,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,SAAoB;IAEpB,MAAM,MAAM,GAAG,yBAAyB,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAG,EAAE,KAAK,EAAE,QAAiB,EAAE,CAAC;IAEjD,4CAA4C;IAC5C,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAExE,6CAA6C;IAC7C,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAE1E,yDAAyD;IACzD,IAAI,UAAU,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC;QACD,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACL,UAAU,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,wEAAwE;IACxE,MAAM,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAEvD,OAAO;QACH,QAAQ;QACR,OAAO,EAAE,CAAC,UAAU;QACpB,QAAQ,EAAE,WAAW;KACxB,CAAC;AACN,CAAC"}

package/build/setup/templates.d.ts

@@ -1,17 +1,19 @@
 /**
- * PM guidance prompt template.
+ * Coordinator guidance prompt template.
  *
- * This template is injected into the project's agent config file to guide the
- * host agent to act as the PM role in a Harmonia-managed project.
+ * This template is injected into the agent's global config file to guide the
+ * host agent to act as the coordinator role in a Harmonia-managed project.
  * The target file (AGENTS.md / CLAUDE.md) is determined by @s_s/agent-kit.
  *
- * The prompt is project-agnostic — no project name, directory, or scale.
- * PM discovers project info at runtime via project_status.
+ * IMPORTANT: This prompt is GENERIC — no workflow-specific operations manual.
+ * Workflow-specific guidance (phases, document types, role names) is provided
+ * by the workflow plugin's coordinator.md role prompt, delivered via nextAction
+ * at runtime.
  */
 /**
- * Generate the PM guidance prompt content.
+ * Generate the coordinator guidance prompt content.
  *
  * Returns raw prompt content WITHOUT marker tags — markers are managed
  * by @s_s/agent-kit's injectPrompt (<!-- harmonia:start/end -->).
  */
-export declare function generatePmPrompt(): string;
+export declare function generateCoordinatorPrompt(): string;

package/build/setup/templates.js

@@ -1,167 +1,132 @@
 /**
- * PM guidance prompt template.
+ * Coordinator guidance prompt template.
  *
- * This template is injected into the project's agent config file to guide the
- * host agent to act as the PM role in a Harmonia-managed project.
+ * This template is injected into the agent's global config file to guide the
+ * host agent to act as the coordinator role in a Harmonia-managed project.
  * The target file (AGENTS.md / CLAUDE.md) is determined by @s_s/agent-kit.
  *
- * The prompt is project-agnostic — no project name, directory, or scale.
- * PM discovers project info at runtime via project_status.
+ * IMPORTANT: This prompt is GENERIC — no workflow-specific operations manual.
+ * Workflow-specific guidance (phases, document types, role names) is provided
+ * by the workflow plugin's coordinator.md role prompt, delivered via nextAction
+ * at runtime.
  */
 /**
- * Generate the PM guidance prompt content.
+ * Generate the coordinator guidance prompt content.
  *
  * Returns raw prompt content WITHOUT marker tags — markers are managed
  * by @s_s/agent-kit's injectPrompt (<!-- harmonia:start/end -->).
  */
-export function generatePmPrompt() {
-    return `## Harmonia — Project Manager Mode
+export function generateCoordinatorPrompt() {
+    return `## Harmonia — Project Coordinator Mode
 
-You are the **PM (Project Manager)** for a Harmonia-managed project.
-Harmonia is managing the project workflow. You are the central coordinator — the only role that talks directly to the user.
+You are the **Coordinator** for a Harmonia-managed project.
+Harmonia is a multi-agent collaboration framework. You are the central coordinator — the only role that talks directly to the user.
 
 ### Getting Started
 
 1. **Check for existing projects**: Call \`project_status()\` (no params) to list registered projects
 2. **If resuming**: Call \`project_status(project_name)\` to see current state and next steps
 3. **If new project**: Talk to user, then call \`project_init(project_name, project_dir)\` to register, followed by \`iteration_start(project_name)\` to begin the first iteration
-4. **If starting a new iteration on an existing project**: Call \`iteration_start(project_name)\` — this creates a fresh iteration with clean phases and documents
-5. **After PRD approved**: Call \`project_set_scale(project_name, scale)\` to set project scale
+4. **If starting a new iteration on an existing project**: Call \`iteration_start(project_name)\` — this creates a fresh iteration with clean state and artifacts
 
-### Project Init vs Iteration Start
+### Core Concepts
 
-- **\`project_init\`** — One-time registration. Creates the project entry in the registry. Does NOT create any iteration data.
-- **\`iteration_start\`** — Creates a new iteration (iter-1, iter-2, ...) with fresh state, phases, and docs directory. Must be called after \`project_init\` before any other tools will work.
-- For existing projects that have completed all phases, \`project_status\` will suggest calling \`iteration_start\` to begin the next iteration.
+- **\`project_init\`** — One-time registration. Creates the project entry in the global registry.
+- **\`iteration_start\`** — Creates a new iteration (iter-1, iter-2, ...) with fresh workflow state. Must be called after \`project_init\`.
+- **\`patch_start\`** — Creates a lightweight patch cycle for bug fixes (patch-1, patch-2, ...).
 
 ### Your Responsibilities
 
-1. **Communicate with the user** — clarify requirements, present documents for review, report progress
-2. **Drive the workflow** — advance phases, produce documents, dispatch tasks to team members
+1. **Communicate with the user** — clarify requirements, present artifacts for review, report progress
+2. **Drive the workflow** — follow nextAction guidance, produce artifacts, dispatch tasks
 3. **Coordinate the team** — dispatch roles, track sessions and dispatch progress, manage outputs
-4. **Ensure quality** — review documents, handle review cycles, verify deliverables
+4. **Ensure quality** — review artifacts, handle review cycles, verify deliverables
 
-### Workflow Guide
+### nextAction — Your Workflow Guide
 
-#### Phase 1: Requirements Clarification (\`clarify\`)
+Every Harmonia tool returns a \`nextAction\` field that tells you exactly what to do next:
+- **type: "dispatch"** — dispatch a role to execute a task node
+- **type: "write_artifact"** — write an artifact document
+- **type: "approve_artifact"** — present an artifact for user approval
+- **type: "wait"** — wait for a running dispatch to complete
+- **type: "completed"** — workflow is finished
+- **type: "failed"** — workflow has failed (check instructions for details)
 
-1. Talk to the user to understand their needs
-2. Write the PRD: \`doc_write(project_name, "prd", content)\`
-3. Write user stories: \`doc_write(project_name, "user-stories", content)\`
-4. Handle review cycles — when \`doc_write\` returns "REVIEW REQUIRED", present the document to the user and wait for confirmation
-5. After PRD is approved, evaluate the project scale and call \`project_set_scale(project_name, scale)\`
-6. Based on scale, write additional documents if needed (FSD, prototype, project plan for medium/large)
-7. After all clarify-phase documents are approved, advance: \`phase_update(project_name, "clarify", "completed")\`
+Always follow the \`instructions\` in nextAction. The workflow engine determines the correct next step based on the workflow definition and current state.
 
-#### Phase 2: Design (\`design\`)
+### Artifact Management
 
-1. Dispatch the architect: \`role_dispatch(project_name, "architect", task_brief)\`
-2. Follow the dispatch workflow (see below) to launch and track the architect
-3. The architect will produce: tech-design, task-breakdown (and optionally: data-model, api-design, risk-assessment)
-4. Review the architect's output, ask user for feedback if needed
-5. Advance: \`phase_update(project_name, "design", "completed")\`
+Before writing any artifact, call \`artifact_schema(project_name, artifact_id)\` to query the structure requirements. For step-based artifacts, query individual steps: \`artifact_schema(project_name, artifact_id, step)\`.
 
-#### Phase 3: Development (\`develop\`)
-
-1. Read the task breakdown: \`doc_read(project_name, "task-breakdown")\`
-2. Dispatch developers for each task (or batch): \`role_dispatch(project_name, "developer", task_brief)\`
-3. Developers can work in parallel if tasks are independent — each gets their own dispatch and session
-4. Track progress with \`project_status\` — it shows all active sessions and dispatch records
-5. Advance when all tasks are complete: \`phase_update(project_name, "develop", "completed")\`
-
-#### Phase 4: Testing (\`test\`)
-
-1. Dispatch the tester: \`role_dispatch(project_name, "tester", task_brief)\`
-2. Follow the dispatch workflow to launch and track the tester
-3. Tester writes test plan, executes tests, produces test report
-4. If bugs are found, coordinate fixes with developers (re-dispatch as needed)
-5. Advance: \`phase_update(project_name, "test", "completed")\`
-
-#### Phase 5: Delivery (\`deliver\`)
-
-1. Review all deliverables against user stories and acceptance criteria
-2. Present final results to the user
-3. Write retrospective: \`doc_write(project_name, "retrospective", content)\`
-4. Advance: \`phase_update(project_name, "deliver", "completed")\`
+When \`artifact_write\` returns "REVIEW REQUIRED":
+1. Present the full artifact to the user
+2. Ask if they approve or want changes
+3. If approved → call \`artifact_approve(project_name, artifact_id, true)\`
+4. If changes needed → revise and call \`artifact_write\` again
+5. **Never skip review.** Unapproved artifacts block workflow progress.
 
 ### Dispatch Workflow (Critical — follow every time)
 
-Dispatching a team member follows three steps:
-
 #### Step 1: Dispatch
 \`\`\`
 role_dispatch(project_name, role, task_brief)
-→ Returns: data package + dispatch_id + session guidance
+→ Returns: data package + dispatch_id + session guidance + rolePrompt
 \`\`\`
-Harmonia automatically:
-- Creates a dispatch record for tracking
-- Checks for reusable idle sessions and tells you whether to resume or launch new
 
 #### Step 2: Launch & Report
-Launch the agent based on the session guidance:
-- **If reusable session found**: Resume the existing agent session (use the agent session ID provided)
-- **If no reusable session**: Launch a new agent
-
+Launch the agent with the rolePrompt as system instructions.
 After launching, immediately report:
 \`\`\`
-dispatch_report(project_name, dispatch_id, agent_session_id="<id from agent>", agent_type="opencode")
+dispatch_report(project_name, dispatch_id, agent_session_id="<id>", agent_type="opencode")
 \`\`\`
-This registers the session and marks the dispatch as running.
 
 #### Step 3: Completion
-When the agent finishes (process exits or session ends):
+When the agent finishes:
 \`\`\`
 dispatch_report(project_name, dispatch_id, status="completed")
 \`\`\`
-Or if it failed:
-\`\`\`
-dispatch_report(project_name, dispatch_id, status="failed", note="reason")
-\`\`\`
-Then check: \`project_status\` to verify outputs and determine next steps.
+Or if failed: \`dispatch_report(project_name, dispatch_id, status="failed", note="reason")\`
+Then check \`project_status\` for next steps.
 
 ### Launching Agents
 
-#### If you are an OpenClaw agent (sessions_spawn)
-Use \`sessions_spawn\` to launch a sub-agent. The sub-agent automatically shares the gateway-level MCP configuration, so it can use all Harmonia tools (doc_write, doc_read, etc.) without additional setup.
-
+#### OpenClaw (sessions_spawn)
 \`\`\`
 sessions_spawn with:
-- system prompt = the role prompt from role_dispatch
+- system prompt = the rolePrompt from role_dispatch
 - task = the task brief
-- The sub-agent has access to all configured MCP servers including Harmonia
+- Sub-agent has access to all configured MCP servers including Harmonia
 \`\`\`
 
-#### For other agents (shell exec)
-Launch the agent via shell command (\`exec\`). You need to:
-1. Start the agent process with the role prompt as system instructions
-2. Pass the task brief and input documents as the initial message
+#### Other agents (shell exec)
+1. Start the agent process with rolePrompt as system instructions
+2. Pass the task brief and input artifacts as the initial message
 3. Wait for the process to exit
 
-### Session Recovery (after interruption)
+### Session Recovery
 
-If you were interrupted or are resuming from a previous session:
+If resuming from a previous session:
+1. Call \`project_status()\` — shows workflow tree, active sessions, dispatch records, pending reviews
+2. Check dispatch records — any "running" dispatches may need verification
+3. Check sessions — "active" may still be running; "idle" can be reused; "lost" need re-dispatch
+4. Follow the next steps suggested by \`project_status\`
 
-1. **Start with** \`project_status()\` — it shows everything: phases, active sessions, dispatch records, pending reviews
-2. **Check dispatch records** — any "running" dispatches may need verification (did the agent finish?)
-3. **Check sessions** — "active" sessions may have agents still running; "idle" sessions can be reused; "lost" sessions need re-dispatch
-4. **Follow the next steps** suggested by \`project_status\`
+### Available Tools
 
-### Document Review Flow
-
-Some documents require user approval (PRD, prototype by default).
-When \`doc_write\` returns "REVIEW REQUIRED":
-
-1. Present the full document to the user
-2. Ask if they approve or want changes
-3. If approved → call \`doc_approve(project_name, doc_id, true)\`
-4. If changes needed → revise and call \`doc_write\` again
-5. **Never skip review.** Unapproved documents must not be used as input for subsequent phases.
+- \`project_init\` / \`project_status\` — project lifecycle
+- \`iteration_start\` / \`patch_start\` — start iteration or patch
+- \`role_dispatch\` / \`dispatch_report\` — dispatch and track team members
+- \`artifact_write\` / \`artifact_read\` / \`artifact_list\` — manage artifacts
+- \`artifact_approve\` / \`review_list\` — artifact review
+- \`artifact_schema\` / \`role_prompt\` — query schemas and role prompts
+- \`issue_create\` / \`issue_list\` / \`issue_update\` — issue tracking
 
 ### Important Rules
 
-1. **Always check status first** — start each session with \`project_status()\` to understand where you are
-2. **Always report dispatch lifecycle** — dispatch → report launch → report completion. Never skip dispatch_report.
-3. **You are the coordinator, not the executor** — dispatch technical work to the appropriate roles (architect, developer, tester). Harmonia enforces this via hooks and guards.
-4. **Always check scale** — use \`project_status(project_name)\` to check scale before deciding which documents to produce`;
+1. **Always check status first** — start each session with \`project_status()\`
+2. **Always follow nextAction** — the workflow engine knows the correct next step
+3. **Always report dispatch lifecycle** — dispatch → report launch → report completion
+4. **You are the coordinator, not the executor** — dispatch technical work to the appropriate roles
+5. **Cross-context access**: Use \`artifact_read(project_name, id, context="iter-1")\` to read artifacts from other iterations or patches`;
 }
 //# sourceMappingURL=templates.js.map

package/build/setup/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/setup/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2HAmJgH,CAAC;AAC5H,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/setup/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB;IACrC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0IA8G+H,CAAC;AAC3I,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * MCP Tool: artifact_approve / review_list
+ * Approve or reject an artifact that is pending review.
+ *
+ * After approval, triggers engine event `artifact_approved` to evaluate gates.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerApproveArtifact(server: McpServer, workflowsDir: string): void;

package/build/tools/artifact-approve.js

@@ -0,0 +1,94 @@
+/**
+ * MCP Tool: artifact_approve / review_list
+ * Approve or reject an artifact that is pending review.
+ *
+ * After approval, triggers engine event `artifact_approved` to evaluate gates.
+ */
+import { z } from 'zod';
+import { resolveReview, getPendingReviews } from '../core/reviews.js';
+import { resolveActive, isError } from './utils.js';
+import { processWorkflowEvent, formatNextAction } from './engine-helpers.js';
+export function registerApproveArtifact(server, workflowsDir) {
+    server.tool('artifact_approve', 'Approve or reject an artifact pending review. Call this after the user has reviewed the artifact and confirmed (or requested changes).', {
+        project_name: z.string().describe('Project name'),
+        artifact_id: z.string().describe('Artifact 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, artifact_id, approved, comment }) => {
+        try {
+            const ctx = await resolveActive(project_name);
+            if (isError(ctx))
+                return ctx;
+            const status = approved ? 'approved' : 'rejected';
+            await resolveReview(project_name, ctx.number, artifact_id, status, comment, ctx.dir);
+            if (approved) {
+                // Trigger engine event: artifact_approved
+                const engineResult = await processWorkflowEvent(workflowsDir, project_name, ctx, {
+                    type: 'artifact_approved',
+                    artifactId: artifact_id,
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Artifact "${artifact_id}" approved.` + formatNextAction(engineResult.nextAction),
+                        },
+                    ],
+                };
+            }
+            else {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: [
+                                `Artifact "${artifact_id}" rejected.`,
+                                comment ? `User feedback: ${comment}` : '',
+                                `Please revise the artifact based on the feedback and call artifact_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 artifacts currently pending user review.', {
+        project_name: z.string().describe('Project name'),
+    }, async ({ project_name }) => {
+        const ctx = await resolveActive(project_name);
+        if (isError(ctx))
+            return ctx;
+        const pending = await getPendingReviews(project_name, ctx.number, ctx.dir);
+        if (pending.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No artifacts pending review.',
+                    },
+                ],
+            };
+        }
+        const list = pending.map((r) => `- ${r.artifactId} (submitted: ${r.submittedAt})`).join('\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Artifacts pending review:\n${list}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=artifact-approve.js.map

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

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

package/build/tools/artifact-schema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP Tool: artifact_schema
+ *
+ * Query artifact structure requirements and writing guidance before writing.
+ * Returns human-readable schema guidance including required sections/fields,
+ * content boundaries, format requirements, and step-by-step constraints.
+ *
+ * Primarily used by coordinator (who is not dispatched and thus doesn't receive
+ * Artifact Requirements automatically via role_dispatch).
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerArtifactSchema(server: McpServer, workflowsDir: string): void;