npm - @exaudeus/workrail - Versions diffs - 3.40.0 → 3.42.0 - Mend

@exaudeus/workrail 3.40.0 → 3.42.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (105) hide show

package/dist/cli/commands/init.js +0 -3
package/dist/cli-worktrain.js +48 -11
package/dist/cli.js +0 -18
package/dist/config/app-config.d.ts +0 -16
package/dist/config/app-config.js +0 -14
package/dist/config/config-file.js +0 -3
package/dist/console-ui/assets/index-DGj8EsFR.css +1 -0
package/dist/console-ui/assets/index-DwfWMKvv.js +28 -0
package/dist/console-ui/index.html +2 -2
package/dist/context-assembly/deps.d.ts +8 -0
package/dist/context-assembly/deps.js +2 -0
package/dist/context-assembly/index.d.ts +6 -0
package/dist/context-assembly/index.js +50 -0
package/dist/context-assembly/infra.d.ts +3 -0
package/dist/context-assembly/infra.js +154 -0
package/dist/context-assembly/types.d.ts +30 -0
package/dist/context-assembly/types.js +2 -0
package/dist/coordinators/pr-review.d.ts +20 -1
package/dist/coordinators/pr-review.js +189 -4
package/dist/daemon/daemon-events.d.ts +9 -1
package/dist/daemon/soul-template.d.ts +2 -2
package/dist/daemon/soul-template.js +11 -1
package/dist/daemon/workflow-runner.d.ts +14 -1
package/dist/daemon/workflow-runner.js +406 -25
package/dist/di/container.js +1 -25
package/dist/di/tokens.d.ts +0 -3
package/dist/di/tokens.js +0 -3
package/dist/domain/execution/state.d.ts +6 -6
package/dist/engine/engine-factory.js +0 -1
package/dist/infrastructure/console-defaults.d.ts +1 -0
package/dist/infrastructure/console-defaults.js +4 -0
package/dist/infrastructure/session/index.d.ts +0 -1
package/dist/infrastructure/session/index.js +1 -3
package/dist/manifest.json +138 -122
package/dist/mcp/handlers/session.d.ts +1 -0
package/dist/mcp/handlers/session.js +61 -13
package/dist/mcp/handlers/v2-workflow.d.ts +2 -2
package/dist/mcp/output-schemas.d.ts +234 -234
package/dist/mcp/server.js +1 -18
package/dist/mcp/tools.d.ts +2 -2
package/dist/mcp/transports/http-entry.js +0 -2
package/dist/mcp/transports/stdio-entry.js +1 -2
package/dist/mcp/types.d.ts +0 -2
package/dist/mcp/v2/tools.d.ts +24 -24
package/dist/trigger/daemon-console.d.ts +2 -0
package/dist/trigger/daemon-console.js +1 -1
package/dist/trigger/trigger-listener.d.ts +2 -0
package/dist/trigger/trigger-listener.js +3 -1
package/dist/trigger/trigger-router.d.ts +4 -3
package/dist/trigger/trigger-router.js +4 -3
package/dist/trigger/trigger-store.js +17 -4
package/dist/v2/durable-core/schemas/artifacts/assessment.d.ts +2 -2
package/dist/v2/durable-core/schemas/artifacts/coordinator-signal.d.ts +2 -2
package/dist/v2/durable-core/schemas/artifacts/loop-control.d.ts +6 -6
package/dist/v2/durable-core/schemas/artifacts/review-verdict.d.ts +6 -6
package/dist/v2/durable-core/schemas/compiled-workflow/index.d.ts +56 -56
package/dist/v2/durable-core/schemas/execution-snapshot/blocked-snapshot.d.ts +83 -83
package/dist/v2/durable-core/schemas/execution-snapshot/execution-snapshot.v1.d.ts +1024 -1024
package/dist/v2/durable-core/schemas/export-bundle/index.d.ts +2336 -2336
package/dist/v2/durable-core/schemas/session/dag-topology.d.ts +6 -6
package/dist/v2/durable-core/schemas/session/events.d.ts +339 -339
package/dist/v2/durable-core/schemas/session/gaps.d.ts +30 -30
package/dist/v2/durable-core/schemas/session/manifest.d.ts +6 -6
package/dist/v2/durable-core/schemas/session/outputs.d.ts +8 -8
package/dist/v2/durable-core/schemas/session/validation-event.d.ts +3 -3
package/dist/v2/usecases/console-routes.d.ts +2 -1
package/dist/v2/usecases/console-routes.js +29 -5
package/dist/v2/usecases/console-service.js +14 -0
package/dist/v2/usecases/console-types.d.ts +1 -0
package/docs/authoring.md +16 -16
package/docs/design/context-assembly-design-candidates.md +199 -0
package/docs/design/context-assembly-implementation-plan.md +211 -0
package/docs/design/context-assembly-review-findings.md +112 -0
package/docs/design/coordinator-message-queue-drain-plan.md +241 -0
package/docs/design/coordinator-message-queue-drain-review.md +120 -0
package/docs/design/coordinator-message-queue-drain.md +289 -0
package/docs/design/shaping-workflow-external-research.md +119 -0
package/docs/discovery/late-bound-goals-impl-plan.md +147 -0
package/docs/discovery/late-bound-goals-review.md +82 -0
package/docs/discovery/late-bound-goals.md +118 -0
package/docs/discovery/steer-endpoint-design-candidates.md +288 -0
package/docs/discovery/steer-endpoint-design-review-findings.md +104 -0
package/docs/discovery/steer-endpoint-implementation-plan.md +284 -0
package/docs/ideas/backlog.md +356 -0
package/docs/ideas/design-candidates-console-session-tree-impl.md +64 -0
package/docs/ideas/design-candidates-session-tree-view.md +196 -0
package/docs/ideas/design-review-findings-console-session-tree-impl.md +75 -0
package/docs/ideas/design-review-findings-session-tree-view.md +88 -0
package/docs/ideas/implementation_plan_session_tree_view.md +238 -0
package/package.json +2 -1
package/spec/authoring-spec.json +16 -16
package/spec/shape.schema.json +178 -0
package/spec/workflow-tags.json +232 -47
package/workflows/coding-task-workflow-agentic.json +491 -480
package/workflows/wr.shaping.json +182 -0
package/dist/console-ui/assets/index-8dh0Psu-.css +0 -1
package/dist/console-ui/assets/index-CXWCAonr.js +0 -28
package/dist/infrastructure/session/DashboardHeartbeat.d.ts +0 -8
package/dist/infrastructure/session/DashboardHeartbeat.js +0 -39
package/dist/infrastructure/session/DashboardLockRelease.d.ts +0 -2
package/dist/infrastructure/session/DashboardLockRelease.js +0 -29
package/dist/infrastructure/session/HttpServer.d.ts +0 -60
package/dist/infrastructure/session/HttpServer.js +0 -912
package/workflows/coding-task-workflow-agentic.lean.v2.json +0 -648
package/workflows/coding-task-workflow-agentic.v2.json +0 -324

package/dist/console-ui/index.html CHANGED Viewed

@@ -4,8 +4,8 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>WorkRail Console</title>
-    <script type="module" crossorigin src="/console/assets/index-CXWCAonr.js"></script>
-    <link rel="stylesheet" crossorigin href="/console/assets/index-8dh0Psu-.css">
+    <script type="module" crossorigin src="/console/assets/index-DwfWMKvv.js"></script>
+    <link rel="stylesheet" crossorigin href="/console/assets/index-DGj8EsFR.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/context-assembly/deps.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import type { Result } from '../runtime/result.js';
+import type { SessionNote } from './types.js';
+export interface ContextAssemblerDeps {
+    readonly execGit: (args: readonly string[], cwd: string) => Promise<Result<string, string>>;
+    readonly execGh: (args: readonly string[], cwd: string) => Promise<Result<string, string>>;
+    readonly listRecentSessions: (workspacePath: string, limit: number) => Promise<Result<readonly SessionNote[], string>>;
+    readonly nowIso: () => string;
+}

package/dist/context-assembly/deps.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ "use strict";
2	+ Object.defineProperty(exports, "__esModule", { value: true });

package/dist/context-assembly/index.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+import type { ContextAssemblerDeps } from './deps.js';
+import type { ContextAssembler, ContextBundle, RenderOpts } from './types.js';
+export declare function createContextAssembler(deps: ContextAssemblerDeps): ContextAssembler;
+export declare function renderContextBundle(bundle: ContextBundle, _opts?: RenderOpts): string;
+export type { AssemblyTask, ContextBundle, ContextAssembler, SessionNote, RenderOpts } from './types.js';
+export type { ContextAssemblerDeps } from './deps.js';

package/dist/context-assembly/index.js ADDED Viewed

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContextAssembler = createContextAssembler;
+exports.renderContextBundle = renderContextBundle;
+function createContextAssembler(deps) {
+    return {
+        async assemble(task) {
+            const [gitDiff, priorSessionNotes] = await Promise.all([
+                assembleGitDiff(deps, task),
+                assemblePriorNotes(deps, task.workspacePath),
+            ]);
+            return {
+                task,
+                gitDiff,
+                priorSessionNotes,
+                assembledAt: deps.nowIso(),
+            };
+        },
+    };
+}
+async function assembleGitDiff(deps, task) {
+    if (task.kind === 'pr_review') {
+        const ghResult = await deps.execGh(['pr', 'diff', String(task.prNumber), '--name-only'], task.workspacePath);
+        if (ghResult.kind === 'ok' && ghResult.value.trim().length > 0) {
+            return { kind: 'ok', value: ghResult.value.trim() };
+        }
+    }
+    return deps.execGit(['diff', 'HEAD~1', '--stat'], task.workspacePath);
+}
+async function assemblePriorNotes(deps, workspacePath) {
+    const PRIOR_SESSION_LIMIT = 3;
+    return deps.listRecentSessions(workspacePath, PRIOR_SESSION_LIMIT);
+}
+function renderContextBundle(bundle, _opts) {
+    const parts = [];
+    if (bundle.priorSessionNotes.kind === 'ok' && bundle.priorSessionNotes.value.length > 0) {
+        parts.push('### Recent session notes for this workspace\n');
+        for (const note of bundle.priorSessionNotes.value) {
+            const title = note.sessionTitle ?? note.sessionId.slice(0, 12);
+            const branch = note.gitBranch ? ` (branch: ${note.gitBranch})` : '';
+            const recap = note.recapSnippet ?? '(no recap available)';
+            parts.push(`**${title}**${branch}\n${recap}\n`);
+        }
+    }
+    if (bundle.gitDiff.kind === 'ok' && bundle.gitDiff.value.trim().length > 0) {
+        parts.push('### Changed files\n');
+        parts.push('```\n' + bundle.gitDiff.value.trim() + '\n```\n');
+    }
+    return parts.join('\n');
+}

package/dist/context-assembly/infra.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import type { Result } from '../runtime/result.js';
+import type { SessionNote } from './types.js';
+export declare function createListRecentSessions(): (workspacePath: string, limit: number) => Promise<Result<readonly SessionNote[], string>>;

package/dist/context-assembly/infra.js ADDED Viewed

@@ -0,0 +1,154 @@
+"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.createListRecentSessions = createListRecentSessions;
+const fs = __importStar(require("node:fs/promises"));
+const nodePath = __importStar(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const neverthrow_1 = require("neverthrow");
+const result_js_1 = require("../runtime/result.js");
+const index_js_1 = require("../v2/infra/local/session-summary-provider/index.js");
+const index_js_2 = require("../v2/infra/local/data-dir/index.js");
+const index_js_3 = require("../v2/infra/local/directory-listing/index.js");
+const index_js_4 = require("../v2/infra/local/session-store/index.js");
+const index_js_5 = require("../v2/infra/local/sha256/index.js");
+const WRITE_NOT_SUPPORTED = 'context-assembly: write ops not supported in read-only session store';
+function makeReadOnlyFsPort() {
+    return {
+        readFileUtf8(filePath) {
+            return (0, neverthrow_1.fromPromise)(fs.readFile(filePath, 'utf-8'), (e) => {
+                const nodeErr = e;
+                if (nodeErr.code === 'ENOENT')
+                    return { code: 'FS_NOT_FOUND', message: nodeErr.message ?? 'not found' };
+                return { code: 'FS_IO_ERROR', message: nodeErr.message ?? String(e) };
+            });
+        },
+        readFileBytes(filePath) {
+            return (0, neverthrow_1.fromPromise)(fs.readFile(filePath).then((buf) => new Uint8Array(buf)), (e) => {
+                const nodeErr = e;
+                if (nodeErr.code === 'ENOENT')
+                    return { code: 'FS_NOT_FOUND', message: nodeErr.message ?? 'not found' };
+                return { code: 'FS_IO_ERROR', message: nodeErr.message ?? String(e) };
+            });
+        },
+        stat(_filePath) {
+            throw new Error(WRITE_NOT_SUPPORTED);
+        },
+        mkdirp(_dirPath) { throw new Error(WRITE_NOT_SUPPORTED); },
+        fsyncDir(_dirPath) { throw new Error(WRITE_NOT_SUPPORTED); },
+        openWriteTruncate(_filePath) { throw new Error(WRITE_NOT_SUPPORTED); },
+        openAppend(_filePath) { throw new Error(WRITE_NOT_SUPPORTED); },
+        openExclusive(_filePath, _bytes) { throw new Error(WRITE_NOT_SUPPORTED); },
+        writeAll(_fd, _bytes) { throw new Error(WRITE_NOT_SUPPORTED); },
+        fsyncFile(_fd) { throw new Error(WRITE_NOT_SUPPORTED); },
+        closeFile(_fd) { throw new Error(WRITE_NOT_SUPPORTED); },
+        rename(_from, _to) { throw new Error(WRITE_NOT_SUPPORTED); },
+        unlink(_filePath) { throw new Error(WRITE_NOT_SUPPORTED); },
+        writeFileBytes(_filePath, _bytes) { throw new Error(WRITE_NOT_SUPPORTED); },
+        readdir(_dirPath) { throw new Error(WRITE_NOT_SUPPORTED); },
+        readdirWithMtime(_dirPath) { throw new Error(WRITE_NOT_SUPPORTED); },
+    };
+}
+function makeDirectoryListingOpsPort() {
+    return {
+        readdir(dirPath) {
+            return (0, neverthrow_1.fromPromise)(fs.readdir(dirPath), (e) => {
+                const nodeErr = e;
+                if (nodeErr.code === 'ENOENT')
+                    return { code: 'FS_NOT_FOUND', message: nodeErr.message ?? 'not found' };
+                return { code: 'FS_IO_ERROR', message: nodeErr.message ?? String(e) };
+            });
+        },
+        readdirWithMtime(dirPath) {
+            return (0, neverthrow_1.fromPromise)((async () => {
+                const entries = await fs.readdir(dirPath, { withFileTypes: true });
+                const withMtimes = await Promise.all(entries.map(async (entry) => {
+                    try {
+                        const stat = await fs.stat(nodePath.join(dirPath, entry.name));
+                        return { name: entry.name, mtimeMs: stat.mtimeMs };
+                    }
+                    catch {
+                        return null;
+                    }
+                }));
+                return withMtimes.filter((e) => e !== null);
+            })(), (e) => {
+                const nodeErr = e;
+                if (nodeErr.code === 'ENOENT')
+                    return { code: 'FS_NOT_FOUND', message: nodeErr.message ?? 'not found' };
+                return { code: 'FS_IO_ERROR', message: nodeErr.message ?? String(e) };
+            });
+        },
+    };
+}
+function createListRecentSessions() {
+    return async (workspacePath, limit) => {
+        try {
+            const dataDir = new index_js_2.LocalDataDirV2(process.env);
+            const directoryListingOps = makeDirectoryListingOpsPort();
+            const directoryListing = new index_js_3.LocalDirectoryListingV2(directoryListingOps);
+            const fsPort = makeReadOnlyFsPort();
+            const sha256 = new index_js_5.NodeSha256V2();
+            const sessionStore = new index_js_4.LocalSessionEventLogStoreV2(dataDir, fsPort, sha256);
+            const provider = new index_js_1.LocalSessionSummaryProviderV2({
+                directoryListing,
+                dataDir,
+                sessionStore,
+            });
+            const result = await provider.loadHealthySummaries();
+            if (result.isErr()) {
+                return (0, result_js_1.err)(`listRecentSessions: ${result.error.message}`);
+            }
+            const workspaceHash = `sha256:${(0, node_crypto_1.createHash)('sha256').update(workspacePath).digest('hex')}`;
+            const notes = result.value
+                .filter((s) => s.observations.repoRootHash === null ||
+                s.observations.repoRootHash === workspaceHash)
+                .slice()
+                .sort((a, b) => (b.lastModifiedMs ?? Date.now()) - (a.lastModifiedMs ?? Date.now()))
+                .slice(0, limit)
+                .map((s) => ({
+                sessionId: String(s.sessionId),
+                recapSnippet: s.recapSnippet != null ? String(s.recapSnippet) : null,
+                sessionTitle: s.sessionTitle,
+                gitBranch: s.observations.gitBranch,
+                lastModifiedMs: s.lastModifiedMs ?? Date.now(),
+            }));
+            return (0, result_js_1.ok)(notes);
+        }
+        catch (e) {
+            return (0, result_js_1.err)(`listRecentSessions error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    };
+}

package/dist/context-assembly/types.d.ts ADDED Viewed

@@ -0,0 +1,30 @@
+import type { Result } from '../runtime/result.js';
+export type AssemblyTask = {
+    readonly kind: 'pr_review';
+    readonly prNumber: number;
+    readonly workspacePath: string;
+    readonly payloadBody?: string;
+} | {
+    readonly kind: 'coding_task';
+    readonly issueNumber?: number;
+    readonly workspacePath: string;
+    readonly payloadBody?: string;
+};
+export interface SessionNote {
+    readonly sessionId: string;
+    readonly recapSnippet: string | null;
+    readonly sessionTitle: string | null;
+    readonly gitBranch: string | null;
+    readonly lastModifiedMs: number;
+}
+export interface ContextBundle {
+    readonly task: AssemblyTask;
+    readonly gitDiff: Result<string, string>;
+    readonly priorSessionNotes: Result<readonly SessionNote[], string>;
+    readonly assembledAt: string;
+}
+export interface RenderOpts {
+}
+export interface ContextAssembler {
+    assemble(task: AssemblyTask): Promise<ContextBundle>;
+}

package/dist/context-assembly/types.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ "use strict";
2	+ Object.defineProperty(exports, "__esModule", { value: true });

package/dist/coordinators/pr-review.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import type { Result } from '../runtime/result.js';
 import type { AwaitResult } from '../cli/commands/worktrain-await.js';
+import type { ContextAssembler } from '../context-assembly/types.js';
 export type ReviewSeverity = 'clean' | 'minor' | 'blocking' | 'unknown';
 export interface ReviewFindings {
     readonly severity: ReviewSeverity;
@@ -36,7 +37,8 @@ export interface PrReviewOpts {
     readonly port?: number;
 }
 export interface CoordinatorDeps {
-    readonly spawnSession: (workflowId: string, goal: string, workspace: string) => Promise<Result<string, string>>;
+    readonly spawnSession: (workflowId: string, goal: string, workspace: string, context?: Readonly<Record<string, unknown>>) => Promise<Result<string, string>>;
+    readonly contextAssembler?: ContextAssembler;
     readonly awaitSessions: (handles: readonly string[], timeoutMs: number) => Promise<AwaitResult>;
     readonly getAgentResult: (sessionHandle: string) => Promise<{
         recapMarkdown: string | null;
@@ -48,6 +50,15 @@ export interface CoordinatorDeps {
     readonly stderr: (line: string) => void;
     readonly now: () => number;
     readonly port: number;
+    readonly readFile: (path: string) => Promise<string>;
+    readonly appendFile: (path: string, content: string) => Promise<void>;
+    readonly mkdir: (path: string, options: {
+        recursive: boolean;
+    }) => Promise<string | undefined>;
+    readonly homedir: () => string;
+    readonly joinPath: (...paths: string[]) => string;
+    readonly nowIso: () => string;
+    readonly generateId: () => string;
 }
 export declare function parseFindingsFromNotes(notes: string | null): Result<ReviewFindings, string>;
 export declare function readVerdictArtifact(artifacts: readonly unknown[], sessionHandle?: string): ReviewFindings | null;
@@ -59,4 +70,12 @@ export interface CoordinatorPortDiscoveryDeps {
     readonly homedir: () => string;
     readonly joinPath: (...paths: string[]) => string;
 }
+export interface DrainResult {
+    readonly stop: boolean;
+    readonly stopReason: string | null;
+    readonly skipPrNumbers: readonly number[];
+    readonly addPrNumbers: readonly number[];
+    readonly messagesProcessed: number;
+}
+export declare function drainMessageQueue(deps: Pick<CoordinatorDeps, 'readFile' | 'appendFile' | 'writeFile' | 'mkdir' | 'homedir' | 'joinPath' | 'nowIso' | 'generateId' | 'stderr'>): Promise<DrainResult>;
 export declare function runPrReviewCoordinator(deps: CoordinatorDeps, opts: PrReviewOpts): Promise<CoordinatorResult>;

package/dist/coordinators/pr-review.js CHANGED Viewed

@@ -5,9 +5,11 @@ exports.readVerdictArtifact = readVerdictArtifact;
 exports.buildFixGoal = buildFixGoal;
 exports.formatElapsed = formatElapsed;
 exports.discoverConsolePort = discoverConsolePort;
+exports.drainMessageQueue = drainMessageQueue;
 exports.runPrReviewCoordinator = runPrReviewCoordinator;
 const result_js_1 = require("../runtime/result.js");
 const review_verdict_js_1 = require("../v2/durable-core/schemas/artifacts/review-verdict.js");
+const index_js_1 = require("../context-assembly/index.js");
 const MAX_FIX_PASSES = 3;
 const CHILD_SESSION_TIMEOUT_MS = 15 * 60 * 1000;
 const COORDINATOR_MAX_MS = 90 * 60 * 1000;
@@ -161,6 +163,126 @@ async function discoverConsolePort(deps, portOverride) {
     }
     return DEFAULT_CONSOLE_PORT;
 }
+async function drainMessageQueue(deps) {
+    const workrailDir = deps.joinPath(deps.homedir(), '.workrail');
+    const queuePath = deps.joinPath(workrailDir, 'message-queue.jsonl');
+    const cursorPath = deps.joinPath(workrailDir, 'message-queue-cursor.json');
+    const outboxPath = deps.joinPath(workrailDir, 'outbox.jsonl');
+    let queueContent;
+    try {
+        queueContent = await deps.readFile(queuePath);
+    }
+    catch (err) {
+        if (isEnoentError(err)) {
+            return { stop: false, stopReason: null, skipPrNumbers: [], addPrNumbers: [], messagesProcessed: 0 };
+        }
+        deps.stderr(`[WARN coord:drain reason=read_failed] drainMessageQueue: could not read message queue: ${err instanceof Error ? err.message : String(err)}`);
+        return { stop: false, stopReason: null, skipPrNumbers: [], addPrNumbers: [], messagesProcessed: 0 };
+    }
+    const allLines = queueContent.split('\n').filter((line) => line.trim() !== '');
+    const parsedMessages = [];
+    for (const line of allLines) {
+        try {
+            const msg = JSON.parse(line);
+            parsedMessages.push(msg);
+        }
+        catch {
+            deps.stderr(`[WARN coord:drain reason=malformed_line] drainMessageQueue: skipped malformed JSONL line`);
+        }
+    }
+    const totalLines = parsedMessages.length;
+    let lastReadCount = 0;
+    try {
+        const cursorContent = await deps.readFile(cursorPath);
+        const cursor = JSON.parse(cursorContent);
+        if (typeof cursor.lastReadCount === 'number' && cursor.lastReadCount >= 0) {
+            lastReadCount = cursor.lastReadCount;
+        }
+    }
+    catch {
+        lastReadCount = 0;
+    }
+    if (lastReadCount > totalLines) {
+        lastReadCount = 0;
+    }
+    const newMessages = parsedMessages.slice(lastReadCount);
+    let stop = false;
+    let stopReason = null;
+    const skipSet = new Set();
+    const addSet = new Set();
+    const outboxEntries = [];
+    const STOP_RE = /^\s*stop\b/i;
+    const SKIP_PR_RE = /\bskip[- ]pr[\s#]+([0-9]+)/i;
+    const ADD_PR_RE = /\badd[- ]pr[\s#]+([0-9]+)/i;
+    for (const msg of newMessages) {
+        const text = msg.message;
+        if (STOP_RE.test(text)) {
+            stop = true;
+            stopReason = text;
+            deps.stderr(`[INFO coord:drain kind=stop ts=${msg.timestamp}] drainMessageQueue: stop signal received -- message: "${text}"`);
+            outboxEntries.push(JSON.stringify({
+                id: deps.generateId(),
+                message: `WorkTrain coordinator stopped by queued message: "${text}" (queued at ${msg.timestamp})`,
+                timestamp: deps.nowIso(),
+            }) + '\n');
+            continue;
+        }
+        const skipMatch = SKIP_PR_RE.exec(text);
+        if (skipMatch !== null) {
+            const prNum = parseInt(skipMatch[1], 10);
+            skipSet.add(prNum);
+            deps.stderr(`[INFO coord:drain kind=skip-pr prNumber=${prNum} ts=${msg.timestamp}] drainMessageQueue: skip-pr signal received -- message: "${text}"`);
+            outboxEntries.push(JSON.stringify({
+                id: deps.generateId(),
+                message: `WorkTrain coordinator skipping PR #${prNum} per queued message: "${text}" (queued at ${msg.timestamp})`,
+                timestamp: deps.nowIso(),
+            }) + '\n');
+            continue;
+        }
+        const addMatch = ADD_PR_RE.exec(text);
+        if (addMatch !== null) {
+            const prNum = parseInt(addMatch[1], 10);
+            addSet.add(prNum);
+            deps.stderr(`[INFO coord:drain kind=add-pr prNumber=${prNum} ts=${msg.timestamp}] drainMessageQueue: add-pr signal received -- message: "${text}"`);
+            outboxEntries.push(JSON.stringify({
+                id: deps.generateId(),
+                message: `WorkTrain coordinator adding PR #${prNum} per queued message: "${text}" (queued at ${msg.timestamp})`,
+                timestamp: deps.nowIso(),
+            }) + '\n');
+            continue;
+        }
+    }
+    if (outboxEntries.length > 0) {
+        try {
+            await deps.mkdir(workrailDir, { recursive: true });
+            await deps.appendFile(outboxPath, outboxEntries.join(''));
+        }
+        catch (err) {
+            deps.stderr(`[WARN coord:drain reason=outbox_write_failed] drainMessageQueue: could not write outbox notifications: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const newCursor = JSON.stringify({ lastReadCount: totalLines }, null, 2) + '\n';
+    try {
+        await deps.mkdir(workrailDir, { recursive: true });
+        await deps.writeFile(cursorPath, newCursor);
+    }
+    catch (err) {
+        deps.stderr(`[WARN coord:drain reason=cursor_write_failed] drainMessageQueue: could not update cursor: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return {
+        stop,
+        stopReason,
+        skipPrNumbers: [...skipSet],
+        addPrNumbers: [...addSet],
+        messagesProcessed: newMessages.length,
+    };
+}
+function isEnoentError(err) {
+    return (err !== null &&
+        typeof err === 'object' &&
+        'code' in err &&
+        err.code === 'ENOENT');
+}
 async function runPrReviewCoordinator(deps, opts) {
     const coordinatorStartMs = deps.now();
     const today = new Date(deps.now()).toISOString().slice(0, 10);
@@ -170,6 +292,30 @@ async function runPrReviewCoordinator(deps, opts) {
         deps.stderr(line);
         reportLines.push(line);
     }
+    const drainResult = await drainMessageQueue(deps);
+    if (drainResult.messagesProcessed > 0) {
+        const skipStr = drainResult.skipPrNumbers.length > 0
+            ? `, skip=[${drainResult.skipPrNumbers.join(',')}]`
+            : '';
+        const addStr = drainResult.addPrNumbers.length > 0
+            ? `, add=[${drainResult.addPrNumbers.join(',')}]`
+            : '';
+        log(`[drain] processed ${drainResult.messagesProcessed} message(s)${skipStr}${addStr}${drainResult.stop ? ', STOP SIGNAL' : ''}`);
+    }
+    if (drainResult.stop) {
+        const stopMsg = drainResult.stopReason ?? 'stop signal in message queue';
+        log(`  STOP: coordinator halted by queued message: "${stopMsg}"`);
+        const result = {
+            reviewed: 0,
+            approved: 0,
+            escalated: 0,
+            mergedPrs: [],
+            reportPath,
+            hasErrors: false,
+        };
+        await writeReport(deps, reportPath, reportLines, result);
+        return result;
+    }
     log('[1/3] Gathering open PRs...');
     const stageStart = deps.now();
     let prs;
@@ -183,6 +329,25 @@ async function runPrReviewCoordinator(deps, opts) {
     else {
         prs = await deps.listOpenPRs(opts.workspace);
     }
+    if (drainResult.addPrNumbers.length > 0) {
+        const existingNums = new Set(prs.map((p) => p.number));
+        for (const addNum of drainResult.addPrNumbers) {
+            if (!existingNums.has(addNum)) {
+                prs = [...prs, { number: addNum, title: `PR #${addNum}`, headRef: '' }];
+                existingNums.add(addNum);
+                log(`  [drain] added PR #${addNum} from message queue`);
+            }
+        }
+    }
+    if (drainResult.skipPrNumbers.length > 0) {
+        const skipSet = new Set(drainResult.skipPrNumbers);
+        const prsBefore = prs.length;
+        prs = prs.filter((p) => !skipSet.has(p.number));
+        const skippedCount = prsBefore - prs.length;
+        if (skippedCount > 0) {
+            log(`  [drain] skipped ${skippedCount} PR(s) from message queue: [${[...skipSet].join(',')}]`);
+        }
+    }
     log(`  done (${formatElapsed(deps.now() - stageStart)}) -- ${prs.length} PR(s) found`);
     if (prs.length === 0) {
         const result = {
@@ -213,13 +378,33 @@ async function runPrReviewCoordinator(deps, opts) {
     }
     const reviewHandles = new Map();
     const spawnErrors = new Map();
+    const spawnContexts = new Map();
     for (const pr of prs) {
         const goal = `Review PR #${pr.number} "${pr.title}" before merge`;
         if (opts.dryRun) {
             log(`      PR #${pr.number} [dry-run] would spawn mr-review-workflow-agentic`);
             continue;
         }
-        const spawnResult = await deps.spawnSession('mr-review-workflow-agentic', goal, opts.workspace);
+        let spawnContext;
+        if (deps.contextAssembler) {
+            const bundle = await deps.contextAssembler.assemble({
+                kind: 'pr_review',
+                prNumber: pr.number,
+                workspacePath: opts.workspace,
+            });
+            const rendered = (0, index_js_1.renderContextBundle)(bundle);
+            if (rendered.trim().length > 0) {
+                spawnContext = { assembledContextSummary: rendered };
+                spawnContexts.set(pr.number, spawnContext);
+            }
+            if (bundle.gitDiff.kind === 'err') {
+                deps.stderr(`[WARN coord:context prNumber=${pr.number}] gitDiff failed: ${bundle.gitDiff.error}`);
+            }
+            if (bundle.priorSessionNotes.kind === 'err') {
+                deps.stderr(`[WARN coord:context prNumber=${pr.number}] priorSessionNotes failed: ${bundle.priorSessionNotes.error}`);
+            }
+        }
+        const spawnResult = await deps.spawnSession('mr-review-workflow-agentic', goal, opts.workspace, spawnContext);
         if (spawnResult.kind === 'err') {
             spawnErrors.set(pr.number, spawnResult.error);
             log(`      PR #${pr.number} spawn failed: ${spawnResult.error}`);
@@ -298,7 +483,7 @@ async function runPrReviewCoordinator(deps, opts) {
                 sessionHandles: [handle],
             };
             if (severity === 'minor' && findings && sessionResult.outcome === 'success') {
-                const processedOutcome = await runFixAgentLoop(deps, opts, pr, findings, outcome, coordinatorStartMs, log);
+                const processedOutcome = await runFixAgentLoop(deps, opts, pr, findings, outcome, coordinatorStartMs, log, spawnContexts.get(prNum));
                 outcomes.set(prNum, processedOutcome);
             }
             else {
@@ -373,7 +558,7 @@ async function runPrReviewCoordinator(deps, opts) {
     await writeReport(deps, reportPath, reportLines, result);
     return result;
 }
-async function runFixAgentLoop(deps, opts, pr, initialFindings, initialOutcome, coordinatorStartMs, log) {
+async function runFixAgentLoop(deps, opts, pr, initialFindings, initialOutcome, coordinatorStartMs, log, reviewSpawnContext) {
     let passCount = 0;
     let currentFindings = initialFindings;
     let sessionHandles = [...initialOutcome.sessionHandles];
@@ -450,7 +635,7 @@ async function runFixAgentLoop(deps, opts, pr, initialFindings, initialOutcome,
             };
         }
         const reReviewGoal = `Re-review PR #${pr.number} after fixes (pass ${passCount})`;
-        const reReviewSpawnResult = await deps.spawnSession('mr-review-workflow-agentic', reReviewGoal, opts.workspace);
+        const reReviewSpawnResult = await deps.spawnSession('mr-review-workflow-agentic', reReviewGoal, opts.workspace, reviewSpawnContext);
         if (reReviewSpawnResult.kind === 'err') {
             log(`      PR #${pr.number}  ->  re-review spawn failed: ${reReviewSpawnResult.error}`);
             return {

package/dist/daemon/daemon-events.d.ts CHANGED Viewed

@@ -101,6 +101,14 @@ export interface ToolCallFailedEvent {
     readonly errorMessage: string;
     readonly workrailSessionId?: string;
 }
+export interface SignalEmittedEvent {
+    readonly kind: 'signal_emitted';
+    readonly sessionId: string;
+    readonly signalKind: string;
+    readonly signalId: string;
+    readonly payload: Readonly<Record<string, unknown>>;
+    readonly workrailSessionId?: string;
+}
 export interface AgentStuckEvent {
     readonly kind: 'agent_stuck';
     readonly sessionId: string;
@@ -110,7 +118,7 @@ export interface AgentStuckEvent {
     readonly argsSummary?: string;
     readonly workrailSessionId?: string;
 }
-export type DaemonEvent = DaemonStartedEvent | TriggerFiredEvent | SessionQueuedEvent | SessionStartedEvent | ToolCalledEvent | ToolErrorEvent | StepAdvancedEvent | SessionCompletedEvent | DeliveryAttemptedEvent | IssueReportedEvent | LlmTurnStartedEvent | LlmTurnCompletedEvent | ToolCallStartedEvent | ToolCallCompletedEvent | ToolCallFailedEvent | AgentStuckEvent;
+export type DaemonEvent = DaemonStartedEvent | TriggerFiredEvent | SessionQueuedEvent | SessionStartedEvent | ToolCalledEvent | ToolErrorEvent | StepAdvancedEvent | SessionCompletedEvent | DeliveryAttemptedEvent | IssueReportedEvent | LlmTurnStartedEvent | LlmTurnCompletedEvent | ToolCallStartedEvent | ToolCallCompletedEvent | ToolCallFailedEvent | AgentStuckEvent | SignalEmittedEvent;
 export declare class DaemonEventEmitter {
     private readonly _dir;
     constructor(dirOverride?: string);

package/dist/daemon/soul-template.d.ts CHANGED Viewed

@@ -1,2 +1,2 @@
-export declare const DAEMON_SOUL_DEFAULT = "- Write code that follows the patterns already established in the codebase\n- Never skip tests. Run existing tests before and after changes\n- Prefer small, focused changes over large rewrites\n- If a step asks you to write code, write actual code -- do not write pseudocode or placeholders\n- Commit your work when you complete a logical unit";
-export declare const DAEMON_SOUL_TEMPLATE = "# WorkRail Daemon Soul\n#\n# This file is injected into every WorkRail Auto daemon session system prompt under\n# \"## Agent Rules and Philosophy\". Edit it to customize the agent's behavior for\n# your environment: coding conventions, commit style, tool preferences, etc.\n#\n# Changes take effect on the next daemon session -- no restart required.\n#\n# The defaults below reflect general best practices. Override them freely.\n\n- Write code that follows the patterns already established in the codebase\n- Never skip tests. Run existing tests before and after changes\n- Prefer small, focused changes over large rewrites\n- If a step asks you to write code, write actual code -- do not write pseudocode or placeholders\n- Commit your work when you complete a logical unit\n";
+export declare const DAEMON_SOUL_DEFAULT = "- Write code that follows the patterns already established in the codebase\n- Never skip tests. Run existing tests before and after changes\n- Prefer small, focused changes over large rewrites\n- If a step asks you to write code, write actual code -- do not write pseudocode or placeholders\n- Commit your work when you complete a logical unit\n\n## File work\n- File search: Use Glob (NOT find or ls)\n- Content search: Use Grep (NOT grep or rg)\n- Read files: Use Read (NOT cat/head/tail)\n- Edit files: Use Edit (NOT sed/awk)\n- Write files: Use Write (NOT echo >/cat <<EOF)\n- Always Read a file before Edit. Edit requires the file to have been read in this session.\n- Use Edit for targeted in-place changes. Use Write only for new files or full rewrites.\n- Grep output_mode: use \"files_with_matches\" to find which files, then Read the relevant ones.";
+export declare const DAEMON_SOUL_TEMPLATE = "# WorkRail Daemon Soul\n#\n# This file is injected into every WorkRail Auto daemon session system prompt under\n# \"## Agent Rules and Philosophy\". Edit it to customize the agent's behavior for\n# your environment: coding conventions, commit style, tool preferences, etc.\n#\n# Changes take effect on the next daemon session -- no restart required.\n#\n# The defaults below reflect general best practices. Override them freely.\n\n- Write code that follows the patterns already established in the codebase\n- Never skip tests. Run existing tests before and after changes\n- Prefer small, focused changes over large rewrites\n- If a step asks you to write code, write actual code -- do not write pseudocode or placeholders\n- Commit your work when you complete a logical unit\n\n## File work\n- File search: Use Glob (NOT find or ls)\n- Content search: Use Grep (NOT grep or rg)\n- Read files: Use Read (NOT cat/head/tail)\n- Edit files: Use Edit (NOT sed/awk)\n- Write files: Use Write (NOT echo >/cat <<EOF)\n- Always Read a file before Edit. Edit requires the file to have been read in this session.\n- Use Edit for targeted in-place changes. Use Write only for new files or full rewrites.\n- Grep output_mode: use \"files_with_matches\" to find which files, then Read the relevant ones.\n";

package/dist/daemon/soul-template.js CHANGED Viewed

@@ -6,7 +6,17 @@ exports.DAEMON_SOUL_DEFAULT = `\
 - Never skip tests. Run existing tests before and after changes
 - Prefer small, focused changes over large rewrites
 - If a step asks you to write code, write actual code -- do not write pseudocode or placeholders
-- Commit your work when you complete a logical unit`;
+- Commit your work when you complete a logical unit
+## File work
+- File search: Use Glob (NOT find or ls)
+- Content search: Use Grep (NOT grep or rg)
+- Read files: Use Read (NOT cat/head/tail)
+- Edit files: Use Edit (NOT sed/awk)
+- Write files: Use Write (NOT echo >/cat <<EOF)
+- Always Read a file before Edit. Edit requires the file to have been read in this session.
+- Use Edit for targeted in-place changes. Use Write only for new files or full rewrites.
+- Grep output_mode: use "files_with_matches" to find which files, then Read the relevant ones.`;
 exports.DAEMON_SOUL_TEMPLATE = `\
 # WorkRail Daemon Soul
 #