@shuffl/cli 0.7.5 → 0.7.7

package/README.md

@@ -14,7 +14,7 @@ shuffl --help
 
 Or run it without installing: `npx @shuffl/cli --help`. To pin it in a project, add `@shuffl/cli` as a dev dependency and run `npx shuffl`. The CLI is built on [`@shuffl/sdk`](https://www.npmjs.com/package/@shuffl/sdk) and released with it under one version; its operation names, help and input flags are generated from the public API contract.
 
-`shuffl permissions list --json` discovers endpoint grants. Each command’s `--help` shows its permission ID and Read/Write classification. Create a delegated key with `shuffl credentials api create --input-file key-command.json --json`, using a `permissions` array such as `["users.list", "groups.save"]`. The issuer must hold `credentials.api.create` and every requested permission. See [endpoint permissions](https://shuffl-rebuild.vercel.app/docs/api-permissions).
+`shuffl permissions list --json` discovers endpoint grants. Each command’s `--help` shows its permission ID and Read/Write classification. Create a delegated key with `shuffl credentials api create --input-file key-command.json --json`, using a `permissions` array such as `["users.list", "groups.save"]`. The issuer must hold `credentials.api.create` and every requested permission. See [endpoint permissions](https://shuffl.ai/docs/api-permissions).
 
 ## Authentication and commands
 
@@ -22,7 +22,7 @@ Create an API key in **Settings → API keys**, choosing only the endpoint permi
 
 ```sh
 # Your credential manager supplies the token on stdin.
-credential-command | shuffl login --base-url https://YOUR-SHUFFL-HOST --token-stdin
+credential-command | shuffl login --base-url https://shuffl.ai --token-stdin
 
 shuffl users list --limit 25 --json
 shuffl programs list --json
@@ -35,7 +35,7 @@ shuffl logout
 
 Alternatively set `SHUFFL_API_KEY` and `SHUFFL_BASE_URL` through your environment. Tokens are never accepted as command-line arguments or printed after login. Saved credentials are stored with mode `0600` under `$XDG_CONFIG_HOME/shuffl/config.json` (default `~/.config/shuffl/config.json`). `SHUFFL_CONFIG_DIR` overrides the Shuffl directory. Logout removes the local copy; revoke the token in Settings to disable other copies.
 
-The saved token cannot be used with a different `--base-url`; log into that server or supply an explicit environment token. Login verifies the token before saving it.
+The saved token cannot be used with a different `--base-url`; log into that server or supply an explicit environment token. Login verifies the token before saving it. For production, use `https://shuffl.ai`. If your saved login uses the old Vercel host, log in again with the canonical URL; environment-based setups must update `SHUFFL_BASE_URL`.
 
 Select the team when creating the token. Each token controls exactly that team; switching teams requires a token issued there. There is no team flag that can broaden the token's authority. `shuffl teams current --json` reads back the selected team. `users list` accepts `--limit` (1–100) and `--cursor` from the previous response's `nextCursor`; other resources retain the pagination fields shown by their command help.
 
@@ -45,7 +45,7 @@ Every operation accepts `--input JSON`, `--input -` for stdin, or `--input-file
 
 Programs are created paused by default. Keep the same `requestKey` for a retry, and use `expectedRevision` to update the version you reviewed. Activating a program enables its schedule. A requested run is queued durably and can be inspected with `shuffl runs get --id RUN_ID`.
 
-Management resources use the same nested command names as the [SDK](https://shuffl-rebuild.vercel.app/docs/sdk):
+Management resources use the same nested command names as the [SDK](https://shuffl.ai/docs/sdk):
 
 ```sh
 shuffl groups list --json
@@ -61,16 +61,16 @@ Management writes require `requestKey` and return `{receipt, result}`. Sensitive
 Commands under `shuffl company` take a company key (`shuffl_company_`) from **Company settings → API keys** instead of a workspace key:
 
 ```sh
-credential-command | shuffl login --company --base-url https://YOUR-SHUFFL-HOST --token-stdin
+credential-command | shuffl login --company --base-url https://shuffl.ai --token-stdin
 shuffl company current --json
 shuffl company members list --limit 100 --json
 shuffl company members remove --user-id USER_ID --json
 shuffl logout --company
 ```
 
-Or set `SHUFFL_COMPANY_KEY` and `SHUFFL_BASE_URL`. The company key is saved in `company.json` next to `config.json`, and only `shuffl company` commands send it; `shuffl logout --company` removes it. Each command's `--help` names its company permission. See [company keys](https://shuffl-rebuild.vercel.app/docs/api-permissions#company-keys).
+Or set `SHUFFL_COMPANY_KEY` and `SHUFFL_BASE_URL`. The company key is saved in `company.json` next to `config.json`, and only `shuffl company` commands send it; `shuffl logout --company` removes it. Each command's `--help` names its company permission. See [company keys](https://shuffl.ai/docs/api-permissions#company-keys).
 
-Full guide: [Use the Shuffl CLI](https://shuffl-rebuild.vercel.app/docs/cli).
+Full guide: [Use the Shuffl CLI](https://shuffl.ai/docs/cli).
 
 ## License
 

package/dist/commands.generated.js

@@ -3212,6 +3212,10 @@ export const commands = [
                                 const: 'mentorship.members.setStatus',
                                 type: 'string',
                             },
+                            {
+                                const: 'mentorship.mentors.choose',
+                                type: 'string',
+                            },
                             {
                                 const: 'mentorship.mine',
                                 type: 'string',
@@ -3248,6 +3252,18 @@ export const commands = [
                                 const: 'mentorship.programs.setStatus',
                                 type: 'string',
                             },
+                            {
+                                const: 'mentorship.requests.answer',
+                                type: 'string',
+                            },
+                            {
+                                const: 'mentorship.sessions.remove',
+                                type: 'string',
+                            },
+                            {
+                                const: 'mentorship.sessions.save',
+                                type: 'string',
+                            },
                             {
                                 const: 'mentorship.settings.get',
                                 type: 'string',
@@ -8476,6 +8492,37 @@ export const commands = [
         scope: 'mentorship:write',
         summary: 'Take someone off a mentorship program, or put them back',
     },
+    {
+        access: 'write',
+        command: ['mentorship', 'mentors', 'choose'],
+        input: {
+            $schema: 'https://json-schema.org/draft/2020-12/schema',
+            additionalProperties: false,
+            properties: {
+                confirm: {
+                    const: 'mentorship.mentors.choose',
+                    type: 'string',
+                },
+                mentorId: {
+                    type: 'string',
+                },
+                programId: {
+                    type: 'string',
+                },
+                requestKey: {
+                    maxLength: 128,
+                    minLength: 1,
+                    type: 'string',
+                },
+            },
+            required: ['mentorId', 'programId', 'confirm', 'requestKey'],
+            type: 'object',
+        },
+        path: ['mentorship', 'mentors', 'choose'],
+        permission: 'mentorship.mentors.choose',
+        scope: 'self:write',
+        summary: 'Choose your mentor from the mentors Shuffl suggests, in a program where mentees choose',
+    },
     {
         access: 'read',
         command: ['mentorship', 'mine'],
@@ -8686,6 +8733,18 @@ export const commands = [
                 id: {
                     type: 'string',
                 },
+                menteesChoose: {
+                    anyOf: [
+                        {
+                            const: false,
+                            type: 'boolean',
+                        },
+                        {
+                            const: true,
+                            type: 'boolean',
+                        },
+                    ],
+                },
                 mentorCapacity: {
                     type: 'number',
                 },
@@ -8753,6 +8812,117 @@ export const commands = [
         scope: 'mentorship:write',
         summary: 'Turn mentorship programs on, pause one, or archive one and end its pairs',
     },
+    {
+        access: 'write',
+        command: ['mentorship', 'requests', 'answer'],
+        input: {
+            $schema: 'https://json-schema.org/draft/2020-12/schema',
+            additionalProperties: false,
+            properties: {
+                confirm: {
+                    const: 'mentorship.requests.answer',
+                    type: 'string',
+                },
+                decision: {
+                    anyOf: [
+                        {
+                            const: 'accept',
+                            type: 'string',
+                        },
+                        {
+                            const: 'pass',
+                            type: 'string',
+                        },
+                    ],
+                },
+                pairId: {
+                    type: 'string',
+                },
+                requestKey: {
+                    maxLength: 128,
+                    minLength: 1,
+                    type: 'string',
+                },
+            },
+            required: ['decision', 'pairId', 'confirm', 'requestKey'],
+            type: 'object',
+        },
+        path: ['mentorship', 'requests', 'answer'],
+        permission: 'mentorship.requests.answer',
+        scope: 'self:write',
+        summary: 'Accept or pass on a mentee who chose you as their mentor',
+    },
+    {
+        access: 'write',
+        command: ['mentorship', 'sessions', 'remove'],
+        input: {
+            $schema: 'https://json-schema.org/draft/2020-12/schema',
+            additionalProperties: false,
+            properties: {
+                confirm: {
+                    const: 'mentorship.sessions.remove',
+                    type: 'string',
+                },
+                pairId: {
+                    type: 'string',
+                },
+                requestKey: {
+                    maxLength: 128,
+                    minLength: 1,
+                    type: 'string',
+                },
+                sessionId: {
+                    type: 'string',
+                },
+            },
+            required: ['pairId', 'sessionId', 'confirm', 'requestKey'],
+            type: 'object',
+        },
+        path: ['mentorship', 'sessions', 'remove'],
+        permission: 'mentorship.sessions.remove',
+        scope: 'self:write',
+        summary: 'Remove your notes from a mentorship meeting',
+    },
+    {
+        access: 'write',
+        command: ['mentorship', 'sessions', 'save'],
+        input: {
+            $schema: 'https://json-schema.org/draft/2020-12/schema',
+            additionalProperties: false,
+            properties: {
+                confirm: {
+                    const: 'mentorship.sessions.save',
+                    type: 'string',
+                },
+                heldOn: {
+                    type: 'string',
+                },
+                nextStep: {
+                    type: 'string',
+                },
+                notes: {
+                    type: 'string',
+                },
+                pairId: {
+                    type: 'string',
+                },
+                requestKey: {
+                    maxLength: 128,
+                    minLength: 1,
+                    type: 'string',
+                },
+                sessionId: {
+                    type: 'string',
+                },
+            },
+            required: ['heldOn', 'pairId', 'confirm', 'requestKey'],
+            type: 'object',
+        },
+        path: ['mentorship', 'sessions', 'save'],
+        permission: 'mentorship.sessions.save',
+        scope: 'self:write',
+        summary: 'Add or change your notes from a mentorship meeting: what you talked about and one thing to try',
+    },
     {
         access: 'read',
         command: ['mentorship', 'settings', 'get'],

package/package.json

@@ -1,8 +1,8 @@
 {
   "dependencies": {
     "@orpc/client": "1.15.3",
-    "@shuffl/api-contracts": "0.7.5",
-    "@shuffl/sdk": "0.7.5"
+    "@shuffl/api-contracts": "0.7.7",
+    "@shuffl/sdk": "0.7.7"
   },
   "description": "Shuffl command line: every public API operation as a scriptable command with JSON output.",
   "engines": {
@@ -19,7 +19,7 @@
     "LICENSE",
     "README.md"
   ],
-  "homepage": "https://shuffl-rebuild.vercel.app/docs/sdk",
+  "homepage": "https://shuffl.ai/docs/sdk",
   "keywords": [
     "shuffl",
     "cli",
@@ -33,7 +33,7 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "bin": {
     "shuffl": "./dist/bin.js"
   }