@loomwork/ui-lineage 0.0.0-stage → 0.1.1

package/dist/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":";;AAeA,oEAoIC;AAhJD,iFAAiF;AACjF,mGAAmG;AACnG,mGAAmG;AACnG,+FAA+F;AAC/F,wCAAwC;AAExC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC;IAC1B,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,EAAE,CAAC,EAAE;IACd,EAAE,EAAE,0BAA0B;CAC/B,CAAC,CAAC;AAEI,KAAK,UAAU,4BAA4B,CAChD,IAAgD;IAEhD,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,EAAE,CAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAyC;QAClD;YACE,6BAA6B;YAC7B,KAAK,IAAI,EAAE;gBACT,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;oBAAE,IAAI,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC;YACvF,CAAC;SACF;QACD;YACE,wDAAwD;YACxD,KAAK,IAAI,EAAE;gBACT,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjD,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjD,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC;oBACxD,IAAI,CAAC,iBAAiB,EAAE,+BAA+B,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACnF,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK;oBAC3C,IAAI,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACrF,CAAC;SACF;QACD;YACE,0EAA0E;YAC1E,KAAK,IAAI,EAAE;gBACT,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzC,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnD,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;oBACrB,IAAI,CAAC,cAAc,EAAE,2BAA2B,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvD,IAAI,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC;oBAC7B,IAAI,CAAC,YAAY,EAAE,2CAA2C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACzF,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;oBAAE,IAAI,CAAC,eAAe,EAAE,yBAAyB,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC;YACzF,CAAC;SACF;QACD;YACE,qDAAqD;YACrD,KAAK,IAAI,EAAE;gBACT,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CACvE,CAAC;gBACF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC7C,IAAI,IAAI,KAAK,CAAC;oBAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,8CAA8C,CAAC,CAAC;gBACpF,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACrC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;oBAAE,IAAI,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC;YACnF,CAAC;SACF;QACD;YACE,uBAAuB;YACvB,KAAK,IAAI,EAAE;gBACT,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzC,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnD,IAAI,CAAC,CAAC,CAAC,EAAE;oBACP,IAAI,CAAC,WAAW,EAAE,gEAAgE,CAAC,CAAC;gBACtF,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;oBAC5C,IAAI,CAAC,WAAW,EAAE,+BAA+B,CAAC,CAAC;YACvD,CAAC;SACF;QACD;YACE,sDAAsD;YACtD,KAAK,IAAI,EAAE;gBACT,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzD,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE;oBAC9B,IAAI,EAAE,qBAAqB;oBAC3B,OAAO;oBACP,EAAE,EAAE,0BAA0B;iBAC/B,CAAC,CAAC;gBACH,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzC,IACE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;oBACjC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;oBAExD,IAAI,CAAC,SAAS,EAAE,2DAA2D,CAAC,CAAC;gBAE7E,KACD,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC1C,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAClD,IAAI,CAAC,UAAU,EAAE,kDAAkD,CAAC,CAAC;gBACvE,IACE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,qBAAqB;oBACzC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,0BAA0B;oBAE5C,IAAI,CAAC,QAAQ,EAAE,+BAA+B,CAAC,CAAC;YACpD,CAAC;SACF;QACD;YACE,gFAAgF;YAChF,KAAK,IAAI,EAAE;gBACT,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;oBAAE,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtC,MAAM,IAAI,GAAG,CAAC,CAAkC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;gBACrF,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;oBACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK;wBAClD,IAAI,CAAC,WAAW,EAAE,4DAA4D,CAAC,CAAC;oBAClF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC;wBACvD,IAAI,CAAC,WAAW,EAAE,wDAAwD,CAAC,CAAC;oBAC9E,IAAI,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;wBACtD,IAAI,CAAC,WAAW,EAAE,2CAA2C,CAAC,CAAC;gBACnE,CAAC;gBACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;oBAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK;wBACnD,IAAI,CAAC,YAAY,EAAE,yDAAyD,CAAC,CAAC;oBAChF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK;wBACtD,IAAI,CAAC,YAAY,EAAE,0CAA0C,CAAC,CAAC;oBACjE,IAAI,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;wBAClD,IAAI,CAAC,YAAY,EAAE,oCAAoC,CAAC,CAAC;gBAC7D,CAAC;gBACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;oBACpC,MAAM,GAAG,GAAa,EAAE,CAAC;oBACzB,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE;wBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACzD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM;wBAC5D,IAAI,CAAC,cAAc,EAAE,+CAA+C,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;SACF;KACF,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,GAAG,EAAE,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/derive.d.ts

@@ -0,0 +1,15 @@
+import { type Experience, type Provenance } from "@loomwork/ui-core";
+export interface Authored {
+    readonly by: Provenance;
+    readonly at: string;
+}
+/** The unsealed artifact a revert to `target` produces on top of `head`. Same line, same id. */
+export declare function revertArtifact(head: Experience, target: Experience, a: Authored): Experience;
+/**
+ * The unsealed first artifact of the line `experienceId`, forked from `source` with the classes of
+ * `carriedFrom` (the source line's head at the fork) carried in. Its parent is `source` — a version
+ * of ANOTHER line, which is how a branch is told from a genesis.
+ */
+export declare function branchArtifact(source: Experience, carriedFrom: Experience, experienceId: string, a: Authored): Experience;
+export declare const authorOf: (by: Provenance) => string;
+//# sourceMappingURL=derive.d.ts.map

package/dist/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAgB,MAAM,mBAAmB,CAAC;AAkBnF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,GAAG,UAAU,CAS5F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,UAAU,EACvB,YAAY,EAAE,MAAM,EACpB,CAAC,EAAE,QAAQ,GACV,UAAU,CASZ;AAED,eAAO,MAAM,QAAQ,GAAI,IAAI,UAAU,KAAG,MAA2C,CAAC"}

package/dist/derive.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.authorOf = void 0;
+exports.revertArtifact = revertArtifact;
+exports.branchArtifact = branchArtifact;
+const ui_core_1 = require("@loomwork/ui-core");
+/** The unsealed artifact a revert to `target` produces on top of `head`. Same line, same id. */
+function revertArtifact(head, target, a) {
+    const adopted = {
+        ...target,
+        experienceId: head.experienceId,
+        versionHash: "",
+        parents: [head.versionHash],
+        meta: { author: (0, exports.authorOf)(a.by), createdAt: a.at, sourceKind: "revert" },
+    };
+    return (0, ui_core_1.carryClasses)(head, adopted);
+}
+/**
+ * The unsealed first artifact of the line `experienceId`, forked from `source` with the classes of
+ * `carriedFrom` (the source line's head at the fork) carried in. Its parent is `source` — a version
+ * of ANOTHER line, which is how a branch is told from a genesis.
+ */
+function branchArtifact(source, carriedFrom, experienceId, a) {
+    const adopted = {
+        ...source,
+        experienceId,
+        versionHash: "",
+        parents: [source.versionHash],
+        meta: { author: (0, exports.authorOf)(a.by), createdAt: a.at, sourceKind: "branch" },
+    };
+    return (0, ui_core_1.carryClasses)(carriedFrom, adopted);
+}
+const authorOf = (by) => by.agentId ?? by.ref ?? by.source;
+exports.authorOf = authorOf;
+//# sourceMappingURL=derive.js.map

package/dist/derive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.js","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":";;;AAwBA,wCASC;AAOD,wCAcC;AAtDD,+CAAmF;AAuBnF,gGAAgG;AAChG,SAAgB,cAAc,CAAC,IAAgB,EAAE,MAAkB,EAAE,CAAW;IAC9E,MAAM,OAAO,GAAe;QAC1B,GAAG,MAAM;QACT,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;QAC3B,IAAI,EAAE,EAAE,MAAM,EAAE,IAAA,gBAAQ,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE;KACxE,CAAC;IACF,OAAO,IAAA,sBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAC5B,MAAkB,EAClB,WAAuB,EACvB,YAAoB,EACpB,CAAW;IAEX,MAAM,OAAO,GAAe;QAC1B,GAAG,MAAM;QACT,YAAY;QACZ,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC;QAC7B,IAAI,EAAE,EAAE,MAAM,EAAE,IAAA,gBAAQ,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE;KACxE,CAAC;IACF,OAAO,IAAA,sBAAY,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAEM,MAAM,QAAQ,GAAG,CAAC,EAAc,EAAU,EAAE,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC;AAAzE,QAAA,QAAQ,YAAiE"}

package/dist/esm/conformance.js

@@ -0,0 +1,140 @@
+// ── The LineageStore conformance kit ──────────────────────────────────────────
+// Returns findings (a test asserts the list is empty), never throws: a store that throws on a case
+// is reported as a finding, like `checkPlannerConformance`. Each case uses a fresh line id, so one
+// `make()` store serves them all — but a backend that cannot isolate lines is exactly what the
+// "lines are independent" case catches.
+const rec = (n) => ({
+    type: "EXPERIENCE_COMPOSED",
+    payload: { n },
+    at: "2026-10-06T00:00:00.000Z",
+});
+export async function checkLineageStoreConformance(make) {
+    const findings = [];
+    const fail = (code, message) => findings.push({ code, severity: "error", message });
+    const store = await make();
+    const cases = [
+        [
+            "an unknown line reads empty",
+            async () => {
+                const r = await store.read("c-empty");
+                if (r.length !== 0)
+                    fail("read-unknown", `an unknown line read ${r.length} records`);
+            },
+        ],
+        [
+            "append at tip 0 wins sequence 1; the sequence is dense",
+            async () => {
+                const a = await store.append("c-seq", 0, rec(1));
+                const b = await store.append("c-seq", 1, rec(2));
+                if (!a.ok || a.sequence !== 1 || !b.ok || b.sequence !== 2)
+                    fail("append-sequence", `sequential appends returned ${JSON.stringify([a, b])}`);
+                const r = await store.read("c-seq");
+                if (r.map((x) => x.sequence).join() !== "1,2")
+                    fail("read-order", `read returned sequences ${r.map((x) => x.sequence).join()}`);
+            },
+        ],
+        [
+            "a stale expectedSequence is refused with the real tip and writes nothing",
+            async () => {
+                await store.append("c-stale", 0, rec(1));
+                const s = await store.append("c-stale", 0, rec(2));
+                if (s.ok || s.tip !== 1)
+                    fail("stale-append", `a stale append returned ${JSON.stringify(s)}`);
+                const ahead = await store.append("c-stale", 5, rec(3));
+                if (ahead.ok || ahead.tip !== 1)
+                    fail("gap-append", `an append past the tip (a gap) returned ${JSON.stringify(ahead)}`);
+                const r = await store.read("c-stale");
+                if (r.length !== 1)
+                    fail("refused-wrote", `a refused append left ${r.length} records`);
+            },
+        ],
+        [
+            "of N concurrent appends at one tip exactly one wins",
+            async () => {
+                const outs = await Promise.all(Array.from({ length: 8 }, (_, i) => store.append("c-race", 0, rec(i))));
+                const wins = outs.filter((o) => o.ok).length;
+                if (wins !== 1)
+                    fail("race", `${wins} of 8 concurrent appends at the same tip won`);
+                const r = await store.read("c-race");
+                if (r.length !== 1)
+                    fail("race-log", `the raced line holds ${r.length} records`);
+            },
+        ],
+        [
+            "lines are independent",
+            async () => {
+                await store.append("c-iso-a", 0, rec(1));
+                const b = await store.append("c-iso-b", 0, rec(2));
+                if (!b.ok)
+                    fail("isolation", "an append to a second line was refused by the first line's tip");
+                if ((await store.read("c-iso-a")).length !== 1)
+                    fail("isolation", "a line holds another's record");
+            },
+        ],
+        [
+            "payloads round-trip and neither side aliases the log",
+            async () => {
+                const payload = { nested: { list: [1, 2, { k: "v" }] } };
+                await store.append("c-copy", 0, {
+                    type: "EXPERIENCE_COMPOSED",
+                    payload,
+                    at: "2026-10-06T00:00:00.000Z",
+                });
+                payload.nested.list.push(3);
+                const first = await store.read("c-copy");
+                if (JSON.stringify(first[0]?.payload) !==
+                    JSON.stringify({ nested: { list: [1, 2, { k: "v" }] } }))
+                    fail("copy-in", "mutating a payload after append changed the stored record");
+                first[0]?.payload.nested.list.push(9);
+                const second = await store.read("c-copy");
+                if (JSON.stringify(second[0]?.payload).includes("9"))
+                    fail("copy-out", "mutating a read result changed the stored record");
+                if (second[0]?.type !== "EXPERIENCE_COMPOSED" ||
+                    second[0]?.at !== "2026-10-06T00:00:00.000Z")
+                    fail("fields", "type or at did not round-trip");
+            },
+        ],
+        [
+            "optional readTail / readAfter / listStreams agree with read (when implemented)",
+            async () => {
+                for (let i = 0; i < 5; i++)
+                    await store.append("c-opt", i, rec(i));
+                const all = await store.read("c-opt");
+                const seqs = (r) => r.map((x) => x.sequence).join();
+                if (store.readTail !== undefined) {
+                    if (seqs(await store.readTail("c-opt", 2)) !== "4,5")
+                        fail("read-tail", "readTail(2) did not return the newest two records in order");
+                    if (seqs(await store.readTail("c-opt", 99)) !== seqs(all))
+                        fail("read-tail", "readTail past the length did not return the whole line");
+                    if ((await store.readTail("c-opt-none", 3)).length !== 0)
+                        fail("read-tail", "readTail of an unknown line was not empty");
+                }
+                if (store.readAfter !== undefined) {
+                    if (seqs(await store.readAfter("c-opt", 3)) !== "4,5")
+                        fail("read-after", "readAfter(3) did not return the records past sequence 3");
+                    if (seqs(await store.readAfter("c-opt", 0, 2)) !== "1,2")
+                        fail("read-after", "readAfter(0, 2) did not honour the limit");
+                    if ((await store.readAfter("c-opt", 5)).length !== 0)
+                        fail("read-after", "readAfter at the tip was not empty");
+                }
+                if (store.listStreams !== undefined) {
+                    const ids = [];
+                    for await (const id of store.listStreams())
+                        ids.push(id);
+                    if (!ids.includes("c-opt") || new Set(ids).size !== ids.length)
+                        fail("list-streams", "listStreams missed a line or listed one twice");
+                }
+            },
+        ],
+    ];
+    for (const [name, run] of cases) {
+        try {
+            await run();
+        }
+        catch (err) {
+            fail("store-threw", `${name}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=conformance.js.map

package/dist/esm/conformance.js.map

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

package/dist/esm/derive.js

@@ -0,0 +1,29 @@
+import { carryClasses } from "@loomwork/ui-core";
+/** The unsealed artifact a revert to `target` produces on top of `head`. Same line, same id. */
+export function revertArtifact(head, target, a) {
+    const adopted = {
+        ...target,
+        experienceId: head.experienceId,
+        versionHash: "",
+        parents: [head.versionHash],
+        meta: { author: authorOf(a.by), createdAt: a.at, sourceKind: "revert" },
+    };
+    return carryClasses(head, adopted);
+}
+/**
+ * The unsealed first artifact of the line `experienceId`, forked from `source` with the classes of
+ * `carriedFrom` (the source line's head at the fork) carried in. Its parent is `source` — a version
+ * of ANOTHER line, which is how a branch is told from a genesis.
+ */
+export function branchArtifact(source, carriedFrom, experienceId, a) {
+    const adopted = {
+        ...source,
+        experienceId,
+        versionHash: "",
+        parents: [source.versionHash],
+        meta: { author: authorOf(a.by), createdAt: a.at, sourceKind: "branch" },
+    };
+    return carryClasses(carriedFrom, adopted);
+}
+export const authorOf = (by) => by.agentId ?? by.ref ?? by.source;
+//# sourceMappingURL=derive.js.map

package/dist/esm/derive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.js","sourceRoot":"","sources":["../../src/derive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAuBnF,gGAAgG;AAChG,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,MAAkB,EAAE,CAAW;IAC9E,MAAM,OAAO,GAAe;QAC1B,GAAG,MAAM;QACT,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;QAC3B,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE;KACxE,CAAC;IACF,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAkB,EAClB,WAAuB,EACvB,YAAoB,EACpB,CAAW;IAEX,MAAM,OAAO,GAAe;QAC1B,GAAG,MAAM;QACT,YAAY;QACZ,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC;QAC7B,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE;KACxE,CAAC;IACF,OAAO,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAc,EAAU,EAAE,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC"}

package/dist/esm/events.js

@@ -0,0 +1,101 @@
+import { Operation, Provenance, Sensitivity } from "@loomwork/ui-core";
+import { z } from "zod";
+// ── The lineage event protocol ────────────────────────────────────────────────
+// A lineage is the append-only log of ONE experience's versions. Every entry is an event whose
+// type names what happened and whose payload carries the content address (`ref`) of the stored
+// artifact plus enough to VERIFY it without trusting the blob:
+//
+//   EXPERIENCE_COMPOSED  a version produced by ops folded onto its parent (or the genesis, ops [])
+//   EXPERIENCE_REVERTED  a version that restores an older artifact's content as a NEW version
+//   EXPERIENCE_BRANCHED  the first version of a NEW lineage forked from a version of another
+//   EXPERIENCE_PROMOTED  the app chose to SHOW a version (head is "latest", promoted is "shown")
+//
+// `EXPERIENCE_COMPOSED` is the same name and `{ ref, parents, ops }` core's `log.ts` declared as a
+// userspace convention; here it gains a producer, a consumer and a validator. The extra fields
+// (`experienceId`, `versionHash`, `by`) are additive. `EXPERIENCE_PROMOTED` is redeclared (not
+// imported) because importing it from `@loomwork/ui-planner` would put the planner's whole graph —
+// hydration, the sandbox — into a server-side store package; `lineage.test.ts` asserts the two
+// spellings never drift.
+export const EXPERIENCE_COMPOSED = "EXPERIENCE_COMPOSED";
+export const EXPERIENCE_REVERTED = "EXPERIENCE_REVERTED";
+export const EXPERIENCE_BRANCHED = "EXPERIENCE_BRANCHED";
+export const EXPERIENCE_PROMOTED = "EXPERIENCE_PROMOTED";
+const ContentRefSchema = z.object({ __loomContent: z.string().min(1) });
+const Hash = z.string().min(1);
+const RecordedOperationSchema = z.object({
+    op: Operation,
+    baseVersion: z.string().optional(),
+    by: Provenance,
+    at: z.string(),
+});
+const Common = {
+    experienceId: z.string().min(1),
+    versionHash: Hash,
+    ref: ContentRefSchema,
+    parents: z.array(Hash),
+    by: Provenance,
+};
+export const ComposedPayload = z.object({
+    ...Common,
+    ops: z.array(RecordedOperationSchema),
+    /**
+     * What the author said about the change (U7): UNTRUSTED text (a planner's model text), bounded
+     * and stripped by `boundSummary` on the way in AND on the way out of the fold, since the log is
+     * untrusted input. Optional, so every version written before it replays unchanged; it is not in
+     * the content address (nothing here is).
+     */
+    summary: z.string().optional(),
+    /**
+     * The strictest class of everything the author READ to write `summary` (the experience, tool
+     * samples, caller context), stamped by the host at compose. A summary is judged against it (and
+     * against the version's own class floor) before a viewer is shown it. Recorded on the event, not
+     * in the content address. Absent = unknown, and the floor alone gates the summary.
+     */
+    summaryClass: Sensitivity.optional(),
+});
+export const RevertedPayload = z.object({ ...Common, revertedTo: Hash });
+export const BranchedPayload = z.object({
+    ...Common,
+    from: z.object({ experienceId: z.string().min(1), versionHash: Hash }),
+    /** The version of the SOURCE line whose sticky classes were carried in (its head at the fork). */
+    carriedFrom: Hash,
+});
+export const PromotedPayload = z.object({
+    ref: ContentRefSchema,
+    experienceId: z.string().min(1),
+    versionHash: Hash,
+    by: Provenance,
+});
+export const PAYLOAD_SCHEMAS = {
+    [EXPERIENCE_COMPOSED]: ComposedPayload,
+    [EXPERIENCE_REVERTED]: RevertedPayload,
+    [EXPERIENCE_BRANCHED]: BranchedPayload,
+    [EXPERIENCE_PROMOTED]: PromotedPayload,
+};
+export const isLineageEventType = (t) => Object.hasOwn(PAYLOAD_SCHEMAS, t);
+/**
+ * The payload paths that carry host or model TEXT, per event type: the op props and labels, the
+ * author's `summary` and the `by` provenance (a user's own words and ids). These are what a host
+ * seals under its owner's key so erasing the owner makes the line unreadable
+ * (`registerLineageSensitivePaths`). Everything else on an event is an identifier (`experienceId`,
+ * `versionHash`, `ref`, `parents`, `from`, `carriedFrom`, `revertedTo`) or a class
+ * (`summaryClass`), and stays plain so the log's structure survives the key.
+ *
+ * `ops` is one path: it covers every nested op's `by`, props, labels and prompt text.
+ */
+export const LINEAGE_SENSITIVE_PATHS = {
+    [EXPERIENCE_COMPOSED]: ["ops", "summary", "by"],
+    [EXPERIENCE_REVERTED]: ["by"],
+    [EXPERIENCE_BRANCHED]: ["by"],
+    [EXPERIENCE_PROMOTED]: ["by"],
+};
+/**
+ * Register {@link LINEAGE_SENSITIVE_PATHS} on a crypto event store (`EncryptingEventStore`'s
+ * `registerSensitive`). Call it once at composition, before the first lineage write: what was
+ * written before stays plaintext.
+ */
+export function registerLineageSensitivePaths(store) {
+    for (const [type, paths] of Object.entries(LINEAGE_SENSITIVE_PATHS))
+        store.registerSensitive(type, paths);
+}
+//# sourceMappingURL=events.js.map

package/dist/esm/events.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,12 @@
+export { LineErasedError, LineUnreadableError, Lineage, classifyLineFailure } from "./lineage";
+export { branchArtifact, revertArtifact } from "./derive";
+export { BranchedPayload, ComposedPayload, EXPERIENCE_BRANCHED, EXPERIENCE_COMPOSED, EXPERIENCE_PROMOTED, EXPERIENCE_REVERTED, LINEAGE_SENSITIVE_PATHS, PromotedPayload, RevertedPayload, registerLineageSensitivePaths, } from "./events";
+export { foldLineage } from "./state";
+export { InMemoryLineageStore, LINEAGE_STREAM_PREFIX, LINEAGE_WORKFLOW_ID, LOOM_UI_STREAM_NAMESPACE, eventStoreLineageStore, } from "./store";
+export { checkLineageStoreConformance } from "./conformance";
+export { DEFAULT_MAX_SEEN_VIEWS, DEFAULT_MAX_SKEW_MS, MAX_SEEN_READ, SEEN_STREAM_PREFIX, SEEN_WORKFLOW_ID, SeenLog, VIEWER_ERASED, VIEWS_RETAINED, VIEW_RECORDED, ViewRecordPayload, seenStoreOptions, seenStreamKey, } from "./seen";
+export { InMemorySeenKeyStore, SEALED_REF_BLOCK, checkSeenKeyStoreConformance, seenKeySubject, } from "./seenCrypto";
+export { collectSeenGarbage, collectSeenRoots } from "./seenGc";
+export { DEFAULT_KEEP_LAST, retainedVersions, validateRetentionPolicy } from "./retention";
+export { rootsFor } from "./rootsFor";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAW/F,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,6BAA6B,GAC9B,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAQjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,QAAQ,CAAC;AAShB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,4BAA4B,EAC5B,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGhE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3F,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}