verkit 0.1.5__tar.gz → 0.2.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: verkit
-Version: 0.1.5
+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.5 → 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.5 → verkit-0.2.1}/pyproject.toml

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

{verkit-0.1.5 → verkit-0.2.1}/src/verkit/__init__.py

@@ -10,16 +10,19 @@ from verkit.inspector import (
 )
 from verkit.promoter import promote_version
 from verkit.tagger import release_version, tag_version
+from verkit.theme import DEFAULT, Theme
 
-__version__ = "0.1.1"
+__version__ = "0.2.0"
 __all__ = [
+    "DEFAULT",
+    "Theme",
     "VersionInfo",
-    "inspect_project",
-    "inspect_committed",
+    "display_version_info",
     "get_installed_version",
     "get_latest_pypi_version",
-    "display_version_info",
+    "inspect_committed",
+    "inspect_project",
     "promote_version",
-    "tag_version",
     "release_version",
+    "tag_version",
 ]

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.5 → 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" },