kctl-github 0.5.4__tar.gz → 0.7.0__tar.gz

{kctl_github-0.5.4 → kctl_github-0.7.0}/PKG-INFO

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

{kctl_github-0.5.4 → kctl_github-0.7.0}/pyproject.toml

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

{kctl_github-0.5.4 → kctl_github-0.7.0}/skills/github-admin/SKILL.md

@@ -1,11 +1,9 @@
 ---
 name: github-admin
 description: >
-  GitHub cross-repo management via kctl-github CLI (11 groups, ~39 commands).
-  MUST use for ANY kctl-github operation.
-  Triggers on: "actions", "activity", "audit", "billing", "bulk-status", "ci", "config", "contributors", "current", "dashboard", "diff", "generate", "health", "init", "kctl-github", "labels", "languages", "monitor", "overview", "packages", "profile", "profiles", "prs", "remove", "repos", "rerun", "rotate", "secrets", "skill", "stale", "stats", "storage", "sync", "test", "validate".
-  Auto-generated: 2026-04-05
-  registry_hash: 226d58bc8834
+  GitHub cross-repo management via kctl-github CLI (16 groups, ~45 commands). MUST use for ANY kctl-github operation. See SKILL.md ## Triggers for keywords.
+  Auto-generated: 2026-05-22
+  registry_hash: 7da309501bb5
 ---
 
 # github-admin — kctl-github CLI Reference
@@ -17,8 +15,8 @@ description: >
 ## Overview
 
 **CLI:** `kctl-github`
-**Command groups:** 11
-**Total commands:** ~39
+**Command groups:** 16
+**Total commands:** ~45
 **Install:** `cd cli && uv tool install --editable .`
 
 ## Global Options
@@ -32,6 +30,12 @@ description: >
 | `--profile`, `-p` | Config profile name |
 | `--version`, `-V` | Show version |
 
+## Triggers
+
+Auto-invoke this skill when the user references any of these keywords:
+
+"actions", "activity", "audit", "billing", "bulk-status", "check", "ci", "commands", "completions", "config", "contributors", "current", "dashboard", "diff", "doctor", "generate", "health", "init", "kctl-github", "labels", "languages", "monitor", "overview", "packages", "profile", "profiles", "prs", "remove", "repos", "rerun", "rotate", "secrets", "self-update", "skill", "stale", "stats", "storage", "sync", "test", "tree", "tui", "validate"
+
 ## Command Reference
 
 ### `kctl-github billing`
@@ -57,6 +61,21 @@ CI/CD monitoring across kodemeio-* repositories.
 | `ci stats [--period]` | CI statistics: success rate, avg duration, failure trends. |
 | `ci status` | Latest workflow run status across ALL repos (pass/fail/running). |
 
+### `kctl-github commands`
+
+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. |
+
+### `kctl-github completions`
+
+Generate or install shell completions.
+
+Usage: `kctl-github completions [--shell] [--install]`
+
 ### `kctl-github config`
 
 Profile and configuration management.
@@ -78,6 +97,10 @@ Profile and configuration management.
 
 Quick overview dashboard.
 
+### `kctl-github doctor`
+
+Run diagnostic checks.
+
 ### `kctl-github health`
 
 API connectivity and rate limits.
@@ -123,6 +146,10 @@ Cross-repo Actions secret management.
 | `secrets rotate <name>` | Update a secret across all repos that have it. |
 | `secrets set <name> <repos>` | Set a secret across multiple repos (prompts for value). |
 
+### `kctl-github self-update`
+
+Check for updates and upgrade kctl-github.
+
 ### `kctl-github skill`
 
 Claude Code skill management.
@@ -149,6 +176,12 @@ Repository statistics across kodemeio-* repos.
 | `stats languages` | Language breakdown across all repos. |
 | `stats overview` | Total repos, total stars, total issues, total PRs. |
 
+### `kctl-github tui`
+
+Launch the interactive TUI.
+
+Usage: `kctl-github tui [--profile]`
+
 ## Configuration
 
 Shared config: `~/.config/kodemeio/config.yaml`

{kctl_github-0.5.4 → kctl_github-0.7.0}/src/kctl_github/__init__.py

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

{kctl_github-0.5.4 → kctl_github-0.7.0}/src/kctl_github/cli.py

@@ -7,6 +7,7 @@ from typing import Annotated
 
 import typer
 from kctl_lib import KctlError, handle_cli_error
+from kctl_lib import cli_entrypoint, register_introspection_commands
 
 from kctl_github import __version__
 from kctl_github.commands.billing import app as billing_app
@@ -123,6 +124,10 @@ def completions(
         typer.echo(script)
 
 
+# Wrap app so KctlError subclasses surface as clean user-facing messages.
+app = cli_entrypoint(app)
+register_introspection_commands(app)
+
 def _run() -> None:
     """Entry point with error handling."""
     try: