cortexshift 0.1.0__py3-none-any.whl

cortexshift/tui/coordinator.py

@@ -0,0 +1,173 @@
+"""Runs the dashboard, then hands the terminal to a native provider.
+
+The ordering enforced here is an architectural guarantee, not a convenience:
+
+    CortexShiftApp.run()   →   returns TuiExitRequest
+                               (Textual has torn down and restored the terminal)
+                           →   RunService / ResumeService / SwitchService
+                           →   native provider owns the terminal
+
+No provider process is ever started while the Textual application is alive, and no
+provider TUI is embedded, captured, or multiplexed. `launch_provider` is only ever
+reached after `run_dashboard` has returned.
+"""
+
+import sys
+from collections.abc import Callable
+from dataclasses import dataclass, field
+from pathlib import Path
+
+from cortexshift.application.resume_service import ResumeService
+from cortexshift.application.run_service import RunService
+from cortexshift.application.switch_service import SwitchService
+from cortexshift.domain.errors import ProjectNotInitializedError, TerminalRequiredError
+from cortexshift.domain.session import Session
+from cortexshift.tui.actions import TuiExitAction, TuiExitRequest
+from cortexshift.tui.app import CortexShiftApp, build_app
+
+TTY_REQUIRED_MESSAGE = (
+    "The CortexShift dashboard requires an interactive terminal (TTY).\n\n"
+    "Both standard input and standard output must be attached to a terminal."
+)
+
+
+def _silent(message: str) -> None:
+    """Default announcement sink: the dashboard says nothing on its own."""
+
+
+def terminal_is_interactive() -> bool:
+    """Whether both stdin and stdout are attached to a terminal."""
+    try:
+        return sys.stdin.isatty() and sys.stdout.isatty()
+    except Exception:
+        return False
+
+
+@dataclass
+class TuiSession:
+    """Result of one dashboard invocation and any provider launch that followed."""
+
+    request: TuiExitRequest | None = None
+    session: Session | None = None
+    launched: bool = False
+    events: list[str] = field(default_factory=list)
+
+    @property
+    def exit_code(self) -> int:
+        """Process exit code derived from the launched provider session, if any."""
+        if self.session is None:
+            return 0
+        from cortexshift.domain.session import SessionStatus
+
+        if self.session.status in (SessionStatus.COMPLETED, SessionStatus.INTERRUPTED):
+            return 0
+        return self.session.exit_code or 1
+
+
+class TuiCoordinator:
+    """Sequences dashboard lifetime and native provider launch."""
+
+    def __init__(
+        self,
+        *,
+        run_service: RunService | None = None,
+        resume_service: ResumeService | None = None,
+        switch_service: SwitchService | None = None,
+        app_factory: Callable[[], CortexShiftApp] | None = None,
+        dashboard_runner: Callable[[], TuiExitRequest | None] | None = None,
+        is_tty: Callable[[], bool] = terminal_is_interactive,
+        announce: Callable[[str], None] | None = None,
+    ) -> None:
+        self._run_service = run_service
+        self._resume_service = resume_service
+        self._switch_service = switch_service
+        self._app_factory = app_factory
+        self._dashboard_runner = dashboard_runner
+        self._is_tty = is_tty
+        self._announce = announce or _silent
+
+    # ------------------------------------------------------------------
+
+    def start(self, project_root: Path | str | None = None) -> TuiSession:
+        """Run the dashboard and, if requested, launch a provider afterwards.
+
+        Raises:
+            ProjectNotInitializedError: If no initialized project is found.
+            TerminalRequiredError: If the process has no interactive terminal.
+        """
+        result = TuiSession()
+
+        request = self._run_dashboard(project_root)
+        result.events.append("dashboard_finished")
+        result.request = request
+
+        if request is None:
+            return result
+
+        self._announce(f"{request.description} — CortexShift released the terminal.")
+        result.events.append("provider_launch_started")
+        result.launched = True
+        result.session = self.launch_provider(request)
+        result.events.append("provider_launch_finished")
+        return result
+
+    def _run_dashboard(self, project_root: Path | str | None) -> TuiExitRequest | None:
+        """Run the Textual application to completion and return its exit request.
+
+        The project is resolved before the terminal is checked: someone standing in the
+        wrong directory should be told that, not told about their terminal.
+        """
+        if self._dashboard_runner is not None:
+            return self._dashboard_runner()
+
+        resolved = resolve_project_root(project_root)
+
+        if not self._is_tty():
+            raise TerminalRequiredError(TTY_REQUIRED_MESSAGE)
+
+        app = self._app_factory() if self._app_factory else build_app(resolved)
+        return app.run()
+
+    # ------------------------------------------------------------------
+
+    def launch_provider(self, request: TuiExitRequest) -> Session | None:
+        """Invoke the existing provider service for a dashboard exit request.
+
+        Only ever called after the Textual application has finished. The provider owns
+        the terminal from here; CortexShift does not wrap, capture, or emulate it.
+        """
+        if request.action is TuiExitAction.RUN:
+            service = self._run_service or RunService()
+            return service.run(provider_name=request.provider)
+
+        if request.action is TuiExitAction.RESUME:
+            service_resume = self._resume_service or ResumeService()
+            outcome = service_resume.resume(
+                provider_name=request.provider,
+                session_id=request.selected_session_id,
+            )
+            return outcome if isinstance(outcome, Session) else None
+
+        service_switch = self._switch_service or SwitchService()
+        switch_result = service_switch.switch(
+            target_provider_name=request.provider,
+            new_session=request.force_new_session,
+            resume_session_id=request.selected_session_id,
+            note=request.note,
+        )
+        return switch_result.target_session
+
+
+def resolve_project_root(start_dir: Path | str | None = None) -> Path:
+    """Resolve the initialized project the dashboard should bind to.
+
+    Raises:
+        ProjectNotInitializedError: If no initialized project root is found.
+    """
+    from cortexshift.application.locator import ProjectLocator
+
+    start_path = Path(start_dir) if start_dir is not None else None
+    project_root = ProjectLocator.find_project_root(start_path)
+    if project_root is None:
+        raise ProjectNotInitializedError()
+    return project_root

cortexshift/tui/cortexshift.tcss

@@ -0,0 +1,258 @@
+/* CortexShift control center theme.
+ *
+ * A restrained engineering palette: dark ground, one accent, subtle borders, and
+ * status emphasis reserved for state that actually needs attention. Meaning is never
+ * carried by colour alone — glyphs accompany every status marker.
+ */
+
+Screen {
+    background: $surface;
+    color: $foreground;
+}
+
+/* ---------- Shell layout ---------- */
+
+#shell {
+    height: 1fr;
+}
+
+#sidebar {
+    width: 20;
+    min-width: 20;
+    background: $panel;
+    border-right: solid $primary-darken-2;
+    padding: 1 1 0 1;
+}
+
+#sidebar-title {
+    color: $accent;
+    text-style: bold;
+    padding: 0 0 1 1;
+}
+
+#nav {
+    height: auto;
+    border: none;
+    background: $panel;
+}
+
+#nav > .option-list--option {
+    padding: 0 0;
+}
+
+#nav:focus > .option-list--option-highlighted {
+    background: $primary;
+    color: $text;
+    text-style: bold;
+}
+
+#content {
+    padding: 1 2;
+    height: 1fr;
+}
+
+#status-line {
+    height: 1;
+    padding: 0 2;
+    background: $panel;
+    color: $text-muted;
+}
+
+/* Compact layout for terminals narrower than 90 columns: the sidebar folds away and
+   the section name moves into the status line. Number keys keep working. */
+
+.compact #sidebar {
+    display: none;
+}
+
+.compact #content {
+    padding: 1 1;
+}
+
+/* ---------- Sections ---------- */
+
+.section {
+    height: 1fr;
+    overflow-y: auto;
+}
+
+.section-title {
+    text-style: bold;
+    color: $accent;
+    padding: 0 0 1 0;
+}
+
+.panel {
+    height: auto;
+    border-top: solid $primary-darken-2;
+    border-title-color: $accent;
+    border-title-style: bold;
+    border-subtitle-color: $text-muted;
+    border-subtitle-style: italic;
+    padding: 0 0 1 0;
+    margin: 1 0 0 0;
+}
+
+.panel-title {
+    color: $text-muted;
+    text-style: bold;
+    padding: 1 0 0 0;
+}
+
+.field-list {
+    height: auto;
+    padding: 0 0 0 1;
+}
+
+.bullets {
+    height: auto;
+    padding: 0 0 0 0;
+}
+
+.columns {
+    height: auto;
+}
+
+.column {
+    width: 1fr;
+    height: auto;
+    padding: 0 2 0 0;
+}
+
+.empty-state {
+    padding: 2 2;
+    color: $text-muted;
+}
+
+.notice {
+    padding: 0 0 1 0;
+    color: $warning;
+}
+
+/* ---------- Tables ---------- */
+
+DataTable {
+    height: auto;
+    max-height: 20;
+    border: round $primary-darken-2;
+}
+
+DataTable > .datatable--header {
+    text-style: bold;
+    background: $panel;
+    color: $text-muted;
+}
+
+DataTable > .datatable--cursor {
+    background: $primary;
+    color: $text;
+}
+
+.detail {
+    height: auto;
+    border-top: solid $primary-darken-2;
+    padding: 1 0 0 0;
+}
+
+/* ---------- Status emphasis ---------- */
+
+.state-ok {
+    color: $success;
+}
+
+.state-warn {
+    color: $warning;
+}
+
+.state-fail {
+    color: $error;
+}
+
+.state-active {
+    color: $accent;
+}
+
+.state-muted {
+    color: $text-muted;
+}
+
+/* ---------- Modals ---------- */
+
+ModalScreen {
+    align: center middle;
+    background: $surface 60%;
+}
+
+.modal {
+    width: 72;
+    max-width: 90%;
+    height: auto;
+    max-height: 90%;
+    padding: 1 2;
+    background: $panel;
+    border: thick $primary;
+}
+
+.modal-title {
+    text-style: bold;
+    color: $accent;
+    padding: 0 0 1 0;
+}
+
+.modal-help {
+    color: $text-muted;
+    padding: 0 0 1 0;
+}
+
+.modal-error {
+    color: $error;
+    height: auto;
+    padding: 0 0 1 0;
+}
+
+.modal-body {
+    height: auto;
+    max-height: 24;
+    overflow-y: auto;
+}
+
+.modal-buttons {
+    height: auto;
+    align-horizontal: right;
+    padding: 1 0 0 0;
+}
+
+.modal-buttons Button {
+    margin: 0 0 0 2;
+    min-width: 12;
+}
+
+.field-label {
+    color: $text-muted;
+    padding: 1 0 0 0;
+}
+
+Input {
+    border: tall $primary-darken-2;
+}
+
+Input:focus {
+    border: tall $accent;
+}
+
+/* ---------- Too-small terminal guard ---------- */
+
+#too-small {
+    display: none;
+    height: 1fr;
+    padding: 1 2;
+    color: $warning;
+}
+
+.too-small #shell {
+    display: none;
+}
+
+.too-small #too-small {
+    display: block;
+}