feat: add silo-aware start panel

Add a SiloStartPanel dock widget that shows connection status, local
checkouts, recent silo activity, and local recent files. Automatically
shown when the Silo workbench is activated.

Sections:
- Connection status badge (green/gray dot with hostname)
- My Checkouts: scans local projects dir for .FCStd files, shows part
  number and description, double-click to open
- Recent Silo Activity: fetches from server, badges items present
  locally, double-click to open or checkout
- Local Recent Files: reads FreeCAD MRU list, double-click to open

Auto-refreshes every 60 seconds. Panel is reused if already open.

Closes #5

freecad/InitGui.py

@@ -35,19 +35,9 @@ class SiloWorkbench(FreeCADGui.Workbench):
         except Exception as e:
             FreeCAD.Console.PrintWarning(f"Could not register Silo origin: {e}\n")
 
-        self.toolbar_commands = [
-            "Silo_ToggleMode",
-            "Separator",
-            "Silo_Open",
-            "Silo_New",
-            "Silo_Save",
-            "Silo_Commit",
-            "Silo_Pull",
-            "Silo_Push",
-        ]
-
-        # Menu has management/admin commands (file commands are in File menu
-        # via the Create module's SiloMenuManipulator)
+        # Silo menu provides admin/management commands.
+        # File operations (New/Open/Save) are handled by the standard File
+        # toolbar via the origin system -- no separate Silo toolbar needed.
         self.menu_commands = [
             "Silo_Info",
             "Silo_BOM",
@@ -57,15 +47,15 @@ class SiloWorkbench(FreeCADGui.Workbench):
             "Separator",
             "Silo_Settings",
             "Silo_Auth",
+            "Silo_StartPanel",
         ]
 
-        self.appendToolbar("Silo", self.toolbar_commands)
         self.appendMenu("Silo", self.menu_commands)
 
     def Activated(self):
         """Called when workbench is activated."""
         FreeCAD.Console.PrintMessage("Kindred Silo workbench activated\n")
-        self._show_shortcut_recommendations()
+        FreeCADGui.runCommand("Silo_StartPanel", 0)
 
     def Deactivated(self):
         pass
@@ -73,41 +63,6 @@ class SiloWorkbench(FreeCADGui.Workbench):
     def GetClassName(self):
         return "Gui::PythonWorkbench"
 
-    def _show_shortcut_recommendations(self):
-        """Show keyboard shortcut recommendations dialog on first activation."""
-        try:
-            param_group = FreeCAD.ParamGet(
-                "User parameter:BaseApp/Preferences/Mod/KindredSilo"
-            )
-            if param_group.GetBool("ShortcutsShown", False):
-                return
-            param_group.SetBool("ShortcutsShown", True)
-
-            from PySide import QtGui
-
-            msg = """<h3>Welcome to Kindred Silo!</h3>
-<p>For the best experience, set up these keyboard shortcuts:</p>
-<table style="margin: 10px 0;">
-<tr><td><b>Ctrl+O</b></td><td> - </td><td>Silo_Open (Search & Open)</td></tr>
-<tr><td><b>Ctrl+N</b></td><td> - </td><td>Silo_New (Register new item)</td></tr>
-<tr><td><b>Ctrl+S</b></td><td> - </td><td>Silo_Save (Save & upload)</td></tr>
-<tr><td><b>Ctrl+Shift+S</b></td><td> - </td><td>Silo_Commit (Save with comment)</td></tr>
-</table>
-<p><b>To set shortcuts:</b> Tools > Customize > Keyboard</p>
-<p style="color: #888;">This message appears once.</p>"""
-
-            dialog = QtGui.QMessageBox()
-            dialog.setWindowTitle("Silo Keyboard Shortcuts")
-            dialog.setTextFormat(QtGui.Qt.RichText)
-            dialog.setText(msg)
-            dialog.setIcon(QtGui.QMessageBox.Information)
-            dialog.addButton("Set Up Now", QtGui.QMessageBox.AcceptRole)
-            dialog.addButton("Later", QtGui.QMessageBox.RejectRole)
-            if dialog.exec_() == 0:
-                FreeCADGui.runCommand("Std_DlgCustomize", 0)
-        except Exception as e:
-            FreeCAD.Console.PrintWarning("Silo shortcuts dialog: " + str(e) + "\n")
-
 
 FreeCADGui.addWorkbench(SiloWorkbench())
 FreeCAD.Console.PrintMessage("Silo workbench registered\n")

freecad/silo_commands.py

@@ -147,6 +147,39 @@ def _clear_auth():
     _fc_settings.clear_auth()
 
 
+# ---------------------------------------------------------------------------
+# Server mode tracking
+# ---------------------------------------------------------------------------
+
+_server_mode = "offline"  # "normal" | "read-only" | "degraded" | "offline"
+
+
+def _fetch_server_mode() -> str:
+    """Fetch server mode from the /ready endpoint.
+
+    Returns one of: "normal", "read-only", "degraded", "offline".
+    """
+    api_url = _get_api_url().rstrip("/")
+    base_url = api_url[:-4] if api_url.endswith("/api") else api_url
+    url = f"{base_url}/ready"
+    try:
+        req = urllib.request.Request(url, method="GET")
+        resp = urllib.request.urlopen(req, context=_get_ssl_context(), timeout=10)
+        body = resp.read(4096).decode("utf-8", errors="replace")
+        data = json.loads(body)
+        status = data.get("status", "")
+        if status in ("ok", "ready"):
+            return "normal"
+        if status in ("read-only", "read_only", "readonly"):
+            return "read-only"
+        if status in ("degraded",):
+            return "degraded"
+        # Unknown status but server responded — treat as normal
+        return "normal"
+    except Exception:
+        return "offline"
+
+
 # ---------------------------------------------------------------------------
 # Icon helper
 # ---------------------------------------------------------------------------
@@ -817,7 +850,7 @@ class Silo_New:
             QtGui.QMessageBox.critical(None, "Error", str(e))
 
     def IsActive(self):
-        return True
+        return _server_mode == "normal"
 
 
 class Silo_Save:
@@ -895,7 +928,7 @@ class Silo_Save:
             FreeCAD.Console.PrintMessage("File saved locally but not uploaded.\n")
 
     def IsActive(self):
-        return FreeCAD.ActiveDocument is not None
+        return FreeCAD.ActiveDocument is not None and _server_mode == "normal"
 
 
 class Silo_Commit:
@@ -948,7 +981,7 @@ class Silo_Commit:
             FreeCAD.Console.PrintError(f"Commit failed: {e}\n")
 
     def IsActive(self):
-        return FreeCAD.ActiveDocument is not None
+        return FreeCAD.ActiveDocument is not None and _server_mode == "normal"
 
 
 def _check_pull_conflicts(part_number, local_path, doc=None):
@@ -1320,7 +1353,7 @@ class Silo_Push:
         QtGui.QMessageBox.information(None, "Push", f"Uploaded {uploaded} files.")
 
     def IsActive(self):
-        return True
+        return _server_mode == "normal"
 
 
 class Silo_Info:
@@ -2316,85 +2349,6 @@ class Silo_BOM:
         return FreeCAD.ActiveDocument is not None
 
 
-# ---------------------------------------------------------------------------
-# Silo Mode toggle - swap Ctrl+O/S/N between standard and Silo commands
-# ---------------------------------------------------------------------------
-
-# Stored original shortcuts so they can be restored on toggle-off
-_original_shortcuts: Dict[str, Any] = {}
-
-
-def _swap_shortcuts(mapping, enable_silo):
-    """Swap keyboard shortcuts between standard and Silo commands.
-
-    mapping: list of (std_cmd, silo_cmd, shortcut) tuples
-    enable_silo: True to assign shortcuts to Silo commands, False to restore.
-    """
-    from PySide import QtGui
-
-    mw = FreeCADGui.getMainWindow()
-    if mw is None:
-        return
-
-    for std_cmd, silo_cmd, shortcut in mapping:
-        if enable_silo:
-            # Save and clear the standard command's shortcut
-            std_action = mw.findChild(QtGui.QAction, std_cmd)
-            if std_action:
-                _original_shortcuts[std_cmd] = std_action.shortcut().toString()
-                std_action.setShortcut("")
-            # Assign the shortcut to the Silo command
-            silo_action = mw.findChild(QtGui.QAction, silo_cmd)
-            if silo_action:
-                silo_action.setShortcut(shortcut)
-        else:
-            # Clear the Silo command's shortcut
-            silo_action = mw.findChild(QtGui.QAction, silo_cmd)
-            if silo_action:
-                silo_action.setShortcut("")
-            # Restore the standard command's original shortcut
-            std_action = mw.findChild(QtGui.QAction, std_cmd)
-            if std_action and std_cmd in _original_shortcuts:
-                std_action.setShortcut(_original_shortcuts.pop(std_cmd))
-
-
-_SHORTCUT_MAP = [
-    ("Std_Open", "Silo_Open", "Ctrl+O"),
-    ("Std_Save", "Silo_Save", "Ctrl+S"),
-    ("Std_New", "Silo_New", "Ctrl+N"),
-]
-
-
-class Silo_ToggleMode:
-    """Toggle between standard file operations and Silo equivalents."""
-
-    def GetResources(self):
-        return {
-            "MenuText": "Silo Mode",
-            "ToolTip": (
-                "Toggle between standard file operations and Silo equivalents.\n"
-                "When ON: Ctrl+O/S/N use Silo Open/Save/New.\n"
-                "When OFF: Standard FreeCAD file operations."
-            ),
-            "Pixmap": _icon("silo"),
-            "Checkable": True,
-        }
-
-    def Activated(self, checked):
-        param = FreeCAD.ParamGet(_PREF_GROUP)
-        if checked:
-            _swap_shortcuts(_SHORTCUT_MAP, enable_silo=True)
-            param.SetBool("SiloMode", True)
-            FreeCAD.Console.PrintMessage("Silo mode enabled\n")
-        else:
-            _swap_shortcuts(_SHORTCUT_MAP, enable_silo=False)
-            param.SetBool("SiloMode", False)
-            FreeCAD.Console.PrintMessage("Silo mode disabled\n")
-
-    def IsActive(self):
-        return True
-
-
 # ---------------------------------------------------------------------------
 # SSE live-update listener
 # ---------------------------------------------------------------------------
@@ -2413,6 +2367,7 @@ class SiloEventListener(QtCore.QThread):
     connection_status = QtCore.Signal(
         str
     )  # "connected" / "disconnected" / "unsupported"
+    server_mode_changed = QtCore.Signal(str)  # "normal" / "read-only" / "degraded"
 
     _MAX_FAST_RETRIES = 3
     _FAST_RETRY_SECS = 5
@@ -2513,6 +2468,12 @@ class SiloEventListener(QtCore.QThread):
         except (json.JSONDecodeError, ValueError):
             return
 
+        if event_type == "server.state":
+            mode = payload.get("mode", "")
+            if mode:
+                self.server_mode_changed.emit(mode)
+            return
+
         pn = payload.get("part_number", "")
         if not pn:
             return
@@ -2620,6 +2581,13 @@ class SiloAuthDockWidget:
         sse_row.addStretch()
         layout.addLayout(sse_row)
 
+        # Server mode banner (hidden when normal)
+        self._mode_banner = QtGui.QLabel("")
+        self._mode_banner.setWordWrap(True)
+        self._mode_banner.setContentsMargins(6, 4, 6, 4)
+        self._mode_banner.setVisible(False)
+        layout.addWidget(self._mode_banner)
+
         layout.addSpacing(4)
 
         # Buttons
@@ -2709,6 +2677,14 @@ class SiloAuthDockWidget:
             self._login_btn.setText("Login")
             self._login_btn.clicked.connect(self._on_login_clicked)
 
+        # Fetch and display server mode
+        global _server_mode
+        if reachable:
+            _server_mode = _fetch_server_mode()
+        else:
+            _server_mode = "offline"
+        self._update_mode_banner()
+
         # Manage SSE listener based on auth state
         self._sync_event_listener(authed)
 
@@ -2722,6 +2698,7 @@ class SiloAuthDockWidget:
                 self._event_listener.item_updated.connect(self._on_remote_change)
                 self._event_listener.revision_created.connect(self._on_remote_revision)
                 self._event_listener.connection_status.connect(self._on_sse_status)
+                self._event_listener.server_mode_changed.connect(self._on_server_mode)
                 self._event_listener.start()
         else:
             if self._event_listener is not None and self._event_listener.isRunning():
@@ -2739,6 +2716,35 @@ class SiloAuthDockWidget:
             self._sse_label.setText("Not available")
             self._sse_label.setStyleSheet("font-size: 11px; color: #888;")
 
+    def _on_server_mode(self, mode):
+        global _server_mode
+        _server_mode = mode
+        self._update_mode_banner()
+
+    def _update_mode_banner(self):
+        _MODE_BANNERS = {
+            "normal": ("", "", False),
+            "read-only": (
+                "Server is in read-only mode",
+                "background: #FFC107; color: #000; padding: 4px; font-size: 11px;",
+                True,
+            ),
+            "degraded": (
+                "MinIO unavailable \u2014 file ops limited",
+                "background: #FF9800; color: #000; padding: 4px; font-size: 11px;",
+                True,
+            ),
+            "offline": (
+                "Disconnected from silo",
+                "background: #F44336; color: #fff; padding: 4px; font-size: 11px;",
+                True,
+            ),
+        }
+        text, style, visible = _MODE_BANNERS.get(_server_mode, _MODE_BANNERS["offline"])
+        self._mode_banner.setText(text)
+        self._mode_banner.setStyleSheet(style)
+        self._mode_banner.setVisible(visible)
+
     def _on_remote_change(self, part_number):
         FreeCAD.Console.PrintMessage(f"Silo: Part {part_number} updated on server\n")
         mw = FreeCADGui.getMainWindow()
@@ -2934,6 +2940,257 @@ class Silo_Auth:
         return True
 
 
+# ---------------------------------------------------------------------------
+# Start panel
+# ---------------------------------------------------------------------------
+
+
+class SiloStartPanel:
+    """Content widget for the Silo Start Panel dock."""
+
+    def __init__(self):
+        from PySide import QtCore, QtGui
+
+        self.widget = QtGui.QWidget()
+        self._build_ui()
+        self._refresh()
+
+        self._timer = QtCore.QTimer(self.widget)
+        self._timer.timeout.connect(self._refresh)
+        self._timer.start(60000)  # Refresh every 60 seconds
+
+    def _build_ui(self):
+        from PySide import QtCore, QtGui
+
+        layout = QtGui.QVBoxLayout(self.widget)
+        layout.setContentsMargins(8, 8, 8, 8)
+        layout.setSpacing(6)
+
+        # Connection status badge
+        status_row = QtGui.QHBoxLayout()
+        status_row.setSpacing(6)
+        self._conn_dot = QtGui.QLabel("\u2b24")
+        self._conn_dot.setFixedWidth(16)
+        self._conn_dot.setAlignment(QtCore.Qt.AlignCenter)
+        self._conn_label = QtGui.QLabel("Checking...")
+        self._conn_label.setStyleSheet("font-weight: bold;")
+        status_row.addWidget(self._conn_dot)
+        status_row.addWidget(self._conn_label)
+        status_row.addStretch()
+        layout.addLayout(status_row)
+
+        layout.addSpacing(8)
+
+        # My Checkouts section
+        checkout_header = QtGui.QLabel("My Checkouts")
+        checkout_header.setStyleSheet("font-weight: bold; font-size: 12px;")
+        layout.addWidget(checkout_header)
+
+        self._checkout_list = QtGui.QListWidget()
+        self._checkout_list.setMaximumHeight(160)
+        self._checkout_list.setAlternatingRowColors(True)
+        self._checkout_list.itemDoubleClicked.connect(self._on_checkout_clicked)
+        layout.addWidget(self._checkout_list)
+
+        layout.addSpacing(8)
+
+        # Recent Silo Activity section
+        activity_header = QtGui.QLabel("Recent Silo Activity")
+        activity_header.setStyleSheet("font-weight: bold; font-size: 12px;")
+        layout.addWidget(activity_header)
+
+        self._activity_list = QtGui.QListWidget()
+        self._activity_list.setMaximumHeight(200)
+        self._activity_list.setAlternatingRowColors(True)
+        self._activity_list.itemDoubleClicked.connect(self._on_activity_clicked)
+        layout.addWidget(self._activity_list)
+
+        layout.addSpacing(8)
+
+        # Local Recent Files section
+        local_header = QtGui.QLabel("Local Recent Files")
+        local_header.setStyleSheet("font-weight: bold; font-size: 12px;")
+        layout.addWidget(local_header)
+
+        self._local_list = QtGui.QListWidget()
+        self._local_list.setMaximumHeight(160)
+        self._local_list.setAlternatingRowColors(True)
+        self._local_list.itemDoubleClicked.connect(self._on_local_clicked)
+        layout.addWidget(self._local_list)
+
+        layout.addStretch()
+
+    def _refresh(self):
+        self._refresh_connection()
+        self._refresh_checkouts()
+        self._refresh_activity()
+        self._refresh_local()
+
+    def _refresh_connection(self):
+        try:
+            reachable, _ = _client.check_connection()
+        except Exception:
+            reachable = False
+
+        if reachable:
+            api_url = _get_api_url()
+            parsed = urllib.parse.urlparse(api_url)
+            hostname = parsed.hostname or api_url
+            self._conn_dot.setStyleSheet("color: #4CAF50; font-size: 10px;")
+            self._conn_label.setText(f"Connected to {hostname}")
+        else:
+            self._conn_dot.setStyleSheet("color: #888; font-size: 10px;")
+            self._conn_label.setText("Disconnected")
+
+    def _refresh_checkouts(self):
+        self._checkout_list.clear()
+        try:
+            local_files = search_local_files()
+            for item in local_files[:15]:
+                pn = item.get("part_number", "")
+                desc = item.get("description", "")
+                modified = (item.get("modified") or "")[:10]
+                label = f"{pn}  {desc}"
+                if modified:
+                    label += f"  ({modified})"
+                list_item = self._checkout_list.addItem(label)
+        except Exception:
+            self._checkout_list.addItem("(Unable to scan local files)")
+
+        if self._checkout_list.count() == 0:
+            self._checkout_list.addItem("(No local checkouts)")
+
+    def _refresh_activity(self):
+        self._activity_list.clear()
+        try:
+            reachable, _ = _client.check_connection()
+        except Exception:
+            reachable = False
+
+        if not reachable:
+            self._activity_list.addItem("(Not connected)")
+            return
+
+        try:
+            items = _client.list_items()
+            if isinstance(items, list):
+                # Collect local part numbers for badge comparison
+                local_pns = set()
+                try:
+                    for lf in search_local_files():
+                        local_pns.add(lf.get("part_number", ""))
+                except Exception:
+                    pass
+
+                for item in items[:10]:
+                    pn = item.get("part_number", "")
+                    desc = item.get("description", "")
+                    updated = (item.get("updated_at") or "")[:10]
+                    badge = "\u2713 " if pn in local_pns else ""
+                    label = f"{badge}{pn}  {desc}"
+                    if updated:
+                        label += f"  ({updated})"
+                    self._activity_list.addItem(label)
+
+            if self._activity_list.count() == 0:
+                self._activity_list.addItem("(No items in database)")
+        except Exception:
+            self._activity_list.addItem("(Unable to fetch activity)")
+
+    def _refresh_local(self):
+        from PySide import QtGui
+
+        self._local_list.clear()
+        try:
+            param = FreeCAD.ParamGet("User parameter:BaseApp/RecentFiles")
+            count = param.GetInt("RecentFiles", 0)
+            for i in range(min(count, 10)):
+                path = param.GetString(f"MRU{i}", "")
+                if path:
+                    name = Path(path).name
+                    item = QtGui.QListWidgetItem(name)
+                    item.setToolTip(path)
+                    item.setData(256, path)  # Qt.UserRole = 256
+                    self._local_list.addItem(item)
+        except Exception:
+            pass
+
+        if self._local_list.count() == 0:
+            self._local_list.addItem("(No recent files)")
+
+    def _on_checkout_clicked(self, item):
+        """Open a local checkout file."""
+        text = item.text()
+        if text.startswith("("):
+            return
+        pn = text.split()[0] if text else ""
+        if not pn:
+            return
+        local_path = find_file_by_part_number(pn)
+        if local_path and local_path.exists():
+            FreeCAD.openDocument(str(local_path))
+
+    def _on_activity_clicked(self, item):
+        """Open/checkout a remote item."""
+        text = item.text()
+        if text.startswith("("):
+            return
+        # Strip badge if present
+        text = text.lstrip("\u2713 ")
+        pn = text.split()[0] if text else ""
+        if not pn:
+            return
+        local_path = find_file_by_part_number(pn)
+        if local_path and local_path.exists():
+            FreeCAD.openDocument(str(local_path))
+        else:
+            _sync.open_item(pn)
+
+    def _on_local_clicked(self, item):
+        """Open a local recent file."""
+        path = item.data(256)  # Qt.UserRole
+        if path and Path(path).exists():
+            FreeCAD.openDocument(path)
+
+
+class Silo_StartPanel:
+    """Show the Silo Start Panel."""
+
+    def GetResources(self):
+        return {
+            "MenuText": "Start Panel",
+            "ToolTip": "Show Silo start panel with checkouts and recent activity",
+            "Pixmap": _icon("open"),
+        }
+
+    def Activated(self):
+        from PySide import QtCore, QtGui
+
+        mw = FreeCADGui.getMainWindow()
+        if mw is None:
+            return
+
+        # Reuse existing panel if it exists
+        panel = mw.findChild(QtGui.QDockWidget, "SiloStartPanel")
+        if panel:
+            panel.show()
+            panel.raise_()
+            return
+
+        # Create new dock widget
+        content = SiloStartPanel()
+        dock = QtGui.QDockWidget("Silo", mw)
+        dock.setObjectName("SiloStartPanel")
+        dock.setWidget(content.widget)
+        dock.setAllowedAreas(
+            QtCore.Qt.LeftDockWidgetArea | QtCore.Qt.RightDockWidgetArea
+        )
+        mw.addDockWidget(QtCore.Qt.LeftDockWidgetArea, dock)
+
+    def IsActive(self):
+        return True
+
+
 # Register commands
 FreeCADGui.addCommand("Silo_Open", Silo_Open())
 FreeCADGui.addCommand("Silo_New", Silo_New())
@@ -2947,5 +3204,6 @@ FreeCADGui.addCommand("Silo_TagProjects", Silo_TagProjects())
 FreeCADGui.addCommand("Silo_Rollback", Silo_Rollback())
 FreeCADGui.addCommand("Silo_SetStatus", Silo_SetStatus())
 FreeCADGui.addCommand("Silo_Settings", Silo_Settings())
-FreeCADGui.addCommand("Silo_ToggleMode", Silo_ToggleMode())
+
 FreeCADGui.addCommand("Silo_Auth", Silo_Auth())
+FreeCADGui.addCommand("Silo_StartPanel", Silo_StartPanel())

freecad/silo_origin.py

@@ -11,8 +11,7 @@ providing the standardized origin interface.
 
 import FreeCAD
 import FreeCADGui
-
-from .silo_commands import (
+from silo_commands import (
     _client,
     _sync,
     collect_document_properties,