sanityops-cli 0.1.3__py3-none-any.whl

sanityops_cli/progress/tracker.py

@@ -0,0 +1,159 @@
+# Copyright 2026 zipsonken
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+"""Step-based progress display with spinner, elapsed timing, and logging."""
+
+from __future__ import annotations
+
+import time
+from types import TracebackType
+from typing import Any
+
+from rich.console import Console, Group, RenderableType
+from rich.live import Live
+from rich.markup import escape
+from rich.spinner import Spinner
+from rich.status import Status
+from rich.text import Text
+
+from sanityops_cli.logging.logger import Logger
+
+#: Refresh rate for spinner/live displays (Hz).
+_REFRESH_PER_SECOND = 10
+
+#: Width of the summary divider, in characters.
+_DIVIDER_LENGTH = 30
+
+__all__ = ["ProgressTracker", "StepContext"]
+
+
+class ProgressTracker:
+    """Tracks sequential steps: spinner progress, per-step timing, logging."""
+
+    def __init__(self, console: Console, logger: Logger, verbose: bool = False) -> None:
+        self.console = console
+        self.logger = logger
+        self.verbose = verbose
+        self.step_times: list[tuple[str, float]] = []
+
+    def step(self, name: str) -> StepContext:
+        """Start a new tracked step, returning its context manager."""
+        return StepContext(self, name)
+
+    def summary(self) -> None:
+        """Print a divider and the total elapsed time across all steps."""
+        total = sum(duration for _, duration in self.step_times)
+        self.console.print(f"[dim]{'─' * _DIVIDER_LENGTH}[/]")
+        self.console.print(f"[bold]Total time:[/] {total:.2f}s")
+
+
+class _LiveConsole:
+    """Console-like sink that appends printed lines into a step's Live display.
+
+    Duck-types ``Console.print`` so an agent's ProgressHook can stream detail
+    lines into the step's Live renderable (expand). The accumulated lines
+    collapse away when the Live stops, replaced by the step summary.
+    """
+
+    def __init__(self, live: Live, step_name: str) -> None:
+        self._live = live
+        self._step_name = step_name
+        self._lines: list[RenderableType] = []
+
+    def print(self, *objects: Any, **kwargs: Any) -> None:
+        """Duck-type ``Console.print``: render objects into the Live display.
+
+        Multiple objects are joined with spaces (rich's default); a ``style``
+        kwarg is honored. Other rich keyword options are ignored — each print
+        is rendered as its own row in the Live display.
+
+        Callers must pass pre-escaped markup (see ``rich.markup.escape``),
+        mirroring ``Console.print`` semantics: the message is parsed as markup.
+        """
+        message = " ".join(str(obj) for obj in objects) if objects else ""
+        line = Text.from_markup(message, style=kwargs.get("style"))
+        self._lines.append(line)
+        self._live.update(
+            Group(
+                Spinner("dots", text=f"[bold cyan]{escape(self._step_name)}[/]"),
+                *self._lines,
+            )
+        )
+
+
+class StepContext:
+    """Context manager for a single tracked step."""
+
+    def __init__(self, tracker: ProgressTracker, name: str) -> None:
+        self.tracker = tracker
+        self.name = name
+        self._start: float = 0.0
+        self._live: Live | None = None
+        self._status: Status | None = None
+        self._live_console: _LiveConsole | None = None
+
+    @property
+    def console(self) -> Console | _LiveConsole:
+        """Console to route agent progress output into (Live sink in verbose mode)."""
+        if self._live_console is not None:
+            return self._live_console
+        return self.tracker.console
+
+    def __enter__(self) -> StepContext:
+        self._start = time.perf_counter()
+        self.tracker.logger.step_started(self.name)
+        if self.tracker.verbose:
+            self._live = Live(
+                console=self.tracker.console, refresh_per_second=_REFRESH_PER_SECOND
+            )
+            self._live.start()
+            self._live.update(Spinner("dots", text=f"[bold cyan]{escape(self.name)}[/]"))
+            self._live_console = _LiveConsole(self._live, self.name)
+        else:
+            self._status = self.tracker.console.status(f"[bold cyan]{escape(self.name)}[/]")
+            self._status.start()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool:
+        duration = time.perf_counter() - self._start
+        if exc_type is None:
+            self.tracker.logger.step_completed(self.name, duration)
+            self.tracker.step_times.append((self.name, duration))
+            summary = Text.from_markup(f"[green]✓[/] {escape(self.name)} ({duration:.2f}s)")
+            if self._live is not None:
+                self._live.update(summary)
+                self._live.stop()
+                self._live = None
+                self._live_console = None
+            else:
+                self._status.stop()
+                self._status = None
+                self.tracker.console.print(summary)
+        else:
+            self.tracker.logger.step_failed(self.name, str(exc_val))
+            if self._live is not None:
+                self._live.update(Text.from_markup(f"[red]✗[/] {escape(self.name)} ({duration:.2f}s)"))
+                self._live.stop()
+                self._live = None
+                self._live_console = None
+            else:
+                self._status.stop()
+                self._status = None
+        return False

sanityops_cli/renderers/__init__.py

@@ -0,0 +1,14 @@
+# Copyright 2026 zipsonken
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#

sanityops_cli/renderers/command_renderer/inspect_command_renderer.py

@@ -0,0 +1,87 @@
+# Copyright 2026 zipsonken
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+from typing import Any
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+console = Console()
+
+# ============================================================================
+# Inspect Command Renderer
+# ============================================================================
+
+def render_inspect_terminal(catalog: dict[str, Any]) -> None:
+    """inspect resulte renderer for terminal"""
+    directory = catalog.get("directory", "-")
+    skills = catalog.get("skills", [])
+    tools = catalog.get("tools", [])
+    prompts = catalog.get("prompts", [])
+    meta = catalog.get("meta", {})
+    elapsed = meta.get("time_elapsed", 0)
+    loops = meta.get("loops_used", 0)
+
+    console.print()
+    header_text = Text()
+    header_text.append("📋 Inspect Report\n\n", style="bold")
+    header_text.append(f"Directory: {directory}", style="dim")
+    console.print(Panel(header_text, border_style="blue"))
+    console.print()
+
+    # Skills
+    console.print(f"[bold]🔧 Skills ({len(skills)})[/]")
+    if skills:
+        for s in skills:
+            name = s.get("name", "-")
+            path = s.get("path", "-")
+            desc = s.get("description", "")
+            console.print(f"  ├─ {name:<20} {path:<30} {desc[:40]}")
+    else:
+        console.print("  [dim]None[/]")
+    console.print()
+
+    # Tools
+    console.print(f"[bold]⚙️ Tools ({len(tools)})[/]")
+    if tools:
+        for t in tools:
+            name = t.get("name", "-")
+            path = t.get("path", "-")
+            t_type = t.get("type", "unknown")
+            desc = t.get("description", "")
+            console.print(f"  ├─ {name:<20} {path} ({t_type})    {desc[:30]}")
+    else:
+        console.print("  [dim]None[/]")
+    console.print()
+
+    # Prompts
+    console.print(f"[bold]💬 Prompts ({len(prompts)})[/]")
+    if prompts:
+        for p in prompts:
+            name = p.get("name", "-")
+            path = p.get("path", "-")
+            p_type = p.get("type", "file")
+            desc = p.get("description", "")
+            console.print(f"  ├─ {name:<20} {path} ({p_type})    {desc[:30]}")
+    else:
+        console.print("  [dim]None[/]")
+    console.print()
+
+    # Statistics
+    console.print(
+        f"[dim]Statistics: {len(skills)} skills, {len(tools)} tools, {len(prompts)} prompts"
+        f"  |  Time elapsed: {elapsed:.1f}s  |  Loops: {loops}[/]"
+    )

sanityops_cli/templates/__init__.py

@@ -0,0 +1,14 @@
+# Copyright 2026 zipsonken
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#

sanityops_cli/templates/inspect_config.yaml

@@ -0,0 +1,55 @@
+# ============================================================================
+# Sanityops CLI - Inspect Configuration Template
+# ============================================================================
+# Usage:
+#   1. Run: sanityops-cli init
+#   2. Fill in model configuration below (required)
+#   3. Connect to the Sanityops service:
+#      sanityops-cli config server.base_url "<your-server-url>"
+#      sanityops-cli config server.api_key
+#   4. Configure artifact paths below
+#   5. Run: sanityops-cli inspect
+#      (A project is created automatically on first upload and the
+#      project id/name are written back to this file.)
+# ============================================================================
+
+# Project metadata
+# id: Left as a placeholder. A real project id is assigned automatically
+#     on first inspect upload (project auto-created), or set it manually.
+# name: Project display name (optional, filled automatically on first upload)
+project:
+  id: "00000000-0000-0000-0000-000000000000"
+  name: ""
+
+# Model configuration
+# Fill in the fields below, or remove this section entirely to configure
+# via LLM_* environment variables instead:
+#   LLM_PROVIDER, LLM_API_KEY, LLM_MODEL_ID, LLM_BASE_URL
+model:
+  provider: anthropic                 # Required: anthropic, openai, azure, etc.
+  api_key: ""                         # Required: your API key (keep this file out of git)
+  model_id: claude-sonnet-4-20250514  # Required: model identifier
+  base_url: ""                        # Optional: custom endpoint URL
+
+# Agent configuration (optional)
+# Override CLI defaults for timeout and token budget.
+# agent:
+#   timeout: 1800      # seconds (default: 1800, 30min)
+#   token_budget: 200000
+
+# System Prompt file list (supports any plaintext file format)
+prompts:
+  - file: prompts/system_prompt.md
+  - file: prompts/fallback_prompt.py
+  - file: prompts/summary_prompt.ts
+
+# Tools Schema file list (supports any plaintext file format)
+tools:
+  - file: tools/search_tools.json
+  - file: tools/file_ops.py
+  - file: tools/code_tools.ts
+
+# Skills file list (supports any plaintext file format)
+skills:
+  - file: skills/code_review.md
+  - file: skills/code_fix/skill.md

sanityops_cli/utils/__init__.py

@@ -0,0 +1,14 @@
+# Copyright 2026 zipsonken
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#