@exaudeus/workrail 3.42.0 → 3.44.0

package/dist/daemon/workflow-runner.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DAEMON_SIGNALS_DIR = exports.DAEMON_SOUL_TEMPLATE = exports.DAEMON_SOUL_DEFAULT = exports.DAEMON_SESSIONS_DIR = void 0;
+exports.DAEMON_SIGNALS_DIR = exports.DAEMON_SOUL_TEMPLATE = exports.DAEMON_SOUL_DEFAULT = exports.WORKTREES_DIR = exports.DAEMON_SESSIONS_DIR = void 0;
 exports.readDaemonSessionState = readDaemonSessionState;
 exports.readAllDaemonSessions = readAllDaemonSessions;
 exports.runStartupRecovery = runStartupRecovery;
@@ -83,7 +83,9 @@ function withWorkrailSession(sid) {
 }
 exports.DAEMON_SESSIONS_DIR = path.join(os.homedir(), '.workrail', 'daemon-sessions');
 const MAX_ORPHAN_AGE_MS = 2 * 60 * 60 * 1000;
+const MAX_WORKTREE_ORPHAN_AGE_MS = 24 * 60 * 60 * 1000;
 const WORKRAIL_DIR = path.join(os.homedir(), '.workrail');
+exports.WORKTREES_DIR = path.join(os.homedir(), '.workrail', 'worktrees');
 const WORKSPACE_CONTEXT_MAX_BYTES = 32 * 1024;
 const MAX_ASSEMBLED_CONTEXT_BYTES = 8192;
 const WORKSPACE_CONTEXT_CANDIDATE_PATHS = [
@@ -96,10 +98,10 @@ const soul_template_js_1 = require("./soul-template.js");
 var soul_template_js_2 = require("./soul-template.js");
 Object.defineProperty(exports, "DAEMON_SOUL_DEFAULT", { enumerable: true, get: function () { return soul_template_js_2.DAEMON_SOUL_DEFAULT; } });
 Object.defineProperty(exports, "DAEMON_SOUL_TEMPLATE", { enumerable: true, get: function () { return soul_template_js_2.DAEMON_SOUL_TEMPLATE; } });
-async function persistTokens(sessionId, continueToken, checkpointToken) {
+async function persistTokens(sessionId, continueToken, checkpointToken, worktreePath) {
     await fs.mkdir(exports.DAEMON_SESSIONS_DIR, { recursive: true });
     const sessionPath = path.join(exports.DAEMON_SESSIONS_DIR, `${sessionId}.json`);
-    const state = JSON.stringify({ continueToken, checkpointToken, ts: Date.now() }, null, 2);
+    const state = JSON.stringify({ continueToken, checkpointToken, ts: Date.now(), ...(worktreePath !== undefined ? { worktreePath } : {}) }, null, 2);
     const tmp = `${sessionPath}.tmp`;
     await fs.writeFile(tmp, state, 'utf8');
     await fs.rename(tmp, sessionPath);
@@ -145,6 +147,7 @@ async function readAllDaemonSessions(sessionsDir = exports.DAEMON_SESSIONS_DIR)
                 continueToken: parsed.continueToken,
                 checkpointToken: typeof parsed.checkpointToken === 'string' ? parsed.checkpointToken : null,
                 ts: parsed.ts,
+                ...(typeof parsed.worktreePath === 'string' ? { worktreePath: parsed.worktreePath } : {}),
             });
         }
         catch (err) {
@@ -153,7 +156,7 @@ async function readAllDaemonSessions(sessionsDir = exports.DAEMON_SESSIONS_DIR)
     }
     return sessions;
 }
-async function runStartupRecovery(sessionsDir = exports.DAEMON_SESSIONS_DIR) {
+async function runStartupRecovery(sessionsDir = exports.DAEMON_SESSIONS_DIR, execFn = execFileAsync) {
     const sessions = await readAllDaemonSessions(sessionsDir);
     if (sessions.length === 0) {
         await clearStrayTmpFiles(sessionsDir);
@@ -168,6 +171,22 @@ async function runStartupRecovery(sessionsDir = exports.DAEMON_SESSIONS_DIR) {
         const ageSec = Math.round(ageMs / 1000);
         const label = isStale ? 'stale orphaned session' : 'orphaned session';
         console.log(`[WorkflowRunner] Clearing ${label}: sessionId=${session.sessionId} age=${ageSec}s`);
+        if (session.worktreePath && ageMs > MAX_WORKTREE_ORPHAN_AGE_MS) {
+            console.log(`[WorkflowRunner] Removing orphan worktree: sessionId=${session.sessionId} worktreePath=${session.worktreePath}`);
+            try {
+                await execFn('git', ['worktree', 'remove', '--force', session.worktreePath]);
+                console.log(`[WorkflowRunner] Removed orphan worktree: ${session.worktreePath}`);
+            }
+            catch (err) {
+                console.warn(`[WorkflowRunner] Could not remove orphan worktree ${session.worktreePath}: ` +
+                    `${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        else if (session.worktreePath && ageMs <= MAX_WORKTREE_ORPHAN_AGE_MS) {
+            const ageHours = (ageMs / (60 * 60 * 1000)).toFixed(1);
+            console.log(`[WorkflowRunner] Keeping recent orphan worktree: sessionId=${session.sessionId} ` +
+                `age=${ageHours}h (threshold=24h) worktreePath=${session.worktreePath}`);
+        }
         try {
             await fs.unlink(path.join(sessionsDir, `${session.sessionId}.json`));
             cleared++;
@@ -1430,12 +1449,66 @@ async function runWorkflow(trigger, ctx, apiKey, daemonRegistry, emitter, steerR
     if (startContinueToken) {
         await persistTokens(sessionId, startContinueToken, startCheckpointToken);
     }
+    if (trigger.botIdentity) {
+        try {
+            await execFileAsync('git', ['-C', trigger.workspacePath, 'config', 'user.name', trigger.botIdentity.name]);
+            await execFileAsync('git', ['-C', trigger.workspacePath, 'config', 'user.email', trigger.botIdentity.email]);
+            console.log(`[WorkflowRunner] Bot identity set: sessionId=${sessionId} ` +
+                `name=${trigger.botIdentity.name} email=${trigger.botIdentity.email}`);
+        }
+        catch (identityErr) {
+            console.warn(`[WorkflowRunner] WARNING: Failed to set bot identity for sessionId=${sessionId}: ` +
+                `${identityErr instanceof Error ? identityErr.message : String(identityErr)}. ` +
+                `Commits will use default git config.`);
+        }
+    }
+    let sessionWorkspacePath = trigger.workspacePath;
+    let sessionWorktreePath;
+    if (trigger.branchStrategy === 'worktree') {
+        const branchPrefix = trigger.branchPrefix ?? 'worktrain/';
+        const baseBranch = trigger.baseBranch ?? 'main';
+        sessionWorkspacePath = path.join(exports.WORKTREES_DIR, sessionId);
+        sessionWorktreePath = sessionWorkspacePath;
+        try {
+            await fs.mkdir(exports.WORKTREES_DIR, { recursive: true });
+            await execFileAsync('git', ['-C', trigger.workspacePath, 'fetch', 'origin', baseBranch]);
+            await execFileAsync('git', [
+                '-C', trigger.workspacePath,
+                'worktree', 'add',
+                sessionWorkspacePath,
+                '-b', `${branchPrefix}${sessionId}`,
+                `origin/${baseBranch}`,
+            ]);
+            await persistTokens(sessionId, startContinueToken ?? currentContinueToken, startCheckpointToken, sessionWorktreePath);
+            console.log(`[WorkflowRunner] Worktree created: sessionId=${sessionId} ` +
+                `branch=${branchPrefix}${sessionId} path=${sessionWorkspacePath}`);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            console.error(`[WorkflowRunner] Worktree creation failed: sessionId=${sessionId} error=${errMsg}`);
+            emitter?.emit({ kind: 'session_completed', sessionId, workflowId: trigger.workflowId, outcome: 'error', detail: errMsg.slice(0, 200), ...withWorkrailSession(workrailSessionId) });
+            if (workrailSessionId !== null)
+                daemonRegistry?.unregister(workrailSessionId, 'failed');
+            return {
+                _tag: 'error',
+                workflowId: trigger.workflowId,
+                message: `Worktree creation failed: ${errMsg}`,
+                stopReason: 'error',
+            };
+        }
+    }
     if (firstStep.isComplete) {
         await fs.unlink(path.join(exports.DAEMON_SESSIONS_DIR, `${sessionId}.json`)).catch(() => { });
         emitter?.emit({ kind: 'session_completed', sessionId, workflowId: trigger.workflowId, outcome: 'success', detail: 'stop', ...withWorkrailSession(workrailSessionId) });
         if (workrailSessionId !== null)
             daemonRegistry?.unregister(workrailSessionId, 'completed');
-        return { _tag: 'success', workflowId: trigger.workflowId, stopReason: 'stop' };
+        return {
+            _tag: 'success',
+            workflowId: trigger.workflowId,
+            stopReason: 'stop',
+            ...(sessionWorktreePath !== undefined ? { sessionWorkspacePath: sessionWorktreePath } : {}),
+            ...(sessionWorktreePath !== undefined ? { sessionId } : {}),
+        };
     }
     const schemas = getSchemas();
     const spawnCurrentDepth = trigger.spawnDepth ?? 0;
@@ -1444,12 +1517,12 @@ async function runWorkflow(trigger, ctx, apiKey, daemonRegistry, emitter, steerR
     const tools = [
         makeCompleteStepTool(sessionId, ctx, () => currentContinueToken, onAdvance, onComplete, (t) => { currentContinueToken = t; }, schemas, index_js_1.executeContinueWorkflow, emitter, workrailSessionId),
         makeContinueWorkflowTool(sessionId, ctx, onAdvance, onComplete, schemas, index_js_1.executeContinueWorkflow, emitter, workrailSessionId),
-        makeBashTool(trigger.workspacePath, schemas, sessionId, emitter, workrailSessionId),
+        makeBashTool(sessionWorkspacePath, schemas, sessionId, emitter, workrailSessionId),
         makeReadTool(readFileState, schemas, sessionId, emitter, workrailSessionId),
         makeWriteTool(readFileState, schemas, sessionId, emitter, workrailSessionId),
-        makeGlobTool(trigger.workspacePath, schemas, sessionId, emitter, workrailSessionId),
-        makeGrepTool(trigger.workspacePath, schemas, sessionId, emitter, workrailSessionId),
-        makeEditTool(trigger.workspacePath, readFileState, schemas, sessionId, emitter, workrailSessionId),
+        makeGlobTool(sessionWorkspacePath, schemas, sessionId, emitter, workrailSessionId),
+        makeGrepTool(sessionWorkspacePath, schemas, sessionId, emitter, workrailSessionId),
+        makeEditTool(sessionWorkspacePath, readFileState, schemas, sessionId, emitter, workrailSessionId),
         makeReportIssueTool(sessionId, emitter, workrailSessionId, undefined, (summary) => {
             if (issueSummaries.length < MAX_ISSUE_SUMMARIES) {
                 issueSummaries.push(summary);
@@ -1627,6 +1700,7 @@ async function runWorkflow(trigger, ctx, apiKey, daemonRegistry, emitter, steerR
         const limitDescription = timeoutReason === 'wall_clock'
             ? `${trigger.agentConfig?.maxSessionMinutes ?? DEFAULT_SESSION_TIMEOUT_MINUTES} minutes`
             : `${trigger.agentConfig?.maxTurns ?? DEFAULT_MAX_TURNS} turns`;
+        await fs.unlink(path.join(exports.DAEMON_SESSIONS_DIR, `${sessionId}.json`)).catch(() => { });
         return {
             _tag: 'timeout',
             workflowId: trigger.workflowId,
@@ -1651,6 +1725,7 @@ async function runWorkflow(trigger, ctx, apiKey, daemonRegistry, emitter, steerR
             ...(lastToolCalled !== null && { lastToolCalled }),
             ...(issueSummaries.length > 0 && { issueSummaries }),
         })}`;
+        await fs.unlink(path.join(exports.DAEMON_SESSIONS_DIR, `${sessionId}.json`)).catch(() => { });
         return {
             _tag: 'error',
             workflowId: trigger.workflowId,
@@ -1670,5 +1745,7 @@ async function runWorkflow(trigger, ctx, apiKey, daemonRegistry, emitter, steerR
         stopReason,
         ...(lastStepNotes !== undefined ? { lastStepNotes } : {}),
         ...(lastStepArtifacts !== undefined ? { lastStepArtifacts } : {}),
+        ...(sessionWorktreePath !== undefined ? { sessionWorkspacePath: sessionWorktreePath } : {}),
+        ...(sessionWorktreePath !== undefined ? { sessionId } : {}),
     };
 }

package/dist/manifest.json

@@ -449,16 +449,16 @@
       "sha256": "5fe866e54f796975dec5d8ba9983aefd86074db212d3fccd64eed04bc9f0b3da",
       "bytes": 8011
     },
+    "console-ui/assets/index-Bi38ITiQ.js": {
+      "sha256": "e3229116ac20f315184c69ef9eaa33267457e5e7aac1e22015ed830cb098e39a",
+      "bytes": 760528
+    },
     "console-ui/assets/index-DGj8EsFR.css": {
       "sha256": "3bdb55ec0957928e0ebbb86a7d6b36d28f7ba7d5c0f3e236fd8f2e2aacee2fa4",
       "bytes": 60631
     },
-    "console-ui/assets/index-DwfWMKvv.js": {
-      "sha256": "14a935b1b1ed6b4d2a178a1f21bd657c5f9bcede837ac06b35fbb713114e99d0",
-      "bytes": 760528
-    },
     "console-ui/index.html": {
-      "sha256": "d0fec3b4d1f1156b9f4df60f7e5fe72af7f12fa8a29c90a331f0706dda67b908",
+      "sha256": "fb9efa806376b8f8f18d3c5d7853d04b9dfc9abc305b0ed22782379bc13a2c86",
       "bytes": 417
     },
     "console/standalone-console.d.ts": {
@@ -550,12 +550,12 @@
       "bytes": 1512
     },
     "daemon/workflow-runner.d.ts": {
-      "sha256": "7025b0023c763c6899511c5d3635e9ab99bdc361616249aa25b36508753bf3a0",
-      "bytes": 6154
+      "sha256": "0406654be8c6eb147706e81e0ba666ce372db140f4720246258e0f001653181e",
+      "bytes": 6628
     },
     "daemon/workflow-runner.js": {
-      "sha256": "94fad3401dca1d854c3d254ac8b6e7ab5ae9a942c47e9c5900383a4e017c820e",
-      "bytes": 84923
+      "sha256": "f40f265284aa1e32168d8a0cf28c08007186eafac6d55182b7ec6ddb53bed5a8",
+      "bytes": 89592
     },
     "di/container.d.ts": {
       "sha256": "003bb7fb7478d627524b9b1e76bd0a963a243794a687ff233b96dc0e33a06d9f",
@@ -1549,6 +1549,14 @@
       "sha256": "dd1a1bc20f1bf6da550960887c75fab4a794c19a1b79f3c89f4277145d009c2e",
       "bytes": 6723
     },
+    "trigger/adapters/github-queue-poller.d.ts": {
+      "sha256": "f36b01b118e6986e8f89701fc5d88fa7a1873fb38acaa67b1612895056bd5ef8",
+      "bytes": 1363
+    },
+    "trigger/adapters/github-queue-poller.js": {
+      "sha256": "73270636634fb8673c63b0c0347e6e5d7f676606d36b87a4c1aadc11f1939eb2",
+      "bytes": 7340
+    },
     "trigger/adapters/gitlab-poller.d.ts": {
       "sha256": "f685490fafad77194fdd0f0bbaf80dbc56730aeb344853da365199a120fbe399",
       "bytes": 911
@@ -1566,12 +1574,12 @@
       "bytes": 5471
     },
     "trigger/delivery-action.d.ts": {
-      "sha256": "58109eaa7124d2864e1d872ff0148548932d2fa4d7e672f5fd83d4bbe40afdda",
-      "bytes": 1188
+      "sha256": "2b3f165759b0de49b7f49023a05efa50848331ab6cd9969b49c1409346959994",
+      "bytes": 1257
     },
     "trigger/delivery-action.js": {
-      "sha256": "453931945078ee15656f7a89f9e804d1db8edcc14b756beeb9cfadfcb9e83102",
-      "bytes": 8026
+      "sha256": "1a9c0d097dc0f14e66765366f878f5f8386a4a1b0c5eb9572fa90a2b60643bab",
+      "bytes": 9016
     },
     "trigger/delivery-client.d.ts": {
       "sha256": "0cb2be24b854cb31e3d2fe7eeaba6032de7a9b2a5290c8bc886df94faf5306f7",
@@ -1581,6 +1589,14 @@
       "sha256": "da358ced4e99c327493b6d3ca975a623aca21f72e68787a092b2760601801c99",
       "bytes": 1269
     },
+    "trigger/github-queue-config.d.ts": {
+      "sha256": "bff922c1b435da55e02b4b11d3fde9f06e999f13b8ac0494788cac4a4fc4c432",
+      "bytes": 766
+    },
+    "trigger/github-queue-config.js": {
+      "sha256": "a0ec09a7725ac1ee1adb9d41fdcb4c9545128f0b9515c6de4df9535d4bec1acc",
+      "bytes": 6857
+    },
     "trigger/index.d.ts": {
       "sha256": "a9cfd053714173e2a8cc5a282fd5b09a5c3f3001304d507facd0e12de9cc0733",
       "bytes": 735
@@ -1606,12 +1622,12 @@
       "bytes": 6968
     },
     "trigger/polling-scheduler.d.ts": {
-      "sha256": "c5f984df836dbc78ec51bfc78fa5a26973aff56e6f88e0cf11776057f940b2b6",
-      "bytes": 761
+      "sha256": "009b3340f5d46a3fc22b9cd087abcf484abe34c526a46dd4f958768fb8f61c9c",
+      "bytes": 792
     },
     "trigger/polling-scheduler.js": {
-      "sha256": "e77a5eb32a54d98e9f7178fc15d7c237809519c183eea716cd01b7b9a2aae62e",
-      "bytes": 10255
+      "sha256": "ec3c73739c9dfbbe3b2d7a55237fd35a290d6aab7bbc30ec5408bde69b2c95e0",
+      "bytes": 19769
     },
     "trigger/trigger-listener.d.ts": {
       "sha256": "92e971ab8f47c3c867860cffc01f54c4aae54fcc4ae199b9469210f4ce639423",
@@ -1626,20 +1642,20 @@
       "bytes": 2123
     },
     "trigger/trigger-router.js": {
-      "sha256": "6584949ecc6bd8fe5d23bfe5b3b7feb3a488804987b2edd90733d2c0142aeec2",
-      "bytes": 15973
+      "sha256": "605cdce397bd19e5b991fe7378faf17b4f25b4421749e1b5349413a208a4f3dd",
+      "bytes": 17250
     },
     "trigger/trigger-store.d.ts": {
       "sha256": "7afb05127d55bc3757a550dd15d4b797766b3fff29d1bfe76b303764b93322e7",
       "bytes": 1588
     },
     "trigger/trigger-store.js": {
-      "sha256": "4e03bf0bea132c67087d69e07f3d9abddb504396438437705c26c9e7870b0680",
-      "bytes": 34667
+      "sha256": "8015b54da7ab5b1cec78e1ecea099d5b457eaa5de267bb1ed52cbb75eca207c4",
+      "bytes": 38148
     },
     "trigger/types.d.ts": {
-      "sha256": "c0f14b59c95cae52e06f8d9fe841292886587fad20497fd6686e842cc5696d3a",
-      "bytes": 2808
+      "sha256": "4ccedde5b927f17edbb96203083e8ffd2d578e2cc007ff2427511112ae262e30",
+      "bytes": 3475
     },
     "trigger/types.js": {
       "sha256": "45b4e4f23a6d1a2b07350196871b0c53840e5d8142b47f7acedd2f40ae7a6b73",

package/dist/trigger/adapters/github-queue-poller.d.ts

@@ -0,0 +1,34 @@
+import type { GitHubQueuePollingSource } from '../types.js';
+import type { GitHubQueueConfig } from '../github-queue-config.js';
+import type { Result } from '../../runtime/result.js';
+export interface GitHubQueueLabel {
+    readonly name: string;
+}
+export interface GitHubQueueIssue {
+    readonly id: number;
+    readonly number: number;
+    readonly title: string;
+    readonly body: string;
+    readonly url: string;
+    readonly labels: readonly GitHubQueueLabel[];
+    readonly createdAt: string;
+}
+export type GitHubQueuePollError = {
+    readonly kind: 'http_error';
+    readonly status: number;
+    readonly message: string;
+} | {
+    readonly kind: 'network_error';
+    readonly message: string;
+} | {
+    readonly kind: 'parse_error';
+    readonly message: string;
+} | {
+    readonly kind: 'not_implemented';
+    readonly message: string;
+};
+export type FetchFn = (url: string, init: RequestInit) => Promise<Response>;
+export declare const DEFAULT_SESSIONS_DIR: string;
+export declare function pollGitHubQueueIssues(source: GitHubQueuePollingSource, config: GitHubQueueConfig, fetchFn?: FetchFn): Promise<Result<GitHubQueueIssue[], GitHubQueuePollError>>;
+export declare function inferMaturity(body: string): 'idea' | 'specced' | 'ready';
+export declare function checkIdempotency(issueNumber: number, sessionsDir?: string): Promise<'clear' | 'active'>;

package/dist/trigger/adapters/github-queue-poller.js

@@ -0,0 +1,200 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SESSIONS_DIR = void 0;
+exports.pollGitHubQueueIssues = pollGitHubQueueIssues;
+exports.inferMaturity = inferMaturity;
+exports.checkIdempotency = checkIdempotency;
+const result_js_1 = require("../../runtime/result.js");
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+exports.DEFAULT_SESSIONS_DIR = path.join(os.homedir(), '.workrail', 'daemon-sessions');
+function checkRateLimit(response) {
+    const remainingHeader = response.headers.get('X-RateLimit-Remaining');
+    const resetHeader = response.headers.get('X-RateLimit-Reset');
+    if (remainingHeader === null)
+        return true;
+    const remaining = parseInt(remainingHeader, 10);
+    if (isNaN(remaining) || remaining >= 100)
+        return true;
+    const resetTs = parseInt(resetHeader ?? '0', 10);
+    const resetAt = resetTs > 0 ? new Date(resetTs * 1000).toISOString() : 'unknown';
+    console.warn(`[GitHubQueuePoller] Rate limit low: remaining=${remaining}, resets at ${resetAt}. ` +
+        `Skipping poll cycle to avoid exhaustion.`);
+    return false;
+}
+async function pollGitHubQueueIssues(source, config, fetchFn = globalThis.fetch) {
+    if (config.type !== 'assignee') {
+        return (0, result_js_1.err)({
+            kind: 'not_implemented',
+            message: `Queue type '${config.type}' is not implemented. Only 'assignee' is supported.`,
+        });
+    }
+    const [owner, repo] = source.repo.split('/');
+    const url = new URL(`https://api.github.com/repos/${owner}/${repo}/issues`);
+    url.searchParams.set('state', 'open');
+    url.searchParams.set('per_page', '100');
+    if (config.user) {
+        url.searchParams.set('assignee', config.user);
+    }
+    let response;
+    try {
+        response = await fetchFn(url.toString(), {
+            headers: {
+                'Authorization': `Bearer ${source.token}`,
+                'Accept': 'application/vnd.github+json',
+                'X-GitHub-Api-Version': '2022-11-28',
+            },
+        });
+    }
+    catch (e) {
+        return (0, result_js_1.err)({
+            kind: 'network_error',
+            message: e instanceof Error ? e.message : String(e),
+        });
+    }
+    if (!response.ok) {
+        return (0, result_js_1.err)({
+            kind: 'http_error',
+            status: response.status,
+            message: `GitHub API returned HTTP ${response.status}: ${response.statusText}`,
+        });
+    }
+    if (!checkRateLimit(response)) {
+        return (0, result_js_1.ok)([]);
+    }
+    let raw;
+    try {
+        raw = await response.json();
+    }
+    catch (e) {
+        return (0, result_js_1.err)({
+            kind: 'parse_error',
+            message: `Failed to parse GitHub Issues API response: ${e instanceof Error ? e.message : String(e)}`,
+        });
+    }
+    if (!Array.isArray(raw)) {
+        return (0, result_js_1.err)({
+            kind: 'parse_error',
+            message: `Expected array from GitHub Issues API, got: ${typeof raw}`,
+        });
+    }
+    const issues = [];
+    for (const item of raw) {
+        const shaped = toGitHubQueueIssue(item);
+        if (shaped !== null) {
+            issues.push(shaped);
+        }
+    }
+    return (0, result_js_1.ok)(issues);
+}
+function inferMaturity(body) {
+    const specLineMatch = /upstream_spec:\s*(https?:\/\/\S+)/i.exec(body);
+    if (specLineMatch)
+        return 'ready';
+    const firstPara = body.split(/\n\s*\n/)[0] ?? '';
+    if (/https?:\/\/\S*\/(?:pitch|prd|spec|brd|rfc|design)\b/i.test(firstPara))
+        return 'ready';
+    if (/- \[ \]/.test(body))
+        return 'specced';
+    if (/^#{1,6}\s*(Acceptance Criteria|Implementation Plan)\s*$/im.test(body))
+        return 'specced';
+    return 'idea';
+}
+async function checkIdempotency(issueNumber, sessionsDir = exports.DEFAULT_SESSIONS_DIR) {
+    let files;
+    try {
+        files = await fs.readdir(sessionsDir);
+    }
+    catch {
+        return 'clear';
+    }
+    const jsonFiles = files.filter(f => f.endsWith('.json'));
+    for (const filename of jsonFiles) {
+        try {
+            const content = await fs.readFile(path.join(sessionsDir, filename), 'utf8');
+            const parsed = JSON.parse(content);
+            if (typeof parsed !== 'object' || parsed === null) {
+                return 'active';
+            }
+            const session = parsed;
+            const context = session['context'];
+            if (typeof context !== 'object' || context === null) {
+                continue;
+            }
+            const ctx = context;
+            const taskCandidate = ctx['taskCandidate'];
+            if (typeof taskCandidate !== 'object' || taskCandidate === null) {
+                continue;
+            }
+            const tc = taskCandidate;
+            if (tc['issueNumber'] === issueNumber) {
+                return 'active';
+            }
+        }
+        catch {
+            return 'active';
+        }
+    }
+    return 'clear';
+}
+function toGitHubQueueIssue(item) {
+    if (typeof item !== 'object' || item === null)
+        return null;
+    const obj = item;
+    if (typeof obj['id'] !== 'number' ||
+        typeof obj['number'] !== 'number' ||
+        typeof obj['title'] !== 'string' ||
+        typeof obj['html_url'] !== 'string') {
+        return null;
+    }
+    const body = typeof obj['body'] === 'string' ? obj['body'] : '';
+    const createdAt = typeof obj['created_at'] === 'string' ? obj['created_at'] : '';
+    const rawLabels = Array.isArray(obj['labels']) ? obj['labels'] : [];
+    const labels = rawLabels
+        .filter((l) => typeof l === 'object' && l !== null)
+        .filter((l) => typeof l['name'] === 'string')
+        .map((l) => ({ name: l['name'] }));
+    return {
+        id: obj['id'],
+        number: obj['number'],
+        title: obj['title'],
+        body,
+        url: obj['html_url'],
+        labels,
+        createdAt,
+    };
+}

package/dist/trigger/delivery-action.d.ts

@@ -11,6 +11,8 @@ export interface HandoffArtifact {
 export interface DeliveryFlags {
     readonly autoCommit?: boolean;
     readonly autoOpenPR?: boolean;
+    readonly sessionId?: string;
+    readonly branchPrefix?: string;
 }
 export type DeliveryResult = {
     readonly _tag: 'committed';

package/dist/trigger/delivery-action.js

@@ -146,6 +146,30 @@ async function runDelivery(artifact, workspacePath, flags, execFn) {
             reason: 'filesChanged is empty -- cannot stage files safely (no git add -A fallback)',
         };
     }
+    if (flags.sessionId) {
+        const expectedBranch = `${flags.branchPrefix ?? 'worktrain/'}${flags.sessionId}`;
+        let headBranch;
+        try {
+            const result = await execFn('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: workspacePath, timeout: DELIVERY_TIMEOUT_MS });
+            headBranch = result.stdout.trim();
+        }
+        catch (e) {
+            return {
+                _tag: 'error',
+                phase: 'commit',
+                details: `HEAD branch check failed (cannot stage): ${formatExecError(e)}`,
+            };
+        }
+        if (headBranch !== expectedBranch) {
+            return {
+                _tag: 'error',
+                phase: 'commit',
+                details: `HEAD branch mismatch: expected "${expectedBranch}" but found "${headBranch}". ` +
+                    `Refusing to stage or push -- the agent may have switched branches. ` +
+                    `Worktree path: ${workspacePath}`,
+            };
+        }
+    }
     const commitMessage = artifact.commitSubject.startsWith(`${artifact.commitType}(`)
         ? artifact.commitSubject
         : `${artifact.commitType}(${artifact.commitScope}): ${artifact.commitSubject}`;

package/dist/trigger/github-queue-config.d.ts

@@ -0,0 +1,18 @@
+import type { Result } from '../runtime/result.js';
+export interface GitHubQueueConfig {
+    readonly type: 'assignee' | 'label' | 'mention' | 'query';
+    readonly user?: string;
+    readonly name?: string;
+    readonly handle?: string;
+    readonly search?: string;
+    readonly workOnAll?: boolean;
+    readonly pollIntervalSeconds: number;
+    readonly maxTotalConcurrentSessions: number;
+    readonly excludeLabels: readonly string[];
+    readonly repo: string;
+    readonly token: string;
+    readonly botName?: string;
+    readonly botEmail?: string;
+}
+export declare const WORKRAIL_CONFIG_PATH: string;
+export declare function loadQueueConfig(configPath?: string, env?: Record<string, string | undefined>): Promise<Result<GitHubQueueConfig | null, string>>;