@miadi/episodic-memory-schema 0.11.1 → 0.13.0

package/README.md

@@ -182,6 +182,14 @@ modifies source material.
 - **Reviews held by an episode.** `parseReviewRef`, `readEpisodeReviews`, `reviewNodeId` and
   `EpisodeReviewEntry` type a Miadi review inside `episode.yaml` (`reviews:`), with its
   `review:<uuid>` node id. Pure: no fs, no fetch.
+- **Screenwalks.** `ScreenwalkRecord` types a screenwalk, a recording of a person working live
+  with agent sessions, as an episode holds it in `captures/screenwalk-<id>/screenwalk.json`: its
+  id is the stamp the person names when recording starts (`miadi-screenwalk:<yymmddHHMM>`), and
+  it gathers the sessions on screen with their ledgers, the video, the review, transcriptions,
+  witness closings and outputs (dialogue, chapters, shorts). `toScreenwalkRecord` also reads the
+  screenwalk `capture.json` files written by hand before the record existed, `isScreenwalkRecord`
+  guards the written form, and `@miadi/episodic-memory-schema/schema/screenwalk` is its JSON
+  Schema. Pure: no fs, no fetch.
 
 ## Versioning
 

package/dist/episode-foundation.d.ts

@@ -0,0 +1,85 @@
+/**
+ * The chronicle FOUNDATION contract — a foundation packet held by an episode.
+ *
+ * A foundation packet is academic grounding (`foundations/<slug>/` in a repo,
+ * distributed in `@miadi/foundations`). Its address is
+ * `miadi-foundation:<slug>`. An episode holds one the way it holds a review
+ * (jgwill/Miadi#630): the packet is one reusable node on the wheel
+ * (`foundation:<slug>`), the episode relates to it with an edge naming what it
+ * uses the packet for, and the episode keeps its own record of the version it
+ * read. Packets get corrected; the version is what the episode stood on.
+ *
+ * An episode can also hold a small foundation of its own, written inside the
+ * vessel under `foundations/<topic>/`. That packet belongs to the episode: its
+ * address is `miadi-chronicle:<episode>/foundations/<topic>`, and its wheel
+ * node is keyed by the episode folder so two episodes can each hold a topic of
+ * the same name.
+ *
+ * Manifest shape (`episode.yaml`):
+ *
+ *   foundations:
+ *     - slug: resource-addressing-and-terminal-hypermedia
+ *       source: package
+ *       version: 0.1.6
+ *       title: Resource Addressing & Terminal Hypermedia
+ *       relation: grounded-by
+ *       added: '2026-10-02T10:30:00.000Z'
+ *     - slug: screenwalk-media-type
+ *       source: episode
+ *       path: foundations/screenwalk-media-type
+ *
+ * A `miadi-foundation:<slug>` string in `references:` is read as a held
+ * packet too. Pure — no fs, no fetch. Ref: jgwill/Miadi#713, jgwill/Miadi#548.
+ */
+/** The address scheme of a distributed foundation packet. */
+export declare const FOUNDATION_REFERENCE_PREFIX = "miadi-foundation:";
+/** Wheel node ids for foundations: `foundation:<slug>`. */
+export declare const FOUNDATION_NODE_PREFIX = "foundation:";
+/** The wheel metadata kind a foundation node carries. */
+export declare const FOUNDATION_NODE_KIND = "miadi_foundation";
+/** Where an episode keeps the small foundations it authors itself. */
+export declare const EPISODE_FOUNDATIONS_DIR = "foundations";
+/** What an episode uses a packet for when nobody said: "Episode grounded-by Foundation". */
+export declare const DEFAULT_FOUNDATION_RELATION = "grounded-by";
+/** `package`: a packet from `@miadi/foundations`. `episode`: a packet inside this episode's vessel. */
+export type FoundationSource = "package" | "episode";
+export declare function isFoundationSlug(value: unknown): value is string;
+/**
+ * The wheel node id of a held packet. A distributed packet is one node shared
+ * by every episode; an episode's own packet is keyed by the episode folder.
+ */
+export declare function foundationNodeId(slug: string, episodeFolder?: string): string;
+/** The slug a `miadi-foundation:` reference names, or null. `//` is accepted on input. */
+export declare function foundationSlugOf(reference: unknown): string | null;
+/** One foundation as an episode records it. */
+export interface EpisodeFoundationEntry {
+    /** The packet directory name. */
+    slug: string;
+    source: FoundationSource;
+    /** The `@miadi/foundations` version read (source `package`). */
+    version?: string;
+    title?: string;
+    /** Vessel-relative directory of an episode's own packet (source `episode`). */
+    path?: string;
+    /** What the episode uses the packet for: completes "Episode <relation> Foundation". */
+    relation?: string;
+    /** ISO timestamp the packet entered the episode. */
+    added?: string;
+}
+export interface ObservedEpisodeFoundation extends EpisodeFoundationEntry {
+    /** `foundations` for a structured entry, `references` for a `miadi-foundation:` citation. */
+    declared: "foundations" | "references";
+}
+/** The entry's keys in the order the manifest writes them. */
+export declare const FOUNDATION_ENTRY_KEYS: readonly ["slug", "source", "version", "title", "path", "relation", "added"];
+/** An episode's own packet lives under `foundations/<slug>`, and nowhere else. */
+export declare function episodeFoundationPath(slug: string): string;
+/** Tolerant reader for one `foundations:` item. Null when it names no packet. */
+export declare function toEpisodeFoundationEntry(raw: unknown): EpisodeFoundationEntry | null;
+/**
+ * Every foundation a parsed `episode.yaml` holds: the structured
+ * `foundations:` list first, then `miadi-foundation:` citations in
+ * `references:` that the list does not already name. One entry per packet.
+ */
+export declare function readEpisodeFoundations(manifest: unknown): ObservedEpisodeFoundation[];
+//# sourceMappingURL=episode-foundation.d.ts.map

package/dist/episode-foundation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode-foundation.d.ts","sourceRoot":"","sources":["../src/episode-foundation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,2BAA2B,sBAAsB,CAAA;AAE9D,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,gBAAgB,CAAA;AAEnD,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,qBAAqB,CAAA;AAEtD,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,gBAAgB,CAAA;AAEpD,4FAA4F;AAC5F,eAAO,MAAM,2BAA2B,gBAAgB,CAAA;AAExD,uGAAuG;AACvG,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAA;AAKpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIlE;AAED,+CAA+C;AAC/C,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,gBAAgB,CAAA;IACxB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,yBAA0B,SAAQ,sBAAsB;IACvE,6FAA6F;IAC7F,QAAQ,EAAE,aAAa,GAAG,YAAY,CAAA;CACvC;AAED,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,8EAA+E,CAAA;AAOjH,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI,CAuBpF;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,yBAAyB,EAAE,CAoBrF"}

package/dist/episode-foundation.js

@@ -0,0 +1,137 @@
+/**
+ * The chronicle FOUNDATION contract — a foundation packet held by an episode.
+ *
+ * A foundation packet is academic grounding (`foundations/<slug>/` in a repo,
+ * distributed in `@miadi/foundations`). Its address is
+ * `miadi-foundation:<slug>`. An episode holds one the way it holds a review
+ * (jgwill/Miadi#630): the packet is one reusable node on the wheel
+ * (`foundation:<slug>`), the episode relates to it with an edge naming what it
+ * uses the packet for, and the episode keeps its own record of the version it
+ * read. Packets get corrected; the version is what the episode stood on.
+ *
+ * An episode can also hold a small foundation of its own, written inside the
+ * vessel under `foundations/<topic>/`. That packet belongs to the episode: its
+ * address is `miadi-chronicle:<episode>/foundations/<topic>`, and its wheel
+ * node is keyed by the episode folder so two episodes can each hold a topic of
+ * the same name.
+ *
+ * Manifest shape (`episode.yaml`):
+ *
+ *   foundations:
+ *     - slug: resource-addressing-and-terminal-hypermedia
+ *       source: package
+ *       version: 0.1.6
+ *       title: Resource Addressing & Terminal Hypermedia
+ *       relation: grounded-by
+ *       added: '2026-10-02T10:30:00.000Z'
+ *     - slug: screenwalk-media-type
+ *       source: episode
+ *       path: foundations/screenwalk-media-type
+ *
+ * A `miadi-foundation:<slug>` string in `references:` is read as a held
+ * packet too. Pure — no fs, no fetch. Ref: jgwill/Miadi#713, jgwill/Miadi#548.
+ */
+/** The address scheme of a distributed foundation packet. */
+export const FOUNDATION_REFERENCE_PREFIX = "miadi-foundation:";
+/** Wheel node ids for foundations: `foundation:<slug>`. */
+export const FOUNDATION_NODE_PREFIX = "foundation:";
+/** The wheel metadata kind a foundation node carries. */
+export const FOUNDATION_NODE_KIND = "miadi_foundation";
+/** Where an episode keeps the small foundations it authors itself. */
+export const EPISODE_FOUNDATIONS_DIR = "foundations";
+/** What an episode uses a packet for when nobody said: "Episode grounded-by Foundation". */
+export const DEFAULT_FOUNDATION_RELATION = "grounded-by";
+// A packet directory name: no separator, no leading dot, never `..`.
+const SLUG = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+export function isFoundationSlug(value) {
+    return typeof value === "string" && SLUG.test(value) && !value.includes("..");
+}
+/**
+ * The wheel node id of a held packet. A distributed packet is one node shared
+ * by every episode; an episode's own packet is keyed by the episode folder.
+ */
+export function foundationNodeId(slug, episodeFolder) {
+    return episodeFolder ? `${FOUNDATION_NODE_PREFIX}${episodeFolder}/${slug}` : `${FOUNDATION_NODE_PREFIX}${slug}`;
+}
+/** The slug a `miadi-foundation:` reference names, or null. `//` is accepted on input. */
+export function foundationSlugOf(reference) {
+    if (typeof reference !== "string")
+        return null;
+    const m = /^miadi-foundation:(?:\/\/)?([^/?#\s]+)/i.exec(reference.trim());
+    return m && isFoundationSlug(m[1]) ? m[1] : null;
+}
+/** The entry's keys in the order the manifest writes them. */
+export const FOUNDATION_ENTRY_KEYS = ["slug", "source", "version", "title", "path", "relation", "added"];
+function text(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return String(value);
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+/** An episode's own packet lives under `foundations/<slug>`, and nowhere else. */
+export function episodeFoundationPath(slug) {
+    return `${EPISODE_FOUNDATIONS_DIR}/${slug}`;
+}
+/** Tolerant reader for one `foundations:` item. Null when it names no packet. */
+export function toEpisodeFoundationEntry(raw) {
+    if (typeof raw === "string") {
+        const slug = foundationSlugOf(raw) ?? (isFoundationSlug(raw.trim()) ? raw.trim() : null);
+        return slug ? { slug, source: "package" } : null;
+    }
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+        return null;
+    const r = raw;
+    const slug = text(r.slug);
+    if (!isFoundationSlug(slug))
+        return null;
+    const source = r.source === "episode" ? "episode" : "package";
+    const entry = { slug, source };
+    const version = text(r.version);
+    if (version && source === "package")
+        entry.version = version;
+    const title = text(r.title);
+    if (title)
+        entry.title = title;
+    // The path is declared by the source, never taken from the file: an
+    // episode's packet is `foundations/<slug>`, whatever a hand edit wrote.
+    if (source === "episode")
+        entry.path = episodeFoundationPath(slug);
+    const relation = text(r.relation);
+    if (relation)
+        entry.relation = relation;
+    const added = r.added instanceof Date ? r.added.toISOString() : text(r.added);
+    if (added)
+        entry.added = added;
+    return entry;
+}
+const keyOf = (entry) => `${entry.source}:${entry.slug}`;
+/**
+ * Every foundation a parsed `episode.yaml` holds: the structured
+ * `foundations:` list first, then `miadi-foundation:` citations in
+ * `references:` that the list does not already name. One entry per packet.
+ */
+export function readEpisodeFoundations(manifest) {
+    if (typeof manifest !== "object" || manifest === null)
+        return [];
+    const m = manifest;
+    const out = [];
+    const seen = new Set();
+    for (const item of Array.isArray(m.foundations) ? m.foundations : []) {
+        const entry = toEpisodeFoundationEntry(item);
+        if (!entry || seen.has(keyOf(entry)))
+            continue;
+        seen.add(keyOf(entry));
+        out.push({ ...entry, declared: "foundations" });
+    }
+    for (const reference of Array.isArray(m.references) ? m.references : []) {
+        const slug = foundationSlugOf(reference);
+        if (!slug)
+            continue;
+        const entry = { slug, source: "package" };
+        if (seen.has(keyOf(entry)))
+            continue;
+        seen.add(keyOf(entry));
+        out.push({ ...entry, declared: "references" });
+    }
+    return out;
+}
+//# sourceMappingURL=episode-foundation.js.map

package/dist/episode-foundation.js.map

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

package/dist/index.d.ts

@@ -32,4 +32,16 @@ export type { AttentionItem, AttentionStore, ParsedAttentionStore, } from "./att
  */
 export { REVIEW_SERVICE_BASE_URL, REVIEW_REFERENCE_PREFIX, REVIEW_NODE_PREFIX, REVIEW_NODE_KIND, REVIEW_ENTRY_KEYS, isReviewId, reviewNodeId, reviewReference, reviewPageUrl, reviewJsonUrl, parseReviewRef, toEpisodeReviewEntry, readEpisodeReviews, } from "./episode-review.js";
 export type { ReviewRef, EpisodeReviewEntry, ObservedEpisodeReview } from "./episode-review.js";
+/**
+ * A foundation packet held by an episode — the `foundations:` list in
+ * `episode.yaml`, and the wheel node kind it projects to (jgwill/Miadi#713).
+ */
+export { FOUNDATION_REFERENCE_PREFIX, FOUNDATION_NODE_PREFIX, FOUNDATION_NODE_KIND, FOUNDATION_ENTRY_KEYS, EPISODE_FOUNDATIONS_DIR, DEFAULT_FOUNDATION_RELATION, isFoundationSlug, foundationNodeId, foundationSlugOf, episodeFoundationPath, toEpisodeFoundationEntry, readEpisodeFoundations, } from "./episode-foundation.js";
+export type { FoundationSource, EpisodeFoundationEntry, ObservedEpisodeFoundation } from "./episode-foundation.js";
+/**
+ * The screenwalk record: a recording of a person working live with agent sessions, held in an
+ * episode as `captures/screenwalk-<id>/screenwalk.json` (Episode 550, jgwill/Miadi#707).
+ */
+export { SCREENWALK_REFERENCE_PREFIX, SCREENWALK_FOLDER_PREFIX, SCREENWALK_FILE, SCREENWALK_STATES, SCREENWALK_OUTPUT_KINDS, SCREENWALK_RECORD_KEYS, LEGACY_SCREENWALK_KEYS, isScreenwalkState, isScreenwalkId, screenwalkReference, screenwalkFolder, screenwalkPath, parseScreenwalkRef, parseScreenwalkStamp, deriveScreenwalkState, toScreenwalkRecord, isScreenwalkRecord, } from "./screenwalk.js";
+export type { ScreenwalkState, ScreenwalkRef, ScreenwalkStamp, ScreenwalkRecording, ScreenwalkVideo, ScreenwalkReview, ScreenwalkSession, ScreenwalkClosing, ScreenwalkTranscription, ScreenwalkOutputKind, ScreenwalkOutput, ScreenwalkRecord, } from "./screenwalk.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEjE;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AAEvB;;;GAGG;AACH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEjE;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AAEvB;;;GAGG;AACH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE/F;;;GAGG;AACH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AAElH;;;GAGG;AACH,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -29,4 +29,14 @@ export { ATTENTION_FILE, ATTENTION_SCHEMA_VERSION, toAttentionItem, parseAttenti
  * shape Episode 345 set (jgwill/Miadi#630).
  */
 export { REVIEW_SERVICE_BASE_URL, REVIEW_REFERENCE_PREFIX, REVIEW_NODE_PREFIX, REVIEW_NODE_KIND, REVIEW_ENTRY_KEYS, isReviewId, reviewNodeId, reviewReference, reviewPageUrl, reviewJsonUrl, parseReviewRef, toEpisodeReviewEntry, readEpisodeReviews, } from "./episode-review.js";
+/**
+ * A foundation packet held by an episode — the `foundations:` list in
+ * `episode.yaml`, and the wheel node kind it projects to (jgwill/Miadi#713).
+ */
+export { FOUNDATION_REFERENCE_PREFIX, FOUNDATION_NODE_PREFIX, FOUNDATION_NODE_KIND, FOUNDATION_ENTRY_KEYS, EPISODE_FOUNDATIONS_DIR, DEFAULT_FOUNDATION_RELATION, isFoundationSlug, foundationNodeId, foundationSlugOf, episodeFoundationPath, toEpisodeFoundationEntry, readEpisodeFoundations, } from "./episode-foundation.js";
+/**
+ * The screenwalk record: a recording of a person working live with agent sessions, held in an
+ * episode as `captures/screenwalk-<id>/screenwalk.json` (Episode 550, jgwill/Miadi#707).
+ */
+export { SCREENWALK_REFERENCE_PREFIX, SCREENWALK_FOLDER_PREFIX, SCREENWALK_FILE, SCREENWALK_STATES, SCREENWALK_OUTPUT_KINDS, SCREENWALK_RECORD_KEYS, LEGACY_SCREENWALK_KEYS, isScreenwalkState, isScreenwalkId, screenwalkReference, screenwalkFolder, screenwalkPath, parseScreenwalkRef, parseScreenwalkStamp, deriveScreenwalkState, toScreenwalkRecord, isScreenwalkRecord, } from "./screenwalk.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAG7B;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AAOvB;;;GAGG;AACH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAG7B;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AAOvB;;;GAGG;AACH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAG5B;;;GAGG;AACH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,yBAAyB,CAAA;AAGhC;;;GAGG;AACH,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAA"}

package/dist/screenwalk.d.ts

@@ -0,0 +1,178 @@
+/**
+ * The chronicle SCREENWALK record — a recording of a person working live with agent
+ * sessions, with their voices, held by an episode.
+ *
+ * Episode 550 ("The Screenwalk as a Media Type") drew the type before any code held it, in
+ * `diagrams/screenwalk.erdf.json`: an Episode holds Screenwalks; a Screenwalk witnesses
+ * sessions, ends with witness closings, is read as one Review and is teased by Shorts. Its
+ * states are the episode's two machines, `screenwalk.smdf.json` (NotStarted to
+ * InConversation) and the media cycle that continues after Reviewed.
+ *
+ * File: `captures/screenwalk-<id>/screenwalk.json` in the episode vessel, beside the seat
+ * ledgers. `capture.json` stays the descriptor of a phone audio take (`@miadi/episode-capture`),
+ * whose reader skips every other shape. The screenwalk `capture.json` files written by hand
+ * before this record existed are read by `toScreenwalkRecord` and converted.
+ *
+ * The id is the stamp the person writes when they press record, `yymmddHHMM`
+ * (`miadi-screenwalk:2610061207`). The first records used `yymmdd-NNN`. The stamp is the
+ * minute the person named. `recording.started` is where the uploaded video's clock begins,
+ * which can differ from it (a retake).
+ *
+ * Shape (`screenwalk.json`):
+ *
+ *   { "screenwalk": "2610061207", "reference": "miadi-screenwalk:2610061207",
+ *     "state": "Reviewed", "episode": "2026-10-01-episode-550-…", "stamp": "2026-10-06T12:07",
+ *     "recording": { "started": "…", "length": "about 24:30", "evidence": "…", "retake": "…" },
+ *     "video": { "url": "https://youtu.be/…", "title": "…" },
+ *     "review": { "id": "6a2b5b59-…", "version": 1 },
+ *     "related": [], "sessions": [{ "session_id": "…", "name": "…", "ledger": "seat-….md" }],
+ *     "closings": [], "transcriptions": [{ "file": "…", "source": "…", "coverage": "…" }],
+ *     "outputs": [], "finding": "…" }
+ *
+ * Pure — no fs, no fetch. Reading and writing the file is the consumer's. Ref: jgwill/Miadi#707.
+ */
+/** The portable reference form: `miadi-screenwalk:<id>`. `miadi-screenwalk://<id>` is read too. */
+export declare const SCREENWALK_REFERENCE_PREFIX = "miadi-screenwalk:";
+/** The folder a screenwalk lives in, under the vessel's `captures/`: `screenwalk-<id>`. */
+export declare const SCREENWALK_FOLDER_PREFIX = "screenwalk-";
+/** The record's file inside its folder. */
+export declare const SCREENWALK_FILE = "screenwalk.json";
+/**
+ * Every state a screenwalk can be in: Episode 550's `screenwalk.smdf.json`, then the media
+ * cycle that continues it after Reviewed (`screenwalk-media-cycle.smdf.json`).
+ */
+export declare const SCREENWALK_STATES: readonly ["NotStarted", "Recording", "Witnessing", "ClosingDrafted", "Played", "Revising", "Recorded", "Published", "Reviewed", "Chronicled", "InConversation", "Enriched", "Notebooked", "MediaGenerated", "Watched", "HeldInCircle", "ScriptedNext"];
+export type ScreenwalkState = (typeof SCREENWALK_STATES)[number];
+export declare function isScreenwalkState(value: unknown): value is ScreenwalkState;
+export declare function isScreenwalkId(value: unknown): value is string;
+export declare function screenwalkReference(id: string): string;
+export declare function screenwalkFolder(id: string): string;
+/** The record's path inside an episode vessel, relative to the vessel. */
+export declare function screenwalkPath(id: string): string;
+export interface ScreenwalkRef {
+    id: string;
+    /** `miadi-screenwalk:<id>`. */
+    reference: string;
+    /** `screenwalk-<id>`, the folder under `captures/`. */
+    folder: string;
+}
+/**
+ * Read a screenwalk reference: `miadi-screenwalk:<id>`, `miadi-screenwalk://<id>`, a folder
+ * name `screenwalk-<id>`, or a bare id. Null for anything else.
+ */
+export declare function parseScreenwalkRef(input: unknown): ScreenwalkRef | null;
+export interface ScreenwalkStamp {
+    /** `YYYY-MM-DD`. */
+    date: string;
+    /** `HH:MM`, present when the id carries an hour. An id with an hour and no minute gives `HH:00`. */
+    time?: string;
+    precision: "day" | "hour" | "minute";
+}
+/**
+ * The date and time an id names, read from its leading digits (`yymmdd`, `yymmddHH`,
+ * `yymmddHHMM`). Local time, as the person wrote it. Null when the digits are not a date.
+ */
+export declare function parseScreenwalkStamp(id: string): ScreenwalkStamp | null;
+export interface ScreenwalkRecording {
+    /** Where the uploaded video's clock begins, ISO or as the evidence states it. */
+    started?: string;
+    /** The video's length as measured, e.g. `about 24:30`. */
+    length?: string;
+    /** How `started` was established. */
+    evidence?: string;
+    /** Why the video differs from the recording the stamp named, when it does. */
+    retake?: string;
+}
+export interface ScreenwalkVideo {
+    url: string;
+    title?: string;
+    published_at?: string;
+}
+export interface ScreenwalkReview {
+    /** The review UUID. */
+    id: string;
+    /** The version this record last checked. */
+    version?: number;
+}
+/** A session on screen (the ERD's WitnessedSession). */
+export interface ScreenwalkSession {
+    session_id?: string;
+    /** The session's name, often its tmux name. */
+    name?: string;
+    /** What the session was doing in the recording. */
+    note?: string;
+    /** The seat ledger file in this folder: what the seat did, in wall-clock time. */
+    ledger?: string;
+}
+/** A witness closing played in the recording (the ERD's WitnessClosing). */
+export interface ScreenwalkClosing {
+    version: number;
+    file?: string;
+    /** The person's words after hearing this version. */
+    correction?: string;
+}
+export interface ScreenwalkTranscription {
+    file: string;
+    source?: string;
+    coverage?: string;
+    complete?: boolean;
+}
+export declare const SCREENWALK_OUTPUT_KINDS: readonly ["dialogue", "chapters", "short", "audio", "other"];
+export type ScreenwalkOutputKind = (typeof SCREENWALK_OUTPUT_KINDS)[number];
+/** Something made from the screenwalk: a dialogue, chapters, a short (the ERD's Short), audio. */
+export interface ScreenwalkOutput {
+    kind: ScreenwalkOutputKind;
+    /** Where it lives: a file in this folder, a URL, or a `miadi-*` reference. */
+    ref?: string;
+    /** For a short: where it starts and ends in the video, `mm:ss` or `h:mm:ss`. */
+    starts_at?: string;
+    ends_at?: string;
+    note?: string;
+}
+export interface ScreenwalkRecord {
+    /** The id: the stamp, `yymmddHHMM`, or an early `yymmdd-NNN`. */
+    screenwalk: string;
+    /** `miadi-screenwalk:<id>`. */
+    reference: string;
+    state?: ScreenwalkState;
+    /** The episode directory that holds it. */
+    episode?: string;
+    /** The minute the person named, `YYYY-MM-DDTHH:MM` local, read from the id when absent. */
+    stamp?: string;
+    recording?: ScreenwalkRecording;
+    video?: ScreenwalkVideo;
+    review?: ScreenwalkReview;
+    /** References to what the screenwalk is about: reviews, episodes, issues. */
+    related?: string[];
+    sessions: ScreenwalkSession[];
+    closings: ScreenwalkClosing[];
+    transcriptions: ScreenwalkTranscription[];
+    outputs: ScreenwalkOutput[];
+    /** What a listener found that the review would not say, e.g. that the person's voice is missing. */
+    finding?: string;
+    /** An `@miadi/episode-capture` stem, when the phone also filed an audio take. */
+    audio_take?: string;
+}
+/** The record's keys in the order `screenwalk.json` writes them. */
+export declare const SCREENWALK_RECORD_KEYS: readonly ["screenwalk", "reference", "state", "episode", "stamp", "recording", "video", "review", "related", "sessions", "closings", "transcriptions", "outputs", "finding", "audio_take"];
+/**
+ * Keys of the hand-written screenwalk `capture.json` files that `toScreenwalkRecord` maps.
+ * A converter that meets any other key should stop rather than drop it.
+ */
+export declare const LEGACY_SCREENWALK_KEYS: readonly ["stem", "video", "title", "review", "reference", "started", "session", "sessions", "seat_ledgers", "related", "recording", "stamp_estimate", "transcriptions", "finding", "note"];
+/** The furthest state the record's own fields prove: a review, then a video. Undefined otherwise. */
+export declare function deriveScreenwalkState(record: Pick<ScreenwalkRecord, "review" | "video">): ScreenwalkState | undefined;
+/**
+ * Tolerant reader for a `screenwalk.json`, or for a screenwalk `capture.json` written by hand
+ * before this record existed (`stem`, `video` as a string, `review` as `miadi-review:<uuid>`,
+ * `session`/`sessions` strings, `seat_ledgers`, `stamp_estimate`). The id comes from
+ * `screenwalk`, then `stem`, then `options.id` (the folder name), then `reference`. Null when
+ * none names a screenwalk.
+ */
+export declare function toScreenwalkRecord(raw: unknown, options?: {
+    id?: string;
+    episode?: string;
+}): ScreenwalkRecord | null;
+/** Strict guard for a record as `screenwalk.json` writes it. */
+export declare function isScreenwalkRecord(value: unknown): value is ScreenwalkRecord;
+//# sourceMappingURL=screenwalk.d.ts.map

package/dist/screenwalk.d.ts.map

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

package/dist/screenwalk.js

@@ -0,0 +1,411 @@
+/**
+ * The chronicle SCREENWALK record — a recording of a person working live with agent
+ * sessions, with their voices, held by an episode.
+ *
+ * Episode 550 ("The Screenwalk as a Media Type") drew the type before any code held it, in
+ * `diagrams/screenwalk.erdf.json`: an Episode holds Screenwalks; a Screenwalk witnesses
+ * sessions, ends with witness closings, is read as one Review and is teased by Shorts. Its
+ * states are the episode's two machines, `screenwalk.smdf.json` (NotStarted to
+ * InConversation) and the media cycle that continues after Reviewed.
+ *
+ * File: `captures/screenwalk-<id>/screenwalk.json` in the episode vessel, beside the seat
+ * ledgers. `capture.json` stays the descriptor of a phone audio take (`@miadi/episode-capture`),
+ * whose reader skips every other shape. The screenwalk `capture.json` files written by hand
+ * before this record existed are read by `toScreenwalkRecord` and converted.
+ *
+ * The id is the stamp the person writes when they press record, `yymmddHHMM`
+ * (`miadi-screenwalk:2610061207`). The first records used `yymmdd-NNN`. The stamp is the
+ * minute the person named. `recording.started` is where the uploaded video's clock begins,
+ * which can differ from it (a retake).
+ *
+ * Shape (`screenwalk.json`):
+ *
+ *   { "screenwalk": "2610061207", "reference": "miadi-screenwalk:2610061207",
+ *     "state": "Reviewed", "episode": "2026-10-01-episode-550-…", "stamp": "2026-10-06T12:07",
+ *     "recording": { "started": "…", "length": "about 24:30", "evidence": "…", "retake": "…" },
+ *     "video": { "url": "https://youtu.be/…", "title": "…" },
+ *     "review": { "id": "6a2b5b59-…", "version": 1 },
+ *     "related": [], "sessions": [{ "session_id": "…", "name": "…", "ledger": "seat-….md" }],
+ *     "closings": [], "transcriptions": [{ "file": "…", "source": "…", "coverage": "…" }],
+ *     "outputs": [], "finding": "…" }
+ *
+ * Pure — no fs, no fetch. Reading and writing the file is the consumer's. Ref: jgwill/Miadi#707.
+ */
+import { isReviewId, parseReviewRef } from "./episode-review.js";
+/** The portable reference form: `miadi-screenwalk:<id>`. `miadi-screenwalk://<id>` is read too. */
+export const SCREENWALK_REFERENCE_PREFIX = "miadi-screenwalk:";
+/** The folder a screenwalk lives in, under the vessel's `captures/`: `screenwalk-<id>`. */
+export const SCREENWALK_FOLDER_PREFIX = "screenwalk-";
+/** The record's file inside its folder. */
+export const SCREENWALK_FILE = "screenwalk.json";
+/**
+ * Every state a screenwalk can be in: Episode 550's `screenwalk.smdf.json`, then the media
+ * cycle that continues it after Reviewed (`screenwalk-media-cycle.smdf.json`).
+ */
+export const SCREENWALK_STATES = [
+    "NotStarted",
+    "Recording",
+    "Witnessing",
+    "ClosingDrafted",
+    "Played",
+    "Revising",
+    "Recorded",
+    "Published",
+    "Reviewed",
+    "Chronicled",
+    "InConversation",
+    "Enriched",
+    "Notebooked",
+    "MediaGenerated",
+    "Watched",
+    "HeldInCircle",
+    "ScriptedNext",
+];
+export function isScreenwalkState(value) {
+    return typeof value === "string" && SCREENWALK_STATES.includes(value);
+}
+/** A date and time stamp of six to ten digits, then optional `-word` parts: `2610061207`, `261005-001`. */
+const SCREENWALK_ID = /^[0-9]{6,10}(?:-[0-9a-z]+)*$/;
+export function isScreenwalkId(value) {
+    return typeof value === "string" && SCREENWALK_ID.test(value);
+}
+export function screenwalkReference(id) {
+    return `${SCREENWALK_REFERENCE_PREFIX}${id}`;
+}
+export function screenwalkFolder(id) {
+    return `${SCREENWALK_FOLDER_PREFIX}${id}`;
+}
+/** The record's path inside an episode vessel, relative to the vessel. */
+export function screenwalkPath(id) {
+    return `captures/${screenwalkFolder(id)}/${SCREENWALK_FILE}`;
+}
+/**
+ * Read a screenwalk reference: `miadi-screenwalk:<id>`, `miadi-screenwalk://<id>`, a folder
+ * name `screenwalk-<id>`, or a bare id. Null for anything else.
+ */
+export function parseScreenwalkRef(input) {
+    if (typeof input !== "string")
+        return null;
+    let raw = input.trim().toLowerCase();
+    if (raw.startsWith(SCREENWALK_REFERENCE_PREFIX))
+        raw = raw.slice(SCREENWALK_REFERENCE_PREFIX.length).replace(/^\/\//, "");
+    else if (raw.startsWith(SCREENWALK_FOLDER_PREFIX))
+        raw = raw.slice(SCREENWALK_FOLDER_PREFIX.length);
+    if (!isScreenwalkId(raw))
+        return null;
+    return { id: raw, reference: screenwalkReference(raw), folder: screenwalkFolder(raw) };
+}
+/**
+ * The date and time an id names, read from its leading digits (`yymmdd`, `yymmddHH`,
+ * `yymmddHHMM`). Local time, as the person wrote it. Null when the digits are not a date.
+ */
+export function parseScreenwalkStamp(id) {
+    const digits = /^([0-9]{6,10})/.exec(id)?.[1];
+    if (!digits || (digits.length !== 6 && digits.length !== 8 && digits.length !== 10))
+        return null;
+    const [yy, mm, dd, hh, mi] = [0, 2, 4, 6, 8].map((i) => digits.slice(i, i + 2));
+    const month = Number(mm);
+    const day = Number(dd);
+    if (month < 1 || month > 12 || day < 1 || day > 31)
+        return null;
+    const date = `20${yy}-${mm}-${dd}`;
+    if (!hh)
+        return { date, precision: "day" };
+    if (Number(hh) > 23 || (mi && Number(mi) > 59))
+        return null;
+    return { date, time: `${hh}:${mi || "00"}`, precision: mi ? "minute" : "hour" };
+}
+export const SCREENWALK_OUTPUT_KINDS = ["dialogue", "chapters", "short", "audio", "other"];
+/** The record's keys in the order `screenwalk.json` writes them. */
+export const SCREENWALK_RECORD_KEYS = [
+    "screenwalk",
+    "reference",
+    "state",
+    "episode",
+    "stamp",
+    "recording",
+    "video",
+    "review",
+    "related",
+    "sessions",
+    "closings",
+    "transcriptions",
+    "outputs",
+    "finding",
+    "audio_take",
+];
+/**
+ * Keys of the hand-written screenwalk `capture.json` files that `toScreenwalkRecord` maps.
+ * A converter that meets any other key should stop rather than drop it.
+ */
+export const LEGACY_SCREENWALK_KEYS = [
+    "stem",
+    "video",
+    "title",
+    "review",
+    "reference",
+    "started",
+    "session",
+    "sessions",
+    "seat_ledgers",
+    "related",
+    "recording",
+    "stamp_estimate",
+    "transcriptions",
+    "finding",
+    "note",
+];
+function text(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function obj(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
+}
+function list(value) {
+    return Array.isArray(value) ? value : [];
+}
+const SESSION_ID = /^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\b\s*(?:\((.*)\))?\s*$/is;
+/** A session written as an object, or as the early string `"<uuid> (note)"`. */
+function toSession(raw) {
+    if (typeof raw === "string") {
+        const match = SESSION_ID.exec(raw.trim());
+        if (match)
+            return { session_id: match[1].toLowerCase(), ...(text(match[2]) ? { note: text(match[2]) } : {}) };
+        return text(raw) ? { note: text(raw) } : null;
+    }
+    const r = obj(raw);
+    if (!r)
+        return null;
+    const session = {};
+    const id = text(r.session_id) ?? text(r.session);
+    if (id)
+        session.session_id = id;
+    const name = text(r.name) ?? text(r.seat);
+    if (name)
+        session.name = name;
+    const note = text(r.note);
+    if (note)
+        session.note = note;
+    const ledger = text(r.ledger) ?? text(r.file);
+    if (ledger)
+        session.ledger = ledger;
+    return Object.keys(session).length ? session : null;
+}
+/** Attach each early `seat_ledgers` entry to its session: by session id, then by a note opening with the seat's name. */
+function attachLedgers(sessions, ledgers) {
+    for (const raw of ledgers) {
+        const ledger = toSession(raw);
+        if (!ledger?.ledger)
+            continue;
+        const seat = ledger.name;
+        const match = sessions.find((s) => (ledger.session_id && s.session_id === ledger.session_id) ||
+            (seat && !s.name && s.note !== undefined && new RegExp(`^${seat.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?:[;,)]|$)`).test(s.note)));
+        if (match) {
+            if (seat && !match.name) {
+                match.name = seat;
+                if (match.note) {
+                    const rest = match.note.slice(seat.length).replace(/^[;,]\s*/, "").trim();
+                    if (rest)
+                        match.note = rest;
+                    else
+                        delete match.note;
+                }
+            }
+            match.ledger = ledger.ledger;
+            if (ledger.session_id && !match.session_id)
+                match.session_id = ledger.session_id;
+        }
+        else {
+            sessions.push(ledger);
+        }
+    }
+    return sessions;
+}
+function toTranscription(raw) {
+    const r = obj(raw);
+    const file = text(r?.file);
+    if (!r || !file)
+        return null;
+    const out = { file };
+    const source = text(r.source);
+    if (source)
+        out.source = source;
+    const coverage = text(r.coverage);
+    if (coverage)
+        out.coverage = coverage;
+    if (typeof r.complete === "boolean")
+        out.complete = r.complete;
+    return out;
+}
+function toClosing(raw) {
+    const r = obj(raw);
+    if (!r || typeof r.version !== "number" || !Number.isSafeInteger(r.version) || r.version < 1)
+        return null;
+    const out = { version: r.version };
+    const file = text(r.file);
+    if (file)
+        out.file = file;
+    const correction = text(r.correction);
+    if (correction)
+        out.correction = correction;
+    return out;
+}
+function toOutput(raw) {
+    const r = obj(raw);
+    if (!r)
+        return null;
+    const kind = SCREENWALK_OUTPUT_KINDS.includes(r.kind) ? r.kind : undefined;
+    if (!kind)
+        return null;
+    const out = { kind };
+    for (const key of ["ref", "starts_at", "ends_at", "note"]) {
+        const value = text(r[key]);
+        if (value)
+            out[key] = value;
+    }
+    return out;
+}
+function toReview(raw) {
+    const r = obj(raw);
+    const ref = parseReviewRef(r ? (text(r.id) ?? text(r.url)) : raw);
+    if (!ref)
+        return undefined;
+    const version = r && typeof r.version === "number" && Number.isSafeInteger(r.version) && r.version > 0 ? r.version : ref.version;
+    return { id: ref.id, ...(version !== undefined ? { version } : {}) };
+}
+function toVideo(raw, title) {
+    const r = obj(raw);
+    const url = r ? text(r.url) : text(raw);
+    if (!url)
+        return undefined;
+    const video = { url };
+    const t = (r && text(r.title)) ?? text(title);
+    if (t)
+        video.title = t;
+    const published = r && text(r.published_at);
+    if (published)
+        video.published_at = published;
+    return video;
+}
+function toRecording(raw, estimate) {
+    const r = obj(raw);
+    const e = obj(estimate);
+    const recording = {};
+    const fromEstimate = e ? parseScreenwalkStamp(text(e.stamp) ?? "") : null;
+    const started = (r && (text(r.started) ?? text(r.started_estimate))) ?? (fromEstimate?.time ? `${fromEstimate.date}T${fromEstimate.time}` : undefined);
+    if (started)
+        recording.started = started;
+    const length = r && text(r.length);
+    if (length)
+        recording.length = length;
+    const evidence = (r && text(r.evidence)) ?? (e && text(e.evidence));
+    if (evidence)
+        recording.evidence = evidence;
+    const retake = r && text(r.retake);
+    if (retake)
+        recording.retake = retake;
+    return Object.keys(recording).length ? recording : undefined;
+}
+/** The furthest state the record's own fields prove: a review, then a video. Undefined otherwise. */
+export function deriveScreenwalkState(record) {
+    if (record.review)
+        return "Reviewed";
+    if (record.video)
+        return "Published";
+    return undefined;
+}
+/**
+ * Tolerant reader for a `screenwalk.json`, or for a screenwalk `capture.json` written by hand
+ * before this record existed (`stem`, `video` as a string, `review` as `miadi-review:<uuid>`,
+ * `session`/`sessions` strings, `seat_ledgers`, `stamp_estimate`). The id comes from
+ * `screenwalk`, then `stem`, then `options.id` (the folder name), then `reference`. Null when
+ * none names a screenwalk.
+ */
+export function toScreenwalkRecord(raw, options = {}) {
+    const r = obj(raw);
+    if (!r)
+        return null;
+    const ref = parseScreenwalkRef(r.screenwalk) ?? parseScreenwalkRef(r.stem) ?? parseScreenwalkRef(options.id) ?? parseScreenwalkRef(r.reference);
+    if (!ref)
+        return null;
+    const record = {
+        screenwalk: ref.id,
+        reference: ref.reference,
+        sessions: [],
+        closings: [],
+        transcriptions: [],
+        outputs: [],
+    };
+    const episode = text(r.episode) ?? options.episode;
+    const stamp = text(r.stamp) ?? text(r.started);
+    const named = parseScreenwalkStamp(ref.id);
+    const recording = toRecording(r.recording, r.stamp_estimate);
+    const video = toVideo(r.video, r.title);
+    const review = toReview(r.review);
+    const related = list(r.related).map(text).filter((v) => v !== undefined);
+    const sessions = attachLedgers([...list(r.sessions), ...(r.session !== undefined ? [r.session] : [])].map(toSession).filter((s) => s !== null), list(r.seat_ledgers));
+    const finding = text(r.finding);
+    const audioTake = text(r.audio_take);
+    const state = isScreenwalkState(r.state) ? r.state : deriveScreenwalkState({ review, video });
+    if (state)
+        record.state = state;
+    if (episode)
+        record.episode = episode;
+    if (stamp)
+        record.stamp = stamp;
+    else if (named?.time)
+        record.stamp = `${named.date}T${named.time}`;
+    if (recording)
+        record.recording = recording;
+    if (video)
+        record.video = video;
+    if (review)
+        record.review = review;
+    if (related.length)
+        record.related = related;
+    record.sessions = sessions.map((s) => {
+        const ordered = {};
+        for (const key of ["session_id", "name", "note", "ledger"])
+            if (s[key] !== undefined)
+                ordered[key] = s[key];
+        return ordered;
+    });
+    record.closings = list(r.closings).map(toClosing).filter((c) => c !== null);
+    record.transcriptions = list(r.transcriptions).map(toTranscription).filter((t) => t !== null);
+    record.outputs = list(r.outputs).map(toOutput).filter((o) => o !== null);
+    if (finding)
+        record.finding = finding;
+    if (audioTake)
+        record.audio_take = audioTake;
+    // Rebuild in the order the file writes, so a written record diffs cleanly.
+    const ordered = {};
+    for (const key of SCREENWALK_RECORD_KEYS)
+        if (record[key] !== undefined)
+            ordered[key] = record[key];
+    return ordered;
+}
+/** Strict guard for a record as `screenwalk.json` writes it. */
+export function isScreenwalkRecord(value) {
+    const r = obj(value);
+    if (!r || !isScreenwalkId(r.screenwalk) || r.reference !== screenwalkReference(r.screenwalk))
+        return false;
+    if (r.state !== undefined && !isScreenwalkState(r.state))
+        return false;
+    for (const key of ["sessions", "closings", "transcriptions", "outputs"])
+        if (!Array.isArray(r[key]))
+            return false;
+    const video = r.video === undefined ? null : obj(r.video);
+    if (r.video !== undefined && !text(video?.url))
+        return false;
+    const review = r.review === undefined ? null : obj(r.review);
+    if (r.review !== undefined && !isReviewId(review?.id))
+        return false;
+    if (!r.outputs.every((o) => toOutput(o) !== null))
+        return false;
+    if (!r.transcriptions.every((t) => toTranscription(t) !== null))
+        return false;
+    if (!r.closings.every((c) => toClosing(c) !== null))
+        return false;
+    return true;
+}
+//# sourceMappingURL=screenwalk.js.map

package/dist/screenwalk.js.map

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

package/dist/story-library-manifest.d.ts

@@ -10,7 +10,7 @@
  * and validates what it is handed so the app and forgewright never fork the
  * read-side.
  *
- * OWNERSHIP (jgwill/Miadi#592, packages/CLAUDE.md): this module is the *declaration*
+ * OWNERSHIP (jgwill/Miadi#592, packages/AGENTS.md): this module is the *declaration*
  * of the chronicle→book edge. `@miadi/inquiry-weave` owns its *enumeration* and never
  * authors a story; `packages/passages` owns the *derivation* of a book from a vessel,
  * as a read-only projection of the chronicle; `app/chronicle` renders and serves.

package/dist/story-library-manifest.js

@@ -10,7 +10,7 @@
  * and validates what it is handed so the app and forgewright never fork the
  * read-side.
  *
- * OWNERSHIP (jgwill/Miadi#592, packages/CLAUDE.md): this module is the *declaration*
+ * OWNERSHIP (jgwill/Miadi#592, packages/AGENTS.md): this module is the *declaration*
  * of the chronicle→book edge. `@miadi/inquiry-weave` owns its *enumeration* and never
  * authors a story; `packages/passages` owns the *derivation* of a book from a vessel,
  * as a read-only projection of the chronicle; `app/chronicle` renders and serves.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/episodic-memory-schema",
-  "version": "0.11.1",
+  "version": "0.13.0",
   "description": "TypeScript types and JSON Schema for episodic memory — the durable session-to-session memory layer in the Miadi orchestration kit. Narrative layer is NCP-aligned; provenance layer is W3C PROV-DM and OAIS-informed.",
   "keywords": [
     "miadi",
@@ -31,6 +31,7 @@
       "default": "./dist/index.js"
     },
     "./schema": "./schema/episodic-memory.schema.json",
+    "./schema/screenwalk": "./schema/screenwalk.schema.json",
     "./package.json": "./package.json"
   },
   "files": [

package/schema/screenwalk.schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/jgwill/Miadi/packages/episodic-memory-schema/schema/screenwalk.schema.json",
+  "title": "Screenwalk record",
+  "description": "captures/screenwalk-<id>/screenwalk.json in a chronicle episode vessel: a recording of a person working live with agent sessions, with their voices. Types: src/screenwalk.ts.",
+  "type": "object",
+  "required": ["screenwalk", "reference", "sessions", "closings", "transcriptions", "outputs"],
+  "properties": {
+    "screenwalk": { "type": "string", "pattern": "^[0-9]{6,10}(?:-[0-9a-z]+)*$", "description": "The stamp yymmddHHMM, or an early yymmdd-NNN." },
+    "reference": { "type": "string", "pattern": "^miadi-screenwalk:[0-9]{6,10}(?:-[0-9a-z]+)*$" },
+    "state": {
+      "enum": ["NotStarted", "Recording", "Witnessing", "ClosingDrafted", "Played", "Revising", "Recorded", "Published", "Reviewed", "Chronicled", "InConversation", "Enriched", "Notebooked", "MediaGenerated", "Watched", "HeldInCircle", "ScriptedNext"]
+    },
+    "episode": { "type": "string", "description": "The episode directory that holds it." },
+    "stamp": { "type": "string", "description": "The minute the person named, YYYY-MM-DDTHH:MM local." },
+    "recording": {
+      "type": "object",
+      "properties": {
+        "started": { "type": "string" },
+        "length": { "type": "string" },
+        "evidence": { "type": "string" },
+        "retake": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "video": {
+      "type": "object",
+      "required": ["url"],
+      "properties": {
+        "url": { "type": "string", "minLength": 1 },
+        "title": { "type": "string" },
+        "published_at": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "review": {
+      "type": "object",
+      "required": ["id"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$" },
+        "version": { "type": "integer", "minimum": 1 }
+      },
+      "additionalProperties": false
+    },
+    "related": { "type": "array", "items": { "type": "string" } },
+    "sessions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "session_id": { "type": "string" },
+          "name": { "type": "string" },
+          "note": { "type": "string" },
+          "ledger": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "closings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["version"],
+        "properties": {
+          "version": { "type": "integer", "minimum": 1 },
+          "file": { "type": "string" },
+          "correction": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "transcriptions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["file"],
+        "properties": {
+          "file": { "type": "string", "minLength": 1 },
+          "source": { "type": "string" },
+          "coverage": { "type": "string" },
+          "complete": { "type": "boolean" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "outputs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["kind"],
+        "properties": {
+          "kind": { "enum": ["dialogue", "chapters", "short", "audio", "other"] },
+          "ref": { "type": "string" },
+          "starts_at": { "type": "string" },
+          "ends_at": { "type": "string" },
+          "note": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "finding": { "type": "string" },
+    "audio_take": { "type": "string" }
+  },
+  "additionalProperties": false
+}