taut-tui 0.8.9__tar.gz

taut_tui-0.8.9/.gitignore

@@ -0,0 +1,25 @@
+.DS_Store
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+.hypothesis/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.py[cod]
+.venv/
+.taut.db
+.taut.db.lock
+.taut.lock
+.taut.db-wal
+.taut.db-shm
+.envrc
+.taut.toml
+.weft
+.broker*
+extensions/taut_pg/uv.lock

taut_tui-0.8.9/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Van Lindberg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

taut_tui-0.8.9/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.5
+Name: taut-tui
+Version: 0.8.9
+Summary: Human-first terminal interface extension for Taut
+Author-email: Van Lindberg <van.lindberg@gmail.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: taut-chat>=0.9.0
+Requires-Dist: textual>=8.2.8
+Provides-Extra: dev
+Requires-Dist: build>=1.5.0; extra == 'dev'
+Requires-Dist: mypy>=2.3.0; extra == 'dev'
+Requires-Dist: pytest-cov>=7.1.0; extra == 'dev'
+Requires-Dist: pytest-timeout>=2.4.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.8.0; extra == 'dev'
+Requires-Dist: pytest>=9.1.1; extra == 'dev'
+Requires-Dist: ruff>=0.16.3; extra == 'dev'
+Requires-Dist: taut-summon>=0.9.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# taut-tui
+
+`taut-tui` is Taut's human-first terminal interface extension. It reflects
+the public capabilities of `taut-chat` and loaded first-party extensions in a
+full-screen Textual application. It does not define a second chat model or
+derive forms from CLI arguments.
+
+Install it beside core, or use core's convenience extra:
+
+```bash
+python -m pip install taut-chat taut-tui
+# equivalent convenience install
+python -m pip install 'taut-chat[tui]'
+taut tui
+```
+
+The extension publishes `tui` through the `taut.commands` entry-point group.
+There is intentionally no separate `taut-tui` console script. Without this
+distribution installed, core does not claim the `tui` command.
+
+The interface provides transcript-first navigation, native typed actions and
+forms, vi-like and conventional keys, mouse controls, state-preserving terminal
+reflow, actor-free system reports, and supervised terminal handoff to
+`taut-summon` when that extension is available. Workspace load remains a
+CLI-only maintenance action.
+
+The governing behavior is in
+[`docs/specs/10-taut-tui.md`](../../docs/specs/10-taut-tui.md). Architecture
+and ownership rationale are in
+[`docs/implementation/12-taut-tui.md`](../../docs/implementation/12-taut-tui.md).
+
+## Development
+
+From the repository root:
+
+```bash
+uv run --project extensions/taut_tui --extra dev \
+  pytest extensions/taut_tui/tests -n 0
+uv run --project extensions/taut_tui --extra dev \
+  ruff check extensions/taut_tui/taut_tui extensions/taut_tui/tests
+uv run --project extensions/taut_tui --extra dev \
+  mypy extensions/taut_tui/taut_tui extensions/taut_tui/tests
+```
+
+The retained lock runs the complete suite with Textual 8.2.8. There is no
+separate older-Textual compatibility lane.

taut_tui-0.8.9/README.md

@@ -0,0 +1,46 @@
+# taut-tui
+
+`taut-tui` is Taut's human-first terminal interface extension. It reflects
+the public capabilities of `taut-chat` and loaded first-party extensions in a
+full-screen Textual application. It does not define a second chat model or
+derive forms from CLI arguments.
+
+Install it beside core, or use core's convenience extra:
+
+```bash
+python -m pip install taut-chat taut-tui
+# equivalent convenience install
+python -m pip install 'taut-chat[tui]'
+taut tui
+```
+
+The extension publishes `tui` through the `taut.commands` entry-point group.
+There is intentionally no separate `taut-tui` console script. Without this
+distribution installed, core does not claim the `tui` command.
+
+The interface provides transcript-first navigation, native typed actions and
+forms, vi-like and conventional keys, mouse controls, state-preserving terminal
+reflow, actor-free system reports, and supervised terminal handoff to
+`taut-summon` when that extension is available. Workspace load remains a
+CLI-only maintenance action.
+
+The governing behavior is in
+[`docs/specs/10-taut-tui.md`](../../docs/specs/10-taut-tui.md). Architecture
+and ownership rationale are in
+[`docs/implementation/12-taut-tui.md`](../../docs/implementation/12-taut-tui.md).
+
+## Development
+
+From the repository root:
+
+```bash
+uv run --project extensions/taut_tui --extra dev \
+  pytest extensions/taut_tui/tests -n 0
+uv run --project extensions/taut_tui --extra dev \
+  ruff check extensions/taut_tui/taut_tui extensions/taut_tui/tests
+uv run --project extensions/taut_tui --extra dev \
+  mypy extensions/taut_tui/taut_tui extensions/taut_tui/tests
+```
+
+The retained lock runs the complete suite with Textual 8.2.8. There is no
+separate older-Textual compatibility lane.

taut_tui-0.8.9/pyproject.toml

@@ -0,0 +1,81 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "taut-tui"
+version = "0.8.9"
+description = "Human-first terminal interface extension for Taut"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "MIT"}
+license-files = ["LICENSE"]
+authors = [
+    {name = "Van Lindberg", email = "van.lindberg@gmail.com"},
+]
+dependencies = [
+    "taut-chat>=0.9.0",
+    "textual>=8.2.8",
+]
+
+[project.entry-points."taut.commands"]
+tui = "taut_tui.command_manifest:tui"
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.5.0",
+    "mypy>=2.3.0",
+    "pytest>=9.1.1",
+    "pytest-cov>=7.1.0",
+    "pytest-timeout>=2.4.0",
+    "pytest-xdist>=3.8.0",
+    "ruff>=0.16.3",
+    "taut-summon>=0.9.0",
+]
+
+[tool.uv.sources]
+taut-chat = { path = "../..", editable = true }
+taut-summon = { path = "../taut_summon", editable = true }
+
+[tool.hatch.build]
+include = [
+    "/taut_tui/**/*.py",
+    "/taut_tui/py.typed",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+testpaths = ["tests"]
+addopts = "-ra -q --strict-markers"
+markers = [
+    "sqlite_only: tests that validate built-in SQLite/path behavior",
+    "tui_only: tests that validate the TUI",
+]
+
+[tool.mypy]
+python_version = "3.11"
+no_namespace_packages = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+
+[tool.ruff]
+target-version = "py311"
+line-length = 88
+
+[tool.ruff.lint]
+extend-select = ["E", "W", "F", "I", "B", "C901", "C4", "UP"]
+ignore = ["E501", "B008"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["taut", "taut_tui"]
+
+[tool.ruff.lint.mccabe]
+max-complexity = 10

taut_tui-0.8.9/taut_tui/__init__.py

@@ -0,0 +1,31 @@
+"""Lazy public launch facade for Taut's optional terminal interface."""
+
+from __future__ import annotations
+
+
+class TuiLaunchError(Exception):
+    """A user-facing failure before or during TUI startup."""
+
+
+class MissingTuiDependencyError(TuiLaunchError):
+    """The extension's required Textual dependency is not installed."""
+
+
+def launch(
+    *,
+    db_path: str | None,
+    as_name: str | None,
+    auth_token: str | None,
+) -> int:
+    """Validate and launch the optional TUI without eager framework imports."""
+
+    from taut_tui._launch import run_tui
+
+    return run_tui(
+        db_path=db_path,
+        as_name=as_name,
+        auth_token=auth_token,
+    )
+
+
+__all__ = ["MissingTuiDependencyError", "TuiLaunchError", "launch"]

taut_tui-0.8.9/taut_tui/_launch.py

@@ -0,0 +1,56 @@
+"""Terminal and optional-dependency preflight for the real TUI app."""
+
+from __future__ import annotations
+
+import importlib
+import sys
+from typing import Any, TextIO
+
+from taut_tui import MissingTuiDependencyError, TuiLaunchError
+
+_INSTALL_HINT = (
+    "The taut-tui installation is missing its Textual dependency; "
+    "reinstall it with: pip install 'taut-tui'"
+)
+
+
+def run_tui(
+    *,
+    db_path: str | None,
+    as_name: str | None,
+    auth_token: str | None,
+) -> int:
+    """Launch the TUI after proving terminal and dependency availability."""
+
+    if not _is_tty(sys.stdin) or not _is_tty(sys.stdout):
+        raise TuiLaunchError("taut tui requires interactive input and output terminals")
+
+    _import_textual()
+    app_module = importlib.import_module("taut_tui.app")
+    app_type: Any = app_module.TautApp
+    app = app_type(
+        db_path=db_path,
+        as_name=as_name,
+        auth_token=auth_token,
+    )
+    app.run()
+    return 0
+
+
+def _is_tty(stream: TextIO) -> bool:
+    try:
+        return stream.isatty()
+    except (AttributeError, OSError, ValueError):
+        return False
+
+
+def _import_textual() -> None:
+    try:
+        importlib.import_module("textual")
+    except ModuleNotFoundError as exc:
+        if exc.name != "textual":
+            raise
+        raise MissingTuiDependencyError(_INSTALL_HINT) from None
+
+
+__all__ = ["run_tui"]