@laurentenhoor/devclaw 0.1.0

package/dist/lib/services/heartbeat.js

@@ -0,0 +1,199 @@
+import fs from "node:fs";
+import path from "node:path";
+import { readProjects } from "../projects.js";
+import { log as auditLog } from "../audit.js";
+import { checkWorkerHealth } from "./health.js";
+import { projectTick } from "./tick.js";
+import { createProvider } from "../providers/index.js";
+// ---------------------------------------------------------------------------
+// Config
+// ---------------------------------------------------------------------------
+export const HEARTBEAT_DEFAULTS = {
+    enabled: true,
+    intervalSeconds: 60,
+    maxPickupsPerTick: 4,
+};
+export function resolveHeartbeatConfig(pluginConfig) {
+    const raw = pluginConfig?.work_heartbeat;
+    return { ...HEARTBEAT_DEFAULTS, ...raw };
+}
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+export function registerHeartbeatService(api) {
+    let intervalId = null;
+    api.registerService({
+        id: "devclaw-heartbeat",
+        start: async (ctx) => {
+            const pluginConfig = api.pluginConfig;
+            const config = resolveHeartbeatConfig(pluginConfig);
+            if (!config.enabled) {
+                ctx.logger.info("work_heartbeat service disabled");
+                return;
+            }
+            const agents = discoverAgents(ctx.config);
+            if (agents.length === 0) {
+                ctx.logger.warn("work_heartbeat service: no DevClaw agents registered");
+                return;
+            }
+            ctx.logger.info(`work_heartbeat service started: every ${config.intervalSeconds}s, ${agents.length} agents, max ${config.maxPickupsPerTick} pickups/tick`);
+            intervalId = setInterval(() => runHeartbeatTick(agents, config, pluginConfig, ctx.logger), config.intervalSeconds * 1000);
+        },
+        stop: async (ctx) => {
+            if (intervalId) {
+                clearInterval(intervalId);
+                intervalId = null;
+                ctx.logger.info("work_heartbeat service stopped");
+            }
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Discover DevClaw agents by scanning which agent workspaces have projects.
+ * Self-discovering: any agent whose workspace contains projects/projects.json is processed.
+ */
+function discoverAgents(config) {
+    const agentsList = config.agents?.list || [];
+    return agentsList
+        .filter((a) => {
+        if (!a.workspace)
+            return false;
+        try {
+            return fs.existsSync(path.join(a.workspace, "projects", "projects.json"));
+        }
+        catch {
+            return false;
+        }
+    })
+        .map((a) => ({ agentId: a.id, workspace: a.workspace }));
+}
+/**
+ * Run one heartbeat tick for all agents.
+ */
+async function runHeartbeatTick(agents, config, pluginConfig, logger) {
+    try {
+        const result = await processAllAgents(agents, config, pluginConfig, logger);
+        logTickResult(result, logger);
+    }
+    catch (err) {
+        logger.error(`work_heartbeat tick failed: ${err}`);
+    }
+}
+/**
+ * Process heartbeat tick for all agents and aggregate results.
+ */
+async function processAllAgents(agents, config, pluginConfig, logger) {
+    const result = {
+        totalPickups: 0,
+        totalHealthFixes: 0,
+        totalSkipped: 0,
+    };
+    for (const { agentId, workspace } of agents) {
+        const agentResult = await tick({
+            workspaceDir: workspace,
+            agentId,
+            config,
+            pluginConfig,
+            logger,
+        });
+        result.totalPickups += agentResult.totalPickups;
+        result.totalHealthFixes += agentResult.totalHealthFixes;
+        result.totalSkipped += agentResult.totalSkipped;
+    }
+    return result;
+}
+/**
+ * Log tick results if anything happened.
+ */
+function logTickResult(result, logger) {
+    if (result.totalPickups > 0 || result.totalHealthFixes > 0) {
+        logger.info(`work_heartbeat tick: ${result.totalPickups} pickups, ${result.totalHealthFixes} health fixes, ${result.totalSkipped} skipped`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Tick (Main Heartbeat Loop)
+// ---------------------------------------------------------------------------
+export async function tick(opts) {
+    const { workspaceDir, agentId, config, pluginConfig } = opts;
+    const data = await readProjects(workspaceDir);
+    const projectIds = Object.keys(data.projects);
+    if (projectIds.length === 0) {
+        return { totalPickups: 0, totalHealthFixes: 0, totalSkipped: 0 };
+    }
+    const result = {
+        totalPickups: 0,
+        totalHealthFixes: 0,
+        totalSkipped: 0,
+    };
+    const projectExecution = pluginConfig?.projectExecution ?? "parallel";
+    let activeProjects = 0;
+    for (const groupId of projectIds) {
+        const project = data.projects[groupId];
+        if (!project)
+            continue;
+        // Health pass: auto-fix zombies and stale workers
+        result.totalHealthFixes += await performHealthPass(workspaceDir, groupId, project);
+        // Budget check: stop if we've hit the limit
+        const remaining = config.maxPickupsPerTick - result.totalPickups;
+        if (remaining <= 0)
+            break;
+        // Sequential project guard: don't start new projects if one is active
+        const isProjectActive = await checkProjectActive(workspaceDir, groupId);
+        if (projectExecution === "sequential" && !isProjectActive && activeProjects >= 1) {
+            result.totalSkipped++;
+            continue;
+        }
+        // Tick pass: fill free worker slots
+        const tickResult = await projectTick({
+            workspaceDir,
+            groupId,
+            agentId,
+            pluginConfig,
+            maxPickups: remaining,
+        });
+        result.totalPickups += tickResult.pickups.length;
+        result.totalSkipped += tickResult.skipped.length;
+        if (isProjectActive || tickResult.pickups.length > 0)
+            activeProjects++;
+    }
+    await auditLog(workspaceDir, "heartbeat_tick", {
+        projectsScanned: projectIds.length,
+        healthFixes: result.totalHealthFixes,
+        pickups: result.totalPickups,
+        skipped: result.totalSkipped,
+    });
+    return result;
+}
+/**
+ * Run health checks and auto-fix for a project (dev + qa roles).
+ */
+async function performHealthPass(workspaceDir, groupId, project) {
+    const { provider } = createProvider({ repo: project.repo });
+    let fixedCount = 0;
+    for (const role of ["dev", "qa"]) {
+        const fixes = await checkWorkerHealth({
+            workspaceDir,
+            groupId,
+            project,
+            role,
+            activeSessions: [],
+            autoFix: true,
+            provider,
+        });
+        fixedCount += fixes.filter((f) => f.fixed).length;
+    }
+    return fixedCount;
+}
+/**
+ * Check if a project has active work (dev or qa).
+ */
+async function checkProjectActive(workspaceDir, groupId) {
+    const fresh = (await readProjects(workspaceDir)).projects[groupId];
+    if (!fresh)
+        return false;
+    return fresh.dev.active || fresh.qa.active;
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/lib/services/heartbeat.js.map

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

package/dist/lib/services/pipeline.d.ts

@@ -0,0 +1,36 @@
+import type { StateLabel, IssueProvider } from "../providers/provider.js";
+export type CompletionRule = {
+    from: StateLabel;
+    to: StateLabel;
+    gitPull?: boolean;
+    detectPr?: boolean;
+    closeIssue?: boolean;
+    reopenIssue?: boolean;
+};
+export declare const COMPLETION_RULES: Record<string, CompletionRule>;
+export declare const NEXT_STATE: Record<string, string>;
+export type CompletionOutput = {
+    labelTransition: string;
+    announcement: string;
+    nextState: string;
+    prUrl?: string;
+    issueUrl?: string;
+    issueClosed?: boolean;
+    issueReopened?: boolean;
+};
+export declare function getRule(role: string, result: string): CompletionRule | undefined;
+/**
+ * Execute the completion side-effects for a role:result pair.
+ */
+export declare function executeCompletion(opts: {
+    workspaceDir: string;
+    groupId: string;
+    role: "dev" | "qa";
+    result: string;
+    issueId: number;
+    summary?: string;
+    prUrl?: string;
+    provider: IssueProvider;
+    repoPath: string;
+}): Promise<CompletionOutput>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/lib/services/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../lib/services/pipeline.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK1E,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,UAAU,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAO3D,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO7C,CAAC;AAWF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+C5B"}

package/dist/lib/services/pipeline.js

@@ -0,0 +1,90 @@
+/**
+ * Pipeline service — declarative completion rules.
+ *
+ * Replaces 7 if-blocks with a data-driven lookup table.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { deactivateWorker } from "../projects.js";
+const execFileAsync = promisify(execFile);
+export const COMPLETION_RULES = {
+    "dev:done": { from: "Doing", to: "To Test", gitPull: true, detectPr: true },
+    "qa:pass": { from: "Testing", to: "Done", closeIssue: true },
+    "qa:fail": { from: "Testing", to: "To Improve", reopenIssue: true },
+    "qa:refine": { from: "Testing", to: "Refining" },
+    "dev:blocked": { from: "Doing", to: "To Do" },
+    "qa:blocked": { from: "Testing", to: "To Test" },
+};
+export const NEXT_STATE = {
+    "dev:done": "QA queue",
+    "dev:blocked": "returned to queue",
+    "qa:pass": "Done!",
+    "qa:fail": "back to DEV",
+    "qa:refine": "awaiting human decision",
+    "qa:blocked": "returned to QA queue",
+};
+const EMOJI = {
+    "dev:done": "✅",
+    "qa:pass": "🎉",
+    "qa:fail": "❌",
+    "qa:refine": "🤔",
+    "dev:blocked": "🚫",
+    "qa:blocked": "🚫",
+};
+export function getRule(role, result) {
+    return COMPLETION_RULES[`${role}:${result}`];
+}
+/**
+ * Execute the completion side-effects for a role:result pair.
+ */
+export async function executeCompletion(opts) {
+    const { workspaceDir, groupId, role, result, issueId, summary, provider, repoPath } = opts;
+    const key = `${role}:${result}`;
+    const rule = COMPLETION_RULES[key];
+    if (!rule)
+        throw new Error(`No completion rule for ${key}`);
+    let prUrl = opts.prUrl;
+    // Git pull (dev:done)
+    if (rule.gitPull) {
+        try {
+            await execFileAsync("git", ["pull"], { cwd: repoPath, timeout: 30_000 });
+        }
+        catch { /* best-effort */ }
+    }
+    // Auto-detect PR URL (dev:done)
+    if (rule.detectPr && !prUrl) {
+        try {
+            prUrl = await provider.getMergedMRUrl(issueId) ?? undefined;
+        }
+        catch { /* ignore */ }
+    }
+    // Deactivate worker + transition label
+    await deactivateWorker(workspaceDir, groupId, role);
+    await provider.transitionLabel(issueId, rule.from, rule.to);
+    // Close/reopen
+    if (rule.closeIssue)
+        await provider.closeIssue(issueId);
+    if (rule.reopenIssue)
+        await provider.reopenIssue(issueId);
+    // Build announcement
+    const issue = await provider.getIssue(issueId);
+    const emoji = EMOJI[key] ?? "📋";
+    const label = key.replace(":", " ").toUpperCase();
+    let announcement = `${emoji} ${label} #${issueId}`;
+    if (summary)
+        announcement += ` — ${summary}`;
+    announcement += `\n📋 Issue: ${issue.web_url}`;
+    if (prUrl)
+        announcement += `\n🔗 PR: ${prUrl}`;
+    announcement += `\n${NEXT_STATE[key]}.`;
+    return {
+        labelTransition: `${rule.from} → ${rule.to}`,
+        announcement,
+        nextState: NEXT_STATE[key],
+        prUrl,
+        issueUrl: issue.web_url,
+        issueClosed: rule.closeIssue,
+        issueReopened: rule.reopenIssue,
+    };
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/lib/services/pipeline.js.map

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

package/dist/lib/services/queue.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Queue service — issue queue fetching.
+ *
+ * Fetches issue queues per project from the issue provider.
+ * Pure functions, no tool registration or state mutation.
+ */
+import type { Issue } from "../providers/provider.js";
+import type { Project } from "../projects.js";
+export type QueueLabel = "To Improve" | "To Test" | "To Do";
+export declare const QUEUE_PRIORITY: Record<QueueLabel, number>;
+export declare function getTaskPriority(label: QueueLabel, issue: Issue): number;
+export declare function getRoleForLabel(label: QueueLabel): "dev" | "qa";
+export declare function fetchProjectQueues(project: Project): Promise<Record<QueueLabel, Issue[]>>;
+//# sourceMappingURL=queue.d.ts.map

package/dist/lib/services/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../lib/services/queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5D,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAIrD,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAEvE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,GAAG,IAAI,CAE/D;AAMD,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAc/F"}

package/dist/lib/services/queue.js

@@ -0,0 +1,31 @@
+import { createProvider } from "../providers/index.js";
+export const QUEUE_PRIORITY = {
+    "To Improve": 3,
+    "To Test": 2,
+    "To Do": 1,
+};
+export function getTaskPriority(label, issue) {
+    return QUEUE_PRIORITY[label] * 10000 - issue.iid;
+}
+export function getRoleForLabel(label) {
+    return label === "To Test" ? "qa" : "dev";
+}
+// ---------------------------------------------------------------------------
+// Fetching
+// ---------------------------------------------------------------------------
+export async function fetchProjectQueues(project) {
+    const { provider } = createProvider({ repo: project.repo });
+    const labels = ["To Improve", "To Test", "To Do"];
+    const queues = { "To Improve": [], "To Test": [], "To Do": [] };
+    for (const label of labels) {
+        try {
+            const issues = await provider.listIssuesByLabel(label);
+            queues[label] = issues.sort((a, b) => getTaskPriority(label, b) - getTaskPriority(label, a));
+        }
+        catch {
+            queues[label] = [];
+        }
+    }
+    return queues;
+}
+//# sourceMappingURL=queue.js.map

package/dist/lib/services/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../lib/services/queue.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AASvD,MAAM,CAAC,MAAM,cAAc,GAA+B;IACxD,YAAY,EAAE,CAAC;IACf,SAAS,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC;CACX,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,KAAiB,EAAE,KAAY;IAC7D,OAAO,cAAc,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAgB;IACvD,MAAM,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAiB,CAAC,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,MAAM,GAAgC,EAAE,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAE7F,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACvD,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/F,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/services/tick.d.ts

@@ -0,0 +1,62 @@
+/**
+ * tick.ts — Project-level queue scan + dispatch.
+ *
+ * Core function: projectTick() scans one project's queue and fills free worker slots.
+ * Called by: work_start (fill parallel slot), work_finish (next pipeline step), heartbeat service (sweep).
+ */
+import type { Issue, StateLabel } from "../providers/provider.js";
+import type { IssueProvider } from "../providers/provider.js";
+export declare const DEV_LABELS: StateLabel[];
+export declare const QA_LABELS: StateLabel[];
+export declare const PRIORITY_ORDER: StateLabel[];
+export declare function detectLevelFromLabels(labels: string[]): string | null;
+export declare function detectRoleFromLabel(label: StateLabel): "dev" | "qa" | null;
+export declare function findNextIssueForRole(provider: Pick<IssueProvider, "listIssuesByLabel">, role: "dev" | "qa"): Promise<{
+    issue: Issue;
+    label: StateLabel;
+} | null>;
+/**
+ * Find next issue for any role (optional filter). Used by work_start for auto-detection.
+ */
+export declare function findNextIssue(provider: Pick<IssueProvider, "listIssuesByLabel">, role?: "dev" | "qa"): Promise<{
+    issue: Issue;
+    label: StateLabel;
+} | null>;
+export type TickAction = {
+    project: string;
+    groupId: string;
+    issueId: number;
+    issueTitle: string;
+    issueUrl: string;
+    role: "dev" | "qa";
+    level: string;
+    sessionAction: "spawn" | "send";
+    announcement: string;
+};
+export type TickResult = {
+    pickups: TickAction[];
+    skipped: Array<{
+        role?: string;
+        reason: string;
+    }>;
+};
+/**
+ * Scan one project's queue and fill free worker slots.
+ *
+ * Does NOT run health checks (that's the heartbeat service's job).
+ * Non-destructive: only dispatches if slots are free and issues are queued.
+ */
+export declare function projectTick(opts: {
+    workspaceDir: string;
+    groupId: string;
+    agentId?: string;
+    sessionKey?: string;
+    pluginConfig?: Record<string, unknown>;
+    dryRun?: boolean;
+    maxPickups?: number;
+    /** Only attempt this role. Used by work_start to fill the other slot. */
+    targetRole?: "dev" | "qa";
+    /** Optional provider override (for testing). Uses createProvider if omitted. */
+    provider?: Pick<IssueProvider, "listIssuesByLabel" | "transitionLabel">;
+}): Promise<TickResult>;
+//# sourceMappingURL=tick.d.ts.map

package/dist/lib/services/tick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick.d.ts","sourceRoot":"","sources":["../../../lib/services/tick.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAW9D,eAAO,MAAM,UAAU,EAAE,UAAU,EAA4B,CAAC;AAChE,eAAO,MAAM,SAAS,EAAE,UAAU,EAAgB,CAAC;AACnD,eAAO,MAAM,cAAc,EAAE,UAAU,EAAuC,CAAC;AAE/E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAgBrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,CAI1E;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,mBAAmB,CAAC,EAClD,IAAI,EAAE,KAAK,GAAG,IAAI,GACjB,OAAO,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAAC,CAWrD;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,mBAAmB,CAAC,EAClD,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,GAClB,OAAO,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAAC,CAWrD;AAMD,MAAM,MAAM,UAAU,GAAG;IACvB,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;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,UAAU,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,mBAAmB,GAAG,iBAAiB,CAAC,CAAC;CACzE,GAAG,OAAO,CAAC,UAAU,CAAC,CAwEtB"}

package/dist/lib/services/tick.js

@@ -0,0 +1,160 @@
+import { createProvider } from "../providers/index.js";
+import { selectLevel } from "../model-selector.js";
+import { getWorker, getSessionForLevel, readProjects } from "../projects.js";
+import { dispatchTask } from "../dispatch.js";
+import { DEV_LEVELS, QA_LEVELS, isDevLevel } from "../tiers.js";
+// ---------------------------------------------------------------------------
+// Shared constants + helpers (used by tick, work-start, auto-pickup)
+// ---------------------------------------------------------------------------
+export const DEV_LABELS = ["To Do", "To Improve"];
+export const QA_LABELS = ["To Test"];
+export const PRIORITY_ORDER = ["To Improve", "To Test", "To Do"];
+export function detectLevelFromLabels(labels) {
+    const lower = labels.map((l) => l.toLowerCase());
+    // Match role.level labels (e.g., "dev.senior", "qa.reviewer")
+    for (const l of lower) {
+        const dot = l.indexOf(".");
+        if (dot === -1)
+            continue;
+        const role = l.slice(0, dot);
+        const level = l.slice(dot + 1);
+        if (role === "dev" && DEV_LEVELS.includes(level))
+            return level;
+        if (role === "qa" && QA_LEVELS.includes(level))
+            return level;
+    }
+    // Fallback: plain level name
+    const all = [...DEV_LEVELS, ...QA_LEVELS];
+    return all.find((l) => lower.includes(l)) ?? null;
+}
+export function detectRoleFromLabel(label) {
+    if (DEV_LABELS.includes(label))
+        return "dev";
+    if (QA_LABELS.includes(label))
+        return "qa";
+    return null;
+}
+export async function findNextIssueForRole(provider, role) {
+    const labels = role === "dev"
+        ? PRIORITY_ORDER.filter((l) => DEV_LABELS.includes(l))
+        : PRIORITY_ORDER.filter((l) => QA_LABELS.includes(l));
+    for (const label of labels) {
+        try {
+            const issues = await provider.listIssuesByLabel(label);
+            if (issues.length > 0)
+                return { issue: issues[issues.length - 1], label };
+        }
+        catch { /* continue */ }
+    }
+    return null;
+}
+/**
+ * Find next issue for any role (optional filter). Used by work_start for auto-detection.
+ */
+export async function findNextIssue(provider, role) {
+    const labels = role === "dev" ? PRIORITY_ORDER.filter((l) => DEV_LABELS.includes(l))
+        : role === "qa" ? PRIORITY_ORDER.filter((l) => QA_LABELS.includes(l))
+            : PRIORITY_ORDER;
+    for (const label of labels) {
+        try {
+            const issues = await provider.listIssuesByLabel(label);
+            if (issues.length > 0)
+                return { issue: issues[issues.length - 1], label };
+        }
+        catch { /* continue */ }
+    }
+    return null;
+}
+/**
+ * Scan one project's queue and fill free worker slots.
+ *
+ * Does NOT run health checks (that's the heartbeat service's job).
+ * Non-destructive: only dispatches if slots are free and issues are queued.
+ */
+export async function projectTick(opts) {
+    const { workspaceDir, groupId, agentId, sessionKey, pluginConfig, dryRun, maxPickups, targetRole } = opts;
+    const project = (await readProjects(workspaceDir)).projects[groupId];
+    if (!project)
+        return { pickups: [], skipped: [{ reason: `Project not found: ${groupId}` }] };
+    const provider = opts.provider ?? createProvider({ repo: project.repo }).provider;
+    const roleExecution = project.roleExecution ?? "parallel";
+    const roles = targetRole ? [targetRole] : ["dev", "qa"];
+    const pickups = [];
+    const skipped = [];
+    let pickupCount = 0;
+    for (const role of roles) {
+        if (maxPickups !== undefined && pickupCount >= maxPickups) {
+            skipped.push({ role, reason: "Max pickups reached" });
+            continue;
+        }
+        // Re-read fresh state (previous dispatch may have changed it)
+        const fresh = (await readProjects(workspaceDir)).projects[groupId];
+        if (!fresh)
+            break;
+        const worker = getWorker(fresh, role);
+        if (worker.active) {
+            skipped.push({ role, reason: `Already active (#${worker.issueId})` });
+            continue;
+        }
+        if (roleExecution === "sequential" && getWorker(fresh, role === "dev" ? "qa" : "dev").active) {
+            skipped.push({ role, reason: "Sequential: other role active" });
+            continue;
+        }
+        const next = await findNextIssueForRole(provider, role);
+        if (!next)
+            continue;
+        const { issue, label: currentLabel } = next;
+        const targetLabel = role === "dev" ? "Doing" : "Testing";
+        // Level selection: label → heuristic
+        const selectedLevel = resolveLevelForIssue(issue, role);
+        if (dryRun) {
+            pickups.push({
+                project: project.name, groupId, issueId: issue.iid, issueTitle: issue.title, issueUrl: issue.web_url,
+                role, level: selectedLevel,
+                sessionAction: getSessionForLevel(worker, selectedLevel) ? "send" : "spawn",
+                announcement: `[DRY RUN] Would pick up #${issue.iid}`,
+            });
+        }
+        else {
+            try {
+                const dr = await dispatchTask({
+                    workspaceDir, agentId, groupId, project: fresh, issueId: issue.iid,
+                    issueTitle: issue.title, issueDescription: issue.description ?? "", issueUrl: issue.web_url,
+                    role, level: selectedLevel, fromLabel: currentLabel, toLabel: targetLabel,
+                    transitionLabel: (id, from, to) => provider.transitionLabel(id, from, to),
+                    pluginConfig, sessionKey,
+                });
+                pickups.push({
+                    project: project.name, groupId, issueId: issue.iid, issueTitle: issue.title, issueUrl: issue.web_url,
+                    role, level: dr.level, sessionAction: dr.sessionAction, announcement: dr.announcement,
+                });
+            }
+            catch (err) {
+                skipped.push({ role, reason: `Dispatch failed: ${err.message}` });
+                continue;
+            }
+        }
+        pickupCount++;
+    }
+    return { pickups, skipped };
+}
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+/**
+ * Determine the level for an issue based on labels, role overrides, and heuristic fallback.
+ */
+function resolveLevelForIssue(issue, role) {
+    const labelLevel = detectLevelFromLabels(issue.labels);
+    if (labelLevel) {
+        // QA role but label specifies a dev level → heuristic picks the right QA level
+        if (role === "qa" && isDevLevel(labelLevel))
+            return selectLevel(issue.title, issue.description ?? "", role).level;
+        // DEV role but label specifies a QA level → heuristic picks the right dev level
+        if (role === "dev" && !isDevLevel(labelLevel))
+            return selectLevel(issue.title, issue.description ?? "", role).level;
+        return labelLevel;
+    }
+    return selectLevel(issue.title, issue.description ?? "", role).level;
+}
+//# sourceMappingURL=tick.js.map

package/dist/lib/services/tick.js.map

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