Merge branch 'main' into feat/native-start-panel-167

Replace QWebEngineView-based start page with a rich native Qt panel that
fetches items directly from the Silo REST API. QWebEngineView is not
available on conda-forge for Qt6.

Start panel features:
- Database Items list with search (from SiloClient.list_items)
- Recent Files list from FreeCAD preferences
- Real-time Activity Feed via SSE (SiloEventListener)
- Context menu: Open in Create, Open in Browser, Copy Part Number
- Open in Browser button (QDesktopServices)
- Catppuccin Mocha dark theme styling

URL scheme support:
- handle_kindred_url() function for kindred://item/{part_number} URLs
- Startup hook in InitGui.py for cold-start URL arguments

Closes #167

freecad/InitGui.py

@@ -48,6 +48,7 @@ class SiloWorkbench(FreeCADGui.Workbench):
             "Silo_Settings",
             "Silo_Auth",
             "Silo_StartPanel",
+            "Silo_Diag",
         ]
 
         self.appendMenu("Silo", self.menu_commands)
@@ -66,3 +67,31 @@ class SiloWorkbench(FreeCADGui.Workbench):
 
 FreeCADGui.addWorkbench(SiloWorkbench())
 FreeCAD.Console.PrintMessage("Silo workbench registered\n")
+
+# Override the Start page with Silo-aware version (must happen before
+# the C++ StartLauncher fires at ~100ms after GUI init)
+try:
+    import silo_start
+
+    silo_start.register()
+except Exception as e:
+    FreeCAD.Console.PrintWarning(f"Silo Start page override failed: {e}\n")
+
+
+# Handle kindred:// URLs passed as command-line arguments on cold start.
+# Delayed to run after the GUI is fully initialised and the Silo addon has
+# loaded its client/sync objects.
+def _handle_startup_urls():
+    """Process any kindred:// URLs passed as command-line arguments."""
+    import sys
+
+    from silo_commands import handle_kindred_url
+
+    for arg in sys.argv[1:]:
+        if arg.startswith("kindred://"):
+            handle_kindred_url(arg)
+
+
+from PySide import QtCore
+
+QtCore.QTimer.singleShot(500, _handle_startup_urls)

freecad/resources/icons/silo-rollback.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#cba6f7" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- Counter-clockwise arrow -->
+  <polyline points="1 4 1 10 7 10" stroke="#f38ba8"/>
+  <path d="M3.51 15a9 9 0 1 0 2.13-9.36L1 10" stroke="#cba6f7"/>
+  <!-- Clock hands -->
+  <line x1="12" y1="7" x2="12" y2="12" stroke="#89dceb" stroke-width="1.5"/>
+  <line x1="12" y1="12" x2="15" y2="14" stroke="#89dceb" stroke-width="1.5"/>
+</svg>

freecad/resources/icons/silo-status.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#cba6f7" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- Shield shape -->
+  <path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z" fill="#313244"/>
+  <!-- Status bars -->
+  <line x1="8" y1="10" x2="16" y2="10" stroke="#a6e3a1" stroke-width="1.5"/>
+  <line x1="8" y1="14" x2="13" y2="14" stroke="#89dceb" stroke-width="1.5"/>
+</svg>

freecad/resources/icons/silo-tag.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#cba6f7" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- Tag shape -->
+  <path d="M20.59 13.41l-7.17 7.17a2 2 0 0 1-2.83 0L2 12V2h10l8.59 8.59a2 2 0 0 1 0 2.82z" fill="#313244"/>
+  <!-- Tag hole -->
+  <circle cx="7" cy="7" r="1.5" fill="#cba6f7" stroke="none"/>
+</svg>

freecad/silo_commands.py

@@ -3,6 +3,7 @@
 import json
 import os
 import re
+import socket
 import urllib.error
 import urllib.parse
 import urllib.request
@@ -25,9 +26,7 @@ from silo_client import (
 _PREF_GROUP = "User parameter:BaseApp/Preferences/Mod/KindredSilo"
 
 # Configuration - preferences take priority over env vars
-SILO_PROJECTS_DIR = os.environ.get(
-    "SILO_PROJECTS_DIR", os.path.expanduser("~/projects")
-)
+SILO_PROJECTS_DIR = os.environ.get("SILO_PROJECTS_DIR", os.path.expanduser("~/projects"))
 
 
 # ---------------------------------------------------------------------------
@@ -65,9 +64,7 @@ class FreeCADSiloSettings(SiloSettings):
         param = FreeCAD.ParamGet(_PREF_GROUP)
         return param.GetString("SslCertPath", "")
 
-    def save_auth(
-        self, username: str, role: str = "", source: str = "", token: str = ""
-    ):
+    def save_auth(self, username: str, role: str = "", source: str = "", token: str = ""):
         param = FreeCAD.ParamGet(_PREF_GROUP)
         param.SetString("AuthUsername", username)
         param.SetString("AuthRole", role)
@@ -125,9 +122,7 @@ def _get_ssl_verify() -> bool:
 def _get_ssl_context():
     from silo_client._ssl import build_ssl_context
 
-    return build_ssl_context(
-        _fc_settings.get_ssl_verify(), _fc_settings.get_ssl_cert_path()
-    )
+    return build_ssl_context(_fc_settings.get_ssl_verify(), _fc_settings.get_ssl_cert_path())
 
 
 def _get_auth_headers() -> Dict[str, str]:
@@ -184,9 +179,7 @@ def _fetch_server_mode() -> str:
 # Icon helper
 # ---------------------------------------------------------------------------
 
-_ICON_DIR = os.path.join(
-    os.path.dirname(os.path.abspath(__file__)), "resources", "icons"
-)
+_ICON_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "resources", "icons")
 
 
 def _icon(name):
@@ -556,6 +549,35 @@ class SiloSync:
 _sync = SiloSync()
 
 
+# ---------------------------------------------------------------------------
+# kindred:// URL handler
+# ---------------------------------------------------------------------------
+
+
+def handle_kindred_url(url: str):
+    """Handle a ``kindred://`` URL by opening the referenced item.
+
+    URL format::
+
+        kindred://item/{part_number}
+        kindred://item/{part_number}/revision/{rev_number}
+
+    Called from C++ ``MainWindow::processMessages()`` when a ``kindred://``
+    URL arrives via IPC, or from ``InitGui.py`` for cold-start URL arguments.
+    """
+    from urllib.parse import urlparse
+
+    parsed = urlparse(url)
+    if parsed.scheme != "kindred":
+        return
+    # urlparse treats "kindred://item/PN-001" as netloc="item", path="/PN-001"
+    parts = [parsed.netloc] + [p for p in parsed.path.split("/") if p]
+    if len(parts) >= 2 and parts[0] == "item":
+        part_number = parts[1]
+        FreeCAD.Console.PrintMessage(f"Silo: Opening item {part_number} from kindred:// URL\n")
+        _sync.open_item(part_number)
+
+
 # ============================================================================
 # COMMANDS
 # ============================================================================
@@ -641,11 +663,7 @@ class Silo_Open:
                 try:
                     for item in search_local_files(search_term):
                         existing = next(
-                            (
-                                r
-                                for r in results_data
-                                if r["part_number"] == item["part_number"]
-                            ),
+                            (r for r in results_data if r["part_number"] == item["part_number"]),
                             None,
                         )
                         if existing:
@@ -669,12 +687,8 @@ class Silo_Open:
 
             results_table.setRowCount(len(results_data))
             for row, data in enumerate(results_data):
-                results_table.setItem(
-                    row, 0, QtGui.QTableWidgetItem(data["part_number"])
-                )
-                results_table.setItem(
-                    row, 1, QtGui.QTableWidgetItem(data["description"])
-                )
+                results_table.setItem(row, 0, QtGui.QTableWidgetItem(data["part_number"]))
+                results_table.setItem(row, 1, QtGui.QTableWidgetItem(data["description"]))
                 results_table.setItem(row, 2, QtGui.QTableWidgetItem(data["item_type"]))
                 results_table.setItem(row, 3, QtGui.QTableWidgetItem(data["source"]))
                 results_table.setItem(row, 4, QtGui.QTableWidgetItem(data["modified"]))
@@ -740,13 +754,9 @@ class Silo_New:
         try:
             schema = _client.get_schema()
             categories = schema.get("segments", [])
-            cat_segment = next(
-                (s for s in categories if s.get("name") == "category"), None
-            )
+            cat_segment = next((s for s in categories if s.get("name") == "category"), None)
             if cat_segment and cat_segment.get("values"):
-                cat_list = [
-                    f"{k} - {v}" for k, v in sorted(cat_segment["values"].items())
-                ]
+                cat_list = [f"{k} - {v}" for k, v in sorted(cat_segment["values"].items())]
                 category_str, ok = QtGui.QInputDialog.getItem(
                     None, "New Item", "Category:", cat_list, 0, False
                 )
@@ -754,15 +764,11 @@ class Silo_New:
                     return
                 category = category_str.split(" - ")[0]
             else:
-                category, ok = QtGui.QInputDialog.getText(
-                    None, "New Item", "Category code:"
-                )
+                category, ok = QtGui.QInputDialog.getText(None, "New Item", "Category code:")
                 if not ok:
                     return
         except Exception:
-            category, ok = QtGui.QInputDialog.getText(
-                None, "New Item", "Category code:"
-            )
+            category, ok = QtGui.QInputDialog.getText(None, "New Item", "Category code:")
             if not ok:
                 return
 
@@ -807,9 +813,7 @@ class Silo_New:
                     ok_btn.clicked.connect(dialog.accept)
 
                     if dialog.exec_() == QtGui.QDialog.Accepted:
-                        selected_projects = [
-                            item.text() for item in list_widget.selectedItems()
-                        ]
+                        selected_projects = [item.text() for item in list_widget.selectedItems()]
         except Exception as e:
             FreeCAD.Console.PrintWarning(f"Could not fetch projects: {e}\n")
 
@@ -916,9 +920,7 @@ class Silo_Save:
 
         # Try to upload to MinIO
         try:
-            result = _client._upload_file(
-                part_number, str(file_path), properties, "Auto-save"
-            )
+            result = _client._upload_file(part_number, str(file_path), properties, "Auto-save")
 
             new_rev = result["revision_number"]
             FreeCAD.Console.PrintMessage(f"Uploaded as revision {new_rev}\n")
@@ -951,9 +953,7 @@ class Silo_Commit:
 
         obj = get_tracked_object(doc)
         if not obj:
-            FreeCAD.Console.PrintError(
-                "No tracked object. Use 'New' to register first.\n"
-            )
+            FreeCAD.Console.PrintError("No tracked object. Use 'New' to register first.\n")
             return
 
         part_number = obj.SiloPartNumber
@@ -970,9 +970,7 @@ class Silo_Commit:
             if not file_path:
                 return
 
-            result = _client._upload_file(
-                part_number, str(file_path), properties, comment
-            )
+            result = _client._upload_file(part_number, str(file_path), properties, comment)
 
             new_rev = result["revision_number"]
             FreeCAD.Console.PrintMessage(f"Committed revision {new_rev}: {comment}\n")
@@ -1019,9 +1017,7 @@ def _check_pull_conflicts(part_number, local_path, doc=None):
             server_updated = item.get("updated_at", "")
             if server_updated:
                 # Parse ISO format timestamp
-                server_dt = datetime.datetime.fromisoformat(
-                    server_updated.replace("Z", "+00:00")
-                )
+                server_dt = datetime.datetime.fromisoformat(server_updated.replace("Z", "+00:00"))
                 if server_dt > local_mtime:
                     conflicts.append("Server version is newer than local file.")
         except Exception:
@@ -1051,9 +1047,7 @@ class SiloPullDialog:
         # Revision table
         self._table = QtGui.QTableWidget()
         self._table.setColumnCount(5)
-        self._table.setHorizontalHeaderLabels(
-            ["Rev", "Date", "Comment", "Status", "File"]
-        )
+        self._table.setHorizontalHeaderLabels(["Rev", "Date", "Comment", "Status", "File"])
         self._table.setSelectionBehavior(QtGui.QAbstractItemView.SelectRows)
         self._table.setSelectionMode(QtGui.QAbstractItemView.SingleSelection)
         self._table.setEditTriggers(QtGui.QAbstractItemView.NoEditTriggers)
@@ -1167,18 +1161,14 @@ class Silo_Pull:
 
         if not has_any_file:
             if existing_local:
-                FreeCAD.Console.PrintMessage(
-                    f"Opening existing local file: {existing_local}\n"
-                )
+                FreeCAD.Console.PrintMessage(f"Opening existing local file: {existing_local}\n")
                 FreeCAD.openDocument(str(existing_local))
             else:
                 try:
                     item = _client.get_item(part_number)
                     new_doc = _sync.create_document_for_item(item, save=True)
                     if new_doc:
-                        FreeCAD.Console.PrintMessage(
-                            f"Created local file for {part_number}\n"
-                        )
+                        FreeCAD.Console.PrintMessage(f"Created local file for {part_number}\n")
                     else:
                         QtGui.QMessageBox.warning(
                             None,
@@ -1309,9 +1299,7 @@ class Silo_Push:
                             server_dt = datetime.fromisoformat(
                                 server_time_str.replace("Z", "+00:00")
                             )
-                            local_dt = datetime.fromtimestamp(
-                                local_mtime, tz=timezone.utc
-                            )
+                            local_dt = datetime.fromtimestamp(local_mtime, tz=timezone.utc)
                             if local_dt > server_dt:
                                 unuploaded.append(lf)
                         else:
@@ -1324,9 +1312,7 @@ class Silo_Push:
                 pass  # Not in DB, skip
 
         if not unuploaded:
-            QtGui.QMessageBox.information(
-                None, "Push", "All local files are already uploaded."
-            )
+            QtGui.QMessageBox.information(None, "Push", "All local files are already uploaded.")
             return
 
         msg = f"Found {len(unuploaded)} files to upload:\n\n"
@@ -1344,9 +1330,7 @@ class Silo_Push:
 
         uploaded = 0
         for item in unuploaded:
-            result = _sync.upload_file(
-                item["part_number"], item["path"], "Synced from local"
-            )
+            result = _sync.upload_file(item["part_number"], item["path"], "Synced from local")
             if result:
                 uploaded += 1
 
@@ -1395,7 +1379,9 @@ class Silo_Info:
             msg = f"<h3>{part_number}</h3>"
             msg += f"<p><b>Type:</b> {item.get('item_type', '-')}</p>"
             msg += f"<p><b>Description:</b> {item.get('description', '-')}</p>"
-            msg += f"<p><b>Projects:</b> {', '.join(project_codes) if project_codes else 'None'}</p>"
+            msg += (
+                f"<p><b>Projects:</b> {', '.join(project_codes) if project_codes else 'None'}</p>"
+            )
             msg += f"<p><b>Current Revision:</b> {item.get('current_revision', 1)}</p>"
             msg += f"<p><b>Local Revision:</b> {getattr(obj, 'SiloRevision', '-')}</p>"
 
@@ -1461,9 +1447,7 @@ class Silo_TagProjects:
         try:
             # Get current projects for item
             current_projects = _client.get_item_projects(part_number)
-            current_codes = {
-                p.get("code", "") for p in current_projects if p.get("code")
-            }
+            current_codes = {p.get("code", "") for p in current_projects if p.get("code")}
 
             # Get all available projects
             all_projects = _client.get_projects()
@@ -1574,9 +1558,7 @@ class Silo_Rollback:
             dialog.setMinimumHeight(300)
             layout = QtGui.QVBoxLayout(dialog)
 
-            label = QtGui.QLabel(
-                f"Select a revision to rollback to (current: Rev {current_rev}):"
-            )
+            label = QtGui.QLabel(f"Select a revision to rollback to (current: Rev {current_rev}):")
             layout.addWidget(label)
 
             # Revision table
@@ -1591,12 +1573,8 @@ class Silo_Rollback:
             for i, rev in enumerate(prev_revisions):
                 table.setItem(i, 0, QtGui.QTableWidgetItem(str(rev["revision_number"])))
                 table.setItem(i, 1, QtGui.QTableWidgetItem(rev.get("status", "draft")))
-                table.setItem(
-                    i, 2, QtGui.QTableWidgetItem(rev.get("created_at", "")[:10])
-                )
-                table.setItem(
-                    i, 3, QtGui.QTableWidgetItem(rev.get("comment", "") or "")
-                )
+                table.setItem(i, 2, QtGui.QTableWidgetItem(rev.get("created_at", "")[:10]))
+                table.setItem(i, 3, QtGui.QTableWidgetItem(rev.get("comment", "") or ""))
 
             table.resizeColumnsToContents()
             layout.addWidget(table)
@@ -1622,9 +1600,7 @@ class Silo_Rollback:
             def on_rollback():
                 selected = table.selectedItems()
                 if not selected:
-                    QtGui.QMessageBox.warning(
-                        dialog, "Rollback", "Please select a revision"
-                    )
+                    QtGui.QMessageBox.warning(dialog, "Rollback", "Please select a revision")
                     return
                 selected_rev[0] = int(table.item(selected[0].row(), 0).text())
                 dialog.accept()
@@ -1722,9 +1698,7 @@ class Silo_SetStatus:
             # Update status
             _client.update_revision(part_number, rev_num, status=status)
 
-            FreeCAD.Console.PrintMessage(
-                f"Updated Rev {rev_num} status to '{status}'\n"
-            )
+            FreeCAD.Console.PrintMessage(f"Updated Rev {rev_num} status to '{status}'\n")
             QtGui.QMessageBox.information(
                 None, "Status Updated", f"Revision {rev_num} status set to '{status}'"
             )
@@ -1788,9 +1762,7 @@ class Silo_Settings:
         ssl_checkbox.setChecked(param.GetBool("SslVerify", True))
         layout.addWidget(ssl_checkbox)
 
-        ssl_hint = QtGui.QLabel(
-            "Disable only for internal servers with self-signed certificates."
-        )
+        ssl_hint = QtGui.QLabel("Disable only for internal servers with self-signed certificates.")
         ssl_hint.setWordWrap(True)
         ssl_hint.setStyleSheet("color: #888; font-size: 11px;")
         layout.addWidget(ssl_hint)
@@ -1997,15 +1969,18 @@ class Silo_BOM:
 
         obj = get_tracked_object(doc)
         if not obj:
-            FreeCAD.Console.PrintError("No tracked Silo item in active document.\n")
-            from PySide import QtGui as _qg
-
-            _qg.QMessageBox.warning(
+            reply = QtGui.QMessageBox.question(
                 None,
                 "BOM",
-                "This document is not registered with Silo.\nUse Silo > New to register it first.",
+                "This document is not registered with Silo.\n\nRegister it now?",
+                QtGui.QMessageBox.Yes | QtGui.QMessageBox.No,
             )
-            return
+            if reply != QtGui.QMessageBox.Yes:
+                return
+            FreeCADGui.runCommand("Silo_New")
+            obj = get_tracked_object(doc)
+            if not obj:
+                return
 
         part_number = obj.SiloPartNumber
 
@@ -2064,9 +2039,7 @@ class Silo_BOM:
 
         wu_table = QtGui.QTableWidget()
         wu_table.setColumnCount(5)
-        wu_table.setHorizontalHeaderLabels(
-            ["Parent Part Number", "Type", "Qty", "Unit", "Ref Des"]
-        )
+        wu_table.setHorizontalHeaderLabels(["Parent Part Number", "Type", "Qty", "Unit", "Ref Des"])
         wu_table.setSelectionBehavior(QtGui.QAbstractItemView.SelectRows)
         wu_table.setSelectionMode(QtGui.QAbstractItemView.SingleSelection)
         wu_table.setEditTriggers(QtGui.QAbstractItemView.NoEditTriggers)
@@ -2095,16 +2068,12 @@ class Silo_BOM:
                 bom_table.setItem(
                     row, 1, QtGui.QTableWidgetItem(entry.get("child_description", ""))
                 )
-                bom_table.setItem(
-                    row, 2, QtGui.QTableWidgetItem(entry.get("rel_type", ""))
-                )
+                bom_table.setItem(row, 2, QtGui.QTableWidgetItem(entry.get("rel_type", "")))
                 qty = entry.get("quantity")
                 bom_table.setItem(
                     row, 3, QtGui.QTableWidgetItem(str(qty) if qty is not None else "")
                 )
-                bom_table.setItem(
-                    row, 4, QtGui.QTableWidgetItem(entry.get("unit") or "")
-                )
+                bom_table.setItem(row, 4, QtGui.QTableWidgetItem(entry.get("unit") or ""))
                 ref_des = entry.get("reference_designators") or []
                 bom_table.setItem(row, 5, QtGui.QTableWidgetItem(", ".join(ref_des)))
                 bom_table.setItem(
@@ -2126,16 +2095,12 @@ class Silo_BOM:
                 wu_table.setItem(
                     row, 0, QtGui.QTableWidgetItem(entry.get("parent_part_number", ""))
                 )
-                wu_table.setItem(
-                    row, 1, QtGui.QTableWidgetItem(entry.get("rel_type", ""))
-                )
+                wu_table.setItem(row, 1, QtGui.QTableWidgetItem(entry.get("rel_type", "")))
                 qty = entry.get("quantity")
                 wu_table.setItem(
                     row, 2, QtGui.QTableWidgetItem(str(qty) if qty is not None else "")
                 )
-                wu_table.setItem(
-                    row, 3, QtGui.QTableWidgetItem(entry.get("unit") or "")
-                )
+                wu_table.setItem(row, 3, QtGui.QTableWidgetItem(entry.get("unit") or ""))
                 ref_des = entry.get("reference_designators") or []
                 wu_table.setItem(row, 4, QtGui.QTableWidgetItem(", ".join(ref_des)))
             wu_table.resizeColumnsToContents()
@@ -2188,9 +2153,7 @@ class Silo_BOM:
                 try:
                     qty = float(qty_text)
                 except ValueError:
-                    QtGui.QMessageBox.warning(
-                        dialog, "BOM", "Quantity must be a number."
-                    )
+                    QtGui.QMessageBox.warning(dialog, "BOM", "Quantity must be a number.")
                     return
 
             unit = unit_input.text().strip() or None
@@ -2269,9 +2232,7 @@ class Silo_BOM:
                 try:
                     new_qty = float(qty_text)
                 except ValueError:
-                    QtGui.QMessageBox.warning(
-                        dialog, "BOM", "Quantity must be a number."
-                    )
+                    QtGui.QMessageBox.warning(dialog, "BOM", "Quantity must be a number.")
                     return
 
             new_unit = unit_input.text().strip() or None
@@ -2295,9 +2256,7 @@ class Silo_BOM:
                 )
                 load_bom()
             except Exception as exc:
-                QtGui.QMessageBox.warning(
-                    dialog, "BOM", f"Failed to update entry:\n{exc}"
-                )
+                QtGui.QMessageBox.warning(dialog, "BOM", f"Failed to update entry:\n{exc}")
 
         def on_remove():
             selected = bom_table.selectedItems()
@@ -2323,9 +2282,7 @@ class Silo_BOM:
                 _client.delete_bom_entry(part_number, child_pn)
                 load_bom()
             except Exception as exc:
-                QtGui.QMessageBox.warning(
-                    dialog, "BOM", f"Failed to remove entry:\n{exc}"
-                )
+                QtGui.QMessageBox.warning(dialog, "BOM", f"Failed to remove entry:\n{exc}")
 
         add_btn.clicked.connect(on_add)
         edit_btn.clicked.connect(on_edit)
@@ -2364,14 +2321,12 @@ class SiloEventListener(QtCore.QThread):
 
     item_updated = QtCore.Signal(str)  # part_number
     revision_created = QtCore.Signal(str, int)  # part_number, revision
-    connection_status = QtCore.Signal(
-        str
-    )  # "connected" / "disconnected" / "unsupported"
+    connection_status = QtCore.Signal(str, int, str)  # (status, retry_count, error_message)
     server_mode_changed = QtCore.Signal(str)  # "normal" / "read-only" / "degraded"
 
-    _MAX_FAST_RETRIES = 3
-    _FAST_RETRY_SECS = 5
-    _SLOW_RETRY_SECS = 30
+    _MAX_RETRIES = 10
+    _BASE_DELAY = 1  # seconds, doubles each retry
+    _MAX_DELAY = 60  # seconds, backoff cap
 
     def __init__(self, parent=None):
         super().__init__(parent)
@@ -2394,6 +2349,7 @@ class SiloEventListener(QtCore.QThread):
 
     def run(self):
         retries = 0
+        last_error = ""
         while not self._stop_flag:
             try:
                 self._listen()
@@ -2401,21 +2357,24 @@ class SiloEventListener(QtCore.QThread):
                 if self._stop_flag:
                     return
                 retries += 1
+                last_error = "connection closed"
             except _SSEUnsupported:
-                self.connection_status.emit("unsupported")
+                self.connection_status.emit("unsupported", 0, "")
                 return
-            except Exception:
+            except Exception as exc:
                 retries += 1
+                last_error = str(exc) or "unknown error"
 
-            self.connection_status.emit("disconnected")
+            if retries > self._MAX_RETRIES:
+                self.connection_status.emit("gave_up", retries - 1, last_error)
+                return
 
-            if retries <= self._MAX_FAST_RETRIES:
-                delay = self._FAST_RETRY_SECS
-            else:
-                delay = self._SLOW_RETRY_SECS
+            self.connection_status.emit("disconnected", retries, last_error)
+
+            delay = min(self._BASE_DELAY * (2 ** (retries - 1)), self._MAX_DELAY)
 
             # Interruptible sleep
-            for _ in range(delay):
+            for _ in range(int(delay)):
                 if self._stop_flag:
                     return
                 self.msleep(1000)
@@ -2423,15 +2382,13 @@ class SiloEventListener(QtCore.QThread):
     # -- SSE stream reader --------------------------------------------------
 
     def _listen(self):
-        url = f"{_get_api_url().rstrip('/')}/api/events"
+        url = f"{_get_api_url().rstrip('/')}/events"
         headers = {"Accept": "text/event-stream"}
         headers.update(_get_auth_headers())
         req = urllib.request.Request(url, headers=headers, method="GET")
 
         try:
-            self._response = urllib.request.urlopen(
-                req, context=_get_ssl_context(), timeout=90
-            )
+            self._response = urllib.request.urlopen(req, context=_get_ssl_context(), timeout=90)
         except urllib.error.HTTPError as e:
             if e.code in (404, 501):
                 raise _SSEUnsupported()
@@ -2439,7 +2396,7 @@ class SiloEventListener(QtCore.QThread):
         except urllib.error.URLError:
             raise
 
-        self.connection_status.emit("connected")
+        self.connection_status.emit("connected", 0, "")
 
         event_type = ""
         data_buf = ""
@@ -2705,13 +2662,24 @@ class SiloAuthDockWidget:
                 self._event_listener.stop()
             self._sse_label.setText("")
 
-    def _on_sse_status(self, status):
+    def _on_sse_status(self, status, retry, error):
         if status == "connected":
             self._sse_label.setText("Listening")
             self._sse_label.setStyleSheet("font-size: 11px; color: #4CAF50;")
+            self._sse_label.setToolTip("")
+            FreeCAD.Console.PrintMessage("Silo: SSE connected\n")
         elif status == "disconnected":
-            self._sse_label.setText("Reconnecting...")
+            self._sse_label.setText(f"Reconnecting ({retry}/{SiloEventListener._MAX_RETRIES})...")
             self._sse_label.setStyleSheet("font-size: 11px; color: #FF9800;")
+            self._sse_label.setToolTip(error or "Connection lost")
+            FreeCAD.Console.PrintWarning(
+                f"Silo: SSE reconnecting ({retry}/{SiloEventListener._MAX_RETRIES}): {error}\n"
+            )
+        elif status == "gave_up":
+            self._sse_label.setText("Disconnected")
+            self._sse_label.setStyleSheet("font-size: 11px; color: #F44336;")
+            self._sse_label.setToolTip(error or "Max retries reached")
+            FreeCAD.Console.PrintError(f"Silo: SSE gave up after {retry} retries: {error}\n")
         elif status == "unsupported":
             self._sse_label.setText("Not available")
             self._sse_label.setStyleSheet("font-size: 11px; color: #888;")
@@ -2753,19 +2721,15 @@ class SiloAuthDockWidget:
         self._refresh_activity_panel()
 
     def _on_remote_revision(self, part_number, revision):
-        FreeCAD.Console.PrintMessage(
-            f"Silo: New revision {revision} for {part_number}\n"
-        )
+        FreeCAD.Console.PrintMessage(f"Silo: New revision {revision} for {part_number}\n")
         mw = FreeCADGui.getMainWindow()
         if mw is not None:
-            mw.statusBar().showMessage(
-                f"Silo: {part_number} rev {revision} available", 5000
-            )
+            mw.statusBar().showMessage(f"Silo: {part_number} rev {revision} available", 5000)
         self._refresh_activity_panel()
 
     def _refresh_activity_panel(self):
         """Refresh the Database Activity panel if it exists."""
-        from PySide import QtWidgets
+        from PySide import QtCore, QtGui, QtWidgets
 
         mw = FreeCADGui.getMainWindow()
         if mw is None:
@@ -2777,6 +2741,24 @@ class SiloAuthDockWidget:
         if activity_list is None:
             return
         activity_list.clear()
+
+        # Connect interaction signals (once)
+        if not getattr(activity_list, "_silo_connected", False):
+            activity_list.itemDoubleClicked.connect(self._on_activity_double_click)
+            activity_list.setContextMenuPolicy(QtCore.Qt.CustomContextMenu)
+            activity_list.customContextMenuRequested.connect(
+                lambda pos: self._on_activity_context_menu(activity_list, pos)
+            )
+            activity_list._silo_connected = True
+
+        # Collect local part numbers for badge
+        local_pns = set()
+        try:
+            for lf in search_local_files():
+                local_pns.add(lf.get("part_number", ""))
+        except Exception:
+            pass
+
         try:
             items = _client.list_items()
             if isinstance(items, list):
@@ -2786,12 +2768,94 @@ class SiloAuthDockWidget:
                     updated = item.get("updated_at", "")
                     if updated:
                         updated = updated[:10]
-                    activity_list.addItem(f"{pn} - {desc} - {updated}")
+
+                    # Fetch latest revision info
+                    rev_num = ""
+                    comment = ""
+                    try:
+                        revs = _client.get_revisions(pn)
+                        if revs:
+                            latest = revs[0] if isinstance(revs, list) else revs
+                            rev_num = str(latest.get("revision_number", ""))
+                            comment = latest.get("comment", "") or ""
+                    except Exception:
+                        pass
+
+                    # Truncate long descriptions
+                    desc_display = desc
+                    if len(desc_display) > 40:
+                        desc_display = desc_display[:37] + "..."
+
+                    # Build display text
+                    rev_part = f" \u2013 Rev {rev_num}" if rev_num else ""
+                    date_part = f" \u2013 {updated}" if updated else ""
+                    local_badge = " \u25cf local" if pn in local_pns else ""
+                    line1 = f"{pn} \u2013 {desc_display}{rev_part}{date_part}{local_badge}"
+
+                    if comment:
+                        line1 += f'\n  "{comment}"'
+                    else:
+                        line1 += "\n  (no comment)"
+
+                    list_item = QtWidgets.QListWidgetItem(line1)
+                    list_item.setData(QtCore.Qt.UserRole, pn)
+                    if desc and len(desc) > 40:
+                        list_item.setToolTip(desc)
+                    if pn in local_pns:
+                        list_item.setForeground(QtGui.QColor("#4CAF50"))
+                    activity_list.addItem(list_item)
+
             if activity_list.count() == 0:
                 activity_list.addItem("(No items in database)")
         except Exception:
             activity_list.addItem("(Unable to refresh activity)")
 
+    def _on_activity_double_click(self, item):
+        """Open/checkout item from activity pane."""
+        pn = item.data(256)  # Qt.UserRole
+        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_activity_context_menu(self, activity_list, pos):
+        """Show context menu for activity pane items."""
+        from PySide import QtCore, QtGui
+
+        item = activity_list.itemAt(pos)
+        if item is None:
+            return
+        pn = item.data(QtCore.Qt.UserRole)
+        if not pn:
+            return
+
+        menu = QtGui.QMenu()
+        open_action = menu.addAction("Open in Create")
+        browser_action = menu.addAction("Open in Browser")
+        copy_action = menu.addAction("Copy Part Number")
+        revisions_action = menu.addAction("View Revisions")
+
+        action = menu.exec_(activity_list.mapToGlobal(pos))
+        if action == open_action:
+            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)
+        elif action == browser_action:
+            import webbrowser
+
+            api_url = _get_api_url().rstrip("/")
+            base_url = api_url[:-4] if api_url.endswith("/api") else api_url
+            webbrowser.open(f"{base_url}/items/{pn}")
+        elif action == copy_action:
+            QtGui.QApplication.clipboard().setText(pn)
+        elif action == revisions_action:
+            FreeCADGui.runCommand("Silo_Info", 0)
+
     # -- Actions ------------------------------------------------------------
 
     def _on_login_clicked(self):
@@ -3182,15 +3246,144 @@ class Silo_StartPanel:
         dock = QtGui.QDockWidget("Silo", mw)
         dock.setObjectName("SiloStartPanel")
         dock.setWidget(content.widget)
-        dock.setAllowedAreas(
-            QtCore.Qt.LeftDockWidgetArea | QtCore.Qt.RightDockWidgetArea
-        )
+        dock.setAllowedAreas(QtCore.Qt.LeftDockWidgetArea | QtCore.Qt.RightDockWidgetArea)
         mw.addDockWidget(QtCore.Qt.LeftDockWidgetArea, dock)
 
     def IsActive(self):
         return True
 
 
+class _DiagWorker(QtCore.QThread):
+    """Background worker that runs connectivity diagnostics."""
+
+    result = QtCore.Signal(str, bool, str)  # (test_name, passed, detail)
+    finished_all = QtCore.Signal()
+    _HTTP_TIMEOUT = 10
+    _DNS_TIMEOUT = 5
+
+    def run(self):
+        api_url = _get_api_url()
+        base_url = api_url.rstrip("/")
+        if base_url.endswith("/api"):
+            base_url = base_url[:-4]
+        self._test_dns(base_url)
+        self._test_http("Health", f"{base_url}/health", auth=False)
+        self._test_http("Ready", f"{base_url}/ready", auth=False)
+        self._test_http("Auth", f"{api_url.rstrip('/')}/auth/me", auth=True)
+        self._test_sse(api_url)
+        self.finished_all.emit()
+
+    def _test_dns(self, base_url):
+        parsed = urllib.parse.urlparse(base_url)
+        hostname = parsed.hostname
+        if not hostname:
+            self.result.emit("DNS", False, "no hostname in URL")
+            return
+        try:
+            addrs = socket.getaddrinfo(hostname, None, socket.AF_UNSPEC, socket.SOCK_STREAM)
+            first_ip = addrs[0][4][0] if addrs else "?"
+            self.result.emit("DNS", True, f"{hostname} -> {first_ip}")
+        except socket.gaierror as e:
+            self.result.emit("DNS", False, f"{hostname}: {e}")
+        except Exception as e:
+            self.result.emit("DNS", False, str(e))
+
+    def _test_http(self, name, url, auth=False):
+        try:
+            headers = {}
+            if auth:
+                headers.update(_get_auth_headers())
+            req = urllib.request.Request(url, headers=headers, method="GET")
+            resp = urllib.request.urlopen(
+                req, context=_get_ssl_context(), timeout=self._HTTP_TIMEOUT
+            )
+            code = resp.getcode()
+            body = resp.read(4096).decode("utf-8", errors="replace").strip()
+            detail = f"HTTP {code}"
+            try:
+                data = json.loads(body)
+                if isinstance(data, dict):
+                    parts = []
+                    for key in ("status", "username", "role"):
+                        if key in data:
+                            parts.append(f"{key}={data[key]}")
+                    if parts:
+                        detail += f" ({', '.join(parts)})"
+            except (json.JSONDecodeError, ValueError):
+                if len(body) <= 80:
+                    detail += f" {body}"
+            self.result.emit(name, code < 400, detail)
+        except urllib.error.HTTPError as e:
+            self.result.emit(name, False, f"HTTP {e.code} {e.reason}")
+        except urllib.error.URLError as e:
+            self.result.emit(name, False, str(e.reason))
+        except Exception as e:
+            self.result.emit(name, False, str(e))
+
+    def _test_sse(self, api_url):
+        url = f"{api_url.rstrip('/')}/events"
+        try:
+            headers = {"Accept": "text/event-stream"}
+            headers.update(_get_auth_headers())
+            req = urllib.request.Request(url, headers=headers, method="GET")
+            resp = urllib.request.urlopen(
+                req, context=_get_ssl_context(), timeout=self._HTTP_TIMEOUT
+            )
+            content_type = resp.headers.get("Content-Type", "")
+            code = resp.getcode()
+            resp.close()
+            if "text/event-stream" in content_type:
+                self.result.emit("SSE", True, f"HTTP {code} event-stream")
+            else:
+                self.result.emit("SSE", True, f"HTTP {code} (type: {content_type})")
+        except urllib.error.HTTPError as e:
+            if e.code in (404, 501):
+                self.result.emit("SSE", False, f"HTTP {e.code} (not supported)")
+            else:
+                self.result.emit("SSE", False, f"HTTP {e.code} {e.reason}")
+        except urllib.error.URLError as e:
+            self.result.emit("SSE", False, str(e.reason))
+        except Exception as e:
+            self.result.emit("SSE", False, str(e))
+
+
+class Silo_Diag:
+    """Command to run connection diagnostics."""
+
+    _worker = None
+
+    def GetResources(self):
+        return {
+            "MenuText": "Diagnostics",
+            "ToolTip": "Test DNS, health, readiness, auth, and SSE connectivity",
+            "Pixmap": _icon("info"),
+        }
+
+    def Activated(self):
+        if self._worker is not None and self._worker.isRunning():
+            FreeCAD.Console.PrintWarning("Silo: diagnostics already running\n")
+            return
+        api_url = _get_api_url()
+        FreeCAD.Console.PrintMessage(f"--- Silo Diagnostics ({api_url}) ---\n")
+        self._worker = _DiagWorker()
+        self._worker.result.connect(self._on_result)
+        self._worker.finished_all.connect(self._on_finished)
+        self._worker.start()
+
+    def _on_result(self, name, passed, detail):
+        if passed:
+            FreeCAD.Console.PrintMessage(f"  PASS  {name}: {detail}\n")
+        else:
+            FreeCAD.Console.PrintError(f"  FAIL  {name}: {detail}\n")
+
+    def _on_finished(self):
+        FreeCAD.Console.PrintMessage("--- Diagnostics complete ---\n")
+        self._worker = None
+
+    def IsActive(self):
+        return True
+
+
 # Register commands
 FreeCADGui.addCommand("Silo_Open", Silo_Open())
 FreeCADGui.addCommand("Silo_New", Silo_New())
@@ -3207,3 +3400,4 @@ FreeCADGui.addCommand("Silo_Settings", Silo_Settings())
 
 FreeCADGui.addCommand("Silo_Auth", Silo_Auth())
 FreeCADGui.addCommand("Silo_StartPanel", Silo_StartPanel())
+FreeCADGui.addCommand("Silo_Diag", Silo_Diag())

freecad/silo_origin.py

@@ -299,9 +299,7 @@ class SiloOrigin:
             Created App.Document or None
         """
         try:
-            cmd = FreeCADGui.Command.get("Silo_New")
-            if cmd:
-                cmd.Activated()
+            FreeCADGui.runCommand("Silo_New")
             return FreeCAD.ActiveDocument
         except Exception as e:
             FreeCAD.Console.PrintError(f"Silo new document failed: {e}\n")
@@ -322,9 +320,7 @@ class SiloOrigin:
         if not identity:
             # No identity - show search dialog
             try:
-                cmd = FreeCADGui.Command.get("Silo_Open")
-                if cmd:
-                    cmd.Activated()
+                FreeCADGui.runCommand("Silo_Open")
                 return FreeCAD.ActiveDocument
             except Exception as e:
                 FreeCAD.Console.PrintError(f"Silo open failed: {e}\n")
@@ -354,9 +350,7 @@ class SiloOrigin:
             Opened App.Document or None
         """
         try:
-            cmd = FreeCADGui.Command.get("Silo_Open")
-            if cmd:
-                cmd.Activated()
+            FreeCADGui.runCommand("Silo_Open")
             return FreeCAD.ActiveDocument
         except Exception as e:
             FreeCAD.Console.PrintError(f"Silo open failed: {e}\n")
@@ -398,8 +392,10 @@ class SiloOrigin:
                 obj.SiloPartNumber, str(file_path), properties, comment=""
             )
 
-            # Clear modified flag
-            doc.Modified = False
+            # Clear modified flag (Modified is on Gui.Document, not App.Document)
+            gui_doc = FreeCADGui.getDocument(doc.Name)
+            if gui_doc:
+                gui_doc.Modified = False
 
             return True
         except Exception as e:
@@ -473,10 +469,8 @@ class SiloOrigin:
             True if command was executed
         """
         try:
-            cmd = FreeCADGui.Command.get("Silo_Commit")
-            if cmd:
-                cmd.Activated()
-                return True
+            FreeCADGui.runCommand("Silo_Commit")
+            return True
         except Exception as e:
             FreeCAD.Console.PrintError(f"Silo commit failed: {e}\n")
         return False
@@ -493,10 +487,8 @@ class SiloOrigin:
             True if command was executed
         """
         try:
-            cmd = FreeCADGui.Command.get("Silo_Pull")
-            if cmd:
-                cmd.Activated()
-                return True
+            FreeCADGui.runCommand("Silo_Pull")
+            return True
         except Exception as e:
             FreeCAD.Console.PrintError(f"Silo pull failed: {e}\n")
         return False
@@ -513,10 +505,8 @@ class SiloOrigin:
             True if command was executed
         """
         try:
-            cmd = FreeCADGui.Command.get("Silo_Push")
-            if cmd:
-                cmd.Activated()
-                return True
+            FreeCADGui.runCommand("Silo_Push")
+            return True
         except Exception as e:
             FreeCAD.Console.PrintError(f"Silo push failed: {e}\n")
         return False
@@ -530,9 +520,7 @@ class SiloOrigin:
             doc: FreeCAD App.Document
         """
         try:
-            cmd = FreeCADGui.Command.get("Silo_Info")
-            if cmd:
-                cmd.Activated()
+            FreeCADGui.runCommand("Silo_Info")
         except Exception as e:
             FreeCAD.Console.PrintError(f"Silo info failed: {e}\n")
 
@@ -545,9 +533,7 @@ class SiloOrigin:
             doc: FreeCAD App.Document
         """
         try:
-            cmd = FreeCADGui.Command.get("Silo_BOM")
-            if cmd:
-                cmd.Activated()
+            FreeCADGui.runCommand("Silo_BOM")
         except Exception as e:
             FreeCAD.Console.PrintError(f"Silo BOM failed: {e}\n")
 

freecad/silo_start.py

@@ -0,0 +1,667 @@
+"""Silo Start Page — native Qt start view for Kindred Create.
+
+Replaces the default Start page with a rich native panel that fetches data
+from the Silo REST API, shows real-time activity via SSE, and provides quick
+access to database items and recent local files.
+
+The command override is activated by calling ``register()`` at module level
+from InitGui.py, which overwrites the C++ ``Start_Start`` command.
+"""
+
+import os
+from datetime import datetime
+from pathlib import Path
+
+import FreeCAD
+import FreeCADGui
+from PySide import QtCore, QtGui, QtWidgets
+
+# ---------------------------------------------------------------------------
+# Catppuccin Mocha palette
+# ---------------------------------------------------------------------------
+_MOCHA = {
+    "base": "#1e1e2e",
+    "mantle": "#181825",
+    "crust": "#11111b",
+    "surface0": "#313244",
+    "surface1": "#45475a",
+    "surface2": "#585b70",
+    "text": "#cdd6f4",
+    "subtext0": "#a6adc8",
+    "subtext1": "#bac2de",
+    "blue": "#89b4fa",
+    "green": "#a6e3a1",
+    "red": "#f38ba8",
+    "peach": "#fab387",
+    "lavender": "#b4befe",
+    "overlay0": "#6c7086",
+}
+
+_PREF_GROUP = "User parameter:BaseApp/Preferences/Mod/KindredSilo"
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+
+def _get_silo_base_url() -> str:
+    """Return the Silo web UI root URL (without /api)."""
+    param = FreeCAD.ParamGet(_PREF_GROUP)
+    url = param.GetString("ApiUrl", "")
+    if not url:
+        url = os.environ.get("SILO_API_URL", "http://localhost:8080/api")
+    url = url.rstrip("/")
+    if url.endswith("/api"):
+        url = url[:-4]
+    return url
+
+
+def _get_recent_files() -> list:
+    """Read recent files from FreeCAD preferences."""
+    group = FreeCAD.ParamGet("User parameter:BaseApp/Preferences/RecentFiles")
+    count = group.GetInt("RecentFiles", 0)
+    files = []
+    for i in range(count):
+        path = group.GetString(f"MRU{i}", "")
+        if path and os.path.exists(path):
+            p = Path(path)
+            mtime = datetime.fromtimestamp(p.stat().st_mtime)
+            files.append({"path": str(p), "name": p.name, "modified": mtime})
+    return files
+
+
+def _relative_time(dt: datetime) -> str:
+    """Format a datetime as a human-friendly relative string."""
+    now = datetime.now()
+    diff = now - dt
+    seconds = int(diff.total_seconds())
+    if seconds < 60:
+        return "just now"
+    minutes = seconds // 60
+    if minutes < 60:
+        return f"{minutes}m ago"
+    hours = minutes // 60
+    if hours < 24:
+        return f"{hours}h ago"
+    days = hours // 24
+    if days < 30:
+        return f"{days}d ago"
+    return dt.strftime("%Y-%m-%d")
+
+
+# ---------------------------------------------------------------------------
+# Stylesheet
+# ---------------------------------------------------------------------------
+
+_STYLESHEET = f"""
+SiloStartView {{
+    background-color: {_MOCHA["base"]};
+}}
+
+/* --- Status banner --- */
+#SiloStatusBanner {{
+    background-color: {_MOCHA["surface0"]};
+    border-radius: 8px;
+}}
+#SiloStatusBanner QLabel {{
+    color: {_MOCHA["text"]};
+    font-size: 13px;
+}}
+#SiloStatusBanner QPushButton {{
+    background-color: {_MOCHA["blue"]};
+    color: {_MOCHA["crust"]};
+    border: none;
+    border-radius: 4px;
+    padding: 6px 12px;
+    font-weight: bold;
+    font-size: 12px;
+}}
+#SiloStatusBanner QPushButton:hover {{
+    background-color: {_MOCHA["lavender"]};
+}}
+
+/* --- Section headers --- */
+.SiloSectionHeader {{
+    color: {_MOCHA["text"]};
+    font-size: 14px;
+    font-weight: bold;
+}}
+
+/* --- Search field --- */
+#SiloSearchField {{
+    background-color: {_MOCHA["surface0"]};
+    border: 1px solid {_MOCHA["surface1"]};
+    border-radius: 4px;
+    padding: 6px 10px;
+    color: {_MOCHA["text"]};
+    font-size: 13px;
+}}
+#SiloSearchField:focus {{
+    border-color: {_MOCHA["blue"]};
+}}
+
+/* --- List widgets --- */
+.SiloList {{
+    background-color: {_MOCHA["mantle"]};
+    border: 1px solid {_MOCHA["surface0"]};
+    border-radius: 6px;
+    padding: 4px;
+}}
+.SiloList::item {{
+    padding: 8px 10px;
+    border-bottom: 1px solid {_MOCHA["surface0"]};
+    color: {_MOCHA["text"]};
+}}
+.SiloList::item:last {{
+    border-bottom: none;
+}}
+.SiloList::item:hover {{
+    background-color: {_MOCHA["surface0"]};
+}}
+.SiloList::item:selected {{
+    background-color: {_MOCHA["surface1"]};
+}}
+
+/* --- Activity feed --- */
+#SiloActivityFeed {{
+    background-color: {_MOCHA["mantle"]};
+    border: 1px solid {_MOCHA["surface0"]};
+    border-radius: 6px;
+    padding: 4px;
+}}
+#SiloActivityFeed::item {{
+    padding: 6px 10px;
+    border-bottom: 1px solid {_MOCHA["surface0"]};
+    color: {_MOCHA["subtext0"]};
+    font-size: 12px;
+}}
+#SiloActivityFeed::item:last {{
+    border-bottom: none;
+}}
+
+/* --- Footer checkbox --- */
+QCheckBox {{
+    color: {_MOCHA["subtext0"]};
+    font-size: 12px;
+}}
+QCheckBox::indicator {{
+    width: 14px;
+    height: 14px;
+}}
+"""
+
+
+# ---------------------------------------------------------------------------
+# Main start view
+# ---------------------------------------------------------------------------
+
+
+class SiloStartView(QtWidgets.QWidget):
+    """Native Qt start page with Silo database items, recent files, and
+    real-time activity feed."""
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self.setObjectName("SiloStartView")
+
+        self._silo_url = _get_silo_base_url()
+        self._connected = False
+        self._event_listener = None
+        self._activity_events = []  # list of (datetime, text) tuples
+        self._silo_imported = False
+        self._silo_cmds = None  # lazy ref to silo_commands module
+
+        self._build_ui()
+        self.setStyleSheet(_STYLESHEET)
+
+        # Debounce timer for search
+        self._search_timer = QtCore.QTimer(self)
+        self._search_timer.setSingleShot(True)
+        self._search_timer.setInterval(300)
+        self._search_timer.timeout.connect(self._refresh_items)
+
+        # Periodic refresh
+        self._poll_timer = QtCore.QTimer(self)
+        self._poll_timer.setInterval(30000)
+        self._poll_timer.timeout.connect(self._periodic_refresh)
+        self._poll_timer.start()
+
+        # Initial load after event loop starts
+        QtCore.QTimer.singleShot(100, self._initial_load)
+
+    # -- lazy import --------------------------------------------------------
+
+    def _silo(self):
+        """Lazy-import silo_commands to avoid circular import at module load."""
+        if not self._silo_imported:
+            try:
+                import silo_commands
+
+                self._silo_cmds = silo_commands
+            except Exception as e:
+                FreeCAD.Console.PrintWarning(f"Silo Start: cannot import silo_commands: {e}\n")
+                self._silo_cmds = None
+            self._silo_imported = True
+        return self._silo_cmds
+
+    # -- UI construction ----------------------------------------------------
+
+    def _build_ui(self):
+        root = QtWidgets.QVBoxLayout(self)
+        root.setContentsMargins(32, 24, 32, 16)
+        root.setSpacing(0)
+
+        # --- Status banner ---
+        banner = QtWidgets.QFrame()
+        banner.setObjectName("SiloStatusBanner")
+        banner_layout = QtWidgets.QHBoxLayout(banner)
+        banner_layout.setContentsMargins(16, 10, 16, 10)
+
+        self._status_icon = QtWidgets.QLabel()
+        self._status_icon.setFixedSize(12, 12)
+        banner_layout.addWidget(self._status_icon)
+
+        self._status_label = QtWidgets.QLabel("Checking Silo connection...")
+        self._status_label.setWordWrap(True)
+        banner_layout.addWidget(self._status_label, 1)
+
+        self._browser_btn = QtWidgets.QPushButton("Open in Browser")
+        self._browser_btn.setFixedWidth(130)
+        self._browser_btn.setCursor(QtCore.Qt.PointingHandCursor)
+        self._browser_btn.clicked.connect(self._open_in_browser)
+        banner_layout.addWidget(self._browser_btn)
+
+        self._retry_btn = QtWidgets.QPushButton("Retry")
+        self._retry_btn.setFixedWidth(70)
+        self._retry_btn.setCursor(QtCore.Qt.PointingHandCursor)
+        self._retry_btn.clicked.connect(self._initial_load)
+        self._retry_btn.hide()
+        banner_layout.addWidget(self._retry_btn)
+
+        root.addWidget(banner)
+        root.addSpacing(20)
+
+        # --- Main content: items (left) + recent files (right) ---
+        content_splitter = QtWidgets.QSplitter(QtCore.Qt.Horizontal)
+        content_splitter.setHandleWidth(12)
+        content_splitter.setStyleSheet(
+            f"QSplitter::handle {{ background-color: {_MOCHA['base']}; }}"
+        )
+
+        # Left: Database Items
+        left = QtWidgets.QWidget()
+        left_layout = QtWidgets.QVBoxLayout(left)
+        left_layout.setContentsMargins(0, 0, 0, 0)
+        left_layout.setSpacing(8)
+
+        items_header = QtWidgets.QLabel("Database Items")
+        items_header.setProperty("class", "SiloSectionHeader")
+        left_layout.addWidget(items_header)
+
+        self._search_field = QtWidgets.QLineEdit()
+        self._search_field.setObjectName("SiloSearchField")
+        self._search_field.setPlaceholderText("Search items...")
+        self._search_field.textChanged.connect(self._on_search_changed)
+        left_layout.addWidget(self._search_field)
+
+        self._items_list = QtWidgets.QListWidget()
+        self._items_list.setProperty("class", "SiloList")
+        self._items_list.setHorizontalScrollBarPolicy(QtCore.Qt.ScrollBarAlwaysOff)
+        self._items_list.itemDoubleClicked.connect(self._on_item_double_clicked)
+        self._items_list.setContextMenuPolicy(QtCore.Qt.CustomContextMenu)
+        self._items_list.customContextMenuRequested.connect(self._on_item_context_menu)
+        left_layout.addWidget(self._items_list, 1)
+
+        content_splitter.addWidget(left)
+
+        # Right: Recent Files
+        right = QtWidgets.QWidget()
+        right_layout = QtWidgets.QVBoxLayout(right)
+        right_layout.setContentsMargins(0, 0, 0, 0)
+        right_layout.setSpacing(8)
+
+        recent_header = QtWidgets.QLabel("Recent Files")
+        recent_header.setProperty("class", "SiloSectionHeader")
+        right_layout.addWidget(recent_header)
+
+        self._file_list = QtWidgets.QListWidget()
+        self._file_list.setProperty("class", "SiloList")
+        self._file_list.setHorizontalScrollBarPolicy(QtCore.Qt.ScrollBarAlwaysOff)
+        self._file_list.itemDoubleClicked.connect(self._on_file_clicked)
+        right_layout.addWidget(self._file_list, 1)
+
+        content_splitter.addWidget(right)
+        content_splitter.setStretchFactor(0, 3)
+        content_splitter.setStretchFactor(1, 2)
+
+        root.addWidget(content_splitter, 1)
+        root.addSpacing(12)
+
+        # --- Activity Feed (bottom) ---
+        activity_header = QtWidgets.QLabel("Activity")
+        activity_header.setProperty("class", "SiloSectionHeader")
+        root.addWidget(activity_header)
+        root.addSpacing(6)
+
+        self._activity_list = QtWidgets.QListWidget()
+        self._activity_list.setObjectName("SiloActivityFeed")
+        self._activity_list.setMaximumHeight(140)
+        self._activity_list.setHorizontalScrollBarPolicy(QtCore.Qt.ScrollBarAlwaysOff)
+        root.addWidget(self._activity_list)
+        root.addSpacing(12)
+
+        # --- Footer ---
+        footer = QtWidgets.QHBoxLayout()
+        footer.addStretch()
+        self._startup_cb = QtWidgets.QCheckBox("Don't show this page on startup")
+        start_prefs = FreeCAD.ParamGet("User parameter:BaseApp/Preferences/Mod/Start")
+        show = start_prefs.GetBool("ShowOnStartup", True)
+        self._startup_cb.setChecked(not show)
+        self._startup_cb.toggled.connect(self._on_startup_toggled)
+        footer.addWidget(self._startup_cb)
+        root.addLayout(footer)
+
+    # -- data loading -------------------------------------------------------
+
+    def _initial_load(self):
+        """First-time data load and SSE connection."""
+        self._refresh_status()
+        self._refresh_items()
+        self._refresh_recent_files()
+        self._start_sse()
+
+    def _periodic_refresh(self):
+        """Periodic refresh of items and connection status."""
+        self._refresh_status()
+        self._refresh_items()
+        self._refresh_recent_files()
+
+    def _refresh_status(self):
+        """Update the connection status banner."""
+        sc = self._silo()
+        if sc is None:
+            self._set_status(False, "Silo addon not available")
+            return
+
+        try:
+            reachable, _ = sc._client.check_connection()
+        except Exception:
+            reachable = False
+
+        self._silo_url = _get_silo_base_url()
+        if reachable:
+            self._set_status(True, f"Connected to {self._silo_url}")
+        else:
+            self._set_status(False, f"Cannot reach {self._silo_url}")
+
+    def _set_status(self, connected: bool, message: str):
+        self._connected = connected
+        if connected:
+            self._status_icon.setStyleSheet(
+                f"background-color: {_MOCHA['green']}; border-radius: 6px;"
+            )
+            self._retry_btn.hide()
+            self._browser_btn.show()
+        else:
+            self._status_icon.setStyleSheet(
+                f"background-color: {_MOCHA['red']}; border-radius: 6px;"
+            )
+            self._retry_btn.show()
+            self._browser_btn.hide()
+        self._status_label.setText(message)
+
+    def _refresh_items(self):
+        """Fetch items from Silo API and populate the items list."""
+        sc = self._silo()
+        if sc is None:
+            return
+
+        self._items_list.clear()
+        search = self._search_field.text().strip()
+
+        try:
+            if search:
+                items = sc._client.list_items(search=search)
+            else:
+                items = sc._client.list_items()
+        except Exception:
+            item = QtWidgets.QListWidgetItem("(Unable to fetch items)")
+            item.setFlags(QtCore.Qt.NoItemFlags)
+            self._items_list.addItem(item)
+            return
+
+        if not isinstance(items, list) or not items:
+            item = QtWidgets.QListWidgetItem("(No items found)")
+            item.setFlags(QtCore.Qt.NoItemFlags)
+            self._items_list.addItem(item)
+            return
+
+        # Collect local part numbers for badge
+        local_pns = set()
+        try:
+            for lf in sc.search_local_files():
+                local_pns.add(lf.get("part_number", ""))
+        except Exception:
+            pass
+
+        for entry in items[:30]:
+            pn = entry.get("part_number", "")
+            desc = entry.get("description", "")
+            rev = entry.get("current_revision", "")
+
+            desc_display = desc
+            if len(desc_display) > 50:
+                desc_display = desc_display[:47] + "..."
+
+            local_badge = "  [local]" if pn in local_pns else ""
+            rev_part = f"  Rev {rev}" if rev else ""
+            label = f"{pn} \u2014 {desc_display}{rev_part}{local_badge}"
+
+            list_item = QtWidgets.QListWidgetItem(label)
+            list_item.setData(QtCore.Qt.UserRole, pn)
+            if desc and len(desc) > 50:
+                list_item.setToolTip(desc)
+            if pn in local_pns:
+                list_item.setForeground(QtGui.QColor(_MOCHA["green"]))
+            self._items_list.addItem(list_item)
+
+    def _refresh_recent_files(self):
+        """Populate the recent files list."""
+        self._file_list.clear()
+        files = _get_recent_files()
+        if not files:
+            item = QtWidgets.QListWidgetItem("(No recent files)")
+            item.setFlags(QtCore.Qt.NoItemFlags)
+            self._file_list.addItem(item)
+            return
+        for f in files:
+            label = f"{f['name']}\n{_relative_time(f['modified'])}"
+            item = QtWidgets.QListWidgetItem(label)
+            item.setData(QtCore.Qt.UserRole, f["path"])
+            item.setToolTip(f["path"])
+            self._file_list.addItem(item)
+
+    # -- SSE ----------------------------------------------------------------
+
+    def _start_sse(self):
+        """Connect to SSE for live activity updates."""
+        sc = self._silo()
+        if sc is None:
+            return
+
+        if self._event_listener is not None:
+            return  # already running
+
+        try:
+            self._event_listener = sc.SiloEventListener()
+            self._event_listener.item_updated.connect(self._on_sse_item_updated)
+            self._event_listener.revision_created.connect(self._on_sse_revision_created)
+            self._event_listener.connection_status.connect(self._on_sse_status)
+            self._event_listener.start()
+        except Exception as e:
+            FreeCAD.Console.PrintLog(f"Silo Start: SSE listener failed to start: {e}\n")
+
+    def _stop_sse(self):
+        """Stop SSE listener when the view is destroyed."""
+        if self._event_listener is not None:
+            self._event_listener.stop()
+            self._event_listener = None
+
+    def _on_sse_item_updated(self, part_number: str):
+        self._add_activity_event(f"{part_number} updated")
+        self._refresh_items()
+
+    def _on_sse_revision_created(self, part_number: str, revision: int):
+        self._add_activity_event(f"{part_number} Rev {revision} created")
+        self._refresh_items()
+
+    def _on_sse_status(self, status: str, retry: int, error: str):
+        if status == "connected":
+            FreeCAD.Console.PrintLog("Silo Start: SSE connected\n")
+        elif status == "disconnected":
+            FreeCAD.Console.PrintLog(f"Silo Start: SSE disconnected (retry {retry}): {error}\n")
+
+    def _add_activity_event(self, text: str):
+        """Add an event to the activity feed."""
+        now = datetime.now()
+        self._activity_events.insert(0, (now, text))
+        self._activity_events = self._activity_events[:20]
+        self._rebuild_activity_feed()
+
+    def _rebuild_activity_feed(self):
+        """Rebuild the activity list widget from stored events."""
+        self._activity_list.clear()
+        if not self._activity_events:
+            item = QtWidgets.QListWidgetItem("(No recent activity)")
+            item.setFlags(QtCore.Qt.NoItemFlags)
+            self._activity_list.addItem(item)
+            return
+        for ts, text in self._activity_events:
+            label = f"{text}  \u00b7  {_relative_time(ts)}"
+            self._activity_list.addItem(label)
+
+    # -- interaction --------------------------------------------------------
+
+    def _on_search_changed(self, _text: str):
+        """Debounce search input."""
+        self._search_timer.start()
+
+    def _on_item_double_clicked(self, item: QtWidgets.QListWidgetItem):
+        pn = item.data(QtCore.Qt.UserRole)
+        if not pn:
+            return
+        sc = self._silo()
+        if sc is None:
+            return
+        local_path = sc.find_file_by_part_number(pn)
+        if local_path and local_path.exists():
+            FreeCAD.openDocument(str(local_path))
+        else:
+            sc._sync.open_item(pn)
+
+    def _on_item_context_menu(self, pos):
+        item = self._items_list.itemAt(pos)
+        if item is None:
+            return
+        pn = item.data(QtCore.Qt.UserRole)
+        if not pn:
+            return
+
+        menu = QtWidgets.QMenu()
+        open_action = menu.addAction("Open in Create")
+        browser_action = menu.addAction("Open in Browser")
+        copy_action = menu.addAction("Copy Part Number")
+
+        action = menu.exec_(self._items_list.mapToGlobal(pos))
+        sc = self._silo()
+        if action == open_action:
+            if sc:
+                local_path = sc.find_file_by_part_number(pn)
+                if local_path and local_path.exists():
+                    FreeCAD.openDocument(str(local_path))
+                else:
+                    sc._sync.open_item(pn)
+        elif action == browser_action:
+            url = f"{_get_silo_base_url()}/items/{pn}"
+            QtGui.QDesktopServices.openUrl(QtCore.QUrl(url))
+        elif action == copy_action:
+            QtWidgets.QApplication.clipboard().setText(pn)
+
+    def _on_file_clicked(self, item: QtWidgets.QListWidgetItem):
+        path = item.data(QtCore.Qt.UserRole)
+        if path:
+            try:
+                FreeCADGui.open(path)
+            except Exception as e:
+                FreeCAD.Console.PrintError(f"Silo Start: failed to open {path}: {e}\n")
+
+    def _open_in_browser(self):
+        """Open Silo web UI in the system browser."""
+        url = _get_silo_base_url()
+        QtGui.QDesktopServices.openUrl(QtCore.QUrl(url))
+
+    @staticmethod
+    def _on_startup_toggled(checked: bool):
+        prefs = FreeCAD.ParamGet("User parameter:BaseApp/Preferences/Mod/Start")
+        prefs.SetBool("ShowOnStartup", not checked)
+
+    # -- cleanup ------------------------------------------------------------
+
+    def closeEvent(self, event):
+        self._stop_sse()
+        self._poll_timer.stop()
+        super().closeEvent(event)
+
+
+# ---------------------------------------------------------------------------
+# Command override
+# ---------------------------------------------------------------------------
+
+
+class _SiloStartCommand:
+    """Replacement for the C++ Start_Start command."""
+
+    def Activated(self):
+        mw = FreeCADGui.getMainWindow()
+        mdi = mw.findChild(QtWidgets.QMdiArea)
+        if not mdi:
+            return
+
+        # Reuse existing view if open
+        for sw in mdi.subWindowList():
+            if sw.widget() and sw.widget().objectName() == "SiloStartView":
+                mdi.setActiveSubWindow(sw)
+                sw.show()
+                return
+
+        # Create new view as MDI subwindow
+        view = SiloStartView()
+        sw = mdi.addSubWindow(view)
+        sw.setWindowTitle("Start")
+        sw.setWindowIcon(QtGui.QIcon(":/icons/StartCommandIcon.svg"))
+        sw.show()
+        mdi.setActiveSubWindow(sw)
+
+    def GetResources(self):
+        return {
+            "MenuText": "&Start Page",
+            "ToolTip": "Displays the start page",
+            "Pixmap": "StartCommandIcon",
+        }
+
+    def IsActive(self):
+        return True
+
+
+def register():
+    """Override the Start_Start command with the Silo start page.
+
+    Call this from InitGui.py at module level so the override is in
+    place before the C++ StartLauncher fires (100ms after GUI init).
+    """
+    try:
+        FreeCADGui.addCommand("Start_Start", _SiloStartCommand())
+        FreeCAD.Console.PrintMessage("Silo Start: registered start page override\n")
+    except Exception as e:
+        FreeCAD.Console.PrintWarning(f"Silo Start: failed to register override: {e}\n")