@joycostudio/scripts 0.0.3 → 0.0.5

package/README.md

@@ -10,6 +10,7 @@ pnpx @joycostudio/scripts compress ./images ./output --quality 80
 pnpx @joycostudio/scripts resize ./images ./output --width 1920 --height 1080
 pnpx @joycostudio/scripts sequence -z 4 ./frames ./output/frame_%n.png
 pnpx @joycostudio/scripts fix-svg src --dry --print
+pnpx @joycostudio/scripts agents -s codex
 ```
 
 For local development, build the CLI before running it directly:

package/dist/cli.js

@@ -502,10 +502,10 @@ var require_help = __commonJS({
         function formatList(textArray) {
           return textArray.join("\n").replace(/^/gm, " ".repeat(itemIndentWidth));
         }
-        let output = [`Usage: ${helper.commandUsage(cmd)}`, ""];
+        let output2 = [`Usage: ${helper.commandUsage(cmd)}`, ""];
         const commandDescription = helper.commandDescription(cmd);
         if (commandDescription.length > 0) {
-          output = output.concat([
+          output2 = output2.concat([
             helper.wrap(commandDescription, helpWidth, 0),
             ""
           ]);
@@ -517,7 +517,7 @@ var require_help = __commonJS({
           );
         });
         if (argumentList.length > 0) {
-          output = output.concat(["Arguments:", formatList(argumentList), ""]);
+          output2 = output2.concat(["Arguments:", formatList(argumentList), ""]);
         }
         const optionList = helper.visibleOptions(cmd).map((option) => {
           return formatItem(
@@ -526,7 +526,7 @@ var require_help = __commonJS({
           );
         });
         if (optionList.length > 0) {
-          output = output.concat(["Options:", formatList(optionList), ""]);
+          output2 = output2.concat(["Options:", formatList(optionList), ""]);
         }
         if (this.showGlobalOptions) {
           const globalOptionList = helper.visibleGlobalOptions(cmd).map((option) => {
@@ -536,7 +536,7 @@ var require_help = __commonJS({
             );
           });
           if (globalOptionList.length > 0) {
-            output = output.concat([
+            output2 = output2.concat([
               "Global Options:",
               formatList(globalOptionList),
               ""
@@ -550,9 +550,9 @@ var require_help = __commonJS({
           );
         });
         if (commandList.length > 0) {
-          output = output.concat(["Commands:", formatList(commandList), ""]);
+          output2 = output2.concat(["Commands:", formatList(commandList), ""]);
         }
-        return output.join("\n");
+        return output2.join("\n");
       }
       /**
        * Calculate the pad width from the maximum term length.
@@ -964,8 +964,8 @@ var require_command = __commonJS({
   "../node_modules/.pnpm/commander@12.1.0/node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter = require("node:events").EventEmitter;
     var childProcess = require("node:child_process");
-    var path6 = require("node:path");
-    var fs5 = require("node:fs");
+    var path8 = require("node:path");
+    var fs7 = require("node:fs");
     var process2 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1897,11 +1897,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path6.resolve(baseDir, baseName);
-          if (fs5.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path6.extname(baseName))) return void 0;
+          const localBin = path8.resolve(baseDir, baseName);
+          if (fs7.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path8.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs5.existsSync(`${localBin}${ext}`)
+            (ext) => fs7.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -1913,21 +1913,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs5.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs7.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path6.resolve(
-            path6.dirname(resolvedScriptPath),
+          executableDir = path8.resolve(
+            path8.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path6.basename(
+            const legacyName = path8.basename(
               this._scriptPath,
-              path6.extname(this._scriptPath)
+              path8.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -1938,7 +1938,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path6.extname(executableFile));
+        launchWithNode = sourceExt.includes(path8.extname(executableFile));
         let proc;
         if (process2.platform !== "win32") {
           if (launchWithNode) {
@@ -2778,7 +2778,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path6.basename(filename, path6.extname(filename));
+        this._name = path8.basename(filename, path8.extname(filename));
         return this;
       }
       /**
@@ -2792,9 +2792,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path7) {
-        if (path7 === void 0) return this._executableDir;
-        this._executableDir = path7;
+      executableDir(path9) {
+        if (path9 === void 0) return this._executableDir;
+        this._executableDir = path9;
         return this;
       }
       /**
@@ -3052,7 +3052,7 @@ var {
 // package.json
 var package_default = {
   name: "@joycostudio/scripts",
-  version: "0.0.3",
+  version: "0.0.5",
   description: "Joyco utility scripts as a pnpx CLI",
   bin: {
     scripts: "dist/cli.js"
@@ -3503,6 +3503,179 @@ function register4(program2) {
   addExamples(command, ["scripts fix-svg src", "scripts fix-svg src --dry --print"]);
 }
 
+// src/commands/agents.ts
+var import_path7 = __toESM(require("path"));
+var import_promises5 = __toESM(require("fs/promises"));
+var import_promises6 = require("node:readline/promises");
+var import_node_process = require("node:process");
+
+// src/core/agents.ts
+var import_promises4 = __toESM(require("fs/promises"));
+var import_path6 = __toESM(require("path"));
+var AGENTS_URL = "https://registry.joyco.studio/AGENTS.md";
+var agentStrategies = {
+  codex: {
+    defaultPath: "AGENTS.md",
+    description: "Codex reads AGENTS.md from the project root."
+  },
+  claude: {
+    defaultPath: "CLAUDE.md",
+    description: "Claude Code reads CLAUDE.md from the project root."
+  },
+  cursor: {
+    defaultPath: "AGENTS.md",
+    description: "Cursor reads AGENTS.md from the project root."
+  }
+};
+function parseAgentStrategy(value) {
+  const normalized = value.trim().toLowerCase();
+  if (normalized in agentStrategies) {
+    return normalized;
+  }
+  const choices = Object.keys(agentStrategies).join(", ");
+  throw new Error(`Unknown strategy "${value}". Choose one of: ${choices}.`);
+}
+function getDefaultAgentsPath(strategy) {
+  return agentStrategies[strategy].defaultPath;
+}
+function resolveAgentsPath({
+  strategy,
+  outputPath,
+  cwd = process.cwd()
+}) {
+  return import_path6.default.resolve(cwd, outputPath ?? getDefaultAgentsPath(strategy));
+}
+async function fetchAgentsMd(url = AGENTS_URL) {
+  const response = await fetch(url, {
+    headers: {
+      "Cache-Control": "no-cache"
+    }
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Failed to fetch ${url} (${response.status} ${response.statusText}).`
+    );
+  }
+  return response.text();
+}
+async function writeAgentsFile(outputPath, contents, mode) {
+  await import_promises4.default.mkdir(import_path6.default.dirname(outputPath), { recursive: true });
+  if (mode === "append") {
+    const needsNewline = !contents.startsWith("\n") && contents.length > 0;
+    await import_promises4.default.appendFile(outputPath, needsNewline ? `
+${contents}` : contents, "utf8");
+    return;
+  }
+  const flag = mode === "create" ? "wx" : "w";
+  await import_promises4.default.writeFile(outputPath, contents, { encoding: "utf8", flag });
+}
+async function pullAgents({
+  strategy,
+  outputPath,
+  writeMode = "create",
+  cwd = process.cwd()
+}) {
+  const resolvedPath = resolveAgentsPath({ strategy, outputPath, cwd });
+  const contents = await fetchAgentsMd();
+  await writeAgentsFile(resolvedPath, contents, writeMode);
+  return {
+    outputPath: resolvedPath,
+    bytes: Buffer.byteLength(contents, "utf8")
+  };
+}
+
+// src/commands/agents.ts
+var strategyChoices = Object.entries(agentStrategies).map(([key, value]) => `${key}=${value.defaultPath}`).join(", ");
+async function fileExists(filePath) {
+  try {
+    await import_promises5.default.access(filePath);
+    return true;
+  } catch (error) {
+    if (error && typeof error === "object" && "code" in error) {
+      const errorCode = error.code;
+      if (errorCode === "ENOENT") {
+        return false;
+      }
+    }
+    throw error;
+  }
+}
+async function promptExistingFile(outputPath) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error(
+      "Output file already exists. Re-run in an interactive terminal to choose overwrite, append, or cancel."
+    );
+  }
+  const rl = (0, import_promises6.createInterface)({ input: import_node_process.stdin, output: import_node_process.stdout });
+  try {
+    while (true) {
+      const answer = await rl.question(
+        `
+File already exists at ${outputPath}. Overwrite (o), append (a), or cancel (c)? `
+      );
+      const normalized = answer.trim().toLowerCase();
+      if (normalized === "o" || normalized === "overwrite") {
+        return "overwrite";
+      }
+      if (normalized === "a" || normalized === "append") {
+        return "append";
+      }
+      if (normalized === "c" || normalized === "cancel") {
+        return "cancel";
+      }
+    }
+  } finally {
+    rl.close();
+  }
+}
+function register5(program2) {
+  const command = program2.command("agents").description("Download the latest AGENTS.md for a selected agent tool strategy.").usage("[dest_path] [-s <strategy>]").argument(
+    "[dest_path]",
+    "Output path (defaults to the strategy's standard location)."
+  ).option(
+    "-s, --strategy <strategy>",
+    `Agent tool strategy (${strategyChoices}).`,
+    parseAgentStrategy,
+    "codex"
+  ).action(async (destPath, options, cmd) => {
+    try {
+      const strategySource = cmd.getOptionValueSource?.("strategy");
+      if (destPath && strategySource === "cli") {
+        throw new Error("Choose either an output path or -s/--strategy, not both.");
+      }
+      const resolvedPath = resolveAgentsPath({
+        strategy: options.strategy,
+        outputPath: destPath,
+        cwd: process.cwd()
+      });
+      const displayPath = import_path7.default.relative(process.cwd(), resolvedPath);
+      let writeMode = "create";
+      if (await fileExists(resolvedPath)) {
+        const choice = await promptExistingFile(displayPath);
+        if (choice === "cancel") {
+          console.log("Canceled.");
+          process.exit(1);
+        }
+        writeMode = choice;
+      }
+      await pullAgents({
+        strategy: options.strategy,
+        outputPath: resolvedPath,
+        writeMode
+      });
+      console.log(`Saved agent instructions to ${displayPath}`);
+    } catch (error) {
+      handleCommandError(error);
+    }
+  });
+  addExamples(command, [
+    "scripts agents",
+    "scripts agents -s claude",
+    "scripts agents -s cursor",
+    "scripts agents ./config/AGENTS.md"
+  ]);
+}
+
 // src/cli.ts
 var cliName = "scripts";
 var cliDescription = "Joyco utility scripts bundled as a pnpx CLI.";
@@ -3510,15 +3683,16 @@ var commandRegistrations = [
   register,
   register2,
   register3,
-  register4
+  register4,
+  register5
 ];
 function buildProgram() {
   const program2 = new Command();
   program2.name(cliName);
   program2.description(cliDescription);
   program2.version(package_default.version);
-  for (const register5 of commandRegistrations) {
-    register5(program2);
+  for (const register6 of commandRegistrations) {
+    register6(program2);
   }
   return program2;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joycostudio/scripts",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Joyco utility scripts as a pnpx CLI",
   "bin": {
     "scripts": "dist/cli.js"