smartcli-toolkit 0.1.3__tar.gz → 0.1.4__tar.gz

{smartcli_toolkit-0.1.3 → smartcli_toolkit-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: smartcli-toolkit
-Version: 0.1.3
+Version: 0.1.4
 Summary: Pluggable-PTY + pyte screen model + semantic snapshot / readiness core for driving interactive terminal programs (SmartCLI shared core).
 Author: dwgx
 License-Expression: MIT
@@ -38,6 +38,10 @@ Provides-Extra: all
 Requires-Dist: pyfiglet>=1.0.0; extra == "all"
 Requires-Dist: Pillow>=10.0.0; extra == "all"
 Requires-Dist: wcwidth>=0.2.0; extra == "all"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: coverage[toml]>=7.0; extra == "dev"
 Dynamic: license-file
 
 <!-- Language: English | [简体中文](docs/i18n/README.zh-Hans.md) | [繁體中文](docs/i18n/README.zh-Hant.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) -->
@@ -51,6 +55,7 @@ Dynamic: license-file
 [![PyPI](https://img.shields.io/pypi/v/smartcli-toolkit?color=orange)](https://pypi.org/project/smartcli-toolkit/)
 [![Python](https://img.shields.io/pypi/pyversions/smartcli-toolkit?color=blue)](https://pypi.org/project/smartcli-toolkit/)
 [![CI](https://github.com/dwgx/SmartCLI/actions/workflows/ci.yml/badge.svg)](https://github.com/dwgx/SmartCLI/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/dwgx/SmartCLI/branch/main/graph/badge.svg)](https://codecov.io/gh/dwgx/SmartCLI)
 [![License: MIT](https://img.shields.io/pypi/l/smartcli-toolkit?color=green)](LICENSE)
 [![Downloads](https://img.shields.io/pypi/dm/smartcli-toolkit?color=blueviolet)](https://pypi.org/project/smartcli-toolkit/)
 [![Skills: 3](https://img.shields.io/badge/skills-3-purple)](#features)
@@ -199,6 +204,14 @@ python skills/drive-tui/scripts/tui.py snapshot --id <SID>
 python skills/drive-tui/scripts/tui.py close --id <SID>
 ```
 
+Or drive from any MCP client — the same verbs as MCP tools, with the
+per-session token attached automatically:
+
+```bash
+pip install "smartcli-toolkit[mcp]"
+python skills/drive-tui/scripts/mcp_server.py     # stdio MCP server
+```
+
 ### As a library
 
 The shared core is importable directly:

{smartcli_toolkit-0.1.3 → smartcli_toolkit-0.1.4}/README.md

@@ -9,6 +9,7 @@
 [![PyPI](https://img.shields.io/pypi/v/smartcli-toolkit?color=orange)](https://pypi.org/project/smartcli-toolkit/)
 [![Python](https://img.shields.io/pypi/pyversions/smartcli-toolkit?color=blue)](https://pypi.org/project/smartcli-toolkit/)
 [![CI](https://github.com/dwgx/SmartCLI/actions/workflows/ci.yml/badge.svg)](https://github.com/dwgx/SmartCLI/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/dwgx/SmartCLI/branch/main/graph/badge.svg)](https://codecov.io/gh/dwgx/SmartCLI)
 [![License: MIT](https://img.shields.io/pypi/l/smartcli-toolkit?color=green)](LICENSE)
 [![Downloads](https://img.shields.io/pypi/dm/smartcli-toolkit?color=blueviolet)](https://pypi.org/project/smartcli-toolkit/)
 [![Skills: 3](https://img.shields.io/badge/skills-3-purple)](#features)
@@ -157,6 +158,14 @@ python skills/drive-tui/scripts/tui.py snapshot --id <SID>
 python skills/drive-tui/scripts/tui.py close --id <SID>
 ```
 
+Or drive from any MCP client — the same verbs as MCP tools, with the
+per-session token attached automatically:
+
+```bash
+pip install "smartcli-toolkit[mcp]"
+python skills/drive-tui/scripts/mcp_server.py     # stdio MCP server
+```
+
 ### As a library
 
 The shared core is importable directly:

{smartcli_toolkit-0.1.3 → smartcli_toolkit-0.1.4}/pyproject.toml

@@ -30,7 +30,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "smartcli-toolkit"
-version = "0.1.3"
+version = "0.1.4"
 description = "Pluggable-PTY + pyte screen model + semantic snapshot / readiness core for driving interactive terminal programs (SmartCLI shared core)."
 readme = "README.md"
 license = "MIT"
@@ -96,6 +96,13 @@ art = ["pyfiglet>=1.0.0"]        # real FIGlet fonts (else built-in block font)
 image = ["Pillow>=10.0.0"]       # real raster images (else PNM/procedural demo)
 width = ["wcwidth>=0.2.0"]       # authoritative cell width (else unicodedata)
 all = ["pyfiglet>=1.0.0", "Pillow>=10.0.0", "wcwidth>=0.2.0"]
+# MCP server over the drive-tui daemon verb surface (skills/drive-tui/scripts/
+# mcp_server.py). Lets any MCP client drive interactive TUIs. Optional — the
+# CLI and library work without it.
+mcp = ["mcp>=1.0"]
+# Dev-only: multi-process coverage over the script-style suite (see
+# tools/coverage_run.py + .coveragerc). Not needed to run SmartCLI.
+dev = ["coverage[toml]>=7.0"]
 
 [tool.setuptools]
 # Only the shared core is a clean installable package (see HONEST NOTE above).

{smartcli_toolkit-0.1.3 → smartcli_toolkit-0.1.4}/smartcli_core/__init__.py

@@ -55,4 +55,4 @@ __all__ = [
     "KEY_MAP",
 ]
 
-__version__ = "0.1.3"
+__version__ = "0.1.4"

{smartcli_toolkit-0.1.3 → smartcli_toolkit-0.1.4}/smartcli_toolkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: smartcli-toolkit
-Version: 0.1.3
+Version: 0.1.4
 Summary: Pluggable-PTY + pyte screen model + semantic snapshot / readiness core for driving interactive terminal programs (SmartCLI shared core).
 Author: dwgx
 License-Expression: MIT
@@ -38,6 +38,10 @@ Provides-Extra: all
 Requires-Dist: pyfiglet>=1.0.0; extra == "all"
 Requires-Dist: Pillow>=10.0.0; extra == "all"
 Requires-Dist: wcwidth>=0.2.0; extra == "all"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: coverage[toml]>=7.0; extra == "dev"
 Dynamic: license-file
 
 <!-- Language: English | [简体中文](docs/i18n/README.zh-Hans.md) | [繁體中文](docs/i18n/README.zh-Hant.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) -->
@@ -51,6 +55,7 @@ Dynamic: license-file
 [![PyPI](https://img.shields.io/pypi/v/smartcli-toolkit?color=orange)](https://pypi.org/project/smartcli-toolkit/)
 [![Python](https://img.shields.io/pypi/pyversions/smartcli-toolkit?color=blue)](https://pypi.org/project/smartcli-toolkit/)
 [![CI](https://github.com/dwgx/SmartCLI/actions/workflows/ci.yml/badge.svg)](https://github.com/dwgx/SmartCLI/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/dwgx/SmartCLI/branch/main/graph/badge.svg)](https://codecov.io/gh/dwgx/SmartCLI)
 [![License: MIT](https://img.shields.io/pypi/l/smartcli-toolkit?color=green)](LICENSE)
 [![Downloads](https://img.shields.io/pypi/dm/smartcli-toolkit?color=blueviolet)](https://pypi.org/project/smartcli-toolkit/)
 [![Skills: 3](https://img.shields.io/badge/skills-3-purple)](#features)
@@ -199,6 +204,14 @@ python skills/drive-tui/scripts/tui.py snapshot --id <SID>
 python skills/drive-tui/scripts/tui.py close --id <SID>
 ```
 
+Or drive from any MCP client — the same verbs as MCP tools, with the
+per-session token attached automatically:
+
+```bash
+pip install "smartcli-toolkit[mcp]"
+python skills/drive-tui/scripts/mcp_server.py     # stdio MCP server
+```
+
 ### As a library
 
 The shared core is importable directly:

{smartcli_toolkit-0.1.3 → smartcli_toolkit-0.1.4}/smartcli_toolkit.egg-info/SOURCES.txt

@@ -16,5 +16,6 @@ smartcli_toolkit.egg-info/top_level.txt
 tests/test_degenerate_inputs.py
 tests/test_doc_counts.py
 tests/test_fx_contract.py
+tests/test_golden_frames.py
 tests/test_readiness.py
 tests/test_vendor_sync.py

{smartcli_toolkit-0.1.3 → smartcli_toolkit-0.1.4}/smartcli_toolkit.egg-info/requires.txt

@@ -11,8 +11,14 @@ wcwidth>=0.2.0
 [art]
 pyfiglet>=1.0.0
 
+[dev]
+coverage[toml]>=7.0
+
 [image]
 Pillow>=10.0.0
 
+[mcp]
+mcp>=1.0
+
 [width]
 wcwidth>=0.2.0

smartcli_toolkit-0.1.4/tests/test_golden_frames.py

@@ -0,0 +1,161 @@
+#!/usr/bin/env python3
+"""test_golden_frames.py — golden-frame snapshot regression for tui-ui widgets.
+
+Every registered widget is rendered to a DETERMINISTIC ANSI frame (its
+``sample(theme)`` composed into a fixed-size ``Page``, exactly the path
+``python -m ui demo`` uses) and compared byte-for-byte against a committed
+baseline in ``tests/golden/<key>.txt``. This locks the 15 widgets against silent
+visual regressions — today only degenerate-input crashes and the fx frame
+contract are guarded; widget *output* was not.
+
+Pure/in-memory: it imports the ui package and renders strings, never spawns a
+process. Deterministic: widgets carry no random/time dependency (verified), and
+the test renders each widget TWICE and fails if the two disagree, so a
+non-deterministic widget can never silently bake flakiness into a baseline.
+
+Usage:
+    python tests/test_golden_frames.py            # check against baselines (exit 1 on drift)
+    python tests/test_golden_frames.py --update    # (re)write baselines from current output
+    python tests/test_golden_frames.py badge card  # limit to named widgets
+
+The baselines are meant to be reviewed in the diff: when a widget's look changes
+on purpose, run --update and the PR shows exactly which cells moved.
+"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(ROOT / "skills" / "tui-ui"))
+
+# Force UTF-8 stdout: baselines and diffs contain box-drawing + CJK, which crash
+# on a legacy Windows codepage (CP936) otherwise.
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[attr-defined]
+except Exception:
+    pass
+
+from ui import registry  # noqa: E402
+from ui.box import Box  # noqa: E402
+from ui.core import get_theme  # noqa: E402
+from ui.layout import Page  # noqa: E402
+
+GOLDEN_DIR = ROOT / "tests" / "golden"
+
+# Fixed render parameters — must stay constant or every baseline shifts. Chosen
+# wide/tall enough that no widget sample clips at its default.
+WIDTH, HEIGHT = 60, 12
+THEME = "dashboard"
+
+results: list[tuple[str, bool, str]] = []
+
+
+def record(name: str, ok: bool, detail: str = "") -> None:
+    results.append((name, ok, detail))
+    print(f"{'PASS' if ok else 'FAIL'}  {name}" + (f"  -- {detail}" if detail else ""))
+
+
+def render_widget(cls) -> str:
+    """Render ONE widget to a deterministic ANSI frame — mirrors ui.cli.cmd_demo:
+    sample(theme) -> Box -> Page.to_ansi()."""
+    theme = get_theme(THEME)
+    widget = cls.sample(theme)
+    page = Page(Box(content=widget, padding=(0, 0), bg=theme.bg),
+                width=WIDTH, height=HEIGHT, bg=theme.bg)
+    return page.to_ansi()
+
+
+def _baseline_path(key: str) -> Path:
+    return GOLDEN_DIR / f"{key}.txt"
+
+
+def _read_lf(path: Path) -> str:
+    """Read a baseline, normalizing any CRLF to LF so the comparison is
+    platform-independent (a Windows checkout may present CRLF; the rendered
+    frame is always LF)."""
+    return path.read_text(encoding="utf-8").replace("\r\n", "\n")
+
+
+def _first_diff(a: str, b: str) -> str:
+    """Human-pointable description of where two frames first differ."""
+    al, bl = a.splitlines(), b.splitlines()
+    if len(al) != len(bl):
+        return f"line count {len(al)} != baseline {len(bl)}"
+    for i, (x, y) in enumerate(zip(al, bl)):
+        if x != y:
+            col = next((j for j, (cx, cy) in enumerate(zip(x, y)) if cx != cy),
+                       min(len(x), len(y)))
+            return f"line {i} differs at col {col}"
+    return "identical length, content differs (trailing?)"
+
+
+def check_widget(cls, update: bool) -> None:
+    key = cls.key
+    # Determinism gate: render twice, must be byte-identical. A widget that
+    # depends on time/random would trip here instead of baking flakiness in.
+    frame1 = render_widget(cls)
+    frame2 = render_widget(cls)
+    if frame1 != frame2:
+        record(f"golden {key}", False,
+               f"NON-DETERMINISTIC render ({_first_diff(frame1, frame2)}) — "
+               "fix the widget or seed it before baselining")
+        return
+
+    path = _baseline_path(key)
+    if update:
+        GOLDEN_DIR.mkdir(parents=True, exist_ok=True)
+        existed = path.exists()
+        old = _read_lf(path) if existed else None
+        # Write with LF newlines explicitly (newline="") so a Windows run doesn't
+        # bake CRLF into the baseline — the rendered frame uses \n, and git
+        # normalizes these files to LF (.gitattributes), so the baseline must be
+        # LF on every platform or the check would drift CRLF-vs-LF across OSes.
+        with open(path, "w", encoding="utf-8", newline="") as fh:
+            fh.write(frame1)
+        state = "unchanged" if old == frame1 else ("updated" if existed else "created")
+        record(f"golden {key}", True, f"baseline {state}")
+        return
+
+    if not path.exists():
+        record(f"golden {key}", False,
+               f"NO baseline at {path.relative_to(ROOT)} — run with --update")
+        return
+    baseline = _read_lf(path)
+    if frame1 == baseline:
+        record(f"golden {key}", True, f"matches baseline ({len(frame1)} bytes)")
+    else:
+        record(f"golden {key}", False,
+               f"DRIFT vs baseline: {_first_diff(frame1, baseline)} "
+               "(intentional? run --update and review the diff)")
+
+
+def main(argv: list[str]) -> int:
+    update = "--update" in argv
+    only = {a for a in argv if not a.startswith("-")}
+
+    registry.load_all()
+    for mod, _tb in registry.load_errors():
+        print(f"warning: widget module {mod} failed to import", file=sys.stderr)
+
+    widgets = [c for c in registry.all_widgets() if not only or c.key in only]
+    if not widgets:
+        print(f"error: no widgets matched {only or '(all)'}", file=sys.stderr)
+        return 2
+
+    for cls in widgets:
+        check_widget(cls, update)
+
+    failed = [r for r in results if not r[1]]
+    print(f"\n{len(results) - len(failed)}/{len(results)} widgets "
+          f"{'baselined' if update else 'match golden frames'} "
+          f"(size {WIDTH}x{HEIGHT}, theme {THEME})")
+    if failed and not update:
+        print("golden-frame drift — review, then `--update` if intended:")
+        for name, _ok, detail in failed:
+            print(f"  - {name}: {detail}")
+    return 1 if (failed and not update) else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv[1:]))