@orchid-labs/pluxx 0.1.5 → 0.1.6

package/README.md

@@ -206,6 +206,8 @@ Pluxx owns the deterministic scaffold, validation, and host compilation layer. Y
 - npm package: `@orchid-labs/pluxx`
 - preferred invocation: `npx @orchid-labs/pluxx ...`
 - global install also works: `npm install -g @orchid-labs/pluxx`
+- check the active global CLI version with: `pluxx --version`
+- upgrade the active global CLI with: `pluxx upgrade`
 - published CLI runtime: Node `>=18`
 - source builds and maintainer workflows also run on Node `>=18`
 

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAeL,KAAK,mBAAmB,EAIzB,MAAM,SAAS,CAAA;AAkChB,OAAO,EACL,wBAAwB,EAIzB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAA;AAkCnE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,OAAO,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,CAAC,EAAE,mBAAmB,CAAA;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;CACpB;AAiGD,wBAAsB,IAAI,kBAgEzB;AA0cD,UAAU,mBAAmB;IAC3B,EAAE,EAAE,QAAQ,GAAG,eAAe,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAyBD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAOhF;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,GAAG,IAAI,GAClE,mBAAmB,GAAG,IAAI,CA4B5B;AA+BD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,YAAY,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAUpI;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,CAAC,GAAG,OAAO,GAAG,SAAS,CAwCpJ;AAiSD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAwB3H"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAeL,KAAK,mBAAmB,EAIzB,MAAM,SAAS,CAAA;AAkChB,OAAO,EACL,wBAAwB,EAIzB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAA;AAoCnE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,OAAO,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,CAAC,EAAE,mBAAmB,CAAA;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;CACpB;AA2GD,wBAAsB,IAAI,kBAsEzB;AAsjBD,UAAU,mBAAmB;IAC3B,EAAE,EAAE,QAAQ,GAAG,eAAe,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAyBD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAOhF;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,GAAG,IAAI,GAClE,mBAAmB,GAAG,IAAI,CA4B5B;AA+BD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,YAAY,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAUpI;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,CAAC,GAAG,OAAO,GAAG,SAAS,CAwCpJ;AAiSD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAwB3H"}

package/dist/cli/index.js

@@ -84,6 +84,9 @@ var require_src = __commonJS({
   }
 });
 
+// src/cli/index.ts
+import { readFileSync as readFileSync16 } from "fs";
+
 // src/config/load.ts
 import { resolve, extname, dirname } from "path";
 import { existsSync } from "fs";
@@ -18069,19 +18072,19 @@ function usage() {
     "- --replay serves a deterministic stdio MCP session from a recorded tape."
   ].join("\n");
 }
-function readOption(rawArgs, flag) {
-  const index = rawArgs.indexOf(flag);
+function readOption(rawArgs2, flag) {
+  const index = rawArgs2.indexOf(flag);
   if (index === -1) return void 0;
-  const value = rawArgs[index + 1];
+  const value = rawArgs2[index + 1];
   if (!value || value.startsWith("-")) {
     return void 0;
   }
   return value;
 }
-function parseOptions(rawArgs) {
-  const source = readOption(rawArgs, "--from-mcp");
-  const recordPath = readOption(rawArgs, "--record");
-  const replayPath = readOption(rawArgs, "--replay");
+function parseOptions(rawArgs2) {
+  const source = readOption(rawArgs2, "--from-mcp");
+  const recordPath = readOption(rawArgs2, "--record");
+  const replayPath = readOption(rawArgs2, "--replay");
   if (recordPath && replayPath) {
     throw new Error("Choose either --record or --replay, not both.");
   }
@@ -18269,17 +18272,17 @@ async function replaySession(filepath, io) {
     rl.close();
   }
 }
-async function runMcpProxy(rawArgs) {
-  return await runMcpProxyWithIo(rawArgs, {
+async function runMcpProxy(rawArgs2) {
+  return await runMcpProxyWithIo(rawArgs2, {
     input: process.stdin,
     output: process.stdout,
     error: process.stderr
   });
 }
-async function runMcpProxyWithIo(rawArgs, io) {
+async function runMcpProxyWithIo(rawArgs2, io) {
   let options;
   try {
-    options = parseOptions(rawArgs);
+    options = parseOptions(rawArgs2);
   } catch (error) {
     io.error.write(`${error instanceof Error ? error.message : String(error)}
 
@@ -19311,7 +19314,7 @@ ${c2}
 import { basename as basename8, resolve as resolve23 } from "path";
 import { mkdir as mkdir4, mkdtemp as mkdtemp3, rm as rm4 } from "fs/promises";
 import { tmpdir as tmpdir5 } from "os";
-import { spawn as spawn4 } from "child_process";
+import { spawn as spawn4, spawnSync as spawnSync3 } from "child_process";
 
 // src/cli/publish.ts
 import { chmodSync, existsSync as existsSync25, mkdtempSync as mkdtempSync2, readFileSync as readFileSync14, rmSync as rmSync4, writeFileSync as writeFileSync6 } from "fs";
@@ -20222,36 +20225,36 @@ function runPublish(config, options = {}) {
 }
 
 // src/cli/runtime.ts
-function createCliRuntime(rawArgs) {
+function createCliRuntime(rawArgs2) {
   const isCI = process.env.CI === "1" || process.env.CI === "true";
   const isTTY = process.stdin.isTTY === true && process.stdout.isTTY === true;
   return {
-    dryRun: rawArgs.includes("--dry-run"),
-    jsonOutput: rawArgs.includes("--json"),
-    quiet: rawArgs.includes("--quiet"),
+    dryRun: rawArgs2.includes("--dry-run"),
+    jsonOutput: rawArgs2.includes("--json"),
+    quiet: rawArgs2.includes("--quiet"),
     isCI,
     isTTY,
     isInteractive: isTTY && !isCI
   };
 }
-function readFlag(rawArgs, flag) {
-  return rawArgs.includes(flag);
+function readFlag(rawArgs2, flag) {
+  return rawArgs2.includes(flag);
 }
-function readOption2(rawArgs, flag) {
-  const index = rawArgs.indexOf(flag);
+function readOption2(rawArgs2, flag) {
+  const index = rawArgs2.indexOf(flag);
   if (index === -1) return void 0;
-  const value = rawArgs[index + 1];
+  const value = rawArgs2[index + 1];
   if (!value || value.startsWith("-")) {
     return void 0;
   }
   return value;
 }
-function readMultiValueOption(rawArgs, flag) {
-  const index = rawArgs.indexOf(flag);
+function readMultiValueOption(rawArgs2, flag) {
+  const index = rawArgs2.indexOf(flag);
   if (index === -1) return void 0;
   const values = [];
-  for (let i = index + 1; i < rawArgs.length; i += 1) {
-    const value = rawArgs[i];
+  for (let i = index + 1; i < rawArgs2.length; i += 1) {
+    const value = rawArgs2[i];
     if (value.startsWith("-")) break;
     values.push(value);
   }
@@ -20531,7 +20534,9 @@ function shellQuote2(value) {
 }
 
 // src/cli/index.ts
-var args = process.argv.slice(2);
+var CLI_PACKAGE_NAME = "@orchid-labs/pluxx";
+var rawArgs = process.argv.slice(2);
+var args = normalizeTopLevelArgs(rawArgs);
 var command = args[0];
 var runtime = createCliRuntime(args);
 var DEFAULT_INIT_TARGETS = ["claude-code", "cursor", "codex", "opencode"];
@@ -20551,6 +20556,12 @@ var ALL_TARGET_PLATFORMS = [
 ];
 async function main() {
   switch (command) {
+    case "version":
+      await runVersionCommand();
+      break;
+    case "upgrade":
+      await runUpgradeCommand();
+      break;
     case "build":
       await runBuild2();
       break;
@@ -20614,6 +20625,95 @@ async function main() {
       process.exit(1);
   }
 }
+function normalizeTopLevelArgs(input) {
+  if (input[0] === "--version" || input[0] === "-v") {
+    return ["version", ...input.slice(1)];
+  }
+  if (input[0] === "--upgrade") {
+    return ["upgrade", ...input.slice(1)];
+  }
+  return input;
+}
+function getCliPackageVersion() {
+  const packageJsonPath = new URL("../../package.json", import.meta.url);
+  const raw = JSON.parse(readFileSync16(packageJsonPath, "utf-8"));
+  if (typeof raw.version !== "string" || raw.version.trim() === "") {
+    throw new Error("Unable to determine the installed pluxx version from package.json.");
+  }
+  return raw.version.trim();
+}
+function resolveNpmExecutable() {
+  return process.platform === "win32" ? "npm.cmd" : "npm";
+}
+function buildUpgradeSummary() {
+  const requestedVersion = readOption2(args, "--version") ?? "latest";
+  const specifier = `${CLI_PACKAGE_NAME}@${requestedVersion}`;
+  return {
+    dryRun: runtime.dryRun,
+    packageName: CLI_PACKAGE_NAME,
+    currentVersion: getCliPackageVersion(),
+    requestedVersion,
+    specifier,
+    command: [resolveNpmExecutable(), "install", "-g", specifier],
+    note: "This updates the global npm install used by `pluxx` on your PATH. Repo-local and `npx` invocations are separate entrypoints."
+  };
+}
+async function runVersionCommand() {
+  const version = getCliPackageVersion();
+  if (runtime.jsonOutput) {
+    printJson({ version });
+    return;
+  }
+  console.log(version);
+}
+async function runUpgradeCommand() {
+  const summary = buildUpgradeSummary();
+  if (runtime.dryRun) {
+    if (runtime.jsonOutput) {
+      printJson(summary);
+      return;
+    }
+    if (!runtime.quiet) {
+      console.log(`Dry run: would run \`${summary.command.join(" ")}\``);
+      console.log(summary.note);
+      console.log(`Current version: ${summary.currentVersion}`);
+    }
+    return;
+  }
+  const install = spawnSync3(summary.command[0], summary.command.slice(1), runtime.jsonOutput ? {
+    env: process.env,
+    encoding: "utf-8",
+    stdio: "pipe"
+  } : {
+    env: process.env,
+    stdio: "inherit"
+  });
+  if (install.status !== 0) {
+    if (runtime.jsonOutput) {
+      printJson({
+        ...summary,
+        ok: false,
+        stdout: typeof install.stdout === "string" ? install.stdout : "",
+        stderr: typeof install.stderr === "string" ? install.stderr : "",
+        exitCode: install.status ?? 1
+      });
+    }
+    throw new Error(`Failed to upgrade ${CLI_PACKAGE_NAME}.`);
+  }
+  const result = {
+    ...summary,
+    ok: true
+  };
+  if (runtime.jsonOutput) {
+    printJson(result);
+    return;
+  }
+  if (!runtime.quiet) {
+    console.log(`Upgraded ${summary.packageName} with \`${summary.command.join(" ")}\`.`);
+    console.log("Run `pluxx --version` to verify the active version on your PATH.");
+    console.log(summary.note);
+  }
+}
 function hasAgentContextHints(input) {
   return Boolean(input.docsUrl || input.websiteUrl || (input.contextPaths?.length ?? 0) > 0);
 }
@@ -20899,8 +20999,8 @@ function parseTargetPlatforms(raw) {
   }
   return targets;
 }
-function parseTargetFlagValues(rawArgs) {
-  const values = readMultiValueOption(rawArgs, "--target");
+function parseTargetFlagValues(rawArgs2) {
+  const values = readMultiValueOption(rawArgs2, "--target");
   if (!values) return void 0;
   return parseTargetPlatforms(values.join(","));
 }
@@ -21223,29 +21323,29 @@ function formatMcpDiscoverySummary(introspection) {
   }
   return `${parts.join(", ")} discovered`;
 }
-function parseInitFromMcpOptions(rawArgs, initialName, initialSource) {
+function parseInitFromMcpOptions(rawArgs2, initialName, initialSource) {
   return {
-    source: initialSource ?? readOption2(rawArgs, "--from-mcp"),
-    assumeDefaults: rawArgs.includes("--yes"),
-    name: readOption2(rawArgs, "--name") ?? initialName,
-    author: readOption2(rawArgs, "--author"),
-    displayName: readOption2(rawArgs, "--display-name"),
-    targets: readOption2(rawArgs, "--targets"),
-    docsUrl: readOption2(rawArgs, "--docs"),
-    websiteUrl: readOption2(rawArgs, "--website"),
-    contextPaths: readMultiValueOption(rawArgs, "--context"),
-    ingestProvider: readOption2(rawArgs, "--ingest-provider"),
-    authEnv: readOption2(rawArgs, "--auth-env"),
-    authType: readOption2(rawArgs, "--auth-type"),
-    authHeader: readOption2(rawArgs, "--auth-header"),
-    authTemplate: readOption2(rawArgs, "--auth-template"),
-    runtimeAuth: readOption2(rawArgs, "--runtime-auth"),
-    oauthWrapper: rawArgs.includes("--oauth-wrapper"),
-    approveMcpTools: rawArgs.includes("--approve-mcp-tools"),
-    grouping: readOption2(rawArgs, "--grouping"),
-    hooks: readOption2(rawArgs, "--hooks"),
-    transport: readOption2(rawArgs, "--transport"),
-    jsonOutput: rawArgs.includes("--json")
+    source: initialSource ?? readOption2(rawArgs2, "--from-mcp"),
+    assumeDefaults: rawArgs2.includes("--yes"),
+    name: readOption2(rawArgs2, "--name") ?? initialName,
+    author: readOption2(rawArgs2, "--author"),
+    displayName: readOption2(rawArgs2, "--display-name"),
+    targets: readOption2(rawArgs2, "--targets"),
+    docsUrl: readOption2(rawArgs2, "--docs"),
+    websiteUrl: readOption2(rawArgs2, "--website"),
+    contextPaths: readMultiValueOption(rawArgs2, "--context"),
+    ingestProvider: readOption2(rawArgs2, "--ingest-provider"),
+    authEnv: readOption2(rawArgs2, "--auth-env"),
+    authType: readOption2(rawArgs2, "--auth-type"),
+    authHeader: readOption2(rawArgs2, "--auth-header"),
+    authTemplate: readOption2(rawArgs2, "--auth-template"),
+    runtimeAuth: readOption2(rawArgs2, "--runtime-auth"),
+    oauthWrapper: rawArgs2.includes("--oauth-wrapper"),
+    approveMcpTools: rawArgs2.includes("--approve-mcp-tools"),
+    grouping: readOption2(rawArgs2, "--grouping"),
+    hooks: readOption2(rawArgs2, "--hooks"),
+    transport: readOption2(rawArgs2, "--transport"),
+    jsonOutput: rawArgs2.includes("--json")
   };
 }
 function toKebabCase3(value) {
@@ -22805,6 +22905,8 @@ function printHelp() {
 pluxx \u2014 Cross-platform AI agent plugin SDK
 
 Usage:
+  pluxx --version | -v                    Print the installed Pluxx CLI version
+  pluxx upgrade [--version x.y.z]         Upgrade the global npm install of Pluxx
   pluxx build [--target <platforms...>] [--install]   Generate platform-specific plugin files
   pluxx dev [--target <platforms...>]     Watch for changes and auto-rebuild
   pluxx validate                          Validate your config
@@ -22841,6 +22943,9 @@ Targets:
   warp, gemini-cli, roo-code, cline, amp
 
 Examples:
+  pluxx --version                         Print the installed CLI version
+  pluxx upgrade                           Upgrade the global npm install to latest
+  pluxx upgrade --version x.y.z           Upgrade the global npm install to a specific version
   pluxx build                             Build for all configured targets
   pluxx build --install                   Build and install all configured targets locally
   pluxx build --target claude-code cursor  Build for specific platforms

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchid-labs/pluxx",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Build AI agent plugins once. Prime-time on Claude Code, Cursor, Codex, and OpenCode, with beta generators for additional hosts.",
   "type": "module",
   "main": "dist/index.js",