@bluewombat/conductor 0.8.0 → 0.9.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.
- package/README.md +3 -3
- package/SPECS.md +128 -146
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/run/open-conductor.d.ts +12 -21
- package/dist/run/open-conductor.d.ts.map +1 -1
- package/dist/run/open-conductor.js +128 -259
- package/dist/run/open-conductor.js.map +1 -1
- package/dist/run/paths.d.ts +1 -2
- package/dist/run/paths.d.ts.map +1 -1
- package/dist/run/paths.js +2 -5
- package/dist/run/paths.js.map +1 -1
- package/dist/transformers/port.d.ts +12 -41
- package/dist/transformers/port.d.ts.map +1 -1
- package/package.json +3 -3
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { CommandResult, WorkLedger } from "@bluewombat/work-ledger";
|
|
2
2
|
import type { AuthorityPort, TransformerPort } from "../transformers/port.js";
|
|
3
3
|
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";
|
|
4
|
-
/** Prepare a
|
|
4
|
+
/** Prepare a Ticket workspace after Isolation — install deps, and so on. */
|
|
5
5
|
export type WarmOutcome = "warmed" | "failed" | "interrupted" | "invalid-invocation";
|
|
6
6
|
export type WarmPort = {
|
|
7
7
|
prepare(input: {
|
|
@@ -33,20 +33,20 @@ export type OpenConductorOptions = {
|
|
|
33
33
|
workspaceRoot: string;
|
|
34
34
|
transformerDurationMs?: number;
|
|
35
35
|
/**
|
|
36
|
-
* The outside judge of a Submission. Absent: an assembled
|
|
36
|
+
* The outside judge of a Submission. Absent: an assembled ticket is folded
|
|
37
37
|
* into the work line directly, with nobody else asked.
|
|
38
38
|
*/
|
|
39
39
|
authority?: AuthorityPort;
|
|
40
|
-
/** The work line a Submission is offered to
|
|
40
|
+
/** The work line a Submission is offered to, unless the Ticket names its own `line`. Required with an Authority. */
|
|
41
41
|
workLineTarget?: string;
|
|
42
42
|
/** How many times the Authority may send the work back before it escalates. */
|
|
43
43
|
maxRefusals?: number;
|
|
44
44
|
/**
|
|
45
|
-
* Whether a local judge decides if the assembled
|
|
45
|
+
* Whether a local judge decides if the assembled ticket meets the
|
|
46
46
|
* intention, before any Submission exists — or, without an Authority,
|
|
47
47
|
* before the final fold. Absent or `false`: `assembly.validate` is not
|
|
48
48
|
* declared, and `integrating` goes straight to offer (or the local judge on
|
|
49
|
-
* `produce: false`)
|
|
49
|
+
* `produce: false`).
|
|
50
50
|
*/
|
|
51
51
|
assemblyValidate?: boolean;
|
|
52
52
|
/**
|
|
@@ -57,16 +57,16 @@ export type OpenConductorOptions = {
|
|
|
57
57
|
assemblyFixDeclared?: boolean;
|
|
58
58
|
/**
|
|
59
59
|
* Told at the moments a pass changes what an outsider would want to know:
|
|
60
|
-
* the
|
|
60
|
+
* the work is submitted. Awaited,
|
|
61
61
|
* so what the caller says lands before the next step; what it throws is
|
|
62
62
|
* its own problem and does not stop the run.
|
|
63
63
|
*/
|
|
64
64
|
observe?: (moment: ConductorMoment) => Promise<void> | void;
|
|
65
65
|
/**
|
|
66
|
-
* Prepare the
|
|
67
|
-
*
|
|
68
|
-
*
|
|
69
|
-
*
|
|
66
|
+
* Prepare the workspace once it exists, before the Builder runs in it.
|
|
67
|
+
* Absent: the Builder gets whatever Isolation left — often a cold tree with
|
|
68
|
+
* no dependencies. Bounded by `durationMs`; retried on the next `runProject`
|
|
69
|
+
* until it returns `warmed`.
|
|
70
70
|
*/
|
|
71
71
|
warm?: WarmPort & {
|
|
72
72
|
durationMs: number;
|
|
@@ -74,15 +74,6 @@ export type OpenConductorOptions = {
|
|
|
74
74
|
};
|
|
75
75
|
/** One thing that happened inside a pass, for whoever is watching from outside. */
|
|
76
76
|
export type ConductorMoment = {
|
|
77
|
-
kind: "planned";
|
|
78
|
-
key: string;
|
|
79
|
-
} | {
|
|
80
|
-
kind: "subtask-integrated";
|
|
81
|
-
key: string;
|
|
82
|
-
subtaskId: string;
|
|
83
|
-
integrated: number;
|
|
84
|
-
total: number;
|
|
85
|
-
} | {
|
|
86
77
|
kind: "submitted";
|
|
87
78
|
key: string;
|
|
88
79
|
reference: string;
|
|
@@ -94,8 +85,8 @@ export type Conductor = {
|
|
|
94
85
|
runProject(project: string): Promise<ProjectRunResult>;
|
|
95
86
|
cancel(key: string): Promise<CommandResult>;
|
|
96
87
|
/**
|
|
97
|
-
* Drop a held
|
|
98
|
-
* Destroys the declared
|
|
88
|
+
* Drop a held unit without waiting for the bail clock.
|
|
89
|
+
* Destroys the declared directory when one was recorded.
|
|
99
90
|
*/
|
|
100
91
|
release(key: string): Promise<CommandResult>;
|
|
101
92
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"open-conductor.d.ts","sourceRoot":"","sources":["../../src/run/open-conductor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,
|
|
1
|
+
{"version":3,"file":"open-conductor.d.ts","sourceRoot":"","sources":["../../src/run/open-conductor.ts"],"names":[],"mappings":"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"}
|