@bluewombat/conductor 0.9.0 → 0.10.0

package/dist/run/open-conductor.d.ts

@@ -1,6 +1,8 @@
 import type { CommandResult, WorkLedger } from "@bluewombat/work-ledger";
 import type { AuthorityPort, TransformerPort } from "../transformers/port.js";
-export type ConductorRefusalCode = "stable-missing" | "root-invalid" | "persist-failed" | "interrupted" | "isolate-failed" | "warm-failed" | "align-conflict" | "transformer-invalid" | "unavailable" | "not-found" | "point-of-no-return" | "project-busy" | "illegal-transition";
+import type { ProjectRunResult } from "./results.js";
+export type { ConductorRefusalCode, ProjectRunResult } from "./results.js";
+export { foldMessageOf, subjectOf } from "./subject.js";
 /** Prepare a Ticket workspace after Isolation — install deps, and so on. */
 export type WarmOutcome = "warmed" | "failed" | "interrupted" | "invalid-invocation";
 export type WarmPort = {
@@ -11,20 +13,18 @@ export type WarmPort = {
         outcome: WarmOutcome;
     }>;
 };
-export type ProjectRunResult = {
-    outcome: "idle";
-} | {
-    outcome: "done";
-    key: string;
-} | {
-    outcome: "escalated";
-    key: string;
-} | {
-    outcome: "paused";
-    key?: string;
-} | {
-    outcome: "refused";
-    code: ConductorRefusalCode;
+/**
+ * Bring the shared copy of the work line up to what the Authority holds, for
+ * the line `target` names. Conductor asks right before it reads the copy, so a
+ * ticket always starts from, and aligns with, the line as it is now.
+ */
+export type LinePort = {
+    refresh(target: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        detail?: string;
+    }>;
 };
 export type OpenConductorOptions = {
     ledger: WorkLedger;
@@ -32,6 +32,18 @@ export type OpenConductorOptions = {
     workLineStable: string;
     workspaceRoot: string;
     transformerDurationMs?: number;
+    /**
+     * How many Tickets of a Project may be active at once. Default 1.
+     *
+     * Above 1 the Project needs an Authority: a Ticket folded straight into the
+     * work line would move it under the others with nobody to send them back.
+     */
+    maxParallel?: number;
+    /**
+     * Keeps the shared copy of the work line current. Absent: it is whatever its
+     * owner left, as before.
+     */
+    line?: LinePort;
     /**
      * The outside judge of a Submission. Absent: an assembled ticket is folded
      * into the work line directly, with nobody else asked.
@@ -44,17 +56,24 @@ export type OpenConductorOptions = {
     /**
      * Whether a local judge decides if the assembled ticket meets the
      * intention, before any Submission exists — or, without an Authority,
-     * before the final fold. Absent or `false`: `assembly.validate` is not
+     * before the final fold. Absent or `false`: `validate` is not
      * declared, and `integrating` goes straight to offer (or the local judge on
      * `produce: false`).
      */
-    assemblyValidate?: boolean;
+    validate?: boolean;
     /**
-     * Whether `assembly.fix` is declared. A validate refusal with nothing to
+     * Whether the tests of a Task are written before its code. Then a pass of its
+     * own runs in the Ticket's workspace first, and what it wrote is committed as a
+     * checkpoint, so the producer's work is what comes after it. Absent or `false`:
+     * the producer makes the code and the tests together, as before.
+     */
+    tests?: boolean;
+    /**
+     * Whether a fix is declared. A validate refusal with nothing to
      * repair it escalates on the spot rather than spending the budget on a round
      * that can only repeat the same refusal.
      */
-    assemblyFixDeclared?: boolean;
+    fixDeclared?: boolean;
     /**
      * Told at the moments a pass changes what an outsider would want to know:
      * the work is submitted. Awaited,
@@ -83,6 +102,19 @@ export type Conductor = {
     pause(): void;
     resume(): void;
     runProject(project: string): Promise<ProjectRunResult>;
+    /**
+     * Take the next Ticket of the Project that may start, within its parallel
+     * limit. Nothing is run. Absent when none may: the Project is full, or
+     * nothing is ready or unblocked.
+     */
+    claimNext(project: string): Promise<{
+        key: string;
+    } | undefined>;
+    /**
+     * Drive one Ticket the Project already holds, as far as it goes. Unlike
+     * `runProject` it neither claims nor reconciles, so several can run at once.
+     */
+    runTicket(key: string): Promise<ProjectRunResult>;
     cancel(key: string): Promise<CommandResult>;
     /**
      * Drop a held unit without waiting for the bail clock.
@@ -90,16 +122,5 @@ export type Conductor = {
      */
     release(key: string): Promise<CommandResult>;
 };
-/**
- * A fold's subject out of prose. Text written the way a commit is — a headline,
- * a blank line, the rest — gives its headline. Otherwise the first sentence,
- * cut at a word when even that runs past what one line of history shows. A
- * subject is not markdown, so the backticks prose uses for names come off; and
- * it ends on a word, not on an ellipsis — the whole text follows in the body
- * for whoever wants it.
- */
-export declare function subjectOf(text: string): string;
-/** Subject line, then the whole text when the subject did not carry it all. */
-export declare function foldMessageOf(text: string): string;
 export declare function openConductor(options: OpenConductorOptions): Conductor;
 //# sourceMappingURL=open-conductor.d.ts.map

package/dist/run/open-conductor.d.ts.map

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