@inhuman.tools/plexus-expectations 0.0.0-stage → 0.1.0

package/dist/shared/models/Job.d.ts

@@ -0,0 +1,85 @@
+import { WorkContainer } from "./WorkContainer.js";
+export type JobResolution<TValue, TReason> = {
+    readonly status: "fulfilled";
+    readonly value: TValue;
+} | {
+    readonly status: "rejected";
+    readonly reason: TReason;
+};
+export type JobKind = "command" | "agent" | "bot" | "workflow";
+/** Runtime that owns a job's effect. */
+export type JobEffectOwner = "session-runtime" | "tool-runtime" | "scheme-runtime" | "agent-calls" | "honor";
+/** What a restart does with a job whose outcome it cannot see. */
+export type UnknownOutcomeRecovery = "resume-queued" | "resume-inner" | "unknown-no-replay";
+export declare abstract class Job<TValue = unknown, TReason = unknown> extends WorkContainer implements Promise<TValue> {
+    #private;
+    /** Not this instantiation — a parent holds jobs with other fulfill and reject types. */
+    accessor children: Job<unknown, unknown>[];
+    accessor background: boolean;
+    accessor walkBoundary: boolean;
+    /** Guard return. `null` = phase 1 not done. */
+    accessor orchestrationResult: true | false | null;
+    /** Cancel fact. `false → true`. Not a deny and not a human approval. */
+    accessor cancelled: boolean;
+    /** This job's own work has finalized (ok or not). */
+    accessor completed: boolean;
+    /**
+     * Crash ending: the license guard or the executor body threw. Empty means
+     * no crash. The message is the fact; the host stamps a receipt from it and
+     * the job completes, so whoever joins the job is released with an outcome.
+     */
+    accessor crash: string;
+    /**
+     * Ordering as data: jobs that must be released before this one is claimed
+     * (license and body). Refs to earlier siblings, never a cycle. The
+     * orchestrator honours it on every pass, so it holds across a restart.
+     */
+    accessor after: Job<unknown, unknown>[];
+    /**
+     * Seal + end clock, in one update: `result` keys on `endedAtMs`, so a
+     * crash between the two writes would leave a completed job unawaitable.
+     * Deny-without-BODY leaves `startedAtMs` null.
+     */
+    markComplete(now?: number): void;
+    /** Replace {@link after}. Call before the job becomes reachable. */
+    stampAfter(jobs: readonly Job<unknown, unknown>[]): void;
+    /**
+     * Released for a successor: done, cancelled, or a background job that has
+     * started. A denied or failed predecessor is done too; order is not success.
+     */
+    get released(): boolean;
+    /** Every {@link after} predecessor is released. */
+    get afterReleased(): boolean;
+    /** Parent `child` when it is not already in `children`. Does not enqueue or wait. */
+    registerJob<T extends Job<unknown, unknown>>(child: T): T;
+    get orchestrated(): boolean;
+    /** Not one call. Agent, bot, shell, and program override. */
+    get kind(): JobKind;
+    /** Not the background flag. Call, program, and shell override. */
+    get isTrackedBackground(): boolean;
+    /** Not the wire name. Call, program, and shell override. */
+    get object(): string;
+    /**
+     * Effect contract for this class. Not synced. An abstract intermediate
+     * declares none, so every concrete kind has to state its own.
+     */
+    abstract readonly owner: JobEffectOwner;
+    abstract readonly intent: string;
+    abstract readonly checkpoint: string;
+    abstract readonly dispatch: string;
+    abstract readonly settlement: string;
+    abstract readonly cancel: string;
+    abstract readonly unknownRecovery: UnknownOutcomeRecovery;
+    abstract readonly unknownNote: string;
+    abstract readonly intentRequired: boolean;
+    get jobs(): Job<unknown, unknown>[];
+    get foregroundJobs(): Job<unknown, unknown>[];
+    get backgroundJobs(): Job<unknown, unknown>[];
+    get result(): JobResolution<TValue, TReason> | null;
+    get work(): readonly WorkContainer[];
+    then<TFulfilled = TValue, TRejected = never>(onfulfilled?: ((value: TValue) => TFulfilled | PromiseLike<TFulfilled>) | null, onrejected?: ((reason: TReason) => TRejected | PromiseLike<TRejected>) | null): Promise<TFulfilled | TRejected>;
+    catch<TRejected = never>(onrejected?: ((reason: TReason) => TRejected | PromiseLike<TRejected>) | null): Promise<TValue | TRejected>;
+    finally(onfinally?: (() => void) | null): Promise<TValue>;
+    get [Symbol.toStringTag](): string;
+}
+//# sourceMappingURL=Job.d.ts.map

package/dist/shared/models/Job.d.ts.map

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

package/dist/shared/models/Job.js

@@ -0,0 +1,261 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+/**
+ * COLLECTORS ARE NOT `.work`. Collectors expand until `walkBoundary`.
+ * Job is a WorkContainer, not a WorkExpectation.
+ *
+ * `orchestrationResult` is the guard's boolean. `orchestrated` is computed
+ * (`!== null`). `cancelled` is the cancel fact. Do not assign `orchestrated`.
+ *
+ * Await settles on `result`, not on this object. `result` stays null until
+ * `endedAtMs` is set, then this class fulfills `undefined`. `cancelled` alone
+ * does not settle. A subclass names its value and rejection by overriding `result`.
+ */
+import { syncing } from "@here.build/plexus";
+import { computed, when } from "mobx";
+import invariant from "tiny-invariant";
+import { WorkContainer } from "./WorkContainer.js";
+let Job = (() => {
+    var _a, _b, _c, _d;
+    let _classDecorators = [syncing("@inhuman.tools/plexus-expectations:Job")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = WorkContainer;
+    let _instanceExtraInitializers = [];
+    let _children_decorators;
+    let _children_initializers = [];
+    let _children_extraInitializers = [];
+    let _background_decorators;
+    let _background_initializers = [];
+    let _background_extraInitializers = [];
+    let _walkBoundary_decorators;
+    let _walkBoundary_initializers = [];
+    let _walkBoundary_extraInitializers = [];
+    let _orchestrationResult_decorators;
+    let _orchestrationResult_initializers = [];
+    let _orchestrationResult_extraInitializers = [];
+    let _cancelled_decorators;
+    let _cancelled_initializers = [];
+    let _cancelled_extraInitializers = [];
+    let _completed_decorators;
+    let _completed_initializers = [];
+    let _completed_extraInitializers = [];
+    let _crash_decorators;
+    let _crash_initializers = [];
+    let _crash_extraInitializers = [];
+    let _after_decorators;
+    let _after_initializers = [];
+    let _after_extraInitializers = [];
+    let _markComplete_decorators;
+    let _stampAfter_decorators;
+    let _get_afterReleased_decorators;
+    let _get_orchestrated_decorators;
+    let _get_jobs_decorators;
+    let _get_foregroundJobs_decorators;
+    let _get_backgroundJobs_decorators;
+    let _get_result_decorators;
+    let _get_work_decorators;
+    var Job = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(this, null, _children_decorators, { kind: "accessor", name: "children", static: false, private: false, access: { has: obj => "children" in obj, get: obj => obj.children, set: (obj, value) => { obj.children = value; } }, metadata: _metadata }, _children_initializers, _children_extraInitializers);
+            __esDecorate(this, null, _background_decorators, { kind: "accessor", name: "background", static: false, private: false, access: { has: obj => "background" in obj, get: obj => obj.background, set: (obj, value) => { obj.background = value; } }, metadata: _metadata }, _background_initializers, _background_extraInitializers);
+            __esDecorate(this, null, _walkBoundary_decorators, { kind: "accessor", name: "walkBoundary", static: false, private: false, access: { has: obj => "walkBoundary" in obj, get: obj => obj.walkBoundary, set: (obj, value) => { obj.walkBoundary = value; } }, metadata: _metadata }, _walkBoundary_initializers, _walkBoundary_extraInitializers);
+            __esDecorate(this, null, _orchestrationResult_decorators, { kind: "accessor", name: "orchestrationResult", static: false, private: false, access: { has: obj => "orchestrationResult" in obj, get: obj => obj.orchestrationResult, set: (obj, value) => { obj.orchestrationResult = value; } }, metadata: _metadata }, _orchestrationResult_initializers, _orchestrationResult_extraInitializers);
+            __esDecorate(this, null, _cancelled_decorators, { kind: "accessor", name: "cancelled", static: false, private: false, access: { has: obj => "cancelled" in obj, get: obj => obj.cancelled, set: (obj, value) => { obj.cancelled = value; } }, metadata: _metadata }, _cancelled_initializers, _cancelled_extraInitializers);
+            __esDecorate(this, null, _completed_decorators, { kind: "accessor", name: "completed", static: false, private: false, access: { has: obj => "completed" in obj, get: obj => obj.completed, set: (obj, value) => { obj.completed = value; } }, metadata: _metadata }, _completed_initializers, _completed_extraInitializers);
+            __esDecorate(this, null, _crash_decorators, { kind: "accessor", name: "crash", static: false, private: false, access: { has: obj => "crash" in obj, get: obj => obj.crash, set: (obj, value) => { obj.crash = value; } }, metadata: _metadata }, _crash_initializers, _crash_extraInitializers);
+            __esDecorate(this, null, _after_decorators, { kind: "accessor", name: "after", static: false, private: false, access: { has: obj => "after" in obj, get: obj => obj.after, set: (obj, value) => { obj.after = value; } }, metadata: _metadata }, _after_initializers, _after_extraInitializers);
+            __esDecorate(this, null, _markComplete_decorators, { kind: "method", name: "markComplete", static: false, private: false, access: { has: obj => "markComplete" in obj, get: obj => obj.markComplete }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _stampAfter_decorators, { kind: "method", name: "stampAfter", static: false, private: false, access: { has: obj => "stampAfter" in obj, get: obj => obj.stampAfter }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_afterReleased_decorators, { kind: "getter", name: "afterReleased", static: false, private: false, access: { has: obj => "afterReleased" in obj, get: obj => obj.afterReleased }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_orchestrated_decorators, { kind: "getter", name: "orchestrated", static: false, private: false, access: { has: obj => "orchestrated" in obj, get: obj => obj.orchestrated }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_jobs_decorators, { kind: "getter", name: "jobs", static: false, private: false, access: { has: obj => "jobs" in obj, get: obj => obj.jobs }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_foregroundJobs_decorators, { kind: "getter", name: "foregroundJobs", static: false, private: false, access: { has: obj => "foregroundJobs" in obj, get: obj => obj.foregroundJobs }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_backgroundJobs_decorators, { kind: "getter", name: "backgroundJobs", static: false, private: false, access: { has: obj => "backgroundJobs" in obj, get: obj => obj.backgroundJobs }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_result_decorators, { kind: "getter", name: "result", static: false, private: false, access: { has: obj => "result" in obj, get: obj => obj.result }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_work_decorators, { kind: "getter", name: "work", static: false, private: false, access: { has: obj => "work" in obj, get: obj => obj.work }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            Job = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        #pending = (__runInitializers(this, _instanceExtraInitializers), null);
+        #children_accessor_storage = __runInitializers(this, _children_initializers, []);
+        /** Not this instantiation — a parent holds jobs with other fulfill and reject types. */
+        get children() { return this.#children_accessor_storage; }
+        set children(value) { this.#children_accessor_storage = value; }
+        #background_accessor_storage = (__runInitializers(this, _children_extraInitializers), __runInitializers(this, _background_initializers, false));
+        get background() { return this.#background_accessor_storage; }
+        set background(value) { this.#background_accessor_storage = value; }
+        #walkBoundary_accessor_storage = (__runInitializers(this, _background_extraInitializers), __runInitializers(this, _walkBoundary_initializers, false));
+        get walkBoundary() { return this.#walkBoundary_accessor_storage; }
+        set walkBoundary(value) { this.#walkBoundary_accessor_storage = value; }
+        #orchestrationResult_accessor_storage = (__runInitializers(this, _walkBoundary_extraInitializers), __runInitializers(this, _orchestrationResult_initializers, null));
+        /** Guard return. `null` = phase 1 not done. */
+        get orchestrationResult() { return this.#orchestrationResult_accessor_storage; }
+        set orchestrationResult(value) { this.#orchestrationResult_accessor_storage = value; }
+        #cancelled_accessor_storage = (__runInitializers(this, _orchestrationResult_extraInitializers), __runInitializers(this, _cancelled_initializers, false));
+        /** Cancel fact. `false → true`. Not a deny and not a human approval. */
+        get cancelled() { return this.#cancelled_accessor_storage; }
+        set cancelled(value) { this.#cancelled_accessor_storage = value; }
+        #completed_accessor_storage = (__runInitializers(this, _cancelled_extraInitializers), __runInitializers(this, _completed_initializers, false));
+        /** This job's own work has finalized (ok or not). */
+        get completed() { return this.#completed_accessor_storage; }
+        set completed(value) { this.#completed_accessor_storage = value; }
+        #crash_accessor_storage = (__runInitializers(this, _completed_extraInitializers), __runInitializers(this, _crash_initializers, ""));
+        /**
+         * Crash ending: the license guard or the executor body threw. Empty means
+         * no crash. The message is the fact; the host stamps a receipt from it and
+         * the job completes, so whoever joins the job is released with an outcome.
+         */
+        get crash() { return this.#crash_accessor_storage; }
+        set crash(value) { this.#crash_accessor_storage = value; }
+        #after_accessor_storage = (__runInitializers(this, _crash_extraInitializers), __runInitializers(this, _after_initializers, []));
+        /**
+         * Ordering as data: jobs that must be released before this one is claimed
+         * (license and body). Refs to earlier siblings, never a cycle. The
+         * orchestrator honours it on every pass, so it holds across a restart.
+         */
+        get after() { return this.#after_accessor_storage; }
+        set after(value) { this.#after_accessor_storage = value; }
+        /**
+         * Seal + end clock, in one update: `result` keys on `endedAtMs`, so a
+         * crash between the two writes would leave a completed job unawaitable.
+         * Deny-without-BODY leaves `startedAtMs` null.
+         */
+        markComplete(now = Date.now()) {
+            if (!this.completed)
+                this.completed = true;
+            this.markEnded(now);
+        }
+        /** Replace {@link after}. Call before the job becomes reachable. */
+        stampAfter(jobs) {
+            this.after.splice(0, this.after.length, ...jobs);
+        }
+        /**
+         * Released for a successor: done, cancelled, or a background job that has
+         * started. A denied or failed predecessor is done too; order is not success.
+         */
+        get released() {
+            return this.completed || this.cancelled || (this.orchestrated && this.background);
+        }
+        /** Every {@link after} predecessor is released. */
+        get afterReleased() {
+            return this.after.every((job) => job.released);
+        }
+        /** Parent `child` when it is not already in `children`. Does not enqueue or wait. */
+        registerJob(child) {
+            if (!this.children.includes(child))
+                this.children.push(child);
+            return child;
+        }
+        get orchestrated() {
+            return this.orchestrationResult !== null;
+        }
+        /** Not one call. Agent, bot, shell, and program override. */
+        get kind() {
+            return "workflow";
+        }
+        /** Not the background flag. Call, program, and shell override. */
+        get isTrackedBackground() {
+            return false;
+        }
+        /** Not the wire name. Call, program, and shell override. */
+        get object() {
+            return "";
+        }
+        get jobs() {
+            const out = [];
+            for (const child of this.children) {
+                if (!(child instanceof Job))
+                    continue;
+                out.push(child);
+                if (!child.walkBoundary)
+                    out.push(...child.jobs);
+            }
+            return out;
+        }
+        get foregroundJobs() {
+            return this.jobs.filter((node) => !node.background);
+        }
+        get backgroundJobs() {
+            return this.jobs.filter((node) => node.background);
+        }
+        get result() {
+            if (this.endedAtMs == null)
+                return null;
+            return { status: "fulfilled", value: undefined };
+        }
+        get work() {
+            return this.children;
+        }
+        then(onfulfilled, onrejected) {
+            return this.#settled().then(onfulfilled, onrejected);
+        }
+        catch(onrejected) {
+            return this.#settled().catch(onrejected);
+        }
+        finally(onfinally) {
+            return this.#settled().finally(onfinally);
+        }
+        get [(_children_decorators = [(_a = syncing.child).list.bind(_a)], _background_decorators = [syncing], _walkBoundary_decorators = [syncing], _orchestrationResult_decorators = [syncing], _cancelled_decorators = [syncing], _completed_decorators = [syncing], _crash_decorators = [syncing], _after_decorators = [(_b = syncing).list.bind(_b)], _markComplete_decorators = [(_c = syncing).action.bind(_c)], _stampAfter_decorators = [(_d = syncing).action.bind(_d)], _get_afterReleased_decorators = [computed], _get_orchestrated_decorators = [computed], _get_jobs_decorators = [computed], _get_foregroundJobs_decorators = [computed], _get_backgroundJobs_decorators = [computed], _get_result_decorators = [computed], _get_work_decorators = [computed], Symbol.toStringTag)]() {
+            return "Job";
+        }
+        #settled() {
+            if (this.#pending != null)
+                return this.#pending;
+            const deliver = () => {
+                const resolution = this.result;
+                invariant(resolution != null, "Job settled without result");
+                if (resolution.status === "rejected")
+                    throw resolution.reason;
+                return resolution.value;
+            };
+            this.#pending =
+                this.result != null ? Promise.resolve().then(deliver) : when(() => this.result != null).then(deliver);
+            return this.#pending;
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _after_extraInitializers);
+        }
+    };
+    return Job = _classThis;
+})();
+export { Job };
+//# sourceMappingURL=Job.js.map

package/dist/shared/models/Job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Job.js","sourceRoot":"","sources":["../../../src/shared/models/Job.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * COLLECTORS ARE NOT `.work`. Collectors expand until `walkBoundary`.\n * Job is a WorkContainer, not a WorkExpectation.\n *\n * `orchestrationResult` is the guard's boolean. `orchestrated` is computed\n * (`!== null`). `cancelled` is the cancel fact. Do not assign `orchestrated`.\n *\n * Await settles on `result`, not on this object. `result` stays null until\n * `endedAtMs` is set, then this class fulfills `undefined`. `cancelled` alone\n * does not settle. A subclass names its value and rejection by overriding `result`.\n */\nimport { syncing } from \"@here.build/plexus\";\nimport { computed, when } from \"mobx\";\nimport invariant from \"tiny-invariant\";\n\nimport { WorkContainer } from \"./WorkContainer.js\";\n\nexport type JobResolution<TValue, TReason> =\n  { readonly status: \"fulfilled\"; readonly value: TValue } | { readonly status: \"rejected\"; readonly reason: TReason };\n\nexport type JobKind = \"command\" | \"agent\" | \"bot\" | \"workflow\";\n\n/** Runtime that owns a job's effect. */\nexport type JobEffectOwner = \"session-runtime\" | \"tool-runtime\" | \"scheme-runtime\" | \"agent-calls\" | \"honor\";\n\n/** What a restart does with a job whose outcome it cannot see. */\nexport type UnknownOutcomeRecovery = \"resume-queued\" | \"resume-inner\" | \"unknown-no-replay\";\n\n@syncing(\"@inhuman.tools/plexus-expectations:Job\")\nexport abstract class Job<TValue = unknown, TReason = unknown> extends WorkContainer implements Promise<TValue> {\n  #pending: Promise<TValue> | null = null;\n\n  /** Not this instantiation — a parent holds jobs with other fulfill and reject types. */\n  @syncing.child.list accessor children: Job<unknown, unknown>[] = [];\n  @syncing accessor background: boolean = false;\n  @syncing accessor walkBoundary: boolean = false;\n  /** Guard return. `null` = phase 1 not done. */\n  @syncing accessor orchestrationResult: true | false | null = null;\n  /** Cancel fact. `false → true`. Not a deny and not a human approval. */\n  @syncing accessor cancelled: boolean = false;\n  /** This job's own work has finalized (ok or not). */\n  @syncing accessor completed: boolean = false;\n  /**\n   * Crash ending: the license guard or the executor body threw. Empty means\n   * no crash. The message is the fact; the host stamps a receipt from it and\n   * the job completes, so whoever joins the job is released with an outcome.\n   */\n  @syncing accessor crash: string = \"\";\n  /**\n   * Ordering as data: jobs that must be released before this one is claimed\n   * (license and body). Refs to earlier siblings, never a cycle. The\n   * orchestrator honours it on every pass, so it holds across a restart.\n   */\n  @syncing.list accessor after: Job<unknown, unknown>[] = [];\n\n  /**\n   * Seal + end clock, in one update: `result` keys on `endedAtMs`, so a\n   * crash between the two writes would leave a completed job unawaitable.\n   * Deny-without-BODY leaves `startedAtMs` null.\n   */\n  @syncing.action\n  markComplete(now = Date.now()): void {\n    if (!this.completed) this.completed = true;\n    this.markEnded(now);\n  }\n\n  /** Replace {@link after}. Call before the job becomes reachable. */\n  @syncing.action\n  stampAfter(jobs: readonly Job<unknown, unknown>[]): void {\n    this.after.splice(0, this.after.length, ...jobs);\n  }\n\n  /**\n   * Released for a successor: done, cancelled, or a background job that has\n   * started. A denied or failed predecessor is done too; order is not success.\n   */\n  get released(): boolean {\n    return this.completed || this.cancelled || (this.orchestrated && this.background);\n  }\n\n  /** Every {@link after} predecessor is released. */\n  @computed\n  get afterReleased(): boolean {\n    return this.after.every((job) => job.released);\n  }\n\n  /** Parent `child` when it is not already in `children`. Does not enqueue or wait. */\n  registerJob<T extends Job<unknown, unknown>>(child: T): T {\n    if (!this.children.includes(child)) this.children.push(child);\n    return child;\n  }\n\n  @computed\n  get orchestrated(): boolean {\n    return this.orchestrationResult !== null;\n  }\n\n  /** Not one call. Agent, bot, shell, and program override. */\n  get kind(): JobKind {\n    return \"workflow\";\n  }\n\n  /** Not the background flag. Call, program, and shell override. */\n  get isTrackedBackground(): boolean {\n    return false;\n  }\n\n  /** Not the wire name. Call, program, and shell override. */\n  get object(): string {\n    return \"\";\n  }\n\n  /**\n   * Effect contract for this class. Not synced. An abstract intermediate\n   * declares none, so every concrete kind has to state its own.\n   */\n  abstract readonly owner: JobEffectOwner;\n  abstract readonly intent: string;\n  abstract readonly checkpoint: string;\n  abstract readonly dispatch: string;\n  abstract readonly settlement: string;\n  abstract readonly cancel: string;\n  abstract readonly unknownRecovery: UnknownOutcomeRecovery;\n  abstract readonly unknownNote: string;\n  abstract readonly intentRequired: boolean;\n\n  @computed\n  get jobs(): Job<unknown, unknown>[] {\n    const out: Job<unknown, unknown>[] = [];\n    for (const child of this.children) {\n      if (!(child instanceof Job)) continue;\n      out.push(child);\n      if (!child.walkBoundary) out.push(...child.jobs);\n    }\n    return out;\n  }\n\n  @computed\n  get foregroundJobs(): Job<unknown, unknown>[] {\n    return this.jobs.filter((node) => !node.background);\n  }\n\n  @computed\n  get backgroundJobs(): Job<unknown, unknown>[] {\n    return this.jobs.filter((node) => node.background);\n  }\n\n  @computed\n  get result(): JobResolution<TValue, TReason> | null {\n    if (this.endedAtMs == null) return null;\n    return { status: \"fulfilled\", value: undefined as TValue };\n  }\n\n  @computed\n  get work(): readonly WorkContainer[] {\n    return this.children;\n  }\n\n  then<TFulfilled = TValue, TRejected = never>(\n    onfulfilled?: ((value: TValue) => TFulfilled | PromiseLike<TFulfilled>) | null,\n    onrejected?: ((reason: TReason) => TRejected | PromiseLike<TRejected>) | null,\n  ): Promise<TFulfilled | TRejected> {\n    return this.#settled().then(onfulfilled, onrejected);\n  }\n\n  catch<TRejected = never>(\n    onrejected?: ((reason: TReason) => TRejected | PromiseLike<TRejected>) | null,\n  ): Promise<TValue | TRejected> {\n    return this.#settled().catch(onrejected);\n  }\n\n  finally(onfinally?: (() => void) | null): Promise<TValue> {\n    return this.#settled().finally(onfinally);\n  }\n\n  get [Symbol.toStringTag](): string {\n    return \"Job\";\n  }\n\n  #settled(): Promise<TValue> {\n    if (this.#pending != null) return this.#pending;\n    const deliver = (): TValue => {\n      const resolution = this.result;\n      invariant(resolution != null, \"Job settled without result\");\n      if (resolution.status === \"rejected\") throw resolution.reason;\n      return resolution.value;\n    };\n    this.#pending =\n      this.result != null ? Promise.resolve().then(deliver) : when(() => this.result != null).then(deliver);\n    return this.#pending;\n  }\n}\n"]}

package/dist/shared/models/ProgrammaticJob.d.ts

@@ -0,0 +1,6 @@
+import { Job } from "./Job.js";
+export declare class ProgrammaticJob extends Job {
+    accessor programText: string | null;
+    accessor resolved: boolean;
+}
+//# sourceMappingURL=ProgrammaticJob.d.ts.map

package/dist/shared/models/ProgrammaticJob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgrammaticJob.d.ts","sourceRoot":"","sources":["../../../src/shared/models/ProgrammaticJob.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,qBACa,eAAgB,SAAQ,GAAG;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IACpD,SAA2B,QAAQ,EAAE,OAAO,CAAS;CACtD"}

package/dist/shared/models/ProgrammaticJob.js

@@ -0,0 +1,80 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+/**
+ * Stored `resolved` — writing it does not require writing children.
+ * `walkBoundary` stays false: not every program is a two-plane contour.
+ */
+import { syncing } from "@here.build/plexus";
+import { Job } from "./Job.js";
+let ProgrammaticJob = (() => {
+    let _classDecorators = [syncing("@inhuman.tools/plexus-expectations:ProgrammaticJob")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = Job;
+    let _programText_decorators;
+    let _programText_initializers = [];
+    let _programText_extraInitializers = [];
+    let _resolved_decorators;
+    let _resolved_initializers = [];
+    let _resolved_extraInitializers = [];
+    var ProgrammaticJob = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _programText_decorators = [syncing];
+            _resolved_decorators = [syncing];
+            __esDecorate(this, null, _programText_decorators, { kind: "accessor", name: "programText", static: false, private: false, access: { has: obj => "programText" in obj, get: obj => obj.programText, set: (obj, value) => { obj.programText = value; } }, metadata: _metadata }, _programText_initializers, _programText_extraInitializers);
+            __esDecorate(this, null, _resolved_decorators, { kind: "accessor", name: "resolved", static: false, private: false, access: { has: obj => "resolved" in obj, get: obj => obj.resolved, set: (obj, value) => { obj.resolved = value; } }, metadata: _metadata }, _resolved_initializers, _resolved_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            ProgrammaticJob = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        #programText_accessor_storage = __runInitializers(this, _programText_initializers, null);
+        get programText() { return this.#programText_accessor_storage; }
+        set programText(value) { this.#programText_accessor_storage = value; }
+        #resolved_accessor_storage = (__runInitializers(this, _programText_extraInitializers), __runInitializers(this, _resolved_initializers, false));
+        get resolved() { return this.#resolved_accessor_storage; }
+        set resolved(value) { this.#resolved_accessor_storage = value; }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _resolved_extraInitializers);
+        }
+    };
+    return ProgrammaticJob = _classThis;
+})();
+export { ProgrammaticJob };
+//# sourceMappingURL=ProgrammaticJob.js.map

package/dist/shared/models/ProgrammaticJob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgrammaticJob.js","sourceRoot":"","sources":["../../../src/shared/models/ProgrammaticJob.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;IAGlB,eAAe;4BAD3B,OAAO,CAAC,oDAAoD,CAAC;;;;sBACzB,GAAG;;;;;;;+BAAX,SAAQ,WAAG;;;;uCACrC,OAAO;oCACP,OAAO;YADC,sLAAS,WAAW,6BAAX,WAAW,iGAAuB;YAC3C,6KAAkB,QAAQ,6BAAR,QAAQ,2FAAkB;YAFvD,6KAGC;;;YAHY,uDAAe;;QACjB,mFAAsC,IAAI,EAAC;QAA3C,IAAS,WAAW,iDAAuB;QAA3C,IAAS,WAAW,uDAAuB;QAC3C,uIAAsC,KAAK,GAAC;QAA5C,IAAkB,QAAQ,8CAAkB;QAA5C,IAAkB,QAAQ,oDAAkB;;;;;;;;SAF1C,eAAe","sourcesContent":["/**\n * Stored `resolved` — writing it does not require writing children.\n * `walkBoundary` stays false: not every program is a two-plane contour.\n */\nimport { syncing } from \"@here.build/plexus\";\n\nimport { Job } from \"./Job.js\";\n\n@syncing(\"@inhuman.tools/plexus-expectations:ProgrammaticJob\")\nexport class ProgrammaticJob extends Job {\n  @syncing accessor programText: string | null = null;\n  @syncing override accessor resolved: boolean = false;\n}\n"]}

package/dist/shared/models/WorkContainer.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Work graph node. `work` may be a synced list or a computed getter.
+ * Walking `.work` from the document root is the whole out-reachable set.
+ *
+ * Brand is on this class — do not duck-type `.work`.
+ *
+ * Thenable. The fulfillment is not `this` — a thenable that resolves to itself
+ * never settles. This class settles when `endedAtMs` is set, fulfills
+ * `undefined`, and does not reject. {@link WorkExpectation} fulfills its
+ * outcome. {@link Job} fulfills or rejects from `result`. The promise value
+ * here is `unknown` so both stay containers.
+ */
+import { PlexusModel } from "@here.build/plexus";
+export declare const workContainer: unique symbol;
+/** Base promise value. An expectation narrows it to the outcome; a job narrows it per class. */
+export type WorkFulfillment = unknown;
+export declare abstract class WorkContainer extends PlexusModel implements Promise<WorkFulfillment> {
+    #private;
+    readonly [workContainer]: true;
+    /** Epoch ms. Write-once. BODY / actor start — not mint, not the guard. */
+    accessor startedAtMs: number | null;
+    /** Epoch ms. Write-once. Job complete / PEW succeed|fail. This class's thenable settles on this. */
+    accessor endedAtMs: number | null;
+    abstract readonly work: readonly WorkContainer[];
+    markStarted(now?: number): void;
+    markEnded(now?: number): void;
+    /** Live: `now - startedAtMs`. Sealed: `endedAtMs - startedAtMs`. Null if start was never stamped. */
+    durationMs(now?: number): number | null;
+    then<TFulfilled = WorkFulfillment, TRejected = never>(onfulfilled?: ((value: WorkFulfillment) => TFulfilled | PromiseLike<TFulfilled>) | null, onrejected?: ((reason: unknown) => TRejected | PromiseLike<TRejected>) | null): Promise<TFulfilled | TRejected>;
+    catch<TRejected = never>(onrejected?: ((reason: unknown) => TRejected | PromiseLike<TRejected>) | null): Promise<WorkFulfillment | TRejected>;
+    finally(onfinally?: (() => void) | null): Promise<WorkFulfillment>;
+    get [Symbol.toStringTag](): string;
+}
+/** Preorder walk of `.work`, cycle-safe. `item === container` stops a leaf `[this]` from recursing. */
+export declare function walkWork(container: WorkContainer, seen?: Set<WorkContainer>): Generator<WorkContainer>;
+//# sourceMappingURL=WorkContainer.d.ts.map

package/dist/shared/models/WorkContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkContainer.d.ts","sourceRoot":"","sources":["../../../src/shared/models/WorkContainer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAW,MAAM,oBAAoB,CAAC;AAG1D,eAAO,MAAM,aAAa,EAAE,OAAO,MAA8C,CAAC;AAElF,gGAAgG;AAChG,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC;AAEtC,8BACsB,aAAc,SAAQ,WAAY,YAAW,OAAO,CAAC,eAAe,CAAC;;IACzF,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAG,IAAI,CAAU;IAGzC,0EAA0E;IACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IACpD,oGAAoG;IAC3F,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAElD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IAEjD,WAAW,CAAC,GAAG,SAAa,GAAG,IAAI;IAKnC,SAAS,CAAC,GAAG,SAAa,GAAG,IAAI;IAKjC,qGAAqG;IACrG,UAAU,CAAC,GAAG,SAAa,GAAG,MAAM,GAAG,IAAI;IAO3C,IAAI,CAAC,UAAU,GAAG,eAAe,EAAE,SAAS,GAAG,KAAK,EAClD,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,EACvF,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,GAC5E,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIlC,KAAK,CAAC,SAAS,GAAG,KAAK,EACrB,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,GAC5E,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAIvC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;IAIlE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;CASF;AAED,uGAAuG;AACvG,wBAAiB,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,GAAE,GAAG,CAAC,aAAa,CAAa,GAAG,SAAS,CAAC,aAAa,CAAC,CAQlH"}