@uniswap/ai-toolkit-nx-claude 0.5.7-next.10

package/README.md

@@ -0,0 +1,60 @@
+# @uniswap/ai-toolkit-nx-claude
+
+This package provides Nx generators for setting up and managing Claude Code configurations, commands, agents, and notification hooks.
+
+## Installation
+
+This package is published to GitHub Packages and requires authentication to access. Ensure you have a GitHub personal access token with appropriate scopes configured in your npm settings. More information available in the root README.md file.
+
+````bash
+
+## Usage
+
+### Run Default Generator
+
+```bash
+npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest
+````
+
+### Run Specific Generators
+
+Each generator can be run directly using colon syntax:
+
+```bash
+# One-shot installer for Claude Code configs
+npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest init
+
+# Install notification hooks
+npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest hooks
+
+# Setup shell proxy for GitHub registry routing
+npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest setup-registry-proxy
+
+# Install and configure Claude Code addons
+npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest addons
+
+# Add a new command to packages
+npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest add-command
+
+# Add a new agent to packages
+npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest add-agent
+```
+
+### List Available Generators
+
+```bash
+npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest --list
+```
+
+## Available Generators
+
+- **init** - One-shot installer for Claude Code configs
+- **hooks** - Install Claude Code notification hooks
+- **setup-registry-proxy** - Setup shell proxy for routing @uniswap/ai-toolkit\* packages to GitHub registry
+- **addons** - Install and configure Claude Code addons including MCP servers
+- **add-command** - Add a new Claude Code command to existing or new packages
+- **add-agent** - Add a new Claude Code agent to existing or new packages
+
+## Building
+
+Run `nx build ai-toolkit-nx-claude` to build the library.

package/dist/cli-generator.cjs

@@ -0,0 +1,447 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// packages/ai-toolkit-nx-claude/src/cli-utils.ts
+var import_child_process = require("child_process");
+var path = __toESM(require("path"));
+var fs = __toESM(require("fs"));
+async function handleNxExecution(generatorName, args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(
+      `Usage: npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest ${generatorName}`
+    );
+    console.log(
+      `
+This command runs the nx-claude ${generatorName} generator.`
+    );
+    console.log("\nOptions are handled interactively during execution.");
+    console.log("\nFor more information, see the package documentation.");
+    process.exit(0);
+  }
+  const isStandalone = shouldRunStandalone();
+  if (isStandalone) {
+    await runGeneratorDirectly(generatorName, args);
+  } else {
+    try {
+      const nxArgs = [
+        "nx",
+        "generate",
+        `@uniswap/ai-toolkit-nx-claude:${generatorName}`,
+        ...args
+      ];
+      (0, import_child_process.execSync)(nxArgs.join(" "), {
+        stdio: "inherit",
+        cwd: process.cwd()
+      });
+    } catch (error) {
+      handleExecutionError(error, generatorName);
+    }
+  }
+}
+function handleExecutionError(error, generatorName) {
+  if (error.code === "403" || error.message?.includes("Forbidden") || error.message?.includes("unauthorized")) {
+    console.error("\n\u274C Authentication Error");
+    console.error(
+      "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"
+    );
+    console.error("You do not have permission to access this package.");
+    console.error(
+      "\nThis package is restricted to members of the Uniswap GitHub organization."
+    );
+    console.error("\nTo gain access:");
+    console.error(
+      "1. Verify you are a member of the Uniswap organization on GitHub"
+    );
+    console.error(
+      '2. Check that your npm token has the required "read:packages" scope'
+    );
+    console.error(
+      "\nFor more information, see: https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#authenticating-to-github-packages"
+    );
+    console.error(
+      "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"
+    );
+  } else if (error.code === "404" || error.message?.includes("Not Found")) {
+    console.error("\n\u274C Package Not Found");
+    console.error(
+      "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"
+    );
+    console.error(
+      "The package @uniswap/ai-toolkit-nx-claude could not be found."
+    );
+    console.error("\nThis may be because:");
+    console.error("1. The package has not been published yet");
+    console.error(
+      "2. You are not authenticated properly (check your GitHub PAT)"
+    );
+    console.error("\nTry running:");
+    console.error(
+      '  echo "//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN" >> ~/.npmrc'
+    );
+    console.error(
+      "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"
+    );
+  } else if (error.code === "ENOENT") {
+    console.error("\n\u274C Nx CLI Not Found");
+    console.error(
+      "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"
+    );
+    console.error("The Nx CLI is required but not installed.");
+    console.error("\nPlease install Nx globally:");
+    console.error("  npm install -g nx");
+    console.error("\nOr use npx to run without installing:");
+    console.error(
+      `  npx nx generate @uniswap/ai-toolkit-nx-claude@latest ${generatorName}`
+    );
+    console.error(
+      "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"
+    );
+  } else {
+    process.exit(error.status || 1);
+  }
+  process.exit(1);
+}
+function shouldRunStandalone() {
+  const scriptPath = process.argv[1];
+  const isInAiToolkitWorkspace = scriptPath.includes(
+    "/ai-toolkit/packages/ai-toolkit-nx-claude/"
+  );
+  if (!isInAiToolkitWorkspace) {
+    return true;
+  }
+  const cwd = process.cwd();
+  const hasNxJson = fs.existsSync(path.join(cwd, "nx.json"));
+  return !hasNxJson || !cwd.includes("/ai-toolkit");
+}
+async function runGeneratorDirectly(generatorName, args) {
+  try {
+    const generatorFunctionMap = {
+      init: "initGenerator",
+      hooks: "hooksGenerator",
+      "setup-registry-proxy": "setupRegistryProxyGenerator",
+      addons: "addonsGenerator",
+      "add-command": "addCommandGenerator",
+      "add-agent": "addAgentGenerator"
+    };
+    const generatorFnName = generatorFunctionMap[generatorName];
+    if (!generatorFnName) {
+      console.error(`
+\u274C Generator '${generatorName}' not found`);
+      console.error(
+        `Available generators: ${Object.keys(generatorFunctionMap).join(", ")}`
+      );
+      process.exit(1);
+    }
+    const jsPath = path.join(
+      __dirname,
+      "generators",
+      generatorName,
+      "generator.js"
+    );
+    const cjsPath = path.join(
+      __dirname,
+      "generators",
+      generatorName,
+      "generator.cjs"
+    );
+    const generatorPath = fs.existsSync(jsPath) ? jsPath : cjsPath;
+    if (!fs.existsSync(generatorPath)) {
+      console.error(`
+\u274C Generator file not found at: ${jsPath}`);
+      console.error(`Also tried: ${cjsPath}`);
+      console.error(`Current __dirname: ${__dirname}`);
+      console.error(`Looking for generator: ${generatorName}`);
+      const generatorsDir = path.join(__dirname, "generators");
+      if (fs.existsSync(generatorsDir)) {
+        console.error(`
+Contents of generators directory:`);
+        const dirs = fs.readdirSync(generatorsDir);
+        dirs.forEach((dir) => {
+          const genPath = path.join(generatorsDir, dir);
+          if (fs.statSync(genPath).isDirectory()) {
+            const genFile = path.join(genPath, "generator.js");
+            console.error(
+              `  ${dir}: ${fs.existsSync(genFile) ? "\u2713 generator.js exists" : "\u2717 generator.js missing"}`
+            );
+          }
+        });
+      } else {
+        console.error(`Generators directory not found at: ${generatorsDir}`);
+      }
+      throw new Error(`Generator file not found: ${generatorName}`);
+    }
+    const generatorModule = require(generatorPath);
+    let generator = generatorModule[generatorFnName];
+    if (!generator && generatorModule.default) {
+      generator = generatorModule.default;
+    }
+    if (!generator && typeof generatorModule === "function") {
+      generator = generatorModule;
+    }
+    if (!generator || typeof generator !== "function") {
+      const moduleExports = Object.keys(generatorModule);
+      console.error(`
+\u274C Generator function not found for '${generatorName}'`);
+      console.error(`Expected function name: ${generatorFnName}`);
+      console.error(`Available exports: ${moduleExports.join(", ")}`);
+      console.error(
+        `Export types: ${moduleExports.map((key) => `${key}: ${typeof generatorModule[key]}`).join(", ")}`
+      );
+      console.error(`
+\u274C Generator '${generatorName}' not found`);
+      console.error(
+        `Available generators: ${Object.keys(generatorFunctionMap).filter((g) => g !== generatorName).join(", ")}`
+      );
+      process.exit(1);
+    }
+    const options = parseCliArgs(args);
+    const tree = createStandaloneTree();
+    await generator(tree, options);
+    await applyTreeChanges(tree);
+  } catch (error) {
+    if (error.code === "MODULE_NOT_FOUND" || error.message?.includes("Cannot find module") || error.message?.includes("Generator file not found")) {
+      console.error(`
+\u274C Failed to load generator '${generatorName}'`);
+      if (!error.message?.includes("Generator file not found")) {
+        console.error(`Error details: ${error.message}`);
+      }
+      console.error(
+        "\nThis may indicate a packaging or installation issue with the npm package."
+      );
+      console.error(
+        "Please report this issue at: https://github.com/uniswap/ai-toolkit/issues"
+      );
+      process.exit(1);
+    }
+    console.error(`Error running generator '${generatorName}':`, error.message);
+    if (process.env.DEBUG) {
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+}
+function parseCliArgs(args) {
+  const options = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith("--")) {
+      let key = arg.slice(2);
+      const nextArg = args[i + 1];
+      let value = true;
+      if (key.includes("=")) {
+        const [k, v] = key.split("=");
+        key = k;
+        value = v;
+      } else if (nextArg && !nextArg.startsWith("--")) {
+        value = nextArg;
+        i++;
+      }
+      const camelKey = key.replace(
+        /-([a-z])/g,
+        (_, letter) => letter.toUpperCase()
+      );
+      if (camelKey.startsWith("no") && camelKey.length > 2) {
+        const actualKey = camelKey[2].toLowerCase() + camelKey.slice(3);
+        if (actualKey === "interactive") {
+          options["nonInteractive"] = true;
+        } else {
+          options[actualKey] = false;
+        }
+      } else {
+        options[camelKey] = value;
+      }
+    }
+  }
+  return options;
+}
+function createStandaloneTree() {
+  const changes = /* @__PURE__ */ new Map();
+  return {
+    root: process.cwd(),
+    read(filePath) {
+      const fullPath = path.join(process.cwd(), filePath);
+      if (fs.existsSync(fullPath)) {
+        return fs.readFileSync(fullPath);
+      }
+      return null;
+    },
+    write(filePath, content) {
+      changes.set(filePath, { content: content.toString(), mode: "update" });
+    },
+    exists(filePath) {
+      const fullPath = path.join(process.cwd(), filePath);
+      return fs.existsSync(fullPath);
+    },
+    delete(filePath) {
+      changes.set(filePath, { content: "", mode: "delete" });
+    },
+    isFile(filePath) {
+      const fullPath = path.join(process.cwd(), filePath);
+      return fs.existsSync(fullPath) && fs.statSync(fullPath).isFile();
+    },
+    children(dirPath) {
+      const fullPath = path.join(process.cwd(), dirPath);
+      if (fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()) {
+        return fs.readdirSync(fullPath);
+      }
+      return [];
+    },
+    // Store changes for later application
+    _changes: changes
+  };
+}
+async function applyTreeChanges(tree) {
+  for (const [filePath, change] of tree._changes.entries()) {
+    const fullPath = path.join(process.cwd(), filePath);
+    if (change.mode === "delete") {
+      if (fs.existsSync(fullPath)) {
+        fs.unlinkSync(fullPath);
+      }
+    } else {
+      const dir = path.dirname(fullPath);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+      fs.writeFileSync(fullPath, change.content);
+    }
+  }
+}
+
+// packages/ai-toolkit-nx-claude/src/cli-generator.ts
+var import_enquirer = require("enquirer");
+var path2 = __toESM(require("path"));
+var fs2 = __toESM(require("fs"));
+function isInAiToolkitRepo() {
+  const cwd = process.cwd();
+  const scriptPath = process.argv[1];
+  const isInAiToolkit = cwd.includes("/ai-toolkit") || scriptPath.includes("/ai-toolkit/") || fs2.existsSync(path2.join(cwd, "package.json")) && JSON.parse(fs2.readFileSync(path2.join(cwd, "package.json"), "utf-8")).name === "@ai-toolkit/source";
+  return isInAiToolkit;
+}
+var GENERATORS = {
+  init: "One-shot installer for Claude Code configs",
+  hooks: "Install Claude Code notification hooks",
+  addons: "Install and configure Claude Code addons including MCP servers",
+  "setup-registry-proxy": "Setup shell proxy for routing @uniswap/ai-toolkit* packages to GitHub registry"
+};
+var ALL_GENERATORS = isInAiToolkitRepo() ? {
+  ...GENERATORS,
+  "add-command": "Add a new Claude Code command to existing or new packages",
+  "add-agent": "Add a new Claude Code agent to existing or new packages"
+} : GENERATORS;
+function getGeneratorName(args) {
+  if (args.length > 0 && !args[0].startsWith("-")) {
+    const generatorName = args[0];
+    if (generatorName in ALL_GENERATORS) {
+      return generatorName;
+    }
+    console.error(`
+\u274C Unknown generator: '${generatorName}'
+`);
+    console.error("Available generators:");
+    Object.entries(ALL_GENERATORS).forEach(([name, description]) => {
+      console.error(`  \u2022 ${name}: ${description}`);
+    });
+    process.exit(1);
+  }
+  return null;
+}
+async function selectGeneratorInteractively() {
+  console.log("\n\u{1F3AF} AI Toolkit NX Claude Generator\n");
+  console.log("Select a generator to run:\n");
+  const availableGenerators = isInAiToolkitRepo() ? ALL_GENERATORS : GENERATORS;
+  const choices = Object.entries(availableGenerators).map(([value, label]) => ({
+    message: `${value.padEnd(25)} - ${label}`,
+    name: value
+    // name is the actual value that gets returned
+  }));
+  const response = await (0, import_enquirer.prompt)({
+    type: "select",
+    name: "generator",
+    message: "Which generator would you like to use?",
+    choices
+  });
+  return response.generator;
+}
+async function main() {
+  const args = process.argv.slice(2);
+  let generatorName = getGeneratorName(args);
+  const processedArgs = args.length > 0 && !args[0].startsWith("-") && args[0] in ALL_GENERATORS ? args.slice(1) : args;
+  if (processedArgs.includes("--list") || processedArgs.includes("-l")) {
+    console.log("Available generators:\n");
+    Object.entries(ALL_GENERATORS).forEach(([name, description]) => {
+      console.log(`  ${name.padEnd(25)} ${description}`);
+    });
+    console.log("\nUsage:");
+    console.log(
+      "  npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest [generator]"
+    );
+    console.log("\nExamples:");
+    console.log(
+      "  npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest init"
+    );
+    console.log(
+      "  npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest hooks"
+    );
+    process.exit(0);
+  }
+  if (processedArgs.includes("--help") || processedArgs.includes("-h")) {
+    if (generatorName) {
+      console.log(
+        `Usage: npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest ${generatorName}`
+      );
+      console.log(
+        `
+This command runs the nx-claude ${generatorName} generator.`
+      );
+    } else {
+      console.log(
+        "Usage: npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest [generator]"
+      );
+      console.log("\nRun without arguments for interactive mode.");
+    }
+    console.log("\nTo see all available generators, run with --list");
+    console.log("\nTo run a specific generator:");
+    console.log(
+      "  npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest [generator]"
+    );
+    console.log("\nOptions are handled interactively during execution.");
+    console.log("\nFor more information, see the package documentation.");
+    process.exit(0);
+  }
+  if (!generatorName && processedArgs.length === 0) {
+    generatorName = await selectGeneratorInteractively();
+    console.log("");
+  }
+  if (!generatorName) {
+    console.error("\n\u274C No generator specified.");
+    console.error(
+      "\nUsage: npx --@uniswap:registry=https://npm.pkg.github.com @uniswap/ai-toolkit-nx-claude@latest [generator]"
+    );
+    console.error("\nRun with --list to see available generators.");
+    process.exit(1);
+  }
+  await handleNxExecution(generatorName, processedArgs);
+}
+main().catch(console.error);