@miadi/ncp-story-studio 0.1.0

package/dist/schema/generated.js

@@ -0,0 +1,497 @@
+// GENERATED FILE — do not edit by hand.
+// Regenerate with: npm run sync-schema (scripts/sync-canonical-schema.mjs)
+// Source: /workspace/repos/avadisabelle/holisticagnostic-narrative-context-protocol/schema/ncp-schema.json
+// sha256: c7a72b1588c988a063d6b92f9ee227f48885fcec666387e464843c434550d811
+export const CANONICAL_SCHEMA_PROVENANCE = {
+    source_path: "/workspace/repos/avadisabelle/holisticagnostic-narrative-context-protocol/schema/ncp-schema.json",
+    sha256: "c7a72b1588c988a063d6b92f9ee227f48885fcec666387e464843c434550d811",
+    synced_at: "2026-09-12",
+    schema_title: "Narrative Context Protcol Schema",
+    declared_schema_version: "1.0",
+};
+/** The canonical schema's own `required` lists, by element. */
+export const CANONICAL_REQUIRED = {
+    "story": [
+        "id",
+        "title",
+        "genre",
+        "logline",
+        "created_at",
+        "narratives"
+    ],
+    "narrative": [
+        "id",
+        "title",
+        "subtext",
+        "storytelling"
+    ],
+    "subtext": [
+        "perspectives",
+        "players",
+        "dynamics",
+        "storypoints",
+        "storybeats"
+    ],
+    "storytelling": [],
+    "perspective": [
+        "id",
+        "pov",
+        "summary",
+        "storytelling"
+    ],
+    "player": [
+        "id",
+        "name",
+        "role",
+        "visual",
+        "audio",
+        "summary",
+        "storytelling",
+        "perspectives"
+    ],
+    "dynamic": [
+        "id",
+        "dynamic",
+        "vector",
+        "summary",
+        "storytelling"
+    ],
+    "storypoint": [
+        "id",
+        "appreciation",
+        "narrative_function",
+        "illustration",
+        "summary",
+        "storytelling",
+        "perspectives"
+    ],
+    "storybeat": [
+        "id",
+        "appreciation",
+        "sequence",
+        "narrative_function",
+        "illustration",
+        "summary",
+        "storytelling",
+        "tones",
+        "perspectives"
+    ],
+    "moment": []
+};
+/** What the canonical schema says about `storybeat.sequence`. */
+export const SEQUENCE_CONSTRAINTS = {
+    "minimum": 1,
+    "type": "integer",
+    "ranges": {
+        "signpost": {
+            "minimum": 1,
+            "maximum": 4
+        },
+        "progression": {
+            "minimum": 1,
+            "maximum": 16
+        },
+        "event": {
+            "minimum": 1,
+            "maximum": 64
+        }
+    }
+};
+export const AUTHOR_STRUCTURAL_POV = [
+    "i",
+    "you",
+    "we",
+    "they",
+];
+export const DYNAMIC_KINDS = [
+    "main_character_resolve",
+    "influence_character_resolve",
+    "main_character_growth",
+    "main_character_approach",
+    "problem_solving_style",
+    "story_limit",
+    "story_driver",
+    "story_outcome",
+    "story_judgment",
+];
+export const DYNAMIC_VECTORS = [
+    "change",
+    "steadfast",
+    "stop",
+    "start",
+    "do_er",
+    "be_er",
+    "linear",
+    "holistic",
+    "optionlock",
+    "timelock",
+    "action",
+    "decision",
+    "success",
+    "failure",
+    "good",
+    "bad",
+];
+export const STORYPOINT_APPRECIATIONS = [
+    "domain",
+    "concern",
+    "issue",
+    "problem",
+    "solution",
+    "symptom",
+    "response",
+    "catalyst",
+    "inhibitor",
+    "unique_ability",
+    "critical_flaw",
+    "benchmark",
+    "story_goal",
+    "story_requirements",
+    "story_prerequisites",
+    "story_preconditions",
+    "story_costs",
+    "story_dividends",
+    "story_forewarnings",
+    "story_consequence",
+    "pivotal_element",
+    "initial_story_driver",
+    "second_story_driver",
+    "midpoint_story_driver",
+    "fourth_story_driver",
+    "concluding_story_driver",
+    "signpost",
+    "progression",
+    "event",
+];
+export const STORYPOINT_NARRATIVE_FUNCTIONS = [
+    "universe",
+    "physics",
+    "psychology",
+    "mind",
+    "past",
+    "understanding",
+    "conceptualizing",
+    "memory",
+    "progress",
+    "doing",
+    "being",
+    "preconscious",
+    "future",
+    "obtaining",
+    "becoming",
+    "subconscious",
+    "present",
+    "learning",
+    "conceiving",
+    "conscious",
+    "fate",
+    "prediction",
+    "interdiction",
+    "destiny",
+    "instinct",
+    "senses",
+    "interpretation",
+    "conditioning",
+    "fact",
+    "security",
+    "threat",
+    "fantasy",
+    "wisdom",
+    "skill",
+    "experience",
+    "enlightenment",
+    "openness",
+    "delay",
+    "choice",
+    "preconception",
+    "approach",
+    "self_interest",
+    "altruism",
+    "attitude",
+    "work",
+    "attraction",
+    "repulsion",
+    "attempt",
+    "qualification",
+    "strategy",
+    "analysis",
+    "stipulation",
+    "truth",
+    "evidence",
+    "suspicion",
+    "falsehood",
+    "state_of_being",
+    "situation",
+    "circumstances",
+    "sense_of_self",
+    "value",
+    "confidence",
+    "worry",
+    "worth",
+    "knowing",
+    "able",
+    "driven",
+    "thinking",
+    "closure",
+    "hope",
+    "dream",
+    "denial",
+    "rationalization",
+    "commitment",
+    "responsibility",
+    "obligation",
+    "investigation",
+    "appraisal",
+    "reappraisal",
+    "doubt",
+    "permission",
+    "need",
+    "expediency",
+    "deficiency",
+    "ability",
+    "acceptance",
+    "accurate",
+    "actuality",
+    "avoid",
+    "aware",
+    "cause",
+    "certainty",
+    "change",
+    "chaos",
+    "conscience",
+    "consider",
+    "control",
+    "deduction",
+    "desire",
+    "determination",
+    "disbelief",
+    "effect",
+    "ending",
+    "equity",
+    "evaluation",
+    "expectation",
+    "faith",
+    "feeling",
+    "help",
+    "hinder",
+    "hunch",
+    "inaction",
+    "induction",
+    "inequity",
+    "inertia",
+    "knowledge",
+    "logic",
+    "rejection",
+    "deviation",
+    "oppose",
+    "order",
+    "perception",
+    "possibility",
+    "potentiality",
+    "proaction",
+    "probability",
+    "process",
+    "production",
+    "projection",
+    "protection",
+    "proven",
+    "pursuit",
+    "re_evaluation",
+    "reaction",
+    "reconsider",
+    "reduction",
+    "result",
+    "self_aware",
+    "speculation",
+    "support",
+    "temptation",
+    "test",
+    "theory",
+    "thought",
+    "trust",
+    "uncontrolled",
+    "continuing",
+    "presumption",
+];
+export const STORYBEAT_APPRECIATIONS = [
+    "signpost",
+    "progression",
+    "event",
+];
+export const STORYBEAT_NARRATIVE_FUNCTIONS = [
+    "past",
+    "understanding",
+    "conceptualizing",
+    "memory",
+    "progress",
+    "doing",
+    "being",
+    "preconscious",
+    "future",
+    "obtaining",
+    "becoming",
+    "subconscious",
+    "present",
+    "learning",
+    "conceiving",
+    "conscious",
+    "fate",
+    "prediction",
+    "interdiction",
+    "destiny",
+    "instinct",
+    "senses",
+    "interpretation",
+    "conditioning",
+    "fact",
+    "security",
+    "threat",
+    "fantasy",
+    "wisdom",
+    "skill",
+    "experience",
+    "enlightenment",
+    "openness",
+    "delay",
+    "choice",
+    "preconception",
+    "approach",
+    "self_interest",
+    "altruism",
+    "attitude",
+    "work",
+    "attraction",
+    "repulsion",
+    "attempt",
+    "qualification",
+    "strategy",
+    "analysis",
+    "stipulation",
+    "truth",
+    "evidence",
+    "suspicion",
+    "falsehood",
+    "state_of_being",
+    "situation",
+    "circumstances",
+    "sense_of_self",
+    "value",
+    "confidence",
+    "worry",
+    "worth",
+    "knowing",
+    "able",
+    "driven",
+    "thinking",
+    "closure",
+    "hope",
+    "dream",
+    "denial",
+    "rationalization",
+    "commitment",
+    "responsibility",
+    "obligation",
+    "investigation",
+    "appraisal",
+    "reappraisal",
+    "doubt",
+    "permission",
+    "need",
+    "expediency",
+    "deficiency",
+    "ability",
+    "acceptance",
+    "accurate",
+    "actuality",
+    "avoid",
+    "aware",
+    "cause",
+    "certainty",
+    "change",
+    "chaos",
+    "conscience",
+    "consider",
+    "control",
+    "deduction",
+    "desire",
+    "determination",
+    "disbelief",
+    "effect",
+    "ending",
+    "equity",
+    "evaluation",
+    "expectation",
+    "faith",
+    "feeling",
+    "help",
+    "hinder",
+    "hunch",
+    "inaction",
+    "induction",
+    "inequity",
+    "inertia",
+    "knowledge",
+    "logic",
+    "rejection",
+    "deviation",
+    "oppose",
+    "order",
+    "perception",
+    "possibility",
+    "potentiality",
+    "proaction",
+    "probability",
+    "process",
+    "production",
+    "projection",
+    "protection",
+    "proven",
+    "pursuit",
+    "re_evaluation",
+    "reaction",
+    "reconsider",
+    "reduction",
+    "result",
+    "self_aware",
+    "speculation",
+    "support",
+    "temptation",
+    "test",
+    "theory",
+    "thought",
+    "trust",
+    "abandon",
+    "continuing",
+    "presumption",
+];
+export const TONE_ABSTRACTION = [
+    "situation",
+    "action",
+    "justification",
+    "opinion",
+];
+export const TONE_SPATIAL = [
+    "potential",
+    "resistance",
+    "current",
+    "power",
+];
+export const TONE_TEMPORAL = [
+    "expression",
+    "experimentation",
+    "integration",
+    "transcendence",
+];
+export const AUDIENCE_EXPERIENTIAL_POV = [
+    "first_person_central",
+    "first_person_peripheral",
+    "second_person",
+    "third_person_limited",
+    "third_person_objective",
+    "third_person_omniscient",
+];
+export const MOMENT_FABRIC_TYPES = [
+    "space",
+    "time",
+];
+//# sourceMappingURL=generated.js.map

package/dist/schema/generated.js.map

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

package/dist/schema/index.d.ts

@@ -0,0 +1,48 @@
+export * from './generated.js';
+export * from './types.js';
+export * from './extensions.js';
+export * from './validate.js';
+export * from './normalize.js';
+export * from './constants.js';
+export * from './terms.js';
+export * from './read.js';
+import type { Narrative, NcpDocument, Story, StorySummary, Storybeat } from './types.js';
+/** Wrap a story as a document at the version this package writes. */
+export declare function toNcpDocument(story: Story, schemaVersion?: string): NcpDocument;
+/** The narrative a view should open by default. */
+export declare function primaryNarrative(story: Story): Narrative | undefined;
+/** Beats in reading order. Never mutates the input. */
+export declare function orderedBeats(narrative: Narrative): Storybeat[];
+/** Find a beat by id across every narrative of a story. */
+export declare function findBeat(story: Story, beatId: string): {
+    narrative: Narrative;
+    beat: Storybeat;
+} | undefined;
+/** Metadata for a project list, without shipping the whole document. */
+export declare function summarizeStory(story: Story, lastModified?: string): StorySummary;
+/** How much of the structure a story has filled in, per element, 0..1. */
+export interface StoryCompleteness {
+    perspectives: number;
+    players: number;
+    dynamics: number;
+    storypoints: number;
+    storybeats: number;
+    toned_beats: number;
+    moments: number;
+    /** Mean of the element scores, 0..1. */
+    overall: number;
+}
+/**
+ * Completeness is measured against a documented target for each element, so the
+ * number means something a reader can check rather than an opaque score.
+ */
+export declare const COMPLETENESS_TARGETS: {
+    readonly perspectives: 4;
+    readonly players: 2;
+    readonly dynamics: 4;
+    readonly storypoints: 4;
+    readonly storybeats: 4;
+    readonly moments: 1;
+};
+export declare function storyCompleteness(story: Story): StoryCompleteness;
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAEA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAExF,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,GAAE,MAA2B,GAAG,WAAW,CAEnG;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,CAEpE;AAED,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,CAE9D;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,SAAS,CAM5G;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CAYhF;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;CAOvB,CAAA;AAEV,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,iBAAiB,CAgCjE"}

package/dist/schema/index.js

@@ -0,0 +1,92 @@
+// `@miadi/ncp-story-studio/schema` — the vocabulary every other module and
+// every consumer produces data against.
+export * from './generated.js';
+export * from './types.js';
+export * from './extensions.js';
+export * from './validate.js';
+export * from './normalize.js';
+export * from './constants.js';
+export * from './terms.js';
+export * from './read.js';
+import { NCP_SCHEMA_VERSION } from './constants.js';
+/** Wrap a story as a document at the version this package writes. */
+export function toNcpDocument(story, schemaVersion = NCP_SCHEMA_VERSION) {
+    return { schema_version: schemaVersion, story };
+}
+/** The narrative a view should open by default. */
+export function primaryNarrative(story) {
+    return story.narratives[0];
+}
+/** Beats in reading order. Never mutates the input. */
+export function orderedBeats(narrative) {
+    return [...narrative.subtext.storybeats].sort((a, b) => a.sequence - b.sequence);
+}
+/** Find a beat by id across every narrative of a story. */
+export function findBeat(story, beatId) {
+    for (const narrative of story.narratives) {
+        const beat = narrative.subtext.storybeats.find((candidate) => candidate.id === beatId);
+        if (beat)
+            return { narrative, beat };
+    }
+    return undefined;
+}
+/** Metadata for a project list, without shipping the whole document. */
+export function summarizeStory(story, lastModified) {
+    const beatCount = story.narratives.reduce((total, narrative) => total + narrative.subtext.storybeats.length, 0);
+    return {
+        id: story.id,
+        title: story.title,
+        genre: story.genre,
+        logline: story.logline,
+        created_at: story.created_at,
+        last_modified: lastModified,
+        narrative_count: story.narratives.length,
+        beat_count: beatCount,
+    };
+}
+/**
+ * Completeness is measured against a documented target for each element, so the
+ * number means something a reader can check rather than an opaque score.
+ */
+export const COMPLETENESS_TARGETS = {
+    perspectives: 4,
+    players: 2,
+    dynamics: 4,
+    storypoints: 4,
+    storybeats: 4,
+    moments: 1,
+};
+export function storyCompleteness(story) {
+    const counts = {
+        perspectives: 0,
+        players: 0,
+        dynamics: 0,
+        storypoints: 0,
+        storybeats: 0,
+        toned: 0,
+        moments: 0,
+    };
+    for (const narrative of story.narratives) {
+        counts.perspectives += narrative.subtext.perspectives.length;
+        counts.players += narrative.subtext.players.length;
+        counts.dynamics += narrative.subtext.dynamics.length;
+        counts.storypoints += narrative.subtext.storypoints.length;
+        counts.storybeats += narrative.subtext.storybeats.length;
+        counts.toned += narrative.subtext.storybeats.filter((beat) => beat.tones !== undefined).length;
+        counts.moments += narrative.storytelling.moments.length;
+    }
+    const ratio = (value, target) => Math.min(1, target === 0 ? 0 : value / target);
+    const scores = {
+        perspectives: ratio(counts.perspectives, COMPLETENESS_TARGETS.perspectives),
+        players: ratio(counts.players, COMPLETENESS_TARGETS.players),
+        dynamics: ratio(counts.dynamics, COMPLETENESS_TARGETS.dynamics),
+        storypoints: ratio(counts.storypoints, COMPLETENESS_TARGETS.storypoints),
+        storybeats: ratio(counts.storybeats, COMPLETENESS_TARGETS.storybeats),
+        toned_beats: counts.storybeats === 0 ? 0 : counts.toned / counts.storybeats,
+        moments: ratio(counts.moments, COMPLETENESS_TARGETS.moments),
+    };
+    const values = Object.values(scores);
+    const overall = values.reduce((total, value) => total + value, 0) / values.length;
+    return { ...scores, overall };
+}
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

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

package/dist/schema/normalize.d.ts

@@ -0,0 +1,20 @@
+import type { NcpDocument } from './types.js';
+export interface NormalizeNote {
+    path: string;
+    action: string;
+}
+export interface NormalizeResult {
+    document: NcpDocument;
+    notes: NormalizeNote[];
+}
+/**
+ * Accepts:
+ * - `{ schema_version, story }` — canonical, passed through
+ * - `{ story, narratives }` — the layout `anora.json` and `the-shawshank-redemption.json` use
+ * - `{ story }` without a schema version
+ * - a bare story object
+ */
+export declare function normalizeNcpInput(input: unknown, options?: {
+    schemaVersion?: string;
+}): NormalizeResult;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/schema/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/schema/normalize.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAa,WAAW,EAAS,MAAM,YAAY,CAAA;AAE/D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,CAAA;IACrB,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAUD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAsCvG"}