speclogician 0.0.0b1__py3-none-any.whl → 0.0.0.dev1__py3-none-any.whl

speclogician/state/state_stats.py

@@ -1,133 +0,0 @@
-#
-#   Imandra Inc.
-#
-#   speclogician/state/state_stats.py
-#
-
-from __future__ import annotations
-
-from dataclasses import dataclass
-
-from .inst import StateInstance
-
-
-@dataclass(frozen=True)
-class StatsCalculator:
-    """
-    Compute time-series stats over a collection of State objects.
-
-    Assumptions:
-    - Each State has `instances` ordered newest-first (index 0 = latest).
-    - We return lists oldest-first for plotting.
-    """
-
-    @staticmethod
-    def stats(instances: list[StateInstance]) -> dict[str, list[int | str]]:
-        """ 
-        Note: we reverse the order of StateInstances here so the 0s element (latest state instance) is all the way on the right
-        """
-        out: dict[str, list[int | str]] = {
-            # identity / time
-            "created_at": [],
-            "num_changes": [],
-
-            # ---- domain model counts (from DomainModel) ----
-            "num_state_preds_total": [],
-            "num_state_preds_valid_logic": [],
-            "num_state_preds_matched": [],
-
-            "num_action_preds_total": [],
-            "num_action_preds_valid_logic": [],
-            "num_action_preds_matched": [],
-
-            "num_preds_total": [],
-            "num_preds_valid_logic": [],
-            "num_preds_matched": [],
-
-            "num_trans_total": [],
-            "num_trans_valid_logic": [],
-            "num_trans_matched": [],
-
-            # ---- scenario stats (from Spec) ----
-            "num_sc_total": [],
-            "num_sc_missing": [],
-            "num_sc_matched": [],
-            "num_sc_inconsistent": [],
-            "num_sc_conflicted": [],
-
-            # ---- artifact stats (from ArtifactContainer) ----
-            "num_test_traces_total": [],
-            "num_test_traces_matched": [],
-            "num_test_traces_logic_good": [],
-
-            "num_log_traces_total": [],
-            "num_log_traces_matched": [],
-            "num_log_traces_logic_good": [],
-
-            "num_doc_arts_total": [],
-            "num_doc_arts_matched": [],
-            "num_src_code_arts_total": [],
-            "num_src_code_arts_matched": [],
-
-            # ---- optional derived metrics (handy for “progress”) ----
-            "num_traces_total": [],
-            "num_traces_logic_good": [],
-            "num_traces_matched": [],
-        }
-
-        for inst in instances[::-1]:
-            # identity / time
-            out["created_at"].append(inst.created_at.isoformat())
-            out["num_changes"].append(len(inst.changes or []))
-
-            # domain model
-            dm = inst.spec.domain_model
-            out["num_state_preds_total"].append(dm.num_state_preds_total)
-            out["num_state_preds_valid_logic"].append(dm.num_state_preds_valid_logic)
-            out["num_state_preds_matched"].append(dm.num_state_preds_matched)
-
-            out["num_action_preds_total"].append(dm.num_action_preds_total)
-            out["num_action_preds_valid_logic"].append(dm.num_action_preds_valid_logic)
-            out["num_action_preds_matched"].append(dm.num_action_preds_matched)
-
-            out["num_preds_total"].append(dm.num_preds_total)
-            out["num_preds_valid_logic"].append(dm.num_preds_valid_logic)
-            out["num_preds_matched"].append(dm.num_preds_matched)
-
-            out["num_trans_total"].append(dm.num_trans_total)
-            out["num_trans_valid_logic"].append(dm.num_trans_valid_logic)
-            out["num_trans_matched"].append(dm.num_trans_matched)
-
-            # spec / scenarios
-            sp = inst.spec
-            out["num_sc_total"].append(sp.num_sc_total)
-            out["num_sc_missing"].append(sp.num_sc_missing)
-            out["num_sc_matched"].append(sp.num_sc_matched)
-            out["num_sc_inconsistent"].append(sp.num_sc_inconsistent)
-            out["num_sc_conflicted"].append(sp.num_sc_conflicted)
-
-            # artifacts
-            ac = inst.art_container
-            out["num_test_traces_total"].append(ac.num_test_traces_total)
-            out["num_test_traces_matched"].append(ac.num_test_traces_matched)
-            out["num_test_traces_logic_good"].append(ac.num_test_traces_logic_good)
-
-            out["num_log_traces_total"].append(ac.num_log_traces_total)
-            out["num_log_traces_matched"].append(ac.num_log_traces_matched)
-            out["num_log_traces_logic_good"].append(ac.num_log_traces_logic_good)
-
-            out["num_doc_arts_total"].append(ac.num_doc_arts_total)
-            out["num_doc_arts_matched"].append(ac.num_doc_arts_matched)
-            out["num_src_code_arts_total"].append(ac.num_src_code_arts_total)
-            out["num_src_code_arts_matched"].append(ac.num_src_code_arts_matched)
-
-            # derived
-            traces_total = ac.num_test_traces_total + ac.num_log_traces_total
-            traces_good = ac.num_test_traces_logic_good + ac.num_log_traces_logic_good
-            traces_matched = ac.num_test_traces_matched + ac.num_log_traces_matched
-
-            out["num_traces_total"].append(traces_total)
-            out["num_traces_logic_good"].append(traces_good)
-            out["num_traces_matched"].append(traces_matched)
-
-        return out

speclogician/tui/app.py

@@ -1,257 +0,0 @@
-#
-#   Imandra Inc.
-#
-#   speclogician/tui/app.py
-#
-
-from __future__ import annotations
-
-import os
-import time
-from datetime import datetime, timezone
-from pathlib import Path
-from typing import Any
-
-import pyperclip
-from textual.app import App
-from textual.screen import Screen
-
-from ..state.state import State
-from ..utils.load import load_state
-from .demo import DemoScreen
-from .splash_screen import SplashScreen
-from .stats_screen import StatsScreen
-from .main_screen import MainScreen
-
-
-class SpecLogicianApp(App[Any]):
-    """SpecLogician TUI app with optional file-watch + manual update."""
-
-    TITLE = "Imandra SpecLogician"
-    SUB_TITLE = "AI-powered spec synthesis, verification & analysis"
-
-    CSS_PATH = "app.tcss"
-
-    SCREENS = {
-        "splash": SplashScreen,
-        "demo": DemoScreen,
-        "stats": StatsScreen,
-        "main": MainScreen,
-    }
-
-    BINDINGS = [
-        ("s", "stats", "Statistics"),
-        ("m", "main", "Main"),
-        ("d", "demo", "Demo Artifacts"),
-        ("c", "copy_full_iml", "Copy IML"),
-        ("u", "update_state", "Update State"),
-        ("q", "quit", "Quit"),
-    ]
-
-    def __init__(
-        self,
-        state: State | None = None,
-        demo_md: str | None = None,
-        demo_title: str = "Demo artifacts",
-        *,
-        state_path: Path | None = None,
-        watch_state_file: bool = False,
-        poll_interval_s: float = 0.5,
-    ) -> None:
-        super().__init__()
-
-        self.demo_md = demo_md
-        self.demo_title = demo_title
-
-        self.state_path = state_path
-        self.watch_state_file = watch_state_file
-        self.poll_interval_s = poll_interval_s
-
-        # manual-update mode fields
-        self._pending_state_sig: tuple[int, int] | None = None
-        self._update_available: bool = False
-
-        # state
-        self.state = load_state() if state is None else state
-
-        # file watch bookkeeping
-        self._state_sig: tuple[int, int] | None = None
-        self._last_reload_ts: float = 0.0
-
-        # one-shot popup
-        self._notified_update_available: bool = False
-
-    # -------------------------------------------------------------------------
-    # mount + nav
-    # -------------------------------------------------------------------------
-
-    def on_mount(self) -> None:
-        # If demo isn't available,
-        # action_demo() will show a popup instead.
-
-        # start watch timer if enabled
-        if self.watch_state_file and self.state_path:
-            self._state_sig = self._get_state_file_signature()
-            self._set_last_updated_indicator(self._state_sig)
-            self.set_interval(self.poll_interval_s, self._poll_state_file)
-        else:
-            self._set_last_updated_indicator(None)
-
-        self.push_screen("splash")
-
-    def action_stats(self) -> None:
-        self.switch_screen("stats")
-
-    def action_main(self) -> None:
-        self.switch_screen("main")
-
-    def action_demo(self) -> None:
-        # If not in demo mode, show a popup (mirrors "No update available")
-        if not self.demo_md:
-            self.notify("No demo artifacts available (run in demo mode to enable).", timeout=2.0)
-            return
-        self.push_screen(DemoScreen(self.demo_md, title=self.demo_title))
-
-    def action_noop(self) -> None:
-        pass
-
-    # -------------------------------------------------------------------------
-    # copy helper
-    # -------------------------------------------------------------------------
-
-    def action_copy_full_iml(self) -> None:
-        screen: Screen[Any] = self.screen
-        if not isinstance(screen, MainScreen):
-            self.notify("Copy is only available on the Main screen.", timeout=1.0)
-            return
-
-        iml_text = getattr(screen, "_full_iml_text", "")
-        if not iml_text:
-            self.notify("No IML model to copy.", timeout=1.0)
-            return
-
-        pyperclip.copy(iml_text)
-        self.notify("Full IML model copied to clipboard.", timeout=1.2)
-
-    # -------------------------------------------------------------------------
-    # state apply / refresh
-    # -------------------------------------------------------------------------
-
-    def _apply_new_state(self, new_state: State) -> None:
-        self.state = new_state
-
-        screen: Screen[Any] = self.screen
-        if isinstance(screen, MainScreen):
-            screen.refresh_from_state()
-
-    # -------------------------------------------------------------------------
-    # file watching (polling) + subtitle indicator
-    # -------------------------------------------------------------------------
-
-    def _fmt_mtime(self, mtime_ns: int) -> str:
-        dt = datetime.fromtimestamp(mtime_ns / 1e9, tz=timezone.utc)
-        return dt.strftime("%Y-%m-%d %H:%M:%S UTC")
-
-    def _set_last_updated_indicator(self, sig: tuple[int, int] | None) -> None:
-        base = "AI-powered spec synthesis, verification & analysis"
-        if not self.watch_state_file or not self.state_path or sig is None:
-            self.sub_title = base
-            return
-        mtime_ns, _ = sig
-        self.sub_title = f"{base} • state updated {self._fmt_mtime(mtime_ns)}"
-
-    def _set_update_indicator_pending(self, sig: tuple[int, int]) -> None:
-        base = "AI-powered spec synthesis, verification & analysis"
-        mtime_ns, _ = sig
-        self.sub_title = f"{base} • update available ({self._fmt_mtime(mtime_ns)})"
-
-    def _get_state_file_signature(self) -> tuple[int, int] | None:
-        if not self.state_path:
-            return None
-        try:
-            st = os.stat(self.state_path)
-            return (st.st_mtime_ns, st.st_size)
-        except FileNotFoundError:
-            return None
-
-    def _poll_state_file(self) -> None:
-        if not self.watch_state_file or not self.state_path:
-            return
-
-        sig = self._get_state_file_signature()
-        if sig is None:
-            return
-
-        if self._state_sig is None:
-            self._state_sig = sig
-            self._set_last_updated_indicator(sig)
-            return
-
-        if sig == self._state_sig:
-            return
-
-        # file changed: mark pending update (manual)
-        self._pending_state_sig = sig
-        self._update_available = True
-        self._set_update_indicator_pending(sig)
-
-        # update footer status if MainScreen is visible
-        screen: Screen[Any] = self.screen
-        if isinstance(screen, MainScreen):
-            mtime_ns, _ = sig
-            screen.set_status(
-                f"[yellow]Update available[/yellow] — press [bold]u[/bold] to reload ({self._fmt_mtime(mtime_ns)})"
-            )
-
-        # one-time popup hint
-        if not self._notified_update_available:
-            self._notified_update_available = True
-            self.notify("Update available — press 'u' to reload.", timeout=2.0)
-
-    # -------------------------------------------------------------------------
-    # manual update action
-    # -------------------------------------------------------------------------
-
-    def action_update_state(self) -> None:
-        if not self._update_available or not self.state_path or not self._pending_state_sig:
-            self.notify("No update available.", timeout=1.0)
-            return
-
-        # Debounce: avoid repeated clicks in quick succession
-        now = time.time()
-        if now - self._last_reload_ts < 0.25:
-            return
-
-        try:
-            data = self.state_path.read_text(encoding="utf-8", errors="replace")
-            new_state = State.model_validate_json(data)  # type: ignore[attr-defined]
-        except Exception:
-            self.notify(
-                "Failed to load updated state (file may be mid-write).",
-                severity="warning",
-                timeout=1.5,
-            )
-            return
-
-        self._last_reload_ts = now
-
-        # accept update
-        self._state_sig = self._pending_state_sig
-        self._pending_state_sig = None
-        self._update_available = False
-
-        # update subtitle back to last-updated
-        self._set_last_updated_indicator(self._state_sig)
-
-        # apply + refresh UI
-        self._apply_new_state(new_state)
-
-        # allow the popup again next time a new update arrives
-        self._notified_update_available = False
-
-        # clear footer status if on main
-        screen: Screen[Any] = self.screen
-        if isinstance(screen, MainScreen):
-            screen.clear_status()
-
-        self.notify("State updated.", timeout=1.2)

speclogician/tui/app.tcss

@@ -1,160 +0,0 @@
-/* Root screen should have real height */
-Screen {
-    height: 100%;
-}
-
-#status_line {
-    dock: bottom;
-    height: auto;
-    padding: 0 1;
-    color: $text-muted;
-    background: $panel;
-}
-
-/* -------------------------------
-   Top toolbar (Update button)
--------------------------------- */
-
-#top_toolbar {
-    height: auto;
-    width: 100%;
-    padding: 0 1;
-    margin-bottom: 1;
-    align: left middle;
-}
-
-#update_badge {
-    padding-left: 1;
-    color: $text-muted;
-}
-
-/* -------------------------------
-   Body layout
--------------------------------- */
-
-#body {
-    width: 100%;
-    height: 100%;
-    layout: vertical;
-}
-
-#instances_split {
-    width: 100%;
-    height: 1fr;
-    layout: horizontal;
-}
-
-/* -------------------------------
-   Left: instances panel
--------------------------------- */
-
-#instances_panel {
-    width: 80;   /* adjust as needed */
-    height: 1fr;
-    overflow: hidden;      /* key: prevents visual spill */
-}
-
-#instances_list {
-    width: 100%;
-    height: 1fr;
-    border: solid gray round;
-    overflow: hidden;      /* also key */
-}
-
-/* -------------------------------
-   Instance list rows + badges
--------------------------------- */
-
-.inst_row {
-    width: 100%;
-    height: auto;
-}
-
-.inst_when {
-    width: 1fr;
-    padding: 0 1;
-}
-
-.inst_badges {
-    width: auto;
-    height: auto;
-    align: right middle;
-}
-
-/* badge “pill” look */
-.inst_badge {
-    padding: 0 1;
-    margin-left: 1;
-    text-style: bold;
-    /* If your Textual version supports it, these make it look nice.
-       If any of these error, remove them. */
-    border: round $panel;
-    background: $panel;
-    color: $text-muted;
-}
-
-/* severity colors (foreground) */
-.inst_badge--error {
-    color: $error;
-}
-
-.inst_badge--warning {
-    color: $warning;
-}
-
-.inst_badge--ok {
-    color: $success;
-}
-
-.inst_badge--info {
-    color: $accent;
-}
-
-.inst_badge--muted {
-    color: $text-muted;
-}
-
-/* -------------------------------
-   Right: tabbed content
--------------------------------- */
-
-TabbedContent {
-    width: 1fr;
-    height: 1fr;
-}
-
-TabPane {
-    width: 1fr;
-    height: 1fr;
-}
-
-/* -------------------------------
-   RichLog content
--------------------------------- */
-
-RichLog {
-    width: 100%;
-    height: 1fr;
-}
-
-/* -------------------------------
-   Full IML panel
--------------------------------- */
-
-#full_iml_panel {
-    width: 1fr;
-    height: 1fr;
-    layout: vertical;
-}
-
-#full_iml_toolbar {
-    height: auto;
-    width: 100%;
-    padding: 0 1;
-    align: left middle;
-}
-
-#full_iml_model {
-    width: 100%;
-    height: 1fr;
-}

speclogician/tui/demo.py

@@ -1,45 +0,0 @@
-#
-#   Imandra Inc.
-#
-#   speclogician/tui/demo.py
-#
-
-from __future__ import annotations
-
-from typing import Any
-from textual.screen import Screen
-from textual.app import ComposeResult
-from textual.widgets import Header, Footer, RichLog
-
-from rich.markdown import Markdown
-from rich.panel import Panel
-
-
-class DemoScreen(Screen[Any]):
-    """Shows demo collateral (artifact markdown) before entering the main TUI."""
-
-    CSS = """
-    #mdlog { height: 1fr; width: 100%; }
-    """
-
-    def __init__(self, markdown_text: str, *, title: str = "Demo artifacts") -> None:
-        super().__init__()
-        self._md_text = markdown_text
-        self._title = title
-
-    def compose(self) -> ComposeResult:
-        yield Header()
-        self.mdlog = RichLog(id="mdlog", wrap=True, highlight=True, markup=False, auto_scroll=False)
-        yield self.mdlog
-        yield Footer()
-
-    def on_mount(self) -> None:
-        # Render markdown inside a panel and write it as a single renderable.
-        self.mdlog.clear()
-        self.mdlog.write(
-            Panel(
-                Markdown(self._md_text or "_(empty)_"),
-                title=f"[bold]{self._title}[/bold]",
-                border_style="magenta",
-            )
-        )