@bpmnkit/cli 0.0.9 → 0.0.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 urbanisierung
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,113 +1,112 @@
-# casen
+<div align="center">
+  <img src="https://raw.githubusercontent.com/bpmnkit/monorepo/main/doc/logos/logo-2-gateway.svg" width="72" height="72" alt="BPMN Kit logo">
+  <h1>@bpmnkit/cli</h1>
+  <p>Command-line interface for Camunda 8 — deploy, manage, and monitor processes from the terminal</p>
 
-CLI for the [Camunda 8 Orchestration Cluster REST API (v2)](https://docs.camunda.io/docs/apis-tools/orchestration-cluster-api-rest/orchestration-cluster-api-rest-overview/).
+  [![npm](https://img.shields.io/npm/v/@bpmnkit/cli?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/cli)
+  [![license](https://img.shields.io/npm/l/@bpmnkit/cli?style=flat-square)](https://github.com/bpmnkit/monorepo/blob/main/LICENSE)
+  [![typescript](https://img.shields.io/badge/TypeScript-strict-6244d7?style=flat-square&logo=typescript&logoColor=white)](https://github.com/bpmnkit/monorepo)
 
-Commands are auto-generated from the official OpenAPI specs — every resource and operation stays in sync automatically. See [DOCUMENTATION.md](./DOCUMENTATION.md) for the full command reference.
+  [Documentation](https://docs.bpmnkit.com) · [GitHub](https://github.com/bpmnkit/monorepo) · [Changelog](https://github.com/bpmnkit/monorepo/blob/main/apps/cli/CHANGELOG.md)
+</div>
 
-## Features
+---
 
-- **All API resources** — process instances, jobs, user tasks, decisions, users, groups, tenants, and more
-- **Multiple profiles** — store named connection configs and switch between them instantly
-- **Three output formats** — human-readable table (default), `--output json`, `--output yaml`
-- **Shell completions** — bash, zsh, and fish
-- **Zero dependencies** — no runtime requirements beyond Node.js
+## Overview
 
-## Installation
+`@bpmnkit/cli` provides the `casen` command-line tool for interacting with Camunda 8 clusters. Manage profiles, deploy processes, run queries, and generate connector templates — all from your terminal.
 
-```bash
-# From the monorepo root
-pnpm build
+## Installation
 
-# Then link globally (optional)
-npm link ./apps/cli
+```sh
+npm install -g @bpmnkit/cli
+# or
+pnpm add -g @bpmnkit/cli
 ```
 
-## Quick start
-
-**1. Create a profile**
+## Quick Start
 
-```bash
-# Bearer token (local / self-managed)
-casen profile create local \
-  --base-url http://localhost:8080/v2 \
-  --auth-type bearer \
-  --token my-token
+### Configure a profile
 
-# OAuth2 (Camunda SaaS)
-casen profile create prod \
-  --base-url https://<cluster-id>.camunda.io/v2 \
-  --auth-type oauth2 \
-  --client-id <client-id> \
-  --client-secret <client-secret> \
-  --token-url https://login.cloud.camunda.io/oauth/token
+```sh
+casen profile add my-cluster
+# Interactive prompts for base URL and auth type
 ```
 
-The first profile created becomes the active profile automatically.
+### Deploy a process
 
-**Import from a Camunda Cloud credentials file**
-
-When you create a client in Camunda Cloud, you can download a credentials file containing `export KEY='VALUE'` declarations. Import it directly:
+```sh
+casen deploy order-process.bpmn
+```
 
-```bash
-casen profile import prod ./camunda-credentials.sh
+### List process instances
 
-# or pipe via stdin
-cat camunda-credentials.sh | casen profile import prod -
+```sh
+casen instances list --state active
 ```
 
-The file must contain at least:
+## Commands
 
-| Variable | Fallback |
-|----------|----------|
-| `ZEEBE_REST_ADDRESS` | _(required)_ |
-| `CAMUNDA_CLIENT_ID` | `ZEEBE_CLIENT_ID` |
-| `CAMUNDA_CLIENT_SECRET` | `ZEEBE_CLIENT_SECRET` |
-| `CAMUNDA_OAUTH_URL` | `ZEEBE_AUTHORIZATION_SERVER_URL` |
+### Profile management
 
-**2. Run a command**
+| Command | Description |
+|---------|-------------|
+| `casen profile list` | List all configured profiles |
+| `casen profile add <name>` | Add a new profile (interactive) |
+| `casen profile use <name>` | Switch the active profile |
+| `casen profile remove <name>` | Delete a profile |
 
-```bash
-casen process-instance list --filter '{"state":"ACTIVE"}'
-casen user-task list --filter '{"assignee":"alice"}'
-casen process-instance create --data '{"processDefinitionId":"order-process"}'
-```
-
-## Profiles
+### Process & deployment
 
-Profiles store connection configuration in the OS config directory:
+| Command | Description |
+|---------|-------------|
+| `casen deploy <file>` | Deploy a BPMN, DMN, or form file |
+| `casen processes list` | List deployed process definitions |
+| `casen instances list` | List process instances (--state filter) |
+| `casen instances cancel <key>` | Cancel a running instance |
 
-| Platform | Location |
-|----------|----------|
-| Linux | `$XDG_CONFIG_HOME/casen/config.json` or `~/.config/casen/config.json` |
-| macOS | `~/Library/Application Support/casen/config.json` |
-| Windows | `%APPDATA%\casen\config.json` |
+### Incidents & jobs
 
-Use `--profile <name>` on any command to temporarily override the active profile.
+| Command | Description |
+|---------|-------------|
+| `casen incidents list` | List open incidents |
+| `casen incidents resolve <key>` | Resolve an incident |
+| `casen jobs list` | List active jobs |
 
-## Output formats
+### Connector generation
 
-Results can be printed as a table (default), JSON, or YAML via `--output json` / `--output yaml`. Colors and table formatting are automatically disabled when stdout is not a TTY or when `NO_COLOR` is set.
+| Command | Description |
+|---------|-------------|
+| `casen connector generate <spec>` | Generate element templates from OpenAPI/Swagger |
 
-## Shell completions
+## Global options
 
-```bash
-# zsh
-mkdir -p ~/.zfunc && casen completion zsh > ~/.zfunc/_casen
-# add to ~/.zshrc: fpath=(~/.zfunc $fpath) && autoload -Uz compinit && compinit
+| Flag | Description |
+|------|-------------|
+| `--profile <name>` | Use a specific profile for this command |
+| `--json` | Output as JSON (machine-readable) |
+| `--help` | Show help |
 
-# bash
-casen completion bash >> ~/.bash_completion
+---
 
-# fish
-casen completion fish > ~/.config/fish/completions/casen.fish
-```
+## Related Packages
 
-## Help
+| Package | Description |
+|---------|-------------|
+| [`@bpmnkit/core`](https://www.npmjs.com/package/@bpmnkit/core) | BPMN/DMN/Form parser, builder, layout engine |
+| [`@bpmnkit/canvas`](https://www.npmjs.com/package/@bpmnkit/canvas) | Zero-dependency SVG BPMN viewer |
+| [`@bpmnkit/editor`](https://www.npmjs.com/package/@bpmnkit/editor) | Full-featured interactive BPMN editor |
+| [`@bpmnkit/engine`](https://www.npmjs.com/package/@bpmnkit/engine) | Lightweight BPMN process execution engine |
+| [`@bpmnkit/feel`](https://www.npmjs.com/package/@bpmnkit/feel) | FEEL expression language parser & evaluator |
+| [`@bpmnkit/plugins`](https://www.npmjs.com/package/@bpmnkit/plugins) | 22 composable canvas plugins |
+| [`@bpmnkit/api`](https://www.npmjs.com/package/@bpmnkit/api) | Camunda 8 REST API TypeScript client |
+| [`@bpmnkit/ascii`](https://www.npmjs.com/package/@bpmnkit/ascii) | Render BPMN diagrams as Unicode ASCII art |
+| [`@bpmnkit/ui`](https://www.npmjs.com/package/@bpmnkit/ui) | Shared design tokens and UI components |
+| [`@bpmnkit/profiles`](https://www.npmjs.com/package/@bpmnkit/profiles) | Shared auth, profile storage, and client factories for CLI & proxy |
+| [`@bpmnkit/operate`](https://www.npmjs.com/package/@bpmnkit/operate) | Monitoring & operations frontend for Camunda clusters |
+| [`@bpmnkit/connector-gen`](https://www.npmjs.com/package/@bpmnkit/connector-gen) | Generate connector templates from OpenAPI specs |
+| [`@bpmnkit/proxy`](https://www.npmjs.com/package/@bpmnkit/proxy) | Local AI bridge and Camunda API proxy server |
 
-```bash
-casen --help                       # Global help
-casen <resource> --help            # Resource-level help
-casen <resource> <command> --help  # Command-level help
-```
+## License
 
-For all available resources and commands see [DOCUMENTATION.md](./DOCUMENTATION.md).
+[MIT](https://github.com/bpmnkit/monorepo/blob/main/LICENSE) © BPMN Kit

package/package.json

@@ -1,32 +1,50 @@
 {
-	"name": "@bpmnkit/cli",
-	"version": "0.0.9",
-	"description": "Camunda v2 REST API command-line interface",
-	"type": "module",
-	"bin": {
-		"casen": "./dist/index.js"
-	},
-	"files": ["dist/**/*.js"],
-	"engines": {
-		"node": ">=20"
-	},
-	"scripts": {
-		"build": "tsc",
-		"typecheck": "tsc --noEmit",
-		"check": "biome check .",
-		"test": "vitest run"
-	},
-	"dependencies": {
-		"@bpmnkit/api": "workspace:*",
-		"@bpmnkit/ascii": "workspace:*",
-		"@bpmnkit/connector-gen": "workspace:*",
-		"@bpmnkit/profiles": "workspace:*"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/bpmnkit/monorepo"
-	}
-}
+  "name": "@bpmnkit/cli",
+  "version": "0.0.10",
+  "description": "Command-line interface for Camunda 8 — deploy, manage, and monitor processes from the terminal",
+  "type": "module",
+  "bin": {
+    "casen": "./dist/index.js"
+  },
+  "files": [
+    "README.md",
+    "dist/**/*.js"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@bpmnkit/api": "0.0.9",
+    "@bpmnkit/ascii": "0.0.9",
+    "@bpmnkit/connector-gen": "0.0.3",
+    "@bpmnkit/profiles": "0.0.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bpmnkit/monorepo"
+  },
+  "keywords": [
+    "camunda",
+    "bpmn",
+    "cli",
+    "terminal",
+    "zeebe",
+    "workflow",
+    "typescript",
+    "casen"
+  ],
+  "license": "MIT",
+  "homepage": "https://bpmnkit.com",
+  "bugs": {
+    "url": "https://github.com/bpmnkit/monorepo/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "check": "biome check .",
+    "test": "vitest run"
+  }
+}

package/dist/client.js

@@ -1,19 +0,0 @@
-import { AdminApiClient, CamundaClient } from "@bpmn-sdk/api";
-import { getActiveProfile, getProfile } from "./profile.js";
-function requireProfile(profileName) {
-    const profile = profileName ? getProfile(profileName) : getActiveProfile();
-    if (!profile) {
-        if (profileName) {
-            throw new Error(`Profile "${profileName}" not found. Run \`casen profile list\` to see available profiles.`);
-        }
-        throw new Error("No active profile. Create one with:\n\n  casen profile create <name> --base-url <url> --auth-type bearer --token <token>\n");
-    }
-    return profile;
-}
-export function createClientFromProfile(profileName) {
-    return new CamundaClient(requireProfile(profileName).config);
-}
-export function createAdminClientFromProfile(profileName) {
-    return new AdminApiClient(requireProfile(profileName).config);
-}
-//# sourceMappingURL=client.js.map

package/dist/profile.js

@@ -1,103 +0,0 @@
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir, platform } from "node:os";
-import { join } from "node:path";
-// ─── Config directory ─────────────────────────────────────────────────────────
-function configDir() {
-    const p = platform();
-    if (p === "win32")
-        return join(process.env.APPDATA ?? homedir(), "casen");
-    if (p === "darwin")
-        return join(homedir(), "Library", "Application Support", "casen");
-    return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "casen");
-}
-function configFilePath() {
-    return join(configDir(), "config.json");
-}
-// ─── Read / write ─────────────────────────────────────────────────────────────
-function readStore() {
-    try {
-        const raw = readFileSync(configFilePath(), "utf8");
-        const store = JSON.parse(raw);
-        if (!store.meta)
-            store.meta = {};
-        return store;
-    }
-    catch {
-        return { profiles: {}, active: null, meta: {} };
-    }
-}
-function writeStore(store) {
-    const dir = configDir();
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(configFilePath(), JSON.stringify(store, null, 2), "utf8");
-}
-// ─── Public API ───────────────────────────────────────────────────────────────
-export function listProfiles() {
-    const store = readStore();
-    return Object.entries(store.profiles).map(([name, config]) => ({
-        name,
-        apiType: store.meta[name]?.apiType ?? "c8",
-        config,
-        createdAt: store.meta[name]?.createdAt ?? null,
-    }));
-}
-export function getProfile(name) {
-    const store = readStore();
-    const config = store.profiles[name];
-    if (!config)
-        return undefined;
-    return {
-        name,
-        apiType: store.meta[name]?.apiType ?? "c8",
-        config,
-        createdAt: store.meta[name]?.createdAt ?? null,
-    };
-}
-export function getActiveProfile() {
-    const store = readStore();
-    if (!store.active)
-        return undefined;
-    return getProfile(store.active);
-}
-export function getActiveName() {
-    return readStore().active;
-}
-export function saveProfile(name, config, apiType = "c8") {
-    const store = readStore();
-    store.profiles[name] = config;
-    if (!store.meta[name]) {
-        store.meta[name] = { createdAt: new Date().toISOString(), apiType };
-    }
-    else {
-        store.meta[name].apiType = apiType;
-    }
-    // Auto-activate if this is the first profile
-    if (store.active === null)
-        store.active = name;
-    writeStore(store);
-}
-export function deleteProfile(name) {
-    const store = readStore();
-    if (!(name in store.profiles))
-        return false;
-    const { [name]: _removed, ...rest } = store.profiles;
-    store.profiles = rest;
-    if (store.active === name) {
-        const remaining = Object.keys(store.profiles);
-        store.active = remaining.length > 0 ? (remaining[0] ?? null) : null;
-    }
-    writeStore(store);
-    return true;
-}
-export function useProfile(name) {
-    const store = readStore();
-    if (!(name in store.profiles))
-        return false;
-    store.active = name;
-    writeStore(store);
-    return true;
-}
-export function getConfigFilePath() {
-    return configFilePath();
-}
-//# sourceMappingURL=profile.js.map