@laurentenhoor/devclaw 0.1.0

package/dist/lib/audit.js

@@ -0,0 +1,42 @@
+/**
+ * Append-only NDJSON audit logging.
+ * Every tool call automatically logs — no manual action needed from agents.
+ * Automatically truncates log to keep only last 250 lines.
+ */
+import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+const MAX_LOG_LINES = 50;
+export async function log(workspaceDir, event, data) {
+    const filePath = join(workspaceDir, "log", "audit.log");
+    const entry = JSON.stringify({
+        ts: new Date().toISOString(),
+        event,
+        ...data,
+    });
+    try {
+        await appendFile(filePath, entry + "\n");
+        await truncateIfNeeded(filePath);
+    }
+    catch (err) {
+        // If directory doesn't exist, create it and retry
+        if (err.code === "ENOENT") {
+            await mkdir(dirname(filePath), { recursive: true });
+            await appendFile(filePath, entry + "\n");
+        }
+        // Audit logging should never break the tool — silently ignore other errors
+    }
+}
+async function truncateIfNeeded(filePath) {
+    try {
+        const content = await readFile(filePath, "utf-8");
+        const lines = content.split("\n").filter((line) => line.length > 0);
+        if (lines.length > MAX_LOG_LINES) {
+            const keptLines = lines.slice(-MAX_LOG_LINES);
+            await writeFile(filePath, keptLines.join("\n") + "\n", "utf-8");
+        }
+    }
+    catch {
+        // Silently ignore truncation errors — log remains intact
+    }
+}
+//# sourceMappingURL=audit.js.map

package/dist/lib/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../lib/audit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,YAAoB,EACpB,KAAa,EACb,IAA6B;IAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,KAAK;QACL,GAAG,IAAI;KACR,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;QACzC,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,kDAAkD;QAClD,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,UAAU,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,2EAA2E;IAC7E,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEpE,IAAI,KAAK,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,CAAC;YAC9C,MAAM,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;AACH,CAAC"}

package/dist/lib/binding-manager.d.ts

@@ -0,0 +1,35 @@
+/**
+ * binding-manager.ts — Channel binding analysis and migration.
+ *
+ * Handles detection of existing channel bindings, channel availability,
+ * and safe migration of bindings between agents.
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export type ChannelType = string;
+export interface BindingAnalysis {
+    channelEnabled: boolean;
+    channelConfigured: boolean;
+    existingChannelWideBinding?: {
+        agentId: string;
+        agentName: string;
+    };
+    groupSpecificBindings: Array<{
+        agentId: string;
+        agentName: string;
+        groupId: string;
+    }>;
+    recommendation: string;
+}
+/**
+ * Analyze the current state of channel bindings for a given channel.
+ */
+export declare function analyzeChannelBindings(api: OpenClawPluginApi, channel: ChannelType): Promise<BindingAnalysis>;
+/**
+ * Migrate a channel-wide binding from one agent to another.
+ */
+export declare function migrateChannelBinding(api: OpenClawPluginApi, channel: ChannelType, fromAgentId: string, toAgentId: string): Promise<void>;
+/**
+ * Remove a channel-wide binding for a specific agent.
+ */
+export declare function removeChannelBinding(api: OpenClawPluginApi, channel: ChannelType, agentId: string): Promise<void>;
+//# sourceMappingURL=binding-manager.d.ts.map

package/dist/lib/binding-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-manager.d.ts","sourceRoot":"","sources":["../../lib/binding-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,0BAA0B,CAAC,EAAE;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,qBAAqB,EAAE,KAAK,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CA4D1B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/lib/binding-manager.js

@@ -0,0 +1,88 @@
+/**
+ * Analyze the current state of channel bindings for a given channel.
+ */
+export async function analyzeChannelBindings(api, channel) {
+    const config = api.runtime.config.loadConfig();
+    // Check if channel is configured and enabled
+    const channelConfig = config.channels?.[channel];
+    const channelConfigured = !!channelConfig;
+    const channelEnabled = channelConfig?.enabled === true;
+    // Find existing bindings
+    const bindings = config.bindings ?? [];
+    let existingChannelWideBinding;
+    const groupSpecificBindings = [];
+    for (const binding of bindings) {
+        if (binding.match?.channel === channel) {
+            const agent = config.agents?.list?.find((a) => a.id === binding.agentId);
+            const agentName = agent?.name ?? binding.agentId;
+            if (!binding.match.peer) {
+                // Channel-wide binding (no peer filter) - potential conflict
+                existingChannelWideBinding = {
+                    agentId: binding.agentId,
+                    agentName,
+                };
+            }
+            else if (binding.match.peer.kind === "group") {
+                // Group-specific binding - no conflict
+                groupSpecificBindings.push({
+                    agentId: binding.agentId,
+                    agentName,
+                    groupId: binding.match.peer.id,
+                });
+            }
+        }
+    }
+    // Generate recommendation
+    let recommendation;
+    if (!channelConfigured) {
+        recommendation = `⚠️ ${channel} is not configured in OpenClaw. Configure it first via the wizard or openclaw.json, then restart OpenClaw.`;
+    }
+    else if (!channelEnabled) {
+        recommendation = `⚠️ ${channel} is configured but disabled. Enable it in openclaw.json (channels.${channel}.enabled: true) and restart OpenClaw.`;
+    }
+    else if (existingChannelWideBinding) {
+        recommendation = `⚠️ Agent "${existingChannelWideBinding.agentName}" is already bound to all ${channel} messages. Options:\n  1. Migrate binding to the new agent (recommended if replacing)\n  2. Use group-specific binding instead (if you want both agents active)\n  3. Skip binding for now`;
+    }
+    else if (groupSpecificBindings.length > 0) {
+        recommendation = `✅ ${groupSpecificBindings.length} group-specific binding(s) exist. No conflicts - safe to add channel-wide binding.`;
+    }
+    else {
+        recommendation = `✅ No existing ${channel} bindings. Safe to bind the new agent.`;
+    }
+    return {
+        channelEnabled,
+        channelConfigured,
+        existingChannelWideBinding,
+        groupSpecificBindings,
+        recommendation,
+    };
+}
+/**
+ * Migrate a channel-wide binding from one agent to another.
+ */
+export async function migrateChannelBinding(api, channel, fromAgentId, toAgentId) {
+    const config = api.runtime.config.loadConfig();
+    const bindings = config.bindings ?? [];
+    // Find the channel-wide binding for this channel and agent
+    const bindingIndex = bindings.findIndex((b) => b.match?.channel === channel &&
+        !b.match.peer &&
+        b.agentId === fromAgentId);
+    if (bindingIndex === -1) {
+        throw new Error(`No channel-wide ${channel} binding found for agent "${fromAgentId}"`);
+    }
+    // Update the binding to point to the new agent
+    bindings[bindingIndex].agentId = toAgentId;
+    config.bindings = bindings;
+    await api.runtime.config.writeConfigFile(config);
+}
+/**
+ * Remove a channel-wide binding for a specific agent.
+ */
+export async function removeChannelBinding(api, channel, agentId) {
+    const config = api.runtime.config.loadConfig();
+    const bindings = config.bindings ?? [];
+    // Filter out the channel-wide binding for this channel and agent
+    config.bindings = bindings.filter((b) => !(b.match?.channel === channel && !b.match.peer && b.agentId === agentId));
+    await api.runtime.config.writeConfigFile(config);
+}
+//# sourceMappingURL=binding-manager.js.map

package/dist/lib/binding-manager.js.map

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

package/dist/lib/cli.d.ts

@@ -0,0 +1,12 @@
+/**
+ * cli.ts — CLI registration for `openclaw devclaw setup` and `openclaw devclaw heartbeat`.
+ *
+ * Uses Commander.js (provided by OpenClaw plugin SDK context).
+ */
+import type { Command } from "commander";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+/**
+ * Register the `devclaw` CLI command group on a Commander program.
+ */
+export declare function registerCli(program: Command, api: OpenClawPluginApi): void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/lib/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../lib/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI7D;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,GAAG,IAAI,CA+D1E"}

package/dist/lib/cli.js

@@ -0,0 +1,69 @@
+import { runSetup } from "./setup/index.js";
+import { DEV_LEVELS, QA_LEVELS, DEFAULT_MODELS } from "./tiers.js";
+/**
+ * Register the `devclaw` CLI command group on a Commander program.
+ */
+export function registerCli(program, api) {
+    const devclaw = program
+        .command("devclaw")
+        .description("DevClaw development pipeline tools");
+    devclaw
+        .command("setup")
+        .description("Set up DevClaw: create agent, configure models, write workspace files")
+        .option("--new-agent <name>", "Create a new agent with this name")
+        .option("--agent <id>", "Use an existing agent by ID")
+        .option("--workspace <path>", "Direct workspace path")
+        .option("--junior <model>", `Junior dev model (default: ${DEFAULT_MODELS.dev.junior})`)
+        .option("--medior <model>", `Medior dev model (default: ${DEFAULT_MODELS.dev.medior})`)
+        .option("--senior <model>", `Senior dev model (default: ${DEFAULT_MODELS.dev.senior})`)
+        .option("--reviewer <model>", `Reviewer model (default: ${DEFAULT_MODELS.qa.reviewer})`)
+        .option("--tester <model>", `Tester model (default: ${DEFAULT_MODELS.qa.tester})`)
+        .action(async (opts) => {
+        const dev = {};
+        const qa = {};
+        if (opts.junior)
+            dev.junior = opts.junior;
+        if (opts.medior)
+            dev.medior = opts.medior;
+        if (opts.senior)
+            dev.senior = opts.senior;
+        if (opts.reviewer)
+            qa.reviewer = opts.reviewer;
+        if (opts.tester)
+            qa.tester = opts.tester;
+        const hasOverrides = Object.keys(dev).length > 0 || Object.keys(qa).length > 0;
+        const models = hasOverrides
+            ? { ...(Object.keys(dev).length > 0 && { dev }), ...(Object.keys(qa).length > 0 && { qa }) }
+            : undefined;
+        const result = await runSetup({
+            api,
+            newAgentName: opts.newAgent,
+            agentId: opts.agent,
+            workspacePath: opts.workspace,
+            models,
+        });
+        if (result.agentCreated) {
+            console.log(`Agent "${result.agentId}" created`);
+        }
+        console.log("Models configured:");
+        for (const t of DEV_LEVELS)
+            console.log(`  dev.${t}: ${result.models.dev[t]}`);
+        for (const t of QA_LEVELS)
+            console.log(`  qa.${t}: ${result.models.qa[t]}`);
+        console.log("Files written:");
+        for (const file of result.filesWritten) {
+            console.log(`  ${file}`);
+        }
+        if (result.warnings.length > 0) {
+            console.log("\nWarnings:");
+            for (const w of result.warnings) {
+                console.log(`  ${w}`);
+            }
+        }
+        console.log("\nDone! Next steps:");
+        console.log("  1. Add bot to a Telegram group");
+        console.log('  2. Register a project: "Register project <name> at <repo> for group <id>"');
+        console.log("  3. Create your first issue and pick it up");
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/lib/cli.js.map

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

package/dist/lib/dispatch.d.ts

@@ -0,0 +1,58 @@
+import { type Project } from "./projects.js";
+export type DispatchOpts = {
+    workspaceDir: string;
+    agentId?: string;
+    groupId: string;
+    project: Project;
+    issueId: number;
+    issueTitle: string;
+    issueDescription: string;
+    issueUrl: string;
+    role: "dev" | "qa";
+    /** Developer level (junior, medior, senior, reviewer) or raw model ID */
+    level: string;
+    /** Label to transition FROM (e.g. "To Do", "To Test", "To Improve") */
+    fromLabel: string;
+    /** Label to transition TO (e.g. "Doing", "Testing") */
+    toLabel: string;
+    /** Function to transition labels (injected to avoid provider dependency) */
+    transitionLabel: (issueId: number, from: string, to: string) => Promise<void>;
+    /** Plugin config for model resolution */
+    pluginConfig?: Record<string, unknown>;
+    /** Orchestrator's session key (used as spawnedBy for subagent tracking) */
+    sessionKey?: string;
+};
+export type DispatchResult = {
+    sessionAction: "spawn" | "send";
+    sessionKey: string;
+    level: string;
+    model: string;
+    announcement: string;
+};
+/**
+ * Build the task message sent to a worker session.
+ * Reads role-specific instructions from workspace/projects/roles/<project>/<role>.md (falls back to projects/roles/default/).
+ */
+export declare function buildTaskMessage(opts: {
+    workspaceDir: string;
+    projectName: string;
+    role: "dev" | "qa";
+    issueId: number;
+    issueTitle: string;
+    issueDescription: string;
+    issueUrl: string;
+    repo: string;
+    baseBranch: string;
+    groupId: string;
+}): Promise<string>;
+/**
+ * Dispatch a task to a worker session.
+ *
+ * Flow: resolve model → build message → transition label → spawn/send session
+ *       → update worker state → audit → build announcement.
+ *
+ * On dispatch failure: rolls back label transition.
+ * On state update failure after dispatch: logs warning (session IS running).
+ */
+export declare function dispatchTask(opts: DispatchOpts): Promise<DispatchResult>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/lib/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../lib/dispatch.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,OAAO,EAIb,MAAM,eAAe,CAAC;AAKvB,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2ClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CAgEzB"}

package/dist/lib/dispatch.js

@@ -0,0 +1,163 @@
+/**
+ * dispatch.ts — Core dispatch logic shared by work_start and projectTick.
+ *
+ * Handles: session lookup, spawn/reuse via Gateway RPC, task dispatch via CLI,
+ * state update (activateWorker), and audit logging.
+ */
+import { execFile, spawn } from "node:child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+import { log as auditLog } from "./audit.js";
+import { activateWorker, getSessionForLevel, getWorker, } from "./projects.js";
+import { resolveModel, levelEmoji } from "./tiers.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Build the task message sent to a worker session.
+ * Reads role-specific instructions from workspace/projects/roles/<project>/<role>.md (falls back to projects/roles/default/).
+ */
+export async function buildTaskMessage(opts) {
+    const { workspaceDir, projectName, role, issueId, issueTitle, issueDescription, issueUrl, repo, baseBranch, groupId, } = opts;
+    const roleInstructions = await loadRoleInstructions(workspaceDir, projectName, role);
+    const availableResults = role === "dev"
+        ? '"done" (completed successfully) or "blocked" (cannot complete, need help)'
+        : '"pass" (approved), "fail" (issues found), "refine" (needs human input), or "blocked" (cannot complete)';
+    const parts = [
+        `${role.toUpperCase()} task for project "${projectName}" — Issue #${issueId}`,
+        ``,
+        issueTitle,
+        issueDescription ? `\n${issueDescription}` : "",
+        ``,
+        `Repo: ${repo} | Branch: ${baseBranch} | ${issueUrl}`,
+        `Project group ID: ${groupId}`,
+    ];
+    if (roleInstructions) {
+        parts.push(``, `---`, ``, roleInstructions.trim());
+    }
+    parts.push(``, `---`, ``, `## MANDATORY: Task Completion`, ``, `When you finish this task, you MUST call \`work_finish\` with:`, `- \`role\`: "${role}"`, `- \`projectGroupId\`: "${groupId}"`, `- \`result\`: ${availableResults}`, `- \`summary\`: brief description of what you did`, ``, `⚠️ You MUST call work_finish even if you encounter errors or cannot finish.`, `Use "blocked" with a summary explaining why you're stuck.`, `Never end your session without calling work_finish.`);
+    return parts.join("\n");
+}
+/**
+ * Dispatch a task to a worker session.
+ *
+ * Flow: resolve model → build message → transition label → spawn/send session
+ *       → update worker state → audit → build announcement.
+ *
+ * On dispatch failure: rolls back label transition.
+ * On state update failure after dispatch: logs warning (session IS running).
+ */
+export async function dispatchTask(opts) {
+    const { workspaceDir, agentId, groupId, project, issueId, issueTitle, issueDescription, issueUrl, role, level, fromLabel, toLabel, transitionLabel, pluginConfig, } = opts;
+    const model = resolveModel(role, level, pluginConfig);
+    const worker = getWorker(project, role);
+    const existingSessionKey = getSessionForLevel(worker, level);
+    const sessionAction = existingSessionKey ? "send" : "spawn";
+    const taskMessage = await buildTaskMessage({
+        workspaceDir, projectName: project.name, role, issueId,
+        issueTitle, issueDescription, issueUrl,
+        repo: project.repo, baseBranch: project.baseBranch, groupId,
+    });
+    await transitionLabel(issueId, fromLabel, toLabel);
+    let sessionKey = existingSessionKey;
+    let dispatched = false;
+    try {
+        sessionKey = await ensureSession(sessionAction, sessionKey, {
+            agentId, projectName: project.name, role, level, model,
+        });
+        await sendToAgent(sessionKey, taskMessage, {
+            agentId, projectName: project.name, issueId, role,
+            orchestratorSessionKey: opts.sessionKey,
+        });
+        dispatched = true;
+        await recordWorkerState(workspaceDir, groupId, role, {
+            issueId, level, sessionKey: sessionKey, sessionAction,
+        });
+    }
+    catch (err) {
+        if (dispatched) {
+            await auditLog(workspaceDir, "work_start", {
+                project: project.name, groupId, issue: issueId, role,
+                warning: "State update failed after successful dispatch",
+                error: err.message, sessionKey,
+            });
+            throw new Error(`State update failed after successful session dispatch: ${err.message}. Session is running but projects.json was not updated.`);
+        }
+        try {
+            await transitionLabel(issueId, toLabel, fromLabel);
+        }
+        catch { /* best-effort rollback */ }
+        throw new Error(`Session dispatch failed: ${err.message}. Label reverted to "${fromLabel}".`);
+    }
+    await auditDispatch(workspaceDir, {
+        project: project.name, groupId, issueId, issueTitle,
+        role, level, model, sessionAction, sessionKey: sessionKey,
+        fromLabel, toLabel,
+    });
+    const announcement = buildAnnouncement(level, role, sessionAction, issueId, issueTitle, issueUrl);
+    return { sessionAction, sessionKey: sessionKey, level, model, announcement };
+}
+// ---------------------------------------------------------------------------
+// Private helpers — exist so dispatchTask reads as a sequence of steps
+// ---------------------------------------------------------------------------
+async function loadRoleInstructions(workspaceDir, projectName, role) {
+    const projectFile = path.join(workspaceDir, "projects", "roles", projectName, `${role}.md`);
+    try {
+        return await fs.readFile(projectFile, "utf-8");
+    }
+    catch { /* none */ }
+    const defaultFile = path.join(workspaceDir, "projects", "roles", "default", `${role}.md`);
+    try {
+        return await fs.readFile(defaultFile, "utf-8");
+    }
+    catch { /* none */ }
+    return "";
+}
+async function ensureSession(action, existingKey, opts) {
+    if (action === "send")
+        return existingKey;
+    const sessionKey = `agent:${opts.agentId ?? "unknown"}:subagent:${opts.projectName}-${opts.role}-${opts.level}`;
+    await execFileAsync("openclaw", ["gateway", "call", "sessions.patch", "--params", JSON.stringify({ key: sessionKey, model: opts.model })], { timeout: 30_000 });
+    return sessionKey;
+}
+function sendToAgent(sessionKey, taskMessage, opts) {
+    const gatewayParams = JSON.stringify({
+        idempotencyKey: `devclaw-${opts.projectName}-${opts.issueId}-${opts.role}-${Date.now()}`,
+        agentId: opts.agentId ?? "devclaw",
+        sessionKey,
+        message: taskMessage,
+        deliver: false,
+        lane: "subagent",
+        ...(opts.orchestratorSessionKey ? { spawnedBy: opts.orchestratorSessionKey } : {}),
+    });
+    const child = spawn("openclaw", ["gateway", "call", "agent", "--params", gatewayParams, "--expect-final", "--json"], { detached: true, stdio: "ignore" });
+    child.unref();
+}
+async function recordWorkerState(workspaceDir, groupId, role, opts) {
+    const params = {
+        issueId: String(opts.issueId),
+        level: opts.level,
+        startTime: new Date().toISOString(),
+    };
+    if (opts.sessionAction === "spawn") {
+        params.sessionKey = opts.sessionKey;
+    }
+    await activateWorker(workspaceDir, groupId, role, params);
+}
+async function auditDispatch(workspaceDir, opts) {
+    await auditLog(workspaceDir, "work_start", {
+        project: opts.project, groupId: opts.groupId,
+        issue: opts.issueId, issueTitle: opts.issueTitle,
+        role: opts.role, level: opts.level,
+        sessionAction: opts.sessionAction, sessionKey: opts.sessionKey,
+        labelTransition: `${opts.fromLabel} → ${opts.toLabel}`,
+    });
+    await auditLog(workspaceDir, "model_selection", {
+        issue: opts.issueId, role: opts.role, level: opts.level, model: opts.model,
+    });
+}
+function buildAnnouncement(level, role, sessionAction, issueId, issueTitle, issueUrl) {
+    const emoji = levelEmoji(role, level) ?? (role === "qa" ? "🔍" : "🔧");
+    const actionVerb = sessionAction === "spawn" ? "Spawning" : "Sending";
+    return `${emoji} ${actionVerb} ${role.toUpperCase()} (${level}) for #${issueId}: ${issueTitle}\n🔗 ${issueUrl}`;
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/lib/dispatch.js.map

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

package/dist/lib/model-selector.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Model selection for dev/qa tasks.
+ * Keyword heuristic fallback — used when the orchestrator doesn't specify a level.
+ * Returns plain level names (junior, medior, senior, reviewer, tester).
+ */
+export type LevelSelection = {
+    level: string;
+    reason: string;
+};
+/**
+ * Select appropriate developer level based on task description.
+ *
+ * Developer levels:
+ * - junior: very simple (typos, single-file fixes, CSS tweaks)
+ * - medior: standard DEV (features, bug fixes, multi-file changes)
+ * - senior: deep/architectural (system-wide refactoring, novel design)
+ * - reviewer: QA code inspection and validation
+ * - tester: QA manual testing
+ */
+export declare function selectLevel(issueTitle: string, issueDescription: string, role: "dev" | "qa"): LevelSelection;
+//# sourceMappingURL=model-selector.d.ts.map

package/dist/lib/model-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selector.d.ts","sourceRoot":"","sources":["../../lib/model-selector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA+BF;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,KAAK,GAAG,IAAI,GACjB,cAAc,CAkChB"}

package/dist/lib/model-selector.js

@@ -0,0 +1,74 @@
+/**
+ * Model selection for dev/qa tasks.
+ * Keyword heuristic fallback — used when the orchestrator doesn't specify a level.
+ * Returns plain level names (junior, medior, senior, reviewer, tester).
+ */
+// Keywords that indicate simple tasks
+const SIMPLE_KEYWORDS = [
+    "typo",
+    "fix typo",
+    "rename",
+    "update text",
+    "change color",
+    "minor",
+    "small",
+    "css",
+    "style",
+    "copy",
+    "wording",
+];
+// Keywords that indicate complex tasks
+const COMPLEX_KEYWORDS = [
+    "architect",
+    "refactor",
+    "redesign",
+    "system-wide",
+    "migration",
+    "database schema",
+    "security",
+    "performance",
+    "infrastructure",
+    "multi-service",
+];
+/**
+ * Select appropriate developer level based on task description.
+ *
+ * Developer levels:
+ * - junior: very simple (typos, single-file fixes, CSS tweaks)
+ * - medior: standard DEV (features, bug fixes, multi-file changes)
+ * - senior: deep/architectural (system-wide refactoring, novel design)
+ * - reviewer: QA code inspection and validation
+ * - tester: QA manual testing
+ */
+export function selectLevel(issueTitle, issueDescription, role) {
+    if (role === "qa") {
+        return {
+            level: "reviewer",
+            reason: "Default QA level for code inspection and validation",
+        };
+    }
+    const text = `${issueTitle} ${issueDescription}`.toLowerCase();
+    const wordCount = text.split(/\s+/).length;
+    // Check for simple task indicators
+    const isSimple = SIMPLE_KEYWORDS.some((kw) => text.includes(kw));
+    if (isSimple && wordCount < 100) {
+        return {
+            level: "junior",
+            reason: `Simple task detected (keywords: ${SIMPLE_KEYWORDS.filter((kw) => text.includes(kw)).join(", ")})`,
+        };
+    }
+    // Check for complex task indicators
+    const isComplex = COMPLEX_KEYWORDS.some((kw) => text.includes(kw));
+    if (isComplex || wordCount > 500) {
+        return {
+            level: "senior",
+            reason: `Complex task detected (${isComplex ? "keywords: " + COMPLEX_KEYWORDS.filter((kw) => text.includes(kw)).join(", ") : "long description"})`,
+        };
+    }
+    // Default: medior for standard dev work
+    return {
+        level: "medior",
+        reason: "Standard dev task — multi-file changes, features, bug fixes",
+    };
+}
+//# sourceMappingURL=model-selector.js.map

package/dist/lib/model-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selector.js","sourceRoot":"","sources":["../../lib/model-selector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,sCAAsC;AACtC,MAAM,eAAe,GAAG;IACtB,MAAM;IACN,UAAU;IACV,QAAQ;IACR,aAAa;IACb,cAAc;IACd,OAAO;IACP,OAAO;IACP,KAAK;IACL,OAAO;IACP,MAAM;IACN,SAAS;CACV,CAAC;AAEF,uCAAuC;AACvC,MAAM,gBAAgB,GAAG;IACvB,WAAW;IACX,UAAU;IACV,UAAU;IACV,aAAa;IACb,WAAW;IACX,iBAAiB;IACjB,UAAU;IACV,aAAa;IACb,gBAAgB;IAChB,eAAe;CAChB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,UAAkB,EAClB,gBAAwB,EACxB,IAAkB;IAElB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,qDAAqD;SAC9D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,UAAU,IAAI,gBAAgB,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAE3C,mCAAmC;IACnC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,IAAI,QAAQ,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;QAChC,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,mCAAmC,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SAC3G,CAAC;IACJ,CAAC;IAED,oCAAoC;IACpC,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,IAAI,SAAS,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;QACjC,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,0BAA0B,SAAS,CAAC,CAAC,CAAC,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,GAAG;SACnJ,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,6DAA6D;KACtE,CAAC;AACJ,CAAC"}