@miadi/episodic-memory-schema 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Miadi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,138 @@
+# `@miadi/episodic-memory-schema`
+
+Types + JSON Schema for **episodic memory** — the durable session-to-session memory layer in the Miadi orchestration kit.
+
+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.
+
+---
+
+## Why "episodic"
+
+Tulving (1972) distinguishes three long-term memory systems:
+
+| Type        | What it stores                  | Storyweaver analogue                |
+| ----------- | ------------------------------- | ----------------------------------- |
+| Episodic    | Memory of experienced events    | **This schema** — one session = one episode |
+| Semantic    | Decontextualized facts          | The Story Bible                     |
+| Procedural  | How to do things                | Skills + agent working rules        |
+
+The package is named for the cognitive system it serves, not the artifact alone.
+
+---
+
+## Schema layers
+
+```
+EpisodicMemory
+├── episode       — sessionId, openedAt/closedAt, charter, lineage
+├── narrative     — NCP-aligned subtext + storytelling
+├── world         — settings, rules introduced, characters advanced, themes
+├── provenance    — sources, consent decisions, authority flags
+├── continuity    — open promises, canonical facts, contradictions, chapter versions
+├── evaluations   — HAWK 10-predicate rubric per beat/chapter/outline
+└── followUpCommissions — seeds for the next episode
+```
+
+### Narrative layer is NCP-aligned
+
+The `narrative` layer mirrors the [Narrative Context Protocol](https://github.com/) two-layer model:
+
+- **Subtext** — authorial intent: perspectives, players, storypoints, storybeats, dynamics
+- **Storytelling** — surface presentation: overviews, moments
+
+An NCP-consuming agent can read the narrative layer directly. Episodic-memory adds the four other layers (episode metadata, world delta, provenance, continuity) that NCP doesn't cover.
+
+### Provenance layer is PROV-DM and OAIS-informed
+
+- **W3C PROV-DM** for source-decision-authority triples
+- **OAIS** (Wilkinson et al. 2016, FAIR) for archival packaging: the session workspace is a SIP, the export packet is an AIP, the delivered story is a DIP
+
+---
+
+## Install
+
+```bash
+pnpm add @miadi/episodic-memory-schema
+```
+
+## Usage
+
+```ts
+import type { EpisodicMemory } from "@miadi/episodic-memory-schema"
+
+const ep: EpisodicMemory = {
+  schemaVersion: "episodic-memory.v1.0",
+  episode: {
+    sessionId: "sw-2026-05-19-001",
+    openedAt: "2026-05-19T13:00:00Z",
+    charter: { purpose: "story.bible.from.brief", protocols: ["wilson-3rs", "OCAP"] }
+  },
+  provenance: { sources: [], consentDecisions: [], authorityFlags: [] },
+  continuity: { promises: [], facts: [], contradictions: [] }
+}
+```
+
+The JSON Schema is at `@miadi/episodic-memory-schema/schema` (draft-07). Validate with `ajv`, `zod-from-json-schema`, or any draft-07-compliant validator.
+
+A complete example episode (the *Inwe-village* foundation session from the Storyweaver scenario) lives at `examples/inwe-village.example.json`.
+
+---
+
+## Layer-by-layer
+
+### `episode` — required
+Session identity, charter (purpose + protocols), and lineage. The `parentEpisodeId` and `childCommissionIds` form a directed graph of episodes.
+
+### `narrative` — optional (NCP)
+Use when the session produced narrative material. Skip for utility sessions (e.g. tool maintenance).
+
+### `world` — optional
+The world state *delta* this episode contributed — not the full world. Settings flagged `real | invented | hybrid` and `locked | malleable`. Themes accumulate across episodes.
+
+### `provenance` — required
+- `sources` — every cited material with `authority: open | restricted | sacred | community-controlled`
+- `consentDecisions` — protocol-gate decisions with timestamp + human-confirmation flag
+- `authorityFlags` — open authority concerns raised by the Research Weaver
+
+### `continuity` — required
+- `promises` — Chekhov's-gun-style commitments, with `status: open | fulfilled | broken`
+- `facts` — canonical facts established this episode
+- `contradictions` — detected contradictions and whether they were resolved
+
+### `evaluations` — optional (HAWK)
+Narrative quality evaluations from the Critique Reviewer and Developmental Editor. Each evaluation targets a beat, chapter, outline, draft, or bible, and scores it against the HAWK 10-predicate rubric (Cheng et al. 2025):
+
+- **Goal** (p1–p5): coherence · progression · originality · tension · resonance
+- **Plan** (p6–p10): feasibility · consistency · interactivity · suspense · cohesion
+
+Each value lies in [-1, 1] (the Decision Agent's logit-derived truth signal).
+
+### `continuity.chapterVersions` — optional (HAWK)
+HAWK-style versioned audit trail per chapter — `{ chapterId, version, at, environmentDelta, characterMemoryDelta }`. Enables parallel review of the story's development over time.
+
+### `followUpCommissions` — optional
+Work the manuscript *implies* but did not complete. Each commission becomes a candidate `parentEpisodeId` for the next session.
+
+---
+
+## Versioning
+
+- v0.1.0 (current) — initial schema; expect minor additions before v1.0
+- Schema version is encoded in the `schemaVersion` field, not just the package version
+
+---
+
+## Provenance lineage of this package
+
+| Influence | Contribution |
+| --- | --- |
+| Tulving (1972), *Episodic and semantic memory* | Naming and conceptual grounding |
+| Narrative Context Protocol (Dramatica Co. / USC ETC) | Subtext + Storytelling layer structure |
+| 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 |
+
+## License
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./narrative";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./narrative";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}

package/dist/narrative.d.ts

@@ -0,0 +1,85 @@
+/**
+ * NCP-aligned narrative layer.
+ *
+ * Conceptually mirrors the Narrative Context Protocol (NCP) two-layer model:
+ *   - Subtext      — authorial intent (perspectives, players, storypoints, storybeats, dynamics)
+ *   - Storytelling — surface presentation (overviews, moments)
+ *
+ * Reference: holisticagnostic-narrative-context-protocol
+ * Stewardship: The Dramatica Co. / USC Entertainment Technology Center
+ * License: MIT (compatible)
+ */
+export interface NarrativeContribution {
+    subtext?: Subtext;
+    storytelling?: Storytelling;
+}
+export interface Subtext {
+    perspectives?: Perspective[];
+    players?: Player[];
+    storypoints?: Storypoint[];
+    storybeats?: Storybeat[];
+    dynamics?: Dynamic[];
+}
+export type Throughline = "Main Character" | "Influence Character" | "Objective Story" | "Relationship";
+export interface Perspective {
+    id: string;
+    throughline: Throughline;
+    summary: string;
+    storytelling?: string;
+}
+export interface Player {
+    id: string;
+    name: string;
+    role: string;
+    summary?: string;
+    perspectiveId?: string;
+}
+export interface Storypoint {
+    id: string;
+    perspectiveId?: string;
+    appreciation: string;
+    illustration?: string;
+    storytelling?: string;
+}
+export interface Storybeat {
+    id: string;
+    perspectiveId?: string;
+    sequence?: number;
+    narrativeFunction?: string;
+    illustration: string;
+    summary?: string;
+    storytelling?: string;
+    timestamp?: string;
+    stageId?: string;
+    tones?: BeatTones;
+}
+export interface BeatTones {
+    abstraction?: string;
+    spatial?: string;
+    temporal?: string;
+}
+export interface Dynamic {
+    id: string;
+    name: string;
+    choice: string;
+}
+export interface Storytelling {
+    overviews?: Overview[];
+    moments?: Moment[];
+}
+export interface Overview {
+    id: string;
+    summary: string;
+    storytelling?: string;
+}
+export interface Moment {
+    id: string;
+    type: "Act" | "Scene" | "Sequence" | "Chapter" | "Level" | string;
+    summary: string;
+    synopsis?: string;
+    storybeats?: Array<{
+        order: number;
+        storybeatId: string;
+    }>;
+}
+//# sourceMappingURL=narrative.d.ts.map

package/dist/narrative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative.d.ts","sourceRoot":"","sources":["../src/narrative.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAED,MAAM,WAAW,OAAO;IACtB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;IAC1B,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CACrB;AAED,MAAM,MAAM,WAAW,GACnB,gBAAgB,GAChB,qBAAqB,GACrB,iBAAiB,GACjB,cAAc,CAAA;AAElB,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;IACjE,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC3D"}

package/dist/narrative.js

@@ -0,0 +1,13 @@
+/**
+ * NCP-aligned narrative layer.
+ *
+ * Conceptually mirrors the Narrative Context Protocol (NCP) two-layer model:
+ *   - Subtext      — authorial intent (perspectives, players, storypoints, storybeats, dynamics)
+ *   - Storytelling — surface presentation (overviews, moments)
+ *
+ * Reference: holisticagnostic-narrative-context-protocol
+ * Stewardship: The Dramatica Co. / USC Entertainment Technology Center
+ * License: MIT (compatible)
+ */
+export {};
+//# sourceMappingURL=narrative.js.map

package/dist/narrative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative.js","sourceRoot":"","sources":["../src/narrative.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/types.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Episodic Memory — durable session-to-session memory.
+ *
+ * The cognitive-science analogue: Tulving (1972) distinguishes episodic memory
+ * (memory of experienced events) from semantic memory (facts) and procedural
+ * memory (skills). One Miadi session produces one episodic memory record,
+ * feedable back into world memory as lineage for the next session.
+ *
+ * The schema has five layers:
+ *   1. episode      — session metadata + charter
+ *   2. narrative    — NCP-aligned subtext + storytelling
+ *   3. world        — settings, themes, character advancement (this episode's delta)
+ *   4. provenance   — sources, consent decisions, authority flags (PROV-DM / OAIS-informed)
+ *   5. continuity   — open promises, canonical facts, contradictions
+ *
+ * Plus follow-up commissions — seeds for the next episode.
+ */
+import type { NarrativeContribution } from "./narrative";
+export declare const SCHEMA_VERSION: "episodic-memory.v1.0";
+export type SchemaVersion = typeof SCHEMA_VERSION;
+export interface EpisodicMemory {
+    schemaVersion: SchemaVersion;
+    episode: EpisodeMetadata;
+    narrative?: NarrativeContribution;
+    world?: WorldStateDelta;
+    provenance: ProvenanceRecord;
+    continuity: ContinuityState;
+    evaluations?: NarrativeEvaluation[];
+    followUpCommissions?: FollowUpCommission[];
+}
+export interface EpisodeMetadata {
+    sessionId: string;
+    openedAt: string;
+    closedAt?: string;
+    charter: SessionCharter;
+    parentEpisodeId?: string;
+    childCommissionIds?: string[];
+}
+export interface SessionCharter {
+    purpose: string;
+    protocols?: string[];
+    audience?: string;
+    authority?: "draft" | "review" | "final";
+}
+export interface WorldStateDelta {
+    settings?: WorldSetting[];
+    rulesIntroduced?: string[];
+    charactersAdvanced?: CharacterAdvancement[];
+    themes?: string[];
+}
+export interface WorldSetting {
+    name: string;
+    type: "real" | "invented" | "hybrid";
+    locked: boolean;
+    notes?: string;
+}
+export interface CharacterAdvancement {
+    name: string;
+    role: string;
+    stake?: string;
+    beatIds?: string[];
+}
+export interface ProvenanceRecord {
+    sources: Source[];
+    consentDecisions: ConsentDecision[];
+    authorityFlags: AuthorityFlag[];
+}
+export type SourceAuthority = "open" | "restricted" | "sacred" | "community-controlled";
+export interface Source {
+    id: string;
+    title: string;
+    authority: SourceAuthority;
+    citation?: string;
+    usedIn: string[];
+    attribution?: string;
+}
+export interface ConsentDecision {
+    id: string;
+    gate: string;
+    decision: string;
+    decidedBy: string;
+    confirmedByHuman: boolean;
+    at: string;
+    notes?: string;
+}
+export interface AuthorityFlag {
+    id: string;
+    flag: string;
+    raisedBy: string;
+    routedTo: string;
+    status: "open" | "resolved" | "pause";
+}
+export interface ContinuityState {
+    promises: StoryPromise[];
+    facts: StoryFact[];
+    contradictions: Contradiction[];
+    chapterVersions?: ChapterVersion[];
+}
+/**
+ * HAWK-style versioned audit trail for chapter state.
+ * Reference: Cheng et al. (2025), "Versioned State Update", §4.1.5.
+ */
+export interface ChapterVersion {
+    chapterId: string;
+    version: string;
+    at: string;
+    environmentDelta?: string;
+    characterMemoryDelta?: string;
+}
+export interface StoryPromise {
+    id: string;
+    text: string;
+    status: "open" | "fulfilled" | "broken";
+    beatId?: string;
+}
+export interface StoryFact {
+    id: string;
+    text: string;
+    source?: string;
+}
+export interface Contradiction {
+    id: string;
+    description: string;
+    resolved: boolean;
+    resolution?: string;
+}
+export interface NarrativeEvaluation {
+    id: string;
+    evaluatedAt: string;
+    evaluatedBy: string;
+    target: EvaluationTarget;
+    goal?: GoalEvaluation;
+    plan?: PlanEvaluation;
+    notes?: string;
+}
+export interface EvaluationTarget {
+    type: "beat" | "chapter" | "outline" | "draft" | "bible";
+    id: string;
+}
+/** HAWK Decision Agent predicates p1–p5. Each value ∈ [-1, 1]. */
+export interface GoalEvaluation {
+    coherence?: number;
+    progression?: number;
+    originality?: number;
+    tension?: number;
+    resonance?: number;
+}
+/** HAWK Decision Agent predicates p6–p10. Each value ∈ [-1, 1]. */
+export interface PlanEvaluation {
+    feasibility?: number;
+    consistency?: number;
+    interactivity?: number;
+    suspense?: number;
+    cohesion?: number;
+}
+export interface FollowUpCommission {
+    id: string;
+    description: string;
+    rationale?: string;
+    proposedBy?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,19 @@
+/**
+ * Episodic Memory — durable session-to-session memory.
+ *
+ * The cognitive-science analogue: Tulving (1972) distinguishes episodic memory
+ * (memory of experienced events) from semantic memory (facts) and procedural
+ * memory (skills). One Miadi session produces one episodic memory record,
+ * feedable back into world memory as lineage for the next session.
+ *
+ * The schema has five layers:
+ *   1. episode      — session metadata + charter
+ *   2. narrative    — NCP-aligned subtext + storytelling
+ *   3. world        — settings, themes, character advancement (this episode's delta)
+ *   4. provenance   — sources, consent decisions, authority flags (PROV-DM / OAIS-informed)
+ *   5. continuity   — open promises, canonical facts, contradictions
+ *
+ * Plus follow-up commissions — seeds for the next episode.
+ */
+export const SCHEMA_VERSION = "episodic-memory.v1.0";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG,sBAA+B,CAAA"}

package/examples/inwe-village.example.json

@@ -0,0 +1,135 @@
+{
+  "schemaVersion": "episodic-memory.v1.0",
+  "episode": {
+    "sessionId": "sw-2026-05-19-001",
+    "openedAt": "2026-05-19T13:00:00Z",
+    "closedAt": "2026-05-19T17:24:00Z",
+    "charter": {
+      "purpose": "story.bible.from.brief",
+      "protocols": ["wilson-3rs", "OCAP"],
+      "audience": "literary, adult",
+      "authority": "draft"
+    }
+  },
+  "narrative": {
+    "subtext": {
+      "perspectives": [
+        {
+          "id": "perspective_aen",
+          "throughline": "Main Character",
+          "summary": "Aen, who has forgotten how to walk softly.",
+          "storytelling": "A returning protagonist whose body remembers a violence the village has not forgiven."
+        }
+      ],
+      "players": [
+        { "id": "player_aen",   "name": "Aen",                "role": "Main Character",       "perspectiveId": "perspective_aen", "summary": "Must relearn soft-step before first frost." },
+        { "id": "player_beech", "name": "Grandmother Beech",  "role": "Influence Character",  "summary": "Carries the village's footstep-memory." }
+      ],
+      "storypoints": [
+        { "id": "sp_accountability", "appreciation": "Issue", "illustration": "The forest keeps score of every footstep." }
+      ],
+      "storybeats": [
+        {
+          "id": "beat_loses_way",
+          "perspectiveId": "perspective_aen",
+          "sequence": 1,
+          "narrativeFunction": "Catalyst",
+          "illustration": "Aen realizes the forest is keeping score and she no longer remembers how to walk softly.",
+          "stageId": "bible",
+          "tones": { "abstraction": "situation", "spatial": "resistance", "temporal": "expression" }
+        }
+      ],
+      "dynamics": [
+        { "id": "dyn_resolve", "name": "Main Character Resolve", "choice": "Changed" }
+      ]
+    },
+    "storytelling": {
+      "overviews": [
+        { "id": "ov_01", "summary": "A literary fable in present tense, intimate scale, early autumn." }
+      ],
+      "moments": [
+        {
+          "id": "moment_return",
+          "type": "Chapter",
+          "summary": "Aen returns to Inwe-village",
+          "synopsis": "The forest greets her with the memory of her last departure.",
+          "storybeats": [{ "order": 0, "storybeatId": "beat_loses_way" }]
+        }
+      ]
+    }
+  },
+  "world": {
+    "settings": [
+      { "name": "Inwe-village", "type": "invented", "locked": true, "notes": "Default-invented per protocol gate; real placement would require community consent." }
+    ],
+    "rulesIntroduced": [
+      "forest remembers footsteps",
+      "autumn is the season of accounting",
+      "silence is currency"
+    ],
+    "charactersAdvanced": [
+      { "name": "Aen",               "role": "Main Character",       "stake": "must relearn soft-step before first frost", "beatIds": ["beat_loses_way"] },
+      { "name": "Grandmother Beech", "role": "Influence Character",  "stake": "carries the village's footstep-memory" }
+    ],
+    "themes": ["accountability", "return", "the weight of presence"]
+  },
+  "provenance": {
+    "sources": [
+      { "id": "src-01", "title": "Trees-as-witnesses motif (literary)",  "authority": "open", "usedIn": ["bible"] },
+      { "id": "src-02", "title": "Soft-step traditions (cross-cultural)", "authority": "open", "usedIn": ["bible"] }
+    ],
+    "consentDecisions": [
+      {
+        "id": "c-01",
+        "gate": "research.authority",
+        "decision": "default-invented-setting",
+        "decidedBy": "protocol-steward",
+        "confirmedByHuman": true,
+        "at": "2026-05-19T13:42:00Z",
+        "notes": "Village named Inwe; not anchored to a real place."
+      }
+    ],
+    "authorityFlags": []
+  },
+  "continuity": {
+    "promises": [
+      { "id": "p1", "text": "Aen relearns soft-step by first frost",      "status": "open", "beatId": "beat_loses_way" },
+      { "id": "p2", "text": "Grandmother Beech speaks at least once",     "status": "open" }
+    ],
+    "facts": [
+      { "id": "f1", "text": "Season is early autumn" },
+      { "id": "f2", "text": "Village name is Inwe-village" }
+    ],
+    "contradictions": [],
+    "chapterVersions": [
+      { "chapterId": "moment_return", "version": "v1.0", "at": "2026-05-19T16:08:00Z",
+        "environmentDelta": "Inwe-village forest activated; autumn-accounting rule live.",
+        "characterMemoryDelta": "Aen recalls last departure; Beech's awareness of footsteps." }
+    ]
+  },
+  "evaluations": [
+    {
+      "id": "eval-bible-01",
+      "evaluatedAt": "2026-05-19T15:55:00Z",
+      "evaluatedBy": "developmental-editor",
+      "target": { "type": "bible", "id": "story.bible" },
+      "goal": { "coherence": 0.82, "progression": 0.61, "originality": 0.74, "tension": 0.88, "resonance": 0.79 },
+      "plan": { "feasibility": 0.71, "consistency": 0.85, "interactivity": 0.42, "suspense": 0.68, "cohesion": 0.77 },
+      "notes": "Foundation holds. Suspense and interactivity will rise as the outline lands."
+    }
+  ],
+  "followUpCommissions": [
+    {
+      "id": "fc-01",
+      "description": "Expand Aen's backstory into a prequel chapter.",
+      "rationale": "Backstory was implied in the bible but not developed; readers will ask.",
+      "proposedBy": "export-steward"
+    },
+    {
+      "id": "fc-02",
+      "description": "Map the seasonal accounting cycle as a world-building document.",
+      "rationale": "Rule introduced this episode is dense enough to warrant its own document.",
+      "proposedBy": "world-architect"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@miadi/episodic-memory-schema",
+  "version": "0.1.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",
+    "storyweaver",
+    "ncp",
+    "narrative-context-protocol",
+    "episodic-memory",
+    "schema",
+    "provenance",
+    "json-schema",
+    "tulving"
+  ],
+  "license": "MIT",
+  "author": "Miadi",
+  "homepage": "https://github.com/jgwill/Miadi/tree/main/packages/episodic-memory-schema",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jgwill/Miadi.git",
+    "directory": "packages/episodic-memory-schema"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schema": "./schema/episodic-memory.schema.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "schema",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/schema/episodic-memory.schema.json

@@ -0,0 +1,357 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://miadi.dev/schema/episodic-memory.v1.0.json",
+  "title": "Episodic Memory",
+  "description": "Durable session-to-session memory for the Miadi orchestration kit. Narrative layer is NCP-aligned; provenance layer is W3C PROV-DM and OAIS-informed.",
+  "type": "object",
+  "required": ["schemaVersion", "episode", "provenance", "continuity"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "const": "episodic-memory.v1.0",
+      "description": "Schema version identifier."
+    },
+    "episode":              { "$ref": "#/definitions/EpisodeMetadata" },
+    "narrative":            { "$ref": "#/definitions/NarrativeContribution" },
+    "world":                { "$ref": "#/definitions/WorldStateDelta" },
+    "provenance":           { "$ref": "#/definitions/ProvenanceRecord" },
+    "continuity":           { "$ref": "#/definitions/ContinuityState" },
+    "evaluations": {
+      "type": "array",
+      "description": "HAWK-derived narrative evaluations (Cheng et al. 2025).",
+      "items": { "$ref": "#/definitions/NarrativeEvaluation" }
+    },
+    "followUpCommissions": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/FollowUpCommission" }
+    }
+  },
+  "definitions": {
+    "EpisodeMetadata": {
+      "type": "object",
+      "required": ["sessionId", "openedAt", "charter"],
+      "properties": {
+        "sessionId":          { "type": "string" },
+        "openedAt":           { "type": "string", "format": "date-time" },
+        "closedAt":           { "type": "string", "format": "date-time" },
+        "charter":            { "$ref": "#/definitions/SessionCharter" },
+        "parentEpisodeId":    { "type": "string" },
+        "childCommissionIds": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "SessionCharter": {
+      "type": "object",
+      "required": ["purpose"],
+      "properties": {
+        "purpose":   { "type": "string" },
+        "protocols": { "type": "array", "items": { "type": "string" } },
+        "audience":  { "type": "string" },
+        "authority": { "type": "string", "enum": ["draft", "review", "final"] }
+      }
+    },
+    "NarrativeContribution": {
+      "type": "object",
+      "description": "NCP-aligned narrative layer.",
+      "properties": {
+        "subtext":      { "$ref": "#/definitions/Subtext" },
+        "storytelling": { "$ref": "#/definitions/Storytelling" }
+      }
+    },
+    "Subtext": {
+      "type": "object",
+      "description": "Authorial intent layer — NCP subtext.",
+      "properties": {
+        "perspectives": { "type": "array", "items": { "$ref": "#/definitions/Perspective" } },
+        "players":      { "type": "array", "items": { "$ref": "#/definitions/Player" } },
+        "storypoints":  { "type": "array", "items": { "$ref": "#/definitions/Storypoint" } },
+        "storybeats":   { "type": "array", "items": { "$ref": "#/definitions/Storybeat" } },
+        "dynamics":     { "type": "array", "items": { "$ref": "#/definitions/Dynamic" } }
+      }
+    },
+    "Storytelling": {
+      "type": "object",
+      "description": "Surface presentation layer — NCP storytelling.",
+      "properties": {
+        "overviews": { "type": "array", "items": { "$ref": "#/definitions/Overview" } },
+        "moments":   { "type": "array", "items": { "$ref": "#/definitions/Moment" } }
+      }
+    },
+    "Perspective": {
+      "type": "object",
+      "required": ["id", "throughline", "summary"],
+      "properties": {
+        "id":           { "type": "string" },
+        "throughline":  { "type": "string", "enum": ["Main Character", "Influence Character", "Objective Story", "Relationship"] },
+        "summary":      { "type": "string" },
+        "storytelling": { "type": "string" }
+      }
+    },
+    "Player": {
+      "type": "object",
+      "required": ["id", "name", "role"],
+      "properties": {
+        "id":            { "type": "string" },
+        "name":          { "type": "string" },
+        "role":          { "type": "string" },
+        "summary":       { "type": "string" },
+        "perspectiveId": { "type": "string" }
+      }
+    },
+    "Storypoint": {
+      "type": "object",
+      "required": ["id", "appreciation"],
+      "properties": {
+        "id":            { "type": "string" },
+        "perspectiveId": { "type": "string" },
+        "appreciation":  { "type": "string" },
+        "illustration":  { "type": "string" },
+        "storytelling":  { "type": "string" }
+      }
+    },
+    "Storybeat": {
+      "type": "object",
+      "required": ["id", "illustration"],
+      "properties": {
+        "id":                { "type": "string" },
+        "perspectiveId":     { "type": "string" },
+        "sequence":          { "type": "integer" },
+        "narrativeFunction": { "type": "string" },
+        "illustration":      { "type": "string" },
+        "summary":           { "type": "string" },
+        "storytelling":      { "type": "string" },
+        "timestamp":         { "type": "string", "format": "date-time" },
+        "stageId":           { "type": "string" },
+        "tones":             { "$ref": "#/definitions/BeatTones" }
+      }
+    },
+    "BeatTones": {
+      "type": "object",
+      "properties": {
+        "abstraction": { "type": "string" },
+        "spatial":     { "type": "string" },
+        "temporal":    { "type": "string" }
+      }
+    },
+    "Dynamic": {
+      "type": "object",
+      "required": ["id", "name", "choice"],
+      "properties": {
+        "id":     { "type": "string" },
+        "name":   { "type": "string" },
+        "choice": { "type": "string" }
+      }
+    },
+    "Overview": {
+      "type": "object",
+      "required": ["id", "summary"],
+      "properties": {
+        "id":           { "type": "string" },
+        "summary":      { "type": "string" },
+        "storytelling": { "type": "string" }
+      }
+    },
+    "Moment": {
+      "type": "object",
+      "required": ["id", "type", "summary"],
+      "properties": {
+        "id":       { "type": "string" },
+        "type":     { "type": "string" },
+        "summary":  { "type": "string" },
+        "synopsis": { "type": "string" },
+        "storybeats": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["order", "storybeatId"],
+            "properties": {
+              "order":       { "type": "integer" },
+              "storybeatId": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "WorldStateDelta": {
+      "type": "object",
+      "properties": {
+        "settings":            { "type": "array", "items": { "$ref": "#/definitions/WorldSetting" } },
+        "rulesIntroduced":     { "type": "array", "items": { "type": "string" } },
+        "charactersAdvanced":  { "type": "array", "items": { "$ref": "#/definitions/CharacterAdvancement" } },
+        "themes":              { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "WorldSetting": {
+      "type": "object",
+      "required": ["name", "type", "locked"],
+      "properties": {
+        "name":   { "type": "string" },
+        "type":   { "type": "string", "enum": ["real", "invented", "hybrid"] },
+        "locked": { "type": "boolean" },
+        "notes":  { "type": "string" }
+      }
+    },
+    "CharacterAdvancement": {
+      "type": "object",
+      "required": ["name", "role"],
+      "properties": {
+        "name":     { "type": "string" },
+        "role":     { "type": "string" },
+        "stake":    { "type": "string" },
+        "beatIds":  { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "ProvenanceRecord": {
+      "type": "object",
+      "required": ["sources", "consentDecisions", "authorityFlags"],
+      "properties": {
+        "sources":          { "type": "array", "items": { "$ref": "#/definitions/Source" } },
+        "consentDecisions": { "type": "array", "items": { "$ref": "#/definitions/ConsentDecision" } },
+        "authorityFlags":   { "type": "array", "items": { "$ref": "#/definitions/AuthorityFlag" } }
+      }
+    },
+    "Source": {
+      "type": "object",
+      "required": ["id", "title", "authority", "usedIn"],
+      "properties": {
+        "id":          { "type": "string" },
+        "title":       { "type": "string" },
+        "authority":   { "type": "string", "enum": ["open", "restricted", "sacred", "community-controlled"] },
+        "citation":    { "type": "string" },
+        "usedIn":      { "type": "array", "items": { "type": "string" } },
+        "attribution": { "type": "string" }
+      }
+    },
+    "ConsentDecision": {
+      "type": "object",
+      "required": ["id", "gate", "decision", "decidedBy", "confirmedByHuman", "at"],
+      "properties": {
+        "id":               { "type": "string" },
+        "gate":             { "type": "string" },
+        "decision":         { "type": "string" },
+        "decidedBy":        { "type": "string" },
+        "confirmedByHuman": { "type": "boolean" },
+        "at":               { "type": "string", "format": "date-time" },
+        "notes":            { "type": "string" }
+      }
+    },
+    "AuthorityFlag": {
+      "type": "object",
+      "required": ["id", "flag", "raisedBy", "routedTo", "status"],
+      "properties": {
+        "id":       { "type": "string" },
+        "flag":     { "type": "string" },
+        "raisedBy": { "type": "string" },
+        "routedTo": { "type": "string" },
+        "status":   { "type": "string", "enum": ["open", "resolved", "pause"] }
+      }
+    },
+    "ContinuityState": {
+      "type": "object",
+      "required": ["promises", "facts", "contradictions"],
+      "properties": {
+        "promises":         { "type": "array", "items": { "$ref": "#/definitions/StoryPromise" } },
+        "facts":            { "type": "array", "items": { "$ref": "#/definitions/StoryFact" } },
+        "contradictions":   { "type": "array", "items": { "$ref": "#/definitions/Contradiction" } },
+        "chapterVersions": {
+          "type": "array",
+          "description": "HAWK-style versioned audit trail per chapter (Cheng et al. 2025, §4.1.5).",
+          "items": { "$ref": "#/definitions/ChapterVersion" }
+        }
+      }
+    },
+    "ChapterVersion": {
+      "type": "object",
+      "required": ["chapterId", "version", "at"],
+      "properties": {
+        "chapterId":            { "type": "string" },
+        "version":              { "type": "string" },
+        "at":                   { "type": "string", "format": "date-time" },
+        "environmentDelta":     { "type": "string" },
+        "characterMemoryDelta": { "type": "string" }
+      }
+    },
+    "NarrativeEvaluation": {
+      "type": "object",
+      "description": "HAWK 10-predicate Decision Agent rubric (Cheng et al. 2025, Figure 3).",
+      "required": ["id", "evaluatedAt", "evaluatedBy", "target"],
+      "properties": {
+        "id":          { "type": "string" },
+        "evaluatedAt": { "type": "string", "format": "date-time" },
+        "evaluatedBy": { "type": "string" },
+        "target": {
+          "type": "object",
+          "required": ["type", "id"],
+          "properties": {
+            "type": { "type": "string", "enum": ["beat", "chapter", "outline", "draft", "bible"] },
+            "id":   { "type": "string" }
+          }
+        },
+        "goal": { "$ref": "#/definitions/GoalEvaluation" },
+        "plan": { "$ref": "#/definitions/PlanEvaluation" },
+        "notes": { "type": "string" }
+      }
+    },
+    "GoalEvaluation": {
+      "type": "object",
+      "description": "HAWK predicates p1–p5. Each value ∈ [-1, 1].",
+      "properties": {
+        "coherence":   { "type": "number", "minimum": -1, "maximum": 1 },
+        "progression": { "type": "number", "minimum": -1, "maximum": 1 },
+        "originality": { "type": "number", "minimum": -1, "maximum": 1 },
+        "tension":     { "type": "number", "minimum": -1, "maximum": 1 },
+        "resonance":   { "type": "number", "minimum": -1, "maximum": 1 }
+      }
+    },
+    "PlanEvaluation": {
+      "type": "object",
+      "description": "HAWK predicates p6–p10. Each value ∈ [-1, 1].",
+      "properties": {
+        "feasibility":   { "type": "number", "minimum": -1, "maximum": 1 },
+        "consistency":   { "type": "number", "minimum": -1, "maximum": 1 },
+        "interactivity": { "type": "number", "minimum": -1, "maximum": 1 },
+        "suspense":      { "type": "number", "minimum": -1, "maximum": 1 },
+        "cohesion":      { "type": "number", "minimum": -1, "maximum": 1 }
+      }
+    },
+    "StoryPromise": {
+      "type": "object",
+      "required": ["id", "text", "status"],
+      "properties": {
+        "id":     { "type": "string" },
+        "text":   { "type": "string" },
+        "status": { "type": "string", "enum": ["open", "fulfilled", "broken"] },
+        "beatId": { "type": "string" }
+      }
+    },
+    "StoryFact": {
+      "type": "object",
+      "required": ["id", "text"],
+      "properties": {
+        "id":     { "type": "string" },
+        "text":   { "type": "string" },
+        "source": { "type": "string" }
+      }
+    },
+    "Contradiction": {
+      "type": "object",
+      "required": ["id", "description", "resolved"],
+      "properties": {
+        "id":          { "type": "string" },
+        "description": { "type": "string" },
+        "resolved":    { "type": "boolean" },
+        "resolution":  { "type": "string" }
+      }
+    },
+    "FollowUpCommission": {
+      "type": "object",
+      "required": ["id", "description"],
+      "properties": {
+        "id":          { "type": "string" },
+        "description": { "type": "string" },
+        "rationale":   { "type": "string" },
+        "proposedBy":  { "type": "string" }
+      }
+    }
+  }
+}