@camunda8/cli 2.0.0-alpha.1 → 2.0.0-alpha.3

package/README.md

@@ -5,15 +5,20 @@ A minimal-dependency CLI for Camunda 8 operations built on top of `@camunda8/orc
 ## Features
 
 - **Minimal Dependencies**: Only one runtime dependency (`@camunda8/orchestration-cluster-api`)
-- **Native TypeScript**: Runs directly with Node.js 22.18+ (no compilation needed)
 - **Multi-Tenant Support**: Full support for multi-tenancy across all operations
 - **Profile Management**: Store and manage multiple cluster configurations
 - **Camunda Modeler Integration**: Automatically import and use profiles from Camunda Modeler
 - **Plugin System**: Extend c8ctl with custom commands via npm packages
-- **Session State**: Maintain active profile, tenant, and output preferences
-- **Building Block Deployment**: Automatic prioritization of `_bb-` folders during deployment
+- **Building Block Deployment**: Automatic prioritization of `*_bb-*` folders during deployment
+- **Watch Mode**: Monitors a folder for changes to `*.{bpmn,dmn,form}` and auto-redeploys 
 - **Flexible Output**: Switch between human-readable text and JSON output modes
 
+## Beware the 🤖
+
+*Full transparency*:  
+this cli is also a pilot-coding experiment.  
+Guided by humans, the codebase is (mostly) built by your friendly neighborhood LLM, fully dogfooding the Human-in-the-Loop pattern.
+
 ## Architecture
 
 ### Core Components
@@ -71,10 +76,21 @@ c8ctl list pi
 # Or using full command name
 c8ctl list process-instances
 
+# List process definitions (using alias 'pd')
+c8ctl list pd
+c8ctl list process-definitions
+
 # Get process instance by key
 c8ctl get pi 123456
 c8ctl get process-instance 123456
 
+# Get process definition by key
+c8ctl get pd 123456
+c8ctl get process-definition 123456
+
+# Get process definition XML
+c8ctl get pd 123456 --xml
+
 # Create process instance
 c8ctl create pi --bpmnProcessId=myProcess
 c8ctl create process-instance --bpmnProcessId=myProcess
@@ -85,10 +101,57 @@ c8ctl deploy ./my-process.bpmn
 # Deploy current directory
 c8ctl deploy
 
+# Watch mode (using alias 'w')
+c8ctl w
+c8ctl watch
+
 # Deploy and start process (run)
 c8ctl run ./my-process.bpmn
 ```
 
+### Shell Completion
+
+c8ctl supports shell completion for `bash`, `zsh`, and `fish`. To enable completion:
+
+#### Bash
+
+```bash
+# Generate and source completion script
+c8ctl completion bash > ~/.c8ctl-completion.bash
+echo 'source ~/.c8ctl-completion.bash' >> ~/.bashrc
+source ~/.bashrc
+```
+
+Or for immediate use in the current session:
+
+```bash
+source <(c8ctl completion bash)
+```
+
+#### Zsh
+
+```bash
+# Generate and source completion script
+c8ctl completion zsh > ~/.c8ctl-completion.zsh
+echo 'source ~/.c8ctl-completion.zsh' >> ~/.zshrc
+source ~/.zshrc
+```
+
+Or for immediate use in the current session:
+
+```bash
+source <(c8ctl completion zsh)
+```
+
+#### Fish
+
+```bash
+# Generate and install completion script
+c8ctl completion fish > ~/.config/fish/completions/c8ctl.fish
+```
+
+Fish will automatically load the completion on next shell start.
+
 ### Credential Resolution
 
 Credentials are resolved in the following order:
@@ -265,6 +328,7 @@ When plugins are loaded, their commands automatically appear in `c8ctl help` out
 ### Resource Aliases
 
 - `pi` = process-instance(s)
+- `pd` = process-definition(s)
 - `ut` = user-task(s)
 - `inc` = incident(s)
 - `msg` = message
@@ -277,7 +341,7 @@ c8ctl <verb> <resource> [arguments] [flags]
 
 **Verbs**: list, get, create, cancel, complete, fail, activate, resolve, publish, correlate, deploy, run, add, remove, use, output
 
-**Resources**: process-instance, user-task, incident, job, message, topology, profile, tenant
+**Resources**: process-instance, process-definition, user-task, incident, job, message, topology, profile, tenant
 
 ## Testing
 
@@ -302,6 +366,9 @@ Integration tests require a running Camunda 8 instance at `http://localhost:8080
 
 ## Development
 
+- **Native TypeScript**: Runs directly with Node.js 22.18+ (no compilation needed)
+
+
 ### Project Structure
 
 ```
@@ -388,7 +455,7 @@ Modeler profiles are:
 
 ## License
 
-MIT
+Apache 2.0 - see LICENSE.md 
 
 ## Contributing
 

package/dist/commands/completion.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shell completion commands
+ */
+/**
+ * Show completion command
+ */
+export declare function showCompletion(shell?: string): void;
+//# sourceMappingURL=completion.d.ts.map

package/dist/commands/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2jBH;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CA0BnD"}