epismo 1.18.2 → 1.20.0

package/README.md

@@ -39,7 +39,14 @@ The npm package contains a dependency-free JavaScript launcher and all supported
 
 ## Quick start
 
-Browse Public Playbooks without an account:
+Browse public cases without an account:
+
+```sh
+epismo case popular
+epismo case get CASE_ID
+```
+
+Public playbooks work the same way:
 
 ```sh
 epismo playbook list
@@ -52,6 +59,9 @@ Log in for search, private data, and writes:
 epismo login
 epismo workspace list
 epismo workspace use acme # optional: save a default workspace by ID or handle
+epismo workspace member invite teammate@example.com
+epismo workspace invitation revoke INVITATION_ID
+epismo case start --title "Customer Onboarding"
 epismo --workspace acme playbook search onboarding
 epismo playbook resource list --kind cli
 epismo playbook init --title Onboarding > playbook.json
@@ -60,32 +70,33 @@ epismo playbook create --definition @playbook.json
 
 `epismo workspace checkout <workspace-id>` starts a hosted subscription checkout. If the workspace has a cancellation scheduled for the end of its current billing period, it resumes that subscription instead of creating a second one.
 
-## Playbook access
-
-Use `visibility` and explicit editors instead of a raw ACL:
-
-```sh
-epismo playbook access get PLAYBOOK_ID
-epismo playbook access set PLAYBOOK_ID --visibility public --editors USER_ID,TEAM_ID
-epismo playbook owner PLAYBOOK_ID --owner-id WORKSPACE_OR_USER_ID
-```
-
-`public` permits published reads only. Editors can read and edit Playbook content; the owner, and every member of a Workspace-owned Playbook, are implicit and are not included in `--editors`. Workspace members can read and edit Playbooks owned by a Workspace they belong to. Owner managers, including Workspace Owners and Admins for a Workspace-owned Playbook, manage access, public visibility, and archive Playbooks or historical versions. Any member may create a Playbook owned by a Workspace they belong to, or move a personally owned private Playbook into it with `playbook owner`.
-
 ## Cases and handoffs
 
-Start a Case, append timeline records, connect dependent workflows, and explore the DAG:
+Start a case, append timeline records, connect dependent workflows, and explore the DAG:
 
 ```sh
 epismo case start --title "Customer Onboarding"
 epismo case record append CASE_ID --kind output --content "Completed setup"
 epismo case record update RECORD_ID --content "Revised setup notes"
 epismo case record delete RECORD_ID
-epismo case handoff FIRST_CASE_ID --to-case-id SECOND_CASE_ID
-epismo case handoff graph CASE_ID --scope connected
+epismo case handoff create FIRST_CASE_ID --to-case-id SECOND_CASE_ID
+epismo case handoff remove CASE_ID HANDOFF_ID
+epismo case handoff graph get CASE_ID --scope connected
 epismo case record list CASE_ID --scope ancestors
 ```
 
+## Playbook access
+
+Use `visibility` and explicit editors instead of a raw ACL:
+
+```sh
+epismo playbook access get PLAYBOOK_ID
+epismo playbook access set PLAYBOOK_ID --visibility public --editors USER_ID,TEAM_ID
+epismo playbook owner transfer PLAYBOOK_ID --owner-id WORKSPACE_OR_USER_ID
+```
+
+`public` permits published reads only. Editors can read and edit playbook content; the owner, and every member of a Workspace-owned playbook, are implicit and are not included in `--editors`. Workspace members can read and edit playbooks owned by a Workspace they belong to. Only the owner (including Workspace Owners and Admins for a Workspace-owned playbook) can manage access, public visibility, and archive playbooks or historical versions. Any member may create a playbook owned by a Workspace they belong to, or move a personally owned private playbook into it with `playbook owner transfer`.
+
 Run `epismo --help` for command groups, or append `--help` to any group or command for its options.
 
 Use `epismo examples` for common workflows, `epismo doctor` to inspect local setup, and `epismo completion zsh` (or `bash`, `fish`, `powershell`) to install shell completion.
@@ -118,8 +129,8 @@ Progress and warnings use a common event envelope:
 Commands that accept a request body support inline JSON, a file, or stdin:
 
 ```sh
-epismo playbook create --input @playbook.json
 epismo case record append CASE_ID --input - < record.json
+epismo playbook create --input @playbook.json
 ```
 
 Explicit flags override fields supplied through `--input`. Mutations create an idempotency key automatically unless you provide `--idempotency-key` or `idempotency_key` in the input.
@@ -130,17 +141,17 @@ The default output is JSON for scripts and agents. Choose a human-friendly outpu
 
 ```sh
 epismo workspace list --output table
+epismo case list --output jsonl
 epismo credit checkout --quantity 500 --output value --field checkout_url
-epismo task list --all --output jsonl
 epismo playbook search --query onboarding --jq '.playbooks[] | .id'
 ```
 
 Global options may appear before or after the command:
 
 ```sh
+EPISMO_WORKSPACE=acme epismo case list
 epismo --workspace acme playbook list
 epismo -w acme task list --all
-EPISMO_WORKSPACE=acme epismo case list
 ```
 
 Workspace references accept an exact ID or unique handle. The effective workspace is chosen in this order: `--workspace`, `EPISMO_WORKSPACE`, a workspace-scoped token, then the saved default workspace. A scoped token cannot grant access outside its scope.
@@ -153,7 +164,7 @@ Workspace references accept an exact ID or unique handle. The effective workspac
 
 `epismo login` opens a browser-based OAuth login. With `--email`, it automatically uses your organization SSO when available, otherwise it prompts for an email code.
 
-`epismo playbook list`, UUID-based `epismo playbook get`, `epismo case get`, `epismo case popular`, `epismo case record list`, and `epismo case handoff graph` work before login for Public Playbooks and Public Cases. Public Case reads expose the current title, input, records, and readable handoffs; tasks, assignment, and collaborator identities remain restricted to work collaborators. `case get` includes the latest five records; pass its `records_next_cursor` to `case record list --cursor` with `--scope self` for older public records. Use `case popular --playbook-id <id> --lang ja,en` to filter discovery. The CLI creates a stable random `anonymousId` in its config for analytics and fair-use rate limiting; it is not an authentication credential. Search, aliases, private data, live Case work, and writes still require login.
+`epismo case get`, `epismo case popular`, `epismo case record list`, `epismo case handoff graph get`, `epismo playbook list`, and UUID-based `epismo playbook get` work before login for public cases and public playbooks. Public case reads expose the current title, input, records, and readable handoffs; tasks, assignment, and collaborator identities remain restricted to work collaborators. `case get` includes the latest five records; pass its `records_next_cursor` to `case record list --cursor` with `--scope self` for older public records. Use `case popular --playbook-id <id> --lang ja,en` to filter discovery. The CLI creates a stable random `anonymousId` in its config for analytics and fair-use rate limiting; it is not an authentication credential. Search, aliases, private data, live case work, and writes still require login.
 
 For CI or other non-interactive use, create a workspace-scoped token and pass it with `EPISMO_TOKEN`:
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "epismo",
-  "version": "1.18.2",
-  "description": "Dependency-free CLI for discovering, authoring, and coordinating reusable AI Playbooks.",
+  "version": "1.20.0",
+  "description": "Native CLI for Epismo. Continue work across people and AI agents; JSON for terminals, scripts, and workflows.",
   "type": "module",
   "license": "Apache-2.0",
   "homepage": "https://epismo.ai",
@@ -12,6 +12,7 @@
   "bugs": "https://github.com/epismoai/cli/issues",
   "keywords": [
     "epismo",
+    "case",
     "playbook",
     "workflow",
     "agent",