@craftrpgs/cli 0.1.5 → 0.1.6

package/dist/bin.js

@@ -41900,7 +41900,7 @@ function describeRemoteSource(resolved) {
 // package.json
 var package_default = {
   name: "@craftrpgs/cli",
-  version: "0.1.5",
+  version: "0.1.6",
   description: "Sync Craft projects with a local folder — clone, edit with any coding agent, push back.",
   license: "UNLICENSED",
   homepage: "https://craftrpgs.com",
@@ -43837,7 +43837,8 @@ var LEADING_SLASH_RE = /^\//;
 var CONTENT_EXTENSION_RE = /\.(json|md)$/i;
 var UUID_RE3 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function entryName(entry) {
-  const base = (entry.path.split("/").at(-1) ?? entry.path).replace(CONTENT_EXTENSION_RE, "");
+  const livePath = entry.movedTo ?? entry.path;
+  const base = (livePath.split("/").at(-1) ?? livePath).replace(CONTENT_EXTENSION_RE, "");
   const suffix = `.${entry.fileType}`;
   return base.endsWith(suffix) ? base.slice(0, -suffix.length) : base;
 }
@@ -43889,6 +43890,13 @@ function resolveLink({
   if (bySlug) {
     return fromEntry(bySlug);
   }
+  const nameKey = generateSlug(trimmed.replace(/^<@|>$/g, ""));
+  if (nameKey) {
+    const byName = ledger.files.find((entry) => generateSlug(entryName(entry)) === nameKey);
+    if (byName) {
+      return fromEntry(byName);
+    }
+  }
   return { status: "unknown" };
 }
 function referenceIdToPath({
@@ -44935,6 +44943,8 @@ var FILE_DESIGNATION_METADATA_SCHEMA_VERSION_V6 = "file-designation-metadata:v6"
 var FILE_DESIGNATION_METADATA_SCHEMA_VERSION_V7 = "file-designation-metadata:v7";
 var FILE_DESIGNATION_METADATA_SCHEMA_VERSION_V8 = "file-designation-metadata:v8";
 var GAME_START_OPENING_MAX_LENGTH = 1e4;
+var GAME_START_MAX_OPENING_BEATS = 50;
+var GAME_START_MAX_CHARACTER_OPENINGS = 100;
 var GM_INSTRUCTION_TRIGGER_PHASES = [
   "post_player_message",
   "post_gm_message"
@@ -45137,10 +45147,25 @@ var GmInstructionMetadataSchema = exports_external.union([
   GmInstructionToolMetadataSchema,
   GmInstructionNarrativeMetadataSchema
 ]);
+var GameStartOpeningBeatSpeakerSchema = exports_external.discriminatedUnion("kind", [
+  exports_external.object({ kind: exports_external.literal("gm") }),
+  exports_external.object({
+    kind: exports_external.literal("character"),
+    fileReferenceId: exports_external.string().uuid(),
+    name: exports_external.string().trim().max(200).optional()
+  })
+]);
+var GameStartOpeningBeatSchema = exports_external.object({
+  id: exports_external.string().uuid(),
+  speaker: GameStartOpeningBeatSpeakerSchema,
+  text: exports_external.string().trim().min(1).max(GAME_START_OPENING_MAX_LENGTH),
+  expression: exports_external.string().trim().max(80).nullish()
+});
 var GameStartOpeningSchema = exports_external.discriminatedUnion("kind", [
   exports_external.object({
     kind: exports_external.literal("static"),
-    message: exports_external.string().trim().min(1).max(GAME_START_OPENING_MAX_LENGTH)
+    message: exports_external.string().trim().min(1).max(GAME_START_OPENING_MAX_LENGTH),
+    beats: exports_external.array(GameStartOpeningBeatSchema).max(GAME_START_MAX_OPENING_BEATS).optional()
   }),
   exports_external.object({
     kind: exports_external.literal("dynamic"),
@@ -45150,16 +45175,55 @@ var GameStartOpeningSchema = exports_external.discriminatedUnion("kind", [
 var GameStartCharacterSchema = exports_external.object({
   fileReferenceId: exports_external.string().uuid()
 });
-var GameStartMetadataSchema = exports_external.object({
+var GameStartCharacterOpeningSchema = exports_external.object({
+  characterFileReferenceId: exports_external.string().uuid(),
+  opening: GameStartOpeningSchema
+});
+function combinedOpeningLength(opening) {
+  if (opening.kind !== "static" || !opening.beats) {
+    return 0;
+  }
+  return opening.beats.reduce((total, beat) => total + beat.text.length, 0);
+}
+var GameStartMetadataObjectSchema = exports_external.object({
   startingLocationFileReferenceId: exports_external.string().uuid().nullable().optional(),
   startingCharacters: exports_external.array(GameStartCharacterSchema).default([]),
   opening: GameStartOpeningSchema.default({
     kind: "static",
     message: "Welcome to the game. What would you like to do first?"
   }),
+  characterOpenings: exports_external.array(GameStartCharacterOpeningSchema).max(GAME_START_MAX_CHARACTER_OPENINGS).default([]),
   displayOrder: exports_external.number().int().default(0),
   openingInstructions: exports_external.string().max(GAME_START_OPENING_MAX_LENGTH).default("")
 });
+var GameStartMetadataSchema = GameStartMetadataObjectSchema.superRefine((metadata, ctx) => {
+  if (combinedOpeningLength(metadata.opening) > GAME_START_OPENING_MAX_LENGTH) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["opening", "beats"],
+      message: `Combined opening beats must be at most ${GAME_START_OPENING_MAX_LENGTH} characters.`
+    });
+  }
+  const seenCharacterReferenceIds = new Set;
+  metadata.characterOpenings.forEach((characterOpening, index) => {
+    const referenceId = characterOpening.characterFileReferenceId.toLowerCase();
+    if (seenCharacterReferenceIds.has(referenceId)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["characterOpenings", index, "characterFileReferenceId"],
+        message: "Each character can only have one opening override."
+      });
+    }
+    seenCharacterReferenceIds.add(referenceId);
+    if (combinedOpeningLength(characterOpening.opening) > GAME_START_OPENING_MAX_LENGTH) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["characterOpenings", index, "opening", "beats"],
+        message: `Combined opening beats must be at most ${GAME_START_OPENING_MAX_LENGTH} characters.`
+      });
+    }
+  });
+});
 var FileDesignationMetadataV1Schema = exports_external.object({
   schemaVersionId: exports_external.literal(FILE_DESIGNATION_METADATA_SCHEMA_VERSION_V1).default(FILE_DESIGNATION_METADATA_SCHEMA_VERSION_V1),
   map: MapDataV1Schema.optional(),
@@ -45669,7 +45733,12 @@ async function runMetaGet(argv) {
   const gameStart = parsed?.gameStart ? {
     ...parsed.gameStart,
     startingLocation: pathForReference(workspace, parsed.gameStart.startingLocationFileReferenceId),
-    startingCharacters: parsed.gameStart.startingCharacters.map((character) => pathForReference(workspace, character.fileReferenceId) ?? character.fileReferenceId)
+    startingCharacters: parsed.gameStart.startingCharacters.map((character) => pathForReference(workspace, character.fileReferenceId) ?? character.fileReferenceId),
+    opening: projectOpeningForOutput(workspace, parsed.gameStart.opening),
+    characterOpenings: parsed.gameStart.characterOpenings.map((characterOpening) => ({
+      character: pathForReference(workspace, characterOpening.characterFileReferenceId) ?? characterOpening.characterFileReferenceId,
+      opening: projectOpeningForOutput(workspace, characterOpening.opening)
+    }))
   } : null;
   if (gameStart) {
     gameStart.startingLocationFileReferenceId = undefined;
@@ -45690,6 +45759,24 @@ async function runMetaGet(argv) {
   });
   return 0;
 }
+function projectOpeningForOutput(workspace, opening) {
+  if (opening.kind !== "static" || !opening.beats?.length) {
+    return opening;
+  }
+  return {
+    kind: "static",
+    beats: opening.beats.map((beat) => ({
+      speaker: beat.speaker.kind === "gm" ? "gm" : pathForReference(workspace, beat.speaker.fileReferenceId) ?? beat.speaker.fileReferenceId,
+      text: beat.text,
+      ...beat.expression ? { expression: beat.expression } : {}
+    }))
+  };
+}
+function speakerNameForLink(link) {
+  const base = link.split("/").filter(Boolean).at(-1);
+  const name = base?.split(".")[0]?.trim();
+  return name || undefined;
+}
 function translateGameStartInput(workspace, raw) {
   if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
     throw new CliError("The game start JSON must be a single object.", 2);
@@ -45711,6 +45798,55 @@ function translateGameStartInput(workspace, raw) {
     failures.push(resolution.status === "unpushed" ? `${where}: "${link}" has not been pushed yet — push it first` : `${where}: "${link}" does not resolve to a tracked file`);
     return null;
   };
+  const translateOpening = (opening, where) => {
+    if (typeof opening !== "object" || opening === null) {
+      return opening;
+    }
+    const openingInput = { ...opening };
+    if (!Array.isArray(openingInput.beats)) {
+      return openingInput;
+    }
+    const beats = openingInput.beats.map((beat, index) => {
+      if (typeof beat !== "object" || beat === null) {
+        return beat;
+      }
+      const beatInput = { ...beat };
+      if (typeof beatInput.id !== "string") {
+        beatInput.id = crypto.randomUUID();
+      }
+      const speaker = beatInput.speaker;
+      if (typeof speaker === "string" && speaker !== "gm") {
+        beatInput.speaker = {
+          kind: "character",
+          fileReferenceId: resolve6(speaker, `${where}.beats[${index}].speaker`),
+          name: speakerNameForLink(speaker)
+        };
+      } else if (speaker === "gm") {
+        beatInput.speaker = { kind: "gm" };
+      } else if (typeof speaker === "object" && speaker !== null && "character" in speaker) {
+        const { character, ...speakerRest } = speaker;
+        beatInput.speaker = {
+          kind: "character",
+          name: typeof character === "string" ? speakerNameForLink(character) : undefined,
+          ...speakerRest,
+          fileReferenceId: resolve6(character, `${where}.beats[${index}].speaker.character`)
+        };
+      }
+      return beatInput;
+    });
+    openingInput.beats = beats;
+    if (typeof openingInput.message !== "string" && openingInput.kind === "static") {
+      const projectable = beats.filter((beat) => typeof beat === "object" && beat !== null && typeof beat.text === "string");
+      openingInput.message = projectable.map((beat) => {
+        const speaker = beat.speaker;
+        const name = speaker && speaker.kind === "character" && typeof speaker.name === "string" ? speaker.name : null;
+        return name ? `${name}: ${beat.text}` : beat.text;
+      }).join(`
+
+`).slice(0, GAME_START_OPENING_MAX_LENGTH);
+    }
+    return openingInput;
+  };
   if ("startingLocation" in input) {
     input.startingLocationFileReferenceId = resolve6(input.startingLocation, "startingLocation");
     input.startingLocation = undefined;
@@ -45725,11 +45861,28 @@ function translateGameStartInput(workspace, raw) {
       return character;
     });
   }
+  if ("opening" in input) {
+    input.opening = translateOpening(input.opening, "opening");
+  }
+  if (Array.isArray(input.characterOpenings)) {
+    input.characterOpenings = input.characterOpenings.map((characterOpening, index) => {
+      if (typeof characterOpening !== "object" || characterOpening === null) {
+        return characterOpening;
+      }
+      const entry = { ...characterOpening };
+      if ("character" in entry) {
+        entry.characterFileReferenceId = resolve6(entry.character, `characterOpenings[${index}].character`);
+        entry.character = undefined;
+      }
+      entry.opening = translateOpening(entry.opening, `characterOpenings[${index}].opening`);
+      return entry;
+    });
+  }
   if (failures.length > 0) {
     throw new CliError(`Nothing was saved — some references do not resolve to pushed files:
 ` + `${failures.map((f) => `  ${f}`).join(`
 `)}
-` + "Use workspace paths, slug.type tokens, or referenceIds of PUSHED files.", 2);
+` + "Use workspace paths (preferred), slug.type tokens, slugs, or file names of PUSHED files.", 2);
   }
   return input;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craftrpgs/cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Sync Craft projects with a local folder — clone, edit with any coding agent, push back.",
   "license": "UNLICENSED",
   "homepage": "https://craftrpgs.com",