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

package/dist/shared/attention.js

@@ -0,0 +1,116 @@
+/**
+ * Attention occupancy. Clients publish on kernel awareness; PEW reduces to
+ * none | ambient | focused. Interned connections outlive a session wrap, so
+ * occupancy is not session-plane. Drivers read the reduced token — never clientIds.
+ */
+import { FieldAwareness } from "@here.build/plexus";
+import { ConnectionSpec } from "./models/ConnectionSpec.js";
+import { DriverSpec } from "./models/DriverSpec.js";
+export const ATTENTION_LANE = "attention";
+export const ATTENTION_FOCUS_LANE = "attentionFocus";
+export function attentionRefFromSpec(spec) {
+    if (isConnectionSubject(spec))
+        return { kind: "connection", id: spec.id };
+    return { kind: "driver", name: spec.name };
+}
+export function collectAttentionRefs(source) {
+    if (source == null)
+        return [];
+    if (isAttentionSubject(source))
+        return [attentionRefFromSpec(source)];
+    const out = [];
+    const seen = new Set();
+    for (const item of source) {
+        if (item == null || !isAttentionSubject(item))
+            continue;
+        const ref = attentionRefFromSpec(item);
+        const key = refKey(ref);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(ref);
+    }
+    return out;
+}
+export function publishAttention(hub, refs) {
+    const lane = new FieldAwareness(hub, ATTENTION_LANE);
+    if (refs.length === 0) {
+        lane.clear();
+        return;
+    }
+    lane.set(refs);
+}
+export function publishAttentionFocus(hub, ref) {
+    const lane = new FieldAwareness(hub, ATTENTION_FOCUS_LANE);
+    if (ref == null) {
+        lane.clear();
+        return;
+    }
+    lane.set(ref);
+}
+/** Union of every client's occupancy. Focused wins over ambient. */
+export function attentionOf(hub, target) {
+    const focus = new FieldAwareness(hub, ATTENTION_FOCUS_LANE);
+    for (const clientId of focus.clientIds) {
+        const value = asAttentionRef(focus.getOther(clientId));
+        if (value != null && sameRef(value, target))
+            return "focused";
+    }
+    const ambient = new FieldAwareness(hub, ATTENTION_LANE);
+    for (const clientId of ambient.clientIds) {
+        const list = asAttentionRefList(ambient.getOther(clientId));
+        if (list.some((item) => sameRef(item, target)))
+            return "ambient";
+    }
+    return "none";
+}
+function isConnectionSubject(spec) {
+    if (spec instanceof ConnectionSpec)
+        return true;
+    if (spec instanceof DriverSpec)
+        return false;
+    return "driver" in spec && "configuration" in spec;
+}
+function isAttentionSubject(value) {
+    if (value instanceof ConnectionSpec || value instanceof DriverSpec)
+        return true;
+    if (typeof value !== "object" || value === null)
+        return false;
+    if ("driver" in value && "configuration" in value)
+        return true;
+    return "importPath" in value && "can" in value;
+}
+function asAttentionRef(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const rec = value;
+    if (rec.kind === "driver" && typeof rec.name === "string" && rec.name !== "") {
+        return { kind: "driver", name: rec.name };
+    }
+    if (rec.kind === "connection" && typeof rec.id === "string" && rec.id !== "") {
+        return { kind: "connection", id: rec.id };
+    }
+    return null;
+}
+function asAttentionRefList(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const item of value) {
+        const ref = asAttentionRef(item);
+        if (ref != null)
+            out.push(ref);
+    }
+    return out;
+}
+function sameRef(a, b) {
+    if (a.kind === "driver" && b.kind === "driver")
+        return a.name === b.name;
+    if (a.kind === "connection" && b.kind === "connection")
+        return a.id === b.id;
+    return false;
+}
+function refKey(ref) {
+    return ref.kind === "driver" ? `driver:${ref.name}` : `connection:${ref.id}`;
+}
+//# sourceMappingURL=attention.js.map

package/dist/shared/attention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention.js","sourceRoot":"","sources":["../../src/shared/attention.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAwB,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIpD,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAUrD,MAAM,UAAU,oBAAoB,CAAC,IAAsB;IACzD,IAAI,mBAAmB,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IAC1E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,kBAAkB,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;YAAE,SAAS;QACxD,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAoB,EAAE,IAA6B;IAClF,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,IAAa,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAoB,EAAE,GAAwB;IAClF,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IAC3D,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,GAAY,CAAC,CAAC;AACzB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,GAAoB,EAAE,MAAoB;IACpE,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IAC5D,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvD,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;IAChE,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACxD,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAsB;IACjD,IAAI,IAAI,YAAY,cAAc;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,IAAI,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,QAAQ,IAAI,IAAI,IAAI,eAAe,IAAI,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,IAAI,CAAC;IAChF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,QAAQ,IAAI,KAAK,IAAI,eAAe,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO,YAAY,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,CAAC;AACjD,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,GAAG,GAAG,KAAyD,CAAC;IACtE,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;QAC7E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7E,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,GAAG,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,CAAe,EAAE,CAAe;IAC/C,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC;IACzE,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;IAC7E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,MAAM,CAAC,GAAiB;IAC/B,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,EAAE,EAAE,CAAC;AAC/E,CAAC","sourcesContent":["/**\n * Attention occupancy. Clients publish on kernel awareness; PEW reduces to\n * none | ambient | focused. Interned connections outlive a session wrap, so\n * occupancy is not session-plane. Drivers read the reduced token — never clientIds.\n */\nimport { FieldAwareness, type PlexusAwareness } from \"@here.build/plexus\";\n\nimport { ConnectionSpec } from \"./models/ConnectionSpec.js\";\nimport { DriverSpec } from \"./models/DriverSpec.js\";\n\nexport type Attention = \"none\" | \"ambient\" | \"focused\";\n\nexport const ATTENTION_LANE = \"attention\";\nexport const ATTENTION_FOCUS_LANE = \"attentionFocus\";\n\nexport type AttentionRef =\n  | { readonly kind: \"driver\"; readonly name: string }\n  | { readonly kind: \"connection\"; readonly id: string };\n\nexport type AttentionSubject = DriverSpec | ConnectionSpec;\n\nexport type AttentionSource = AttentionSubject | Iterable<AttentionSubject | null | undefined> | null | undefined;\n\nexport function attentionRefFromSpec(spec: AttentionSubject): AttentionRef {\n  if (isConnectionSubject(spec)) return { kind: \"connection\", id: spec.id };\n  return { kind: \"driver\", name: spec.name };\n}\n\nexport function collectAttentionRefs(source: AttentionSource): AttentionRef[] {\n  if (source == null) return [];\n  if (isAttentionSubject(source)) return [attentionRefFromSpec(source)];\n  const out: AttentionRef[] = [];\n  const seen = new Set<string>();\n  for (const item of source) {\n    if (item == null || !isAttentionSubject(item)) continue;\n    const ref = attentionRefFromSpec(item);\n    const key = refKey(ref);\n    if (seen.has(key)) continue;\n    seen.add(key);\n    out.push(ref);\n  }\n  return out;\n}\n\nexport function publishAttention(hub: PlexusAwareness, refs: readonly AttentionRef[]): void {\n  const lane = new FieldAwareness(hub, ATTENTION_LANE);\n  if (refs.length === 0) {\n    lane.clear();\n    return;\n  }\n  lane.set(refs as never);\n}\n\nexport function publishAttentionFocus(hub: PlexusAwareness, ref: AttentionRef | null): void {\n  const lane = new FieldAwareness(hub, ATTENTION_FOCUS_LANE);\n  if (ref == null) {\n    lane.clear();\n    return;\n  }\n  lane.set(ref as never);\n}\n\n/** Union of every client's occupancy. Focused wins over ambient. */\nexport function attentionOf(hub: PlexusAwareness, target: AttentionRef): Attention {\n  const focus = new FieldAwareness(hub, ATTENTION_FOCUS_LANE);\n  for (const clientId of focus.clientIds) {\n    const value = asAttentionRef(focus.getOther(clientId));\n    if (value != null && sameRef(value, target)) return \"focused\";\n  }\n  const ambient = new FieldAwareness(hub, ATTENTION_LANE);\n  for (const clientId of ambient.clientIds) {\n    const list = asAttentionRefList(ambient.getOther(clientId));\n    if (list.some((item) => sameRef(item, target))) return \"ambient\";\n  }\n  return \"none\";\n}\n\nfunction isConnectionSubject(spec: AttentionSubject): spec is ConnectionSpec {\n  if (spec instanceof ConnectionSpec) return true;\n  if (spec instanceof DriverSpec) return false;\n  return \"driver\" in spec && \"configuration\" in spec;\n}\n\nfunction isAttentionSubject(value: unknown): value is AttentionSubject {\n  if (value instanceof ConnectionSpec || value instanceof DriverSpec) return true;\n  if (typeof value !== \"object\" || value === null) return false;\n  if (\"driver\" in value && \"configuration\" in value) return true;\n  return \"importPath\" in value && \"can\" in value;\n}\n\nfunction asAttentionRef(value: unknown): AttentionRef | null {\n  if (typeof value !== \"object\" || value === null) return null;\n  const rec = value as { kind?: unknown; name?: unknown; id?: unknown };\n  if (rec.kind === \"driver\" && typeof rec.name === \"string\" && rec.name !== \"\") {\n    return { kind: \"driver\", name: rec.name };\n  }\n  if (rec.kind === \"connection\" && typeof rec.id === \"string\" && rec.id !== \"\") {\n    return { kind: \"connection\", id: rec.id };\n  }\n  return null;\n}\n\nfunction asAttentionRefList(value: unknown): AttentionRef[] {\n  if (!Array.isArray(value)) return [];\n  const out: AttentionRef[] = [];\n  for (const item of value) {\n    const ref = asAttentionRef(item);\n    if (ref != null) out.push(ref);\n  }\n  return out;\n}\n\nfunction sameRef(a: AttentionRef, b: AttentionRef): boolean {\n  if (a.kind === \"driver\" && b.kind === \"driver\") return a.name === b.name;\n  if (a.kind === \"connection\" && b.kind === \"connection\") return a.id === b.id;\n  return false;\n}\n\nfunction refKey(ref: AttentionRef): string {\n  return ref.kind === \"driver\" ? `driver:${ref.name}` : `connection:${ref.id}`;\n}\n"]}

package/dist/shared/control.d.ts

@@ -0,0 +1,4 @@
+/** `null` on the entity means not done. Cancel is `failed`, not a fourth state. */
+export type ExpectationOutcome = "successful" | "failed";
+export type EndCause = "settled" | "cancel" | "crash";
+//# sourceMappingURL=control.d.ts.map

package/dist/shared/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../src/shared/control.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEzD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC"}

package/dist/shared/control.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=control.js.map

package/dist/shared/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../src/shared/control.ts"],"names":[],"mappings":"","sourcesContent":["/** `null` on the entity means not done. Cancel is `failed`, not a fourth state. */\nexport type ExpectationOutcome = \"successful\" | \"failed\";\n\nexport type EndCause = \"settled\" | \"cancel\" | \"crash\";\n"]}

package/dist/shared/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./models/index.js";
+export * from "./revalidation-demand.js";
+export * from "./control.js";
+export * from "./map-field-awareness.js";
+export * from "./role.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,7 @@
+export * from "./models/index.js";
+export * from "./revalidation-demand.js";
+export * from "./control.js";
+export * from "./map-field-awareness.js";
+export * from "./role.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./models/index.js\";\nexport * from \"./revalidation-demand.js\";\nexport * from \"./control.js\";\nexport * from \"./map-field-awareness.js\";\nexport * from \"./role.js\";\nexport * from \"./types.js\";\n"]}

package/dist/shared/map-field-awareness.d.ts

@@ -0,0 +1,19 @@
+/**
+ * One awareness field as a string-keyed map.
+ *
+ * Each client owns its map. A write patches the local map. A read is the
+ * first present entry across bases, local then others, so a peer's key is
+ * visible here. `undefined` means the key is absent; `""` and `null` are
+ * stored values.
+ *
+ * Callers read and write through this lens. A process-local map misses
+ * every peer entry.
+ */
+import { FieldAwareness, type AwarenessShape, type PlexusAwareness, type ShapeOfAwareness } from "@here.build/plexus";
+export declare class MapFieldAwareness<A extends PlexusAwareness<AwarenessShape> = PlexusAwareness, K extends string & keyof ShapeOfAwareness<A> = string & keyof ShapeOfAwareness<A>> extends FieldAwareness<A, K> {
+    #private;
+    mapGet(key: string): unknown;
+    mapSet(key: string, value: unknown): void;
+    mapDelete(key: string): void;
+}
+//# sourceMappingURL=map-field-awareness.d.ts.map

package/dist/shared/map-field-awareness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-field-awareness.d.ts","sourceRoot":"","sources":["../../src/shared/map-field-awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,iBAAiB,CAC5B,CAAC,SAAS,eAAe,CAAC,cAAc,CAAC,GAAG,eAAe,EAC3D,CAAC,SAAS,MAAM,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,CACjF,SAAQ,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;;IAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAU5B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIzC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAmB7B"}

package/dist/shared/map-field-awareness.js

@@ -0,0 +1,58 @@
+/**
+ * One awareness field as a string-keyed map.
+ *
+ * Each client owns its map. A write patches the local map. A read is the
+ * first present entry across bases, local then others, so a peer's key is
+ * visible here. `undefined` means the key is absent; `""` and `null` are
+ * stored values.
+ *
+ * Callers read and write through this lens. A process-local map misses
+ * every peer entry.
+ */
+import { FieldAwareness, } from "@here.build/plexus";
+export class MapFieldAwareness extends FieldAwareness {
+    mapGet(key) {
+        const own = readAt(this.get(), key);
+        if (own !== undefined)
+            return own;
+        for (const id of this.clientIds) {
+            const value = readAt(this.getOther(id), key);
+            if (value !== undefined)
+                return value;
+        }
+        return undefined;
+    }
+    mapSet(key, value) {
+        this.#write({ ...this.#record(), [key]: value });
+    }
+    mapDelete(key) {
+        const current = this.#record();
+        if (!(key in current))
+            return;
+        delete current[key];
+        // An empty object is still a published value. The last delete leaves the lane null.
+        if (Object.keys(current).length === 0)
+            this.clear();
+        else
+            this.#write(current);
+    }
+    #record() {
+        const value = this.get();
+        if (!isRecord(value))
+            return {};
+        return { ...value };
+    }
+    /** `set` wants the lane's serializable value. The bag is a plain object. */
+    #write(bag) {
+        this.set(bag);
+    }
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function readAt(value, key) {
+    if (!isRecord(value) || !(key in value))
+        return undefined;
+    return value[key];
+}
+//# sourceMappingURL=map-field-awareness.js.map

package/dist/shared/map-field-awareness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-field-awareness.js","sourceRoot":"","sources":["../../src/shared/map-field-awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,cAAc,GAIf,MAAM,oBAAoB,CAAC;AAE5B,MAAM,OAAO,iBAGX,SAAQ,cAAoB;IAC5B,MAAM,CAAC,GAAW;QAChB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QACpC,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC;QAClC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YAC7C,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;QACxC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,KAAc;QAChC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC;YAAE,OAAO;QAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;QACpB,oFAAoF;QACpF,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,KAAK,EAAE,CAAC;;YAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAChC,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,GAA4B;QACjC,IAAI,CAAC,GAAG,CAAC,GAA6B,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,MAAM,CAAC,KAAc,EAAE,GAAW;IACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC","sourcesContent":["/**\n * One awareness field as a string-keyed map.\n *\n * Each client owns its map. A write patches the local map. A read is the\n * first present entry across bases, local then others, so a peer's key is\n * visible here. `undefined` means the key is absent; `\"\"` and `null` are\n * stored values.\n *\n * Callers read and write through this lens. A process-local map misses\n * every peer entry.\n */\nimport {\n  FieldAwareness,\n  type AwarenessShape,\n  type PlexusAwareness,\n  type ShapeOfAwareness,\n} from \"@here.build/plexus\";\n\nexport class MapFieldAwareness<\n  A extends PlexusAwareness<AwarenessShape> = PlexusAwareness,\n  K extends string & keyof ShapeOfAwareness<A> = string & keyof ShapeOfAwareness<A>,\n> extends FieldAwareness<A, K> {\n  mapGet(key: string): unknown {\n    const own = readAt(this.get(), key);\n    if (own !== undefined) return own;\n    for (const id of this.clientIds) {\n      const value = readAt(this.getOther(id), key);\n      if (value !== undefined) return value;\n    }\n    return undefined;\n  }\n\n  mapSet(key: string, value: unknown): void {\n    this.#write({ ...this.#record(), [key]: value });\n  }\n\n  mapDelete(key: string): void {\n    const current = this.#record();\n    if (!(key in current)) return;\n    delete current[key];\n    // An empty object is still a published value. The last delete leaves the lane null.\n    if (Object.keys(current).length === 0) this.clear();\n    else this.#write(current);\n  }\n\n  #record(): Record<string, unknown> {\n    const value = this.get();\n    if (!isRecord(value)) return {};\n    return { ...value };\n  }\n\n  /** `set` wants the lane's serializable value. The bag is a plain object. */\n  #write(bag: Record<string, unknown>): void {\n    this.set(bag as ShapeOfAwareness<A>[K]);\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction readAt(value: unknown, key: string): unknown {\n  if (!isRecord(value) || !(key in value)) return undefined;\n  return value[key];\n}\n"]}

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

@@ -0,0 +1,15 @@
+import { WorkExpectation } from "./WorkExpectation.js";
+export declare abstract class ApprovableExpectation<TResult = unknown, TReport = unknown, TProposal = never> extends WorkExpectation<TResult, TReport, TProposal> {
+    accessor policyResult: Record<string, string>;
+    accessor policyAsk: Record<string, string>;
+    accessor explicitApprovalResult: true | false | null;
+    accessor judges: Record<string, WorkExpectation>;
+    policyResultOf(id: string): boolean | null;
+    writePolicyResult(id: string, value: boolean): void;
+    policyAskOf(id: string): boolean;
+    writePolicyAsk(id: string): void;
+    effectiveApproval(id: string): boolean | null;
+    get approvalWork(): readonly WorkExpectation[];
+    get work(): readonly WorkExpectation[];
+}
+//# sourceMappingURL=ApprovableExpectation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApprovableExpectation.d.ts","sourceRoot":"","sources":["../../../src/shared/models/ApprovableExpectation.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,8BACsB,qBAAqB,CACzC,OAAO,GAAG,OAAO,EACjB,OAAO,GAAG,OAAO,EACjB,SAAS,GAAG,KAAK,CACjB,SAAQ,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;IAEpD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAGnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAGhD,QAAQ,CAAC,sBAAsB,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,CAAQ;IAG5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAM;IAEtD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAKzC;IAED,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAElD;IAED,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE/B;IAED,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE/B;IAED,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAG5C;IAED,IAAI,YAAY,IAAI,SAAS,eAAe,EAAE,CAE7C;IAED,IACa,IAAI,IAAI,SAAS,eAAe,EAAE,CAE9C;CACF"}

package/dist/shared/models/ApprovableExpectation.js

@@ -0,0 +1,138 @@
+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;
+};
+/**
+ * Work that always runs the approval flow.
+ *
+ * `id` is an argument — this model does not read SessionRoot. Explicit wins
+ * when not null. `judges` is a child record of WorkExpectation so PEW does
+ * not import harness (runtime: harness CompletionExpectation).
+ *
+ * Per-policy facts are string records (`"true"` | `"false"`; absent = unset)
+ * because live `@syncing.record` bags are `Record<string, string>`.
+ *
+ * docs/design/approval.md
+ */
+import { syncing } from "@here.build/plexus";
+import { computed } from "mobx";
+import { WorkExpectation } from "./WorkExpectation.js";
+let ApprovableExpectation = (() => {
+    var _a, _b, _c;
+    let _classDecorators = [syncing("@inhuman.tools/plexus-expectations:ApprovableExpectation")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = WorkExpectation;
+    let _instanceExtraInitializers = [];
+    let _policyResult_decorators;
+    let _policyResult_initializers = [];
+    let _policyResult_extraInitializers = [];
+    let _policyAsk_decorators;
+    let _policyAsk_initializers = [];
+    let _policyAsk_extraInitializers = [];
+    let _explicitApprovalResult_decorators;
+    let _explicitApprovalResult_initializers = [];
+    let _explicitApprovalResult_extraInitializers = [];
+    let _judges_decorators;
+    let _judges_initializers = [];
+    let _judges_extraInitializers = [];
+    let _get_work_decorators;
+    var ApprovableExpectation = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _policyResult_decorators = [(_a = syncing).record.bind(_a)];
+            _policyAsk_decorators = [(_b = syncing).record.bind(_b)];
+            _explicitApprovalResult_decorators = [syncing];
+            _judges_decorators = [(_c = syncing.child).record.bind(_c)];
+            _get_work_decorators = [computed];
+            __esDecorate(this, null, _policyResult_decorators, { kind: "accessor", name: "policyResult", static: false, private: false, access: { has: obj => "policyResult" in obj, get: obj => obj.policyResult, set: (obj, value) => { obj.policyResult = value; } }, metadata: _metadata }, _policyResult_initializers, _policyResult_extraInitializers);
+            __esDecorate(this, null, _policyAsk_decorators, { kind: "accessor", name: "policyAsk", static: false, private: false, access: { has: obj => "policyAsk" in obj, get: obj => obj.policyAsk, set: (obj, value) => { obj.policyAsk = value; } }, metadata: _metadata }, _policyAsk_initializers, _policyAsk_extraInitializers);
+            __esDecorate(this, null, _explicitApprovalResult_decorators, { kind: "accessor", name: "explicitApprovalResult", static: false, private: false, access: { has: obj => "explicitApprovalResult" in obj, get: obj => obj.explicitApprovalResult, set: (obj, value) => { obj.explicitApprovalResult = value; } }, metadata: _metadata }, _explicitApprovalResult_initializers, _explicitApprovalResult_extraInitializers);
+            __esDecorate(this, null, _judges_decorators, { kind: "accessor", name: "judges", static: false, private: false, access: { has: obj => "judges" in obj, get: obj => obj.judges, set: (obj, value) => { obj.judges = value; } }, metadata: _metadata }, _judges_initializers, _judges_extraInitializers);
+            __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);
+            ApprovableExpectation = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        #policyResult_accessor_storage = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _policyResult_initializers, {}));
+        get policyResult() { return this.#policyResult_accessor_storage; }
+        set policyResult(value) { this.#policyResult_accessor_storage = value; }
+        #policyAsk_accessor_storage = (__runInitializers(this, _policyResult_extraInitializers), __runInitializers(this, _policyAsk_initializers, {}));
+        get policyAsk() { return this.#policyAsk_accessor_storage; }
+        set policyAsk(value) { this.#policyAsk_accessor_storage = value; }
+        #explicitApprovalResult_accessor_storage = (__runInitializers(this, _policyAsk_extraInitializers), __runInitializers(this, _explicitApprovalResult_initializers, null));
+        get explicitApprovalResult() { return this.#explicitApprovalResult_accessor_storage; }
+        set explicitApprovalResult(value) { this.#explicitApprovalResult_accessor_storage = value; }
+        #judges_accessor_storage = (__runInitializers(this, _explicitApprovalResult_extraInitializers), __runInitializers(this, _judges_initializers, {}));
+        get judges() { return this.#judges_accessor_storage; }
+        set judges(value) { this.#judges_accessor_storage = value; }
+        policyResultOf(id) {
+            const raw = this.policyResult[id];
+            if (raw === "true")
+                return true;
+            if (raw === "false")
+                return false;
+            return null;
+        }
+        writePolicyResult(id, value) {
+            this.policyResult[id] = value ? "true" : "false";
+        }
+        policyAskOf(id) {
+            return this.policyAsk[id] === "true";
+        }
+        writePolicyAsk(id) {
+            this.policyAsk[id] = "true";
+        }
+        effectiveApproval(id) {
+            if (this.explicitApprovalResult !== null)
+                return this.explicitApprovalResult;
+            return this.policyResultOf(id);
+        }
+        get approvalWork() {
+            return Object.values(this.judges);
+        }
+        get work() {
+            return [this, ...this.approvalWork];
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _judges_extraInitializers);
+        }
+    };
+    return ApprovableExpectation = _classThis;
+})();
+export { ApprovableExpectation };
+//# sourceMappingURL=ApprovableExpectation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApprovableExpectation.js","sourceRoot":"","sources":["../../../src/shared/models/ApprovableExpectation.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;IAGjC,qBAAqB;;4BAD1C,OAAO,CAAC,0DAA0D,CAAC;;;;sBAK1D,eAAe;;;;;;;;;;;;;;;qCAAvB,SAAQ,WAA4C;;;;wCACnD,CAAA,KAAA,OAAO,EAAC,MAAM;qCAGd,CAAA,KAAA,OAAO,EAAC,MAAM;kDAGd,OAAO;kCAGP,CAAA,KAAA,OAAO,CAAC,KAAK,EAAC,MAAM;oCA+BpB,QAAQ;YAvCT,yLAAS,YAAY,6BAAZ,YAAY,mGAA8B;YAGnD,gLAAS,SAAS,6BAAT,SAAS,6FAA8B;YAGhD,uNAAS,sBAAsB,6BAAtB,sBAAsB,uHAA6B;YAG5D,uKAAS,MAAM,6BAAN,MAAM,uFAAuC;YA+BtD,mKAAa,IAAI,6DAEhB;YAhDH,6KAiDC;;;YAjDqB,uDAAqB;;QAMzC,kCANoB,mDAAqB,sDAMO,EAAE,GAAC;QAAnD,IAAS,YAAY,kDAA8B;QAAnD,IAAS,YAAY,wDAA8B;QAGnD,0IAA6C,EAAE,GAAC;QAAhD,IAAS,SAAS,+CAA8B;QAAhD,IAAS,SAAS,qDAA8B;QAGhD,iKAAuD,IAAI,GAAC;QAA5D,IAAS,sBAAsB,4DAA6B;QAA5D,IAAS,sBAAsB,kEAA6B;QAG5D,8IAAmD,EAAE,GAAC;QAAtD,IAAS,MAAM,4CAAuC;QAAtD,IAAS,MAAM,kDAAuC;QAEtD,cAAc,CAAC,EAAU;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,GAAG,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC;YAChC,IAAI,GAAG,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,iBAAiB,CAAC,EAAU,EAAE,KAAc;YAC1C,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QACnD,CAAC;QAED,WAAW,CAAC,EAAU;YACpB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;QACvC,CAAC;QAED,cAAc,CAAC,EAAU;YACvB,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;QAC9B,CAAC;QAED,iBAAiB,CAAC,EAAU;YAC1B,IAAI,IAAI,CAAC,sBAAsB,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC,sBAAsB,CAAC;YAC7E,OAAO,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;QAED,IAAI,YAAY;YACd,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAGD,IAAa,IAAI;YACf,OAAO,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;QACtC,CAAC;;;;;;;;SAhDmB,qBAAqB","sourcesContent":["/**\n * Work that always runs the approval flow.\n *\n * `id` is an argument — this model does not read SessionRoot. Explicit wins\n * when not null. `judges` is a child record of WorkExpectation so PEW does\n * not import harness (runtime: harness CompletionExpectation).\n *\n * Per-policy facts are string records (`\"true\"` | `\"false\"`; absent = unset)\n * because live `@syncing.record` bags are `Record<string, string>`.\n *\n * docs/design/approval.md\n */\nimport { syncing } from \"@here.build/plexus\";\nimport { computed } from \"mobx\";\n\nimport { WorkExpectation } from \"./WorkExpectation.js\";\n\n@syncing(\"@inhuman.tools/plexus-expectations:ApprovableExpectation\")\nexport abstract class ApprovableExpectation<\n  TResult = unknown,\n  TReport = unknown,\n  TProposal = never,\n> extends WorkExpectation<TResult, TReport, TProposal> {\n  @syncing.record\n  accessor policyResult: Record<string, string> = {};\n\n  @syncing.record\n  accessor policyAsk: Record<string, string> = {};\n\n  @syncing\n  accessor explicitApprovalResult: true | false | null = null;\n\n  @syncing.child.record\n  accessor judges: Record<string, WorkExpectation> = {};\n\n  policyResultOf(id: string): boolean | null {\n    const raw = this.policyResult[id];\n    if (raw === \"true\") return true;\n    if (raw === \"false\") return false;\n    return null;\n  }\n\n  writePolicyResult(id: string, value: boolean): void {\n    this.policyResult[id] = value ? \"true\" : \"false\";\n  }\n\n  policyAskOf(id: string): boolean {\n    return this.policyAsk[id] === \"true\";\n  }\n\n  writePolicyAsk(id: string): void {\n    this.policyAsk[id] = \"true\";\n  }\n\n  effectiveApproval(id: string): boolean | null {\n    if (this.explicitApprovalResult !== null) return this.explicitApprovalResult;\n    return this.policyResultOf(id);\n  }\n\n  get approvalWork(): readonly WorkExpectation[] {\n    return Object.values(this.judges);\n  }\n\n  @computed\n  override get work(): readonly WorkExpectation[] {\n    return [this, ...this.approvalWork];\n  }\n}\n"]}

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

@@ -0,0 +1,44 @@
+/**
+ * YAML connection inventory. Settings ride a private synced bag; the public
+ * face is {@link configuration} (deep-readonly get, whole-bag set).
+ * Secrets never live here. PEW process facts are `readyState` / `error`
+ * plus {@link live}. YAML file fill does not touch process facts.
+ */
+import { PlexusModel } from "@here.build/plexus";
+import type { ReadyState, SpecCatalog } from "../types.js";
+import { DriverSpec } from "./DriverSpec.js";
+import { type LiveFacts } from "./jsonRecord.js";
+export type ConfigurationAtom = string | number | boolean | null;
+export type ConfigurationValue = ConfigurationAtom | readonly ConfigurationValue[] | {
+    readonly [key: string]: ConfigurationValue;
+};
+export type ConnectionConfiguration = {
+    readonly [key: string]: ConfigurationValue;
+};
+export declare class ConnectionSpec extends PlexusModel<SpecCatalog | null> {
+    #private;
+    get id(): string;
+    /** Only `failed` is a problem. */
+    get issue(): "failed" | false;
+    /** YAML `driver:` resolves to this entity. */
+    accessor driver: DriverSpec;
+    accessor name: string;
+    accessor annotation: string;
+    private accessor configurationMap;
+    /** PEW instance self-report. `null` = never ensured. YAML fill does not touch this. */
+    accessor readyState: ReadyState;
+    accessor error: string;
+    private accessor liveMap;
+    /** Frozen through; assign the whole bag to write. */
+    get configuration(): ConnectionConfiguration;
+    set configuration(settings: Readonly<Record<string, unknown>> | undefined);
+    get live(): LiveFacts;
+    set live(next: Readonly<Record<string, unknown>> | undefined);
+    /** Process self-report. YAML fill does not call this. */
+    stampProcess(next: {
+        readonly readyState: ReadyState;
+        readonly error: string;
+        readonly live: Readonly<Record<string, unknown>> | undefined;
+    }): void;
+}
+//# sourceMappingURL=ConnectionSpec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionSpec.d.ts","sourceRoot":"","sources":["../../../src/shared/models/ConnectionSpec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAW,MAAM,oBAAoB,CAAC;AAG1D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAElF,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAC1B,iBAAiB,GACjB,SAAS,kBAAkB,EAAE,GAC7B;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAE,CAAC;AACnD,MAAM,MAAM,uBAAuB,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAE,CAAC;AAErF,qBACa,cAAe,SAAQ,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC;;IACjE,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,kCAAkC;IAClC,IAAI,KAAK,IAAI,QAAQ,GAAG,KAAK,CAE5B;IAED,8CAA8C;IACrC,QAAQ,CAAC,MAAM,EAAG,UAAU,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAM;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8B;IAE/E,uFAAuF;IAC9E,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAQ;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IAEtE,qDAAqD;IACrD,IACI,aAAa,IAAI,uBAAuB,CAE3C;IAED,IAAI,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EAExE;IAOD,IACI,IAAI,IAAI,SAAS,CAEpB;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EAE3D;IAOD,yDAAyD;IAEzD,YAAY,CAAC,IAAI,EAAE;QACjB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;QAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;KAC9D,GAAG,IAAI;CAKT"}