kctl-github 0.5.3__tar.gz → 0.6.0__tar.gz

{kctl_github-0.5.3 → kctl_github-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kctl-github
-Version: 0.5.3
+Version: 0.6.0
 Summary: Kodemeio GitHub CLI — cross-repo GitHub management
 Requires-Python: >=3.12
 Requires-Dist: httpx>=0.28.0

{kctl_github-0.5.3 → kctl_github-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kctl-github"
-version = "0.5.3"
+version = "0.6.0"
 description = "Kodemeio GitHub CLI — cross-repo GitHub management"
 requires-python = ">=3.12"
 dependencies = [

{kctl_github-0.5.3 → kctl_github-0.6.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.3 → kctl_github-0.6.0}/src/kctl_github/__init__.py

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

{kctl_github-0.5.3 → kctl_github-0.6.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:

kctl_github-0.6.0/tests/test_standard.py

@@ -0,0 +1,57 @@
+"""Standard CLI smoke/config/completions tests for kctl-github."""
+
+from __future__ import annotations
+
+import pytest
+from typer.testing import CliRunner
+
+from kctl_github.cli import app
+
+runner = CliRunner()
+
+
+@pytest.fixture(autouse=True)
+def _isolate(tmp_path, monkeypatch):
+    config_dir = tmp_path / "config"
+    config_dir.mkdir()
+    config_file = config_dir / "config.yaml"
+    monkeypatch.setattr("kctl_lib.config.CONFIG_DIR", config_dir, raising=False)
+    monkeypatch.setattr("kctl_lib.config.CONFIG_FILE", config_file, raising=False)
+
+
+class TestVersion:
+    def test_version_long(self) -> None:
+        result = runner.invoke(app, ["--version"])
+        assert result.exit_code == 0
+
+
+class TestHelp:
+    def test_top_level_help(self) -> None:
+        result = runner.invoke(app, ["--help"])
+        assert result.exit_code == 0
+        assert "Usage:" in result.output
+
+    @pytest.mark.parametrize(
+        "group",
+        ["billing", "ci", "config", "dashboard", "doctor", "health", "labels", "prs", "repos", "secrets", "stats"],
+    )
+    def test_group_help(self, group: str) -> None:
+        result = runner.invoke(app, [group, "--help"])
+        assert result.exit_code == 0, result.output
+
+
+class TestConfigSubcommands:
+    def test_config_help(self) -> None:
+        result = runner.invoke(app, ["config", "--help"])
+        assert result.exit_code == 0
+
+    def test_config_show(self) -> None:
+        result = runner.invoke(app, ["config", "show"])
+        assert result.exit_code in (0, 1, 2)
+
+
+class TestCompletions:
+    @pytest.mark.parametrize("shell", ["bash", "zsh", "fish"])
+    def test_completions(self, shell: str) -> None:
+        result = runner.invoke(app, ["completions", shell])
+        assert result.exit_code == 0, result.output