@mulmoclaude/mulmoscript-plugin 4.3.0 → 4.5.0

package/dist/contract-BHqxMUWm.cjs

@@ -0,0 +1,82 @@
+//#region src/core/contract.ts
+/** Plugin pubsub event name the host publishes generation events on
+*  (full channel: `plugin:<scope>:generation`). */
+var GENERATION_EVENT = "generation";
+/** Plugin pubsub event name for "this script changed on disk"
+*  (full channel: `plugin:<scope>:scriptChanged`). */
+var SCRIPT_CHANGED_EVENT = "scriptChanged";
+/**
+* Whether a View watching `watching` should reload because of `event`.
+*
+* A pure rule rather than a condition inside the subscriber, because the case that matters is
+* the one that is invisible when it is wrong: a View acting on the echo of its own write
+* rebuilds the element the caret is in, on every keystroke.
+*/
+var shouldReloadForScriptChange = (event, watching, ownOrigin, watchingRoot) => watching !== "" && event.filePath === watching && sameRoot(event.root, watchingRoot) && event.origin !== ownOrigin;
+/**
+* The one spelling of a root that every comparison and every key must use.
+*
+* It lives HERE, in the module both the server and the View import, because
+* the server had its own copy and the browser side compared raw strings — so
+* `publishGeneration` emitted `"repoA"` while a View watching `" repoA "`
+* dropped every event of its own generation (CodeRabbit on #3015). A rule
+* that two sides must agree on cannot live on one of the two sides.
+*
+* Trimmed, because the codebase's other opaque "which project root" reader —
+* `readCommandScope` in `@mulmoclaude/core/remote-host` — trims its value and
+* shares the "absent = the host's own root" convention. Without this,
+* `" repoA "` is one root there and a different one here.
+*
+* A non-string reads as the default root rather than throwing. The type says
+* that cannot happen, but this package is published and its callers include
+* untyped JavaScript: a subscription whose `root()` returns `42` reached
+* `.trim()` and threw from INSIDE a pubsub callback, where nothing catches it
+* and the View simply stops updating (Codex P2 on #3015). The guard belongs
+* here rather than at the three call sites, because a rule enforced by
+* enumerating its callers is what this PR got wrong repeatedly.
+*/
+var normalizeRoot = (root) => typeof root === "string" ? root.trim() : "";
+/**
+* Two roots are the same when they name the same one, with absent meaning the
+* host's default (#3014).
+*
+* The identity of a script is the PAIR, not the path: `stories/deck.json` in
+* two repositories is two files, and comparing paths alone would reload the
+* View watching one because the other was saved. Absent normalises to the
+* default so a pre-`root` event and a default-root watcher still match — that
+* equivalence is what keeps every existing card working untouched.
+*/
+var sameRoot = (a, b) => normalizeRoot(a) === normalizeRoot(b);
+//#endregion
+Object.defineProperty(exports, "GENERATION_EVENT", {
+	enumerable: true,
+	get: function() {
+		return GENERATION_EVENT;
+	}
+});
+Object.defineProperty(exports, "SCRIPT_CHANGED_EVENT", {
+	enumerable: true,
+	get: function() {
+		return SCRIPT_CHANGED_EVENT;
+	}
+});
+Object.defineProperty(exports, "normalizeRoot", {
+	enumerable: true,
+	get: function() {
+		return normalizeRoot;
+	}
+});
+Object.defineProperty(exports, "sameRoot", {
+	enumerable: true,
+	get: function() {
+		return sameRoot;
+	}
+});
+Object.defineProperty(exports, "shouldReloadForScriptChange", {
+	enumerable: true,
+	get: function() {
+		return shouldReloadForScriptChange;
+	}
+});
+
+//# sourceMappingURL=contract-BHqxMUWm.cjs.map

package/dist/contract-BHqxMUWm.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-BHqxMUWm.cjs","names":[],"sources":["../src/core/contract.ts"],"sourcesContent":["// Host-agnostic dispatch envelope for the presentMulmoScript View. The Vue\n// View is decoupled from any one host's REST surface: it calls\n// `useRuntime().dispatch({ kind, … })`, the host routes that to its\n// mulmoScript dispatch handler, and every response is an `{ ok: … }`\n// envelope so failures travel as data (no HTTP-status coupling, no\n// \"dispatch failed (500)\" prefixes in user-facing errors).\n//\n// Long-running generation (movie / PDF) is a single long-held dispatch that\n// resolves when the pipeline finishes; per-beat progress arrives on the\n// plugin pubsub channel (`GENERATION_EVENT`) instead of an SSE stream, which\n// also covers generations started elsewhere (background autoGenerateMovie,\n// another tab, the agent).\n\n/** One in-flight or per-beat generation notice, published on the plugin\n *  pubsub `generation` channel and returned by the `pendingGenerations`\n *  snapshot. Value strings mirror @mulmobridge/protocol's GENERATION_KINDS\n *  so MulmoClaude's host bridge maps 1:1 without a lookup table. */\nexport interface MulmoScriptGenerationEvent {\n  kind: \"beatImage\" | \"beatAudio\" | \"characterImage\" | \"movie\" | \"pdf\";\n  /** Wire `stories/…` path of the script the generation belongs to. */\n  filePath: string;\n  /** Which stories root `filePath` is relative to (#3014). Absent = the\n   *  host's default root, which is every event this package emitted before\n   *  roots existed. */\n  root?: string;\n  /** beatIndex (as string) for beat*, character key for characterImage, \"\" for movie/pdf. */\n  key: string;\n  /** false = started, true = finished (reload the asset off disk). */\n  done: boolean;\n  /** Only set on done=true when the work failed. */\n  error?: string;\n}\n\n/** Plugin pubsub event name the host publishes generation events on\n *  (full channel: `plugin:<scope>:generation`). */\nexport const GENERATION_EVENT = \"generation\";\n\n/** Plugin pubsub event name for \"this script changed on disk\"\n *  (full channel: `plugin:<scope>:scriptChanged`). */\nexport const SCRIPT_CHANGED_EVENT = \"scriptChanged\";\n\n/**\n * A script was written — by the agent, or by another View.\n *\n * `origin` is who wrote it. A View passes its own id on every write and ignores the echo of\n * its own: without that, a keystroke would round-trip through the server and reload the very\n * element the caret is in. An agent write carries no origin, so every View reloads.\n */\nexport interface MulmoScriptChangedEvent {\n  filePath: string;\n  /** Which stories root `filePath` is relative to (#3014). Absent = default. */\n  root?: string;\n  origin?: string;\n}\n\n/**\n * Whether a View watching `watching` should reload because of `event`.\n *\n * A pure rule rather than a condition inside the subscriber, because the case that matters is\n * the one that is invisible when it is wrong: a View acting on the echo of its own write\n * rebuilds the element the caret is in, on every keystroke.\n */\nexport const shouldReloadForScriptChange = (event: MulmoScriptChangedEvent, watching: string, ownOrigin: string, watchingRoot?: string): boolean =>\n  watching !== \"\" && event.filePath === watching && sameRoot(event.root, watchingRoot) && event.origin !== ownOrigin;\n\n/** The default root: what a caller that names no root is asking for. */\nexport const DEFAULT_ROOT = \"\";\n\n/**\n * The one spelling of a root that every comparison and every key must use.\n *\n * It lives HERE, in the module both the server and the View import, because\n * the server had its own copy and the browser side compared raw strings — so\n * `publishGeneration` emitted `\"repoA\"` while a View watching `\" repoA \"`\n * dropped every event of its own generation (CodeRabbit on #3015). A rule\n * that two sides must agree on cannot live on one of the two sides.\n *\n * Trimmed, because the codebase's other opaque \"which project root\" reader —\n * `readCommandScope` in `@mulmoclaude/core/remote-host` — trims its value and\n * shares the \"absent = the host's own root\" convention. Without this,\n * `\" repoA \"` is one root there and a different one here.\n *\n * A non-string reads as the default root rather than throwing. The type says\n * that cannot happen, but this package is published and its callers include\n * untyped JavaScript: a subscription whose `root()` returns `42` reached\n * `.trim()` and threw from INSIDE a pubsub callback, where nothing catches it\n * and the View simply stops updating (Codex P2 on #3015). The guard belongs\n * here rather than at the three call sites, because a rule enforced by\n * enumerating its callers is what this PR got wrong repeatedly.\n */\nexport const normalizeRoot = (root: string | undefined): string => (typeof root === \"string\" ? root.trim() : DEFAULT_ROOT);\n\n/**\n * Two roots are the same when they name the same one, with absent meaning the\n * host's default (#3014).\n *\n * The identity of a script is the PAIR, not the path: `stories/deck.json` in\n * two repositories is two files, and comparing paths alone would reload the\n * View watching one because the other was saved. Absent normalises to the\n * default so a pre-`root` event and a default-root watcher still match — that\n * equivalence is what keeps every existing card working untouched.\n */\nexport const sameRoot = (a: string | undefined, b: string | undefined): boolean => normalizeRoot(a) === normalizeRoot(b);\n\ninterface BeatRef {\n  filePath: string;\n  beatIndex: number;\n}\n\ninterface CharacterRef {\n  filePath: string;\n  key: string;\n}\n\n/** Session tag for hosts that surface per-session generation indicators\n *  (MulmoClaude's sidebar). Optional everywhere; hosts without sessions\n *  ignore it. */\ninterface SessionTag {\n  chatSessionId?: string | undefined;\n}\n\n/**\n * Which registered stories root the named script lives in (#3014).\n *\n * Intersected into the whole union below, so every dispatch that names a\n * `filePath` can name its root — a union member that could not would make\n * root-aware calls untypeable while the handler happily read `args.root`\n * off an untyped record (Codex P1 on #3015).\n */\ninterface RootTag {\n  root?: string | undefined;\n}\n\nexport type MulmoScriptDispatchArgs = RootTag &\n  (\n    | ({ kind: \"save\" } & { filePath?: string; script?: unknown; filename?: string })\n    | { kind: \"updateBeat\"; filePath: string; beatIndex: number; beat: unknown; origin?: string }\n    | { kind: \"updateScript\"; filePath: string; script: unknown; origin?: string }\n    | ({ kind: \"beatImage\" } & BeatRef)\n    | ({ kind: \"beatAudio\" } & BeatRef)\n    | ({ kind: \"beatMovie\" } & BeatRef)\n    | ({ kind: \"renderBeat\" } & BeatRef & SessionTag & { force?: boolean })\n    | ({ kind: \"generateBeatAudio\" } & BeatRef & SessionTag & { force?: boolean })\n    | ({ kind: \"uploadBeatImage\" } & BeatRef & { imageData: string })\n    | ({ kind: \"characterImage\" } & CharacterRef)\n    | ({ kind: \"renderCharacter\" } & CharacterRef & SessionTag & { force?: boolean })\n    | ({ kind: \"uploadCharacterImage\" } & CharacterRef & { imageData: string })\n    | ({ kind: \"movieStatus\" } & { filePath: string })\n    | ({ kind: \"pdfStatus\" } & { filePath: string })\n    | ({ kind: \"generateMovie\" } & { filePath: string } & SessionTag)\n    | ({ kind: \"generatePdf\" } & { filePath: string } & SessionTag)\n    | { kind: \"pendingGenerations\"; filePath: string }\n  );\n\nexport type MulmoScriptDispatchKind = MulmoScriptDispatchArgs[\"kind\"];\n\n/** Failure half of every dispatch response. `code` mirrors the phase-1\n *  outcome codes so a host can log/telemetry on it; the View only reads\n *  `error`. */\nexport interface DispatchFailure {\n  ok: false;\n  code?: \"bad_request\" | \"not_found\" | \"server_error\";\n  error: string;\n}\n\nexport type DispatchEnvelope<T> = ({ ok: true } & T) | DispatchFailure;\n\n/** The success payload of each dispatch `kind`, BEFORE the root tag below is\n *  applied. Not exported: `MulmoScriptDispatchResult` is the type callers use. */\ninterface DispatchResultPayloads {\n  save: { script: Record<string, unknown>; filePath: string; message: string };\n  updateBeat: Record<string, never>;\n  updateScript: Record<string, never>;\n  beatImage: { image: string | null };\n  beatAudio: { audio: string | null };\n  beatMovie: { moviePath: string | null };\n  renderBeat: { image: string };\n  generateBeatAudio: { audio: string };\n  uploadBeatImage: { image: string };\n  characterImage: { image: string | null };\n  renderCharacter: { image: string };\n  uploadCharacterImage: { image: string };\n  movieStatus: { moviePath: string | null };\n  pdfStatus: { pdfPath: string | null };\n  generateMovie: { moviePath: string };\n  generatePdf: { pdfPath: string };\n  pendingGenerations: { pending: MulmoScriptGenerationEvent[] };\n}\n\n/**\n * Maps a dispatch `kind` to its success payload, every one of them carrying\n * the root it acted in.\n *\n * A host builds its cards from these results, and a card's identity is the\n * PAIR `(root, filePath)` — `stories/deck.json` exists in every registered\n * root. Without the root here, two repositories' identically-named decks\n * collapse onto one card, which is #3014's third collision point, and no\n * amount of fixing the host's identity function helps because the value never\n * arrives.\n *\n * `root` was threaded through the ARGS and the EVENTS in #3015 and not through\n * the results — the same shape that PR got wrong repeatedly: the comparison\n * widened while the path carrying the data to it did not. Applied as a mapped\n * type rather than field by field so a kind added later cannot be forgotten.\n *\n * Absent means the default root, so every pre-`root` card is unchanged.\n */\nexport type MulmoScriptDispatchResult = {\n  [K in keyof DispatchResultPayloads]: DispatchResultPayloads[K] & RootTag;\n};\n"],"mappings":";;;AAmCA,IAAa,mBAAmB;;;AAIhC,IAAa,uBAAuB;;;;;;;;AAuBpC,IAAa,+BAA+B,OAAgC,UAAkB,WAAmB,iBAC/G,aAAa,MAAM,MAAM,aAAa,YAAY,SAAS,MAAM,MAAM,YAAY,KAAK,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;AA2B3G,IAAa,iBAAiB,SAAsC,OAAO,SAAS,WAAW,KAAK,KAAK,IAAA;;;;;;;;;;;AAYzG,IAAa,YAAY,GAAuB,MAAmC,cAAc,CAAC,MAAM,cAAc,CAAC"}

package/dist/contract-BnIl6w_f.js

@@ -0,0 +1,53 @@
+//#region src/core/contract.ts
+/** Plugin pubsub event name the host publishes generation events on
+*  (full channel: `plugin:<scope>:generation`). */
+var GENERATION_EVENT = "generation";
+/** Plugin pubsub event name for "this script changed on disk"
+*  (full channel: `plugin:<scope>:scriptChanged`). */
+var SCRIPT_CHANGED_EVENT = "scriptChanged";
+/**
+* Whether a View watching `watching` should reload because of `event`.
+*
+* A pure rule rather than a condition inside the subscriber, because the case that matters is
+* the one that is invisible when it is wrong: a View acting on the echo of its own write
+* rebuilds the element the caret is in, on every keystroke.
+*/
+var shouldReloadForScriptChange = (event, watching, ownOrigin, watchingRoot) => watching !== "" && event.filePath === watching && sameRoot(event.root, watchingRoot) && event.origin !== ownOrigin;
+/**
+* The one spelling of a root that every comparison and every key must use.
+*
+* It lives HERE, in the module both the server and the View import, because
+* the server had its own copy and the browser side compared raw strings — so
+* `publishGeneration` emitted `"repoA"` while a View watching `" repoA "`
+* dropped every event of its own generation (CodeRabbit on #3015). A rule
+* that two sides must agree on cannot live on one of the two sides.
+*
+* Trimmed, because the codebase's other opaque "which project root" reader —
+* `readCommandScope` in `@mulmoclaude/core/remote-host` — trims its value and
+* shares the "absent = the host's own root" convention. Without this,
+* `" repoA "` is one root there and a different one here.
+*
+* A non-string reads as the default root rather than throwing. The type says
+* that cannot happen, but this package is published and its callers include
+* untyped JavaScript: a subscription whose `root()` returns `42` reached
+* `.trim()` and threw from INSIDE a pubsub callback, where nothing catches it
+* and the View simply stops updating (Codex P2 on #3015). The guard belongs
+* here rather than at the three call sites, because a rule enforced by
+* enumerating its callers is what this PR got wrong repeatedly.
+*/
+var normalizeRoot = (root) => typeof root === "string" ? root.trim() : "";
+/**
+* Two roots are the same when they name the same one, with absent meaning the
+* host's default (#3014).
+*
+* The identity of a script is the PAIR, not the path: `stories/deck.json` in
+* two repositories is two files, and comparing paths alone would reload the
+* View watching one because the other was saved. Absent normalises to the
+* default so a pre-`root` event and a default-root watcher still match — that
+* equivalence is what keeps every existing card working untouched.
+*/
+var sameRoot = (a, b) => normalizeRoot(a) === normalizeRoot(b);
+//#endregion
+export { shouldReloadForScriptChange as a, sameRoot as i, SCRIPT_CHANGED_EVENT as n, normalizeRoot as r, GENERATION_EVENT as t };
+
+//# sourceMappingURL=contract-BnIl6w_f.js.map

package/dist/contract-BnIl6w_f.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-BnIl6w_f.js","names":[],"sources":["../src/core/contract.ts"],"sourcesContent":["// Host-agnostic dispatch envelope for the presentMulmoScript View. The Vue\n// View is decoupled from any one host's REST surface: it calls\n// `useRuntime().dispatch({ kind, … })`, the host routes that to its\n// mulmoScript dispatch handler, and every response is an `{ ok: … }`\n// envelope so failures travel as data (no HTTP-status coupling, no\n// \"dispatch failed (500)\" prefixes in user-facing errors).\n//\n// Long-running generation (movie / PDF) is a single long-held dispatch that\n// resolves when the pipeline finishes; per-beat progress arrives on the\n// plugin pubsub channel (`GENERATION_EVENT`) instead of an SSE stream, which\n// also covers generations started elsewhere (background autoGenerateMovie,\n// another tab, the agent).\n\n/** One in-flight or per-beat generation notice, published on the plugin\n *  pubsub `generation` channel and returned by the `pendingGenerations`\n *  snapshot. Value strings mirror @mulmobridge/protocol's GENERATION_KINDS\n *  so MulmoClaude's host bridge maps 1:1 without a lookup table. */\nexport interface MulmoScriptGenerationEvent {\n  kind: \"beatImage\" | \"beatAudio\" | \"characterImage\" | \"movie\" | \"pdf\";\n  /** Wire `stories/…` path of the script the generation belongs to. */\n  filePath: string;\n  /** Which stories root `filePath` is relative to (#3014). Absent = the\n   *  host's default root, which is every event this package emitted before\n   *  roots existed. */\n  root?: string;\n  /** beatIndex (as string) for beat*, character key for characterImage, \"\" for movie/pdf. */\n  key: string;\n  /** false = started, true = finished (reload the asset off disk). */\n  done: boolean;\n  /** Only set on done=true when the work failed. */\n  error?: string;\n}\n\n/** Plugin pubsub event name the host publishes generation events on\n *  (full channel: `plugin:<scope>:generation`). */\nexport const GENERATION_EVENT = \"generation\";\n\n/** Plugin pubsub event name for \"this script changed on disk\"\n *  (full channel: `plugin:<scope>:scriptChanged`). */\nexport const SCRIPT_CHANGED_EVENT = \"scriptChanged\";\n\n/**\n * A script was written — by the agent, or by another View.\n *\n * `origin` is who wrote it. A View passes its own id on every write and ignores the echo of\n * its own: without that, a keystroke would round-trip through the server and reload the very\n * element the caret is in. An agent write carries no origin, so every View reloads.\n */\nexport interface MulmoScriptChangedEvent {\n  filePath: string;\n  /** Which stories root `filePath` is relative to (#3014). Absent = default. */\n  root?: string;\n  origin?: string;\n}\n\n/**\n * Whether a View watching `watching` should reload because of `event`.\n *\n * A pure rule rather than a condition inside the subscriber, because the case that matters is\n * the one that is invisible when it is wrong: a View acting on the echo of its own write\n * rebuilds the element the caret is in, on every keystroke.\n */\nexport const shouldReloadForScriptChange = (event: MulmoScriptChangedEvent, watching: string, ownOrigin: string, watchingRoot?: string): boolean =>\n  watching !== \"\" && event.filePath === watching && sameRoot(event.root, watchingRoot) && event.origin !== ownOrigin;\n\n/** The default root: what a caller that names no root is asking for. */\nexport const DEFAULT_ROOT = \"\";\n\n/**\n * The one spelling of a root that every comparison and every key must use.\n *\n * It lives HERE, in the module both the server and the View import, because\n * the server had its own copy and the browser side compared raw strings — so\n * `publishGeneration` emitted `\"repoA\"` while a View watching `\" repoA \"`\n * dropped every event of its own generation (CodeRabbit on #3015). A rule\n * that two sides must agree on cannot live on one of the two sides.\n *\n * Trimmed, because the codebase's other opaque \"which project root\" reader —\n * `readCommandScope` in `@mulmoclaude/core/remote-host` — trims its value and\n * shares the \"absent = the host's own root\" convention. Without this,\n * `\" repoA \"` is one root there and a different one here.\n *\n * A non-string reads as the default root rather than throwing. The type says\n * that cannot happen, but this package is published and its callers include\n * untyped JavaScript: a subscription whose `root()` returns `42` reached\n * `.trim()` and threw from INSIDE a pubsub callback, where nothing catches it\n * and the View simply stops updating (Codex P2 on #3015). The guard belongs\n * here rather than at the three call sites, because a rule enforced by\n * enumerating its callers is what this PR got wrong repeatedly.\n */\nexport const normalizeRoot = (root: string | undefined): string => (typeof root === \"string\" ? root.trim() : DEFAULT_ROOT);\n\n/**\n * Two roots are the same when they name the same one, with absent meaning the\n * host's default (#3014).\n *\n * The identity of a script is the PAIR, not the path: `stories/deck.json` in\n * two repositories is two files, and comparing paths alone would reload the\n * View watching one because the other was saved. Absent normalises to the\n * default so a pre-`root` event and a default-root watcher still match — that\n * equivalence is what keeps every existing card working untouched.\n */\nexport const sameRoot = (a: string | undefined, b: string | undefined): boolean => normalizeRoot(a) === normalizeRoot(b);\n\ninterface BeatRef {\n  filePath: string;\n  beatIndex: number;\n}\n\ninterface CharacterRef {\n  filePath: string;\n  key: string;\n}\n\n/** Session tag for hosts that surface per-session generation indicators\n *  (MulmoClaude's sidebar). Optional everywhere; hosts without sessions\n *  ignore it. */\ninterface SessionTag {\n  chatSessionId?: string | undefined;\n}\n\n/**\n * Which registered stories root the named script lives in (#3014).\n *\n * Intersected into the whole union below, so every dispatch that names a\n * `filePath` can name its root — a union member that could not would make\n * root-aware calls untypeable while the handler happily read `args.root`\n * off an untyped record (Codex P1 on #3015).\n */\ninterface RootTag {\n  root?: string | undefined;\n}\n\nexport type MulmoScriptDispatchArgs = RootTag &\n  (\n    | ({ kind: \"save\" } & { filePath?: string; script?: unknown; filename?: string })\n    | { kind: \"updateBeat\"; filePath: string; beatIndex: number; beat: unknown; origin?: string }\n    | { kind: \"updateScript\"; filePath: string; script: unknown; origin?: string }\n    | ({ kind: \"beatImage\" } & BeatRef)\n    | ({ kind: \"beatAudio\" } & BeatRef)\n    | ({ kind: \"beatMovie\" } & BeatRef)\n    | ({ kind: \"renderBeat\" } & BeatRef & SessionTag & { force?: boolean })\n    | ({ kind: \"generateBeatAudio\" } & BeatRef & SessionTag & { force?: boolean })\n    | ({ kind: \"uploadBeatImage\" } & BeatRef & { imageData: string })\n    | ({ kind: \"characterImage\" } & CharacterRef)\n    | ({ kind: \"renderCharacter\" } & CharacterRef & SessionTag & { force?: boolean })\n    | ({ kind: \"uploadCharacterImage\" } & CharacterRef & { imageData: string })\n    | ({ kind: \"movieStatus\" } & { filePath: string })\n    | ({ kind: \"pdfStatus\" } & { filePath: string })\n    | ({ kind: \"generateMovie\" } & { filePath: string } & SessionTag)\n    | ({ kind: \"generatePdf\" } & { filePath: string } & SessionTag)\n    | { kind: \"pendingGenerations\"; filePath: string }\n  );\n\nexport type MulmoScriptDispatchKind = MulmoScriptDispatchArgs[\"kind\"];\n\n/** Failure half of every dispatch response. `code` mirrors the phase-1\n *  outcome codes so a host can log/telemetry on it; the View only reads\n *  `error`. */\nexport interface DispatchFailure {\n  ok: false;\n  code?: \"bad_request\" | \"not_found\" | \"server_error\";\n  error: string;\n}\n\nexport type DispatchEnvelope<T> = ({ ok: true } & T) | DispatchFailure;\n\n/** The success payload of each dispatch `kind`, BEFORE the root tag below is\n *  applied. Not exported: `MulmoScriptDispatchResult` is the type callers use. */\ninterface DispatchResultPayloads {\n  save: { script: Record<string, unknown>; filePath: string; message: string };\n  updateBeat: Record<string, never>;\n  updateScript: Record<string, never>;\n  beatImage: { image: string | null };\n  beatAudio: { audio: string | null };\n  beatMovie: { moviePath: string | null };\n  renderBeat: { image: string };\n  generateBeatAudio: { audio: string };\n  uploadBeatImage: { image: string };\n  characterImage: { image: string | null };\n  renderCharacter: { image: string };\n  uploadCharacterImage: { image: string };\n  movieStatus: { moviePath: string | null };\n  pdfStatus: { pdfPath: string | null };\n  generateMovie: { moviePath: string };\n  generatePdf: { pdfPath: string };\n  pendingGenerations: { pending: MulmoScriptGenerationEvent[] };\n}\n\n/**\n * Maps a dispatch `kind` to its success payload, every one of them carrying\n * the root it acted in.\n *\n * A host builds its cards from these results, and a card's identity is the\n * PAIR `(root, filePath)` — `stories/deck.json` exists in every registered\n * root. Without the root here, two repositories' identically-named decks\n * collapse onto one card, which is #3014's third collision point, and no\n * amount of fixing the host's identity function helps because the value never\n * arrives.\n *\n * `root` was threaded through the ARGS and the EVENTS in #3015 and not through\n * the results — the same shape that PR got wrong repeatedly: the comparison\n * widened while the path carrying the data to it did not. Applied as a mapped\n * type rather than field by field so a kind added later cannot be forgotten.\n *\n * Absent means the default root, so every pre-`root` card is unchanged.\n */\nexport type MulmoScriptDispatchResult = {\n  [K in keyof DispatchResultPayloads]: DispatchResultPayloads[K] & RootTag;\n};\n"],"mappings":";;;AAmCA,IAAa,mBAAmB;;;AAIhC,IAAa,uBAAuB;;;;;;;;AAuBpC,IAAa,+BAA+B,OAAgC,UAAkB,WAAmB,iBAC/G,aAAa,MAAM,MAAM,aAAa,YAAY,SAAS,MAAM,MAAM,YAAY,KAAK,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;AA2B3G,IAAa,iBAAiB,SAAsC,OAAO,SAAS,WAAW,KAAK,KAAK,IAAA;;;;;;;;;;;AAYzG,IAAa,YAAY,GAAuB,MAAmC,cAAc,CAAC,MAAM,cAAc,CAAC"}

package/dist/core/contract.d.ts

@@ -6,6 +6,10 @@ export interface MulmoScriptGenerationEvent {
     kind: "beatImage" | "beatAudio" | "characterImage" | "movie" | "pdf";
     /** Wire `stories/…` path of the script the generation belongs to. */
     filePath: string;
+    /** Which stories root `filePath` is relative to (#3014). Absent = the
+     *  host's default root, which is every event this package emitted before
+     *  roots existed. */
+    root?: string;
     /** beatIndex (as string) for beat*, character key for characterImage, "" for movie/pdf. */
     key: string;
     /** false = started, true = finished (reload the asset off disk). */
@@ -28,6 +32,8 @@ export declare const SCRIPT_CHANGED_EVENT = "scriptChanged";
  */
 export interface MulmoScriptChangedEvent {
     filePath: string;
+    /** Which stories root `filePath` is relative to (#3014). Absent = default. */
+    root?: string;
     origin?: string;
 }
 /**
@@ -37,7 +43,43 @@ export interface MulmoScriptChangedEvent {
  * the one that is invisible when it is wrong: a View acting on the echo of its own write
  * rebuilds the element the caret is in, on every keystroke.
  */
-export declare const shouldReloadForScriptChange: (event: MulmoScriptChangedEvent, watching: string, ownOrigin: string) => boolean;
+export declare const shouldReloadForScriptChange: (event: MulmoScriptChangedEvent, watching: string, ownOrigin: string, watchingRoot?: string) => boolean;
+/** The default root: what a caller that names no root is asking for. */
+export declare const DEFAULT_ROOT = "";
+/**
+ * The one spelling of a root that every comparison and every key must use.
+ *
+ * It lives HERE, in the module both the server and the View import, because
+ * the server had its own copy and the browser side compared raw strings — so
+ * `publishGeneration` emitted `"repoA"` while a View watching `" repoA "`
+ * dropped every event of its own generation (CodeRabbit on #3015). A rule
+ * that two sides must agree on cannot live on one of the two sides.
+ *
+ * Trimmed, because the codebase's other opaque "which project root" reader —
+ * `readCommandScope` in `@mulmoclaude/core/remote-host` — trims its value and
+ * shares the "absent = the host's own root" convention. Without this,
+ * `" repoA "` is one root there and a different one here.
+ *
+ * A non-string reads as the default root rather than throwing. The type says
+ * that cannot happen, but this package is published and its callers include
+ * untyped JavaScript: a subscription whose `root()` returns `42` reached
+ * `.trim()` and threw from INSIDE a pubsub callback, where nothing catches it
+ * and the View simply stops updating (Codex P2 on #3015). The guard belongs
+ * here rather than at the three call sites, because a rule enforced by
+ * enumerating its callers is what this PR got wrong repeatedly.
+ */
+export declare const normalizeRoot: (root: string | undefined) => string;
+/**
+ * Two roots are the same when they name the same one, with absent meaning the
+ * host's default (#3014).
+ *
+ * The identity of a script is the PAIR, not the path: `stories/deck.json` in
+ * two repositories is two files, and comparing paths alone would reload the
+ * View watching one because the other was saved. Absent normalises to the
+ * default so a pre-`root` event and a default-root watcher still match — that
+ * equivalence is what keeps every existing card working untouched.
+ */
+export declare const sameRoot: (a: string | undefined, b: string | undefined) => boolean;
 interface BeatRef {
     filePath: string;
     beatIndex: number;
@@ -52,7 +94,18 @@ interface CharacterRef {
 interface SessionTag {
     chatSessionId?: string | undefined;
 }
-export type MulmoScriptDispatchArgs = ({
+/**
+ * Which registered stories root the named script lives in (#3014).
+ *
+ * Intersected into the whole union below, so every dispatch that names a
+ * `filePath` can name its root — a union member that could not would make
+ * root-aware calls untypeable while the handler happily read `args.root`
+ * off an untyped record (Codex P1 on #3015).
+ */
+interface RootTag {
+    root?: string | undefined;
+}
+export type MulmoScriptDispatchArgs = RootTag & (({
     kind: "save";
 } & {
     filePath?: string;
@@ -116,7 +169,7 @@ export type MulmoScriptDispatchArgs = ({
 } & SessionTag) | {
     kind: "pendingGenerations";
     filePath: string;
-};
+});
 export type MulmoScriptDispatchKind = MulmoScriptDispatchArgs["kind"];
 /** Failure half of every dispatch response. `code` mirrors the phase-1
  *  outcome codes so a host can log/telemetry on it; the View only reads
@@ -129,9 +182,9 @@ export interface DispatchFailure {
 export type DispatchEnvelope<T> = ({
     ok: true;
 } & T) | DispatchFailure;
-/** Maps a dispatch `kind` to its success payload so the View's transport
- *  can call `dispatch` without casts at every site. */
-export interface MulmoScriptDispatchResult {
+/** The success payload of each dispatch `kind`, BEFORE the root tag below is
+ *  applied. Not exported: `MulmoScriptDispatchResult` is the type callers use. */
+interface DispatchResultPayloads {
     save: {
         script: Record<string, unknown>;
         filePath: string;
@@ -182,5 +235,26 @@ export interface MulmoScriptDispatchResult {
         pending: MulmoScriptGenerationEvent[];
     };
 }
+/**
+ * Maps a dispatch `kind` to its success payload, every one of them carrying
+ * the root it acted in.
+ *
+ * A host builds its cards from these results, and a card's identity is the
+ * PAIR `(root, filePath)` — `stories/deck.json` exists in every registered
+ * root. Without the root here, two repositories' identically-named decks
+ * collapse onto one card, which is #3014's third collision point, and no
+ * amount of fixing the host's identity function helps because the value never
+ * arrives.
+ *
+ * `root` was threaded through the ARGS and the EVENTS in #3015 and not through
+ * the results — the same shape that PR got wrong repeatedly: the comparison
+ * widened while the path carrying the data to it did not. Applied as a mapped
+ * type rather than field by field so a kind added later cannot be forgotten.
+ *
+ * Absent means the default root, so every pre-`root` card is unchanged.
+ */
+export type MulmoScriptDispatchResult = {
+    [K in keyof DispatchResultPayloads]: DispatchResultPayloads[K] & RootTag;
+};
 export {};
 //# sourceMappingURL=contract.d.ts.map

package/dist/core/contract.d.ts.map

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

package/dist/core/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/core/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,eAAO,MAAM,SAAS,uBAAuB,CAAC;AAM9C,eAAO,MAAM,eAAe,EAAE,cA4H7B,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/core/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,eAAO,MAAM,SAAS,uBAAuB,CAAC;AAM9C,eAAO,MAAM,eAAe,EAAE,cA0H7B,CAAC"}

package/dist/core/paths.d.ts

@@ -1,3 +1,44 @@
+/**
+ * The slice of `node:path` this rule needs.
+ *
+ * Injected with no default, and this module imports no `node:*` builtin: it is
+ * reached from the browser entry through `core/plugin`, so a `node:path`
+ * import here lands in the Vue bundle (Codex on #3017). The server passes its
+ * own `path`; tests pass `path.win32` to reach the case below.
+ */
+export interface PathRules {
+    relative: (from: string, to: string) => string;
+    isAbsolute: (p: string) => boolean;
+    sep: string;
+}
+/**
+ * The wire ref for an absolute path inside a stories root, or `null` when it
+ * is not inside one.
+ *
+ * Pure, and taking its path rules as an argument, because the case that
+ * matters is unreachable on the machine this is written on. `path.relative`
+ * says "not under the base" in TWO ways and only one looks like an escape:
+ * `../…` is the familiar one, and across Windows DRIVES there is no relative
+ * path at all, so `relative("C:\\base", "D:\\x")` answers `"D:\\x"` —
+ * absolute, with no `..` for the escape check to catch. That minted
+ * `stories/D:/anything`, a wire ref that reads back as a DIFFERENT file, which
+ * is the substitution this function exists to refuse. Only Windows CI caught
+ * it; here there is one root and always a relative route (#3015 post-merge).
+ */
+/**
+ * The path INSIDE a stories root that a wire path names, or null when it does
+ * not name one.
+ *
+ * The default root's FileOps is rooted one level up, at `<workspace>/artifacts`,
+ * so there the wire path and the FileOps path are the SAME string and nothing
+ * is stripped. A named root's FileOps is rooted at the stories directory
+ * itself — which is what a host naturally writes, having registered exactly
+ * that directory in `extraRoots` — so the `stories/` prefix has to come off,
+ * or the write lands in `<root>/stories/<rel>` while the read looks in
+ * `<root>/<rel>` and the two are different files (#3020 review H1).
+ */
+export declare function storiesRelativePath(wirePath: string): string | null;
+export declare function storyRefWithin(base: string, absolutePath: string, rules: PathRules): string | null;
 /** Lowercase-hyphen slug, capped, leading/trailing hyphens stripped; falls back
  *  to `fallback` for empty/undefined/non-ASCII input. */
 export declare function slugify(title: string | undefined, fallback?: string): string;

package/dist/core/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAgBA;yDACyD;AACzD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAsB,GAAG,MAAM,CAEzF;AAED;;0CAE0C;AAC1C,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAEhF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlE"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;GAaG;AACH;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAInE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAMlG;AAKD;yDACyD;AACzD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAsB,GAAG,MAAM,CAEzF;AAED;;0CAE0C;AAC1C,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAEhF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlE"}

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_plugin = require("./plugin-BOq5YkTl.cjs");
+const require_plugin = require("./plugin-C5JC2lNR.cjs");
 exports.TOOL_DEFINITION = require_plugin.TOOL_DEFINITION;
 exports.TOOL_NAME = require_plugin.TOOL_NAME;
 exports.executeMulmoScript = require_plugin.executeMulmoScript;

package/dist/index.js

@@ -1,2 +1,2 @@
-import { a as pluginCore, c as normalizeStoryPath, f as TOOL_DEFINITION, i as executeUpdateScript, l as slugify, n as executeMulmoScriptSave, o as validateUpdateBeatBody, p as TOOL_NAME, r as executeUpdateBeat, s as validateUpdateScriptBody, t as executeMulmoScript, u as storyFilePath } from "./plugin-CAhxJ5WM.js";
+import { a as pluginCore, c as normalizeStoryPath, d as storyFilePath, h as TOOL_NAME, i as executeUpdateScript, l as slugify, m as TOOL_DEFINITION, n as executeMulmoScriptSave, o as validateUpdateBeatBody, r as executeUpdateBeat, s as validateUpdateScriptBody, t as executeMulmoScript } from "./plugin-Jo8iGv4K.js";
 export { TOOL_DEFINITION, TOOL_NAME, executeMulmoScript, executeMulmoScriptSave, executeUpdateBeat, executeUpdateScript, normalizeStoryPath, pluginCore, slugify, storyFilePath, validateUpdateBeatBody, validateUpdateScriptBody };

package/dist/lang/de.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"de.d.ts","sourceRoot":"","sources":["../../src/lang/de.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QA+BT,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"de.d.ts","sourceRoot":"","sources":["../../src/lang/de.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAiCT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/lang/en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QA+BT,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/lang/en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAiCT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/es.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"es.d.ts","sourceRoot":"","sources":["../../src/lang/es.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QA+BT,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"es.d.ts","sourceRoot":"","sources":["../../src/lang/es.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAiCT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/fr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fr.d.ts","sourceRoot":"","sources":["../../src/lang/fr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QA+BT,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"fr.d.ts","sourceRoot":"","sources":["../../src/lang/fr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAiCT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/ja.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ja.d.ts","sourceRoot":"","sources":["../../src/lang/ja.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QA+BT,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"ja.d.ts","sourceRoot":"","sources":["../../src/lang/ja.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAiCT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/ko.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ko.d.ts","sourceRoot":"","sources":["../../src/lang/ko.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QA+BT,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"ko.d.ts","sourceRoot":"","sources":["../../src/lang/ko.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAiCT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/messages.d.ts

@@ -3,6 +3,10 @@
  *  `common.cancel`); interpolated / pluralized keys become functions. */
 export interface Messages {
     beatCount(count: number): string;
+    /** Tab: edit every beat in place. */
+    editTab: string;
+    /** Tab: the per-beat list, where audio / image / movie generation lives. */
+    mediaTab: string;
     movie: string;
     generating: string;
     rendering: string;

package/dist/lang/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/lang/messages.ts"],"names":[],"mappings":"AAAA;;yEAEyE;AACzE,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/lang/messages.ts"],"names":[],"mappings":"AAAA;;yEAEyE;AACzE,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/lang/ptBR.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ptBR.d.ts","sourceRoot":"","sources":["../../src/lang/ptBR.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,IAAI,EAAE,QA+BX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"ptBR.d.ts","sourceRoot":"","sources":["../../src/lang/ptBR.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,IAAI,EAAE,QAiCX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/lang/zh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zh.d.ts","sourceRoot":"","sources":["../../src/lang/zh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QA+BT,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"zh.d.ts","sourceRoot":"","sources":["../../src/lang/zh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAiCT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/{plugin-BOq5YkTl.cjs → plugin-C5JC2lNR.cjs}

@@ -151,6 +151,44 @@ function errorMessage(err, fallback) {
 }
 //#endregion
 //#region src/core/paths.ts
+/**
+* The wire ref for an absolute path inside a stories root, or `null` when it
+* is not inside one.
+*
+* Pure, and taking its path rules as an argument, because the case that
+* matters is unreachable on the machine this is written on. `path.relative`
+* says "not under the base" in TWO ways and only one looks like an escape:
+* `../…` is the familiar one, and across Windows DRIVES there is no relative
+* path at all, so `relative("C:\\base", "D:\\x")` answers `"D:\\x"` —
+* absolute, with no `..` for the escape check to catch. That minted
+* `stories/D:/anything`, a wire ref that reads back as a DIFFERENT file, which
+* is the substitution this function exists to refuse. Only Windows CI caught
+* it; here there is one root and always a relative route (#3015 post-merge).
+*/
+/**
+* The path INSIDE a stories root that a wire path names, or null when it does
+* not name one.
+*
+* The default root's FileOps is rooted one level up, at `<workspace>/artifacts`,
+* so there the wire path and the FileOps path are the SAME string and nothing
+* is stripped. A named root's FileOps is rooted at the stories directory
+* itself — which is what a host naturally writes, having registered exactly
+* that directory in `extraRoots` — so the `stories/` prefix has to come off,
+* or the write lands in `<root>/stories/<rel>` while the read looks in
+* `<root>/<rel>` and the two are different files (#3020 review H1).
+*/
+function storiesRelativePath(wirePath) {
+	const normalized = normalizeStoryPath(wirePath);
+	if (normalized === null) return null;
+	return normalized.slice(`${STORIES_DIR}/`.length);
+}
+function storyRefWithin(base, absolutePath, rules) {
+	const relative = rules.relative(base, absolutePath);
+	if (rules.isAbsolute(relative)) return null;
+	const rel = relative.split(rules.sep).join("/");
+	if (rel === ".." || rel.startsWith("../")) return null;
+	return rel ? `${STORIES_DIR}/${rel}` : STORIES_DIR;
+}
 var STORIES_DIR = "stories";
 var STORY_FALLBACK_SLUG = "story";
 /** Lowercase-hyphen slug, capped, leading/trailing hyphens stripped; falls back
@@ -496,12 +534,24 @@ Object.defineProperty(exports, "slugify", {
 		return slugify;
 	}
 });
+Object.defineProperty(exports, "storiesRelativePath", {
+	enumerable: true,
+	get: function() {
+		return storiesRelativePath;
+	}
+});
 Object.defineProperty(exports, "storyFilePath", {
 	enumerable: true,
 	get: function() {
 		return storyFilePath;
 	}
 });
+Object.defineProperty(exports, "storyRefWithin", {
+	enumerable: true,
+	get: function() {
+		return storyRefWithin;
+	}
+});
 Object.defineProperty(exports, "validateUpdateBeatBody", {
 	enumerable: true,
 	get: function() {
@@ -515,4 +565,4 @@ Object.defineProperty(exports, "validateUpdateScriptBody", {
 	}
 });
 
-//# sourceMappingURL=plugin-BOq5YkTl.cjs.map
+//# sourceMappingURL=plugin-C5JC2lNR.cjs.map