@miadi/episodic-memory-schema 0.10.0 → 0.11.1

package/README.md

@@ -2,6 +2,16 @@
 
 Types + JSON Schema for **episodic memory** — the durable session-to-session memory layer in the Miadi orchestration kit.
 
+In the Miadi stack, this is the shared record format. An episode is the unit everything is
+filed under, and this package defines its shapes: the authored `EpisodicMemory` a session
+leaves behind, and the read-only observations, manifests and catalogs other packages build
+from existing episode folders. It has no dependencies and touches no filesystem: callers read
+the files and hand it what they read.
+
+Most of the stack depends on it: `@miadi/inquiry-weave`, `passages`, `@miadi/capture`,
+`@miadi/episode-capture`, `@miadi/transcription`, `@miadi/plan-insight` and
+`@miadi/musical-composition-to-episode`.
+
 When a Storyweaver session closes, the Export Steward extracts an episodic-memory object and feeds it back to Miadi world memory. The next commission inherits what this one built.
 
 ---
@@ -35,7 +45,7 @@ EpisodicMemory
 
 ### Narrative layer is NCP-aligned
 
-The `narrative` layer mirrors the [Narrative Context Protocol](https://github.com/) two-layer model:
+The `narrative` layer mirrors the Narrative Context Protocol (NCP) two-layer model:
 
 - **Subtext** — authorial intent: perspectives, players, storypoints, storybeats, dynamics
 - **Storytelling** — surface presentation: overviews, moments
@@ -52,7 +62,7 @@ An NCP-consuming agent can read the narrative layer directly. Episodic-memory ad
 ## Install
 
 ```bash
-pnpm add @miadi/episodic-memory-schema
+npm i @miadi/episodic-memory-schema
 ```
 
 ## Usage
@@ -158,12 +168,25 @@ modifies source material.
 
 ---
 
+## Also in this package
+
+- **Chronicle and story-library manifests.** `observeChronicleManifest`,
+  `EpisodeManifestEntry`, `chronicleEpisodeNodeId`, `linkEpisodeCaptures`;
+  `observeStoryLibrary`, `StoryManifestEntry`, `indexStoriesByEpisode`, `linkStoryForms`. They
+  shape a snapshot of the chronicle, or of a library of stories made from episodes, that the
+  caller hands in.
+- **Episode captures.** `EpisodeCaptureRecord` and its parts: the descriptor of a recording
+  filed into an episode. `CaptureProvenance` is the provenance a capture carries.
+- **Attention items.** The `attention.json` store an episode keeps for questions waiting on a
+  person (`ATTENTION_FILE`, schema `chronicle.attention.v1`).
+- **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.
+
 ## Versioning
 
-- v0.2.0 (current) — compatibility-first observation adapters for composition manifests, parsed episode YAML, and descriptor-light directory snapshots
-- v0.1.1 — strict authored episodic-memory types and JSON Schema
-- The package release is `0.2.0`; the authored memory schema remains `episodic-memory.v1.0`
-- Schema version is encoded in the `schemaVersion` field, independently of the package version
+The package version and the authored memory schema version move independently. The schema is
+`episodic-memory.v1.0`, carried in the `schemaVersion` field.
 
 ---
 
@@ -176,7 +199,7 @@ modifies source material.
 | W3C PROV-DM | Source / agent / activity attribution |
 | OAIS reference model + FAIR (Wilkinson 2016) | Archival packaging frame |
 | HAWK (Cheng et al. 2025, arXiv:2507.04067) | 10-predicate evaluation rubric; versioned chapter-state audit trail |
-| Storyweaver foundations (`foundations/narrative-studies-and-digital-storytelling/`) | Domain integration |
+| Storyweaver foundations (narrative studies and digital storytelling) | Domain integration |
 
 ## License
 

package/dist/episode-review.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The chronicle REVIEW contract — a Miadi review held by an episode.
+ *
+ * A review lives in the Miadi Review service and has one public address,
+ * `<base>/review/<uuid>`. Episode 345 (`review-medicine-wheel-experiment.md`)
+ * set the practice this module types: the review is one reusable node on the
+ * wheel (`review:<uuid>`), each episode relates to it with an edge naming the
+ * contribution it expects, and the episode keeps its own record of which
+ * version it used. Earlier manifests cite a review as a reference string
+ * `miadi-review:<uuid>`; those are read as reviews too.
+ *
+ * Manifest shape (`episode.yaml`):
+ *
+ *   reviews:
+ *     - id: 1e1ba57a-9e30-41ea-8126-5735c3f344bd
+ *       url: https://miadi-review-service.vercel.app/review/1e1ba57a-…
+ *       title: Software Fundamentals in the Age of AI — Matt Pocock
+ *       version: 2
+ *       relation: discusses
+ *       added: '2026-09-24T10:30:00.000Z'
+ *       ceremony: <ceremony id>
+ *       circle: <circle node id>
+ *
+ * Pure — no fs, no fetch. Reading and writing the file is the consumer's.
+ * Ref: jgwill/Miadi#630.
+ */
+/** Where reviews are published when nothing else is configured. */
+export declare const REVIEW_SERVICE_BASE_URL = "https://miadi-review-service.vercel.app";
+/** The portable reference form Episode 345 wrote into `references:`. */
+export declare const REVIEW_REFERENCE_PREFIX = "miadi-review:";
+/** Wheel node ids for reviews: `review:<uuid>` (Episode 345). */
+export declare const REVIEW_NODE_PREFIX = "review:";
+/** The wheel metadata kind a review node carries. */
+export declare const REVIEW_NODE_KIND = "miadi_review";
+export declare function isReviewId(value: unknown): value is string;
+export declare function reviewNodeId(id: string): string;
+export declare function reviewReference(id: string): string;
+export declare function reviewPageUrl(id: string, base?: string): string;
+export declare function reviewJsonUrl(id: string, base?: string, version?: number): string;
+export interface ReviewRef {
+    /** The review UUID, lower-case. */
+    id: string;
+    /** The canonical public page, `<base>/review/<id>`. */
+    url: string;
+    /** The service origin the reference was read against. */
+    base: string;
+    /** Set when the reference pinned one version (`?v=N`). */
+    version?: number;
+}
+/**
+ * Read a review reference. Accepts the public page URL, its `/json` or `/raw`
+ * form, `?v=N`, `miadi-review:<uuid>`, `review:<uuid>`, or a bare uuid. A URL
+ * is accepted only on the configured service origin, so a caller cannot make a
+ * server fetch an address of its choosing. Returns null for anything else.
+ */
+export declare function parseReviewRef(input: unknown, options?: {
+    base?: string;
+}): ReviewRef | null;
+/** One review as an episode records it. */
+export interface EpisodeReviewEntry {
+    /** The review UUID. */
+    id: string;
+    /** Canonical public page URL. */
+    url: string;
+    title?: string;
+    /** The review version this episode used. The review may have moved on since. */
+    version?: number;
+    /** The intended contribution, as the episode→review edge's relationship type. */
+    relation?: string;
+    /** ISO timestamp the review entered the episode. */
+    added?: string;
+    /** The ceremony held to discuss this review, once one opened. */
+    ceremony?: string;
+    /** The circle that ceremony was held in. */
+    circle?: string;
+}
+export interface ObservedEpisodeReview extends EpisodeReviewEntry {
+    /** `reviews` for a structured entry, `references` for an Episode 345 `miadi-review:<uuid>` citation. */
+    declared: "reviews" | "references";
+}
+/** The entry's keys in the order the manifest writes them. */
+export declare const REVIEW_ENTRY_KEYS: readonly ["id", "url", "title", "version", "relation", "added", "ceremony", "circle"];
+/** Tolerant reader for one `reviews:` item. Null when it names no review. */
+export declare function toEpisodeReviewEntry(raw: unknown, options?: {
+    base?: string;
+}): EpisodeReviewEntry | null;
+/**
+ * Every review a parsed `episode.yaml` holds: the structured `reviews:` list
+ * first, then `miadi-review:<uuid>` citations in `references:` that the list
+ * does not already name. One entry per review id.
+ */
+export declare function readEpisodeReviews(manifest: unknown, options?: {
+    base?: string;
+}): ObservedEpisodeReview[];
+//# sourceMappingURL=episode-review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"episode-review.d.ts","sourceRoot":"","sources":["../src/episode-review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,4CAA4C,CAAA;AAEhF,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,kBAAkB,CAAA;AAEtD,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,YAAY,CAAA;AAE3C,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,iBAAiB,CAAA;AAK9C,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE1D;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,MAAgC,GAAG,MAAM,CAExF;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,MAAgC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1G;AAED,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAA;IACX,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,GAAG,IAAI,CAgChG;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,wGAAwG;IACxG,QAAQ,EAAE,SAAS,GAAG,YAAY,CAAA;CACnC;AAMD,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,uFAAwF,CAAA;AAEtH,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,kBAAkB,GAAG,IAAI,CAuB7G;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,qBAAqB,EAAE,CAmB9G"}

package/dist/episode-review.js

@@ -0,0 +1,161 @@
+/**
+ * The chronicle REVIEW contract — a Miadi review held by an episode.
+ *
+ * A review lives in the Miadi Review service and has one public address,
+ * `<base>/review/<uuid>`. Episode 345 (`review-medicine-wheel-experiment.md`)
+ * set the practice this module types: the review is one reusable node on the
+ * wheel (`review:<uuid>`), each episode relates to it with an edge naming the
+ * contribution it expects, and the episode keeps its own record of which
+ * version it used. Earlier manifests cite a review as a reference string
+ * `miadi-review:<uuid>`; those are read as reviews too.
+ *
+ * Manifest shape (`episode.yaml`):
+ *
+ *   reviews:
+ *     - id: 1e1ba57a-9e30-41ea-8126-5735c3f344bd
+ *       url: https://miadi-review-service.vercel.app/review/1e1ba57a-…
+ *       title: Software Fundamentals in the Age of AI — Matt Pocock
+ *       version: 2
+ *       relation: discusses
+ *       added: '2026-09-24T10:30:00.000Z'
+ *       ceremony: <ceremony id>
+ *       circle: <circle node id>
+ *
+ * Pure — no fs, no fetch. Reading and writing the file is the consumer's.
+ * Ref: jgwill/Miadi#630.
+ */
+/** Where reviews are published when nothing else is configured. */
+export const REVIEW_SERVICE_BASE_URL = "https://miadi-review-service.vercel.app";
+/** The portable reference form Episode 345 wrote into `references:`. */
+export const REVIEW_REFERENCE_PREFIX = "miadi-review:";
+/** Wheel node ids for reviews: `review:<uuid>` (Episode 345). */
+export const REVIEW_NODE_PREFIX = "review:";
+/** The wheel metadata kind a review node carries. */
+export const REVIEW_NODE_KIND = "miadi_review";
+/** The same UUID rule the review service applies to `/review/<id>`. */
+const REVIEW_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+export function isReviewId(value) {
+    return typeof value === "string" && REVIEW_ID.test(value);
+}
+export function reviewNodeId(id) {
+    return `${REVIEW_NODE_PREFIX}${id.toLowerCase()}`;
+}
+export function reviewReference(id) {
+    return `${REVIEW_REFERENCE_PREFIX}${id.toLowerCase()}`;
+}
+export function reviewPageUrl(id, base = REVIEW_SERVICE_BASE_URL) {
+    return `${base.replace(/\/+$/, "")}/review/${id.toLowerCase()}`;
+}
+export function reviewJsonUrl(id, base = REVIEW_SERVICE_BASE_URL, version) {
+    return `${reviewPageUrl(id, base)}/json${version !== undefined ? `?v=${version}` : ""}`;
+}
+/**
+ * Read a review reference. Accepts the public page URL, its `/json` or `/raw`
+ * form, `?v=N`, `miadi-review:<uuid>`, `review:<uuid>`, or a bare uuid. A URL
+ * is accepted only on the configured service origin, so a caller cannot make a
+ * server fetch an address of its choosing. Returns null for anything else.
+ */
+export function parseReviewRef(input, options = {}) {
+    const base = (options.base ?? REVIEW_SERVICE_BASE_URL).replace(/\/+$/, "");
+    if (typeof input !== "string")
+        return null;
+    const raw = input.trim();
+    if (!raw)
+        return null;
+    for (const prefix of ["", REVIEW_REFERENCE_PREFIX, REVIEW_NODE_PREFIX]) {
+        if (raw.toLowerCase().startsWith(prefix) && isReviewId(raw.slice(prefix.length))) {
+            const id = raw.slice(prefix.length).toLowerCase();
+            return { id, url: reviewPageUrl(id, base), base };
+        }
+    }
+    let url;
+    let origin;
+    try {
+        url = new URL(raw);
+        origin = new URL(base).origin;
+    }
+    catch {
+        return null;
+    }
+    if (url.origin !== origin)
+        return null;
+    const match = /^\/review\/([^/]+)(?:\/(?:json|raw))?\/?$/.exec(url.pathname);
+    if (!match || !isReviewId(match[1]))
+        return null;
+    const id = match[1].toLowerCase();
+    const pinned = Number(url.searchParams.get("v"));
+    return {
+        id,
+        url: reviewPageUrl(id, base),
+        base,
+        ...(Number.isSafeInteger(pinned) && pinned > 0 ? { version: pinned } : {}),
+    };
+}
+function text(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+/** The entry's keys in the order the manifest writes them. */
+export const REVIEW_ENTRY_KEYS = ["id", "url", "title", "version", "relation", "added", "ceremony", "circle"];
+/** Tolerant reader for one `reviews:` item. Null when it names no review. */
+export function toEpisodeReviewEntry(raw, options = {}) {
+    if (typeof raw === "string") {
+        const ref = parseReviewRef(raw, options);
+        return ref ? { id: ref.id, url: ref.url, ...(ref.version !== undefined ? { version: ref.version } : {}) } : null;
+    }
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+        return null;
+    const r = raw;
+    const ref = parseReviewRef(text(r.id) ?? text(r.url), options);
+    if (!ref)
+        return null;
+    const version = typeof r.version === "number" && Number.isSafeInteger(r.version) && r.version > 0 ? r.version : ref.version;
+    const added = r.added instanceof Date ? r.added.toISOString() : text(r.added);
+    const entry = { id: ref.id, url: text(r.url) ?? ref.url };
+    const title = text(r.title);
+    if (title)
+        entry.title = title;
+    if (version !== undefined)
+        entry.version = version;
+    const relation = text(r.relation);
+    if (relation)
+        entry.relation = relation;
+    if (added)
+        entry.added = added;
+    const ceremony = text(r.ceremony);
+    if (ceremony)
+        entry.ceremony = ceremony;
+    const circle = text(r.circle);
+    if (circle)
+        entry.circle = circle;
+    return entry;
+}
+/**
+ * Every review a parsed `episode.yaml` holds: the structured `reviews:` list
+ * first, then `miadi-review:<uuid>` citations in `references:` that the list
+ * does not already name. One entry per review id.
+ */
+export function readEpisodeReviews(manifest, options = {}) {
+    if (typeof manifest !== "object" || manifest === null)
+        return [];
+    const m = manifest;
+    const out = [];
+    const seen = new Set();
+    for (const item of Array.isArray(m.reviews) ? m.reviews : []) {
+        const entry = toEpisodeReviewEntry(item, options);
+        if (!entry || seen.has(entry.id))
+            continue;
+        seen.add(entry.id);
+        out.push({ ...entry, declared: "reviews" });
+    }
+    for (const reference of Array.isArray(m.references) ? m.references : []) {
+        if (typeof reference !== "string" || !reference.trim().toLowerCase().startsWith(REVIEW_REFERENCE_PREFIX))
+            continue;
+        const ref = parseReviewRef(reference, options);
+        if (!ref || seen.has(ref.id))
+            continue;
+        seen.add(ref.id);
+        out.push({ id: ref.id, url: ref.url, declared: "references" });
+    }
+    return out;
+}
+//# sourceMappingURL=episode-review.js.map

package/dist/episode-review.js.map

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

package/dist/index.d.ts

@@ -26,4 +26,10 @@ export type { StableArtifactIdInput } from "./adapters/common.js";
  */
 export { ATTENTION_FILE, ATTENTION_SCHEMA_VERSION, toAttentionItem, parseAttentionStore, serializeAttentionStore, } from "./attention.js";
 export type { AttentionItem, AttentionStore, ParsedAttentionStore, } from "./attention.js";
+/**
+ * The chronicle REVIEW contract — a Miadi review held by an episode, in the
+ * 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";
+export type { ReviewRef, EpisodeReviewEntry, ObservedEpisodeReview } from "./episode-review.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"}
+{"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"}

package/dist/index.js

@@ -24,4 +24,9 @@ export { stableArtifactId, tryStableArtifactId, isStableArtifactId, captureStabl
  * jgwill/Miadi#615). One owner for the shape every surface renders.
  */
 export { ATTENTION_FILE, ATTENTION_SCHEMA_VERSION, toAttentionItem, parseAttentionStore, serializeAttentionStore, } from "./attention.js";
+/**
+ * The chronicle REVIEW contract — a Miadi review held by an episode, in the
+ * 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";
 //# 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"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/episodic-memory-schema",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "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",