@miadi/episodic-memory-schema 0.11.0 → 0.12.0

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,18 +168,25 @@ modifies source material.
 
 ---
 
-## Reviews held by an episode
-
-`parseReviewRef`, `readEpisodeReviews`, `reviewNodeId` and `EpisodeReviewEntry` type a Miadi
-review inside `episode.yaml` (`reviews:`), in the shape Episode 345 set on the wheel
-(`review:<uuid>`). Pure: no fs, no fetch. jgwill/Miadi#682.
+## 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.
 
 ---
 
@@ -182,7 +199,7 @@ review inside `episode.yaml` (`reviews:`), in the shape Episode 345 set on the w
 | 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-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,10 @@ 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";
 //# 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"}

package/dist/index.js

@@ -29,4 +29,9 @@ 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";
 //# 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"}

package/package.json

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