docs: split REPOSITORY_STATE.md into topic files

Replace the monolithic REPOSITORY_STATE.md with four focused files: - OVERVIEW.md: metadata, submodule pins, doc index - ARCHITECTURE.md: bootstrap flow, source layout - COMPONENTS.md: ztools, Silo, Origin commands, theme, icons - KNOWN_ISSUES.md: bugs, incomplete features, next steps Updates reflected in the split: - Silo auth: corrected from 'not implemented' to 'local auth complete; LDAP/OIDC pending infrastructure' - CSRF: corrected from 'not implemented' to 'implemented (nosurf)' - Silo commands: 14 (was 13, added Silo_Auth) - New Origin commands section (5 C++ commands) - New icon infrastructure section with missing icon tracking - New issues: Newton-Raphson convergence fix (#12), Assembly restore crash fix (#13), missing Silo icons (#11) - Updated submodule pins (silo 27e112e, OndselSolver 5d1988b)
fix(gui): add silo-* icons to Qt resource file for origin commands
2026-02-06 10:43:34 -06:00 · 2026-02-05 22:00:35 -06:00 · 2026-02-05 20:48:28 -06:00 · 2026-02-05 19:13:45 -06:00 · 2026-02-05 18:38:19 -06:00
15 changed files with 334 additions and 228 deletions
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -0,0 +1,61 @@
+# Architecture
+
+## Bootstrap flow
+
+```
+FreeCAD startup
+  └─ src/Mod/Create/Init.py
+       └─ setup_kindred_addons()
+            ├─ exec(mods/ztools/ztools/Init.py)
+            └─ exec(mods/silo/pkg/freecad/Init.py)
+
+  └─ src/Mod/Create/InitGui.py
+       ├─ setup_kindred_workbenches()
+       │    ├─ exec(mods/ztools/ztools/InitGui.py)
+       │    │    ├─ registers ZToolsWorkbench
+       │    │    └─ installs _ZToolsPartDesignManipulator (global)
+       │    └─ exec(mods/silo/pkg/freecad/InitGui.py)
+       │         └─ registers SiloWorkbench
+       └─ Deferred setup (QTimer):
+            ├─ 1500ms: _setup_silo_auth_panel()    → "Database Auth" dock
+            ├─ 2000ms: _setup_silo_menu()           → SiloMenuManipulator
+            ├─ 3000ms: _check_silo_first_start()    → settings prompt
+            └─ 4000ms: _setup_silo_activity_panel() → "Database Activity" dock
+```
+
+## Key source layout
+
+```
+src/Mod/Create/              Kindred bootstrap module (Python)
+  ├── Init.py                Adds mods/ addon paths, loads Init.py files
+  └── InitGui.py             Loads workbenches, installs Silo manipulators
+
+src/Gui/FileOrigin.h/.cpp           FileOrigin base class + LocalFileOrigin
+src/Gui/CommandOrigin.cpp            Origin_Commit/Pull/Push/Info/BOM commands
+src/Gui/OriginManager.h/.cpp        Origin lifecycle management
+src/Gui/OriginSelectorWidget.h/.cpp  UI for origin selection
+
+mods/ztools/                 [submodule] ztools workbench
+  ├── ztools/InitGui.py      ZToolsWorkbench + PartDesign manipulator
+  ├── ztools/ztools/
+  │   ├── commands/          Datum, pattern, pocket, assembly, spreadsheet
+  │   ├── datums/core.py     Datum creation via Part::AttachExtension
+  │   └── resources/         Icons, theme utilities
+  └── CatppuccinMocha/       Theme preference pack (QSS)
+
+mods/silo/                   [submodule] Silo parts database
+  ├── cmd/                   Go server entry points
+  ├── internal/              Go API, database, auth, storage packages
+  ├── pkg/freecad/           FreeCAD workbench (Python)
+  │   ├── InitGui.py         SiloWorkbench
+  │   ├── silo_commands.py   Commands + SiloClient API
+  │   └── silo_origin.py     FileOrigin backend for Silo
+  ├── pkg/calc/              LibreOffice Calc extension (Python)
+  ├── deployments/           Docker compose configuration
+  └── migrations/            PostgreSQL schema migrations (001–010)
+
+src/Gui/Stylesheets/         QSS themes and SVG assets
+resources/preferences/       Canonical preference pack (KindredCreate)
+```
+
+See [INTEGRATION_PLAN.md](INTEGRATION_PLAN.md) for architecture layers and phase status.
--- a/docs/COMPONENTS.md
+++ b/docs/COMPONENTS.md
@@ -0,0 +1,110 @@
+# Components
+
+## ztools workbench
+
+**Registered commands (9):**
+
+| Command | Function |
+|---------|----------|
+| `ZTools_DatumCreator` | Create datum planes, axes, points (16 modes) |
+| `ZTools_DatumManager` | Manage existing datum objects |
+| `ZTools_EnhancedPocket` | Flip-side pocket (cut outside sketch profile) |
+| `ZTools_RotatedLinearPattern` | Linear pattern with incremental rotation |
+| `ZTools_AssemblyLinearPattern` | Pattern assembly components linearly |
+| `ZTools_AssemblyPolarPattern` | Pattern assembly components around axis |
+| `ZTools_SpreadsheetStyle{Bold,Italic,Underline}` | Text style toggles |
+| `ZTools_SpreadsheetAlign{Left,Center,Right}` | Cell alignment |
+| `ZTools_Spreadsheet{BgColor,TextColor,QuickAlias}` | Colors and alias creation |
+
+**PartDesign integration** via `_ZToolsPartDesignManipulator`:
+- `ZTools_DatumCreator`, `ZTools_DatumManager` → "Part Design Helper Features" toolbar
+- `ZTools_EnhancedPocket` → "Part Design Modeling Features" toolbar
+- `ZTools_RotatedLinearPattern` → "Part Design Transformation Features" toolbar
+- Same commands inserted into Part Design menu after `PartDesign_Boolean`
+
+**Datum types (7):** offset_from_face, offset_from_plane, midplane, 3_points, normal_to_edge, angled, tangent_to_cylinder. All except tangent_to_cylinder use `Part::AttachExtension` for automatic parametric updates.
+
+---
+
+## Origin commands (C++)
+
+The Origin abstraction (`src/Gui/FileOrigin.h`) provides a backend-agnostic interface for document storage. Commands delegate to the active `FileOrigin` implementation (currently `LocalFileOrigin` for local files, `SiloOrigin` via `mods/silo/pkg/freecad/silo_origin.py` for Silo-tracked documents).
+
+**Registered commands (5):**
+
+| Command | Function | Icon |
+|---------|----------|------|
+| `Origin_Commit` | Commit changes as a new revision | `silo-commit` |
+| `Origin_Pull` | Pull a specific revision from the origin | `silo-pull` |
+| `Origin_Push` | Push local changes to the origin | `silo-push` |
+| `Origin_Info` | Show document information from origin | `silo-info` |
+| `Origin_BOM` | Show Bill of Materials for this document | `silo-bom` |
+
+These appear in the File menu and "Origin Tools" toolbar across all workbenches (see `src/Gui/Workbench.cpp`).
+
+---
+
+## Silo workbench
+
+**Registered commands (14):**
+
+| Command | Function |
+|---------|----------|
+| `Silo_New` | Create new Silo-tracked document |
+| `Silo_Open` | Open file from Silo database |
+| `Silo_Save` | Save to Silo (create revision) |
+| `Silo_Commit` | Commit current revision |
+| `Silo_Pull` | Pull latest revision from server |
+| `Silo_Push` | Push local changes to server |
+| `Silo_Info` | View item metadata and history |
+| `Silo_BOM` | Bill of materials dialog (BOM + Where Used) |
+| `Silo_TagProjects` | Assign project tags |
+| `Silo_Rollback` | Rollback to previous revision |
+| `Silo_SetStatus` | Set revision status (draft/review/released/obsolete) |
+| `Silo_Settings` | Configure API URL, projects dir, SSL certificates |
+| `Silo_ToggleMode` | Swap Ctrl+O/S/N between FreeCAD and Silo commands |
+| `Silo_Auth` | Login/logout authentication panel |
+
+**Global integration** via `SiloMenuManipulator` in `src/Mod/Create/InitGui.py`:
+- File menu: Silo_New, Silo_Open, Silo_Save, Silo_Commit, Silo_Pull, Silo_Push, Silo_BOM
+- File toolbar: Silo_ToggleMode button
+
+**Server architecture:** Go REST API (38+ routes) + PostgreSQL + MinIO S3. Authentication via local (bcrypt), LDAP, or OIDC backends. See `mods/silo/docs/` for server documentation.
+
+**LibreOffice Calc extension** (`mods/silo/pkg/calc/`): BOM management, item creation, and AI-assisted descriptions via OpenRouter API. Shares the same Silo REST API and auth token system.
+
+---
+
+## Theme
+
+**Canonical source:** `resources/preferences/KindredCreate/KindredCreate.qss`
+
+Four copies must stay in sync:
+1. `resources/preferences/KindredCreate/KindredCreate.qss` (canonical)
+2. `src/Gui/Stylesheets/KindredCreate.qss`
+3. `src/Gui/PreferencePacks/KindredCreate/KindredCreate.qss`
+4. `mods/ztools/CatppuccinMocha/CatppuccinMocha.qss`
+
+---
+
+## Icon infrastructure
+
+### Qt resource icons (`src/Gui/Icons/`)
+
+5 `silo-*` SVGs registered in `resource.qrc`, used by C++ Origin commands:
+
+`silo-bom.svg`, `silo-commit.svg`, `silo-info.svg`, `silo-pull.svg`, `silo-push.svg`
+
+### Silo module icons (`mods/silo/pkg/freecad/resources/icons/`)
+
+10 SVGs loaded at runtime by the `_icon()` function in `silo_commands.py`:
+
+`silo-auth.svg`, `silo-bom.svg`, `silo-commit.svg`, `silo-info.svg`, `silo-new.svg`, `silo-open.svg`, `silo-pull.svg`, `silo-push.svg`, `silo-save.svg`, `silo.svg`
+
+### Missing icons
+
+3 command icon names have no corresponding SVG file: `silo-tag`, `silo-rollback`, `silo-status`. The `_icon()` function returns an empty string for these, so `Silo_TagProjects`, `Silo_Rollback`, and `Silo_SetStatus` render without toolbar icons.
+
+### Palette
+
+All silo-* icons use the Catppuccin Mocha color scheme. See `kindred-icons/README.md` for palette specification and icon design standards.
--- a/docs/KNOWN_ISSUES.md
+++ b/docs/KNOWN_ISSUES.md
@@ -0,0 +1,75 @@
+# Known Issues
+
+## Issues
+
+### Critical
+
+1. **QSS duplication.** Four copies of the stylesheet must be kept in sync manually. A build step or symlinks should eliminate this.
+
+2. **WorkbenchManipulator timing.** The `_ZToolsPartDesignManipulator` appends commands by name. If ZToolsWorkbench hasn't been activated when the user switches to PartDesign, the commands may not be registered. The manipulator API tolerates missing commands silently, but buttons won't appear.
+
+3. **Silo shortcut persistence.** `Silo_ToggleMode` stores original shortcuts in a module-level dict. If FreeCAD crashes with Silo mode on, original shortcuts are lost on next launch.
+
+### High
+
+4. **Silo authentication not production-hardened.** Local auth (bcrypt) works end-to-end. LDAP (FreeIPA) and OIDC (Keycloak) backends are coded but depend on infrastructure not yet deployed. FreeCAD client has `Silo_Auth` dock panel for login and API token management. Server has session middleware (`alexedwards/scs`), CSRF protection (`nosurf`), and role-based access control (admin/editor/viewer). Migration `009_auth.sql` adds users, api_tokens, and sessions tables.
+
+5. **No unit tests.** Zero test coverage for ztools and Silo FreeCAD commands. Silo Go backend also lacks tests.
+
+6. **Assembly solver datum handling is minimal.** The `findPlacement()` fix in `src/Mod/Assembly/UtilsAssembly.py` extracts placement from `obj.Shape.Faces[0]` for `PartDesign::Plane` and from shape vertex for `PartDesign::Point`. Does not handle empty shapes or non-planar datum objects.
+
+### Medium
+
+7. **`Silo_BOM` requires Silo-tracked document.** Depends on `SiloPartNumber` property. Unregistered documents show a warning with no registration path.
+
+8. **PartDesign menu insertion fragility.** `_ZToolsPartDesignManipulator.modifyMenuBar()` inserts after `PartDesign_Boolean`. If upstream renames this command, insertions silently fail.
+
+9. **tangent_to_cylinder falls back to manual placement.** TangentPlane MapMode requires a vertex reference not collected by the current UI.
+
+10. **`delete_bom_entry()` bypasses error normalization.** Uses raw `urllib.request` instead of `SiloClient._request()`.
+
+11. **Missing Silo icons.** Three commands reference icons that don't exist: `silo-tag.svg` (`Silo_TagProjects`), `silo-rollback.svg` (`Silo_Rollback`), `silo-status.svg` (`Silo_SetStatus`). The `_icon()` function returns an empty string, so these commands render without toolbar icons.
+
+### Fixed (retain for reference)
+
+12. **OndselSolver Newton-Raphson convergence.** `NewtonRaphson::isConvergedToNumericalLimit()` compared `dxNorms->at(iterNo)` to itself instead of `dxNorms->at(iterNo - 1)`. This prevented convergence detection on complex assemblies, causing solver exhaustion and "grounded object moved" warnings. Fixed in Kindred fork (`src/3rdParty/OndselSolver`). Needs upstreaming to `FreeCAD/OndselSolver`.
+
+13. **Assembly solver crash on document restore.** `AssemblyObject::onChanged()` called `updateSolveStatus()` when the Group property changed during document restore, triggering the solver while child objects were still deserializing (SIGSEGV). Fixed with `isRestoring()` and `isPerformingTransaction()` guards at `src/Mod/Assembly/App/AssemblyObject.cpp:143`.
+
+---
+
+## Incomplete features
+
+### Silo
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Authentication | Local auth complete | LDAP/OIDC backends coded, pending infrastructure |
+| CSRF protection | Implemented | `nosurf` library on web form routes |
+| File locking | Not implemented | Needed to prevent concurrent edits |
+| Odoo ERP integration | Stub only | Returns "not yet implemented" |
+| Part number date segments | Broken | `formatDate()` returns error |
+| Location/inventory APIs | Tables exist, no handlers | |
+| CSV import rollback | Not implemented | `bom_handlers.go` |
+
+### ztools
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Tangent-to-cylinder attachment | Manual fallback | No vertex ref in UI |
+| Angled datum live editing | Incomplete | AttachmentOffset not updated in panel |
+| Assembly pattern undo | Not implemented | |
+
+---
+
+## Next steps
+
+1. **Authentication hardening** -- Deploy FreeIPA and Keycloak infrastructure. End-to-end test LDAP and OIDC flows. Harden token rotation and session expiry.
+
+2. **BOM-Assembly bridge** -- Auto-populate Silo BOM from Assembly component links on save.
+
+3. **File locking** -- Pessimistic locks on `Silo_Open` to prevent concurrent edits. Requires server-side lock table and client-side lock display.
+
+4. **Build system** -- CMake install rules for `mods/` submodules so packages include ztools and Silo without manual steps.
+
+5. **Test coverage** -- Unit tests for ztools datum creation, Silo FreeCAD commands, and Go API endpoints.
--- a/docs/OVERVIEW.md
+++ b/docs/OVERVIEW.md
@@ -0,0 +1,29 @@
+# Kindred Create
+
+**Last updated:** 2026-02-06
+**Branch:** main @ `c858706d480`
+**Kindred Create:** v0.1.0
+**FreeCAD base:** v1.0.0
+
+## Documentation
+
+| Document | Contents |
+|----------|----------|
+| [ARCHITECTURE.md](ARCHITECTURE.md) | Bootstrap flow, source layout, submodules |
+| [COMPONENTS.md](COMPONENTS.md) | ztools, Silo, Origin commands, theme, icons |
+| [KNOWN_ISSUES.md](KNOWN_ISSUES.md) | Bugs, incomplete features, next steps |
+| [INTEGRATION_PLAN.md](INTEGRATION_PLAN.md) | Architecture layers, integration phases |
+| [CI_CD.md](CI_CD.md) | Build and release workflows |
+
+## Submodules
+
+| Submodule | Path | Source | Pinned commit |
+|-----------|------|--------|---------------|
+| ztools | `mods/ztools` | `gitea.kindred.internal/kindred/ztools-0065` | `d2f94c3` |
+| silo | `mods/silo` | `gitea.kindred.internal/kindred/silo-0062` | `27e112e` |
+| OndselSolver | `src/3rdParty/OndselSolver` | `gitea.kindred.internal/kindred/ondsel` | `5d1988b` |
+| GSL | `src/3rdParty/GSL` | `github.com/microsoft/GSL` | `756c91a` |
+| AddonManager | `src/Mod/AddonManager` | `github.com/FreeCAD/AddonManager` | `01e242e` |
+| googletest | `tests/lib` | `github.com/google/googletest` | `56efe39` |
+
+OndselSolver is forked from `github.com/FreeCAD/OndselSolver` to carry a Newton-Raphson convergence fix (see [KNOWN_ISSUES.md](KNOWN_ISSUES.md#12)).
--- a/docs/REPOSITORY_STATE.md
+++ b/docs/REPOSITORY_STATE.md
@@ -1,215 +0,0 @@
-# Repository State
-
-**Last updated:** 2026-02-03
-**Branch:** main @ `0ef9ffcf51`
-**Kindred Create:** v0.1.0
-**FreeCAD base:** v1.0.0
-
-## Submodules
-
-| Submodule | Path | Source | Pinned commit |
-|-----------|------|--------|---------------|
-| ztools | `mods/ztools` | `gitea.kindred.internal/kindred/ztools-0065` | `d2f94c3` |
-| silo | `mods/silo` | `gitea.kindred.internal/kindred/silo-0062` | `17a10ab` |
-| OndselSolver | `src/3rdParty/OndselSolver` | `gitea.kindred.internal/kindred/ondsel` | `e32c9cd` |
-| GSL | `src/3rdParty/GSL` | `github.com/microsoft/GSL` | `756c91a` |
-| AddonManager | `src/Mod/AddonManager` | `github.com/FreeCAD/AddonManager` | `01e242e` |
-| googletest | `tests/lib` | `github.com/google/googletest` | `56efe39` |
-
---
-
-## Architecture
-
-### Bootstrap flow
-
-```
-FreeCAD startup
-  └─ src/Mod/Create/Init.py
-       └─ setup_kindred_addons()
-            ├─ exec(mods/ztools/ztools/Init.py)
-            └─ exec(mods/silo/pkg/freecad/Init.py)
-
-  └─ src/Mod/Create/InitGui.py
-       ├─ setup_kindred_workbenches()
-       │    ├─ exec(mods/ztools/ztools/InitGui.py)
-       │    │    ├─ registers ZToolsWorkbench
-       │    │    └─ installs _ZToolsPartDesignManipulator (global)
-       │    └─ exec(mods/silo/pkg/freecad/InitGui.py)
-       │         └─ registers SiloWorkbench
-       └─ Deferred setup (QTimer):
-            ├─ 1500ms: _setup_silo_auth_panel()    → "Database Auth" dock
-            ├─ 2000ms: _setup_silo_menu()           → SiloMenuManipulator
-            ├─ 3000ms: _check_silo_first_start()    → settings prompt
-            └─ 4000ms: _setup_silo_activity_panel() → "Database Activity" dock
-```
-
-### Key source layout
-
-```
-src/Mod/Create/              Kindred bootstrap module (Python)
-  ├── Init.py                Adds mods/ addon paths, loads Init.py files
-  └── InitGui.py             Loads workbenches, installs Silo manipulators
-
-mods/ztools/                 [submodule] ztools workbench
-  ├── ztools/InitGui.py      ZToolsWorkbench + PartDesign manipulator
-  ├── ztools/ztools/
-  │   ├── commands/          Datum, pattern, pocket, assembly, spreadsheet
-  │   ├── datums/core.py     Datum creation via Part::AttachExtension
-  │   └── resources/         Icons, theme utilities
-  └── CatppuccinMocha/       Theme preference pack (QSS)
-
-mods/silo/                   [submodule] Silo parts database
-  ├── cmd/                   Go server entry points
-  ├── internal/              Go API, database, storage packages
-  ├── pkg/freecad/           FreeCAD workbench (Python)
-  │   ├── InitGui.py         SiloWorkbench
-  │   └── silo_commands.py   Commands + SiloClient API
-  ├── deployments/           Docker compose configuration
-  └── migrations/            PostgreSQL schema migrations
-
-src/Gui/Stylesheets/         QSS themes and SVG assets
-resources/preferences/       Canonical preference pack (KindredCreate)
-```
-
---
-
-## Component status
-
-### ztools workbench
-
-**Registered commands (9):**
-
-| Command | Function |
-|---------|----------|
-| `ZTools_DatumCreator` | Create datum planes, axes, points (16 modes) |
-| `ZTools_DatumManager` | Manage existing datum objects |
-| `ZTools_EnhancedPocket` | Flip-side pocket (cut outside sketch profile) |
-| `ZTools_RotatedLinearPattern` | Linear pattern with incremental rotation |
-| `ZTools_AssemblyLinearPattern` | Pattern assembly components linearly |
-| `ZTools_AssemblyPolarPattern` | Pattern assembly components around axis |
-| `ZTools_SpreadsheetStyle{Bold,Italic,Underline}` | Text style toggles |
-| `ZTools_SpreadsheetAlign{Left,Center,Right}` | Cell alignment |
-| `ZTools_Spreadsheet{BgColor,TextColor,QuickAlias}` | Colors and alias creation |
-
-**PartDesign integration** via `_ZToolsPartDesignManipulator`:
- `ZTools_DatumCreator`, `ZTools_DatumManager` → "Part Design Helper Features" toolbar
- `ZTools_EnhancedPocket` → "Part Design Modeling Features" toolbar
- `ZTools_RotatedLinearPattern` → "Part Design Transformation Features" toolbar
- Same commands inserted into Part Design menu after `PartDesign_Boolean`
-
-**Datum types (7):** offset_from_face, offset_from_plane, midplane, 3_points, normal_to_edge, angled, tangent_to_cylinder. All except tangent_to_cylinder use `Part::AttachExtension` for automatic parametric updates.
-
-### Silo workbench
-
-**Registered commands (13):**
-
-| Command | Function |
-|---------|----------|
-| `Silo_New` | Create new Silo-tracked document |
-| `Silo_Open` | Open file from Silo database |
-| `Silo_Save` | Save to Silo (create revision) |
-| `Silo_Commit` | Commit current revision |
-| `Silo_Pull` | Pull latest revision from server |
-| `Silo_Push` | Push local changes to server |
-| `Silo_Info` | View item metadata and history |
-| `Silo_BOM` | Bill of materials dialog (BOM + Where Used) |
-| `Silo_TagProjects` | Assign project tags |
-| `Silo_Rollback` | Rollback to previous revision |
-| `Silo_SetStatus` | Set revision status (draft/review/released/obsolete) |
-| `Silo_Settings` | Configure API URL, projects dir, SSL certificates |
-| `Silo_ToggleMode` | Swap Ctrl+O/S/N between FreeCAD and Silo commands |
-
-**Global integration** via `SiloMenuManipulator` in `src/Mod/Create/InitGui.py`:
- File menu: Silo_New, Silo_Open, Silo_Save, Silo_Commit, Silo_Pull, Silo_Push, Silo_BOM
- File toolbar: Silo_ToggleMode button
-
-**Server architecture:** Go REST API (38 routes) + PostgreSQL + MinIO. See `mods/silo/docs/REPOSITORY_STATUS.md` for route details.
-
-### Theme
-
-**Canonical source:** `resources/preferences/KindredCreate/KindredCreate.qss`
-
-Four copies must stay in sync:
-1. `resources/preferences/KindredCreate/KindredCreate.qss` (canonical)
-2. `src/Gui/Stylesheets/KindredCreate.qss`
-3. `src/Gui/PreferencePacks/KindredCreate/KindredCreate.qss`
-4. `mods/ztools/CatppuccinMocha/CatppuccinMocha.qss`
-
---
-
-## Known issues
-
-### Critical
-
-1. **QSS duplication.** Four copies of the stylesheet must be kept in sync manually. A build step or symlinks should eliminate this.
-
-2. **WorkbenchManipulator timing.** The `_ZToolsPartDesignManipulator` appends commands by name. If ZToolsWorkbench hasn't been activated when the user switches to PartDesign, the commands may not be registered. The manipulator API tolerates missing commands silently, but buttons won't appear.
-
-3. **Silo shortcut persistence.** `Silo_ToggleMode` stores original shortcuts in a module-level dict. If FreeCAD crashes with Silo mode on, original shortcuts are lost on next launch.
-
-### High
-
-4. **No authentication on Silo server.** All API endpoints are publicly accessible. Required before multi-user deployment.
-
-5. **No unit tests.** Zero test coverage for ztools and Silo FreeCAD commands. Silo Go backend also lacks tests.
-
-6. **Assembly solver datum handling is minimal.** The `findPlacement()` fix extracts placement from `obj.Shape.Faces[0]` for `PartDesign::Plane`. Does not handle empty shapes or non-planar datum objects.
-
-### Medium
-
-7. **`Silo_BOM` requires Silo-tracked document.** Depends on `SiloPartNumber` property. Unregistered documents show a warning with no registration path.
-
-8. **PartDesign menu insertion fragility.** `_ZToolsPartDesignManipulator.modifyMenuBar()` inserts after `PartDesign_Boolean`. If upstream renames this command, insertions silently fail.
-
-9. **tangent_to_cylinder falls back to manual placement.** TangentPlane MapMode requires a vertex reference not collected by the current UI.
-
-10. **`delete_bom_entry()` bypasses error normalization.** Uses raw `urllib.request` instead of `SiloClient._request()`.
-
---
-
-## Incomplete features
-
-### Silo
-
-| Feature | Status | Notes |
-|---------|--------|-------|
-| Authentication/authorization | Not implemented | Required for multi-user |
-| File locking | Not implemented | Needed to prevent concurrent edits |
-| Odoo ERP integration | Stub only | Returns "not yet implemented" |
-| Part number date segments | Broken | `formatDate()` returns error |
-| Location/inventory APIs | Tables exist, no handlers | |
-| CSRF protection | Not implemented | Web UI only |
-| CSV import rollback | Not implemented | `bom_handlers.go` |
-
-### ztools
-
-| Feature | Status | Notes |
-|---------|--------|-------|
-| Tangent-to-cylinder attachment | Manual fallback | No vertex ref in UI |
-| Angled datum live editing | Incomplete | AttachmentOffset not updated in panel |
-| Assembly pattern undo | Not implemented | |
-
-### Integration plan
-
-| Phase | Feature | Status |
-|-------|---------|--------|
-| 1 | Addon auto-loading | Done |
-| 2 | Enhanced Pocket as C++ feature | Not started |
-| 3 | Datum C++ helpers | Not started (Python approach used) |
-| 4 | Theme moved to Create module | Partial (QSS synced, not relocated) |
-| 5 | Silo deep integration | Done |
-| 6 | Build system install rules for mods/ | Partial (CI/CD done, CMake install rules pending) |
-
---
-
-## Next steps
-
-1. **Authentication** -- LDAP/FreeIPA integration for Silo multi-user deployment. Server needs auth middleware; FreeCAD client needs credential storage.
-
-2. **BOM-Assembly bridge** -- Auto-populate Silo BOM from Assembly component links on save.
-
-3. **File locking** -- Pessimistic locks on `Silo_Open` to prevent concurrent edits. Requires server-side lock table and client-side lock display.
-
-4. **Build system** -- CMake install rules for `mods/` submodules so packages include ztools and Silo without manual steps.
-
-5. **Test coverage** -- Unit tests for ztools datum creation, Silo FreeCAD commands, and Go API endpoints.
--- a/package/rattler-build/recipe.yaml
+++ b/package/rattler-build/recipe.yaml
@@ -22,7 +22,7 @@ requirements:
    - noqt5
    - python>=3.11,<3.12
    - qt6-main>=6.8,<6.9
-    - swig
+    - swig >=4.0,<4.4

    - if: linux and x86_64
      then:
--- a/src/Gui/CommandDoc.cpp
+++ b/src/Gui/CommandDoc.cpp
@@ -674,14 +674,15 @@ void StdCmdNew::activated(int iMsg)
    }

    // Set default view orientation for the new document
-    Gui::Document* guiDoc = Application::Instance->getDocument(doc);
-    if (guiDoc) {
-        auto views = guiDoc->getMDIViewsOfType(View3DInventor::getClassTypeId());
-        for (auto* view : views) {
-            auto view3d = static_cast<View3DInventor*>(view);
-            view3d->getViewer()->viewDefaultOrientation();
-        }
-    }
+    auto hGrp = App::GetApplication().GetParameterGroupByPath(
+        "User parameter:BaseApp/Preferences/View"
+    );
+    std::string default_view = hGrp->GetASCII("NewDocumentCameraOrientation", "Top");
+    doCommand(
+        Command::Gui,
+        "Gui.activeDocument().activeView().viewDefaultOrientation('%s',0)",
+        default_view.c_str()
+    );

    ParameterGrp::handle hViewGrp = App::GetApplication().GetParameterGroupByPath(
        "User parameter:BaseApp/Preferences/View"
--- a/src/Gui/Icons/resource.qrc
+++ b/src/Gui/Icons/resource.qrc
@@ -185,6 +185,11 @@
        <file>sel-bbox.svg</file>
        <file>sel-forward.svg</file>
        <file>sel-instance.svg</file>
+        <file>silo-bom.svg</file>
+        <file>silo-commit.svg</file>
+        <file>silo-info.svg</file>
+        <file>silo-pull.svg</file>
+        <file>silo-push.svg</file>
        <file>spaceball_button.svg</file>
        <file>SpNav-PanLR.svg</file>
        <file>SpNav-PanUD.svg</file>
--- a/src/Gui/Icons/silo-bom.svg
+++ b/src/Gui/Icons/silo-bom.svg
@@ -0,0 +1,12 @@
+<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">
+  <!-- Outer box -->
+  <rect x="3" y="3" width="18" height="18" rx="2" fill="#313244"/>
+  <!-- List lines (BOM rows) -->
+  <line x1="8" y1="8" x2="18" y2="8" stroke="#89dceb" stroke-width="1.5"/>
+  <line x1="8" y1="12" x2="18" y2="12" stroke="#89dceb" stroke-width="1.5"/>
+  <line x1="8" y1="16" x2="18" y2="16" stroke="#89dceb" stroke-width="1.5"/>
+  <!-- Hierarchy dots -->
+  <circle cx="6" cy="8" r="1" fill="#cba6f7"/>
+  <circle cx="6" cy="12" r="1" fill="#cba6f7"/>
+  <circle cx="6" cy="16" r="1" fill="#cba6f7"/>
+</svg>
--- a/src/Gui/Icons/silo-commit.svg
+++ b/src/Gui/Icons/silo-commit.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">
+  <!-- Git commit style -->
+  <circle cx="12" cy="12" r="4" fill="#313244" stroke="#a6e3a1"/>
+  <line x1="12" y1="2" x2="12" y2="8" stroke="#cba6f7"/>
+  <line x1="12" y1="16" x2="12" y2="22" stroke="#cba6f7"/>
+  <!-- Checkmark inside -->
+  <polyline points="9.5 12 11 13.5 14.5 10" stroke="#a6e3a1" stroke-width="1.5" fill="none"/>
+</svg>
--- a/src/Gui/Icons/silo-info.svg
+++ b/src/Gui/Icons/silo-info.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">
+  <!-- Info circle -->
+  <circle cx="12" cy="12" r="10" fill="#313244"/>
+  <line x1="12" y1="16" x2="12" y2="12" stroke="#89dceb" stroke-width="2"/>
+  <circle cx="12" cy="8" r="0.5" fill="#89dceb" stroke="#89dceb"/>
+</svg>
--- a/src/Gui/Icons/silo-pull.svg
+++ b/src/Gui/Icons/silo-pull.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">
+  <!-- Cloud -->
+  <path d="M18 10h-1.26A8 8 0 1 0 9 20h9a5 5 0 0 0 0-10z" fill="#313244"/>
+  <!-- Download arrow -->
+  <path d="M12 13v5m0 0l-2-2m2 2l2-2" stroke="#89b4fa" stroke-width="2"/>
+  <line x1="12" y1="9" x2="12" y2="13" stroke="#89b4fa" stroke-width="2"/>
+</svg>
--- a/src/Gui/Icons/silo-push.svg
+++ b/src/Gui/Icons/silo-push.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">
+  <!-- Cloud -->
+  <path d="M18 10h-1.26A8 8 0 1 0 9 20h9a5 5 0 0 0 0-10z" fill="#313244"/>
+  <!-- Upload arrow -->
+  <path d="M12 18v-5m0 0l-2 2m2-2l2 2" stroke="#a6e3a1" stroke-width="2"/>
+  <line x1="12" y1="13" x2="12" y2="9" stroke="#a6e3a1" stroke-width="2"/>
+</svg>
--- a/src/Gui/OriginManager.cpp
+++ b/src/Gui/OriginManager.cpp
@@ -124,7 +124,7 @@ bool OriginManager::registerOrigin(FileOrigin* origin)
    }

    _origins[originId] = std::unique_ptr<FileOrigin>(origin);
-    Base::Console().Log("OriginManager: Registered origin '%s'\n", originId.c_str());
+    Base::Console().log("OriginManager: Registered origin '%s'\n", originId.c_str());

    signalOriginRegistered(originId);
    return true;
@@ -150,7 +150,7 @@ bool OriginManager::unregisterOrigin(const std::string& id)
    }

    _origins.erase(it);
-    Base::Console().Log("OriginManager: Unregistered origin '%s'\n", id.c_str());
+    Base::Console().log("OriginManager: Unregistered origin '%s'\n", id.c_str());

    signalOriginUnregistered(id);
    return true;
--- a/src/Gui/OriginSelectorWidget.cpp
+++ b/src/Gui/OriginSelectorWidget.cpp
@@ -244,7 +244,7 @@ QIcon OriginSelectorWidget::iconForOrigin(FileOrigin* origin) const
                QPixmap overlay = BitmapFactory().pixmapFromSvg(
                    "dagViewFail", QSizeF(8, 8));
                if (!overlay.isNull()) {
-                    baseIcon = BitmapFactory::mergePixmap(
+                    baseIcon = BitmapFactoryInst::mergePixmap(
                        baseIcon, overlay, BitmapFactoryInst::BottomRight);
                }
            }
@@ -256,7 +256,7 @@ QIcon OriginSelectorWidget::iconForOrigin(FileOrigin* origin) const
                QPixmap overlay = BitmapFactory().pixmapFromSvg(
                    "Warning", QSizeF(8, 8));
                if (!overlay.isNull()) {
-                    baseIcon = BitmapFactory::mergePixmap(
+                    baseIcon = BitmapFactoryInst::mergePixmap(
                        baseIcon, overlay, BitmapFactoryInst::BottomRight);
                }
            }
Author	SHA1	Message	Date
forbes	a2200b4042	docs: split REPOSITORY_STATE.md into topic files Some checks failed Build and Test / build (pull_request) Has been cancelled Details Replace the monolithic REPOSITORY_STATE.md with four focused files: - OVERVIEW.md: metadata, submodule pins, doc index - ARCHITECTURE.md: bootstrap flow, source layout - COMPONENTS.md: ztools, Silo, Origin commands, theme, icons - KNOWN_ISSUES.md: bugs, incomplete features, next steps Updates reflected in the split: - Silo auth: corrected from 'not implemented' to 'local auth complete; LDAP/OIDC pending infrastructure' - CSRF: corrected from 'not implemented' to 'implemented (nosurf)' - Silo commands: 14 (was 13, added Silo_Auth) - New Origin commands section (5 C++ commands) - New icon infrastructure section with missing icon tracking - New issues: Newton-Raphson convergence fix (#12), Assembly restore crash fix (#13), missing Silo icons (#11) - Updated submodule pins (silo 27e112e, OndselSolver 5d1988b)	2026-02-06 10:43:34 -06:00
forbes	c858706d48	fix(gui): add silo-* icons to Qt resource file for origin commands Some checks failed Build and Test / build (push) Successful in 1h14m34s Details Release Build / build-linux (push) Failing after 1h33m10s Details Release Build / publish-release (push) Has been skipped Details Copy silo-bom, silo-commit, silo-info, silo-pull, and silo-push SVG icons from mods/silo/pkg/freecad/resources/icons/ into src/Gui/Icons/ and register them in resource.qrc so they are compiled into the binary and discoverable by BitmapFactory at runtime.	2026-02-05 22:00:35 -06:00
forbes	724440dcb7	fix(gui): fix build errors in OriginSelectorWidget and OriginManager Some checks failed Build and Test / build (push) Has been cancelled Details - OriginSelectorWidget: use BitmapFactoryInst::mergePixmap() instead of BitmapFactory::mergePixmap() since BitmapFactory is a function, not a class - OriginManager: use Console().log() instead of Console().Log() which does not exist on ConsoleSingleton	2026-02-05 20:48:28 -06:00
forbes	2f594dac0a	fix(gui): use Python API for viewDefaultOrientation in StdCmdNew Some checks failed Build and Test / build (push) Failing after 20m15s Details viewDefaultOrientation is a method on View3DInventorPy (Python wrapper), not on View3DInventorViewer (C++ viewer). Use doCommand with the Python API, matching the pattern used in StdCmdViewHome.	2026-02-05 19:13:45 -06:00
forbes	939b81385e	fix(build): pin swig <4.4 for pivy runtime compatibility Some checks failed Build and Test / build (push) Failing after 19m41s Details SWIG 4.4.x uses runtime API version 5, which is incompatible with conda-forge pivy 0.6.9 built with SWIG <=4.3.x (runtime version 4). Pin to >=4.0,<4.4 to ensure matching runtime versions.	2026-02-05 18:38:19 -06:00