@craftrpgs/cli 0.1.4 → 0.1.6

package/dist/bin.js

@@ -26939,6 +26939,22 @@ var imageObjectSchema = exports_external.preprocess((input) => normalizeImageInp
   variations: exports_external.array(imageVariationSchema).max(MAX_FILE_TYPE_STATES).optional()
 }).strict());
 
+// ../shared/src/projects/manual.ts
+var MANUAL_VERSION = 1;
+var MAX_MANUAL_CHAPTERS = 50;
+var MAX_MANUAL_TITLE_LENGTH = 120;
+var MAX_MANUAL_CONTENT_LENGTH = 1e5;
+var manualChapterSchema = exports_external.object({
+  id: exports_external.string().min(1).max(64),
+  title: exports_external.string().trim().min(1).max(MAX_MANUAL_TITLE_LENGTH),
+  content: exports_external.string().max(MAX_MANUAL_CONTENT_LENGTH)
+});
+var manualSchema = exports_external.object({
+  version: exports_external.literal(MANUAL_VERSION),
+  updatedAt: exports_external.string().max(40).optional(),
+  chapters: exports_external.array(manualChapterSchema).max(MAX_MANUAL_CHAPTERS)
+});
+
 // ../shared/src/projects/project-import.ts
 var projectImportJsonValueSchema = exports_external.lazy(() => exports_external.union([
   exports_external.string(),
@@ -27027,7 +27043,9 @@ var projectImportProjectSettingsSchema = exports_external.object({
   gmToolSettings: gmToolSettingsInputSchema.optional(),
   rootMapFileReferenceId: exports_external.string().uuid().nullable().optional(),
   gm: projectImportGameMasterSettingsSchema.optional(),
-  preludeFlow: exports_external.unknown().nullable().optional()
+  preludeFlow: exports_external.unknown().nullable().optional(),
+  playerHandbook: manualSchema.nullable().optional(),
+  builderManual: manualSchema.nullable().optional()
 }).strict();
 var projectImportProjectSchema = exports_external.object({
   name: exports_external.string().trim().min(1),
@@ -41882,7 +41900,7 @@ function describeRemoteSource(resolved) {
 // package.json
 var package_default = {
   name: "@craftrpgs/cli",
-  version: "0.1.4",
+  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",
@@ -43819,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;
 }
@@ -43871,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({
@@ -44917,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"
@@ -45119,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"),
@@ -45132,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(),
@@ -45651,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;
@@ -45672,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);
@@ -45693,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;
@@ -45707,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;
 }
@@ -50485,12 +50656,19 @@ content. File type changes from the zip apply only with --include-types
 (missing types are created, drifted types updated \u2014 the server revalidates
 existing files against schema changes). Project settings changes from the
 zip's .craft/project.json apply only with --include-settings; without it,
-differing settings are listed but left untouched.
+differing settings are listed but left untouched. Every field of
+project.json is diffed and applied individually: name, description, tags,
+and settings.* \u2014 theme, image, projectIcon, attribution, gameSystemName,
+headlineLabel, headline, body, authorsNotes, gallery, galleryLayout,
+isClonable, hideHeroTitle, imageStyleInstructions, autoImageGeneration,
+defaultImageModel, gmToolSettings, rootMapFileReferenceId, preludeFlow, gm,
+playerHandbook, builderManual.
 
 --dry-run shows the full plan without writing. --exclude <referenceId>
 skips individual rows from the plan (repeatable, or comma-separated; get the
 ids from a --dry-run --json plan). --exclude-setting <key> vetoes a single
-settings change (e.g. settings.preludeFlow). Runs inside the target
+settings change, named exactly as the plan's rows are keyed (e.g.
+settings.preludeFlow, settings.playerHandbook). Runs inside the target
 project's workspace, or anywhere with --project <projectId>. The apply is
 one atomic batch: on any per-file failure (409) nothing is written and every
 failure is listed. Exits 1 while conflicts or failures remain.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craftrpgs/cli",
-  "version": "0.1.4",
+  "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",