agents-relay 2.0.69 → 2.0.71

package/dist/cli-job-create.js

@@ -1,9 +1,7 @@
 import { openLocalManagedStore } from './local-managed-store.js';
 import { createJobEntity } from './workflow/entity-creation.js';
 import { normalizeThreadId } from './reviewer-thread.js';
-import { discoverLocalRelayStoreSnapshots } from './relay-store.js';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { discoverLocalRelayStoreSnapshots, relayStoreDirectory } from './relay-store.js';
 /**
  * Job lifecycle bootstrap: SQLite is authoritative. No GitHub request is
  * required; an explicit PR number is optional external metadata.
@@ -16,7 +14,7 @@ export async function ensureManagedGitHubJob(_client, repositoryName, _trustedAu
         throw new Error('Invalid external PR binding number');
     const placeholder = { number: requestedNumber, title: options.title ?? options.id,
         body: options.body ?? options.objective ?? '', state: 'OPEN', head: options.head ?? '', base: options.base ?? '' };
-    const directory = options.storeDirectory ?? join(homedir(), '.agents-relay', 'stores');
+    const directory = options.storeDirectory ?? relayStoreDirectory();
     const alreadyKnown = (await discoverLocalRelayStoreSnapshots(directory)).flatMap(snapshot => snapshot.jobs.filter(job => job.id === options.id).map(job => ({ job, path: snapshot.path })));
     if (alreadyKnown.length > 1)
         throw new Error('Duplicate immutable Job ID across SQLite stores: ' + options.id);

package/dist/cli-support.js

@@ -4,8 +4,7 @@ import { githubAuthContext } from './github-auth.js';
 import { noGitHubMode } from './no-github.js';
 import { basename } from 'node:path';
 import { createJobIdRegistryResolver } from './local-job-registry.js';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { relayStoreDirectory } from './relay-store.js';
 import { NatsEventBus, eventFor } from './events.js';
 import { parseJobSchedule } from './scheduler.js';
 import { parseJobTagJson } from './task-tag.js';
@@ -73,7 +72,7 @@ export async function storeFor(args) {
     const jobId = arg(args, '--id');
     if (!repo || !jobId)
         throw new Error('Local Job requires --repo and --id (or explicit --file)');
-    const directory = arg(args, '--store-dir') || join(homedir(), '.agents-relay', 'stores');
+    const directory = arg(args, '--store-dir') || relayStoreDirectory();
     const binding = await createJobIdRegistryResolver(directory, new Map())(jobId);
     if (!binding || binding.job.repository !== repo)
         throw new Error('Immutable local Job not found for repository: ' + jobId);

package/dist/cli.js

@@ -1,9 +1,7 @@
 #!/usr/bin/env node
-import { homedir } from 'node:os';
-import { join } from 'node:path';
 import { configureLocalGitMerge } from './cli-local-merge-config.js';
 import { noGitHubMode } from './no-github.js';
-import { discoverLocalRelayStoreSnapshots } from './relay-store.js';
+import { discoverLocalRelayStoreSnapshots, relayStoreDirectory } from './relay-store.js';
 import { realpathSync } from 'node:fs';
 import { once } from 'node:events';
 import { fileURLToPath } from 'node:url';
@@ -489,7 +487,7 @@ export async function createService(args) {
     let overviewProvider;
     if (repo) {
         overviewProvider = async () => {
-            const snapshots = await discoverLocalRelayStoreSnapshots(join(homedir(), '.agents-relay', 'stores'));
+            const snapshots = await discoverLocalRelayStoreSnapshots(relayStoreDirectory());
             return dashboardManagedJobs(snapshots.flatMap(snapshot => snapshot.jobs
                 .filter(job => job.repository === repo)
                 .map(job => ({

package/dist/local-authority-store.js

@@ -133,6 +133,8 @@ export class LocalAuthorityDurableStore {
             const children = mergeInboundJobSnapshot(current, incoming);
             const preserveTerminal = ['COMPLETED', 'CANCELLED'].includes(current.state)
                 && !['COMPLETED', 'CANCELLED'].includes(incoming.state);
+            // A stale snapshot must not undo an already committed Graph activation.
+            const preserveActivation = current.state === 'ACTIVE' && incoming.state === 'DRAFT';
             const review = current.review && incoming.review
                 && current.review.updatedAt > incoming.review.updatedAt
                 ? current.review : incoming.review;
@@ -142,7 +144,7 @@ export class LocalAuthorityDurableStore {
             const scalarSource = incoming.updatedAt > current.updatedAt ? incoming : current;
             return {
                 ...current, ...scalarSource,
-                state: preserveTerminal ? current.state : scalarSource.state,
+                state: preserveTerminal || preserveActivation ? current.state : scalarSource.state,
                 updatedAt: current.updatedAt > incoming.updatedAt ? current.updatedAt : incoming.updatedAt,
                 tasks: children.tasks,
                 ...(children.plans ? { plans: children.plans } : {}),

package/dist/local-job-path.js

@@ -1,7 +1,12 @@
 import { createHash } from 'node:crypto';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
 /** Primary local store key is immutable Job ID, independent of a PR number. */
 export function relayJobStorePath(directory, jobId) {
     if (!jobId.trim() || jobId.length > 1024)
         throw new Error('Invalid immutable Job ID');
     return directory + '/job-' + createHash('sha256').update(jobId).digest('hex') + '.db';
 }
+export function relayStoreDirectory(env = process.env) {
+    return env.AGENTS_RELAY_STORE_DIR || join(homedir(), '.agents-relay', 'stores');
+}

package/dist/local-managed-store.js

@@ -1,16 +1,14 @@
-import { homedir } from 'node:os';
-import { join } from 'node:path';
 import { GhApiClient } from './github-client.js';
 import { DisabledGitHubClient, noGitHubMode } from './no-github.js';
 import { GitHubStore } from './store.js';
 import { LocalAuthorityDurableStore } from './local-authority-store.js';
-import { relayStorePath, relayJobStorePath, SQLiteRelayStore } from './relay-store.js';
+import { relayStoreDirectory, relayStorePath, relayJobStorePath, SQLiteRelayStore } from './relay-store.js';
 /** Open the canonical V2 SQLite authority without making any GitHub request. */
 export function openLocalManagedStore(repository, prNumber, options = {}) {
     if (!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(repository) || repository.includes('..') || !Number.isInteger(prNumber) || prNumber < 0 || (prNumber === 0 && !options.jobId)) {
         throw new Error('Local managed store requires a repository and either a positive PR number or immutable jobId');
     }
-    const directory = options.directory ?? join(homedir(), '.agents-relay', 'stores');
+    const directory = options.directory ?? relayStoreDirectory();
     const relay = new SQLiteRelayStore(prNumber === 0 ? relayJobStorePath(directory, options.jobId) : relayStorePath(directory, repository, prNumber));
     const client = prNumber === 0 || options.noGitHub || noGitHubMode() ? new DisabledGitHubClient() : options.client ?? new GhApiClient();
     const github = new GitHubStore(client, repository, prNumber, options.trustedAuthors ?? new Set());

package/dist/relay-store.js

@@ -367,7 +367,7 @@ export class SQLiteRelayStore {
 export function relayStorePath(directory, repository, prNumber) {
     return directory + '/' + `${repository.replace('/', '_')}-${prNumber}.db`;
 }
-export { relayJobStorePath } from './local-job-path.js';
+export { relayJobStorePath, relayStoreDirectory } from './local-job-path.js';
 /**
  * SQLite is the only job registry. Inventory queries must be strictly read-only:
  * opening a writable RelayStore here would reset in-flight projection claims

package/dist/relayd-dashboard-actions.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 export function createDashboardActions(deps) {
-    const { cachedOverviews, requireLocalJobBinding, pool, dashboardJobAction, makeReconciler, concurrency, dashboardJobSetState, refreshAll, applyJobActivateAction, applyOrchestratorStartAction, applyOrchestratorCompleteAction, publishOrchestratorTaskStarted, publishOrchestratorTaskCompletion, bus, dashboardTaskAction, dashboardTaskSetState } = deps;
-    const dashboardOverview = (jobId, target) => cachedOverviews.find((item) => item.job.id === jobId
+    const { getOverviews, requireLocalJobBinding, pool, dashboardJobAction, makeReconciler, concurrency, dashboardJobSetState, refreshAll, applyJobActivateAction, applyOrchestratorStartAction, applyOrchestratorCompleteAction, publishOrchestratorTaskStarted, publishOrchestratorTaskCompletion, bus, dashboardTaskAction, dashboardTaskSetState } = deps;
+    const currentOverviews = () => getOverviews();
+    const dashboardOverview = (jobId, target) => currentOverviews().find((item) => item.job.id === jobId
         && (!target?.repository || item.job.repository === target.repository)
         && (!target?.prNumber || (item.job.externalPrNumber ?? item.job.prNumber) === target.prNumber));
     const workspaceJobAction = (action) => async (jobId) => {
-        const overview = cachedOverviews.find((item) => item.job.id === jobId);
+        const overview = currentOverviews().find((item) => item.job.id === jobId);
         if (!overview)
             throw new Error(`Managed job ${jobId} not found`);
         const store = (await requireLocalJobBinding(jobId)).store;
@@ -25,7 +26,7 @@ export function createDashboardActions(deps) {
         return result;
     };
     const workspaceTaskCreate = async (jobId, task) => {
-        const overview = cachedOverviews.find((item) => item.job.id === jobId);
+        const overview = currentOverviews().find((item) => item.job.id === jobId);
         if (!overview)
             throw new Error(`Managed job ${jobId} not found`);
         if (task.jobId !== jobId)
@@ -59,7 +60,7 @@ export function createDashboardActions(deps) {
         return await store.load(jobId);
     };
     const workspaceTaskStart = async (jobId, taskId) => {
-        const overview = cachedOverviews.find((item) => item.job.id === jobId);
+        const overview = currentOverviews().find((item) => item.job.id === jobId);
         if (!overview)
             throw new Error(`Managed job ${jobId} not found`);
         const store = (await requireLocalJobBinding(jobId)).store;
@@ -74,7 +75,7 @@ export function createDashboardActions(deps) {
         return await store.load(jobId);
     };
     const workspaceTaskComplete = async (jobId, taskId, summary) => {
-        const overview = cachedOverviews.find((item) => item.job.id === jobId);
+        const overview = currentOverviews().find((item) => item.job.id === jobId);
         if (!overview)
             throw new Error(`Managed job ${jobId} not found`);
         const store = (await requireLocalJobBinding(jobId)).store;
@@ -89,7 +90,7 @@ export function createDashboardActions(deps) {
         return await store.load(jobId);
     };
     const workspaceTaskAction = (action) => async (jobId, taskId) => {
-        const overview = cachedOverviews.find((item) => item.job.id === jobId);
+        const overview = currentOverviews().find((item) => item.job.id === jobId);
         if (!overview)
             throw new Error(`Managed job ${jobId} not found`);
         const store = (await requireLocalJobBinding(jobId)).store;

package/dist/relayd.js

@@ -13,7 +13,7 @@ import { Reconciler } from './reconciler.js';
 import { dashboardManagedJobs, GitHubStore, InMemoryStore, resolvePullRequest } from './store.js';
 import { GitHubProjectionWriter } from './projected-store.js';
 import { LocalAuthorityDurableStore } from './local-authority-store.js';
-import { discoverLocalRelayStoreSnapshots, relayStorePath, SQLiteRelayStore } from './relay-store.js';
+import { discoverLocalRelayStoreSnapshots, relayStoreDirectory, relayStorePath, SQLiteRelayStore } from './relay-store.js';
 import { createJobIdRegistryResolver } from './local-job-registry.js';
 import { projectAuthoritativeLocalMerge } from './local-merge-projection.js';
 import { archiveDisplayPullRequest } from './github-pr-archive.js';
@@ -116,7 +116,7 @@ export async function runDaemon(argv) {
         const key = `${repository}#${prNumber}`;
         let relay = relayStores.get(key);
         if (!relay) {
-            relay = new SQLiteRelayStore(relayStorePath(join(homedir(), '.agents-relay', 'stores'), repository, prNumber));
+            relay = new SQLiteRelayStore(relayStorePath(relayStoreDirectory(), repository, prNumber));
             relayStores.set(key, relay);
         }
         const github = new GitHubStore(client, repository, prNumber, trusted, seed);
@@ -127,7 +127,7 @@ export async function runDaemon(argv) {
         return projected;
     };
     // SQLite inventory, not GitHub discovery, defines which repositories exist.
-    const existingInventory = await discoverLocalRelayStoreSnapshots(join(homedir(), '.agents-relay', 'stores'));
+    const existingInventory = await discoverLocalRelayStoreSnapshots(relayStoreDirectory());
     for (const snapshot of existingInventory)
         for (const job of snapshot.jobs) {
             if (!repositories.includes(job.repository))
@@ -136,7 +136,7 @@ export async function runDaemon(argv) {
     if (repositories.length === 0)
         repositories.push('local/' + basename(workspaceRoot));
     const inventoryFromLocal = async () => {
-        const snapshots = await discoverLocalRelayStoreSnapshots(join(homedir(), '.agents-relay', 'stores'));
+        const snapshots = await discoverLocalRelayStoreSnapshots(relayStoreDirectory());
         const known = new Set(repositories);
         const entries = snapshots.flatMap(snapshot => snapshot.jobs.filter(job => known.has(job.repository)).map(job => ({
             job, githubState: snapshot.facts?.state ?? 'UNKNOWN',
@@ -174,7 +174,7 @@ export async function runDaemon(argv) {
         };
     };
     const refreshPullRequest = async (repository, prNumber, trigger, options) => (await refreshPullRequestSnapshot(repository, prNumber, trigger, options)).overviews;
-    const localJobBinding = createJobIdRegistryResolver(join(homedir(), '.agents-relay', 'stores'), relayStores, { client, trustedAuthors: trusted, noGitHub });
+    const localJobBinding = createJobIdRegistryResolver(relayStoreDirectory(), relayStores, { client, trustedAuthors: trusted, noGitHub });
     const requireLocalJobBinding = async (jobId) => {
         const binding = await localJobBinding(jobId);
         if (!binding)
@@ -214,7 +214,7 @@ export async function runDaemon(argv) {
             return;
         if (client.rateLimitStatus().limited)
             return;
-        const snapshots = await discoverLocalRelayStoreSnapshots(join(homedir(), '.agents-relay', 'stores'));
+        const snapshots = await discoverLocalRelayStoreSnapshots(relayStoreDirectory());
         const bindingCandidates = orderGitHubBindingCandidates(snapshots.flatMap(snapshot => snapshot.jobs.map(job => ({ snapshotPath: snapshot.path, job }))));
         for (const candidate of bindingCandidates) {
             const snapshot = { path: candidate.snapshotPath };
@@ -338,7 +338,7 @@ export async function runDaemon(argv) {
     const initial = cachedOverviews;
     const fallback = initial[0]?.job;
     const dashboardStore = fallback ? (await requireLocalJobBinding(fallback.id)).store : new InMemoryStore();
-    const { dashboardOverview, workspaceJobAction, workspaceJobSetState, workspaceTaskCreate, workspaceTaskStart, workspaceTaskComplete, workspaceTaskAction, workspaceTaskSetState } = createDashboardActions({ cachedOverviews, requireLocalJobBinding, pool, dashboardJobAction, makeReconciler, concurrency, dashboardJobSetState, refreshAll, applyJobActivateAction, applyOrchestratorStartAction, applyOrchestratorCompleteAction, publishOrchestratorTaskStarted, publishOrchestratorTaskCompletion, bus, dashboardTaskAction, dashboardTaskSetState });
+    const { dashboardOverview, workspaceJobAction, workspaceJobSetState, workspaceTaskCreate, workspaceTaskStart, workspaceTaskComplete, workspaceTaskAction, workspaceTaskSetState } = createDashboardActions({ getOverviews: () => cachedOverviews, requireLocalJobBinding, pool, dashboardJobAction, makeReconciler, concurrency, dashboardJobSetState, refreshAll, applyJobActivateAction, applyOrchestratorStartAction, applyOrchestratorCompleteAction, publishOrchestratorTaskStarted, publishOrchestratorTaskCompletion, bus, dashboardTaskAction, dashboardTaskSetState });
     const workspaceControl = createWorkspaceControl({ client, trusted, noGitHub, repositories, refreshAll, requireLocalJobBinding, makeReconciler, concurrency, pool, bus, isEffectivelyBlocked, unblockAutonomousTasks, unblockTask, publishTaskUnblocked, dispatchTaskAction, registerBlockerDependency, discoverAgents, ensureManagedGitHubJob });
     const secretFile = value(argv, '--github-webhook-secret-file');
     const secret = noGitHub ? '' : value(argv, '--github-webhook-secret') || process.env.AGENTS_RELAY_GITHUB_WEBHOOK_SECRET || (secretFile ? (await readFile(secretFile, 'utf8')).trim() : '');

package/dist/service-publication.js

@@ -1,9 +1,7 @@
-import { homedir } from 'node:os';
-import { join } from 'node:path';
 import { eventFor } from './events.js';
-import { SQLiteRelayStore, relayStorePath } from './relay-store.js';
+import { SQLiteRelayStore, relayStoreDirectory, relayStorePath } from './relay-store.js';
 /** Single-Job service uses the same durable publish facts as the repository daemon. */
-export async function handleServicePublication(job, wake, bus, directory = join(homedir(), '.agents-relay', 'stores')) {
+export async function handleServicePublication(job, wake, bus, directory = relayStoreDirectory()) {
     if (!wake.publication && !wake.publishFailure)
         return;
     const sqlite = new SQLiteRelayStore(relayStorePath(directory, job.repository, job.prNumber));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-relay",
-  "version": "2.0.69",
+  "version": "2.0.71",
   "description": "Durable async agent jobs coordinated through GitHub pull requests",
   "type": "module",
   "bin": {
@@ -12,9 +12,9 @@
     "test": "npm run test:full",
     "test:chatgpt-temp-quality": "AGENTS_RELAY_RUN_CHATGPT_TEMP_QUALITY=1 sh -c \"npm run build && node test/quality/run-temporary-chat.mjs\"",
     "dev": "tsx src/cli.ts",
-    "test:publish": "npm run build && node --test --test-concurrency=1 --test-force-exit test/*.test.js",
-    "test:fast": "npm run build && node --test --test-concurrency=2 test/workflow-lifecycle.test.js test/workflow-v2-lifecycle-parity.test.js test/workflow-effects.test.js test/relay-store.test.js test/local-authority.test.js test/local-jobid-routing.test.js test/local-sqlite-jobid.test.js test/no-github.test.js test/scheduled-jobs.test.js test/reconcile-coordinator.test.js test/service-publication.test.js test/github-webhook.test.js",
-    "test:full": "npm run build && node --test --test-concurrency=1 test/*.test.js",
+    "test:publish": "npm run build && node --import ./test/test-store-env.mjs --test --test-concurrency=1 --test-force-exit test/*.test.js",
+    "test:fast": "npm run build && node --import ./test/test-store-env.mjs --test --test-concurrency=2 test/workflow-lifecycle.test.js test/workflow-v2-lifecycle-parity.test.js test/workflow-effects.test.js test/relay-store.test.js test/local-authority.test.js test/local-jobid-routing.test.js test/local-sqlite-jobid.test.js test/no-github.test.js test/scheduled-jobs.test.js test/reconcile-coordinator.test.js test/service-publication.test.js test/github-webhook.test.js",
+    "test:full": "npm run build && node --import ./test/test-store-env.mjs --test --test-concurrency=1 test/*.test.js",
     "e2e": "node e2e/runner/run.mjs"
   },
   "devDependencies": {