@patterkit/runtime 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -33,6 +33,27 @@ version number always means the same runtime behaviour. This package is versione
 
 ## [Unreleased]
 
+## [0.10.0] - 2026-09-02
+
+### Added
+
+- **`Engine.listBags()` and `Flow.listBags()`.** The kernel bags with the path each answers
+  to in a log - the shared `@patter` globals and per-scene props on the engine, a flow's own
+  halves prefixed with its id. Parity with the Storylet Engine's method of the same name; it
+  is what a state logger mounts. A stage bag's LOG path is `@scene:<sceneId>.` where its
+  address is `@scene.`, because a log spans scenes and has to say which one.
+
+### Changed
+
+- **The state logger watches the property bags instead of diffing save snapshots.** A
+  property write is logged when it LANDS, on the bag's audit hook, rather than at the next
+  capture. The visit counts live in no bag, so those are still diffed - which is all this
+  logger used to do for everything. What it buys: a diff can only report the NET change
+  between two captures, so a value that changed and changed back was invisible, and every
+  write was reported late. The core is shared with the Storylet Engine, which has always
+  worked this way.
+- **Requires `@wildwinter/scoperegistry` ^0.5.0**, which carries the shared state logger.
+
 ## [0.9.0] - 2026-09-02
 
 ### Changed

package/dist/index.cjs

@@ -495,6 +495,22 @@ var Engine = class _Engine {
   flows() {
     return [...this.flowsById.values()];
   }
+  /**
+   * The SHARED kernel bags with the path each answers to in a log: the `@patter` globals,
+   * and one per scene for the shared `@scene` props. Parity with the Storylet Engine's
+   * listBags of the same name - it is what a state logger mounts.
+   *
+   * A stage bag's log path is `@scene:<sceneId>.`, not the bag's own `@scene.`: a property
+   * is ADDRESSED relative to a flow's current scene, but a log spans scenes and has to say
+   * which one. That is why a mount may override the bag's prefix.
+   *
+   * loadGame() replaces every bag, so re-enumerate after a load.
+   */
+  listBags() {
+    const mounts = [{ bag: this.host.shared.ownedBag("patter") }];
+    for (const [sceneId, bag] of this.host.stageBags) mounts.push({ bag, pathPrefix: `@scene:${sceneId}.` });
+    return mounts;
+  }
   /** Close (remove) a flow. The flow object is FINISHED, not merely unregistered, so a host still
    *  holding it cannot keep advancing it into the shared world (see {@link Flow.close}). */
   closeFlow(id) {
@@ -934,7 +950,16 @@ var Flow = class {
       this.enterChild(children[frame.index++]);
     }
   }
-  /** The options of a pending choice (empty when not at a choice point). */
+  /**
+   * THIS flow's own kernel bags: its not-shared `@patter` half and its per-scene `@scene`
+   * props, each prefixed with the flow id so one path space holds every flow. The shared
+   * halves are the Engine's listBags.
+   */
+  listBags() {
+    const mounts = [{ bag: this.local.ownedBag("patter"), pathPrefix: `${this.id}/@patter.` }];
+    for (const [sceneId, bag] of this.sceneBags) mounts.push({ bag, pathPrefix: `${this.id}/@scene:${sceneId}.` });
+    return mounts;
+  }
   /** This flow's decisions, in order. Empty unless the run was opened with `log: true`.
    *  The engine's log carries the same events tagged with the flow; this one is what a
    *  single conversation reads as. */
@@ -953,6 +978,7 @@ var Flow = class {
     if (!this.host.logEnabled) return;
     this.flowLog.push({ ...event, seq: this.flowSeq++, ...scene ? { scene } : {} });
   }
+  /** The options of a pending choice (empty when not at a choice point). */
   getChoices() {
     return this.pendingChoice?.options ?? [];
   }