kctl-api 0.7.2__tar.gz → 0.7.3__tar.gz

{kctl_api-0.7.2 → kctl_api-0.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kctl-api
-Version: 0.7.2
+Version: 0.7.3
 Summary: Kodemeio API CLI - manage your FastAPI platform
 Author-email: Kodemeio <dev@kodeme.io>
 License-Expression: MIT

{kctl_api-0.7.2 → kctl_api-0.7.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kctl-api"
-version = "0.7.2"
+version = "0.7.3"
 description = "Kodemeio API CLI - manage your FastAPI platform"
 license = "MIT"
 requires-python = ">=3.12"

{kctl_api-0.7.2 → kctl_api-0.7.3}/skills/api-admin/SKILL.md

@@ -1,11 +1,9 @@
 ---
 name: api-admin
 description: >
-  FastAPI platform management via kctl-api CLI (55 groups, ~231 commands).
-  MUST use for ANY kctl-api operation.
-  Triggers on: "ai", "apps", "attach", "audit", "auth", "automation", "background-job", "bench", "breaking", "broadcast", "build", "cache", "call", "chat", "check", "check-safety", "checkout", "clean", "clients", "config", "connect", "connections", "consumers", "containers", "conversation", "conversations", "copilots", "correlation", "cors", "count", "coverage", "current", "dashboard", "db", "dd", "dead-letter", "deep", "delete-conversation", "deploy", "deps", "deps-check", "dev", "diff", "dl", "docker", "doctor", "down", "downgrade", "download", "dr", "ds", "du", "endpoint", "endpoints", "enqueue", "env", "errors", "expire-audit", "export", "files", "fl", "flush", "fmt", "follow", "generate", "graph", "hc", "headers", "health", "heartbeat", "history", "images", "info", "init", "install", "jo", "jobs", "kctl-api", "keys", "keys-by-prefix".
-  Auto-generated: 2026-04-05
-  registry_hash: c99de89d0de1
+  FastAPI platform management via kctl-api CLI (59 groups, ~236 commands). MUST use for ANY kctl-api operation. See SKILL.md ## Triggers for keywords.
+  Auto-generated: 2026-05-22
+  registry_hash: 92e9f30a4f23
 ---
 
 # api-admin — kctl-api CLI Reference
@@ -17,8 +15,8 @@ description: >
 ## Overview
 
 **CLI:** `kctl-api`
-**Command groups:** 55
-**Total commands:** ~231
+**Command groups:** 59
+**Total commands:** ~236
 **Install:** `cd cli && uv tool install --editable .`
 
 ## Global Options
@@ -32,6 +30,37 @@ description: >
 | `--profile`, `-p` | Config profile name |
 | `--version`, `-V` | Show version |
 
+## Quick Discovery (for AI agents)
+
+**DO NOT GUESS command paths or flag names.** Before invoking `kctl-api <group> <verb> ...`, use these AI-facing affordances:
+
+1. **Find a command by keyword** — substring filter, returns sorted leaf paths:
+   ```bash
+   kctl-api commands list --filter <keyword>
+   ```
+   Example: `kctl-api commands list --filter database` → all database-related commands in one call.
+
+2. **Inspect flags before invoking** — full param schema with
+   opts/defaults/required/choices/help:
+   ```bash
+   kctl-api commands tree --json | jq '.. | objects | select(.name == "<verb>") | .params'
+   ```
+   Reading the `params` array tells you exact flag names (`--lang`), short aliases (`-l`), defaults, required-vs-optional, and choices — eliminating the `No such option '--xxx'` failure mode.
+
+3. **Preview destructive operations without executing** — `--explain` is supported on selected write commands:
+   ```bash
+   kctl-api <group> <verb> <args> --explain
+   ```
+   Prints the planned action and exits 0. If `--explain` errors with "no such option", that command does not support it — fall back to verifying via `commands tree` schema inspection before running for real.
+
+4. **Errors are user-facing one-liners**, not Python tracebacks. A failed invocation shows `❌ <ErrorClass>: <message>` on stderr (or `{"error": ..., "message": ...}` JSON if `--json` was passed). Read the message — it usually tells you exactly what's missing.
+
+## Triggers
+
+Auto-invoke this skill when the user references any of these keywords:
+
+"ai", "apps", "attach", "audit", "auth", "automation", "background-job", "bench", "breaking", "broadcast", "build", "cache", "call", "chat", "check", "check-safety", "checkout", "clean", "clients", "commands", "completions", "config", "connect", "connections", "consumers", "containers", "conversation", "conversations", "copilots", "correlation", "cors", "count", "coverage", "current", "dashboard", "db", "dd", "dead-letter", "deep", "delete-conversation", "deploy", "deps", "deps-check", "dev", "diff", "dl", "docker", "doctor", "down", "downgrade", "download", "dr", "ds", "du", "endpoint", "endpoints", "enqueue", "env", "errors", "expire-audit", "export", "files", "fl", "flush", "fmt", "follow", "generate", "graph", "hc", "headers", "health", "heartbeat", "history", "images", "info", "init", "install", "jo", "jobs", "kctl-api"
+
 ## Command Reference
 
 ### `kctl-api ai`
@@ -104,6 +133,21 @@ Cleanup — all, cache, build, pycache.
 | `clean cache [--dry_run]` | Remove .ruff_cache, .mypy_cache, .pytest_cache directories. |
 | `clean pycache [--dry_run]` | Remove all __pycache__ directories and .pyc/.pyo files. |
 
+### `kctl-api commands`
+
+Machine-readable command discovery (for AI agents).
+
+| Command | Description |
+|---------|-------------|
+| `commands list [--json_flag] [--filter_substr]` | List all leaf commands as 'group verb' strings. |
+| `commands tree [--json_flag]` | Dump the full command tree as JSON. |
+
+### `kctl-api completions`
+
+Generate or install shell completions.
+
+Usage: `kctl-api completions [--shell] [--install]`
+
 ### `kctl-api config`
 
 Manage connection profiles and configuration.
@@ -162,7 +206,7 @@ Deployment management — status, logs, restart, rollback.
 | Command | Description |
 |---------|-------------|
 | `deploy list` | List all deployments (will use Dokploy API). |
-| `deploy logs <app_name> [--tail]` | View deployment logs (will use Dokploy API). |
+| `deploy logs <app_name> [--tail] [--follow] [--compose_id] [--service] [--dokploy_profile]` | View deployment logs via kctl-dokploy or local docker compose. |
 | `deploy restart <app_name>` | Restart a deployed app (will use Dokploy API). |
 | `deploy rollback <app_name> [--revision]` | Rollback a deployment to a previous revision (will use Dokploy API). |
 | `deploy status [--app_name]` | Show deployment status (will use Dokploy API). |
@@ -483,6 +527,10 @@ Security — audit, secrets, CORS, headers, deps.
 | `security headers [--url]` | Check security headers on a URL. |
 | `security secrets [--path]` | Scan source code for potential secrets and credentials. |
 
+### `kctl-api self-update`
+
+Check for updates and upgrade kctl-api.
+
 ### `kctl-api services`
 
 Docker Compose services — list, status, restart, logs.
@@ -563,6 +611,12 @@ Test runner — run, coverage, watch.
 
 Alias: test run all
 
+### `kctl-api tui`
+
+Launch the interactive TUI.
+
+Usage: `kctl-api tui [--profile]`
+
 ### `kctl-api ul`
 
 Alias: users list

{kctl_api-0.7.2 → kctl_api-0.7.3}/src/kctl_api/__init__.py

@@ -1,3 +1,3 @@
 """kctl-api: Kodemeio API CLI."""
 
-__version__ = "0.7.2"
+__version__ = "0.7.3"