@llm4ts/flow 2.8.0 → 2.9.0

package/dist/RosterSeats.d.ts

@@ -0,0 +1,71 @@
+import * as Effect from "effect/Effect";
+import * as Scope from "effect/Scope";
+import type { LlmServiceShape } from "@llm4ts/core/LlmService";
+import { type ConnectorCapabilities } from "@llm4ts/core/Models";
+import { type FlowError } from "./FlowError.ts";
+import { type FlowEventsShape } from "./FlowEvents.ts";
+import { type ExecutorSpec, type Role, type RosterShape } from "./Roster.ts";
+/** An executor's connector, as the runner resolved it for a role and a directory. */
+export type RosterSeat = LlmServiceShape & {
+    readonly capabilities: ConnectorCapabilities;
+};
+export interface SeatSource {
+    readonly seatFor: (executor: ExecutorSpec, role: Role, workDir: string) => Effect.Effect<RosterSeat, FlowError>;
+}
+/** What a flow context knows about the roster behind its seats. */
+export interface RosterView {
+    /** A seat for `role`, leased per call (independent of this context's coder where possible). */
+    readonly forRole: (role: Role) => LlmServiceShape;
+    /** Free slots for `role` right now. */
+    readonly available: (role: Role) => Effect.Effect<number>;
+    /** Configured slots for `role`. */
+    readonly slots: (role: Role) => number;
+    /** The executor holding this context's coder, once leased. */
+    readonly executor: Effect.Effect<string | undefined>;
+    /** Every executor that held this context's coder, in order (handovers). */
+    readonly history: Effect.Effect<ReadonlyArray<string>>;
+}
+export interface RosterSeatOptions {
+    readonly events: FlowEventsShape;
+    /** Executors this seat must not use: the context's coder, for independence. */
+    readonly avoid?: Effect.Effect<ReadonlyArray<string>>;
+    /** Used without a slot when nobody outside `avoid` can ever serve the role. */
+    readonly borrow?: Effect.Effect<ExecutorSpec | undefined>;
+    /** Who is asking, for the events. */
+    readonly label?: string;
+}
+/**
+ * A seat for `role` that leases an executor for each call and releases it
+ * when the call (or its stream) ends. A failure is reported to the roster,
+ * which excludes the executor when the failure says it is out of quota or
+ * down; the call itself still fails — a per-call seat has nothing to hand
+ * over, and the retry layer below has already had its turn.
+ */
+export declare const rosterSeat: (roster: RosterShape, source: SeatSource, role: Role, workDir: string, options: RosterSeatOptions) => LlmServiceShape;
+export interface HeldCoderOptions {
+    readonly events: FlowEventsShape;
+    /** Lease now (a story waiting for capacity), or on the first call (a flow's root coder). */
+    readonly eager: boolean;
+    /** The executor this context held before, taken first while free. */
+    readonly prefer?: string;
+    /** Handovers before a failure surfaces. Default 2. */
+    readonly maxHandovers?: number;
+    readonly label?: string;
+}
+export interface HeldCoder {
+    readonly service: LlmServiceShape;
+    readonly executor: Effect.Effect<string | undefined>;
+    readonly lease: Effect.Effect<ExecutorSpec | undefined>;
+    readonly history: Effect.Effect<ReadonlyArray<string>>;
+}
+export declare const takeoverNote: (from: string, reason: string) => string;
+/**
+ * The coder of one context (a story, or a flow's root): one executor held
+ * for the context's lifetime. When a call fails in a way that takes that
+ * executor out of the round (a usage limit, a dead serving engine), the
+ * lease is released, the next coder leased, and the call repeated there
+ * with a takeover note — the chat history the flow replays, the task
+ * checkpoint and the working tree carry the work across.
+ */
+export declare const makeHeldCoder: (roster: RosterShape, source: SeatSource, workDir: string, options: HeldCoderOptions) => Effect.Effect<HeldCoder, import("./FlowError.ts").PersistenceError | import("./FlowError.ts").PlanParseError | import("./FlowError.ts").UnsupportedSchemaVersion | import("./FlowError.ts").WorkspacePathError | import("./FlowError.ts").WorkspaceLimitError | import("./FlowError.ts").WorkspaceIoError | import("./FlowError.ts").FlowAborted | import("./FlowError.ts").ProcessError | import("./FlowError.ts").FlowLlmError | import("./FlowError.ts").FlowCapabilityDenied | import("./FlowError.ts").ColumnNotFound | import("./FlowError.ts").BudgetExceeded | import("./FlowError.ts").StoryPlanInvalid | import("./FlowError.ts").PerimeterViolation | import("./FlowError.ts").MissingDependency | import("./FlowError.ts").MergeConflict | import("./FlowError.ts").EpicCheckoutDirty | import("./FlowError.ts").RosterInvalid | import("./FlowError.ts").RosterExhausted | import("./FlowError.ts").StoryFailed | import("./FlowError.ts").DecisionsInvalid | import("./FlowError.ts").OpenPointsPending | import("./FlowError.ts").ContractConflict, Scope.Scope>;
+//# sourceMappingURL=RosterSeats.d.ts.map

package/dist/RosterSeats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RosterSeats.d.ts","sourceRoot":"","sources":["../src/RosterSeats.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAIrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAW,KAAK,qBAAqB,EAAiB,MAAM,qBAAqB,CAAA;AACxF,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAQ,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EAGL,KAAK,YAAY,EAEjB,KAAK,IAAI,EACT,KAAK,WAAW,EACjB,MAAM,aAAa,CAAA;AAEpB,qFAAqF;AACrF,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAA;CAAE,CAAA;AAE3F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,CAChB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;CAC1C;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,eAAe,CAAA;IACjD,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACzD,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAA;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACpD,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;CACvD;AAwDD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;IACrD,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,CAAA;IACzD,qCAAqC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,WAAW,EACnB,QAAQ,UAAU,EAClB,MAAM,IAAI,EACV,SAAS,MAAM,EACf,SAAS,iBAAiB,KACzB,eA8CF,CAAA;AAID,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,sDAAsD;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,CAAA;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;CACvD;AAED,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,MAK/C,CAAA;AAOb;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,0mCA2FxB,CAAA"}

package/dist/RosterSeats.js

@@ -0,0 +1,144 @@
+// Seats over the executor roster (ADR 0019). A flow keeps calling an
+// `LlmServiceShape`; behind it, a reasoning seat leases an executor for each
+// call, and a coder seat holds one executor for its context and hands over
+// to the next when that one is taken out of the round. The runner supplies
+// `seatFor`, which turns an executor into a connector rooted in a directory.
+import * as Effect from "effect/Effect";
+import * as Ref from "effect/Ref";
+import * as Scope from "effect/Scope";
+import * as Semaphore from "effect/Semaphore";
+import * as Stream from "effect/Stream";
+import { ConfigError } from "@llm4ts/core/Errors";
+import { Message } from "@llm4ts/core/Models";
+import { describeFlowError } from "./FlowError.js";
+import { Info } from "./FlowEvents.js";
+import { describeExclusion, hasRole } from "./Roster.js";
+/** A roster failure seen through an `LlmServiceShape`, whose failures are `LlmError`s. */
+const asLlmError = (error) => ConfigError.make({ message: describeFlowError(error) });
+const say = (events, message) => events.publish(Info.make({ message: `roster: ${message}` }));
+const withNote = (note, prompt) => note === undefined ? prompt : `${note}\n\n${prompt}`;
+const withNoteOnLast = (note, messages) => {
+    const last = messages.at(-1);
+    if (note === undefined || last === undefined) {
+        return messages;
+    }
+    return [
+        ...messages.slice(0, -1),
+        Message.make({ ...last, content: withNote(note, last.content) })
+    ];
+};
+const serviceOver = (runner) => ({
+    executeStream: (prompt) => runner.stream((seat, note) => seat.executeStream(withNote(note, prompt))),
+    executeStreamWithHistory: (messages) => runner.stream((seat, note) => seat.executeStreamWithHistory(withNoteOnLast(note, messages))),
+    executeWithTools: (prompt, tools) => runner.run((seat, note) => seat.executeWithTools(withNote(note, prompt), tools)),
+    executeStructured: (prompt, schema, jsonSchema) => runner.run((seat, note) => seat.executeStructured(withNote(note, prompt), schema, jsonSchema)),
+    executeStructuredWithUsage: (prompt, schema, jsonSchema) => runner.run((seat, note) => seat.executeStructuredWithUsage(withNote(note, prompt), schema, jsonSchema)),
+    scoreLabels: (prompt, labels) => runner.run((seat) => seat.scoreLabels(prompt, labels)),
+    isAvailable: runner.isAvailable
+});
+/**
+ * A seat for `role` that leases an executor for each call and releases it
+ * when the call (or its stream) ends. A failure is reported to the roster,
+ * which excludes the executor when the failure says it is out of quota or
+ * down; the call itself still fails — a per-call seat has nothing to hand
+ * over, and the retry layer below has already had its turn.
+ */
+export const rosterSeat = (roster, source, role, workDir, options) => {
+    const acquire = Effect.gen(function* () {
+        const avoid = options.avoid === undefined ? [] : yield* options.avoid;
+        if (avoid.length > 0 && !(yield* roster.canEverServe(role, avoid))) {
+            const borrowed = options.borrow === undefined ? undefined : yield* options.borrow;
+            if (borrowed !== undefined && hasRole(borrowed, role)) {
+                yield* say(options.events, `${borrowed.id} takes ${role}${options.label === undefined ? "" : ` for ${options.label}`} on its own coder's slot — not independent (no other executor can take ${role})`);
+                return borrowed;
+            }
+        }
+        const lease = yield* roster
+            .lease(role, { avoid, ...(options.label === undefined ? {} : { label: options.label }) })
+            .pipe(Effect.mapError(asLlmError));
+        return lease.executor;
+    });
+    const seatOf = (executor) => source.seatFor(executor, role, workDir).pipe(Effect.mapError(asLlmError));
+    const reportOn = (executor) => (error) => Effect.asVoid(roster.report(executor.id, error));
+    return serviceOver({
+        run: (use) => Effect.scoped(Effect.gen(function* () {
+            const executor = yield* acquire;
+            const seat = yield* seatOf(executor);
+            return yield* use(seat, undefined).pipe(Effect.tapError(reportOn(executor)));
+        })),
+        stream: (use) => Stream.unwrap(Effect.gen(function* () {
+            const executor = yield* acquire;
+            const seat = yield* seatOf(executor);
+            return use(seat, undefined).pipe(Stream.tapError(reportOn(executor)));
+        })),
+        isAvailable: roster.canEverServe(role)
+    });
+};
+export const takeoverNote = (from, reason) => [
+    `(You are taking over this work from another coding agent ('${from}'), which had to stop:`,
+    `${reason}. Its changes so far are in the working tree: inspect them (git status, git diff)`,
+    "before continuing, and carry on from there.)"
+].join(" ");
+/**
+ * The coder of one context (a story, or a flow's root): one executor held
+ * for the context's lifetime. When a call fails in a way that takes that
+ * executor out of the round (a usage limit, a dead serving engine), the
+ * lease is released, the next coder leased, and the call repeated there
+ * with a takeover note — the chat history the flow replays, the task
+ * checkpoint and the working tree carry the work across.
+ */
+export const makeHeldCoder = Effect.fn("@llm4ts/flow/RosterSeats.heldCoder")(function* (roster, source, workDir, options) {
+    const scope = yield* Effect.scope;
+    const current = yield* Ref.make(undefined);
+    const history = yield* Ref.make([]);
+    const handovers = yield* Ref.make(0);
+    const prefer = yield* Ref.make(options.prefer);
+    const gate = yield* Semaphore.make(1);
+    const maxHandovers = options.maxHandovers ?? 2;
+    const acquire = gate.withPermit(Effect.gen(function* () {
+        const held = yield* Ref.get(current);
+        if (held !== undefined) {
+            return held;
+        }
+        const preferred = yield* Ref.get(prefer);
+        const lease = yield* roster
+            .lease("coder", {
+            ...(preferred === undefined ? {} : { prefer: preferred }),
+            ...(options.label === undefined ? {} : { label: options.label })
+        })
+            .pipe(Scope.provide(scope));
+        const seat = yield* source.seatFor(lease.executor, "coder", workDir);
+        const next = { lease, seat };
+        yield* Ref.set(current, next);
+        yield* Ref.update(history, (ids) => ids.at(-1) === lease.executor.id ? ids : [...ids, lease.executor.id]);
+        return next;
+    }));
+    if (options.eager) {
+        yield* acquire;
+    }
+    /** Decides whether a failure hands over; returns the takeover note, or fails with the error. */
+    const handover = (held, error) => Effect.gen(function* () {
+        const exclusion = yield* roster.report(held.lease.executor.id, error);
+        if (exclusion === undefined || (yield* Ref.get(handovers)) >= maxHandovers) {
+            return yield* Effect.fail(error);
+        }
+        yield* Ref.update(handovers, (count) => count + 1);
+        yield* Ref.set(prefer, undefined);
+        yield* held.lease.release;
+        yield* Ref.set(current, undefined);
+        yield* say(options.events, `${options.label ?? workDir}: handing the coder over from ${held.lease.executor.id} (${describeExclusion(exclusion)})`);
+        return takeoverNote(held.lease.executor.id, exclusion.reason);
+    });
+    const run = (use, note) => Effect.gen(function* () {
+        const held = yield* acquire.pipe(Effect.mapError(asLlmError));
+        return yield* use(held.seat, note).pipe(Effect.catch((error) => Effect.flatMap(handover(held, error), (next) => run(use, next))));
+    });
+    const stream = (use, note) => Stream.unwrap(Effect.map(acquire.pipe(Effect.mapError(asLlmError)), (held) => use(held.seat, note).pipe(Stream.catchIf(() => true, (error) => Stream.unwrap(Effect.map(handover(held, error), (next) => stream(use, next)))))));
+    return {
+        service: serviceOver({ run, stream, isAvailable: roster.canEverServe("coder") }),
+        executor: Effect.map(Ref.get(current), (held) => held?.lease.executor.id),
+        lease: Effect.map(Ref.get(current), (held) => held?.lease.executor),
+        history: Ref.get(history)
+    };
+});
+//# sourceMappingURL=RosterSeats.js.map

package/dist/RosterSeats.js.map

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

package/dist/Stories.d.ts

@@ -5,7 +5,7 @@ import type * as Scope from "effect/Scope";
 import type { LlmServiceShape } from "@llm4ts/core/LlmService";
 import type { TokenUsage } from "@llm4ts/core/Models";
 import { type BoardSyncShape } from "./BoardSync.ts";
-import type { FlowContextShape } from "./FlowContext.ts";
+import type { ContextOptions, FlowContextShape } from "./FlowContext.ts";
 import { EpicCheckoutDirty, MissingDependency, PerimeterViolation, StoryFailed, type FlowError } from "./FlowError.ts";
 import { type PlainFileStoreShape } from "./Persistence.ts";
 import { Plan } from "./Plan.ts";
@@ -28,6 +28,8 @@ declare const StoryState_base: Schema.Class<StoryState, Schema.Struct<{
     readonly branch: Schema.String;
     readonly worktree: Schema.String;
     readonly status: Schema.Literals<readonly ["started", "merged", "failed"]>;
+    /** The roster executor that last held the story's coder (ADR 0019); preferred on resume. */
+    readonly executor: Schema.optionalKey<Schema.String>;
 }>, {}>;
 /** What the executor remembers about a story between runs. */
 export declare class StoryState extends StoryState_base {
@@ -44,6 +46,8 @@ declare const StoryOutcome_base: Schema.Class<StoryOutcome, Schema.Struct<{
     /** Failure reason, or what a waiting story waits for. */
     readonly reason: Schema.optionalKey<Schema.String>;
     readonly judge: Schema.optionalKey<Schema.String>;
+    /** The roster executor(s) that coded the story, in order ("codex → claude"). */
+    readonly executor: Schema.optionalKey<Schema.String>;
     /** ESTIMATES, never measurements (ADR 0012). */
     readonly estimatedTokens: Schema.optionalKey<Schema.Int>;
     readonly estimatedCostUsd: Schema.optionalKey<Schema.Number>;
@@ -122,7 +126,7 @@ export interface StoriesOptions {
     /** Default `epic/<epicId>`. */
     readonly epicBranch?: string;
     /** Seats rooted in a worktree; the executor never resolves seats itself. */
-    readonly contextFor: (workDir: string) => Effect.Effect<StorySeats, FlowError, Scope.Scope>;
+    readonly contextFor: (workDir: string, options?: ContextOptions) => Effect.Effect<StorySeats, FlowError, Scope.Scope>;
     readonly board: BoardSyncShape;
     /**
      * Prepares a worktree before its coder runs — a fresh checkout has no
@@ -133,7 +137,7 @@ export interface StoriesOptions {
     /** The target's gates, run in a worktree per task and on the epic checkout after each merge. */
     readonly gates: (workDir: string) => Effect.Effect<ReviewResult, FlowError>;
     /** Story-level judge over the branch's diff against the epic branch; omit to skip. */
-    readonly judge?: (story: Story, diff: string) => Effect.Effect<ReviewResult, FlowError>;
+    readonly judge?: (story: Story, diff: string, seats: StorySeats) => Effect.Effect<ReviewResult, FlowError>;
     /** Judge attempts, each but the last followed by one coder feedback round. Default 2. */
     readonly judgeRounds?: number;
     /** Extra system context per story (house rules, shared read-only excerpts). */
@@ -151,7 +155,7 @@ export interface StoriesOptions {
      * story owns, or a parallel story's). `real: false` sends the coder back
      * once with the reason. Omit to accept every such claim.
      */
-    readonly verifyBlocked?: (story: Story, need: string, workDir: string) => Effect.Effect<BlockedVerdict, FlowError>;
+    readonly verifyBlocked?: (story: Story, need: string, workDir: string, seats: StorySeats) => Effect.Effect<BlockedVerdict, FlowError>;
     /**
      * Waits until a serving engine that went down (`isOutageMessage`) is back;
      * the story it interrupted is then retried once. Omit, or fail it, and the
@@ -159,6 +163,6 @@ export interface StoriesOptions {
      */
     readonly awaitRecovery?: (reason: string) => Effect.Effect<void, FlowError>;
 }
-export declare const implementStoriesFlow: (context: FlowContextShape, options: StoriesOptions) => Effect.Effect<EpicReport, import("./FlowError.ts").PersistenceError | import("./FlowError.ts").PlanParseError | import("./FlowError.ts").UnsupportedSchemaVersion | import("./FlowError.ts").WorkspacePathError | import("./FlowError.ts").WorkspaceLimitError | import("./FlowError.ts").WorkspaceIoError | import("./FlowError.ts").FlowAborted | import("./FlowError.ts").ProcessError | import("./FlowError.ts").FlowLlmError | import("./FlowError.ts").FlowCapabilityDenied | import("./FlowError.ts").ColumnNotFound | import("./FlowError.ts").BudgetExceeded | import("./FlowError.ts").StoryPlanInvalid | PerimeterViolation | MissingDependency | import("./FlowError.ts").MergeConflict | EpicCheckoutDirty | StoryFailed | import("./FlowError.ts").DecisionsInvalid | import("./FlowError.ts").OpenPointsPending | import("./FlowError.ts").ContractConflict, never>;
+export declare const implementStoriesFlow: (context: FlowContextShape, options: StoriesOptions) => Effect.Effect<EpicReport, import("./FlowError.ts").PersistenceError | import("./FlowError.ts").PlanParseError | import("./FlowError.ts").UnsupportedSchemaVersion | import("./FlowError.ts").WorkspacePathError | import("./FlowError.ts").WorkspaceLimitError | import("./FlowError.ts").WorkspaceIoError | import("./FlowError.ts").FlowAborted | import("./FlowError.ts").ProcessError | import("./FlowError.ts").FlowLlmError | import("./FlowError.ts").FlowCapabilityDenied | import("./FlowError.ts").ColumnNotFound | import("./FlowError.ts").BudgetExceeded | import("./FlowError.ts").StoryPlanInvalid | PerimeterViolation | MissingDependency | import("./FlowError.ts").MergeConflict | EpicCheckoutDirty | import("./FlowError.ts").RosterInvalid | import("./FlowError.ts").RosterExhausted | StoryFailed | import("./FlowError.ts").DecisionsInvalid | import("./FlowError.ts").OpenPointsPending | import("./FlowError.ts").ContractConflict, never>;
 export {};
 //# sourceMappingURL=Stories.d.ts.map

package/dist/Stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Stories.d.ts","sourceRoot":"","sources":["../src/Stories.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Stories.d.ts","sourceRoot":"","sources":["../src/Stories.ts"],"names":[],"mappings":"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"}

package/dist/Stories.js

@@ -14,7 +14,7 @@ import * as Stream from "effect/Stream";
 import { BoardItem } from "./BoardSync.js";
 import { makeChat } from "./Chat.js";
 import { implementPlanFlow } from "./Flow.js";
-import { describeFlowError, EpicCheckoutDirty, MissingDependency, PerimeterViolation, StoryFailed } from "./FlowError.js";
+import { describeFlowError, rosterExhaustedPrefix, EpicCheckoutDirty, MissingDependency, PerimeterViolation, StoryFailed } from "./FlowError.js";
 import { Info } from "./FlowEvents.js";
 import { statusPaths } from "./GitTool.js";
 import { checkPerimeter, enforcePerimeter, isWithinPerimeter, perimeterGate, strayTasks } from "./Perimeter.js";
@@ -36,7 +36,9 @@ export class StoryState extends Schema.Class("StoryState")({
     hash: Schema.String,
     branch: Schema.String,
     worktree: Schema.String,
-    status: StoryStatus
+    status: StoryStatus,
+    /** The roster executor that last held the story's coder (ADR 0019); preferred on resume. */
+    executor: Schema.optionalKey(Schema.String)
 }) {
 }
 export const EpicReportVersion = 1;
@@ -50,6 +52,8 @@ export class StoryOutcome extends Schema.Class("StoryOutcome")({
     /** Failure reason, or what a waiting story waits for. */
     reason: Schema.optionalKey(Schema.String),
     judge: Schema.optionalKey(Schema.String),
+    /** The roster executor(s) that coded the story, in order ("codex → claude"). */
+    executor: Schema.optionalKey(Schema.String),
     /** ESTIMATES, never measurements (ADR 0012). */
     estimatedTokens: Schema.optionalKey(Schema.Int),
     estimatedCostUsd: Schema.optionalKey(Schema.Number)
@@ -93,6 +97,25 @@ export const renderEpicReport = (report) => {
     if (cost.length > 0) {
         lines.push(`- Estimated cost: ${money(cost.reduce((sum, value) => sum + value, 0))}`);
     }
+    const coded = report.stories.filter((story) => story.executor !== undefined);
+    if (coded.length > 0) {
+        // A story is counted for the executor that finished it; a handover chain
+        // is shown in full next to the story.
+        const byExecutor = new Map();
+        for (const story of coded) {
+            const chain = story.executor ?? "";
+            const last = chain.split(" → ").at(-1) ?? chain;
+            const entry = byExecutor.get(last) ?? { stories: [], tokens: 0, cost: 0 };
+            entry.stories.push(chain === last ? story.id : `${story.id} (${chain})`);
+            entry.tokens += story.estimatedTokens ?? 0;
+            entry.cost += story.estimatedCostUsd ?? 0;
+            byExecutor.set(last, entry);
+        }
+        lines.push("", "## By executor", "");
+        for (const [executor, entry] of byExecutor) {
+            lines.push(`- ${executor}: ${entry.stories.join(", ")} — ~${entry.tokens} tokens, ${money(entry.cost)} (estimated)`);
+        }
+    }
     lines.push("");
     return lines.join("\n");
 };
@@ -416,7 +439,15 @@ export const implementStoriesFlow = Effect.fn("@llm4ts/flow/Stories.implement")(
     });
     /** Everything that happens inside a story's worktree: plan, implement, judge, perimeter. */
     const implementStory = Effect.fn("@llm4ts/flow/Stories.implementStory")(function* (story, state) {
-        const seats = yield* options.contextFor(state.worktree);
+        const seats = yield* options.contextFor(state.worktree, {
+            label: `story ${story.id}`,
+            ...(state.executor === undefined ? {} : { prefer: state.executor })
+        });
+        const roster = seats.context.roster;
+        const coderExecutor = roster === undefined ? undefined : yield* roster.executor;
+        if (coderExecutor !== undefined && coderExecutor !== state.executor) {
+            yield* saveVersioned(files, statePath(story), StoryStateVersion, StoryState, StoryState.make({ ...state, executor: coderExecutor }));
+        }
         const blocked = yield* Ref.make(undefined);
         const pushbacks = yield* Ref.make(0);
         const storyContext = {
@@ -474,7 +505,7 @@ export const implementStoriesFlow = Effect.fn("@llm4ts/flow/Stories.implement")(
             let rebuttal = blockedRebuttal(plan, story, need);
             if (rebuttal === undefined && options.verifyBlocked !== undefined) {
                 const verdict = yield* options
-                    .verifyBlocked(story, need, state.worktree)
+                    .verifyBlocked(story, need, state.worktree, watchedSeats)
                     .pipe(Effect.catch(() => Effect.succeed(undefined)));
                 rebuttal = verdict === undefined || verdict.real ? undefined : verdict.reason;
             }
@@ -564,7 +595,7 @@ export const implementStoriesFlow = Effect.fn("@llm4ts/flow/Stories.implement")(
                     // a model asked to score an empty diff scores the prompt instead.
                     return yield* failed(story, "the story branch has no changes against the epic branch");
                 }
-                const verdict = yield* judge(story, diff);
+                const verdict = yield* judge(story, diff, watchedSeats);
                 if (verdict.isClean) {
                     judgeNote = `judge cleared (round ${round})`;
                     break;
@@ -584,7 +615,12 @@ export const implementStoriesFlow = Effect.fn("@llm4ts/flow/Stories.implement")(
         const changed = yield* git.changedFilesVsBase(epicBranch);
         yield* enforcePerimeter(changed, story);
         const totals = seats.totals === undefined ? undefined : yield* seats.totals;
-        return { judge: judgeNote, totals };
+        const history = roster === undefined ? [] : yield* roster.history;
+        return {
+            judge: judgeNote,
+            totals,
+            executor: history.length === 0 ? undefined : history.join(" → ")
+        };
     });
     const runStory = Effect.fn("@llm4ts/flow/Stories.runStory")(function* (story) {
         yield* board.start(story.id);
@@ -601,13 +637,19 @@ export const implementStoriesFlow = Effect.fn("@llm4ts/flow/Stories.implement")(
         }
         const result = yield* Effect.scoped(implementStory(story, state));
         yield* integrate(story, state.branch);
-        yield* saveVersioned(files, statePath(story), StoryStateVersion, StoryState, StoryState.make({ ...state, status: "merged" }));
+        const last = result.executor?.split(" → ").at(-1);
+        yield* saveVersioned(files, statePath(story), StoryStateVersion, StoryState, StoryState.make({
+            ...state,
+            status: "merged",
+            ...(last === undefined ? {} : { executor: last })
+        }));
         return StoryOutcome.make({
             id: story.id,
             title: story.title,
             status: "done",
             branch: state.branch,
             ...(result.judge === undefined ? {} : { judge: result.judge }),
+            ...(result.executor === undefined ? {} : { executor: result.executor }),
             ...(result.totals === undefined ? {} : { estimatedTokens: result.totals.total }),
             ...(result.totals?.costUsd === undefined ? {} : { estimatedCostUsd: result.totals.costUsd })
         });
@@ -620,7 +662,9 @@ export const implementStoriesFlow = Effect.fn("@llm4ts/flow/Stories.implement")(
         if (stored !== undefined && stored.status !== "merged") {
             yield* saveVersioned(files, path, StoryStateVersion, StoryState, StoryState.make({ ...stored, status: "failed" })).pipe(Effect.ignore);
         }
-        const interruption = error._tag === "EpicCheckoutDirty"
+        const interruption = error._tag === "EpicCheckoutDirty" ||
+            error._tag === "RosterExhausted" ||
+            reason.includes(rosterExhaustedPrefix)
             ? "halt"
             : isOutageMessage(reason)
                 ? "outage"
@@ -677,7 +721,14 @@ export const implementStoriesFlow = Effect.fn("@llm4ts/flow/Stories.implement")(
             if (halted === undefined) {
                 const current = yield* progress;
                 const ready = readyStories(plan, current);
-                const slots = concurrency - current.running.size;
+                // With a roster, never launch more stories than there are free
+                // coders; with nothing running, launch one anyway — its lease waits
+                // for the first executor to come back (ADR 0019).
+                const free = context.roster === undefined
+                    ? Number.POSITIVE_INFINITY
+                    : yield* context.roster.available("coder");
+                const budget = Math.min(concurrency - current.running.size, free);
+                const slots = current.running.size === 0 && ready.length > 0 ? Math.max(1, budget) : budget;
                 for (const story of ready.slice(0, Math.max(0, slots))) {
                     yield* Ref.update(running, (set) => new Set([...set, story.id]));
                     yield* Effect.forkScoped(attempt(story).pipe(Effect.flatMap((completion) => Queue.offer(completions, completion))));
@@ -718,7 +769,16 @@ export const implementStoriesFlow = Effect.fn("@llm4ts/flow/Stories.implement")(
             if (outcome.status === "done") {
                 yield* board.complete(outcome.id, {
                     ...(outcome.branch === undefined ? {} : { branch: outcome.branch }),
-                    ...(outcome.judge === undefined ? {} : { detail: outcome.judge }),
+                    ...(outcome.judge === undefined && outcome.executor === undefined
+                        ? {}
+                        : {
+                            detail: [
+                                outcome.judge,
+                                outcome.executor === undefined ? undefined : `coder ${outcome.executor}`
+                            ]
+                                .filter((part) => part !== undefined)
+                                .join(" · ")
+                        }),
                     ...(outcome.estimatedTokens === undefined
                         ? {}
                         : { estimatedTokens: outcome.estimatedTokens }),