@boxxy/dispatch 0.1.1 → 0.1.3

package/src/test-utils/build-mock-claim-change.ts

@@ -1,11 +1,18 @@
-import type { AttemptRow, StoreChange } from '@boxxy/model';
+import type { AttemptRow, LimitName, StoreChange } from '@boxxy/model';
 import { buildMockFactId } from '@boxxy/model/test-utils/build-mock-fact-id';
 
-export function buildMockClaimChange(attempt: AttemptRow): StoreChange {
+// A claim that takes the lease and a seat in each named limit, and inserts the attempt as given.
+export function buildMockClaimChange(
+  attempt: AttemptRow,
+  limits: readonly LimitName[] = [],
+): StoreChange {
   return {
     at: attempt.claimedAt,
     writes: [
-      { op: 'take-slot', pool: attempt.pool, holder: attempt.id },
+      {
+        op: 'take-seats',
+        take: { limits, attempt: attempt.id, holdGen: attempt.holdGen, overCap: false },
+      },
       {
         op: 'insert',
         table: 'leases',
@@ -18,22 +25,25 @@ export function buildMockClaimChange(attempt: AttemptRow): StoreChange {
           releasedAt: null,
         },
       },
-      { op: 'insert', table: 'attempts', row: { ...attempt, slot: 0, slotGen: 0 } },
+      { op: 'insert', table: 'attempts', row: attempt },
     ],
     facts: [
       {
         id: buildMockFactId(),
         type: 'boxxy.attempt.claimed',
-        entity: `boxxy:attempt:${attempt.id}`,
+        entity: `boxxy:item:${attempt.item}`,
         actor: `boxxy:runner:${attempt.runner}`,
         payload: {
-          item: attempt.item,
+          attempt: attempt.id,
           phase: attempt.phase,
           number: attempt.number,
+          round: attempt.round,
+          mode: attempt.mode,
           pool: attempt.pool,
-          slot: 0,
-          gen: 0,
+          fields: attempt.fields,
+          seats: limits.map((limit) => ({ limit })),
           recipeHash: attempt.recipeHash,
+          skillsRef: null,
           rulesVersion: attempt.rulesVersion,
         },
       },

package/src/test-utils/build-mock-file-item-change.ts

@@ -2,6 +2,8 @@ import type { ItemRow, StoreChange } from '@boxxy/model';
 import { buildMockFactId } from '@boxxy/model/test-utils/build-mock-fact-id';
 
 export function buildMockFileItemChange(item: ItemRow): StoreChange {
+  const { keptSession: _keptSession, ...filed } = item;
+
   return {
     at: item.filedAt,
     writes: [{ op: 'insert', table: 'items', row: item }],
@@ -11,7 +13,7 @@ export function buildMockFileItemChange(item: ItemRow): StoreChange {
         type: 'boxxy.item.filed',
         entity: `boxxy:item:${item.id}`,
         actor: 'boxxy:owner:local',
-        payload: item,
+        payload: filed,
       },
     ],
   };

package/src/test-utils/build-mock-new-id.ts

@@ -0,0 +1,12 @@
+import type { NewId } from '@boxxy/model';
+
+// A new-ID source that gives version 7 UUIDs in order: 1, 2, 3, … in the last group.
+export function buildMockNewId(): NewId {
+  let count = 0;
+
+  return () => {
+    count += 1;
+
+    return `0190a6f4-0000-7000-8000-${String(count).padStart(12, '0')}`;
+  };
+}

package/src/test-utils/build-mock-note-change.ts

@@ -0,0 +1,18 @@
+import type { NoteRow, StoreChange } from '@boxxy/model';
+import { buildMockFactId } from '@boxxy/model/test-utils/build-mock-fact-id';
+
+export function buildMockNoteChange(note: NoteRow): StoreChange {
+  return {
+    at: note.at,
+    writes: [{ op: 'insert', table: 'notes', row: note }],
+    facts: [
+      {
+        id: buildMockFactId(),
+        type: 'boxxy.item.noted',
+        entity: `boxxy:item:${note.item}`,
+        actor: note.by,
+        payload: { seq: note.seq, text: note.text },
+      },
+    ],
+  };
+}

package/src/test-utils/build-mock-pause-change.ts

@@ -1,7 +1,7 @@
 import { brandSchemas } from '@boxxy/model';
 import type { RunnerId, StoreChange } from '@boxxy/model';
-import { buildMockFactId } from '@boxxy/model/test-utils/build-mock-fact-id';
 
+// The fact catalog has no runner fact, so the pause writes the row and no fact.
 export function buildMockPauseChange(runner: RunnerId): StoreChange {
   return {
     at: brandSchemas.instant.parse(1500),
@@ -14,14 +14,6 @@ export function buildMockPauseChange(runner: RunnerId): StoreChange {
         set: { paused: true },
       },
     ],
-    facts: [
-      {
-        id: buildMockFactId(),
-        type: 'boxxy.runner.paused',
-        entity: `boxxy:runner:${runner}`,
-        actor: 'boxxy:owner:local',
-        payload: { runner },
-      },
-    ],
+    facts: [],
   };
 }

package/src/test-utils/build-mock-pull-request-change.ts

@@ -1,23 +1,26 @@
 import { brandSchemas } from '@boxxy/model';
 import type { AttemptRow, PullRequestRow, StoreChange } from '@boxxy/model';
 import { buildMockFactId } from '@boxxy/model/test-utils/build-mock-fact-id';
-import { buildMockPullRequestRow } from '@boxxy/model/test-utils/build-mock-pull-request-row';
+import { buildMockV1PullRequestRow } from '@boxxy/model/test-utils/build-mock-v1-pull-request-row';
 
 interface PullRequestInput {
   readonly attempt: AttemptRow;
   readonly state: PullRequestRow['state'];
+  readonly number?: number;
 }
 
+// The hook links a pull request of `acme/lamps` to the attempt, with its evidence row.
 export function buildMockPullRequestChange(input: PullRequestInput): StoreChange {
   const attempt = input.attempt;
   const linkedAt = brandSchemas.instant.parse(4000);
   const factId = buildMockFactId();
-  const url = 'https://github.com/acme/lamps/pull/7';
+  const number = input.number ?? 7;
 
-  const pullRequest = buildMockPullRequestRow({
+  const pullRequest = buildMockV1PullRequestRow({
     repo: brandSchemas.repoName.parse('acme/lamps'),
-    number: 7,
+    number,
     attempt: attempt.id,
+    githubId: 2_000_000 + number,
     state: input.state,
     checkedAt: linkedAt,
   });
@@ -32,8 +35,8 @@ export function buildMockPullRequestChange(input: PullRequestInput): StoreChange
         row: {
           factId,
           attempt: attempt.id,
-          kind: 'pr',
-          ref: url,
+          kind: 'pull_request',
+          ref: pullRequest.url,
           observed: null,
           source: 'hook',
           at: linkedAt,
@@ -43,10 +46,17 @@ export function buildMockPullRequestChange(input: PullRequestInput): StoreChange
     facts: [
       {
         id: factId,
-        type: 'boxxy.evidence.pr_linked',
-        entity: `boxxy:attempt:${attempt.id}`,
+        type: 'boxxy.pull_request.linked',
+        entity: `boxxy:item:${attempt.item}`,
         actor: `boxxy:hook:${attempt.id}`,
-        payload: { repo: pullRequest.repo, number: 7, url },
+        payload: {
+          attempt: attempt.id,
+          repo: pullRequest.repo,
+          number,
+          url: pullRequest.url,
+          pullRequestId: String(pullRequest.githubId),
+          source: 'hook',
+        },
       },
     ],
   };

package/src/test-utils/{build-mock-link-change.ts → build-mock-relation-change.ts}

@@ -2,13 +2,13 @@ import { brandSchemas } from '@boxxy/model';
 import type { ItemId, StoreChange } from '@boxxy/model';
 import { buildMockFactId } from '@boxxy/model/test-utils/build-mock-fact-id';
 
-interface LinkInput {
+interface RelationInput {
   readonly source: ItemId;
   readonly target: ItemId;
 }
 
-export function buildMockLinkChange(input: LinkInput): StoreChange {
-  const type = brandSchemas.linkTypeName.parse('blocks');
+export function buildMockRelationChange(input: RelationInput): StoreChange {
+  const type = brandSchemas.relationTypeName.parse('blocks');
   const addedAt = brandSchemas.instant.parse(3500);
 
   return {
@@ -16,7 +16,7 @@ export function buildMockLinkChange(input: LinkInput): StoreChange {
     writes: [
       {
         op: 'insert',
-        table: 'links',
+        table: 'relations',
         row: {
           source: input.source,
           target: input.target,
@@ -30,8 +30,8 @@ export function buildMockLinkChange(input: LinkInput): StoreChange {
     facts: [
       {
         id: buildMockFactId(),
-        type: 'boxxy.link.added',
-        entity: `boxxy:link:${input.source}:${type}:${input.target}`,
+        type: 'boxxy.relation.added',
+        entity: `boxxy:item:${input.source}`,
         actor: 'boxxy:owner:local',
         payload: { source: input.source, target: input.target, type },
       },

package/src/test-utils/build-mock-running-reading.ts

@@ -0,0 +1,19 @@
+import type { SessionReading } from '@boxxy/model';
+import { brandSchemas } from '@boxxy/model';
+
+type RunningReading = Extract<SessionReading, { kind: 'running' }>;
+
+// A working session with an agent session ID, no caller and no usage limit, active at time 0.
+export function buildMockRunningReading(overrides: Partial<RunningReading> = {}): RunningReading {
+  return {
+    kind: 'running',
+    atcSession: brandSchemas.atcSessionId.parse('atc-1'),
+    agentSession: brandSchemas.agentSessionId.parse('agent-1'),
+    caller: null,
+    attention: 'working',
+    lastActivityAt: brandSchemas.instant.parse(0),
+    lastOwnerAt: brandSchemas.instant.parse(0),
+    usageLimitResetsAt: null,
+    ...overrides,
+  };
+}

package/src/test-utils/build-mock-settle-change.ts

@@ -3,15 +3,18 @@ import type { AttemptRow, StoreChange } from '@boxxy/model';
 import { buildMockFactId } from '@boxxy/model/test-utils/build-mock-fact-id';
 
 interface SettleInput {
-  // the attempt as claimed, with the slot and slot gen its take got
   readonly attempt: AttemptRow;
   readonly state: 'succeeded' | 'failed';
 }
 
+// A settle under the live lease and hold generations: it releases the lease and the seats. A
+// succeeded attempt ends `built`; a failed one ends `lost` with `closeout-missing`.
 export function buildMockSettleChange(input: SettleInput): StoreChange {
   const attempt = input.attempt;
   const endedAt = brandSchemas.instant.parse(3000);
-  const failure = input.state === 'failed' ? 'closeout-missing' : null;
+  const isSucceeded = input.state === 'succeeded';
+  const failure = isSucceeded ? null : 'closeout-missing';
+  const outcome = isSucceeded ? brandSchemas.outcomeName.parse('built') : 'lost';
 
   return {
     at: endedAt,
@@ -19,7 +22,7 @@ export function buildMockSettleChange(input: SettleInput): StoreChange {
       item: attempt.item,
       phase: attempt.phase,
       gen: attempt.leaseGen,
-      slot: { pool: attempt.pool, slot: attempt.slot, gen: attempt.slotGen },
+      holdGen: attempt.holdGen,
     },
     writes: [
       {
@@ -27,7 +30,7 @@ export function buildMockSettleChange(input: SettleInput): StoreChange {
         table: 'attempts',
         key: { id: attempt.id },
         expect: { state: attempt.state },
-        set: { state: input.state, failure, endedAt },
+        set: { state: input.state, failure, outcome, endedAt },
       },
       {
         op: 'update',
@@ -36,21 +39,30 @@ export function buildMockSettleChange(input: SettleInput): StoreChange {
         expect: { releasedAt: null },
         set: { releasedAt: endedAt },
       },
-      { op: 'release-slot', pool: attempt.pool, slot: attempt.slot, holder: attempt.id },
+      { op: 'release-seats', release: { attempt: attempt.id, holdGen: attempt.holdGen } },
     ],
     facts: [
       {
         id: buildMockFactId(),
         type: 'boxxy.attempt.settled',
-        entity: `boxxy:attempt:${attempt.id}`,
+        entity: `boxxy:item:${attempt.item}`,
         actor: `boxxy:runner:${attempt.runner}`,
         payload: {
+          attempt: attempt.id,
+          phase: attempt.phase,
+          round: attempt.round,
           state: input.state,
           failure,
+          outcome,
+          returnedOutcome: null,
+          closing: null,
+          asleep: false,
+          sessionStopped: true,
           endedAt,
           criteria: [],
           matched: [],
           frictionDropped: 0,
+          skippedEffects: [],
         },
       },
     ],

package/src/test-utils/build-mock-start-change.ts

@@ -1,11 +1,18 @@
 import { brandSchemas } from '@boxxy/model';
-import type { AttemptRow, StoreChange } from '@boxxy/model';
+import type { AttemptRow, CallerIdentity, StoreChange } from '@boxxy/model';
 import { buildMockFactId } from '@boxxy/model/test-utils/build-mock-fact-id';
+import invariant from 'tiny-invariant';
 
-export function buildMockStartChange(attempt: AttemptRow): StoreChange {
-  const atcSession = brandSchemas.atcSessionId.parse('atc-session-1');
+// The start of a `starting` attempt on its own atc session, with the caller the worker reported.
+export function buildMockStartChange(
+  attempt: AttemptRow,
+  caller: CallerIdentity | null = null,
+): StoreChange {
+  const atcSession = attempt.atcSession;
   const startedAt = brandSchemas.instant.parse(2500);
 
+  invariant(atcSession !== null, 'a started attempt names its atc session');
+
   return {
     at: startedAt,
     under: { item: attempt.item, phase: attempt.phase, gen: attempt.leaseGen },
@@ -15,16 +22,16 @@ export function buildMockStartChange(attempt: AttemptRow): StoreChange {
         table: 'attempts',
         key: { id: attempt.id },
         expect: { state: 'starting' },
-        set: { state: 'running', atcSession, startedAt },
+        set: { state: 'running', atcSession, caller, startedAt },
       },
     ],
     facts: [
       {
         id: buildMockFactId(),
         type: 'boxxy.attempt.started',
-        entity: `boxxy:attempt:${attempt.id}`,
+        entity: `boxxy:item:${attempt.item}`,
         actor: `boxxy:runner:${attempt.runner}`,
-        payload: { atcSession },
+        payload: { attempt: attempt.id, atcSession, resumeFallback: false, caller },
       },
     ],
   };