kctl-github 0.7.1__tar.gz → 0.7.3__tar.gz

{kctl_github-0.7.1 → kctl_github-0.7.3}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: kctl-github
-Version: 0.7.1
+Version: 0.7.3
 Summary: Kodemeio GitHub CLI — cross-repo GitHub management
 Requires-Python: >=3.12
 Requires-Dist: httpx>=0.28.0
-Requires-Dist: kctl-lib>=0.10.0
+Requires-Dist: kctl-lib>=0.11.0
 Requires-Dist: pydantic>=2.10.0
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: rich>=13.9.0

{kctl_github-0.7.1 → kctl_github-0.7.3}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kctl-github"
-version = "0.7.1"
+version = "0.7.3"
 description = "Kodemeio GitHub CLI — cross-repo GitHub management"
 requires-python = ">=3.12"
 dependencies = [
-    "kctl-lib>=0.10.0",
+    "kctl-lib>=0.11.0",
     "typer>=0.15.0",
     "rich>=13.9.0",
     "pydantic>=2.10.0",

{kctl_github-0.7.1 → kctl_github-0.7.3}/skills/github-admin/SKILL.md

@@ -30,6 +30,31 @@ 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-github <group> <verb> ...`, use these AI-facing affordances:
+
+1. **Find a command by keyword** — substring filter, returns sorted leaf paths:
+   ```bash
+   kctl-github commands list --filter <keyword>
+   ```
+   Example: `kctl-github 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-github 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-github <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:
@@ -67,8 +92,8 @@ Machine-readable command discovery (for AI agents).
 
 | Command | Description |
 |---------|-------------|
-| `commands list [--json_flag]` | List all leaf commands as 'group verb' strings. |
-| `commands tree` | Dump the full command tree as JSON. |
+| `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-github completions`
 

{kctl_github-0.7.1 → kctl_github-0.7.3}/src/kctl_github/__init__.py

@@ -1,3 +1,3 @@
 """kctl-github: GitHub integration management."""
 
-__version__ = "0.7.1"
+__version__ = "0.7.3"