verkit 0.1.4__tar.gz → 0.2.1__tar.gz

{verkit-0.1.4 → verkit-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: verkit
-Version: 0.1.4
+Version: 0.2.1
 Summary: Polyglot project version inspector, promoter, tagger, and release workflow engine
 Author: Mark Stouffer
 License: MIT
@@ -86,3 +86,39 @@ tag_name = verkit.tag_version(push=True)
 # 4. Atomic release
 verkit.release_version("patch", push=True)
 ```
+
+---
+
+## Shared Terminal Theme
+
+`verkit` publishes the canonical Rich theme used across this developer's
+CLIs (`task-agent`, `multi-agent-registry`, ...). It is **opt-in** — verkit
+never applies the theme for you; consumers import it and apply it to their
+own `Table`/`Panel` objects:
+
+```python
+from rich.console import Console
+from rich.table import Table
+from verkit.theme import DEFAULT as theme
+
+console = Console()
+table = Table(
+    title="Portfolio",
+    box=theme.table_box,          # borderless
+    header_style=theme.header_style,  # "on grey23"
+    padding=theme.table_padding,  # (0, 2, 0, 0)
+)
+console.print(table)
+```
+
+The theme is a frozen dataclass (`verkit.theme.Theme`); `DEFAULT` is the
+canonical instance. Non-Python consumers (e.g. PowerShell scripts) read the
+machine-readable mirror, which stays in sync via `tests/test_theme.py`:
+
+```powershell
+$theme = Invoke-RestMethod `
+  https://raw.githubusercontent.com/bizkite-co/verkit/main/src/verkit/theme.json
+# $theme.theme.header_style               -> "on grey23"
+# $theme.theme.header_background_ansi     -> ANSI 256 index 237 background escape
+# $theme.theme.header_background_rgb_hex  -> "#3a3a3a"
+```

{verkit-0.1.4 → verkit-0.2.1}/README.md

@@ -76,3 +76,39 @@ tag_name = verkit.tag_version(push=True)
 # 4. Atomic release
 verkit.release_version("patch", push=True)
 ```
+
+---
+
+## Shared Terminal Theme
+
+`verkit` publishes the canonical Rich theme used across this developer's
+CLIs (`task-agent`, `multi-agent-registry`, ...). It is **opt-in** — verkit
+never applies the theme for you; consumers import it and apply it to their
+own `Table`/`Panel` objects:
+
+```python
+from rich.console import Console
+from rich.table import Table
+from verkit.theme import DEFAULT as theme
+
+console = Console()
+table = Table(
+    title="Portfolio",
+    box=theme.table_box,          # borderless
+    header_style=theme.header_style,  # "on grey23"
+    padding=theme.table_padding,  # (0, 2, 0, 0)
+)
+console.print(table)
+```
+
+The theme is a frozen dataclass (`verkit.theme.Theme`); `DEFAULT` is the
+canonical instance. Non-Python consumers (e.g. PowerShell scripts) read the
+machine-readable mirror, which stays in sync via `tests/test_theme.py`:
+
+```powershell
+$theme = Invoke-RestMethod `
+  https://raw.githubusercontent.com/bizkite-co/verkit/main/src/verkit/theme.json
+# $theme.theme.header_style               -> "on grey23"
+# $theme.theme.header_background_ansi     -> ANSI 256 index 237 background escape
+# $theme.theme.header_background_rgb_hex  -> "#3a3a3a"
+```

{verkit-0.1.4 → verkit-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "verkit"
-version = "0.1.4"
+version = "0.2.1"
 description = "Polyglot project version inspector, promoter, tagger, and release workflow engine"
 readme = "README.md"
 requires-python = ">=3.9"

verkit-0.2.1/src/verkit/__init__.py

@@ -0,0 +1,28 @@
+"""Polyglot project version inspector, promoter, tagger, and release engine."""
+
+from verkit.inspector import (
+    VersionInfo,
+    display_version_info,
+    get_installed_version,
+    get_latest_pypi_version,
+    inspect_committed,
+    inspect_project,
+)
+from verkit.promoter import promote_version
+from verkit.tagger import release_version, tag_version
+from verkit.theme import DEFAULT, Theme
+
+__version__ = "0.2.0"
+__all__ = [
+    "DEFAULT",
+    "Theme",
+    "VersionInfo",
+    "display_version_info",
+    "get_installed_version",
+    "get_latest_pypi_version",
+    "inspect_committed",
+    "inspect_project",
+    "promote_version",
+    "release_version",
+    "tag_version",
+]

{verkit-0.1.4 → verkit-0.2.1}/src/verkit/cli.py

@@ -3,7 +3,7 @@ import sys
 
 from rich.console import Console
 
-from verkit.inspector import inspect_committed, inspect_project
+from verkit.inspector import display_version_info
 from verkit.promoter import promote_version
 from verkit.tagger import release_version, tag_version
 
@@ -51,10 +51,7 @@ def main():
     console = Console()
 
     if not args.command or args.command == "inspect":
-        info = inspect_project()
-        committed = inspect_committed()
-        console.print(f"[bold blue]Working version:[/bold blue] {info.version} (from {info.source or 'unknown'})")
-        console.print(f"[dim]Committed version (HEAD):[/dim] {committed.version}")
+        display_version_info(console, "verkit")
         return
 
     try:

{verkit-0.1.4 → verkit-0.2.1}/src/verkit/inspector.py

@@ -1,11 +1,63 @@
+import importlib.metadata
 import json
 import os
 import re
 import subprocess
+import urllib.request
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Optional
 
+from rich.console import Console
+
+
+def get_installed_version(package_name: str) -> str:
+    """Read the installed package version via importlib.metadata."""
+    try:
+        return importlib.metadata.version(package_name)
+    except Exception:
+        return "unknown"
+
+
+def get_latest_pypi_version(package_name: str, timeout: int = 4) -> Optional[str]:
+    """Fetch the latest version of a package from PyPI."""
+    url = f"https://pypi.org/pypi/{package_name}/json"
+    try:
+        with urllib.request.urlopen(url, timeout=timeout) as response:
+            data = json.load(response)
+            return data["info"]["version"]
+    except Exception:
+        return None
+
+
+def display_version_info(
+    console: Console,
+    package_name: str,
+    root: Optional[Path] = None,
+    upgrade_cmd: Optional[str] = None,
+):
+    """Display running, PyPI, and local project version information."""
+    tool_v = get_installed_version(package_name)
+    console.print(f"[bold blue]Running version:[/bold blue] {tool_v}")
+
+    latest_v = get_latest_pypi_version(package_name)
+    if latest_v:
+        if latest_v != tool_v:
+            console.print(f"[bold yellow]Latest PyPI version:[/bold yellow] {latest_v}")
+            if upgrade_cmd:
+                console.print(f"[dim]Run [bold]{upgrade_cmd}[/bold] to upgrade.[/dim]")
+        else:
+            console.print(f"[dim]Latest PyPI version:[/dim] {latest_v} (up to date)")
+
+    try:
+        info = get_project_version(root)
+        if info.version != "unknown":
+            console.print(
+                f"[dim]Local project version:[/dim] {info.version} (from {info.source})"
+            )
+    except Exception:
+        pass
+
 
 @dataclass
 class VersionInfo:

{verkit-0.1.4 → verkit-0.2.1}/src/verkit/promoter.py

@@ -235,7 +235,9 @@ def _commit_version_bump(
                 if msg_res.returncode == 0
                 else "chore: bump version"
             )
-            commit_res = _git("commit", "--amend", "-m", existing_msg, cwd=git_root)
+            commit_res = _git(
+                "commit", "--no-verify", "--amend", "-m", existing_msg, cwd=git_root
+            )
             if commit_res.returncode != 0:
                 err = (commit_res.stderr or commit_res.stdout or "").strip()
                 raise RuntimeError(f"Failed to amend version bump: {err}")
@@ -246,7 +248,7 @@ def _commit_version_bump(
 
     if not amend:
         msg = f"chore(release): v{new_v}"
-        commit_res = _git("commit", "-m", msg, cwd=git_root)
+        commit_res = _git("commit", "--no-verify", "-m", msg, cwd=git_root)
         if commit_res.returncode != 0:
             err = (commit_res.stderr or commit_res.stdout or "").strip()
             if "nothing to commit" in err.lower():

verkit-0.2.1/src/verkit/theme.json

@@ -0,0 +1,18 @@
+{
+  "name": "verkit-grey",
+  "version": 1,
+  "description": "Shared Rich terminal theme for tables and panels across this developer's Python CLIs (task-agent, multi-agent-registry, ...). Source of truth is src/verkit/theme.py (the Theme dataclass); this JSON mirrors Theme.DEFAULT for non-Python consumers and is kept in sync by tests/test_theme.py.",
+  "adoption": {
+    "python": "from verkit.theme import DEFAULT as theme",
+    "powershell": "$theme = Invoke-RestMethod '<raw URL of this file>'; $theme.theme",
+    "note": "Opt-in only: verkit publishes the theme but never applies it for you."
+  },
+  "theme": {
+    "table_box": null,
+    "panel_box": "MINIMAL",
+    "table_padding": [0, 2, 0, 0],
+    "header_style": "on grey23",
+    "header_background_ansi": "\u001b[48;5;237m",
+    "header_background_rgb_hex": "#3a3a3a"
+  }
+}

verkit-0.2.1/src/verkit/theme.py

@@ -0,0 +1,55 @@
+"""Shared visual theme for Rich terminal output across client CLIs.
+
+This module is a *convention carrier*, not a mandate. The theme is published
+here so a client project can opt in with a one-line import instead of
+maintaining its own copy; importing it is never forced on consumers.
+
+Adoption hint (Python)::
+
+    from verkit.theme import DEFAULT as theme
+
+    table = Table(
+        title="...",
+        box=theme.table_box,
+        header_style=theme.header_style,
+        padding=theme.table_padding,
+    )
+    console.print(Panel(..., box=theme.panel_box))
+
+Because ``Theme`` is a frozen dataclass, ``DEFAULT`` can be shared or
+subclassed without risk of accidental mutation.
+
+Non-Python consumers (e.g. PowerShell scripts) should read the machine
+readable mirror at ``src/verkit/theme.json`` instead of re-deriving styles:
+
+    $theme = Invoke-RestMethod `
+      https://raw.githubusercontent.com/bizkite-co/verkit/main/src/verkit/theme.json
+
+The JSON and this dataclass are kept in sync by ``tests/test_theme.py``.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from rich import box as rich_box
+
+
+@dataclass(frozen=True)
+class Theme:
+    """Visual theme for Rich terminal output (tables, panels).
+
+    Defaults render tables and panels in the compact report style shared
+    across this developer's CLIs: borderless tables, a minimal panel border,
+    and a subtle grey header band (ANSI 256 index 237).
+    """
+
+    table_box: rich_box.Box | None = None
+    panel_box: rich_box.Box = rich_box.MINIMAL
+    table_padding: tuple[int, int, int, int] = (0, 2, 0, 0)
+    header_style: str = "on grey23"
+
+
+#: The canonical theme. Client CLIs opt in with ``from verkit.theme import
+#: DEFAULT``.
+DEFAULT = Theme()

verkit-0.2.1/tests/test_theme.py

@@ -0,0 +1,38 @@
+import json
+from pathlib import Path
+
+from rich import box as rich_box
+
+from verkit.theme import DEFAULT, Theme
+
+THEME_JSON = Path(__file__).resolve().parent.parent / "src" / "verkit" / "theme.json"
+
+
+def test_default_is_theme():
+    assert isinstance(DEFAULT, Theme)
+
+
+def test_default_values():
+    assert DEFAULT.table_box is None
+    assert DEFAULT.panel_box is rich_box.MINIMAL
+    assert DEFAULT.table_padding == (0, 2, 0, 0)
+    assert DEFAULT.header_style == "on grey23"
+
+
+def test_theme_json_matches_default():
+    data = json.loads(THEME_JSON.read_text(encoding="utf-8"))
+    theme = data["theme"]
+    assert theme["table_box"] is None
+    assert theme["panel_box"] == "MINIMAL"
+    assert tuple(theme["table_padding"]) == DEFAULT.table_padding
+    assert theme["header_style"] == DEFAULT.header_style
+    assert theme["header_background_ansi"] == "\x1b[48;5;237m"
+
+
+def test_theme_is_frozen():
+    try:
+        DEFAULT.table_padding = (1, 1, 1, 1)
+    except AttributeError:
+        pass
+    else:
+        raise AssertionError("Theme should be immutable")

{verkit-0.1.4 → verkit-0.2.1}/uv.lock

@@ -70,7 +70,7 @@ wheels = [
 
 [[package]]
 name = "verkit"
-version = "0.1.4"
+version = "0.2.1"
 source = { editable = "." }
 dependencies = [
     { name = "rich" },

verkit-0.1.4/src/verkit/__init__.py

@@ -1,14 +0,0 @@
-"""Polyglot project version inspector, promoter, tagger, and release engine."""
-
-from verkit.inspector import VersionInfo, inspect_project, inspect_committed
-from verkit.promoter import promote_version
-from verkit.tagger import tag_version
-
-__version__ = "0.1.0"
-__all__ = [
-    "VersionInfo",
-    "inspect_project",
-    "inspect_committed",
-    "promote_version",
-    "tag_version",
-]