spawnpack 0.1.4 → 0.1.6

package/README.md

@@ -16,10 +16,11 @@ It generates BP/RP structure, optional Script API setup, optional rgl integratio
   - `@minecraft/math`
 - Optional `rgl` setup for faster Bedrock builds
 - Optional marketplace add-on structure using nested `namespace/projectId` folders in BP/RP content directories
-- Optional Rockide recommendation during setup
-- Optional AI setup:
-  - `CLAUDE.md`
-  - `.mcp.json`
+- Optional Rockide recommendation during setup
+- Optional AI setup:
+  - `CLAUDE.md` for Claude
+  - `AGENTS.md` for Other
+  - `.mcp.json`
 
 ## Runtime Requirement
 
@@ -78,7 +79,7 @@ The wizard walks through:
 6. Script packages
 7. `rgl` toggle
 8. Rockide toggle
-9. AI setup toggle
+9. AI setup choice (`None`, `Claude`, or `Other`)
 10. Review screen and generation
 
 ## Generated project options
@@ -92,9 +93,10 @@ Depending on your choices, Spawnpack can generate:
 - `package.json`
 - `tsconfig.json`
 - `dprint.json`
-- `config.json` for `rgl`
-- `CLAUDE.md`
-- `.mcp.json`
+- `config.json` for `rgl`
+- `CLAUDE.md`
+- `AGENTS.md`
+- `.mcp.json`
 
 ## Marketplace structure mode
 
@@ -120,9 +122,11 @@ Spawnpack fetches the latest stable npm versions for:
 - `@minecraft/vanilla-data`
 - `@minecraft/math`
 
-If version lookup fails, it falls back to baked stable defaults.
-
-## Development
+If version lookup fails, it falls back to baked stable defaults.
+
+Only runtime Script API modules, currently `@minecraft/server` and `@minecraft/server-ui`, are written to the behavior pack manifest. npm-side libraries such as `@minecraft/vanilla-data` and `@minecraft/math` stay in the generated `package.json` for imports and bundling.
+
+## Development
 
 ```bash
 bun install
@@ -134,10 +138,11 @@ bun run build
 
 The npm package is configured to publish only:
 
-- `dist/spawnpack.js`
-- `templates/CLAUDE.md`
-- `README.md`
-- `LICENSE`
+- `dist/spawnpack.js`
+- `templates/CLAUDE.md`
+- `templates/AGENTS.md`
+- `README.md`
+- `LICENSE`
 - `package.json`
 
 Internal planning files, Serena state, and local AI/project notes are excluded from the published tarball.

package/dist/spawnpack.js

@@ -1571,13 +1571,22 @@ function getScriptDirectorySegments(config) {
 function getScriptEntryPath(config) {
   return [...getScriptDirectorySegments(config), "main.js"].join("/");
 }
+function getAiDocFilename(aiSetup) {
+  if (aiSetup === "claude") {
+    return "CLAUDE.md";
+  }
+  if (aiSetup === "other") {
+    return "AGENTS.md";
+  }
+  return null;
+}
 
 // src/engine/manifests.ts
 var PACK_VERSION = [1, 0, 0];
 function getAuthors(author) {
   return author.trim() === "" ? [] : [author];
 }
-function getScriptDependencies(config, versions) {
+function getManifestScriptDependencies(config, versions) {
   const dependencies = [];
   if (config.scriptPackages.server) {
     dependencies.push({ module_name: "@minecraft/server", version: versions.server });
@@ -1585,12 +1594,6 @@ function getScriptDependencies(config, versions) {
   if (config.scriptPackages.serverUi) {
     dependencies.push({ module_name: "@minecraft/server-ui", version: versions.serverUi });
   }
-  if (config.scriptPackages.vanillaData) {
-    dependencies.push({ module_name: "@minecraft/vanilla-data", version: versions.vanillaData });
-  }
-  if (config.scriptPackages.math) {
-    dependencies.push({ module_name: "@minecraft/math", version: versions.math });
-  }
   return dependencies;
 }
 function getBpModules(config) {
@@ -1609,7 +1612,7 @@ function getBpModules(config) {
 function generateBpManifest(config, bpUuid, rpUuid, versions) {
   const dependencies = [{ uuid: rpUuid, version: PACK_VERSION }];
   if (config.scripting !== "none") {
-    dependencies.push(...getScriptDependencies(config, versions));
+    dependencies.push(...getManifestScriptDependencies(config, versions));
   }
   return {
     format_version: VERSIONS.manifestFormat,
@@ -1891,9 +1894,10 @@ function generateReadme(config) {
   const runtimeEntry = config.scripting === "none" ? "None" : `packs/BP/${getScriptEntryPath(config)}`;
   const installStep = config.scripting !== "none" ? "1. Install dependencies with `bun install` or `npm install`." : "1. No package install is required for this scaffold.";
   const buildSteps = config.scripting === "none" ? "2. Edit your BP/RP JSON files directly inside `packs/`." : config.useRgl ? "2. Run `rgl watch` while developing to rebuild and export your add-on automatically.\n3. Run `rgl run build` when you want a production build." : config.scripting === "typescript" ? "2. Write your gameplay scripts in `data/scripts/`.\n3. Run `bun run build` or `npm run build` to compile TypeScript into `packs/BP/scripts/`." : "2. Write your gameplay scripts in `packs/BP/scripts/` and let Minecraft copy the pack into `com.mojang`.";
-  const aiSection = config.useAi ? `## AI Tooling
+  const aiDocFilename = getAiDocFilename(config.aiSetup);
+  const aiSection = aiDocFilename !== null ? `## AI Tooling
 
-Spawnpack generated \`CLAUDE.md\` and \`.mcp.json\` for AI-assisted development.
+Spawnpack generated \`${aiDocFilename}\` and \`.mcp.json\` for AI-assisted development.
 
 Add your own API keys before using the MCP tools:
 
@@ -1904,6 +1908,11 @@ Add your own API keys before using the MCP tools:
 
 Update the placeholder values in \`.mcp.json\` with your own tokens.
 
+` : "";
+  const scriptPackageSection = config.scripting !== "none" ? `## Script Packages
+
+Selected npm packages are installed through \`package.json\`. Only runtime Script API modules such as \`@minecraft/server\` and \`@minecraft/server-ui\` are written to \`packs/BP/manifest.json\`; npm-side libraries such as \`@minecraft/vanilla-data\` and \`@minecraft/math\` are imported and bundled from \`package.json\`.
+
 ` : "";
   return `# ${config.projectName}
 
@@ -1928,7 +1937,7 @@ ${config.scripting === "none" ? "This project was generated without Script API s
 - Add additional JavaScript files beside \`main.js\` and import them from there.
 - Minecraft copies the BP/RP content directly into \`com.mojang\`, so there is no TypeScript compile step.`}
 
-${config.useRgl ? `## rgl Workflow
+${scriptPackageSection}${config.useRgl ? `## rgl Workflow
 
 - \`rgl watch\` rebuilds your scripts and exports your add-on while you work.
 - \`rgl run\` builds a development export once.
@@ -2162,30 +2171,37 @@ async function generateMcpConfig(projectPath) {
 // src/provisioning/ai.ts
 var AI_EXCLUDE_LINES = [
   "# AI tool files",
-  "CLAUDE.md",
-  "AGENTS.md",
-  ".mcp.json",
-  ".claude/",
-  ".serena/"
-];
-var CLAUDE_TEMPLATE_URLS = [
-  new URL("../templates/CLAUDE.md", import.meta.url),
-  new URL("../../templates/CLAUDE.md", import.meta.url)
+  "/CLAUDE.md",
+  "/AGENTS.md",
+  "/.mcp.json",
+  "/.claude/",
+  "/.serena/"
 ];
-async function createClaudeMdContent() {
-  for (const templateUrl of CLAUDE_TEMPLATE_URLS) {
+function getTemplateUrls(filename) {
+  return [
+    new URL(`../templates/${filename}`, import.meta.url),
+    new URL(`../../templates/${filename}`, import.meta.url)
+  ];
+}
+async function createAiDocContent(filename) {
+  const templateUrls = getTemplateUrls(filename);
+  for (const templateUrl of templateUrls) {
     const templateFile = Bun.file(templateUrl);
     const exists = await templateFile.exists().then((value) => value, () => false);
     if (exists) {
       return await templateFile.text();
     }
   }
-  return await Bun.file(CLAUDE_TEMPLATE_URLS[0]).text();
+  return await Bun.file(templateUrls[0]).text();
 }
-async function generateClaudeMd(projectPath) {
-  const claudePath = join3(projectPath, "CLAUDE.md");
-  const content = await createClaudeMdContent();
-  await Bun.write(claudePath, content).then(() => {
+async function generateAiDoc(projectPath, aiSetup) {
+  const filename = getAiDocFilename(aiSetup);
+  if (filename === null) {
+    return;
+  }
+  const outputPath = join3(projectPath, filename);
+  const content = await createAiDocContent(filename);
+  await Bun.write(outputPath, content).then(() => {
     return;
   }, () => {
     return;
@@ -2218,8 +2234,11 @@ async function setupGitExcludes(projectPath) {
     return;
   });
 }
-async function setupAi(projectPath) {
-  await generateClaudeMd(projectPath);
+async function setupAi(projectPath, aiSetup) {
+  if (aiSetup === "none") {
+    return;
+  }
+  await generateAiDoc(projectPath, aiSetup);
   await setupGitExcludes(projectPath);
   await generateMcpConfig(projectPath);
 }
@@ -2317,6 +2336,15 @@ function getScriptingLabel(choice) {
   }
   return "None";
 }
+function getAiSetupLabel(choice) {
+  if (choice === "claude") {
+    return "Claude";
+  }
+  if (choice === "other") {
+    return "Other";
+  }
+  return "None";
+}
 function getSelectedPackages(scriptPackages) {
   const packages = [];
   if (scriptPackages.server) {
@@ -2423,8 +2451,9 @@ function showFolderTree(config) {
   if (config.useRgl) {
     lines.push(import_picocolors.default.dim("├─ config.json"));
   }
-  if (config.useAi) {
-    lines.push(import_picocolors.default.dim("├─ CLAUDE.md"));
+  const aiDocFilename = getAiDocFilename(config.aiSetup);
+  if (aiDocFilename !== null) {
+    lines.push(import_picocolors.default.dim(`├─ ${aiDocFilename}`));
     lines.push(import_picocolors.default.dim("├─ .mcp.json"));
   }
   lines.push(import_picocolors.default.dim("├─ .gitignore"));
@@ -2452,7 +2481,7 @@ function showReview(config) {
     `${border}  ${import_picocolors.default.dim(padLabel("Packages:"))} ${packages}`,
     `${border}  ${import_picocolors.default.dim(padLabel("rgl:"))} ${formatToggle(config.useRgl)}`,
     `${border}  ${import_picocolors.default.dim(padLabel("Rockide:"))} ${formatToggle(config.installRockide)}`,
-    `${border}  ${import_picocolors.default.dim(padLabel("AI Setup:"))} ${formatToggle(config.useAi)}`,
+    `${border}  ${import_picocolors.default.dim(padLabel("AI Setup:"))} ${formatValue(getAiSetupLabel(config.aiSetup))}`,
     "",
     `${border}  ${teal(import_picocolors.default.bold("Planned structure"))}`,
     ...showFolderTree(config).split(`
@@ -2483,7 +2512,7 @@ function showPostGeneration(config) {
   if (config.scripting === "none" && !config.useRgl) {
     usefulCommands.push(`  ${import_picocolors.default.dim("No extra build commands needed for this scaffold")}`);
   }
-  if (config.useAi) {
+  if (config.aiSetup !== "none") {
     usefulCommands.push("");
     usefulCommands.push(`${teal(import_picocolors.default.bold("Note"))} ${import_picocolors.default.dim("Add your own Exa and Browser Use MCP API keys in .mcp.json before using the AI tooling.")}`);
     usefulCommands.push(`  ${import_picocolors.default.dim("Exa:")} ${import_picocolors.default.cyan("https://dashboard.exa.ai/api-keys")}`);
@@ -2657,11 +2686,16 @@ async function runWizard() {
   if (q(installRockide2)) {
     return abortWizard();
   }
-  const useAi = await ot2({
-    message: `${import_picocolors2.default.bold("AI setup?")} ${import_picocolors2.default.dim("generate CLAUDE.md with Bedrock development rules")}`,
-    initialValue: false
+  const aiSetup = await _t({
+    message: import_picocolors2.default.bold("AI setup"),
+    initialValue: "none",
+    options: [
+      { value: "none", label: "None", hint: "no AI docs or MCP config" },
+      { value: "claude", label: "Claude", hint: "generate CLAUDE.md and .mcp.json" },
+      { value: "other", label: "Other", hint: "generate AGENTS.md and .mcp.json" }
+    ]
   });
-  if (q(useAi)) {
+  if (q(aiSetup)) {
     return abortWizard();
   }
   const config = {
@@ -2674,7 +2708,7 @@ async function runWizard() {
     scriptPackages: scripting === "none" ? { ...DEFAULT_SCRIPT_PACKAGES } : scriptPackages,
     useMarketplaceStructure,
     useRgl: scripting === "none" ? false : useRgl,
-    useAi,
+    aiSetup,
     installRockide: installRockide2
   };
   showReview(config);
@@ -2703,8 +2737,8 @@ if (config === null) {
 var generation = fe();
 generation.start(teal3("Generating your Bedrock addon scaffold..."));
 await generateProject(config);
-if (config.useAi) {
-  await setupAi(config.destination);
+if (config.aiSetup !== "none") {
+  await setupAi(config.destination, config.aiSetup);
 }
 await runProvisioning(config);
 generation.stop(import_picocolors3.default.green("Spawnpack scaffold generated."));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "spawnpack",
-    "version": "0.1.4",
+    "version": "0.1.6",
     "description": "Minecraft Bedrock addon project generator — scaffold your BP+RP in seconds",
     "author": "veedy-dev",
     "license": "MIT",
@@ -12,6 +12,7 @@
         "bin/spawnpack.js",
         "dist/spawnpack.js",
         "templates/CLAUDE.md",
+        "templates/AGENTS.md",
         "README.md",
         "LICENSE",
         "package.json"