@ztffn/presentation-generator-plugin 1.0.0 → 1.0.4

package/.github/workflows/publish.yml

@@ -20,7 +20,9 @@ jobs:
           node-version: "20"
           registry-url: "https://registry.npmjs.org"
 
-      - run: npm publish --provenance --access public
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
   release-zip:
     name: Create GitHub Release with zip

package/README.md

@@ -20,16 +20,14 @@ Requires Claude Code 1.0.33 or later.
 claude --plugin-dir /path/to/presentation-generator-plugin
 ```
 
-To always have it available in a project, add it to `.claude/settings.json`:
+To always have it available in a project, register it with Claude Code:
 
-```json
-{
-  "plugins": [
-    { "path": "/path/to/presentation-generator-plugin" }
-  ]
-}
+```bash
+claude plugin install /path/to/presentation-generator-plugin --scope project
 ```
 
+This writes the correct entry to `.claude/settings.json`. Commit that file to share the plugin with your team.
+
 To update: download the new zip from Releases, replace the old folder.
 
 ### Option B — install via npx (requires Node.js 18+ and GitHub auth)

package/bin/index.js

@@ -1,182 +1,230 @@
 #!/usr/bin/env node
 
-const { execSync, spawnSync } = require("child_process");
+const https = require("https");
+const { execSync } = require("child_process");
 const fs = require("fs");
 const path = require("path");
 const os = require("os");
 
-const REPO_URL =
-  "https://github.com/ztffn/presentation-generator-plugin.git";
+const NPM_PACKAGE = "@ztffn/presentation-generator-plugin";
 const PLUGIN_NAME = "presentation-generator";
 const INSTALL_DIR = path.join(os.homedir(), ".claude", "plugins", PLUGIN_NAME);
 const CURRENT_VERSION = require("../package.json").version;
 
 const command = process.argv[2] || "help";
 
-function run(cmd, opts = {}) {
-  return execSync(cmd, { stdio: "inherit", ...opts });
-}
+// ── Helpers ───────────────────────────────────────────────────────────────────
 
-function runCapture(cmd) {
+function getInstalledVersion() {
+  const pkgPath = path.join(INSTALL_DIR, "package.json");
+  if (!fs.existsSync(pkgPath)) return null;
   try {
-    return execSync(cmd, { encoding: "utf8", stderr: "pipe" }).trim();
+    return JSON.parse(fs.readFileSync(pkgPath, "utf8")).version;
   } catch {
     return null;
   }
 }
 
-function checkGitAuth() {
-  const result = spawnSync("gh", ["auth", "status"], { encoding: "utf8" });
-  if (result.status !== 0) {
-    console.error("\nGitHub authentication required.");
-    console.error("Run: gh auth login\n");
-    process.exit(1);
-  }
+function fetchJson(url) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, { headers: { Accept: "application/json" } }, (res) => {
+        let data = "";
+        res.on("data", (chunk) => (data += chunk));
+        res.on("end", () => {
+          try {
+            resolve(JSON.parse(data));
+          } catch (e) {
+            reject(e);
+          }
+        });
+      })
+      .on("error", reject);
+  });
 }
 
-function getInstalledVersion() {
-  const pkgPath = path.join(INSTALL_DIR, "package.json");
-  if (!fs.existsSync(pkgPath)) return null;
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const follow = (u) => {
+      https
+        .get(u, (res) => {
+          if (res.statusCode === 301 || res.statusCode === 302) {
+            follow(res.headers.location);
+            return;
+          }
+          const file = fs.createWriteStream(dest);
+          res.pipe(file);
+          file.on("finish", () => file.close(resolve));
+          file.on("error", reject);
+        })
+        .on("error", reject);
+    };
+    follow(url);
+  });
+}
+
+async function getLatestNpmVersion() {
   try {
-    return JSON.parse(fs.readFileSync(pkgPath, "utf8")).version;
+    const data = await fetchJson(
+      `https://registry.npmjs.org/${NPM_PACKAGE}/latest`
+    );
+    return data.version || null;
   } catch {
     return null;
   }
 }
 
-function getLatestRemoteVersion() {
-  const result = runCapture(
-    `git ls-remote --tags ${REPO_URL} | grep -o 'v[0-9]*\\.[0-9]*\\.[0-9]*' | sort -V | tail -1`
-  );
-  return result ? result.replace(/^v/, "") : null;
-}
+async function downloadAndExtract(version) {
+  const pkgSlug = NPM_PACKAGE.replace("@", "").replace("/", "-");
+  const tarballUrl = `https://registry.npmjs.org/${NPM_PACKAGE}/-/${pkgSlug}-${version}.tgz`;
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "claude-plugin-"));
+  const tarball = path.join(tmpDir, "plugin.tgz");
 
-function printSettingsHelp() {
-  const settingsPath = path.join(process.cwd(), ".claude", "settings.json");
-  const settingsExists = fs.existsSync(settingsPath);
+  console.log(`Downloading v${version} from npm...`);
+  await downloadFile(tarballUrl, tarball);
 
-  console.log("\nAdd the plugin to your project:");
-  console.log(
-    `  File: ${path.join(process.cwd(), ".claude", "settings.json")}`
-  );
+  console.log("Extracting...");
+  execSync(`tar -xzf "${tarball}" -C "${tmpDir}"`);
 
-  if (settingsExists) {
-    let settings;
-    try {
-      settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
-    } catch {
-      settings = {};
-    }
-    const plugins = settings.plugins || [];
-    const alreadyAdded = plugins.some((p) => p.path === INSTALL_DIR);
-    if (alreadyAdded) {
-      console.log("  Already configured in settings.json ✓");
-      return;
-    }
+  // npm tarballs always extract to a "package/" subdirectory
+  const extracted = path.join(tmpDir, "package");
+  if (!fs.existsSync(extracted)) {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+    throw new Error("Extraction failed: no package/ directory in tarball");
   }
 
-  console.log(
-    `  Add: { "plugins": [{ "path": "${INSTALL_DIR}" }] }\n`
-  );
-
-  // Offer to auto-configure
-  try {
-    const readline = require("readline").createInterface({
-      input: process.stdin,
-      output: process.stdout,
-    });
-    readline.question(
-      "Auto-add to .claude/settings.json? [Y/n] ",
-      (answer) => {
-        readline.close();
-        if (answer.toLowerCase() !== "n") {
-          addToSettings(settingsPath);
-        }
-      }
-    );
-  } catch {
-    // non-interactive context
+  if (fs.existsSync(INSTALL_DIR)) {
+    fs.rmSync(INSTALL_DIR, { recursive: true, force: true });
   }
+  fs.mkdirSync(path.dirname(INSTALL_DIR), { recursive: true });
+  fs.renameSync(extracted, INSTALL_DIR);
+  fs.rmSync(tmpDir, { recursive: true, force: true });
 }
 
-function addToSettings(settingsPath) {
-  const dir = path.dirname(settingsPath);
-  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+function registerPlugin() {
+  console.log("\nRegistering plugin with Claude Code...");
 
-  let settings = {};
-  if (fs.existsSync(settingsPath)) {
-    try {
+  // Prefer project-level settings if .claude/ exists in cwd, else user-level
+  const projectDir = path.join(process.cwd(), ".claude");
+  const settingsPath = fs.existsSync(projectDir)
+    ? path.join(projectDir, "settings.json")
+    : path.join(os.homedir(), ".claude", "settings.json");
+
+  try {
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
       settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
-    } catch {}
-  }
+    }
 
-  settings.plugins = settings.plugins || [];
-  const alreadyAdded = settings.plugins.some((p) => p.path === INSTALL_DIR);
-  if (!alreadyAdded) {
-    settings.plugins.push({ path: INSTALL_DIR });
+    if (!Array.isArray(settings.enabledPlugins)) {
+      settings.enabledPlugins = [];
+    }
+
+    if (!settings.enabledPlugins.includes(INSTALL_DIR)) {
+      settings.enabledPlugins.push(INSTALL_DIR);
+    }
+
+    fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
-    console.log("  settings.json updated ✓");
+
+    const label = settingsPath.startsWith(process.cwd())
+      ? ".claude/settings.json"
+      : settingsPath;
+    console.log(`Plugin registered in ${label} ✓`);
+
+    if (settingsPath.startsWith(process.cwd())) {
+      console.log("Commit that file to share the plugin with your team.");
+    }
+  } catch {
+    console.log(
+      "\nCould not write settings. Add manually to .claude/settings.json:"
+    );
+    console.log(JSON.stringify({ enabledPlugins: [INSTALL_DIR] }, null, 2));
+    console.log(`\nOr load for a single session:`);
+    console.log(`  claude --plugin-dir "${INSTALL_DIR}"`);
   }
 }
 
 // ── Commands ──────────────────────────────────────────────────────────────────
 
-function install() {
-  checkGitAuth();
-
+async function install() {
   if (fs.existsSync(INSTALL_DIR)) {
     const installed = getInstalledVersion();
-    const latest = getLatestRemoteVersion();
+    const latest = await getLatestNpmVersion();
 
     if (latest && installed && installed !== latest) {
       console.log(`\nPlugin already installed (v${installed}).`);
-      console.log(`v${latest} is available — run: npx @huma/presentation-generator-plugin update\n`);
+      console.log(
+        `v${latest} is available — run: npx ${NPM_PACKAGE} update\n`
+      );
     } else {
-      console.log(`\nPlugin already installed (v${installed || "unknown"}). Nothing to do.\n`);
+      console.log(
+        `\nPlugin already installed (v${installed || "unknown"}). Nothing to do.\n`
+      );
     }
-    printSettingsHelp();
+    registerPlugin();
     return;
   }
 
   console.log(`\nInstalling presentation-generator plugin...`);
-  fs.mkdirSync(path.dirname(INSTALL_DIR), { recursive: true });
-  run(`git clone ${REPO_URL} "${INSTALL_DIR}"`);
-  console.log(`\nInstalled to: ${INSTALL_DIR}`);
-  printSettingsHelp();
-}
 
-function update() {
-  checkGitAuth();
+  const version = await getLatestNpmVersion();
+  if (!version) {
+    console.error(
+      "\nCould not fetch latest version from npm registry. Check your internet connection.\n"
+    );
+    process.exit(1);
+  }
+
+  await downloadAndExtract(version);
+  console.log(`\nInstalled v${version} to: ${INSTALL_DIR}`);
+  registerPlugin();
+}
 
+async function update() {
   if (!fs.existsSync(INSTALL_DIR)) {
     console.log("\nPlugin not installed. Run install first:");
-    console.log("  npx @ztffn/presentation-generator-plugin install\n");
+    console.log(`  npx ${NPM_PACKAGE} install\n`);
     process.exit(1);
   }
 
   const before = getInstalledVersion();
-  console.log(`\nUpdating presentation-generator plugin (current: v${before || "unknown"})...`);
-  run(`git -C "${INSTALL_DIR}" pull`);
+  const latest = await getLatestNpmVersion();
 
-  const after = getInstalledVersion();
-  if (before !== after) {
-    console.log(`\nUpdated v${before} → v${after} ✓\n`);
-  } else {
-    console.log(`\nAlready up to date (v${after}) ✓\n`);
+  if (!latest) {
+    console.error(
+      "\nCould not fetch latest version from npm registry. Check your internet connection.\n"
+    );
+    process.exit(1);
   }
+
+  if (before === latest) {
+    console.log(`\nAlready up to date (v${before}) ✓`);
+    registerPlugin();
+    return;
+  }
+
+  console.log(
+    `\nUpdating presentation-generator plugin (v${before || "unknown"} → v${latest})...`
+  );
+  await downloadAndExtract(latest);
+  console.log(`\nUpdated to v${latest} ✓`);
+  registerPlugin();
 }
 
-function checkUpdate() {
+async function checkUpdate() {
   if (!fs.existsSync(INSTALL_DIR)) {
-    console.log("\nPlugin not installed.");
+    console.log("\nPlugin not installed.\n");
     return;
   }
 
   const installed = getInstalledVersion();
-  const latest = getLatestRemoteVersion();
+  const latest = await getLatestNpmVersion();
 
   if (!latest) {
-    console.log(`\nInstalled: v${installed || "unknown"} (could not reach remote)\n`);
+    console.log(
+      `\nInstalled: v${installed || "unknown"} (could not reach npm registry)\n`
+    );
     return;
   }
 
@@ -184,7 +232,7 @@ function checkUpdate() {
     console.log(`\nUp to date: v${installed} ✓\n`);
   } else {
     console.log(`\nUpdate available: v${installed} → v${latest}`);
-    console.log(`Run: npx @ztffn/presentation-generator-plugin update\n`);
+    console.log(`Run: npx ${NPM_PACKAGE} update\n`);
   }
 }
 
@@ -194,8 +242,7 @@ function uninstall() {
     return;
   }
   fs.rmSync(INSTALL_DIR, { recursive: true, force: true });
-  console.log(`\nRemoved: ${INSTALL_DIR}`);
-  console.log("You may also want to remove the plugin entry from .claude/settings.json\n");
+  console.log(`\nRemoved: ${INSTALL_DIR}\n`);
 }
 
 function help() {
@@ -203,21 +250,28 @@ function help() {
 presentation-generator-plugin v${CURRENT_VERSION}
 
 Commands:
-  install       Clone plugin to ~/.claude/plugins/ and configure project
-  update        Pull latest changes from GitHub
+  install       Download plugin from npm and register with Claude Code
+  update        Download and install the latest version from npm
   check-update  Report whether an update is available
   uninstall     Remove plugin from ~/.claude/plugins/
 
 Usage:
-  npx @ztffn/presentation-generator-plugin install
-  npx @ztffn/presentation-generator-plugin update
-  npx @ztffn/presentation-generator-plugin check-update
-
-Requires: gh auth login (GitHub authentication)
+  npx ${NPM_PACKAGE} install
+  npx ${NPM_PACKAGE} update
+  npx ${NPM_PACKAGE} check-update
 `);
 }
 
-const commands = { install, update, "check-update": checkUpdate, uninstall, help };
+// ── Dispatch ──────────────────────────────────────────────────────────────────
+
+const commands = {
+  install,
+  update,
+  "check-update": checkUpdate,
+  uninstall,
+  help,
+};
+
 const fn = commands[command];
 
 if (!fn) {
@@ -226,4 +280,7 @@ if (!fn) {
   process.exit(1);
 }
 
-fn();
+Promise.resolve(fn()).catch((err) => {
+  console.error("\nError:", err.message, "\n");
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ztffn/presentation-generator-plugin",
-  "version": "1.0.0",
+  "version": "1.0.4",
   "description": "Claude Code plugin for generating graph-based presentations",
   "bin": {
     "presentation-generator-plugin": "bin/index.js"