katalyst-taxonomy-tui 2.0.1a4__tar.gz

katalyst_taxonomy_tui-2.0.1a4/.gitignore

@@ -0,0 +1,123 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+# Not a Python build directory: Bard's SPA keeps shared helpers (utils.ts, download.ts) in
+# src/lib, and ignoring it left a fresh clone unable to build or test the SPA.
+!plugins/bard/web/src/lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy / pyright
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyright/
+
+# Ruff
+.ruff_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Local configuration
+*.local
+
+# Browser/Playwright state files
+browser-state-*.json
+
+# Agent harness scratch (run exhaust, never the design bundle)
+.opencode/sessions/
+.opencode/analysis/
+.opencode/package-lock.json
+
+# Build artifacts
+site/
+stack-tests/cucumber-report/
+stack-tests/test-results/
+
+# Generated artifacts (rebuild with `just generate-schemas`)
+taxonomy/src/katalyst_taxonomy/engine/generated/
+.worktrees/
+.plan-74-75-76-77.md
+.HANDOFF-scaffolding-wiring.md
+.HANDOFF-2-cicd-migration.md
+.HANDOFF-action-execution-fixes.md
+.HANDOFF-bdd-coverage.md
+.HANDOFF-*.md
+docs/superpowers/
+
+# Node dependencies — installed, never committed
+node_modules/

katalyst_taxonomy_tui-2.0.1a4/PKG-INFO

@@ -0,0 +1,12 @@
+Metadata-Version: 2.5
+Name: katalyst-taxonomy-tui
+Version: 2.0.1a4
+Summary: Terminal UI for katalyst-taxonomy
+Author: eSimplicity
+License: Proprietary
+Requires-Python: >=3.12
+Requires-Dist: katalyst-engine<6,>=5
+Requires-Dist: katalyst-taxonomy<6,>=5
+Requires-Dist: loguru>=0.7
+Requires-Dist: rich>=13.0
+Requires-Dist: textual>=0.89

katalyst_taxonomy_tui-2.0.1a4/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "katalyst-taxonomy-tui"
+version = "2.0.1a4"
+description = "Terminal UI for katalyst-taxonomy"
+license = { text = "Proprietary" }
+requires-python = ">=3.12"
+authors = [
+    { name = "eSimplicity" }
+]
+dependencies = [
+    "katalyst-taxonomy>=5,<6",
+    "katalyst-engine>=5,<6",
+    "textual>=0.89",
+    "rich>=13.0",
+    "loguru>=0.7",
+]
+
+[project.scripts]
+katalyst-tui = "katalyst_taxonomy_tui.__main__:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/katalyst_taxonomy_tui"]
+
+[tool.hatch.build.targets.wheel.sources]
+"src" = ""
+
+[tool.hatch.build]
+include = [
+    "src/katalyst_taxonomy_tui/**/*.py",
+    "src/katalyst_taxonomy_tui/**/*.css",
+    "src/katalyst_taxonomy_tui/py.typed",
+]

katalyst_taxonomy_tui-2.0.1a4/src/katalyst_taxonomy_tui/__init__.py

@@ -0,0 +1,22 @@
+"""Textual TUI package for the Katalyst taxonomy toolkit."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .app import run
+
+__all__ = ["run"]
+
+
+# Lazy re-export (PEP 562): importing this package must NOT eagerly pull in the
+# optional 'tui' extra (textual). The always-installed `katalyst-tui` console
+# script imports through here; eager imports broke graceful degradation on a
+# plain install (GH #65).
+def __getattr__(name: str) -> object:
+    if name == "run":
+        from .app import run
+
+        return run
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

katalyst_taxonomy_tui-2.0.1a4/src/katalyst_taxonomy_tui/__main__.py

@@ -0,0 +1,73 @@
+"""Console entrypoint for the taxonomy Textual UI.
+
+Takes no repository path: the TUI opens on the effective configuration — every backend
+the active profile reads — and every repository is a filesystem backend declared in the
+user config file. A development (editable) install refuses to fall back to the default
+home: see :mod:`katalyst_taxonomy.adapters.filesystem.development`.
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+#: The distribution this entry point is installed from.
+DISTRIBUTION = "katalyst-taxonomy-tui"
+
+
+def activate_plugins() -> None:
+    """Give plugins a host in the TUI (#219, part 1).
+
+    Parity with the CLI, MCP and REST hosts. The TUI builds its own event bus
+    inside ``app.run``, which this entry point cannot reach, so plugins get a
+    dedicated bus here — none of the five built-ins subscribe to events, and a
+    plugin that needs the TUI's bus should be reached through the app rather than
+    the entry point.
+
+    A plugin that raises during ``register()`` stops the TUI from starting, with
+    the plugin named, rather than launching a UI that is quietly missing a feature.
+    """
+    from katalyst_taxonomy.adapters.filesystem.config import FilesystemConfigAdapter
+    from katalyst_taxonomy.plugins.startup import activate_plugins_for
+    from katalyst_taxonomy.services.source_providers import ensure_source_providers
+
+    # The bundles and plugins config.yaml declares with a source, as the CLI and servers do.
+    ensure_source_providers(True)
+    activate_plugins_for(FilesystemConfigAdapter())
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description=(
+            "Run the katalyst taxonomy Textual UI on the effective configuration "
+            "(<user config home>/config.yaml)."
+        )
+    )
+    parser.parse_args()
+
+    from katalyst_taxonomy.adapters.filesystem.development import development_home_refusal
+    from katalyst_taxonomy.domain.homes import HomeError
+
+    try:
+        refusal = development_home_refusal(DISTRIBUTION)
+    except HomeError as exc:
+        parser.error(str(exc))
+    if refusal is not None:
+        parser.error(refusal)
+
+    try:
+        from .app import run
+    except ModuleNotFoundError as exc:  # pragma: no cover - exercised in clean-install smoke test
+        sys.stderr.write(
+            "katalyst-tui requires the 'tui' extra. Install it with:\n"
+            "    pip install 'katalyst-taxonomy-cli[tui]'\n"
+            f"(missing dependency: {exc.name})\n"
+        )
+        raise SystemExit(1) from exc
+
+    activate_plugins()
+    run()
+
+
+if __name__ == "__main__":
+    main()