@craftrpgs/cli 0.1.2 → 0.1.3

package/dist/bin.js

@@ -27454,6 +27454,7 @@ function cliPushResponseForOpsSchema(ops) {
     }
   });
 }
+var MAX_IMPORT_ZIP_BYTES = 50 * 1024 * 1024;
 var cliImportOptionsSchema = exports_external.object({
   dryRun: exports_external.boolean().default(false),
   overwrite: exports_external.boolean().default(false),
@@ -41858,7 +41859,7 @@ function describeRemoteSource(resolved) {
 // package.json
 var package_default = {
   name: "@craftrpgs/cli",
-  version: "0.1.2",
+  version: "0.1.3",
   description: "Sync Craft projects with a local folder — clone, edit with any coding agent, push back.",
   license: "UNLICENSED",
   homepage: "https://craftrpgs.com",
@@ -42280,6 +42281,36 @@ async function defaultCloneDir(base) {
   }
   throw new CliError(`Could not find a free directory name near ${base}; pass [dir] explicitly.`, 2);
 }
+async function assertUsableCloneTarget({
+  targetDir,
+  zipFilePaths
+}) {
+  if (!existsSync4(targetDir)) {
+    return;
+  }
+  const existing = await readdir3(targetDir);
+  const visible = existing.filter((name) => !shouldSkipWorkspaceName(name));
+  const collisions = zipFilePaths.filter((relative2) => {
+    try {
+      return existsSync4(joinUnderWorkspaceRoot(targetDir, relative2));
+    } catch {
+      return false;
+    }
+  });
+  if (visible.length === 0 && collisions.length === 0) {
+    return;
+  }
+  throw new CliError([
+    `Refusing to clone into ${targetDir}:`,
+    ...visible.map((name) => `  ${name} — pre-existing and would be mixed into the new workspace`),
+    ...collisions.map((relative2) => `  ${relative2} — the project snapshot would overwrite it`),
+    "Entries the workspace scanner ignores (.git/, .gitignore, other dotfiles) may pre-exist; move the listed items or pick a different [dir]."
+  ].join(`
+`), 2);
+}
+function nextStepHint(targetDir) {
+  return targetDir === process.cwd() ? "Next: run `craft status`." : "Next: cd in and run `craft status`.";
+}
 async function downloadAndUnpackSnapshot({
   client,
   projectId,
@@ -42290,12 +42321,8 @@ async function downloadAndUnpackSnapshot({
   const paths = Object.keys(entries);
   const rootDir = zipRootDir(paths);
   const targetDir = dirArg ? resolve4(dirArg) : await defaultCloneDir(resolve4(rootDir));
-  if (existsSync4(targetDir)) {
-    const existing = await readdir3(targetDir);
-    if (existing.length > 0) {
-      throw new CliError(`Refusing to clone into non-empty directory ${targetDir}`, 2);
-    }
-  }
+  const zipFilePaths = paths.filter((path) => !path.endsWith("/")).map((path) => path.slice(rootDir.length + 1)).filter((relative2) => relative2 !== "");
+  await assertUsableCloneTarget({ targetDir, zipFilePaths });
   await mkdir3(targetDir, { recursive: true });
   let fileCount = 0;
   for (const [path, bytes] of Object.entries(entries)) {
@@ -42362,12 +42389,15 @@ async function runClone(argv) {
   } else {
     printLines([
       `Cloned project ${target.projectId} into ${targetDir} (${fileCount} files).`,
-      "Next: cd in and run `craft status`."
+      nextStepHint(targetDir)
     ]);
   }
   return 0;
 }
 
+// src/commands/create.ts
+import { basename } from "node:path";
+
 // src/commands/clone.ts
 import { existsSync as existsSync5 } from "node:fs";
 import { mkdir as mkdir4, readdir as readdir4, writeFile as writeFile4 } from "node:fs/promises";
@@ -42401,6 +42431,36 @@ async function defaultCloneDir2(base) {
   }
   throw new CliError(`Could not find a free directory name near ${base}; pass [dir] explicitly.`, 2);
 }
+async function assertUsableCloneTarget2({
+  targetDir,
+  zipFilePaths
+}) {
+  if (!existsSync5(targetDir)) {
+    return;
+  }
+  const existing = await readdir4(targetDir);
+  const visible = existing.filter((name) => !shouldSkipWorkspaceName(name));
+  const collisions = zipFilePaths.filter((relative2) => {
+    try {
+      return existsSync5(joinUnderWorkspaceRoot(targetDir, relative2));
+    } catch {
+      return false;
+    }
+  });
+  if (visible.length === 0 && collisions.length === 0) {
+    return;
+  }
+  throw new CliError([
+    `Refusing to clone into ${targetDir}:`,
+    ...visible.map((name) => `  ${name} — pre-existing and would be mixed into the new workspace`),
+    ...collisions.map((relative2) => `  ${relative2} — the project snapshot would overwrite it`),
+    "Entries the workspace scanner ignores (.git/, .gitignore, other dotfiles) may pre-exist; move the listed items or pick a different [dir]."
+  ].join(`
+`), 2);
+}
+function nextStepHint2(targetDir) {
+  return targetDir === process.cwd() ? "Next: run `craft status`." : "Next: cd in and run `craft status`.";
+}
 async function downloadAndUnpackSnapshot2({
   client,
   projectId,
@@ -42411,12 +42471,8 @@ async function downloadAndUnpackSnapshot2({
   const paths = Object.keys(entries);
   const rootDir = zipRootDir2(paths);
   const targetDir = dirArg ? resolve5(dirArg) : await defaultCloneDir2(resolve5(rootDir));
-  if (existsSync5(targetDir)) {
-    const existing = await readdir4(targetDir);
-    if (existing.length > 0) {
-      throw new CliError(`Refusing to clone into non-empty directory ${targetDir}`, 2);
-    }
-  }
+  const zipFilePaths = paths.filter((path) => !path.endsWith("/")).map((path) => path.slice(rootDir.length + 1)).filter((relative2) => relative2 !== "");
+  await assertUsableCloneTarget2({ targetDir, zipFilePaths });
   await mkdir4(targetDir, { recursive: true });
   let fileCount = 0;
   for (const [path, bytes] of Object.entries(entries)) {
@@ -42444,6 +42500,10 @@ async function downloadAndUnpackSnapshot2({
 }
 
 // src/commands/create.ts
+var DIRECTORY_NAME_SEPARATORS = /[-_\s]+/;
+function projectNameFromDirectory(dirName) {
+  return dirName.split(DIRECTORY_NAME_SEPARATORS).filter((word) => word.length > 0).map((word) => (word[0]?.toUpperCase() ?? "") + word.slice(1)).join(" ");
+}
 async function runCreate(argv) {
   const args = parseCommandArgs({
     argv,
@@ -42455,10 +42515,19 @@ async function runCreate(argv) {
     },
     maxPositionals: 2
   });
-  const [name, dirArg] = args.positionals;
+  const [nameArg, dirPositional] = args.positionals;
+  if (!nameArg) {
+    throw new CliError('Usage: craft create <name> [dir] — quote names with spaces, e.g. craft create "My World" (or `craft create .` to create here, named after this directory)', 2);
+  }
+  if (nameArg === "." && dirPositional !== undefined) {
+    throw new CliError('`craft create .` takes no [dir] — "." already means "create in the current directory, named after it". To pick the name yourself: craft create "My Name" .', 2);
+  }
+  const namedAfterCwd = nameArg === ".";
+  const name = namedAfterCwd ? projectNameFromDirectory(basename(process.cwd())) : nameArg;
   if (!name) {
-    throw new CliError('Usage: craft create <name> [dir] — quote names with spaces, e.g. craft create "My World"', 2);
+    throw new CliError('Could not derive a project name from the current directory — pass one explicitly: craft create "My World" .', 2);
   }
+  const dirArg = namedAfterCwd ? "." : dirPositional;
   const resolved = resolveRemote({ flagRemote: stringFlag(args, "remote") });
   const remote = resolved.remote;
   const client = createCliClient({
@@ -42485,6 +42554,7 @@ async function runCreate(argv) {
     printJson({
       projectId: created.projectId,
       containerId: created.containerId,
+      name,
       remote,
       dir: targetDir,
       files: fileCount
@@ -42492,8 +42562,11 @@ async function runCreate(argv) {
   } else {
     printLines([
       `Created project "${name}" (${created.projectId}) on ${remote} ` + `(${describeRemoteSource(resolved)}).`,
+      ...namedAfterCwd ? [
+        'Named after the current directory — `craft create "My Name" .` picks the name yourself.'
+      ] : [],
       `Cloned into ${targetDir} (${fileCount} files).`,
-      "Next: cd in and run `craft status`."
+      nextStepHint2(targetDir)
     ]);
   }
   return 0;
@@ -43495,7 +43568,7 @@ async function workspacePin() {
 
 // src/commands/image.ts
 import { readFile as readFile6 } from "node:fs/promises";
-import { basename, isAbsolute as isAbsolute2 } from "node:path";
+import { basename as basename2, isAbsolute as isAbsolute2 } from "node:path";
 
 // ../shared/src/ledger-constants.ts
 var SYSTEM_ACCOUNTS = {
@@ -43753,7 +43826,7 @@ async function runImageUpload(argv) {
     })
   });
   const form = new FormData;
-  form.append("file", new File([new Uint8Array(bytes)], basename(filePath)));
+  form.append("file", new File([new Uint8Array(bytes)], basename2(filePath)));
   let result;
   try {
     result = await client.uploadImage({
@@ -43768,7 +43841,7 @@ async function runImageUpload(argv) {
     return 0;
   }
   printLines([
-    `Uploaded ${basename(filePath)} (${result.width}x${result.height}, ${Math.round(result.bytes / 1024)}KB as webp):`,
+    `Uploaded ${basename2(filePath)} (${result.width}x${result.height}, ${Math.round(result.bytes / 1024)}KB as webp):`,
     `  ${result.image.url ?? "<no url returned>"}`,
     "",
     `To use it, set this object as the file's "image" field and push:`,
@@ -43850,7 +43923,7 @@ async function runImageGenerate(argv) {
   const referenceImageUrls = [];
   for (const reference of localReferenceImages) {
     const form = new FormData;
-    form.append("file", new File([new Uint8Array(reference.bytes)], basename(reference.path)));
+    form.append("file", new File([new Uint8Array(reference.bytes)], basename2(reference.path)));
     let uploaded;
     try {
       uploaded = await client.uploadImage({
@@ -43953,7 +44026,7 @@ function toActionableError(error48, operation = "generation") {
 
 // src/commands/import.ts
 import { readFile as readFile7 } from "node:fs/promises";
-import { basename as basename2 } from "node:path";
+import { basename as basename3 } from "node:path";
 async function runImport(argv) {
   const args = parseCommandArgs({
     argv,
@@ -43986,7 +44059,7 @@ async function runImport(argv) {
     throw new CliError(`Could not read "${zipPath}": ${error48 instanceof Error ? error48.message : String(error48)}`, 2);
   }
   const form = new FormData;
-  form.append("file", new File([new Uint8Array(zipBytes)], basename2(zipPath)));
+  form.append("file", new File([new Uint8Array(zipBytes)], basename3(zipPath)));
   if (args.booleans.has("dry-run")) {
     form.append("dryRun", "true");
   }
@@ -49800,8 +49873,11 @@ var AUTH_COMMAND_LINES_DEV = `  login [--remote <env|origin>]  Sign in with your
                                  Show or set the environment used from this directory
 `;
 var HELP_COMMAND_LINES = `  clone <projectIdOrUrl> [dir]   Download a project as a local workspace
+                                 ([dir] may be "." for the current directory)
   create <name> [dir] [--description "..."] [--empty]
-                                 Create a new project and clone it locally
+                                 Create a new project and clone it locally:
+                                 craft create "My World" .   \u2192 current directory
+                                 craft create .              \u2192 here, named after the dir
                                  (--empty skips the starter file types)
   projects                       List the projects your account owns
   log <path> [--limit <n>]       Show a file's version history (newest first)
@@ -49882,12 +49958,28 @@ Sign out \u2014 forget the credentials stored on this machine.
   clone: `Usage: craft clone <projectIdOrUrl> [dir]
 
 Download a project as a local workspace. Accepts a project id or a pasted
-project URL. [dir] defaults to a folder named after the project.
+project URL. [dir] defaults to a new folder named after the project; pass
+"." (or any path) to choose the destination. The target may already hold
+entries the workspace ignores (.git/, .gitignore, other dotfiles), but
+nothing the snapshot would mix with or overwrite.
+
+Examples:
+  craft clone <id>              # into ./<project-name>/
+  craft clone <id> my-dir       # into ./my-dir/
+  craft clone <id> .            # into the current directory
 `,
   create: `Usage: craft create <name> [dir] [--description "..."] [--empty]
+       craft create .           (create here, named after the current directory)
 
 Create a new project on the server and clone it into [dir] (defaults to a
-folder named after the project).
+new folder named after the project; "." uses the current directory \u2014
+pre-existing dotfiles like .git/ are fine).
+
+Examples:
+  craft create "My World"           # creates ./my-world/
+  craft create "My World" my-dir    # creates ./my-dir/
+  craft create "My World" .         # into the current directory
+  craft create .                    # here, named after the directory
 
 By default the project seeds the standard starter file types (Character,
 Location, Equipment, Game Start, GM Instructions) plus example files \u2014
@@ -50155,13 +50247,29 @@ A cloned workspace always syncs with the server it was cloned from.
 
 Download a project as a local workspace. A full project URL carries its
 origin; a bare project id uses the current environment (see \`craft help
-env\`). [dir] defaults to a folder named after the project.
+env\`). [dir] defaults to a new folder named after the project; pass "."
+(or any path) to choose the destination. The target may already hold
+entries the workspace ignores (.git/, .gitignore, other dotfiles), but
+nothing the snapshot would mix with or overwrite.
+
+Examples:
+  craft clone <id>              # into ./<project-name>/
+  craft clone <id> my-dir       # into ./my-dir/
+  craft clone <id> .            # into the current directory
 `,
   create: `Usage: craft create <name> [dir] [--description "..."] [--empty]
+       craft create .           (create here, named after the current directory)
 
 Create a new project on the server and clone it into [dir] (defaults to a
-folder named after the project). Targets the current environment \u2014 check
-with \`craft env\`.
+new folder named after the project; "." uses the current directory \u2014
+pre-existing dotfiles like .git/ are fine). Targets the current
+environment \u2014 check with \`craft env\`.
+
+Examples:
+  craft create "My World"           # creates ./my-world/
+  craft create "My World" my-dir    # creates ./my-dir/
+  craft create "My World" .         # into the current directory
+  craft create .                    # here, named after the directory
 
 By default the project seeds the standard starter file types (Character,
 Location, Equipment, Game Start, GM Instructions) plus example files \u2014

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@craftrpgs/cli",
-  "version": "0.1.2",
-  "description": "Sync Craft projects with a local folder \u2014 clone, edit with any coding agent, push back.",
+  "version": "0.1.3",
+  "description": "Sync Craft projects with a local folder — clone, edit with any coding agent, push back.",
   "license": "UNLICENSED",
   "homepage": "https://craftrpgs.com",
   "type": "module",