@laurentenhoor/devclaw 0.1.0

package/dist/lib/notify.d.ts

@@ -0,0 +1,54 @@
+import type { TickAction } from "./services/tick.js";
+/** Per-event-type toggle. All default to true — set to false to suppress. */
+export type NotificationConfig = Partial<Record<NotifyEvent["type"], boolean>>;
+export type NotifyEvent = {
+    type: "workerStart";
+    project: string;
+    groupId: string;
+    issueId: number;
+    issueTitle: string;
+    issueUrl: string;
+    role: "dev" | "qa";
+    level: string;
+    sessionAction: "spawn" | "send";
+} | {
+    type: "workerComplete";
+    project: string;
+    groupId: string;
+    issueId: number;
+    issueUrl: string;
+    role: "dev" | "qa";
+    result: "done" | "pass" | "fail" | "refine" | "blocked";
+    summary?: string;
+    nextState?: string;
+};
+/**
+ * Send a notification for a worker lifecycle event.
+ *
+ * Returns true if notification was sent, false on error.
+ */
+export declare function notify(event: NotifyEvent, opts: {
+    workspaceDir: string;
+    config?: NotificationConfig;
+    /** Target for project-scoped notifications (groupId) */
+    groupId?: string;
+    /** Channel type for routing (e.g. "telegram", "whatsapp", "discord", "slack") */
+    channel?: string;
+}): Promise<boolean>;
+/**
+ * Send workerStart notifications for each tick pickup.
+ *
+ * Called after projectTick() returns pickups — callers pass the array
+ * so each dispatched task gets a visible start notification in the project group.
+ */
+export declare function notifyTickPickups(pickups: TickAction[], opts: {
+    workspaceDir: string;
+    config?: NotificationConfig;
+    channel?: string;
+}): Promise<void>;
+/**
+ * Extract notification config from plugin config.
+ * All event types default to enabled (true).
+ */
+export declare function getNotificationConfig(pluginConfig?: Record<string, unknown>): NotificationConfig;
+//# sourceMappingURL=notify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../lib/notify.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/E,MAAM,MAAM,WAAW,GACnB;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC;CACjC,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAmFN;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE;IACJ,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,UAAU,EAAE,EACrB,IAAI,EAAE;IACJ,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,kBAAkB,CAEpB"}

package/dist/lib/notify.js

@@ -0,0 +1,143 @@
+/**
+ * notify.ts — Programmatic alerting for worker lifecycle events.
+ *
+ * Sends notifications to project groups for visibility into the DevClaw pipeline.
+ *
+ * Event types:
+ * - workerStart: Worker spawned/resumed for a task (→ project group)
+ * - workerComplete: Worker completed task (→ project group)
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { log as auditLog } from "./audit.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Build a human-readable message for a notification event.
+ */
+function buildMessage(event) {
+    switch (event.type) {
+        case "workerStart": {
+            const action = event.sessionAction === "spawn" ? "🚀 Started" : "▶️ Resumed";
+            return `${action} ${event.role.toUpperCase()} (${event.level}) on #${event.issueId}: ${event.issueTitle}\n🔗 ${event.issueUrl}`;
+        }
+        case "workerComplete": {
+            const icons = {
+                done: "✅",
+                pass: "🎉",
+                fail: "❌",
+                refine: "🤔",
+                blocked: "🚫",
+            };
+            const icon = icons[event.result] ?? "📋";
+            const resultText = {
+                done: "completed",
+                pass: "PASSED",
+                fail: "FAILED",
+                refine: "needs refinement",
+                blocked: "BLOCKED",
+            };
+            const text = resultText[event.result] ?? event.result;
+            let msg = `${icon} ${event.role.toUpperCase()} ${text} #${event.issueId}`;
+            if (event.summary) {
+                msg += ` — ${event.summary}`;
+            }
+            if (event.nextState) {
+                msg += ` → ${event.nextState}`;
+            }
+            msg += `\n🔗 ${event.issueUrl}`;
+            return msg;
+        }
+    }
+}
+/**
+ * Send a notification message via the native OpenClaw messaging CLI.
+ *
+ * Uses `openclaw message send` which handles target resolution, chunking,
+ * retries, and error reporting for all supported channels.
+ * Fails silently (logs error but doesn't throw) to avoid breaking the main flow.
+ */
+async function sendMessage(target, message, channel, workspaceDir) {
+    try {
+        await execFileAsync("openclaw", [
+            "message",
+            "send",
+            "--channel",
+            channel,
+            "--target",
+            target,
+            "--message",
+            message,
+            "--json",
+        ], { timeout: 30_000 });
+        return true;
+    }
+    catch (err) {
+        // Log but don't throw — notifications shouldn't break the main flow
+        await auditLog(workspaceDir, "notify_error", {
+            target,
+            channel,
+            error: err.message,
+        });
+        return false;
+    }
+}
+/**
+ * Send a notification for a worker lifecycle event.
+ *
+ * Returns true if notification was sent, false on error.
+ */
+export async function notify(event, opts) {
+    if (opts.config?.[event.type] === false)
+        return true;
+    const channel = opts.channel ?? "telegram";
+    const message = buildMessage(event);
+    const target = opts.groupId ?? event.groupId;
+    if (!target) {
+        await auditLog(opts.workspaceDir, "notify_skip", {
+            eventType: event.type,
+            reason: "no target",
+        });
+        return true; // Not an error, just nothing to do
+    }
+    await auditLog(opts.workspaceDir, "notify", {
+        eventType: event.type,
+        target,
+        channel,
+        message,
+    });
+    return sendMessage(target, message, channel, opts.workspaceDir);
+}
+/**
+ * Send workerStart notifications for each tick pickup.
+ *
+ * Called after projectTick() returns pickups — callers pass the array
+ * so each dispatched task gets a visible start notification in the project group.
+ */
+export async function notifyTickPickups(pickups, opts) {
+    for (const pickup of pickups) {
+        await notify({
+            type: "workerStart",
+            project: pickup.project,
+            groupId: pickup.groupId,
+            issueId: pickup.issueId,
+            issueTitle: pickup.issueTitle,
+            issueUrl: pickup.issueUrl,
+            role: pickup.role,
+            level: pickup.level,
+            sessionAction: pickup.sessionAction,
+        }, {
+            workspaceDir: opts.workspaceDir,
+            config: opts.config,
+            groupId: pickup.groupId,
+            channel: opts.channel,
+        });
+    }
+}
+/**
+ * Extract notification config from plugin config.
+ * All event types default to enabled (true).
+ */
+export function getNotificationConfig(pluginConfig) {
+    return pluginConfig?.notifications ?? {};
+}
+//# sourceMappingURL=notify.js.map

package/dist/lib/notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../lib/notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,GAAG,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AA6B1C;;GAEG;AACH,SAAS,YAAY,CAAC,KAAkB;IACtC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;YAC7E,OAAO,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,KAAK,SAAS,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,UAAU,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC;QAClI,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,KAAK,GAA2B;gBACpC,IAAI,EAAE,GAAG;gBACT,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,GAAG;gBACT,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,IAAI;aACd,CAAC;YACF,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;YACzC,MAAM,UAAU,GAA2B;gBACzC,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,kBAAkB;gBAC1B,OAAO,EAAE,SAAS;aACnB,CAAC;YACF,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC;YACtD,IAAI,GAAG,GAAG,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;YAC1E,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,GAAG,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;YAC/B,CAAC;YACD,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACpB,GAAG,IAAI,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,CAAC;YACD,GAAG,IAAI,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,WAAW,CACxB,MAAc,EACd,OAAe,EACf,OAAe,EACf,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,aAAa,CACjB,UAAU,EACV;YACE,SAAS;YACT,MAAM;YACN,WAAW;YACX,OAAO;YACP,UAAU;YACV,MAAM;YACN,WAAW;YACX,OAAO;YACP,QAAQ;SACT,EACD,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oEAAoE;QACpE,MAAM,QAAQ,CAAC,YAAY,EAAE,cAAc,EAAE;YAC3C,MAAM;YACN,OAAO;YACP,KAAK,EAAG,GAAa,CAAC,OAAO;SAC9B,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,KAAkB,EAClB,IAOC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAErD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC;IAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAK,KAA8B,CAAC,OAAO,CAAC;IAEvE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,EAAE;YAC/C,SAAS,EAAE,KAAK,CAAC,IAAI;YACrB,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,CAAC,mCAAmC;IAClD,CAAC;IAED,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE;QAC1C,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,MAAM;QACN,OAAO;QACP,OAAO;KACR,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAqB,EACrB,IAIC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,CACV;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,EACD;YACE,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAsC;IAEtC,OAAQ,YAAY,EAAE,aAAoC,IAAI,EAAE,CAAC;AACnE,CAAC"}

package/dist/lib/onboarding.d.ts

@@ -0,0 +1,5 @@
+export declare function isPluginConfigured(pluginConfig?: Record<string, unknown>): boolean;
+export declare function hasWorkspaceFiles(workspaceDir?: string): Promise<boolean>;
+export declare function buildReconfigContext(pluginConfig?: Record<string, unknown>): string;
+export declare function buildOnboardToolContext(): string;
+//# sourceMappingURL=onboarding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../lib/onboarding.ts"],"names":[],"mappings":"AAaA,wBAAgB,kBAAkB,CAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAGT;AAED,wBAAsB,iBAAiB,CACrC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAkBD,wBAAgB,oBAAoB,CAClC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,MAAM,CAgBR;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAkEhD"}

package/dist/lib/onboarding.js

@@ -0,0 +1,124 @@
+/**
+ * onboarding.ts — Conversational onboarding context templates.
+ *
+ * Provides context templates for the onboard tool.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { DEFAULT_MODELS } from "./tiers.js";
+// ---------------------------------------------------------------------------
+// Detection
+// ---------------------------------------------------------------------------
+export function isPluginConfigured(pluginConfig) {
+    const models = pluginConfig?.models;
+    return !!models && Object.keys(models).length > 0;
+}
+export async function hasWorkspaceFiles(workspaceDir) {
+    if (!workspaceDir)
+        return false;
+    try {
+        const content = await fs.readFile(path.join(workspaceDir, "AGENTS.md"), "utf-8");
+        return content.includes("DevClaw") && content.includes("work_start");
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Context templates
+// ---------------------------------------------------------------------------
+function buildModelTable(pluginConfig) {
+    const cfg = pluginConfig?.models;
+    const lines = [];
+    for (const [role, levels] of Object.entries(DEFAULT_MODELS)) {
+        for (const [level, defaultModel] of Object.entries(levels)) {
+            const model = cfg?.[role]?.[level] || defaultModel;
+            lines.push(`  - **${role} ${level}**: ${model} (default: ${defaultModel})`);
+        }
+    }
+    return lines.join("\n");
+}
+export function buildReconfigContext(pluginConfig) {
+    const modelTable = buildModelTable(pluginConfig);
+    return `# DevClaw Reconfiguration
+
+The user wants to reconfigure DevClaw. Current model configuration:
+
+${modelTable}
+
+## What can be changed
+1. **Model levels** — call \`setup\` with a \`models\` object containing only the levels to change
+2. **Workspace files** — \`setup\` re-writes AGENTS.md, HEARTBEAT.md (backs up existing files)
+3. **Register new projects** — use \`project_register\`
+
+Ask what they want to change, then call the appropriate tool.
+\`setup\` is safe to re-run — it backs up existing files before overwriting.
+`;
+}
+export function buildOnboardToolContext() {
+    // Build the model table dynamically from DEFAULT_MODELS
+    const rows = [];
+    const purposes = {
+        junior: "Typos, single-file fixes",
+        medior: "Features, bug fixes",
+        senior: "Architecture, refactoring",
+        reviewer: "Code review",
+        tester: "Testing",
+    };
+    for (const [role, levels] of Object.entries(DEFAULT_MODELS)) {
+        for (const [level, model] of Object.entries(levels)) {
+            rows.push(`| ${role} | ${level} | ${model} | ${purposes[level] ?? ""} |`);
+        }
+    }
+    const modelTable = rows.join("\n");
+    return `# DevClaw Onboarding
+
+## What is DevClaw?
+DevClaw turns each Telegram group into an autonomous development team:
+- An **orchestrator** that manages backlogs and delegates work
+- **DEV workers** (junior/medior/senior levels) that write code in isolated sessions
+- **QA workers** that review code and run tests
+- Atomic tools for label transitions, session dispatch, state management, and audit logging
+
+## Setup Steps
+
+**Step 1: Agent Selection**
+Ask: "Do you want to configure DevClaw for the current agent, or create a new dedicated agent?"
+- Current agent → no \`newAgentName\` needed
+- New agent → ask for:
+  1. Agent name
+  2. **Channel binding**: "Which channel should this agent listen to? (telegram/whatsapp/none)"
+     - If telegram/whatsapp selected:
+       a) Check openclaw.json for existing channel bindings
+       b) If channel not configured/enabled → warn and recommend skipping binding for now
+       c) If channel-wide binding exists on another agent → ask: "Migrate binding from {agentName}?"
+       d) Collect migration decision
+     - If none selected, user can add bindings manually later via openclaw.json
+
+**Step 2: Model Configuration**
+Show the default level-to-model mapping and ask if they want to customize:
+
+| Role | Level | Default Model | Purpose |
+|------|-------|---------------|---------|
+${modelTable}
+
+If the defaults are fine, proceed. If customizing, ask which levels to change.
+
+**Step 3: Run Setup**
+Call \`setup\` with the collected answers:
+- Current agent: \`setup({})\` or \`setup({ models: { dev: { ... }, qa: { ... } } })\`
+- New agent: \`setup({ newAgentName: "<name>", channelBinding: "telegram"|"whatsapp"|null, migrateFrom: "<agentId>"|null, models: { ... } })\`
+  - \`migrateFrom\`: Include if user wants to migrate an existing channel-wide binding
+
+**Step 4: Optional Project Registration**
+After setup, ask: "Would you like to register a project now?"
+If yes, collect: project name, repo path, Telegram group ID, group name, base branch.
+Then call \`project_register\`.
+
+## Guidelines
+- Be conversational and friendly. Ask one question at a time.
+- Show defaults so the user can accept them quickly.
+- After setup, summarize what was configured (including channel binding if applicable).
+`;
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/lib/onboarding.js.map

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

package/dist/lib/projects.d.ts

@@ -0,0 +1,64 @@
+export type WorkerState = {
+    active: boolean;
+    issueId: string | null;
+    startTime: string | null;
+    level: string | null;
+    sessions: Record<string, string | null>;
+};
+export type Project = {
+    name: string;
+    repo: string;
+    groupName: string;
+    deployUrl: string;
+    baseBranch: string;
+    deployBranch: string;
+    /** Messaging channel for this project's group (e.g. "telegram", "whatsapp", "discord", "slack"). Stored at registration time. */
+    channel?: string;
+    /** Project-level role execution: parallel (DEV+QA can run simultaneously) or sequential (only one role at a time). Default: parallel */
+    roleExecution?: "parallel" | "sequential";
+    maxDevWorkers?: number;
+    maxQaWorkers?: number;
+    dev: WorkerState;
+    qa: WorkerState;
+};
+export type ProjectsData = {
+    projects: Record<string, Project>;
+};
+/**
+ * Create a blank WorkerState with null sessions for given level names.
+ */
+export declare function emptyWorkerState(levels: string[]): WorkerState;
+/**
+ * Get session key for a specific level from a worker's sessions map.
+ */
+export declare function getSessionForLevel(worker: WorkerState, level: string): string | null;
+export declare function readProjects(workspaceDir: string): Promise<ProjectsData>;
+export declare function writeProjects(workspaceDir: string, data: ProjectsData): Promise<void>;
+export declare function getProject(data: ProjectsData, groupId: string): Project | undefined;
+export declare function getWorker(project: Project, role: "dev" | "qa"): WorkerState;
+/**
+ * Update worker state for a project. Only provided fields are updated.
+ * Sessions are merged (not replaced) when both existing and new sessions are present.
+ */
+export declare function updateWorker(workspaceDir: string, groupId: string, role: "dev" | "qa", updates: Partial<WorkerState>): Promise<ProjectsData>;
+/**
+ * Mark a worker as active with a new task.
+ * Stores session key in sessions[level] when a new session is spawned.
+ */
+export declare function activateWorker(workspaceDir: string, groupId: string, role: "dev" | "qa", params: {
+    issueId: string;
+    level: string;
+    sessionKey?: string;
+    startTime?: string;
+}): Promise<ProjectsData>;
+/**
+ * Mark a worker as inactive after task completion.
+ * Preserves sessions map and level for reuse via updateWorker's spread.
+ * Clears startTime to prevent stale timestamps on inactive workers.
+ */
+export declare function deactivateWorker(workspaceDir: string, groupId: string, role: "dev" | "qa"): Promise<ProjectsData>;
+/**
+ * Resolve repo path from projects.json repo field (handles ~/ expansion).
+ */
+export declare function resolveRepoPath(repoField: string): string;
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../lib/projects.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iIAAiI;IACjI,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wIAAwI;IACxI,aAAa,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,WAAW,CAAC;IACjB,EAAE,EAAE,WAAW,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAYF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAY9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAEf;AAMD,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAiB9E;AAED,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,GAAG,SAAS,CAErB;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,KAAK,GAAG,IAAI,GACjB,WAAW,CAEb;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,KAAK,GAAG,IAAI,EAClB,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,YAAY,CAAC,CAiBvB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,KAAK,GAAG,IAAI,EAClB,MAAM,EAAE;IACN,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,YAAY,CAAC,CAavB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,KAAK,GAAG,IAAI,GACjB,OAAO,CAAC,YAAY,CAAC,CAMvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKzD"}

package/dist/lib/projects.js

@@ -0,0 +1,127 @@
+/**
+ * Atomic projects.json read/write operations.
+ * All state mutations go through this module to prevent corruption.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { homedir } from "node:os";
+function parseWorkerState(worker) {
+    return {
+        active: worker.active,
+        issueId: worker.issueId,
+        startTime: worker.startTime,
+        level: (worker.level ?? worker.tier ?? null),
+        sessions: worker.sessions ?? {},
+    };
+}
+/**
+ * Create a blank WorkerState with null sessions for given level names.
+ */
+export function emptyWorkerState(levels) {
+    const sessions = {};
+    for (const l of levels) {
+        sessions[l] = null;
+    }
+    return {
+        active: false,
+        issueId: null,
+        startTime: null,
+        level: null,
+        sessions,
+    };
+}
+/**
+ * Get session key for a specific level from a worker's sessions map.
+ */
+export function getSessionForLevel(worker, level) {
+    return worker.sessions[level] ?? null;
+}
+function projectsPath(workspaceDir) {
+    return path.join(workspaceDir, "projects", "projects.json");
+}
+export async function readProjects(workspaceDir) {
+    const raw = await fs.readFile(projectsPath(workspaceDir), "utf-8");
+    const data = JSON.parse(raw);
+    for (const project of Object.values(data.projects)) {
+        project.dev = project.dev
+            ? parseWorkerState(project.dev)
+            : emptyWorkerState([]);
+        project.qa = project.qa
+            ? parseWorkerState(project.qa)
+            : emptyWorkerState([]);
+        if (!project.channel) {
+            project.channel = "telegram";
+        }
+    }
+    return data;
+}
+export async function writeProjects(workspaceDir, data) {
+    const filePath = projectsPath(workspaceDir);
+    const tmpPath = filePath + ".tmp";
+    await fs.writeFile(tmpPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+    await fs.rename(tmpPath, filePath);
+}
+export function getProject(data, groupId) {
+    return data.projects[groupId];
+}
+export function getWorker(project, role) {
+    return project[role];
+}
+/**
+ * Update worker state for a project. Only provided fields are updated.
+ * Sessions are merged (not replaced) when both existing and new sessions are present.
+ */
+export async function updateWorker(workspaceDir, groupId, role, updates) {
+    const data = await readProjects(workspaceDir);
+    const project = data.projects[groupId];
+    if (!project) {
+        throw new Error(`Project not found for groupId: ${groupId}`);
+    }
+    const worker = project[role];
+    if (updates.sessions && worker.sessions) {
+        updates.sessions = { ...worker.sessions, ...updates.sessions };
+    }
+    project[role] = { ...worker, ...updates };
+    await writeProjects(workspaceDir, data);
+    return data;
+}
+/**
+ * Mark a worker as active with a new task.
+ * Stores session key in sessions[level] when a new session is spawned.
+ */
+export async function activateWorker(workspaceDir, groupId, role, params) {
+    const updates = {
+        active: true,
+        issueId: params.issueId,
+        level: params.level,
+    };
+    if (params.sessionKey !== undefined) {
+        updates.sessions = { [params.level]: params.sessionKey };
+    }
+    if (params.startTime !== undefined) {
+        updates.startTime = params.startTime;
+    }
+    return updateWorker(workspaceDir, groupId, role, updates);
+}
+/**
+ * Mark a worker as inactive after task completion.
+ * Preserves sessions map and level for reuse via updateWorker's spread.
+ * Clears startTime to prevent stale timestamps on inactive workers.
+ */
+export async function deactivateWorker(workspaceDir, groupId, role) {
+    return updateWorker(workspaceDir, groupId, role, {
+        active: false,
+        issueId: null,
+        startTime: null,
+    });
+}
+/**
+ * Resolve repo path from projects.json repo field (handles ~/ expansion).
+ */
+export function resolveRepoPath(repoField) {
+    if (repoField.startsWith("~/")) {
+        return repoField.replace("~", homedir());
+    }
+    return repoField;
+}
+//# sourceMappingURL=projects.js.map

package/dist/lib/projects.js.map

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

package/dist/lib/providers/github.d.ts

@@ -0,0 +1,23 @@
+import { type IssueProvider, type Issue, type StateLabel } from "./provider.js";
+export declare class GitHubProvider implements IssueProvider {
+    private repoPath;
+    constructor(opts: {
+        repoPath: string;
+    });
+    private gh;
+    ensureLabel(name: string, color: string): Promise<void>;
+    ensureAllStateLabels(): Promise<void>;
+    createIssue(title: string, description: string, label: StateLabel, assignees?: string[]): Promise<Issue>;
+    listIssuesByLabel(label: StateLabel): Promise<Issue[]>;
+    getIssue(issueId: number): Promise<Issue>;
+    transitionLabel(issueId: number, from: StateLabel, to: StateLabel): Promise<void>;
+    closeIssue(issueId: number): Promise<void>;
+    reopenIssue(issueId: number): Promise<void>;
+    hasStateLabel(issue: Issue, expected: StateLabel): boolean;
+    getCurrentStateLabel(issue: Issue): StateLabel | null;
+    hasMergedMR(issueId: number): Promise<boolean>;
+    getMergedMRUrl(issueId: number): Promise<string | null>;
+    addComment(issueId: number, body: string): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/lib/providers/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../lib/providers/github.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,UAAU,EAGhB,MAAM,eAAe,CAAC;AAoBvB,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,QAAQ,CAAS;gBACb,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;YAExB,EAAE;IAKV,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAaxG,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAOtD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAKzC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IASjF,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjD,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO;IAC1D,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,IAAI;IAI/C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS9C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASvD,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}