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

package/dist/shared/models/WorkContainer.js

@@ -0,0 +1,140 @@
+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;
+};
+/**
+ * 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, syncing } from "@here.build/plexus";
+import { when } from "mobx";
+export const workContainer = Symbol.for("work:container");
+let WorkContainer = (() => {
+    let _classDecorators = [syncing("@inhuman.tools/plexus-expectations:WorkContainer")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = PlexusModel;
+    let _startedAtMs_decorators;
+    let _startedAtMs_initializers = [];
+    let _startedAtMs_extraInitializers = [];
+    let _endedAtMs_decorators;
+    let _endedAtMs_initializers = [];
+    let _endedAtMs_extraInitializers = [];
+    var WorkContainer = 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, _startedAtMs_decorators, { kind: "accessor", name: "startedAtMs", static: false, private: false, access: { has: obj => "startedAtMs" in obj, get: obj => obj.startedAtMs, set: (obj, value) => { obj.startedAtMs = value; } }, metadata: _metadata }, _startedAtMs_initializers, _startedAtMs_extraInitializers);
+            __esDecorate(this, null, _endedAtMs_decorators, { kind: "accessor", name: "endedAtMs", static: false, private: false, access: { has: obj => "endedAtMs" in obj, get: obj => obj.endedAtMs, set: (obj, value) => { obj.endedAtMs = value; } }, metadata: _metadata }, _endedAtMs_initializers, _endedAtMs_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            WorkContainer = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        [workContainer] = true;
+        #settledPromise = null;
+        #startedAtMs_accessor_storage = __runInitializers(this, _startedAtMs_initializers, null);
+        /** Epoch ms. Write-once. BODY / actor start — not mint, not the guard. */
+        get startedAtMs() { return this.#startedAtMs_accessor_storage; }
+        set startedAtMs(value) { this.#startedAtMs_accessor_storage = value; }
+        #endedAtMs_accessor_storage = (__runInitializers(this, _startedAtMs_extraInitializers), __runInitializers(this, _endedAtMs_initializers, null));
+        /** Epoch ms. Write-once. Job complete / PEW succeed|fail. This class's thenable settles on this. */
+        get endedAtMs() { return this.#endedAtMs_accessor_storage; }
+        set endedAtMs(value) { this.#endedAtMs_accessor_storage = value; }
+        markStarted(now = Date.now()) {
+            if (this.startedAtMs != null)
+                return;
+            this.startedAtMs = now;
+        }
+        markEnded(now = Date.now()) {
+            if (this.endedAtMs != null)
+                return;
+            this.endedAtMs = now;
+        }
+        /** Live: `now - startedAtMs`. Sealed: `endedAtMs - startedAtMs`. Null if start was never stamped. */
+        durationMs(now = Date.now()) {
+            if (this.startedAtMs == null || !Number.isFinite(this.startedAtMs))
+                return null;
+            const end = this.endedAtMs != null && Number.isFinite(this.endedAtMs) ? this.endedAtMs : now;
+            return Math.max(0, end - this.startedAtMs);
+        }
+        then(onfulfilled, onrejected) {
+            return this.#settled().then(onfulfilled, onrejected);
+        }
+        catch(onrejected) {
+            return this.#settled().catch(onrejected);
+        }
+        finally(onfinally) {
+            return this.#settled().finally(onfinally);
+        }
+        get [(_startedAtMs_decorators = [syncing], _endedAtMs_decorators = [syncing], Symbol.toStringTag)]() {
+            return "WorkContainer";
+        }
+        #settled() {
+            if (this.#settledPromise != null)
+                return this.#settledPromise;
+            const fulfill = () => undefined;
+            this.#settledPromise =
+                this.endedAtMs != null ? Promise.resolve(fulfill()) : when(() => this.endedAtMs != null).then(fulfill);
+            return this.#settledPromise;
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _endedAtMs_extraInitializers);
+        }
+    };
+    return WorkContainer = _classThis;
+})();
+export { WorkContainer };
+/** Preorder walk of `.work`, cycle-safe. `item === container` stops a leaf `[this]` from recursing. */
+export function* walkWork(container, seen = new Set()) {
+    for (const item of container.work) {
+        if (seen.has(item))
+            continue;
+        seen.add(item);
+        yield item;
+        if (item === container)
+            continue;
+        yield* walkWork(item, seen);
+    }
+}
+//# sourceMappingURL=WorkContainer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkContainer.js","sourceRoot":"","sources":["../../../src/shared/models/WorkContainer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Work graph node. `work` may be a synced list or a computed getter.\n * Walking `.work` from the document root is the whole out-reachable set.\n *\n * Brand is on this class — do not duck-type `.work`.\n *\n * Thenable. The fulfillment is not `this` — a thenable that resolves to itself\n * never settles. This class settles when `endedAtMs` is set, fulfills\n * `undefined`, and does not reject. {@link WorkExpectation} fulfills its\n * outcome. {@link Job} fulfills or rejects from `result`. The promise value\n * here is `unknown` so both stay containers.\n */\nimport { PlexusModel, syncing } from \"@here.build/plexus\";\nimport { when } from \"mobx\";\n\nexport const workContainer: unique symbol = Symbol.for(\"work:container\") as never;\n\n/** Base promise value. An expectation narrows it to the outcome; a job narrows it per class. */\nexport type WorkFulfillment = unknown;\n\n@syncing(\"@inhuman.tools/plexus-expectations:WorkContainer\")\nexport abstract class WorkContainer extends PlexusModel implements Promise<WorkFulfillment> {\n  readonly [workContainer] = true as const;\n  #settledPromise: Promise<WorkFulfillment> | null = null;\n\n  /** Epoch ms. Write-once. BODY / actor start — not mint, not the guard. */\n  @syncing accessor startedAtMs: number | null = null;\n  /** Epoch ms. Write-once. Job complete / PEW succeed|fail. This class's thenable settles on this. */\n  @syncing accessor endedAtMs: number | null = null;\n\n  abstract readonly work: readonly WorkContainer[];\n\n  markStarted(now = Date.now()): void {\n    if (this.startedAtMs != null) return;\n    this.startedAtMs = now;\n  }\n\n  markEnded(now = Date.now()): void {\n    if (this.endedAtMs != null) return;\n    this.endedAtMs = now;\n  }\n\n  /** Live: `now - startedAtMs`. Sealed: `endedAtMs - startedAtMs`. Null if start was never stamped. */\n  durationMs(now = Date.now()): number | null {\n    if (this.startedAtMs == null || !Number.isFinite(this.startedAtMs)) return null;\n    const end =\n      this.endedAtMs != null && Number.isFinite(this.endedAtMs) ? this.endedAtMs : now;\n    return Math.max(0, end - this.startedAtMs);\n  }\n\n  then<TFulfilled = WorkFulfillment, TRejected = never>(\n    onfulfilled?: ((value: WorkFulfillment) => TFulfilled | PromiseLike<TFulfilled>) | null,\n    onrejected?: ((reason: unknown) => TRejected | PromiseLike<TRejected>) | null,\n  ): Promise<TFulfilled | TRejected> {\n    return this.#settled().then(onfulfilled, onrejected);\n  }\n\n  catch<TRejected = never>(\n    onrejected?: ((reason: unknown) => TRejected | PromiseLike<TRejected>) | null,\n  ): Promise<WorkFulfillment | TRejected> {\n    return this.#settled().catch(onrejected);\n  }\n\n  finally(onfinally?: (() => void) | null): Promise<WorkFulfillment> {\n    return this.#settled().finally(onfinally);\n  }\n\n  get [Symbol.toStringTag](): string {\n    return \"WorkContainer\";\n  }\n\n  #settled(): Promise<WorkFulfillment> {\n    if (this.#settledPromise != null) return this.#settledPromise;\n    const fulfill = (): WorkFulfillment => undefined;\n    this.#settledPromise =\n      this.endedAtMs != null ? Promise.resolve(fulfill()) : when(() => this.endedAtMs != null).then(fulfill);\n    return this.#settledPromise;\n  }\n}\n\n/** Preorder walk of `.work`, cycle-safe. `item === container` stops a leaf `[this]` from recursing. */\nexport function* walkWork(container: WorkContainer, seen: Set<WorkContainer> = new Set()): Generator<WorkContainer> {\n  for (const item of container.work) {\n    if (seen.has(item)) continue;\n    seen.add(item);\n    yield item;\n    if (item === container) continue;\n    yield* walkWork(item, seen);\n  }\n}\n"]}

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

@@ -0,0 +1,63 @@
+import { type PlexusAwareness } from "@here.build/plexus";
+import { type EndCause, type ExpectationOutcome } from "../control.js";
+import type { SessionAwareness, SessionPlexus } from "../types.js";
+import { WorkContainer } from "./WorkContainer.js";
+/**
+ * Awareness: empty string occupies the role map without a report frame.
+ * Retract drops the uuid. Not a durable outcome.
+ */
+export declare const ROLE_LANE_OCCUPIED = "";
+export declare abstract class WorkExpectation<TResult = unknown, TReport = unknown> extends WorkContainer implements Promise<ExpectationOutcome> {
+    #private;
+    /**
+     * Kernel catalog key this work rides. Required at construction.
+     * Plexus materialization passes a symbol through unchanged.
+     */
+    accessor connectionId: string;
+    constructor(init: {
+        readonly connectionId: string;
+    } | symbol);
+    accessor outcome: ExpectationOutcome | null;
+    accessor endCause: EndCause | null;
+    accessor endDetail: string | null;
+    /** Durable last frame as JSON. `"null"` when the work ended without a report. */
+    accessor outcomeReport: string | null;
+    /** Last live role-map frame this process saw. Retract does not clear it. */
+    private accessor lastProgress;
+    get plexus(): SessionPlexus | null;
+    get awareness(): PlexusAwareness<SessionAwareness> | null;
+    /** Live progress as the fulfiller tells it. Awareness retract does not drop the last frame. */
+    get progressAwareness(): TReport | null;
+    /** Occupancy on the role map. Not a durable outcome. */
+    get workerPresent(): boolean;
+    get isDone(): boolean;
+    /** Leaf. PEW does not parent PEW. */
+    get work(): readonly WorkExpectation[];
+    /**
+     * Settles when {@link isDone}. Fulfills with {@link outcome} for both
+     * `successful` and `failed` — failure is an outcome, not a rejection.
+     * The fulfillment cannot be `this`: a thenable that resolves to itself
+     * never settles (Promise unwraps `then` forever).
+     */
+    then<TFulfilled = ExpectationOutcome, TRejected = never>(onfulfilled?: ((value: ExpectationOutcome) => 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<ExpectationOutcome | TRejected>;
+    finally(onfinally?: (() => void) | null): Promise<ExpectationOutcome>;
+    get [Symbol.toStringTag](): string;
+    applySettlement(_result: TResult): void;
+    /**
+     * Durable outcome frame if written, else last progress seen.
+     * {@link ROLE_LANE_OCCUPIED} is not a frame. Retract keeps the last frame.
+     */
+    get report(): TReport | null;
+    succeed(cause: EndCause, detail: string, outcomeReport: string, settlement?: {
+        readonly result: TResult;
+    }): boolean;
+    fail(cause: EndCause, detail: string, outcomeReport: string): boolean;
+}
+/** Open work whose parent sealed — honor does not start these. */
+export declare function isTreeOrphan(node: WorkExpectation): boolean;
+/** Admits every WorkExpectation instantiation. */
+export type AnyWorkExpectation = WorkExpectation<any, any>;
+export type ResultOf<E extends AnyWorkExpectation> = Parameters<E["applySettlement"]>[0];
+export type ReportOf<E extends AnyWorkExpectation> = Exclude<E["report"], null>;
+//# sourceMappingURL=WorkExpectation.d.ts.map

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

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

package/dist/shared/models/WorkExpectation.js

@@ -0,0 +1,290 @@
+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;
+};
+import { syncing } from "@here.build/plexus";
+import { docPlexus } from "@here.build/plexus/internals";
+import { comparer, computed, observable, reaction, when } from "mobx";
+import invariant from "tiny-invariant";
+import { roleOf } from "../role.js";
+import { Job } from "./Job.js";
+import { WorkContainer } from "./WorkContainer.js";
+/**
+ * Awareness: empty string occupies the role map without a report frame.
+ * Retract drops the uuid. Not a durable outcome.
+ */
+export const ROLE_LANE_OCCUPIED = "";
+let WorkExpectation = (() => {
+    var _a, _b, _c;
+    let _classDecorators = [syncing("@inhuman.tools/plexus-expectations:WorkExpectation")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = WorkContainer;
+    let _instanceExtraInitializers = [];
+    let _connectionId_decorators;
+    let _connectionId_initializers = [];
+    let _connectionId_extraInitializers = [];
+    let _outcome_decorators;
+    let _outcome_initializers = [];
+    let _outcome_extraInitializers = [];
+    let _endCause_decorators;
+    let _endCause_initializers = [];
+    let _endCause_extraInitializers = [];
+    let _endDetail_decorators;
+    let _endDetail_initializers = [];
+    let _endDetail_extraInitializers = [];
+    let _outcomeReport_decorators;
+    let _outcomeReport_initializers = [];
+    let _outcomeReport_extraInitializers = [];
+    let _lastProgress_decorators;
+    let _lastProgress_initializers = [];
+    let _lastProgress_extraInitializers = [];
+    let _get_progressAwareness_decorators;
+    let _get_workerPresent_decorators;
+    let _get_report_decorators;
+    let _succeed_decorators;
+    let _fail_decorators;
+    var WorkExpectation = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _get_report_decorators = [computed];
+            _succeed_decorators = [(_b = syncing).action.bind(_b)];
+            _fail_decorators = [(_c = syncing).action.bind(_c)];
+            __esDecorate(this, null, _connectionId_decorators, { kind: "accessor", name: "connectionId", static: false, private: false, access: { has: obj => "connectionId" in obj, get: obj => obj.connectionId, set: (obj, value) => { obj.connectionId = value; } }, metadata: _metadata }, _connectionId_initializers, _connectionId_extraInitializers);
+            __esDecorate(this, null, _outcome_decorators, { kind: "accessor", name: "outcome", static: false, private: false, access: { has: obj => "outcome" in obj, get: obj => obj.outcome, set: (obj, value) => { obj.outcome = value; } }, metadata: _metadata }, _outcome_initializers, _outcome_extraInitializers);
+            __esDecorate(this, null, _endCause_decorators, { kind: "accessor", name: "endCause", static: false, private: false, access: { has: obj => "endCause" in obj, get: obj => obj.endCause, set: (obj, value) => { obj.endCause = value; } }, metadata: _metadata }, _endCause_initializers, _endCause_extraInitializers);
+            __esDecorate(this, null, _endDetail_decorators, { kind: "accessor", name: "endDetail", static: false, private: false, access: { has: obj => "endDetail" in obj, get: obj => obj.endDetail, set: (obj, value) => { obj.endDetail = value; } }, metadata: _metadata }, _endDetail_initializers, _endDetail_extraInitializers);
+            __esDecorate(this, null, _outcomeReport_decorators, { kind: "accessor", name: "outcomeReport", static: false, private: false, access: { has: obj => "outcomeReport" in obj, get: obj => obj.outcomeReport, set: (obj, value) => { obj.outcomeReport = value; } }, metadata: _metadata }, _outcomeReport_initializers, _outcomeReport_extraInitializers);
+            __esDecorate(this, null, _lastProgress_decorators, { kind: "accessor", name: "lastProgress", static: false, private: false, access: { has: obj => "lastProgress" in obj, get: obj => obj.lastProgress, set: (obj, value) => { obj.lastProgress = value; } }, metadata: _metadata }, _lastProgress_initializers, _lastProgress_extraInitializers);
+            __esDecorate(this, null, _get_progressAwareness_decorators, { kind: "getter", name: "progressAwareness", static: false, private: false, access: { has: obj => "progressAwareness" in obj, get: obj => obj.progressAwareness }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_workerPresent_decorators, { kind: "getter", name: "workerPresent", static: false, private: false, access: { has: obj => "workerPresent" in obj, get: obj => obj.workerPresent }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_report_decorators, { kind: "getter", name: "report", static: false, private: false, access: { has: obj => "report" in obj, get: obj => obj.report }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _succeed_decorators, { kind: "method", name: "succeed", static: false, private: false, access: { has: obj => "succeed" in obj, get: obj => obj.succeed }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _fail_decorators, { kind: "method", name: "fail", static: false, private: false, access: { has: obj => "fail" in obj, get: obj => obj.fail }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            WorkExpectation = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        #connectionId_accessor_storage = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _connectionId_initializers, void 0));
+        /**
+         * Kernel catalog key this work rides. Required at construction.
+         * Plexus materialization passes a symbol through unchanged.
+         */
+        get connectionId() { return this.#connectionId_accessor_storage; }
+        set connectionId(value) { this.#connectionId_accessor_storage = value; }
+        constructor(init) {
+            if (typeof init !== "symbol") {
+                invariant(typeof init.connectionId === "string" && init.connectionId !== "", "WorkExpectation.connectionId is required");
+            }
+            super(init);
+        }
+        #outcome_accessor_storage = (__runInitializers(this, _connectionId_extraInitializers), __runInitializers(this, _outcome_initializers, null));
+        get outcome() { return this.#outcome_accessor_storage; }
+        set outcome(value) { this.#outcome_accessor_storage = value; }
+        #endCause_accessor_storage = (__runInitializers(this, _outcome_extraInitializers), __runInitializers(this, _endCause_initializers, null));
+        get endCause() { return this.#endCause_accessor_storage; }
+        set endCause(value) { this.#endCause_accessor_storage = value; }
+        #endDetail_accessor_storage = (__runInitializers(this, _endCause_extraInitializers), __runInitializers(this, _endDetail_initializers, null));
+        get endDetail() { return this.#endDetail_accessor_storage; }
+        set endDetail(value) { this.#endDetail_accessor_storage = value; }
+        #outcomeReport_accessor_storage = (__runInitializers(this, _endDetail_extraInitializers), __runInitializers(this, _outcomeReport_initializers, null));
+        /** Durable last frame as JSON. `"null"` when the work ended without a report. */
+        get outcomeReport() { return this.#outcomeReport_accessor_storage; }
+        set outcomeReport(value) { this.#outcomeReport_accessor_storage = value; }
+        #lastProgress_accessor_storage = (__runInitializers(this, _outcomeReport_extraInitializers), __runInitializers(this, _lastProgress_initializers, null));
+        /** Last live role-map frame this process saw. Retract does not clear it. */
+        get lastProgress() { return this.#lastProgress_accessor_storage; }
+        set lastProgress(value) { this.#lastProgress_accessor_storage = value; }
+        #progressCacheStarted = (__runInitializers(this, _lastProgress_extraInitializers), false);
+        #settledPromise = null;
+        get plexus() {
+            const doc = this.__doc__;
+            if (!doc)
+                return null;
+            const plexus = docPlexus.get(doc);
+            if (!plexus)
+                return null;
+            return plexus;
+        }
+        get awareness() {
+            const hub = this.plexus?.awareness ?? null;
+            if (hub != null)
+                this.#ensureProgressCache();
+            return hub;
+        }
+        // MobX: arm on the first `awareness` read so a later untracked read still
+        // sees the last frame. Dispose on done — a sealed lane is frozen; do not
+        // keep a reaction per expectation for the life of the document.
+        #ensureProgressCache() {
+            if (this.#progressCacheStarted)
+                return;
+            this.#progressCacheStarted = true;
+            reaction(() => ({ done: this.isDone, frame: this.#liveProgressFrame() }), ({ done, frame }, _previous, self) => {
+                if (frame !== null)
+                    this.lastProgress = frame;
+                if (done)
+                    self.dispose();
+            }, { fireImmediately: true, equals: comparer.structural });
+        }
+        #liveProgressFrame() {
+            const hub = this.awareness;
+            if (hub == null)
+                return null;
+            const frame = roleOf(hub, this.uuid);
+            if (frame == null || frame === ROLE_LANE_OCCUPIED)
+                return null;
+            return frame;
+        }
+        /** Live progress as the fulfiller tells it. Awareness retract does not drop the last frame. */
+        get progressAwareness() {
+            return this.#liveProgressFrame() ?? this.lastProgress;
+        }
+        /** Occupancy on the role map. Not a durable outcome. */
+        get workerPresent() {
+            const hub = this.awareness;
+            if (hub == null)
+                return false;
+            const value = roleOf(hub, this.uuid);
+            return value !== undefined && value !== null;
+        }
+        get isDone() {
+            return this.outcome != null;
+        }
+        /** Leaf. PEW does not parent PEW. */
+        get work() {
+            return [this];
+        }
+        /**
+         * Settles when {@link isDone}. Fulfills with {@link outcome} for both
+         * `successful` and `failed` — failure is an outcome, not a rejection.
+         * The fulfillment cannot be `this`: a thenable that resolves to itself
+         * never settles (Promise unwraps `then` forever).
+         */
+        then(onfulfilled, onrejected) {
+            return this.#settled().then(onfulfilled, onrejected);
+        }
+        catch(onrejected) {
+            return this.#settled().catch(onrejected);
+        }
+        finally(onfinally) {
+            return this.#settled().finally(onfinally);
+        }
+        get [(_connectionId_decorators = [syncing], _outcome_decorators = [syncing], _endCause_decorators = [syncing], _endDetail_decorators = [syncing], _outcomeReport_decorators = [syncing], _lastProgress_decorators = [(_a = observable).ref.bind(_a)], _get_progressAwareness_decorators = [computed], _get_workerPresent_decorators = [computed], Symbol.toStringTag)]() {
+            return "WorkExpectation";
+        }
+        #settled() {
+            if (this.#settledPromise != null)
+                return this.#settledPromise;
+            this.#settledPromise = this.isDone
+                ? Promise.resolve(this.#sealedOutcome())
+                : when(() => this.isDone).then(() => this.#sealedOutcome());
+            return this.#settledPromise;
+        }
+        #sealedOutcome() {
+            invariant(this.outcome != null, "WorkExpectation settled without outcome");
+            return this.outcome;
+        }
+        applySettlement(_result) { }
+        #parseOutcomeReport() {
+            if (this.outcomeReport == null)
+                return null;
+            try {
+                return JSON.parse(this.outcomeReport);
+            }
+            catch {
+                return null;
+            }
+        }
+        /**
+         * Durable outcome frame if written, else last progress seen.
+         * {@link ROLE_LANE_OCCUPIED} is not a frame. Retract keeps the last frame.
+         */
+        get report() {
+            if (this.outcomeReport != null)
+                return this.#parseOutcomeReport();
+            return this.progressAwareness;
+        }
+        succeed(cause, detail, outcomeReport, settlement) {
+            if (this.isDone)
+                return false;
+            if (settlement !== undefined) {
+                try {
+                    this.applySettlement(settlement.result);
+                }
+                catch (error) {
+                    this.outcome = "failed";
+                    this.endCause = cause;
+                    this.endDetail = `apply_error: ${String(error)}`;
+                    this.outcomeReport = outcomeReport;
+                    this.markEnded();
+                    return true;
+                }
+            }
+            this.outcome = "successful";
+            this.endCause = cause;
+            this.endDetail = detail;
+            this.outcomeReport = outcomeReport;
+            this.markEnded();
+            return true;
+        }
+        fail(cause, detail, outcomeReport) {
+            if (this.isDone)
+                return false;
+            this.outcome = "failed";
+            this.endCause = cause;
+            this.endDetail = detail;
+            this.outcomeReport = outcomeReport;
+            this.markEnded();
+            return true;
+        }
+    };
+    return WorkExpectation = _classThis;
+})();
+export { WorkExpectation };
+/** Open work whose parent sealed — honor does not start these. */
+export function isTreeOrphan(node) {
+    if (node.isDone)
+        return false;
+    const parent = node.parent;
+    if (parent === null)
+        return false;
+    if (parent instanceof WorkExpectation)
+        return parent.isDone;
+    if (parent instanceof Job)
+        return parent.completed;
+    return false;
+}
+//# sourceMappingURL=WorkExpectation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkExpectation.js","sourceRoot":"","sources":["../../../src/shared/models/WorkExpectation.ts"],"names":[],"mappings":"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","sourcesContent":["import { type PlexusAwareness, syncing } from \"@here.build/plexus\";\nimport { docPlexus } from \"@here.build/plexus/internals\";\nimport { comparer, computed, observable, reaction, when } from \"mobx\";\nimport invariant from \"tiny-invariant\";\n\nimport { type EndCause, type ExpectationOutcome } from \"../control.js\";\nimport { roleOf } from \"../role.js\";\nimport type { SessionAwareness, SessionPlexus } from \"../types.js\";\nimport { Job } from \"./Job.js\";\nimport { WorkContainer } from \"./WorkContainer.js\";\n\n/**\n * Awareness: empty string occupies the role map without a report frame.\n * Retract drops the uuid. Not a durable outcome.\n */\nexport const ROLE_LANE_OCCUPIED = \"\";\n\n@syncing(\"@inhuman.tools/plexus-expectations:WorkExpectation\")\nexport abstract class WorkExpectation<TResult = unknown, TReport = unknown>\n  extends WorkContainer\n  implements Promise<ExpectationOutcome>\n{\n  /**\n   * Kernel catalog key this work rides. Required at construction.\n   * Plexus materialization passes a symbol through unchanged.\n   */\n  @syncing\n  accessor connectionId!: string;\n\n  constructor(init: { readonly connectionId: string } | symbol) {\n    if (typeof init !== \"symbol\") {\n      invariant(\n        typeof init.connectionId === \"string\" && init.connectionId !== \"\",\n        \"WorkExpectation.connectionId is required\",\n      );\n    }\n    super(init);\n  }\n\n  @syncing\n  accessor outcome: ExpectationOutcome | null = null;\n\n  @syncing\n  accessor endCause: EndCause | null = null;\n\n  @syncing\n  accessor endDetail: string | null = null;\n\n  /** Durable last frame as JSON. `\"null\"` when the work ended without a report. */\n  @syncing\n  accessor outcomeReport: string | null = null;\n\n  /** Last live role-map frame this process saw. Retract does not clear it. */\n  @observable.ref private accessor lastProgress: TReport | null = null;\n  #progressCacheStarted = false;\n  #settledPromise: Promise<ExpectationOutcome> | null = null;\n\n  get plexus(): SessionPlexus | null {\n    const doc = this.__doc__;\n    if (!doc) return null;\n    const plexus = docPlexus.get(doc);\n    if (!plexus) return null;\n    return plexus as SessionPlexus;\n  }\n\n  get awareness(): PlexusAwareness<SessionAwareness> | null {\n    const hub = this.plexus?.awareness ?? null;\n    if (hub != null) this.#ensureProgressCache();\n    return hub;\n  }\n\n  // MobX: arm on the first `awareness` read so a later untracked read still\n  // sees the last frame. Dispose on done — a sealed lane is frozen; do not\n  // keep a reaction per expectation for the life of the document.\n  #ensureProgressCache(): void {\n    if (this.#progressCacheStarted) return;\n    this.#progressCacheStarted = true;\n    reaction(\n      () => ({ done: this.isDone, frame: this.#liveProgressFrame() }),\n      ({ done, frame }, _previous, self) => {\n        if (frame !== null) this.lastProgress = frame;\n        if (done) self.dispose();\n      },\n      { fireImmediately: true, equals: comparer.structural },\n    );\n  }\n\n  #liveProgressFrame(): TReport | null {\n    const hub = this.awareness;\n    if (hub == null) return null;\n    const frame = roleOf(hub, this.uuid);\n    if (frame == null || frame === ROLE_LANE_OCCUPIED) return null;\n    return frame as TReport;\n  }\n\n  /** Live progress as the fulfiller tells it. Awareness retract does not drop the last frame. */\n  @computed\n  get progressAwareness(): TReport | null {\n    return this.#liveProgressFrame() ?? this.lastProgress;\n  }\n\n  /** Occupancy on the role map. Not a durable outcome. */\n  @computed\n  get workerPresent(): boolean {\n    const hub = this.awareness;\n    if (hub == null) return false;\n    const value = roleOf(hub, this.uuid);\n    return value !== undefined && value !== null;\n  }\n\n  get isDone(): boolean {\n    return this.outcome != null;\n  }\n\n  /** Leaf. PEW does not parent PEW. */\n  get work(): readonly WorkExpectation[] {\n    return [this];\n  }\n\n  /**\n   * Settles when {@link isDone}. Fulfills with {@link outcome} for both\n   * `successful` and `failed` — failure is an outcome, not a rejection.\n   * The fulfillment cannot be `this`: a thenable that resolves to itself\n   * never settles (Promise unwraps `then` forever).\n   */\n  then<TFulfilled = ExpectationOutcome, TRejected = never>(\n    onfulfilled?: ((value: ExpectationOutcome) => TFulfilled | PromiseLike<TFulfilled>) | null,\n    onrejected?: ((reason: unknown) => TRejected | PromiseLike<TRejected>) | null,\n  ): Promise<TFulfilled | TRejected> {\n    return this.#settled().then(onfulfilled, onrejected);\n  }\n\n  catch<TRejected = never>(\n    onrejected?: ((reason: unknown) => TRejected | PromiseLike<TRejected>) | null,\n  ): Promise<ExpectationOutcome | TRejected> {\n    return this.#settled().catch(onrejected);\n  }\n\n  finally(onfinally?: (() => void) | null): Promise<ExpectationOutcome> {\n    return this.#settled().finally(onfinally);\n  }\n\n  get [Symbol.toStringTag](): string {\n    return \"WorkExpectation\";\n  }\n\n  #settled(): Promise<ExpectationOutcome> {\n    if (this.#settledPromise != null) return this.#settledPromise;\n    this.#settledPromise = this.isDone\n      ? Promise.resolve(this.#sealedOutcome())\n      : when(() => this.isDone).then(() => this.#sealedOutcome());\n    return this.#settledPromise;\n  }\n\n  #sealedOutcome(): ExpectationOutcome {\n    invariant(this.outcome != null, \"WorkExpectation settled without outcome\");\n    return this.outcome;\n  }\n\n  applySettlement(_result: TResult): void {}\n\n  #parseOutcomeReport(): TReport | null {\n    if (this.outcomeReport == null) return null;\n    try {\n      return JSON.parse(this.outcomeReport) as TReport | null;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Durable outcome frame if written, else last progress seen.\n   * {@link ROLE_LANE_OCCUPIED} is not a frame. Retract keeps the last frame.\n   */\n  @computed\n  get report(): TReport | null {\n    if (this.outcomeReport != null) return this.#parseOutcomeReport();\n    return this.progressAwareness;\n  }\n\n  @syncing.action\n  succeed(cause: EndCause, detail: string, outcomeReport: string, settlement?: { readonly result: TResult }): boolean {\n    if (this.isDone) return false;\n    if (settlement !== undefined) {\n      try {\n        this.applySettlement(settlement.result);\n      } catch (error) {\n        this.outcome = \"failed\";\n        this.endCause = cause;\n        this.endDetail = `apply_error: ${String(error)}`;\n        this.outcomeReport = outcomeReport;\n        this.markEnded();\n        return true;\n      }\n    }\n    this.outcome = \"successful\";\n    this.endCause = cause;\n    this.endDetail = detail;\n    this.outcomeReport = outcomeReport;\n    this.markEnded();\n    return true;\n  }\n\n  @syncing.action\n  fail(cause: EndCause, detail: string, outcomeReport: string): boolean {\n    if (this.isDone) return false;\n    this.outcome = \"failed\";\n    this.endCause = cause;\n    this.endDetail = detail;\n    this.outcomeReport = outcomeReport;\n    this.markEnded();\n    return true;\n  }\n}\n\n/** Open work whose parent sealed — honor does not start these. */\nexport function isTreeOrphan(node: WorkExpectation): boolean {\n  if (node.isDone) return false;\n  const parent = node.parent;\n  if (parent === null) return false;\n  if (parent instanceof WorkExpectation) return parent.isDone;\n  if (parent instanceof Job) return parent.completed;\n  return false;\n}\n\n/** Admits every WorkExpectation instantiation. */\nexport type AnyWorkExpectation = WorkExpectation<any, any>;\nexport type ResultOf<E extends AnyWorkExpectation> = Parameters<E[\"applySettlement\"]>[0];\nexport type ReportOf<E extends AnyWorkExpectation> = Exclude<E[\"report\"], null>;\n"]}

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

@@ -0,0 +1,4 @@
+import { WorkExpectation } from "./WorkExpectation.js";
+export declare abstract class WorkExpectationWithIntrospection<TResult = unknown, TReport = unknown, TProposal = never> extends WorkExpectation<TResult, TReport, TProposal> {
+}
+//# sourceMappingURL=WorkExpectationWithIntrospection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkExpectationWithIntrospection.d.ts","sourceRoot":"","sources":["../../../src/shared/models/WorkExpectationWithIntrospection.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,8BACsB,gCAAgC,CACpD,OAAO,GAAG,OAAO,EACjB,OAAO,GAAG,OAAO,EACjB,SAAS,GAAG,KAAK,CACjB,SAAQ,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;CAAG"}

package/dist/shared/models/WorkExpectationWithIntrospection.js

@@ -0,0 +1,28 @@
+import { __esDecorate, __runInitializers } from "tslib";
+/**
+ * Formerly IntrospectingPlexusModel — a PlexusModel helper that WorkExpectation
+ * extended. Flipped: this is a WorkExpectation, not a parent of one.
+ * `plexus` / `awareness` / `getUniqueLanePresence` live on {@link WorkExpectation}.
+ */
+import { syncing } from "@here.build/plexus";
+import { WorkExpectation } from "./WorkExpectation.js";
+let WorkExpectationWithIntrospection = (() => {
+    let _classDecorators = [syncing("@inhuman.tools/plexus-expectations:WorkExpectationWithIntrospection")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = WorkExpectation;
+    var WorkExpectationWithIntrospection = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            WorkExpectationWithIntrospection = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+    };
+    return WorkExpectationWithIntrospection = _classThis;
+})();
+export { WorkExpectationWithIntrospection };
+//# sourceMappingURL=WorkExpectationWithIntrospection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkExpectationWithIntrospection.js","sourceRoot":"","sources":["../../../src/shared/models/WorkExpectationWithIntrospection.ts"],"names":[],"mappings":";AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;IAGjC,gCAAgC;4BADrD,OAAO,CAAC,qEAAqE,CAAC;;;;sBAKrE,eAAe;gDAAvB,SAAQ,WAA4C;;;;YAJtD,6KAIyD;;;YAJnC,uDAAgC;;;;;SAAhC,gCAAgC","sourcesContent":["/**\n * Formerly IntrospectingPlexusModel — a PlexusModel helper that WorkExpectation\n * extended. Flipped: this is a WorkExpectation, not a parent of one.\n * `plexus` / `awareness` / `getUniqueLanePresence` live on {@link WorkExpectation}.\n */\nimport { syncing } from \"@here.build/plexus\";\n\nimport { WorkExpectation } from \"./WorkExpectation.js\";\n\n@syncing(\"@inhuman.tools/plexus-expectations:WorkExpectationWithIntrospection\")\nexport abstract class WorkExpectationWithIntrospection<\n  TResult = unknown,\n  TReport = unknown,\n  TProposal = never,\n> extends WorkExpectation<TResult, TReport, TProposal> {}\n"]}

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

@@ -0,0 +1,7 @@
+export * from "./WorkContainer.js";
+export * from "./WorkExpectation.js";
+export * from "./Job.js";
+export * from "./DriverSpec.js";
+export * from "./ConnectionSpec.js";
+export { type LiveFacts as LiveFacts } from "./jsonRecord.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,KAAK,SAAS,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/shared/models/index.js

@@ -0,0 +1,6 @@
+export * from "./WorkContainer.js";
+export * from "./WorkExpectation.js";
+export * from "./Job.js";
+export * from "./DriverSpec.js";
+export * from "./ConnectionSpec.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC","sourcesContent":["export * from \"./WorkContainer.js\";\nexport * from \"./WorkExpectation.js\";\nexport * from \"./Job.js\";\nexport * from \"./DriverSpec.js\";\nexport * from \"./ConnectionSpec.js\";\nexport { type LiveFacts as LiveFacts } from \"./jsonRecord.js\";\n"]}

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

@@ -0,0 +1,14 @@
+/**
+ * Plexus `@syncing.record` bags are `Record<string, string>`. Values round-trip
+ * through JSON.stringify; `undefined` is omitted.
+ */
+/** Process self-report on ConnectionSpec / DriverSpec. JSON through `liveMap`. */
+export type LiveFacts = {
+    readonly [key: string]: unknown | undefined;
+    readonly models?: readonly string[];
+    readonly tools?: unknown;
+};
+export declare function readJsonRecord(map: Record<string, string>): Record<string, unknown>;
+export declare function writeJsonRecord(map: Record<string, string>, next: Readonly<Record<string, unknown>> | undefined): void;
+export declare function deepFreeze<T>(value: T): T;
+//# sourceMappingURL=jsonRecord.d.ts.map