@jskit-ai/jskit-cli 0.2.10 → 0.2.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/jskit-cli",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Bundle and package orchestration CLI for JSKIT apps.",
   "type": "module",
   "files": [
@@ -20,7 +20,8 @@
     "test": "node --test"
   },
   "dependencies": {
-    "@jskit-ai/jskit-catalog": "0.1.10"
+    "@jskit-ai/cli-runtime": "0.1.0",
+    "@jskit-ai/jskit-catalog": "0.1.12"
   },
   "engines": {
     "node": "20.x"

package/src/server/argParser.js

@@ -0,0 +1,187 @@
+const KNOWN_COMMANDS = new Set([
+  "help",
+  "create",
+  "list",
+  "show",
+  "view",
+  "add",
+  "position",
+  "update",
+  "remove",
+  "doctor",
+  "lint-descriptors"
+]);
+
+const COMMAND_ALIASES = Object.freeze({
+  view: "show",
+  ls: "list"
+});
+
+function resolveCommandAlias(rawCommand) {
+  const command = String(rawCommand || "").trim();
+  if (!command) {
+    return "";
+  }
+  return COMMAND_ALIASES[command] || command;
+}
+
+function parseArgs(argv, { createCliError } = {}) {
+  if (typeof createCliError !== "function") {
+    throw new TypeError("parseArgs requires createCliError.");
+  }
+
+  const args = Array.isArray(argv) ? [...argv] : [];
+  const firstToken = String(args[0] || "").trim();
+  if (firstToken === "--help" || firstToken === "-h") {
+    args.shift();
+    return {
+      command: "help",
+      options: {
+        dryRun: false,
+        noInstall: false,
+        full: false,
+        expanded: false,
+        details: false,
+        debugExports: false,
+        json: false,
+        all: false,
+        help: true,
+        inlineOptions: {}
+      },
+      positional: []
+    };
+  }
+
+  const rawCommand = String(args.shift() || "help").trim() || "help";
+  const command = resolveCommandAlias(rawCommand);
+
+  if (!KNOWN_COMMANDS.has(command)) {
+    throw createCliError(`Unknown command: ${rawCommand}`, { showUsage: true });
+  }
+
+  const options = {
+    dryRun: false,
+    noInstall: false,
+    full: false,
+    expanded: false,
+    details: false,
+    debugExports: false,
+    json: false,
+    all: false,
+    help: false,
+    inlineOptions: {}
+  };
+  const positional = [];
+
+  while (args.length > 0) {
+    const token = String(args.shift() || "");
+
+    if (token === "--dry-run") {
+      options.dryRun = true;
+      continue;
+    }
+    if (token === "--no-install") {
+      options.noInstall = true;
+      continue;
+    }
+    if (token === "--full") {
+      options.full = true;
+      continue;
+    }
+    if (token === "--expanded") {
+      options.expanded = true;
+      continue;
+    }
+    if (token === "--details") {
+      options.details = true;
+      continue;
+    }
+    if (token === "--debug-exports") {
+      options.debugExports = true;
+      continue;
+    }
+    if (token === "--json") {
+      options.json = true;
+      continue;
+    }
+    if (token === "--all") {
+      options.all = true;
+      continue;
+    }
+    if (token === "--help" || token === "-h") {
+      options.help = true;
+      continue;
+    }
+
+    if (token.startsWith("--")) {
+      const withoutPrefix = token.slice(2);
+      const hasInlineValue = withoutPrefix.includes("=");
+      const optionName = hasInlineValue ? withoutPrefix.slice(0, withoutPrefix.indexOf("=")) : withoutPrefix;
+      const optionValueRaw = hasInlineValue
+        ? withoutPrefix.slice(withoutPrefix.indexOf("=") + 1)
+        : args.shift();
+
+      if (!/^[a-z][a-z0-9-]*$/.test(optionName)) {
+        throw createCliError(`Unknown option: ${token}`, { showUsage: true });
+      }
+      if (typeof optionValueRaw !== "string") {
+        throw createCliError(`--${optionName} requires a value.`, { showUsage: true });
+      }
+      const optionValue = optionValueRaw.trim();
+      if (!hasInlineValue && optionValue.startsWith("-")) {
+        throw createCliError(`--${optionName} requires a value.`, { showUsage: true });
+      }
+
+      options.inlineOptions[optionName] = optionValue;
+      continue;
+    }
+
+    if (token.startsWith("-")) {
+      throw createCliError(`Unknown option: ${token}`, { showUsage: true });
+    }
+
+    positional.push(token);
+  }
+
+  if (options.debugExports) {
+    options.details = true;
+  }
+
+  return {
+    command,
+    options,
+    positional
+  };
+}
+
+function printUsage(stream = process.stderr) {
+  stream.write("Usage: jskit <command> [options]\n\n");
+  stream.write("Commands:\n");
+  stream.write("  create package <name>        Scaffold app-local package under packages/ and install it\n");
+  stream.write("  list [bundles [all]|packages] List available bundles/packages and installed status\n");
+  stream.write("  lint-descriptors             Validate bundle/package descriptor files\n");
+  stream.write("  add bundle <bundleId>        Add one bundle (bundle is a package shortcut)\n");
+  stream.write("  add package <packageId>      Add one package to current app (catalog/app-local/installed external)\n");
+  stream.write("  position element <packageId> Re-apply positioning mutations for one installed package\n");
+  stream.write("  show <id>                    Show details for bundle id or package id\n");
+  stream.write("  view <id>                    Alias of show <id>\n");
+  stream.write("  update package <packageId>   Re-apply one installed package\n");
+  stream.write("  remove package <packageId>   Remove one installed package\n");
+  stream.write("  doctor                       Validate lockfile + managed files\n");
+  stream.write("\n");
+  stream.write("Options:\n");
+  stream.write("  --dry-run                    Print planned changes only\n");
+  stream.write("  --no-install                 Skip npm install during create/add/update/remove\n");
+  stream.write("  --scope <scope>              (create package) override generated package scope\n");
+  stream.write("  --package-id <id>            (create package) explicit @scope/name package id\n");
+  stream.write("  --description <text>         (create package) descriptor description text\n");
+  stream.write("  --full                       Show bundle package ids (declared packages)\n");
+  stream.write("  --expanded                   Show expanded/transitive package ids\n");
+  stream.write("  --details                    Show extra capability detail in show output\n");
+  stream.write("  --debug-exports              Show export provenance/re-export source details in show output\n");
+  stream.write("  --<option> <value>           Package option (for packages requiring input)\n");
+  stream.write("  --json                       Print structured output\n");
+  stream.write("  -h, --help                   Show help\n");
+}
+
+export { parseArgs, printUsage };

package/src/server/cliEntrypoint.js

@@ -1,14 +1 @@
-import process from "node:process";
-
-async function runCliEntrypoint(runCli, argv = process.argv.slice(2)) {
-  if (typeof runCli !== "function") {
-    throw new TypeError("runCliEntrypoint requires a runCli function");
-  }
-
-  const exitCode = await runCli(argv);
-  if (exitCode !== 0) {
-    process.exit(exitCode);
-  }
-}
-
-export { runCliEntrypoint };
+export { runCliEntrypoint } from "@jskit-ai/cli-runtime/server";

package/src/server/cliError.js

@@ -1,8 +1 @@
-function createCliError(message, { showUsage = false } = {}) {
-  const error = new Error(String(message || "Unknown CLI error"));
-  error.name = "CliError";
-  error.showUsage = Boolean(showUsage);
-  return error;
-}
-
-export { createCliError };
+export { createCliError } from "@jskit-ai/cli-runtime/server";