@sentientui/cli 0.2.5 → 0.3.0

package/README.md

@@ -18,12 +18,23 @@ npx @sentientui/cli init
 
 `init` **never edits your layout or any existing file.** Nothing adapts until you do the wrap-and-mount step it prints — add the provider snippet to your root layout and mount the example component yourself.
 
-## Flags
+## Commands and flags
+
+```bash
+npx @sentientui/cli init      # set up SentientUI in this app
+npx @sentientui/cli --help    # full usage
+npx @sentientui/cli --version # the installed version, on stdout
+```
 
 | Flag | Description |
 |------|-------------|
 | `--key pk_...` | Your public API key, written into `.env.local`. Omit it to leave the value empty — the SDK then runs in keyless local mode (decisions simulated on-device, nothing sent), so you can build and style before creating an account. |
 | `--yes` / `-y` | Accepted for npx muscle memory; `init` has no prompts, so this is already the default behavior. |
+| `--help` / `-h` | Print usage and exit 0. |
+| `--version` / `-v` | Print the version and exit 0. |
+
+`--help` and `--version` print to stdout and exit 0, so they are safe to pipe.
+An unknown command prints usage to stderr and exits 1.
 
 ## After init
 
@@ -31,6 +42,11 @@ Run your dev server and preview personas locally with `?sentient_persona=buyer`
 
 Full component and hook reference: the [`@sentientui/react` README](https://www.npmjs.com/package/@sentientui/react).
 
+## More
+
+- [Developer resources](https://sentient-ui.com/docs/developers) — REST API, OpenAPI spec, MCP server, webhooks
+- [CLI reference](https://sentient-ui.com/docs/developers#cli)
+
 ## License
 
 MIT

package/dist/index.cjs

@@ -308,10 +308,41 @@ function runInit(opts) {
 
 // src/index.ts
 var import_meta = {};
+var VERSION = true ? "0.3.0" : "0.0.0-dev";
+var USAGE = `SentientUI CLI \u2014 adaptive UI personalization for the web
+
+Usage
+  npx @sentientui/cli <command> [options]
+
+Commands
+  init                 Set up SentientUI in an existing React app: detect the
+                       framework (Next.js App/Pages Router, Vite, Remix, CRA),
+                       install @sentientui/react, write .env.local, and scaffold
+                       an example component.
+
+Options
+  --key <pk_...>       Publishable API key to write into .env.local. Omit it to
+                       use keyless local mode, which returns deterministic
+                       simulated decisions and needs no account.
+  --yes, -y            Accept defaults without prompting (the default today).
+  --help, -h           Show this help.
+  --version, -v        Print the CLI version.
+
+Notes
+  init does NOT edit your layout. It prints the snippet \u2014 you must wrap your app
+  in <AdaptiveRoot> yourself, or nothing adapts and nothing is tracked.
+
+  Verify an install by loading the app with ?sentient_persona=buyer and then
+  ?sentient_persona=deal_seeker; the two should render differently.
+
+Docs   https://sentient-ui.com/docs/developers#cli
+API    https://api.sentient-ui.com/openapi.json`;
 function parseArgs(argv) {
   const args = [...argv];
   const command = args.shift();
   let key;
+  let help = command === "--help" || command === "-h";
+  let version = command === "--version" || command === "-v";
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg === "--key") {
@@ -319,12 +350,24 @@ function parseArgs(argv) {
       i++;
     } else if (arg.startsWith("--key=")) {
       key = arg.slice("--key=".length);
+    } else if (arg === "--help" || arg === "-h") {
+      help = true;
+    } else if (arg === "--version" || arg === "-v") {
+      version = true;
     }
   }
-  return { command, key };
+  return { command, key, help, version };
 }
 function main(argv) {
-  const { command, key } = parseArgs(argv);
+  const { command, key, help, version } = parseArgs(argv);
+  if (version) {
+    console.log(VERSION);
+    return;
+  }
+  if (help) {
+    console.log(USAGE);
+    return;
+  }
   if (command === "init") {
     try {
       runInit({ cwd: process.cwd(), key });
@@ -333,8 +376,13 @@ function main(argv) {
       process.exit(1);
     }
   } else {
-    console.log("Usage: npx @sentientui/cli init [--key pk_...] [--yes]");
-    process.exit(command ? 1 : 0);
+    if (command) {
+      console.error(`[sentientui] unknown command: ${command}
+`);
+      console.error(USAGE);
+      process.exit(1);
+    }
+    console.log(USAGE);
   }
 }
 function isRunAsScript() {

package/dist/index.js

@@ -273,10 +273,41 @@ function runInit(opts) {
 }
 
 // src/index.ts
+var VERSION = true ? "0.3.0" : "0.0.0-dev";
+var USAGE = `SentientUI CLI \u2014 adaptive UI personalization for the web
+
+Usage
+  npx @sentientui/cli <command> [options]
+
+Commands
+  init                 Set up SentientUI in an existing React app: detect the
+                       framework (Next.js App/Pages Router, Vite, Remix, CRA),
+                       install @sentientui/react, write .env.local, and scaffold
+                       an example component.
+
+Options
+  --key <pk_...>       Publishable API key to write into .env.local. Omit it to
+                       use keyless local mode, which returns deterministic
+                       simulated decisions and needs no account.
+  --yes, -y            Accept defaults without prompting (the default today).
+  --help, -h           Show this help.
+  --version, -v        Print the CLI version.
+
+Notes
+  init does NOT edit your layout. It prints the snippet \u2014 you must wrap your app
+  in <AdaptiveRoot> yourself, or nothing adapts and nothing is tracked.
+
+  Verify an install by loading the app with ?sentient_persona=buyer and then
+  ?sentient_persona=deal_seeker; the two should render differently.
+
+Docs   https://sentient-ui.com/docs/developers#cli
+API    https://api.sentient-ui.com/openapi.json`;
 function parseArgs(argv) {
   const args = [...argv];
   const command = args.shift();
   let key;
+  let help = command === "--help" || command === "-h";
+  let version = command === "--version" || command === "-v";
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg === "--key") {
@@ -284,12 +315,24 @@ function parseArgs(argv) {
       i++;
     } else if (arg.startsWith("--key=")) {
       key = arg.slice("--key=".length);
+    } else if (arg === "--help" || arg === "-h") {
+      help = true;
+    } else if (arg === "--version" || arg === "-v") {
+      version = true;
     }
   }
-  return { command, key };
+  return { command, key, help, version };
 }
 function main(argv) {
-  const { command, key } = parseArgs(argv);
+  const { command, key, help, version } = parseArgs(argv);
+  if (version) {
+    console.log(VERSION);
+    return;
+  }
+  if (help) {
+    console.log(USAGE);
+    return;
+  }
   if (command === "init") {
     try {
       runInit({ cwd: process.cwd(), key });
@@ -298,8 +341,13 @@ function main(argv) {
       process.exit(1);
     }
   } else {
-    console.log("Usage: npx @sentientui/cli init [--key pk_...] [--yes]");
-    process.exit(command ? 1 : 0);
+    if (command) {
+      console.error(`[sentientui] unknown command: ${command}
+`);
+      console.error(USAGE);
+      process.exit(1);
+    }
+    console.log(USAGE);
   }
 }
 function isRunAsScript() {

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@sentientui/cli",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "SentientUI CLI — `npx @sentientui/cli init` sets up adaptive UI in an existing React app (installs the SDK, writes env config, scaffolds an example, and prints the wrap instructions)",
   "license": "MIT",
   "homepage": "https://sentient-ui.com",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/casancam/SentientUI.git",
+    "url": "git+https://github.com/SentientUI/sdk.git",
     "directory": "packages/cli"
   },
+  "bugs": "https://github.com/SentientUI/sdk/issues",
   "keywords": [
     "cli",
     "sentientui",