@medicine-wheel/narrative-cluster 0.4.9

package/README.md

@@ -0,0 +1,75 @@
+# @medicine-wheel/narrative-cluster
+
+Turn witnessed production events into cinematic clusters, narrative beats, and a Film Edit Brief.
+
+This package receives the output of `@medicine-wheel/perception-layer` and gives it an edit-facing structure: grouped rushes, Medicine Wheel-aligned beats, EDL-style markers, and narrative annotations. It is intentionally deterministic so a real transcript can become a testable vertical slice.
+
+## Why it exists
+
+Episode 066 named a film-production path where agents help transform raw material into story without erasing relationship. Episode 067 sharpened the distinction between the Jerry thread of runtime observability and the Nicolas Renaud thread of Research is Ceremony. This package sits between perception and editing: it clusters witnessed events while preserving relational moments as first-class material.
+
+## Install
+
+```bash
+npm install @medicine-wheel/narrative-cluster
+```
+
+## API
+
+```ts
+import {
+  clusterEvents,
+  clustersToBeats,
+  generateEditBrief,
+} from '@medicine-wheel/narrative-cluster';
+
+const clusters = clusterEvents(
+  events.map((event) => ({
+    type: event.type,
+    text: event.text,
+    index: event.index,
+    source: event.source,
+  })),
+);
+
+const beats = clustersToBeats(clusters);
+const brief = generateEditBrief(clusters, {
+  title: 'Episode 066 rushes',
+});
+```
+
+## Main concepts
+
+- `NarrativeCluster`: a group of related events with a kind, theme, direction, and source events.
+- `NarrativeBeat`: a Medicine Wheel-aligned beat for downstream narrative engines.
+- `EditBrief`: ordered markers plus a CMX3600-style EDL text block.
+- `EditMarker`: deterministic timecode and annotation for an editable unit.
+
+## Cluster kinds
+
+- `shot-sequence` → usually East / vision
+- `sound-environment` → usually South / growth
+- `relational-moment` → usually West / reflection
+
+## Verification
+
+The real vertical slice is covered by:
+
+```bash
+cd /workspace/repos/jgwill/medicine-wheel
+npm run build:packages
+npm test -- --run tests/film-production-vertical-slice.test.ts
+```
+
+That test uses the real Episode 066 transcript and proves:
+
+1. perceptual events → narrative clusters,
+2. clusters → Medicine Wheel-aligned beats,
+3. clusters → Film Edit Brief / EDL markers,
+4. storyteller and ceremony gates can complete the production loop.
+
+## Related issues
+
+- #85 — Episode 068 vertical slice
+- #87 — narrative cluster, storyteller gate, and production ceremony gates
+- #84 — Episode 068 plan-review audio steering context

package/dist/clusters.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @medicine-wheel/narrative-cluster — Clusters
+ *
+ * The Narrative Cluster Processor as a reusable method: group witnessed events
+ * into cinematic clusters and turn them into direction-aligned NarrativeBeats.
+ * Input is the minimal `ClusterableEvent` shape, so any source (transcript,
+ * rushes, notes) flows through without a hard dependency on perception-layer.
+ */
+import type { NarrativeBeat, DirectionName } from '@medicine-wheel/ontology-core';
+export type ClusterKind = 'shot-sequence' | 'sound-environment' | 'relational-moment';
+/** The minimal input shape — decoupled from any specific producer. */
+export interface ClusterableEvent {
+    /** Event type label (e.g. a PerceptualEventType string). */
+    type: string;
+    text: string;
+    index: number;
+    source?: string;
+}
+export interface NarrativeCluster {
+    id: string;
+    kind: ClusterKind;
+    theme: string;
+    direction: DirectionName;
+    events: ClusterableEvent[];
+}
+/** Group events into cinematic clusters, preserving stream order within each. */
+export declare function clusterEvents(events: ClusterableEvent[]): NarrativeCluster[];
+/** One direction-aligned NarrativeBeat per cluster. */
+export declare function clustersToBeats(clusters: NarrativeCluster[]): NarrativeBeat[];
+//# sourceMappingURL=clusters.d.ts.map

package/dist/clusters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusters.d.ts","sourceRoot":"","sources":["../src/clusters.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAElF,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAEtF,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AA+BD,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAsB5E;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,aAAa,EAAE,CAiB7E"}

package/dist/clusters.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clusterEvents = clusterEvents;
+exports.clustersToBeats = clustersToBeats;
+const KIND_FOR_EVENT = {
+    'shot-composition': 'shot-sequence',
+    'ambient-sound': 'sound-environment',
+    'relational-moment': 'relational-moment',
+    'director-intent': 'relational-moment',
+    'transcript-segment': 'relational-moment',
+};
+const DIRECTION_FOR_KIND = {
+    'shot-sequence': 'east', // vision — what is seen
+    'sound-environment': 'south', // embodied — what is heard
+    'relational-moment': 'west', // reflection — relationship
+};
+const THEME_FOR_KIND = {
+    'shot-sequence': 'Visual composition — what the eye witnesses',
+    'sound-environment': 'Sound environment — what the ear witnesses',
+    'relational-moment': 'Relational moments — knowledge from relationship',
+};
+const CLUSTER_ORDER = ['shot-sequence', 'sound-environment', 'relational-moment'];
+const ACT_FOR_DIRECTION = {
+    east: 1,
+    south: 2,
+    west: 3,
+    north: 4,
+};
+/** Group events into cinematic clusters, preserving stream order within each. */
+function clusterEvents(events) {
+    const buckets = new Map();
+    for (const ev of events) {
+        const kind = KIND_FOR_EVENT[ev.type] ?? 'relational-moment';
+        const arr = buckets.get(kind) ?? [];
+        arr.push(ev);
+        buckets.set(kind, arr);
+    }
+    const clusters = [];
+    for (const kind of CLUSTER_ORDER) {
+        const evs = buckets.get(kind);
+        if (!evs || evs.length === 0)
+            continue;
+        clusters.push({
+            id: `cluster:${kind}:${evs[0].index}`,
+            kind,
+            theme: THEME_FOR_KIND[kind],
+            direction: DIRECTION_FOR_KIND[kind],
+            events: evs,
+        });
+    }
+    return clusters;
+}
+/** One direction-aligned NarrativeBeat per cluster. */
+function clustersToBeats(clusters) {
+    const now = new Date().toISOString();
+    return clusters.map((c) => ({
+        id: `beat:${c.id}`,
+        direction: c.direction,
+        title: c.theme,
+        description: `${c.events.length} ${c.kind} event(s) witnessed`,
+        prose: c.events
+            .slice(0, 3)
+            .map((e) => e.text)
+            .join(' '),
+        ceremonies: [],
+        learnings: [],
+        timestamp: now,
+        act: ACT_FOR_DIRECTION[c.direction],
+        relations_honored: [],
+    }));
+}
+//# sourceMappingURL=clusters.js.map

package/dist/clusters.js.map

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

package/dist/edit-brief.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @medicine-wheel/narrative-cluster — Edit Brief
+ *
+ * Generate a Film Edit Brief from narrative clusters: ordered EDL-style markers
+ * with synthesized timecodes and narrative annotations. Deterministic — the same
+ * clusters always yield the same brief, so the slice is testable.
+ */
+import type { ClusterKind, NarrativeCluster } from './clusters.js';
+export interface EditMarker {
+    index: number;
+    clusterId: string;
+    kind: ClusterKind;
+    /** HH:MM:SS:FF timecode synthesized from marker order. */
+    timecode: string;
+    /** Narrative annotation for the editor. */
+    label: string;
+    source: string;
+}
+export interface EditBrief {
+    productionId: string;
+    title: string;
+    markers: EditMarker[];
+    /** CMX3600-style EDL text block. */
+    edl: string;
+    generatedAt: string;
+}
+export interface EditBriefOptions {
+    productionId?: string;
+    title?: string;
+    fps?: number;
+    /** Seconds allotted per marker for synthetic timecodes (default: 4). */
+    secondsPerMarker?: number;
+}
+/** Produce ordered markers + an EDL text block from clusters. */
+export declare function generateEditBrief(clusters: NarrativeCluster[], opts?: EditBriefOptions): EditBrief;
+//# sourceMappingURL=edit-brief.d.ts.map

package/dist/edit-brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-brief.d.ts","sourceRoot":"","sources":["../src/edit-brief.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAWD,iEAAiE;AACjE,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,IAAI,GAAE,gBAAqB,GAC1B,SAAS,CAoCX"}

package/dist/edit-brief.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateEditBrief = generateEditBrief;
+function tc(totalSeconds, fps) {
+    const pad = (n) => String(n).padStart(2, '0');
+    const h = Math.floor(totalSeconds / 3600);
+    const m = Math.floor(totalSeconds / 60) % 60;
+    const s = Math.floor(totalSeconds) % 60;
+    const f = Math.floor((totalSeconds - Math.floor(totalSeconds)) * fps);
+    return `${pad(h)}:${pad(m)}:${pad(s)}:${pad(f)}`;
+}
+/** Produce ordered markers + an EDL text block from clusters. */
+function generateEditBrief(clusters, opts = {}) {
+    const fps = opts.fps ?? 24;
+    const secondsPerMarker = opts.secondsPerMarker ?? 4;
+    const productionId = opts.productionId ?? `production:${Date.now()}`;
+    const title = opts.title ?? 'Agent-supported edit brief';
+    const generatedAt = new Date().toISOString();
+    const markers = [];
+    let order = 0;
+    for (const cluster of clusters) {
+        for (const ev of cluster.events) {
+            const startSec = order * secondsPerMarker;
+            order += 1;
+            markers.push({
+                index: order,
+                clusterId: cluster.id,
+                kind: cluster.kind,
+                timecode: tc(startSec, fps),
+                label: `[${cluster.kind}] ${ev.text.slice(0, 72)}`,
+                source: ev.source ?? 'belt-device',
+            });
+        }
+    }
+    const edlLines = [`TITLE: ${title}`, 'FCM: NON-DROP FRAME'];
+    markers.forEach((marker, i) => {
+        const startSec = i * secondsPerMarker;
+        const inTc = tc(startSec, fps);
+        const outTc = tc(startSec + secondsPerMarker, fps);
+        const num = String(marker.index).padStart(3, '0');
+        edlLines.push(`${num}  AX       AA/V  C        ${inTc} ${outTc} ${inTc} ${outTc}`);
+        edlLines.push(`* FROM CLIP NAME: ${marker.source}`);
+        edlLines.push(`* COMMENT: ${marker.label}`);
+    });
+    return { productionId, title, markers, edl: edlLines.join('\n'), generatedAt };
+}
+//# sourceMappingURL=edit-brief.js.map

package/dist/edit-brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-brief.js","sourceRoot":"","sources":["../src/edit-brief.ts"],"names":[],"mappings":";;AA+CA,8CAuCC;AAjDD,SAAS,EAAE,CAAC,YAAoB,EAAE,GAAW;IAC3C,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;IACxC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACtE,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,iEAAiE;AACjE,SAAgB,iBAAiB,CAC/B,QAA4B,EAC5B,OAAyB,EAAE;IAE3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;IAC3B,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,cAAc,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACrE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,4BAA4B,CAAC;IACzD,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE7C,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,KAAK,GAAG,gBAAgB,CAAC;YAC1C,KAAK,IAAI,CAAC,CAAC;YACX,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,KAAK;gBACZ,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC;gBAC3B,KAAK,EAAE,IAAI,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;gBAClD,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,aAAa;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAa,CAAC,UAAU,KAAK,EAAE,EAAE,qBAAqB,CAAC,CAAC;IACtE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,CAAC,GAAG,gBAAgB,CAAC;QACtC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,GAAG,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,6BAA6B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QACnF,QAAQ,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;AACjF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @medicine-wheel/narrative-cluster
+ *
+ * The Narrative Cluster Processor: witnessed events → cinematic clusters →
+ * narrative beats → a Film Edit Brief (EDL markers with narrative annotations).
+ *
+ * @example
+ * ```ts
+ * import { clusterEvents, clustersToBeats, generateEditBrief } from '@medicine-wheel/narrative-cluster';
+ *
+ * const clusters = clusterEvents(events.map((e) => ({ type: e.type, text: e.text, index: e.index, source: e.source })));
+ * const beats = clustersToBeats(clusters);
+ * const brief = generateEditBrief(clusters, { title: 'Episode 066 rushes' });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { ClusterKind, ClusterableEvent, NarrativeCluster } from './clusters.js';
+export { clusterEvents, clustersToBeats } from './clusters.js';
+export type { EditMarker, EditBrief, EditBriefOptions } from './edit-brief.js';
+export { generateEditBrief } from './edit-brief.js';
+//# 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;;;;;;;;;;;;;;;;GAgBG;AACH,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE/D,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateEditBrief = exports.clustersToBeats = exports.clusterEvents = void 0;
+var clusters_js_1 = require("./clusters.js");
+Object.defineProperty(exports, "clusterEvents", { enumerable: true, get: function () { return clusters_js_1.clusterEvents; } });
+Object.defineProperty(exports, "clustersToBeats", { enumerable: true, get: function () { return clusters_js_1.clustersToBeats; } });
+var edit_brief_js_1 = require("./edit-brief.js");
+Object.defineProperty(exports, "generateEditBrief", { enumerable: true, get: function () { return edit_brief_js_1.generateEditBrief; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAkBA,6CAA+D;AAAtD,4GAAA,aAAa,OAAA;AAAE,8GAAA,eAAe,OAAA;AAGvC,iDAAoD;AAA3C,kHAAA,iBAAiB,OAAA"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@medicine-wheel/narrative-cluster",
+  "version": "0.4.9",
+  "description": "Narrative Cluster Processor — turn witnessed perceptual events / rushes into thematic clusters, narrative beats, and a Film Edit Brief (EDL markers)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "medicine-wheel",
+    "film-production",
+    "narrative",
+    "cluster",
+    "edit-brief",
+    "edl",
+    "indigenous"
+  ],
+  "author": "jgwill",
+  "license": "MIT",
+  "dependencies": {
+    "@medicine-wheel/ontology-core": "^0.4.9"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}