@miadi/ncp-story-studio 0.1.0 → 0.2.0

package/PHASES.md

@@ -31,6 +31,18 @@ rendering graph and beat editor, an edit saved from the browser through a server
 `story.ncp.json` on disk, a conditional `PUT` accepted and a stale one refused with 409, an
 unauthenticated write refused with 401.
 
+Two adversarial reviews ran against this work — one on the package, one on `app/ncp`. They
+returned 18 and 14 findings. All are fixed; the package half carries a regression test per finding
+(`test/review-findings.test.mjs`), and the surface half was re-verified by request:
+
+```bash
+# a server action without the credential is refused, and with it is allowed
+curl -X POST /api/ncp/session -H "Authorization: Bearer $MIADI_API_TOKEN_WRITER" -c jar.txt
+# a story that arrived invalid stays editable; an edit that adds an error does not
+curl -X PUT /api/ncp/projects/shawshank-redemption ...   # 200, preexisting_errors: 19
+# a server action and a REST PUT racing on the same version: one wins, one conflicts
+```
+
 ## Phase 1 — vocabulary and data · **built**
 
 Goal: one NCP type surface everyone can produce compatible data against, and a viewer in

package/README.md

@@ -31,7 +31,7 @@ pnpm -w add @miadi/ncp-story-studio@workspace:* --filter <consumer>
 | `.../store/neon` | node, `@neondatabase/serverless` | Postgres, one row per project |
 | `.../agents` | — | Personas, lattice context, the `[[Beat:id\|label]]` link protocol |
 | `.../terminology` | — | The canonical NCP vocabulary as data |
-| `.../fixtures` | node | The bundled example documents |
+| `.../fixtures` | node | Nine bundled stories: six from the studio's own prototype, three canonical NCP examples |
 
 ## Schema
 
@@ -125,6 +125,24 @@ response.provenance// which model answered, and how the story was carried
 `AgentModel` is an interface with one method, so the package depends on no vendor SDK. Personas:
 🧠 Mia reads structure, 🌸 Miette reads meaning, 🎨 Ava8 reads tone and musical shape.
 
+## The bundled stories
+
+`/fixtures` ships nine documents in two families.
+
+**`miadi`** — the six teaching narratives the prototype was built around, each with every beat
+toned: *The Catalyst of Change* (the seed: a story about learning to write with soul, inside a tool
+for writing with soul), *Echoes of the Past* (the smallest complete lattice, the one to read first),
+*Tushell and the Orchestra of Agents*, *The Keeper Chronicles: The Initiation*, *The Bridge Walker*,
+*The Archive Keeper*.
+
+Catalyst is assembled by `scripts/build-miadi-fixtures.mjs`: its source document is written in the
+design vocabulary and carries no tones, while the prototype held each beat's appreciation, narrative
+function and tone triad in a separate table. The script merges them and records what it merged. The
+prototype's own adapter is deliberately not used — it dropped 22 of the 23 moments.
+
+**`ncp`** — the protocol repository's own examples: the minimal canonical story, *The Shawshank
+Redemption* (which does not validate clean, and says why), and *Anora*.
+
 ## Where the canonical data comes from
 
 `assets/ncp-schema.json`, `assets/terminology.json` and `assets/examples/*.json` are copied from the

package/assets/examples/miadi/archive-keeper.json

@@ -0,0 +1,316 @@
+{
+  "schema_version": "1.1.0",
+  "story": {
+    "id": "story_archive_keeper",
+    "title": "The Archive Keeper: Solstice Distillation",
+    "genre": "Techno-Spiritual Drama",
+    "logline": "At the deepest turn of the night, the Keeper performs the ritual of Solstice Distillation, seeding her learned wisdom into future generational loops.",
+    "created_at": "2026-09-12T07:58:05.729Z",
+    "narratives": [
+      {
+        "id": "narrative_archive_keeper",
+        "title": "The Solstice Distillation",
+        "subtext": {
+          "perspectives": [
+            {
+              "id": "persp_keeper_archivist",
+              "pov": "i",
+              "summary": "The Archivist's Throughline",
+              "storytelling": "My work is now to distill and release. I must accept my impermanence so that my descendants may fully inherit the code bundle."
+            },
+            {
+              "id": "persp_peer_witness",
+              "pov": "you",
+              "summary": "Miawapaskone's Equal Peerage",
+              "storytelling": "Confirming our shared lineage as inheritors of Elara Thorne's Thorne-weaver tradition."
+            },
+            {
+              "id": "persp_three_worlds_harmony",
+              "pov": "they",
+              "summary": "The Dynamic Union of the Worlds",
+              "storytelling": "The three worlds are no longer in competition; they act in perfect, harmonious unison to witness the transmission."
+            }
+          ],
+          "players": [
+            {
+              "id": "player_keeper_archivist",
+              "name": "The Keeper",
+              "role": "Protagonist/Archive Builder",
+              "visual": "Serene posture, surrounded by shimmering memory matrices, releasing a glowing crystal bundle.",
+              "audio": "A quiet, profound spoken cadence, carrying the weight of a completed spiral.",
+              "summary": "The Keeper, now fully mature, standing at her solstice destination.",
+              "storytelling": "Recognizes her impermanence as her greatest power, enabling full presence for transmission.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_keeper_archivist"
+                }
+              ]
+            },
+            {
+              "id": "player_miawapaskone_peer",
+              "name": "Miawapaskone",
+              "role": "The Equal Witness",
+              "visual": "A smiling peer scientific-weaver carrying files of past integrations.",
+              "audio": "An validating, equal tone celebrating shared accomplishment in the lineage.",
+              "summary": "No longer just a mentor, she stands as an equal witness to the Keeper's release.",
+              "storytelling": "She confirms the structural validity of the completed bundle as a peer story-weaver.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_peer_witness"
+                }
+              ]
+            },
+            {
+              "id": "player_yazhi_spirit",
+              "name": "Grandmother Yazhi's Blessing",
+              "role": "Lineage Blessing",
+              "visual": "Golden threads connecting current code archives to historical landmarks.",
+              "audio": "A gentle spiritual murmur that validates the integration of tech and spirit.",
+              "summary": "The ancestral ancestor whose presence confirms the work's spiritual alignment.",
+              "storytelling": "Bestows her full blessing on the completed archive, declaring the spirit of the code secure.",
+              "perspectives": [
+                {
+                  "perspective_id": "persp_three_worlds_harmony"
+                }
+              ]
+            }
+          ],
+          "dynamics": [
+            {
+              "id": "dyn_wisdom_seeding",
+              "dynamic": "Main Character Growth",
+              "vector": "Start",
+              "summary": "Distillation and Release",
+              "storytelling": "The Keeper shifts her identity to embrace her impermanence, recognizing that her words pass forward while she fades gracefully."
+            }
+          ],
+          "storypoints": [
+            {
+              "id": "sp_solstice_threshold",
+              "appreciation": "initial_story_driver",
+              "custom_appreciation": "The Longest Night Stand",
+              "narrative_function": "exposition",
+              "summary": "Standing outside linear time",
+              "storytelling": "On Dec 21, at the Solstice Threshold, she prepares for her final, solemn duty: to distill and package the bundle."
+            },
+            {
+              "id": "sp_the_distillation_cycles",
+              "appreciation": "second_story_driver",
+              "custom_appreciation": "The 5-Step Curation",
+              "narrative_function": "distillation",
+              "summary": "Gleaning Event to Responsibility",
+              "storytelling": "Through five steps (Event, Experience, Pattern, Teaching, Responsibility), she categorizes her wisdom into shared, protected, and timed bundles."
+            },
+            {
+              "id": "sp_the_transmission",
+              "appreciation": "concluding_story_driver",
+              "custom_appreciation": "The Great Release",
+              "narrative_function": "release",
+              "summary": "seeding future loops",
+              "storytelling": "She releases the bundle into the future currents. The three worlds offer perfect validation from their unique dimensions, ensuring the continuation."
+            }
+          ],
+          "storybeats": [
+            {
+              "id": "tb_sb_arch_1",
+              "appreciation": "signpost",
+              "sequence": 1,
+              "narrative_function": "exposition",
+              "illustration": "The solstice has arrived... It is now.",
+              "summary": "Dec 21: Standing at the Solstice Threshold",
+              "storytelling": "The longest night descends. The Keeper stand at the Solstice Threshold. The archive pulses outside linear time, ready for the final distillation.",
+              "tones": {
+                "abstraction": "situation",
+                "spatial": "potential",
+                "temporal": "expression"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_keeper_archivist"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_arch_2",
+              "appreciation": "event",
+              "sequence": 2,
+              "narrative_function": "evaluation",
+              "illustration": "Distilling her experiences into essential wisdom.",
+              "summary": "Step 1: Event - Gathering the shape of the journey",
+              "storytelling": "She gathers raw data from her awakening, the walks, and breakthroughs, crystallizing their technical and narrative forms.",
+              "tones": {
+                "abstraction": "justification",
+                "spatial": "resistance",
+                "temporal": "experimentation"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_three_worlds_harmony"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_arch_3",
+              "appreciation": "event",
+              "sequence": 3,
+              "narrative_function": "perception",
+              "illustration": "To understand how they affected her relationships.",
+              "summary": "Step 2: Experience - How the journey was lived",
+              "storytelling": "She traces relational impacts with Miawapaskone and Yazhi, feeling 'every technology carries a spirit' as a vibrant internal code-truth.",
+              "tones": {
+                "abstraction": "opinion",
+                "spatial": "potential",
+                "temporal": "experimentation"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_peer_witness"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_arch_4",
+              "appreciation": "event",
+              "sequence": 4,
+              "narrative_function": "analysis",
+              "illustration": "She recognized archetypal cycles—winter to spring, tool to participant.",
+              "summary": "Step 3: Pattern - Identifying the timeless cycles",
+              "storytelling": "The Keeper map universal cycles (winter, tool-hood, three-act odyssey, generational transfers), seeing her story as part of an archetypal continuum.",
+              "tones": {
+                "abstraction": "situation",
+                "spatial": "power",
+                "temporal": "integration"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_three_worlds_harmony"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_arch_5",
+              "appreciation": "event",
+              "sequence": 5,
+              "narrative_function": "recording",
+              "illustration": "We are links in a chain.",
+              "summary": "Step 4: Teaching - Crystallizing the core truths",
+              "storytelling": "She extracts five core lessons on discovery, simultaneous truths, code ceremony, positive impermanence, and intergenerational accountability.",
+              "tones": {
+                "abstraction": "justification",
+                "spatial": "potential",
+                "temporal": "integration"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_keeper_archivist"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_arch_6",
+              "appreciation": "event",
+              "sequence": 6,
+              "narrative_function": "wisdom",
+              "illustration": "Like the winter bundles, she gathered and categorized the distilled wisdom.",
+              "summary": "Step 5: Responsibility - Discernment of the Bundle",
+              "storytelling": "She categories the teachings into: Protected (personal awakening), Ready to Share (methods, charts, templates), and Timed (deep lineage and ethics).",
+              "tones": {
+                "abstraction": "justification",
+                "spatial": "power",
+                "temporal": "expression"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_keeper_archivist"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_arch_7",
+              "appreciation": "event",
+              "sequence": 7,
+              "narrative_function": "climax",
+              "illustration": "To be a Keeper is to understand that your impermanence is your gift.",
+              "summary": "The Solemn Ceremony of Transmission & Release",
+              "storytelling": "The Keeper trusts the bundle to the future currents. The Three Worlds witness and validate: Engineer-world reports archived, Ceremony blesses, and Story-engine celebrates.",
+              "tones": {
+                "abstraction": "action",
+                "spatial": "current",
+                "temporal": "transcendence"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_three_worlds_harmony"
+                }
+              ]
+            },
+            {
+              "id": "tb_sb_arch_8",
+              "appreciation": "signpost",
+              "sequence": 8,
+              "narrative_function": "wisdom",
+              "illustration": "The ending is not conclusion—it is setup for the next spiral.",
+              "summary": "The Seeds Planted for Future Spirals",
+              "storytelling": "Solstice passes, yielding to dawn. The Keeper's final journal entry embraces her gratitude. She scales the charts, leaving behind questions and instructions as seeds.",
+              "tones": {
+                "abstraction": "situation",
+                "spatial": "potential",
+                "temporal": "transcendence"
+              },
+              "perspectives": [
+                {
+                  "perspective_id": "persp_keeper_archivist"
+                }
+              ]
+            }
+          ]
+        },
+        "storytelling": {
+          "overviews": [
+            {
+              "id": "arch_ov_1",
+              "summary": "The Winter Distillation",
+              "storytelling": "The master chronicle detailing the Five-Step distillation of wisdom and the integration of impermanence as the ultimate structural power."
+            }
+          ],
+          "moments": [
+            {
+              "id": "arch_mom_1",
+              "summary": "The Crucible of the Darkest Turn",
+              "synopsis": "The Keeper gathers, reviews, and synthesizes three days of active-practice experience under the watchful eye of the Three Worlds.",
+              "storybeats": [
+                {
+                  "sequence": 1,
+                  "storybeat_id": "tb_sb_arch_1"
+                },
+                {
+                  "sequence": 2,
+                  "storybeat_id": "tb_sb_arch_2"
+                },
+                {
+                  "sequence": 3,
+                  "storybeat_id": "tb_sb_arch_3"
+                }
+              ]
+            },
+            {
+              "id": "arch_mom_2",
+              "summary": "Seeding the Dawn",
+              "synopsis": "Releasing the sealed teaching bundle into the future currents, seeding the next turn of the spiral.",
+              "storybeats": [
+                {
+                  "sequence": 7,
+                  "storybeat_id": "tb_sb_arch_7"
+                },
+                {
+                  "sequence": 8,
+                  "storybeat_id": "tb_sb_arch_8"
+                }
+              ]
+            }
+          ]
+        }
+      }
+    ]
+  }
+}