narraeon 0.4.0 → 0.5.0

package/dist/node/runtime/world/WorldDocumentMaintenance.js

@@ -0,0 +1,174 @@
+import { listWorldDocuments } from "../prompt/WorldMaintenanceReport.js";
+import { WorldDocumentStore } from "./WorldDocumentStore.js";
+/** Reachable committed bytes only. Cached prefixes are disposable accelerators. */
+export async function readDocumentMaintenanceFacts(authority, head, cache) {
+    const exact = cache.get(head);
+    if (exact !== undefined)
+        return structuredClone(exact.facts);
+    const timeline = [];
+    let cursor = head;
+    const seen = new Set();
+    while (cursor !== "genesis" && !cache.has(cursor)) {
+        const commit = await authority.commitAt(cursor);
+        if (commit === null || seen.has(cursor))
+            throw new Error("Document maintenance history is not reachable");
+        seen.add(cursor);
+        timeline.push(commit);
+        cursor = commit.timelineParent.head;
+    }
+    timeline.reverse();
+    const prefix = cache.get(cursor);
+    const files = prefix === undefined
+        ? new Map((await authority.recoverState("genesis")).map(({ path, contents }) => [path, contents]))
+        : new Map(prefix.files);
+    const snapshot = () => WorldDocumentStore.open({
+        layout: "world_state",
+        files: [...files].map(([path, contents]) => ({
+            path: `state/${path}`,
+            contents,
+        })),
+    });
+    let previous = snapshot();
+    const facts = structuredClone(prefix?.facts ?? {});
+    const bodyContexts = structuredClone(prefix?.bodyContexts ?? new Map());
+    const metadataContexts = structuredClone(prefix?.metadataContexts ?? new Map());
+    const origin = {
+        kind: "world_origin",
+        context: null,
+        round: 0,
+        worldTime: null,
+    };
+    for (const document of prefix === undefined
+        ? listWorldDocuments(previous)
+        : []) {
+        const read = previous.query({
+            kind: "read_document",
+            document: { shortRef: document.shortRef },
+        });
+        if (read.kind !== "read_document")
+            continue;
+        facts[document.shortRef] = {
+            baselineKind: "world_origin",
+            baselineBytes: Buffer.byteLength(read.body, "utf8"),
+            lastBodyWrite: origin,
+            lastMetadataWrite: origin,
+            bodyChangedContexts: 0,
+            metadataChangedContexts: 0,
+        };
+    }
+    const contexts = structuredClone(prefix?.contexts ?? new Map());
+    let inputPosition = prefix?.inputPosition ?? 0;
+    let unassignedPlayer = prefix?.unassignedPlayer ?? false;
+    for (const commit of timeline) {
+        let context = commit.playContext === undefined
+            ? undefined
+            : contexts.get(commit.playContext);
+        if (commit.playContext !== undefined && context === undefined) {
+            context = { ordinal: contexts.size + 1, round: 0 };
+            contexts.set(commit.playContext, context);
+        }
+        if (context !== undefined && unassignedPlayer) {
+            context.round += 1;
+            unassignedPlayer = false;
+        }
+        for (const message of commit.historyAppend) {
+            if (message.role === "player" && message.exactText.trim().length > 0) {
+                inputPosition += 1;
+                if (context !== undefined)
+                    context.round += 1;
+                else
+                    unassignedPlayer = true;
+            }
+            else if (message.role === "narrator")
+                unassignedPlayer = false;
+        }
+        if (commit.stateChanges.length === 0)
+            continue;
+        const changed = await Promise.all(commit.stateChanges.map(async (change) => ({
+            change,
+            contents: await authority.readStateChangeContents(change),
+        })));
+        for (const { change, contents } of changed)
+            files.set(change.relativePath, contents);
+        const next = snapshot();
+        const position = {
+            kind: commit.mode === "correction"
+                ? "correction"
+                : context === undefined
+                    ? "history"
+                    : "play",
+            context: context?.ordinal ?? null,
+            round: context?.round ?? inputPosition,
+            worldTime: commit.worldClock ?? null,
+        };
+        for (const { change } of changed) {
+            const ref = change.stableShortRef;
+            const before = previous.query({
+                kind: "read_document",
+                document: { shortRef: ref },
+            });
+            const after = next.query({
+                kind: "read_document",
+                document: { shortRef: ref },
+            });
+            if (after.kind !== "read_document")
+                throw new Error(`Accepted document @${ref} is unreadable`);
+            const fact = facts[ref] ?? {
+                baselineKind: "document_creation",
+                baselineBytes: Buffer.byteLength(after.body, "utf8"),
+                lastBodyWrite: null,
+                lastMetadataWrite: null,
+                bodyChangedContexts: 0,
+                metadataChangedContexts: 0,
+            };
+            const bodyChanged = before.kind !== "read_document" || before.body !== after.body;
+            const metadataChanged = before.kind !== "read_document" ||
+                JSON.stringify([
+                    before.document.title,
+                    before.document.summary,
+                    before.document.aliases,
+                    before.document.retired,
+                ]) !==
+                    JSON.stringify([
+                        after.document.title,
+                        after.document.summary,
+                        after.document.aliases,
+                        after.document.retired,
+                    ]);
+            if (bodyChanged) {
+                fact.lastBodyWrite = structuredClone(position);
+                if (commit.playContext !== undefined) {
+                    const changedContexts = bodyContexts.get(ref) ?? new Set();
+                    changedContexts.add(commit.playContext);
+                    bodyContexts.set(ref, changedContexts);
+                    fact.bodyChangedContexts = changedContexts.size;
+                }
+            }
+            if (metadataChanged) {
+                fact.lastMetadataWrite = structuredClone(position);
+                if (commit.playContext !== undefined) {
+                    const changedContexts = metadataContexts.get(ref) ?? new Set();
+                    changedContexts.add(commit.playContext);
+                    metadataContexts.set(ref, changedContexts);
+                    fact.metadataChangedContexts = changedContexts.size;
+                }
+            }
+            facts[ref] = fact;
+        }
+        previous = next;
+    }
+    for (const fact of Object.values(facts))
+        fact.observedContexts = contexts.size;
+    if (cache.size >= 8)
+        cache.delete(cache.keys().next().value);
+    cache.set(head, {
+        files,
+        facts,
+        bodyContexts,
+        metadataContexts,
+        contexts,
+        inputPosition,
+        unassignedPlayer,
+    });
+    return structuredClone(facts);
+}