fix(ci): use Docker network hostname for docs runner checkout

The act_runner and gitea containers share the git_default Docker
network. Use http://gitea:3000 (container DNS name) instead of
localhost, which resolves to the runner container itself.

.gitea/workflows/build.yml

@@ -47,8 +47,12 @@ jobs:
           submodules: recursive
           fetch-depth: 1
 
-      - name: Fetch tags (for git describe)
-        run: git fetch --no-recurse-submodules --force --depth=1 origin '+refs/tags/*:refs/tags/*'
+      - name: Fetch latest tag (for git describe)
+        run: |
+          latest_tag=$(git ls-remote --tags --sort=-v:refname origin 'refs/tags/v*' | grep -v '\^{}' | head -n1 | awk '{print $2}')
+          if [ -n "$latest_tag" ]; then
+            git fetch --no-recurse-submodules --force --depth=1 origin "+${latest_tag}:${latest_tag}"
+          fi
 
       - name: Install pixi
         run: |

.gitea/workflows/docs.yml

@@ -0,0 +1,39 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - ".gitea/workflows/docs.yml"
+
+jobs:
+  build-and-deploy:
+    runs-on: docs
+    steps:
+      - name: Checkout
+        run: |
+          REPO_URL="http://gitea:3000/kindred/create.git"
+          if [ -d .git ]; then
+            git fetch "$REPO_URL" main
+            git checkout -f FETCH_HEAD
+          else
+            git clone --depth 1 --branch main "$REPO_URL" .
+          fi
+
+      - name: Install mdBook
+        run: |
+          if ! command -v mdbook &>/dev/null; then
+            MDBOOK_VERSION="v0.5.2"
+            wget -q -O mdbook.tar.gz "https://github.com/rust-lang/mdBook/releases/download/${MDBOOK_VERSION}/mdbook-${MDBOOK_VERSION}-x86_64-unknown-linux-musl.tar.gz"
+            tar -xzf mdbook.tar.gz -C /usr/local/bin
+            rm mdbook.tar.gz
+          fi
+
+      - name: Build mdBook
+        run: mdbook build docs/
+
+      - name: Deploy
+        run: |
+          rm -rf /opt/git/docs/book/*
+          cp -r docs/book/* /opt/git/docs/book/

.gitea/workflows/release.yml

@@ -57,8 +57,12 @@ jobs:
           submodules: recursive
           fetch-depth: 1
 
-      - name: Fetch tags
-        run: git fetch --tags --force --no-recurse-submodules origin
+      - name: Fetch latest tag (for git describe)
+        run: |
+          latest_tag=$(git ls-remote --tags --sort=-v:refname origin 'refs/tags/v*' | grep -v '\^{}' | head -n1 | awk '{print $2}')
+          if [ -n "$latest_tag" ]; then
+            git fetch --no-recurse-submodules --force --depth=1 origin "+${latest_tag}:${latest_tag}"
+          fi
 
       - name: Install pixi
         run: |
@@ -389,21 +393,34 @@ jobs:
           fi
 
           # Create release
-          release_id=$(curl -s -X POST \
+          response=$(curl -s -w "\n%{http_code}" -X POST \
             -H "Authorization: token ${GITEA_TOKEN}" \
             -H "Content-Type: application/json" \
             -d "$PAYLOAD" \
-            "${GITEA_URL}/api/v1/repos/${REPO}/releases" | \
-            python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")
+            "${GITEA_URL}/api/v1/repos/${REPO}/releases")
+          http_code=$(echo "$response" | tail -1)
+          body=$(echo "$response" | sed '$d')
+
+          if [ "$http_code" -lt 200 ] || [ "$http_code" -ge 300 ]; then
+            echo "::error::Failed to create release (HTTP ${http_code}): ${body}"
+            exit 1
+          fi
+
+          release_id=$(echo "$body" | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")
           echo "Created release ${release_id}"
 
           # Upload assets
           for file in release/*; do
             filename=$(basename "$file")
             echo "Uploading ${filename}..."
-            curl -s -X POST \
+            upload_resp=$(curl -s -w "\n%{http_code}" -X POST \
               -H "Authorization: token ${GITEA_TOKEN}" \
               -F "attachment=@${file}" \
-              "${GITEA_URL}/api/v1/repos/${REPO}/releases/${release_id}/assets?name=${filename}"
-            echo " done."
+              "${GITEA_URL}/api/v1/repos/${REPO}/releases/${release_id}/assets?name=${filename}")
+            upload_code=$(echo "$upload_resp" | tail -1)
+            if [ "$upload_code" -lt 200 ] || [ "$upload_code" -ge 300 ]; then
+              echo "::warning::Failed to upload ${filename} (HTTP ${upload_code})"
+            else
+              echo " done."
+            fi
           done

.gitignore

@@ -71,3 +71,6 @@ files_to_translate.txt
 # pixi environments
 .pixi
 *.egg-info
+
+# mdBook build output
+docs/book/

CONTRIBUTING.md

@@ -1,111 +1,131 @@
-# FreeCAD Contribution Process (FCP)
+# Contributing to Kindred Create
 
-FreeCAD's contribution process is inspired by the Collective Code Construction Contract which itself is an evolution of the github.com Fork and Pull Model.
+Kindred Create is maintained at [git.kindred-systems.com/kindred/create](https://git.kindred-systems.com/kindred/create). Contributions are submitted as pull requests against the `main` branch.
 
-The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
+## Getting started
 
+```bash
+git clone --recursive ssh://git@git.kindred-systems.com:2222/kindred/create.git
+cd create
+pixi run configure
+pixi run build
+pixi run freecad
+```
 
-## 0. Status
+See the [README](README.md) for full build instructions.
 
-FreeCAD is in a transition period. The following are to be regarded as GUIDELINES for contribution submission and acceptance. For historical reasons, the actual process MAY diverge from this process during the transition.  Such deviations SHOULD be noted and discussed whenever possible.
+## Branch and PR workflow
 
-## 1. Goals
+1. Create a feature branch from `main`:
+   ```bash
+   git checkout -b feat/my-feature main
+   ```
+2. Make your changes, commit with conventional commit messages (see below).
+3. Push and open a pull request against `main`.
+4. CI builds and tests run automatically on all PRs.
 
-The FreeCAD Contribution Process is expressed here with the following specific goals in mind:
+## Commit messages
 
-1. To provide transparency and fairness in the contribution process.
-2. To allow contributions to be included as quickly as possible.
-3. To preserve and improve the code quality while encouraging appropriate experimentation and risk-taking.
-4. To minimize dependence on individual Contributors by encouraging a large pool of active Contributors.
-5. To be inclusive of many viewpoints and to harness a diverse set of skills.
-6. To provide an encouraging environment where Contributors learn and improve their skills.
-7. To protect the free and open nature of the FreeCAD project.
+Use [Conventional Commits](https://www.conventionalcommits.org/):
 
-## 2. Fundamentals
+| Prefix | Purpose |
+|--------|---------|
+| `feat:` | New feature |
+| `fix:` | Bug fix |
+| `chore:` | Maintenance, dependencies |
+| `docs:` | Documentation only |
+| `art:` | Icons, theme, visual assets |
 
-1. FreeCAD uses the git distributed revision control system.
-2. Source code for the main application and related subprojects is hosted on github.com in the FreeCAD organization.
-3. Problems are discrete, well-defined limitations or bugs.
-4. FreeCAD uses GitHub's issue-tracking system to track problems and contributions. For help requests and general discussions, use the project forum.
-5. Contributions are sets of code changes that resolve a single problem.
-6. FreeCAD uses the Pull Request workflow for evaluating and accepting contributions.
+Examples:
+- `feat: add datum point creation mode`
+- `fix(gui): correct menu icon size on Wayland`
+- `chore: update silo submodule`
 
-## 3. Roles
-1. "User": A member of the wider FreeCAD community who uses the software.
-2. "Contributor": A person who submits a contribution that resolves a previously identified problem. Contributors do not have commit access to the repository unless they are also Maintainers. Everyone, without distinction or discrimination, SHALL have an equal right to become a Contributor.
-3. "Maintainer": A person who merges contributions. Maintainers may or may not be Contributors. Their role is to enforce the process. Maintainers have commit access to the repository.
-4. "Administrator": Administrators have additional authority to maintain the list of designated Maintainers.
+## Code style
 
-## 4. Licensing, Ownership, and Credit
-1. FreeCAD is distributed under the Lesser General Public License, version 2, or superior (LGPL2+).  Additional details can be found in the LICENSE file.
-2. All contributions to FreeCAD MUST use a compatible license.
-3. All contributions are owned by their authors unless assigned to another.
-4. FreeCAD does not have a mandatory copyright assignment policy.
-5. A Contributor who wishes to be identified in the Credits section of the application "About" dialog is responsible for identifying themselves. They should modify the Contributors file and submit a PR with a single commit for this modification only. The contributors file is found at https://github.com/FreeCAD/FreeCAD/blob/main/src/Doc/CONTRIBUTORS
-6. A contributor who does not wish to assume the copyright of their contribution MAY choose to assign it to the [FreeCAD project association](https://fpa.freecad.org) by mentioning **Copyright (c) 2022 The FreeCAD project association <fpa@freecad.org>** in the file's license code block.
+### C/C++
 
-## 5. Contribution Requirements
+Formatted with **clang-format** (config in `.clang-format`). Static analysis via **clang-tidy** (config in `.clang-tidy`).
 
-1. Contributions are submitted in the form of Pull Requests (PR).
-2. Maintainers and Contributors MUST have a GitHub account and SHOULD use their real names or a well-known alias.
-3. If the GitHub username differs from the username on the FreeCAD Forum, effort SHOULD be taken to avoid confusion.
-4. A PR SHOULD be a minimal and accurate answer to exactly one identified and agreed-on problem.
-5. A PR SHOULD refrain from adding additional dependencies to the FreeCAD project unless no other option is available.
-6. Code submissions MUST adhere to the code style guidelines of the project if these are defined.
-7. If a PR contains multiple commits, each commit MUST compile cleanly when merged with all previous commits of the same PR. Each commit SHOULD add value to the history of the project. Checkpoint commits SHOULD be squashed.
-8. A PR SHALL NOT include non-trivial code from other projects unless the Contributor is the original author of that code.
-9. A PR MUST compile cleanly and pass project self-tests on all target platforms.
-10. Changes that break python API used by extensions SHALL be avoided. If it is not possible to avoid breaking changes, the amount of them MUST be minimized and PR MUST clearly describe all breaking changes with clear description on how to replace no longer working solution with newer one. Contributor SHOULD search for addons that will be broken and list them in the PR.
-11. Each commit message in a PR MUST succinctly explain what the commit achieves. The commit message SHALL follow the suggestions in the `git commit --help` documentation, section DISCUSSION.
-12. The PR Title MUST succinctly explain what the PR achieves. The Body MAY be as detailed as needed. If a PR changes the user interface (UI), the body of the text MUST include a presentation of these UI changes, preferably with screenshots of the previous and revised state.
-13. If a PR contains the work of another author (for example, if it is cherry-picked from a fork by someone other than the PR-submitter):
-    1. the PR description MUST contain proper attribution as the first line, for example: "This is work of XYZ cherry-picked from <link>";
-    2. all commits MUST have proper authorship, i.e. be authored by the original author and committed by the author of the PR;
-    3. if changes to cherry-picked commits are necessary they SHOULD be done as follow-up commits. If it is not possible to do so, then the modified commits MUST contain a `Co-Authored-By` trailer in their commit message.
-14. A “Valid PR” is one which satisfies the above requirements.
+### Python
 
-## 6. Process
+Formatted with **black** (100-character line length). Linted with **pylint** (config in `.pylintrc`).
 
-1. Change on the project follows the pattern of accurately identifying problems and applying minimal, accurate solutions to these problems.
-2. To request changes, a User logs an issue on the project GitHub issue tracker.
-3. The User or Contributor SHOULD write the issue by describing the problem they face or observe. Links to the forum or other resources are permitted but the issue SHOULD be complete and accurate and SHOULD NOT require the reader to visit the forum or any other platform to understand what is being described.
-4. Issue authors SHOULD strive to describe the minimum acceptable condition.
-5. Issue authors SHOULD focus on User tasks and avoid comparisons to other software solutions.
-6. The User or Contributor SHOULD seek consensus on the accuracy of their observation and the value of solving the problem.
-7. To submit a solution to a problem, a Contributor SHALL create a pull request back to the project.
-8. Contributors and Maintainers SHALL NOT commit changes directly to the target branch.
-9. To discuss a proposed solution, Users MAY comment on the Pull Request in GitHub. Forum conversations regarding the solution SHOULD be discouraged and conversation redirected to the Pull Request or the related issue.
-10. To accept or reject a Pull Request, a Maintainer SHALL use GitHub's interface.
-11. Maintainers SHOULD NOT merge their own PRs except:
-    1. in exceptional cases, such as non-responsiveness from other Maintainers for an extended period.
-    2. If the Maintainer is also the primary developer of the workbench or subsystem.
+### Pre-commit hooks
 
-12. Maintainers SHALL merge valid PRs from other Contributors rapidly.
-13. Maintainers MAY, at their discretion merge PRs that have not met all criteria to be considered valid to:
-    1. end fruitless discussions
-    2. capture toxic contributions in the historical record
-    3. engage with the Contributor on improving their contribution quality.
-14. Maintainers SHALL NOT make value judgments on correct contributions.
-15. If a PR requires significant further work before merging, the PR SHOULD be moved to draft status.
-16. If a PR is complete, but should not be merged yet (for example, because it depends on another in-process PR), the "On hold" label SHOULD be applied.
-17. Any Contributor who has value judgments on a PR SHOULD express these via their own PR.
-18. The User who created an issue SHOULD close the issue after checking the PR is successful.
-19. Maintainers SHOULD close issues that are left open without action or update for an unreasonable period.
+```bash
+pip install pre-commit
+pre-commit install
+```
 
-## 7. Branches and Releases
+This runs clang-format, black, and pylint automatically on staged files.
 
-1. The project SHALL have one branch (“main”) that always holds the latest in-progress version and SHOULD always build.
-2. The project SHALL NOT use topic branches for any reason. Personal forks MAY use topic branches.
-3. To make a stable release a Maintainer SHALL tag the repository. Stable releases SHALL always be released from the repository main branch.
+## Submodules
 
-## 8. Project Administration
+Kindred Create uses git submodules for addon workbenches:
 
-1. Project Administrators are those individuals who are members of the FreeCAD Github organization and have the role of 'owner'.  They have the task of administering the organization including adding and removing individuals from various teams.
-2. Project Administrator is a technical role necessitated by the GitHub platform. Except for the specific exceptions listed below, the Project Administrators do not make the decision about individual team members. Rather, they carry out the collective wishes of the Maintainers team. Project Administrators will be selected from the Maintainers team by the Maintainers themselves.
-3. To ensure continuity there SHALL be at least four Project Administrators at all times.
-4. The project Administrators will manage the set of project Maintainers.  They SHALL maintain a sufficiently large pool of Maintainers to ensure their succession and permit timely review of contributions. If the pool of Maintainers is insufficient, the Project Administrators will request that the Maintainers select additional individuals to add.
-5. Contributors who have a history of successful PRs and have demonstrated continued professionalism should be invited to be Maintainers.
-6. Administrators SHOULD remove Maintainers who are inactive for an extended period, or who repeatedly fail to apply this process accurately.
-7. The list of Maintainers SHALL be publicly accessible and reflective of current activity on the project.
-8. Administrators SHALL act expediently to protect the FreeCAD infrastructure and resources.
-9. Administrators SHOULD block or ban “bad actors” who cause stress, animosity, or confusion to others in the project. This SHOULD be done after public discussion, with a chance for all parties to speak. A bad actor is someone who repeatedly ignores the rules and culture of the project, who is hostile or offensive, who impedes the productive exchange of information, and who is unable to self-correct their behavior when asked to do so by others.
+| Submodule | Path | Repository |
+|-----------|------|------------|
+| ztools | `mods/ztools` | `git.kindred-systems.com/forbes/ztools` |
+| silo-mod | `mods/silo` | `git.kindred-systems.com/kindred/silo-mod` |
+
+To update a submodule:
+
+```bash
+cd mods/silo
+git checkout main && git pull
+cd ../..
+git add mods/silo
+git commit -m "chore: update silo submodule"
+```
+
+If you cloned without `--recursive`, initialize submodules with:
+
+```bash
+git submodule update --init --recursive
+```
+
+## Theme and QSS changes
+
+The Catppuccin Mocha theme has **three QSS copies** that must be kept in sync:
+
+1. `resources/preferences/KindredCreate/KindredCreate.qss` (canonical)
+2. `src/Gui/Stylesheets/KindredCreate.qss`
+3. `src/Gui/PreferencePacks/KindredCreate/KindredCreate.qss`
+
+When modifying the theme, apply changes to all three files. Note that the copies have intentional differences (e.g., tree branch rendering style), so do not blindly copy between them -- apply edits individually.
+
+See [KNOWN_ISSUES.md](docs/KNOWN_ISSUES.md) for the planned QSS consolidation.
+
+## Preference pack
+
+Default preferences are defined in `resources/preferences/KindredCreate/KindredCreate.cfg`. This XML file uses FreeCAD's parameter format:
+
+```xml
+<FCParamGroup Name="GroupName">
+  <FCBool Name="Setting" Value="1"/>
+  <FCInt Name="Setting" Value="42"/>
+  <FCText Name="Setting">value</FCText>
+</FCParamGroup>
+```
+
+Changes here affect the out-of-box experience for all users.
+
+## CI/CD
+
+- **Build workflow** (`build.yml`): Runs on every push to `main` and on PRs. Builds in Ubuntu 24.04 container, runs C++ and Python tests.
+- **Release workflow** (`release.yml`): Triggered by `v*` tags. Builds AppImage and .deb packages.
+
+See [docs/CI_CD.md](docs/CI_CD.md) for full details.
+
+## Architecture
+
+For an overview of the codebase structure, bootstrap flow, and design decisions, see:
+
+- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) -- Bootstrap flow and source layout
+- [docs/COMPONENTS.md](docs/COMPONENTS.md) -- Feature inventory
+- [docs/INTEGRATION_PLAN.md](docs/INTEGRATION_PLAN.md) -- Architecture layers and roadmap
+
+## License
+
+All contributions must be compatible with [LGPL-2.1-or-later](LICENSE).

docs/ARCHITECTURE.md

@@ -20,7 +20,8 @@ FreeCAD startup
             ├─ 1500ms: _register_silo_origin()      → registers Silo FileOrigin
             ├─ 2000ms: _setup_silo_auth_panel()     → "Database Auth" dock
             ├─ 3000ms: _check_silo_first_start()    → settings prompt
-            └─ 4000ms: _setup_silo_activity_panel() → "Database Activity" dock
+            ├─ 4000ms: _setup_silo_activity_panel() → "Database Activity" dock (SSE)
+            └─ 10000ms: _check_for_updates()        → update checker (Gitea API)
 ```
 
 ## Key source layout
@@ -28,7 +29,9 @@ FreeCAD startup
 ```
 src/Mod/Create/              Kindred bootstrap module (Python)
   ├── Init.py                Adds mods/ addon paths, loads Init.py files
-  └── InitGui.py             Loads workbenches, installs Silo manipulators
+  ├── InitGui.py             Loads workbenches, installs Silo manipulators
+  ├── version.py.in          CMake template → version.py (build-time)
+  └── update_checker.py      Checks Gitea releases API for updates
 
 src/Gui/FileOrigin.h/.cpp           FileOrigin base class + LocalFileOrigin
 src/Gui/CommandOrigin.cpp            Origin_Commit/Pull/Push/Info/BOM commands
@@ -52,7 +55,7 @@ mods/silo/                   [submodule -> silo-mod.git] FreeCAD workbench
       └── silo_origin.py     FileOrigin backend for Silo
 
 src/Gui/Stylesheets/         QSS themes and SVG assets
-resources/preferences/       Canonical preference pack (KindredCreate)
+src/Gui/PreferencePacks/     KindredCreate preference pack (cfg + build-time QSS)
 ```
 
 See [INTEGRATION_PLAN.md](INTEGRATION_PLAN.md) for architecture layers and phase status.

docs/CI_CD.md

@@ -7,7 +7,7 @@ Kindred Create uses Gitea Actions for continuous integration and release builds.
 | Workflow | Trigger | Purpose | Artifacts |
 |----------|---------|---------|-----------|
 | `build.yml` | Push to `main`, pull requests | Build + test | Linux tarball |
-| `release.yml` | Tags matching `v*` | Multi-platform release | AppImage, .deb, .dmg, .exe, .7z |
+| `release.yml` | Tags matching `v*` or `latest` | Release build | AppImage, .deb |
 
 All builds run on public runners in dockerized mode. No host-mode or internal infrastructure is required.
 
@@ -34,14 +34,16 @@ Runs on every push to `main` and on pull requests. Builds the project in an Ubun
 
 ### Caching
 
-ccache is persisted between builds using `actions/cache`. Cache keys are scoped by branch and commit SHA, with fallback to the branch key then `main`.
+ccache is persisted between builds using `actions/cache`. Cache keys use a date suffix so entries rotate daily (one save per day per branch). Saves are skipped when the exact key already exists, preventing duplicate entries that fill runner storage.
 
 ```
-Key:      ccache-build-{branch}-{sha}
+Key:      ccache-build-{branch}-{YYYYMMDD}
 Fallback: ccache-build-{branch}-
 Fallback: ccache-build-main-
 ```
 
+Release builds use a separate key namespace (`ccache-release-linux-{YYYYMMDD}`) because they compile with different optimization flags (`-O3`). The rattler-build script (`build.sh`) explicitly sets `CCACHE_DIR` and `CCACHE_BASEDIR` since rattler-build does not forward environment variables from the parent process.
+
 ccache configuration: 4 GB max, zlib compression level 6, sloppy mode for include timestamps and PCH.
 
 ---
@@ -63,17 +65,19 @@ Tags containing `rc`, `beta`, or `alpha` are marked as pre-releases.
 
 ### Platform matrix
 
-| Job | Runner | Container | Preset | Output |
-|-----|--------|-----------|--------|--------|
-| `build-linux` | `ubuntu-latest` | `ubuntu:24.04` | `conda-linux-release` | AppImage, .deb |
-| `build-macos` (Intel) | `macos-13` | native | `conda-macos-release` | .dmg (x86_64) |
-| `build-macos` (Apple Silicon) | `macos-14` | native | `conda-macos-release` | .dmg (arm64) |
-| `build-windows` | `windows-latest` | native | `conda-windows-release` | .exe (NSIS), .7z |
+| Job | Runner | Container | Preset | Output | Status |
+|-----|--------|-----------|--------|--------|--------|
+| `build-linux` | `ubuntu-latest` | `ubuntu:24.04` | `conda-linux-release` | AppImage, .deb | Active |
+| `build-macos` (Intel) | `macos-13` | native | `conda-macos-release` | .dmg (x86_64) | Disabled |
+| `build-macos` (Apple Silicon) | `macos-14` | native | `conda-macos-release` | .dmg (arm64) | Disabled |
+| `build-windows` | `windows-latest` | native | `conda-windows-release` | .exe (NSIS), .7z | Disabled |
 
-All four jobs run concurrently. After all succeed, `publish-release` collects artifacts and creates the Gitea release.
+Only the Linux build is currently active. macOS and Windows jobs are defined but commented out pending runner availability or cross-compilation support. After `build-linux` succeeds, `publish-release` collects artifacts and creates the Gitea release.
 
 ### Linux build
 
+Both workflows start with a disk cleanup step that removes pre-installed bloat (dotnet, Android SDK, etc.) to free space for the build.
+
 Uses the rattler-build packaging pipeline:
 
 1. `pixi install` in `package/rattler-build/`
@@ -81,9 +85,10 @@ Uses the rattler-build packaging pipeline:
 3. The bundle script:
    - Copies the pixi conda environment to an AppDir
    - Strips unnecessary files (includes, static libs, cmake files, `__pycache__`)
-   - Downloads `appimagetool` and creates a squashfs AppImage (zstd compressed)
-   - Generates SHA256 checksums
-4. `package/debian/build-deb.sh` builds a .deb from the AppDir
+   - Downloads `appimagetool`, extracts it with `--appimage-extract` (FUSE unavailable in containers), and runs via `squashfs-root/AppRun`
+   - Creates a squashfs AppImage (zstd compressed) with SHA256 checksums
+4. Intermediate build files are cleaned up to free space for the .deb step
+5. `package/debian/build-deb.sh` builds a .deb from the AppDir
    - Installs to `/opt/kindred-create/` with wrapper scripts in `/usr/bin/`
    - Sets up LD_LIBRARY_PATH, QT_PLUGIN_PATH, PYTHONPATH in wrappers
    - Creates desktop entry, MIME types, AppStream metainfo
@@ -123,10 +128,15 @@ Builds natively on Windows runner:
 
 `publish-release` runs after all platform builds succeed:
 
-1. Downloads all artifacts from `build-linux`, `build-macos`, `build-windows`
-2. Collects release files (AppImage, .deb, .dmg, .7z, .exe, checksums)
-3. Creates a Gitea release via `gitea.com/actions/release-action`
-4. Requires `RELEASE_TOKEN` secret with repository write permissions
+1. Downloads all artifacts from completed build jobs
+2. Collects release files (AppImage, .deb, checksums) into a `release/` directory
+3. Deletes any existing Gitea release for the same tag (allows re-running)
+4. Creates a new Gitea release via the REST API (`/api/v1/repos/{owner}/{repo}/releases`)
+5. Uploads each artifact as a release attachment via the API
+
+The release payload (tag name, body, prerelease flag) is built entirely in Python to avoid shell/Python type mismatches. Tags containing `rc`, `beta`, or `alpha` are automatically marked as pre-releases.
+
+Requires `RELEASE_TOKEN` secret with repository write permissions.
 
 ---
 
@@ -174,6 +184,27 @@ container:
   network: bridge
 ```
 
+### Runner cleanup daemon
+
+A cleanup script at `.gitea/runner/cleanup.sh` prevents disk exhaustion on self-hosted runners. It uses a tiered approach based on disk usage thresholds:
+
+| Threshold | Action |
+|-----------|--------|
+| 70% | Docker cleanup (stopped containers, dangling images, build cache) |
+| 80% | Purge act_runner cache entries older than 7 days, clean inactive workspaces |
+| 90% | System cleanup (apt cache, old logs, journal vacuum to 100 MB) |
+| 95% | Emergency: remove all act_runner cache entries and Docker images |
+
+Install via the provided systemd units (`.gitea/runner/cleanup.service` and `.gitea/runner/cleanup.timer`) to run every 30 minutes:
+
+```bash
+sudo cp .gitea/runner/cleanup.sh /usr/local/bin/runner-cleanup.sh
+sudo cp .gitea/runner/cleanup.service /etc/systemd/system/
+sudo cp .gitea/runner/cleanup.timer /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable --now cleanup.timer
+```
+
 ---
 
 ## Secrets
@@ -214,11 +245,12 @@ Defined in `CMakePresets.json`. Release builds use:
 
 ### ccache
 
-Compiler cache is used across all builds to speed up incremental compilation. Cache is persisted between CI runs via `actions/cache`. Configuration:
+Compiler cache is used across all builds to speed up incremental compilation. Cache is persisted between CI runs via `actions/cache` with date-based key rotation. Configuration:
 
 - Max size: 4 GB
 - Compression: zlib level 6
 - Sloppy mode: include timestamps, PCH defines, time macros
+- `CCACHE_BASEDIR`: set to workspace root (build workflow) or `$SRC_DIR` (rattler-build) for path normalization across runs
 
 ---
 
@@ -243,9 +275,12 @@ The Docker container installs only minimal dependencies. If a new dependency is
 ccache misses spike when:
 - The compiler version changes (pixi update)
 - CMake presets change configuration flags
-- The cache key doesn't match (new branch, force-pushed SHA)
+- First build of the day (date-based key rotates daily)
+- New branch without a prior cache (falls back to `main` cache)
 
-Check `pixi run ccache -s` output for hit/miss ratios.
+For release builds, ensure `build.sh` is correctly setting `CCACHE_DIR=/tmp/ccache-kindred-create` -- rattler-build does not forward environment variables from the workflow, so ccache config must be set inside the script.
+
+Check `pixi run ccache -s` output (printed in the "Show ccache statistics" step) for hit/miss ratios. The "Prepare ccache" step also prints the full ccache configuration via `ccache -p`.
 
 ### Submodule checkout fails
 

docs/COMPONENTS.md

@@ -69,7 +69,12 @@ These appear in the File menu and "Origin Tools" toolbar across all workbenches
 - Origin Tools toolbar: `Origin_Commit`/`Origin_Pull`/`Origin_Push`/`Origin_Info`/`Origin_BOM` (auto-disable by capability)
 - Silo origin registered at startup by `src/Mod/Create/InitGui.py`
 
-**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.
+**Dock panels:**
+- Database Auth (2000ms) -- Login/logout and API token management
+- Database Activity (4000ms) -- Real-time server event feed via SSE (Server-Sent Events) with automatic reconnection and exponential backoff
+- Start Panel -- In-viewport landing page with recent files and Silo integration
+
+**Server architecture:** Go REST API (38+ routes) + PostgreSQL + MinIO S3. Authentication via local (bcrypt), LDAP, or OIDC backends. SSE endpoint for real-time event streaming. See `mods/silo/docs/` for server documentation.
 
 **LibreOffice Calc extension** ([silo-calc](https://git.kindred-systems.com/kindred/silo-calc.git)): BOM management, item creation, and AI-assisted descriptions via OpenRouter API. Shares the same Silo REST API and auth token system via the shared [silo-client](https://git.kindred-systems.com/kindred/silo-client.git) package.
 
@@ -77,13 +82,14 @@ These appear in the File menu and "Origin Tools" toolbar across all workbenches
 
 ## Theme
 
-**Canonical source:** `resources/preferences/KindredCreate/KindredCreate.qss`
+**Canonical source:** `src/Gui/Stylesheets/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`
+The PreferencePacks copy (`src/Gui/PreferencePacks/KindredCreate/KindredCreate.qss`) is generated at build time via `configure_file()` in `src/Gui/PreferencePacks/CMakeLists.txt`. Only the Stylesheets copy needs to be maintained.
+
+Notable theme customizations beyond standard Catppuccin colors:
+- `QGroupBox::indicator` styling to match `QCheckBox::indicator` (consistent checkbox appearance)
+- `QLabel[haslink="true"]` link color (`#b4befe` Catppuccin Lavender) -- picked up by FreeCAD to set `QPalette::Link`
+- Spanning-line tree branch indicators
 
 ---
 

docs/KNOWN_ISSUES.md

@@ -4,7 +4,7 @@
 
 ### Critical
 
-1. **QSS duplication.** Four copies of the stylesheet must be kept in sync manually. A build step or symlinks should eliminate this.
+1. ~~**QSS duplication.**~~ Resolved. The canonical QSS lives in `src/Gui/Stylesheets/KindredCreate.qss`. The PreferencePacks copy is now generated at build time via `configure_file()` in `src/Gui/PreferencePacks/CMakeLists.txt`. The unused `resources/preferences/KindredCreate/` directory has been removed.
 
 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.
 
@@ -36,6 +36,8 @@
 
 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`.
 
+14. **`DlgSettingsGeneral::applyMenuIconSize` visibility.** The method was `private` but called from `StartupProcess.cpp`. Fixed by moving to `public` (PR #49). Also required `Dialog::` namespace qualifier in `StartupProcess.cpp`.
+
 ---
 
 ## Incomplete features
@@ -44,13 +46,16 @@
 
 | Feature | Status | Notes |
 |---------|--------|-------|
-| Authentication | Local auth complete | LDAP/OIDC backends coded, pending infrastructure |
+| Authentication | Local auth complete | LDAP/OIDC backends coded, pending infrastructure. Auth dock panel available. |
 | 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` |
+| SSE event streaming | Implemented | Reconnect logic with exponential backoff |
+| Database Activity panel | Implemented | Dock panel showing real-time server events |
+| Start panel | Implemented | In-viewport start page with recent files and Silo integration |
 
 ### ztools
 
@@ -73,3 +78,7 @@
 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.
+
+6. **QSS consolidation** -- Eliminate the 3-copy QSS duplication via build-time copy or symlinks. The canonical source is `resources/preferences/KindredCreate/KindredCreate.qss`.
+
+7. **Update notification UI** -- Display in-app notification when a new release is available (issue #30). The update checker backend is already implemented.

docs/OVERVIEW.md

@@ -1,7 +1,7 @@
 # Kindred Create
 
-**Last updated:** 2026-02-06
-**Branch:** main @ `c858706d480`
+**Last updated:** 2026-02-08
+**Branch:** main @ `cf523f1d87a`
 **Kindred Create:** v0.1.0
 **FreeCAD base:** v1.0.0
 
@@ -19,11 +19,13 @@
 
 | 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` |
+| ztools | `mods/ztools` | `git.kindred-systems.com/forbes/ztools` | `3298d1c` |
+| silo-mod | `mods/silo` | `git.kindred-systems.com/kindred/silo-mod` | `f9924d3` |
+| OndselSolver | `src/3rdParty/OndselSolver` | `git.kindred-systems.com/kindred/solver` | `fe41fa3` |
 | 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` |
 
+The silo submodule was split from a monorepo into three repos: `silo-client` (shared Python API client), `silo-mod` (FreeCAD workbench, used as Create's submodule), and `silo-calc` (LibreOffice Calc extension). The `silo-mod` repo includes `silo-client` as its own submodule.
+
 OndselSolver is forked from `github.com/FreeCAD/OndselSolver` to carry a Newton-Raphson convergence fix (see [KNOWN_ISSUES.md](KNOWN_ISSUES.md#12)).

docs/book.toml

@@ -0,0 +1,17 @@
+[book]
+title = "Kindred Create Documentation"
+authors = ["Kindred Systems LLC"]
+language = "en"
+multilingual = false
+src = "src"
+
+[build]
+build-dir = "book"
+
+[output.html]
+default-theme = "coal"
+preferred-dark-theme = "coal"
+git-repository-url = "https://git.kindred-systems.com/kindred/create"
+git-repository-icon = "fa-code-branch"
+additional-css = ["theme/kindred.css"]
+no-section-label = false

docs/src/SUMMARY.md

@@ -0,0 +1,33 @@
+# Summary
+
+[Introduction](./introduction.md)
+
+---
+
+# User Guide
+
+- [Getting Started](./guide/getting-started.md)
+  - [Installation](./guide/installation.md)
+  - [Building from Source](./guide/building.md)
+- [Workbenches](./guide/workbenches.md)
+  - [ztools](./guide/ztools.md)
+  - [Silo](./guide/silo.md)
+
+# Architecture
+
+- [Overview](./architecture/overview.md)
+- [Python as Source of Truth](./architecture/python-source-of-truth.md)
+- [Silo Server](./architecture/silo-server.md)
+- [OndselSolver](./architecture/ondsel-solver.md)
+
+# Development
+
+- [Contributing](./development/contributing.md)
+- [Code Quality](./development/code-quality.md)
+- [Repository Structure](./development/repo-structure.md)
+- [Build System](./development/build-system.md)
+
+# Reference
+
+- [Configuration](./reference/configuration.md)
+- [Glossary](./reference/glossary.md)

docs/src/architecture/ondsel-solver.md

@@ -0,0 +1,27 @@
+# OndselSolver
+
+OndselSolver is the assembly constraint solver used by FreeCAD's Assembly workbench. Kindred Create vendors a fork of the solver as a git submodule.
+
+- **Path:** `src/3rdParty/OndselSolver/`
+- **Source:** `git.kindred-systems.com/kindred/solver` (Kindred fork)
+
+## How it works
+
+The solver uses a **Lagrangian constraint formulation** to resolve assembly constraints (mates, joints, fixed positions). Given a set of parts with geometric constraints between them, it computes positions and orientations that satisfy all constraints simultaneously.
+
+The Assembly workbench (`src/Mod/Assembly/`) calls the solver whenever constraints are added or modified. Kindred Create has patches to `Assembly/` that extend `findPlacement()` for better datum and origin handling.
+
+## Why a fork
+
+The solver is forked from the upstream Ondsel project for:
+- **Pinned stability** — the submodule is pinned to a known-good commit
+- **Potential modifications** — the fork allows Kindred-specific patches if needed
+- **Availability** — hosted on Kindred's Gitea instance for reliable access
+
+## Future: GNN solver
+
+There are plans to explore a Graph Neural Network (GNN) approach to constraint solving that could complement or supplement the Lagrangian solver for specific use cases. This is not yet implemented.
+
+## Related: GSL
+
+The `src/3rdParty/GSL/` submodule is Microsoft's Guidelines Support Library (`github.com/microsoft/GSL`), providing C++ core guidelines utilities like `gsl::span` and `gsl::not_null`. It is a build dependency, not related to the constraint solver.

docs/src/architecture/overview.md

@@ -0,0 +1,78 @@
+# Architecture Overview
+
+Kindred Create is structured as a thin integration layer on top of FreeCAD. The design follows three principles:
+
+1. **Minimal core modifications** — prefer submodule addons over patching FreeCAD internals
+2. **Graceful degradation** — Create runs without ztools or Silo if submodules are missing
+3. **Pure Python addons** — workbenches follow FreeCAD's standard addon pattern
+
+## Three-layer model
+
+```
+┌─────────────────────────────────┐
+│  FreeCAD Documents (.FCStd)     │  Python source of truth
+│  Workbench logic (Python)       │
+├─────────────────────────────────┤
+│  PostgreSQL                     │  Silo metadata, revisions, BOM
+├─────────────────────────────────┤
+│  MinIO (S3-compatible)          │  Binary file storage cache
+└─────────────────────────────────┘
+```
+
+FreeCAD documents are the authoritative representation of CAD data. Silo's PostgreSQL database stores metadata (part numbers, revisions, BOM relationships) and MinIO stores the binary `.FCStd` files. The FreeCAD workbench synchronizes between local files and the server.
+
+## Source layout
+
+```
+create/
+├── src/App/                # Core application (C++)
+├── src/Base/               # Foundation classes (C++)
+├── src/Gui/                # GUI framework (C++ + Qt6 + QSS)
+│   ├── Stylesheets/        # KindredCreate.qss theme
+│   ├── PreferencePacks/    # Theme preference pack
+│   ├── Icons/              # silo-*.svg origin icons
+│   ├── FileOrigin.*        # Abstract file origin interface
+│   └── OriginManager.*     # Origin lifecycle management
+├── src/Mod/                # ~37 FreeCAD modules
+│   ├── Create/             # Kindred bootstrap module
+│   ├── Assembly/           # Assembly workbench (Kindred patches)
+│   ├── PartDesign/         # Part Design (stock + ztools injection)
+│   └── ...                 # Other stock FreeCAD modules
+├── mods/
+│   ├── ztools/             # Datum/pattern/pocket workbench (submodule)
+│   └── silo/               # Parts database workbench (submodule)
+└── src/3rdParty/
+    ├── OndselSolver/       # Assembly solver (submodule)
+    └── GSL/                # Guidelines Support Library (submodule)
+```
+
+## Bootstrap sequence
+
+1. FreeCAD core initializes, discovers `src/Mod/Create/`
+2. `Init.py` runs `setup_kindred_addons()` — adds `mods/ztools/ztools` and `mods/silo/freecad` to `sys.path`, executes their `Init.py`
+3. GUI phase: `InitGui.py` runs `setup_kindred_workbenches()` — executes addon `InitGui.py` files to register workbenches
+4. Deferred QTimer cascade:
+   - **1500ms** — Register Silo as a file origin
+   - **2000ms** — Dock the Silo auth panel
+   - **3000ms** — Check for Silo first-start configuration
+   - **4000ms** — Dock the Silo activity panel
+   - **10000ms** — Check for application updates
+
+The QTimer cascade exists because FreeCAD's startup is not fully synchronous — Silo registration must wait for the GUI framework to be ready.
+
+## Origin system
+
+The origin system is Kindred's primary addition to FreeCAD's GUI layer:
+
+- **`FileOrigin`** — abstract C++ interface for file backends
+- **`LocalFileOrigin`** — default implementation (local filesystem)
+- **`SiloOrigin`** — Silo database backend (registered by the Python addon)
+- **`OriginManager`** — manages origin lifecycle, switching, capability queries
+- **`OriginSelectorWidget`** — dropdown in the File toolbar
+- **`CommandOrigin.cpp`** — Commit / Pull / Push / Info / BOM commands that delegate to the active origin
+
+## Module interaction
+
+- **ztools** injects commands into PartDesign via `_ZToolsPartDesignManipulator`
+- **Silo** registers as a `FileOrigin` backend via `silo_origin.register_silo_origin()`
+- **Create module** is glue only — no feature code, just bootstrap and version management

docs/src/architecture/python-source-of-truth.md

@@ -0,0 +1,26 @@
+# Python as Source of Truth
+
+In Kindred Create's architecture, FreeCAD documents (`.FCStd` files) are the authoritative representation of all CAD data. The Silo database and MinIO storage are caches and metadata indexes — they do not define the model.
+
+## How it works
+
+An `.FCStd` file is a ZIP archive containing:
+- XML documents describing the parametric model tree
+- BREP geometry files for each shape
+- Thumbnail images
+- Embedded spreadsheets and metadata
+
+When a user runs **Commit**, the workbench uploads the entire `.FCStd` file to MinIO and records metadata (part number, revision, timestamp, commit message) in PostgreSQL. When a user runs **Pull**, the workbench downloads the `.FCStd` from MinIO and opens it locally.
+
+## Why this design
+
+- **No data loss** — the complete model is always in the `.FCStd` file, never split across systems
+- **Offline capability** — engineers can work without a server connection
+- **FreeCAD compatibility** — files are standard FreeCAD documents, openable in stock FreeCAD
+- **Simple sync model** — the unit of transfer is always a whole file, avoiding merge conflicts in binary geometry
+
+## Trade-offs
+
+- **Large files** — `.FCStd` files can grow large with complex assemblies; every commit stores the full file
+- **No partial sync** — you cannot pull a single feature or component; it is all or nothing
+- **Conflict resolution** — two users editing the same file must resolve conflicts manually (last-commit-wins by default)

docs/src/architecture/silo-server.md

@@ -0,0 +1,50 @@
+# Silo Server
+
+The Silo server is a Go REST API that provides the backend for the Silo workbench. It manages part numbers, revisions, bills of materials, and file storage for engineering teams.
+
+## Components
+
+```
+silo/
+├── cmd/
+│   ├── silo/              # CLI tool
+│   └── silod/             # API server
+├── internal/
+│   ├── api/               # HTTP handlers, routes, templates
+│   ├── config/            # Configuration loading
+│   ├── db/                # PostgreSQL access
+│   ├── migration/         # Property migration utilities
+│   ├── partnum/           # Part number generation
+│   ├── schema/            # YAML schema parsing
+│   └── storage/           # MinIO file storage
+├── migrations/            # Database migration SQL scripts
+├── schemas/               # Part numbering schema definitions (YAML)
+└── deployments/           # Docker Compose and systemd configs
+```
+
+## Stack
+
+- **Go** REST API with 38+ routes
+- **PostgreSQL** for metadata, revisions, BOM relationships
+- **MinIO** (S3-compatible) for binary `.FCStd` file storage
+- **LDAP / OIDC** for authentication
+- **SSE** (Server-Sent Events) for real-time activity feed
+
+## Key features
+
+- **Configurable part number generation** via YAML schemas
+- **Revision tracking** with append-only history
+- **BOM management** with reference designators and alternates
+- **Physical inventory** tracking with hierarchical locations
+
+## Database migrations
+
+Migrations live in `migrations/` as numbered SQL scripts (e.g., `001_initial.sql`). Apply them sequentially against the database:
+
+```bash
+psql -h psql.kindred.internal -U silo -d silo -f migrations/001_initial.sql
+```
+
+## Deployment
+
+See `mods/silo/deployments/` for Docker Compose and systemd configurations. A typical deployment runs the Go server alongside PostgreSQL and MinIO containers.

docs/src/development/build-system.md

@@ -0,0 +1,72 @@
+# Build System
+
+Kindred Create uses **CMake** for build configuration, **pixi** (conda-based) for dependency management and task running, and **ccache** for compilation caching.
+
+## Overview
+
+- **CMake** >= 3.22.0
+- **Ninja** generator (via conda presets)
+- **pixi** manages all dependencies — compilers, Qt6, OpenCASCADE, Python, etc.
+- **ccache** with 4 GB max, zlib compression level 6, sloppy mode
+- **mold** linker on Linux for faster link times
+
+## CMake configuration
+
+The root `CMakeLists.txt` defines:
+- **Kindred Create version:** `0.1.0` (via `KINDRED_CREATE_VERSION`)
+- **FreeCAD base version:** `1.0.0` (via `FREECAD_VERSION`)
+- CMake policy settings for compatibility
+- ccache auto-detection
+- Submodule dependency checks
+- Library setup: yaml-cpp, fmt, ICU
+
+### Version injection
+
+The version flows from CMake to Python via `configure_file()`:
+
+```
+CMakeLists.txt (KINDRED_CREATE_VERSION = "0.1.0")
+    → src/Mod/Create/version.py.in (template)
+    → build/*/Mod/Create/version.py (generated)
+    → update_checker.py (imports VERSION)
+```
+
+## CMake presets
+
+Defined in `CMakePresets.json`:
+
+| Preset | Platform | Build type |
+|--------|----------|------------|
+| `conda-linux-debug` | Linux | Debug |
+| `conda-linux-release` | Linux | Release |
+| `conda-macos-debug` | macOS | Debug |
+| `conda-macos-release` | macOS | Release |
+| `conda-windows-debug` | Windows | Debug |
+| `conda-windows-release` | Windows | Release |
+
+All presets inherit from a hidden `common` base and a hidden `conda` base (Ninja generator, conda toolchain).
+
+## cMake/ helper modules
+
+The `cMake/` directory contains CMake helper macros inherited from FreeCAD:
+- **FreeCAD_Helpers** — macros for building FreeCAD modules
+- Platform detection modules
+- Dependency finding modules (Find*.cmake)
+
+## Dependencies
+
+Core dependencies managed by pixi (from `pixi.toml`):
+
+| Category | Packages |
+|----------|----------|
+| Build | cmake, ninja, swig, compilers (clang/gcc) |
+| CAD kernel | occt 7.8, coin3d, opencamlib, pythonocc-core |
+| UI | Qt6 6.8, PySide6, pyside6 |
+| Math | eigen, numpy, scipy, sympy |
+| Data | hdf5, vtk, smesh, ifcopenshell |
+| Python | 3.11 (< 3.12), pip, freecad-stubs |
+
+Platform-specific extras:
+- **Linux:** clang, kernel-headers, mesa, X11, libspnav
+- **macOS:** sed
+- **Windows:** pthreads-win32

docs/src/development/code-quality.md

@@ -0,0 +1,40 @@
+# Code Quality
+
+## Formatting and linting
+
+### C/C++
+
+- **Formatter:** clang-format (config in `.clang-format`)
+- **Static analysis:** clang-tidy (config in `.clang-tidy`)
+
+### Python
+
+- **Formatter:** black with 100-character line length
+- **Linter:** pylint (config in `.pylintrc`)
+
+## Pre-commit hooks
+
+The repository uses [pre-commit](https://pre-commit.com/) to run formatters and linters automatically on staged files:
+
+```bash
+pip install pre-commit
+pre-commit install
+```
+
+Configured hooks (`.pre-commit-config.yaml`):
+- `trailing-whitespace` — remove trailing whitespace
+- `end-of-file-fixer` — ensure files end with a newline
+- `check-yaml` — validate YAML syntax
+- `check-added-large-files` — prevent accidental large file commits
+- `mixed-line-ending` — normalize line endings
+- `black` — Python formatting (100 char lines)
+- `clang-format` — C/C++ formatting
+
+## Scope
+
+Pre-commit hooks are configured to run on specific directories:
+- `src/Base/`, `src/Gui/`, `src/Main/`, `src/Tools/`
+- `src/Mod/Assembly/`, `src/Mod/BIM/`, `src/Mod/CAM/`, `src/Mod/Draft/`, `src/Mod/Fem/`, and other stock modules
+- `tests/src/`
+
+Excluded: generated files, vendored libraries (`QSint/`, `Quarter/`, `3Dconnexion/navlib`), and binary formats.

docs/src/development/contributing.md

@@ -0,0 +1,52 @@
+# Contributing
+
+Kindred Create is maintained at [git.kindred-systems.com/kindred/create](https://git.kindred-systems.com/kindred/create). Contributions are submitted as pull requests against the `main` branch.
+
+## Getting started
+
+```bash
+git clone --recursive ssh://git@git.kindred-systems.com:2222/kindred/create.git
+cd create
+pixi run configure
+pixi run build
+pixi run freecad
+```
+
+See [Building from Source](../guide/building.md) for the full development setup.
+
+## Branch and PR workflow
+
+1. Create a feature branch from `main`:
+   ```bash
+   git checkout -b feat/my-feature main
+   ```
+2. Make your changes, commit with conventional commit messages (see below).
+3. Push and open a pull request against `main`.
+4. CI builds and tests run automatically on all PRs.
+
+## Commit messages
+
+Use [Conventional Commits](https://www.conventionalcommits.org/):
+
+| Prefix | Purpose |
+|--------|---------|
+| `feat:` | New feature |
+| `fix:` | Bug fix |
+| `chore:` | Maintenance, dependencies |
+| `docs:` | Documentation only |
+| `art:` | Icons, theme, visual assets |
+
+Scope is optional but encouraged:
+- `feat(ztools): add datum point creation mode`
+- `fix(gui): correct menu icon size on Wayland`
+- `chore: update silo submodule`
+
+## Reporting issues
+
+Report issues at the [issue tracker](https://git.kindred-systems.com/kindred/create/issues). When reporting:
+
+1. Note whether the issue involves Kindred Create additions (ztools, Silo, theme) or base FreeCAD
+2. Include version info from **Help > About FreeCAD > Copy to clipboard**
+3. Provide reproduction steps and attach example files (FCStd as ZIP) if applicable
+
+For base FreeCAD issues, also check the [FreeCAD issue tracker](https://github.com/FreeCAD/FreeCAD/issues).

docs/src/development/repo-structure.md

@@ -0,0 +1,73 @@
+# Repository Structure
+
+```
+create/
+├── src/
+│   ├── App/                    # Core application (C++)
+│   ├── Base/                   # Base classes (C++)
+│   ├── Gui/                    # GUI framework and stylesheets (C++)
+│   ├── Main/                   # Application entry points
+│   ├── Mod/                    # FreeCAD modules (~37)
+│   │   ├── Create/             # Kindred bootstrap module
+│   │   ├── Assembly/           # Assembly workbench (Kindred patches)
+│   │   ├── PartDesign/         # Part Design workbench
+│   │   ├── Sketcher/           # Sketcher workbench
+│   │   ├── AddonManager/       # Addon manager (submodule)
+│   │   └── ...                 # Other stock FreeCAD modules
+│   └── 3rdParty/
+│       ├── OndselSolver/       # Assembly solver (submodule)
+│       └── GSL/                # Guidelines Support Library (submodule)
+├── mods/                       # Kindred addon workbenches (submodules)
+│   ├── ztools/                 # ztools workbench
+│   └── silo/                   # Silo parts database
+├── kindred-icons/              # SVG icon library (~200 icons)
+├── resources/                  # Branding, desktop integration
+│   ├── branding/               # Logo, splash, icon generation scripts
+│   └── icons/                  # Platform icons (.ico, .icns, hicolor)
+├── package/                    # Packaging scripts
+│   ├── debian/                 # Debian package
+│   ├── ubuntu/                 # Ubuntu-specific
+│   ├── fedora/                 # RPM package
+│   ├── rattler-build/          # Cross-platform bundles (AppImage, DMG, NSIS)
+│   └── WindowsInstaller/       # NSIS installer definition
+├── .gitea/workflows/           # CI/CD pipelines
+│   ├── build.yml               # Build + test on push/PR
+│   └── release.yml             # Release on tag push
+├── tests/                      # Test suite
+│   ├── src/                    # C++ test sources
+│   └── lib/                    # Google Test framework (submodule)
+├── cMake/                      # CMake helper modules
+├── docs/                       # Documentation (this book)
+├── tools/                      # Dev utilities (build, lint, profile)
+├── contrib/                    # IDE configs (VSCode, CLion, debugger)
+├── data/                       # Example and test data
+├── CMakeLists.txt              # Root build configuration
+├── CMakePresets.json           # Platform build presets
+├── pixi.toml                  # Pixi environment and tasks
+├── CONTRIBUTING.md             # Contribution guide
+├── README.md                   # Project overview
+├── LICENSE                     # LGPL-2.1-or-later
+└── .pre-commit-config.yaml     # Code quality hooks
+```
+
+## Git submodules
+
+| Submodule | Path | Source | Purpose |
+|-----------|------|--------|---------|
+| ztools | `mods/ztools` | `git.kindred-systems.com/forbes/ztools` | Unified workbench |
+| silo-mod | `mods/silo` | `git.kindred-systems.com/kindred/silo-mod` | Parts database |
+| OndselSolver | `src/3rdParty/OndselSolver` | `git.kindred-systems.com/kindred/solver` | Assembly solver |
+| GSL | `src/3rdParty/GSL` | `github.com/microsoft/GSL` | C++ guidelines library |
+| AddonManager | `src/Mod/AddonManager` | `github.com/FreeCAD/AddonManager` | Extension manager |
+| googletest | `tests/lib` | `github.com/google/googletest` | Test framework |
+
+## Key files
+
+| File | Purpose |
+|------|---------|
+| `src/Mod/Create/Init.py` | Console-phase bootstrap — loads addons |
+| `src/Mod/Create/InitGui.py` | GUI-phase bootstrap — registers workbenches, deferred setup |
+| `src/Gui/FileOrigin.h` | Abstract file origin interface (Kindred addition) |
+| `src/Gui/Stylesheets/KindredCreate.qss` | Catppuccin Mocha theme |
+| `pixi.toml` | Build tasks and dependencies |
+| `CMakeLists.txt` | Root CMake configuration |

docs/src/guide/building.md

@@ -0,0 +1,107 @@
+# Building from Source
+
+## Prerequisites
+
+- **git** with submodule support
+- **[pixi](https://pixi.sh)** — conda-based dependency manager and task runner
+
+Pixi handles all other dependencies (CMake, compilers, Qt6, OpenCASCADE, etc.).
+
+## Clone
+
+```bash
+git clone --recursive ssh://git@git.kindred-systems.com:2222/kindred/create.git
+cd create
+```
+
+If cloned without `--recursive`:
+```bash
+git submodule update --init --recursive
+```
+
+The repository includes six submodules:
+
+| Submodule | Path | Source |
+|-----------|------|--------|
+| ztools | `mods/ztools` | `git.kindred-systems.com/forbes/ztools` |
+| silo-mod | `mods/silo` | `git.kindred-systems.com/kindred/silo-mod` |
+| OndselSolver | `src/3rdParty/OndselSolver` | `git.kindred-systems.com/kindred/solver` |
+| GSL | `src/3rdParty/GSL` | `github.com/microsoft/GSL` |
+| AddonManager | `src/Mod/AddonManager` | `github.com/FreeCAD/AddonManager` |
+| googletest | `tests/lib` | `github.com/google/googletest` |
+
+## Build
+
+```bash
+pixi run configure
+pixi run build
+pixi run install
+pixi run freecad
+```
+
+By default these target the **debug** configuration. For release builds:
+
+```bash
+pixi run configure-release
+pixi run build-release
+pixi run install-release
+pixi run freecad-release
+```
+
+## All pixi tasks
+
+| Task | Description |
+|------|-------------|
+| `initialize` | `git submodule update --init --recursive` |
+| `configure` | CMake configure (debug) |
+| `configure-debug` | CMake configure with debug preset |
+| `configure-release` | CMake configure with release preset |
+| `build` | Build (debug) |
+| `build-debug` | `cmake --build build/debug` |
+| `build-release` | `cmake --build build/release` |
+| `install` | Install (debug) |
+| `install-debug` | `cmake --install build/debug` |
+| `install-release` | `cmake --install build/release` |
+| `test` | Run tests (debug) |
+| `test-debug` | `ctest --test-dir build/debug` |
+| `test-release` | `ctest --test-dir build/release` |
+| `freecad` | Launch FreeCAD (debug) |
+| `freecad-debug` | `build/debug/bin/FreeCAD` |
+| `freecad-release` | `build/release/bin/FreeCAD` |
+
+## CMake presets
+
+The project provides presets in `CMakePresets.json` for each platform and build type:
+
+- `conda-linux-debug` / `conda-linux-release`
+- `conda-macos-debug` / `conda-macos-release`
+- `conda-windows-debug` / `conda-windows-release`
+
+All presets inherit from a `common` base that enables `CMAKE_EXPORT_COMPILE_COMMANDS` and configures job pools. The `conda` presets use the Ninja generator and pick up compiler paths from the pixi environment.
+
+## Platform notes
+
+**Linux:** Uses clang from conda-forge. Requires kernel-headers, mesa, X11, and libspnav (all provided by pixi). Uses the mold linker for faster link times.
+
+**macOS:** Minimal extra dependencies — pixi provides nearly everything. Tested on both Intel and Apple Silicon.
+
+**Windows:** Requires pthreads-win32 and MSVC. The conda preset configures the MSVC toolchain automatically when run inside a pixi shell.
+
+## Caching
+
+The build uses **ccache** for compilation caching:
+- Maximum cache size: 4 GB
+- Compression: zlib level 6
+- Sloppiness mode enabled for faster cache hits
+
+ccache is auto-detected by CMake at configure time.
+
+## Common problems
+
+**Submodules not initialized:** If you see missing file errors for ztools or Silo, run `pixi run initialize` or `git submodule update --init --recursive`.
+
+**Pixi not found:** Install pixi from <https://pixi.sh>.
+
+**ccache full:** Clear with `ccache -C` or increase the limit in your ccache config.
+
+**Preset not found:** Ensure you are running CMake from within a pixi shell (`pixi shell`) so that conda environment variables are set.

docs/src/guide/getting-started.md

@@ -0,0 +1,41 @@
+# Getting Started
+
+Kindred Create can be installed from prebuilt packages or built from source. This section covers both paths.
+
+## Quick start (prebuilt)
+
+Download the latest release from the [releases page](https://git.kindred-systems.com/kindred/create/releases).
+
+**Debian/Ubuntu:**
+```bash
+sudo apt install ./kindred-create_*.deb
+```
+
+**AppImage:**
+```bash
+chmod +x KindredCreate-*.AppImage
+./KindredCreate-*.AppImage
+```
+
+## Quick start (from source)
+
+```bash
+git clone --recursive ssh://git@git.kindred-systems.com:2222/kindred/create.git
+cd create
+pixi run configure
+pixi run build
+pixi run freecad
+```
+
+See [Installation](./installation.md) for prebuilt package details and [Building from Source](./building.md) for the full development setup.
+
+## First run
+
+On first launch, Kindred Create:
+
+1. Loads the **ztools** and **Silo** workbenches automatically via the Create bootstrap module
+2. Opens the **ZToolsWorkbench** as the default workbench
+3. Prompts for Silo server configuration if not yet set up
+4. Checks for application updates in the background (after ~10 seconds)
+
+If the Silo server is not available, Kindred Create operates normally with local file operations. The Silo features activate once a server is configured.

docs/src/guide/installation.md

@@ -0,0 +1,49 @@
+# Installation
+
+## Prebuilt packages
+
+Download the latest release from the [releases page](https://git.kindred-systems.com/kindred/create/releases).
+
+### Debian / Ubuntu
+
+```bash
+sudo apt install ./kindred-create_*.deb
+```
+
+### AppImage (any Linux)
+
+```bash
+chmod +x KindredCreate-*.AppImage
+./KindredCreate-*.AppImage
+```
+
+The AppImage is a self-contained bundle using squashfs with zstd compression. No installation required.
+
+### macOS
+
+> macOS builds are planned but not yet available in CI. Build from source for now.
+
+### Windows
+
+> Windows builds are planned but not yet available in CI. Build from source for now.
+
+## Verifying your installation
+
+Launch Kindred Create and check the console output (View > Report View) for:
+
+```
+Create: Loaded ztools Init.py
+Create: Loaded silo Init.py
+Create module initialized
+```
+
+This confirms the bootstrap module loaded both workbenches. If Silo is not configured, you will see a settings prompt on first launch.
+
+## Uninstalling
+
+**Debian/Ubuntu:**
+```bash
+sudo apt remove kindred-create
+```
+
+**AppImage:** Delete the `.AppImage` file. No system files are modified.

docs/src/guide/silo.md

@@ -0,0 +1,204 @@
+# Silo
+
+Silo is an item database and part management system for Kindred Create. It provides revision-controlled storage for CAD files, configurable part number generation, BOM management, and team collaboration.
+
+- **Submodule path:** `mods/silo/`
+- **Source:** `git.kindred-systems.com/kindred/silo-mod`
+
+## Architecture
+
+Silo has three components:
+
+```
+┌──────────────────────┐     ┌──────────────┐
+│  FreeCAD Workbench   │────▶│  Go REST API  │
+│  (Python commands)   │     │  (silod)      │
+└──────────────────────┘     └──────┬───────┘
+         │                          │
+         │  silo-client             │
+         │  (shared API lib)        │
+         │                    ┌─────┴─────┐
+         │                    │           │
+         │               PostgreSQL    MinIO
+         │               (metadata)  (files)
+         │
+    Local .FCStd files
+```
+
+- **Go REST API server** (`cmd/silod/`) — 38+ routes, backed by PostgreSQL and MinIO
+- **FreeCAD workbench** (`freecad/`) — Python commands integrated into Kindred Create
+- **Shared API client** (`silo-client/`) — Python library used by the workbench (nested submodule)
+
+The silo-mod repository was split from a monorepo into three repos: `silo-client` (shared Python API client), `silo-mod` (FreeCAD workbench), and `silo-calc` (LibreOffice Calc extension).
+
+## Workbench commands
+
+### Document lifecycle
+
+| Command | Shortcut | Description |
+|---------|----------|-------------|
+| `Silo_New` | Ctrl+N | Register a new part — select category, generate part number from schema, optional project tagging |
+| `Silo_Open` | Ctrl+O | Search and open items — combined dialog querying both the database and local files |
+| `Silo_Save` | Ctrl+S | Save locally to canonical path, collect document properties, upload to MinIO as auto-revision |
+| `Silo_Commit` | Ctrl+Shift+S | Save as a new revision with a user-provided comment |
+| `Silo_Pull` | — | Download from MinIO with revision selection, conflict detection, and progress tracking |
+| `Silo_Push` | — | Batch upload — finds local files not yet synced to the server, compares timestamps |
+
+### Information and management
+
+| Command | Description |
+|---------|-------------|
+| `Silo_Info` | Show item metadata, project tags, and revision history table with status and labels |
+| `Silo_BOM` | Two-tab view: BOM (children) and Where Used (parents). Add, edit, remove entries with quantity and unit tracking |
+| `Silo_TagProjects` | Multi-select dialog for assigning project tags to items |
+| `Silo_Rollback` | Select a previous revision and create a new revision from that point with optional comment |
+| `Silo_SetStatus` | Change revision lifecycle status: draft → review → released → obsolete |
+
+### Administration
+
+| Command | Description |
+|---------|-------------|
+| `Silo_Settings` | Full settings UI — API URL, SSL verify, custom CA cert, API token management, authentication status |
+| `Silo_Auth` | Session-based login: `/login` → `/api/auth/me` → `/api/auth/tokens`; stores API token in preferences |
+| `Silo_ToggleMode` | Switch between Silo workbench and other workbenches (menu only) |
+
+## Origin integration
+
+Silo registers as a **file origin** via the `FileOrigin` interface in `src/Gui/`. The `SiloOrigin` class in `silo_origin.py` implements:
+
+| Capability | Value |
+|------------|-------|
+| `id` | `"silo"` |
+| `name` | `"Kindred Silo"` |
+| `type` | PLM (1) |
+| `tracksExternally` | true |
+| `requiresAuthentication` | true |
+| `supportsRevisions` | true |
+| `supportsBOM` | true |
+| `supportsPartNumbers` | true |
+| `supportsAssemblies` | true |
+
+The origin delegates to the workbench commands for all operations (new, open, save, commit, pull, push, info, BOM). Registration happens via a deferred QTimer (1500ms after startup) in `src/Mod/Create/InitGui.py`.
+
+## Configuration
+
+### FreeCAD parameters
+
+Stored in `User parameter:BaseApp/Preferences/Mod/KindredSilo`:
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `ApiUrl` | String | (empty) | Silo server URL |
+| `SslVerify` | Bool | true | Verify SSL certificates |
+| `CaCertPath` | String | (empty) | Path to custom CA certificate |
+| `ApiToken` | String | (empty) | Stored authentication token |
+| `FirstStartChecked` | Bool | false | Whether first-start prompt has been shown |
+| `ProjectsDir` | String | `~/projects` | Local directory for checked-out files |
+
+### Environment variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SILO_API_URL` | `http://localhost:8080/api` | Override for server API endpoint |
+| `SILO_PROJECTS_DIR` | `~/projects` | Override for local projects directory |
+
+## Server setup
+
+### Quick start
+
+```bash
+# Database setup (apply migrations sequentially)
+psql -h psql.kindred.internal -U silo -d silo -f migrations/001_initial.sql
+# ... through 010_item_extended_fields.sql
+
+# Configure
+cp config.example.yaml config.yaml
+# Edit config.yaml with your database, MinIO, and auth settings
+
+# Run server
+go run ./cmd/silod
+```
+
+### Production deployment
+
+Production configs live in `mods/silo/deployments/`:
+
+```
+deployments/
+├── config.prod.yaml              # Database, MinIO, auth settings
+├── docker-compose.prod.yaml      # Production container orchestration
+├── docker-compose.yaml           # Development Docker Compose
+└── systemd/
+    ├── silod.env.example         # Service environment template
+    └── silod.service             # systemd unit file
+```
+
+The systemd service runs as user `silo` with security hardening (`ProtectSystem=strict`, `NoNewPrivileges`, `PrivateTmp`). Config at `/etc/silo/config.yaml`, binary at `/opt/silo/bin/silod`.
+
+### Server stack
+
+- **Go** REST API with 38+ routes
+- **PostgreSQL** for metadata, revisions, BOM relationships
+- **MinIO** (S3-compatible) for binary `.FCStd` file storage
+- **LDAP / OIDC** for authentication
+- **SSE** (Server-Sent Events) for real-time activity feed
+
+## Database migrations
+
+Migrations live in `mods/silo/migrations/` as numbered SQL scripts:
+
+| Migration | Purpose |
+|-----------|---------|
+| `001_initial.sql` | Core schema — items, revisions, properties |
+| `002_sequence_by_name.sql` | Part number sequence generation |
+| `003_remove_material.sql` | Property cleanup |
+| `004_cad_sync_state.sql` | CAD file sync tracking |
+| `005_property_schema_version.sql` | Schema versioning for properties |
+| `006_project_tags.sql` | Project-to-item relationships |
+| `007_revision_status.sql` | Revision lifecycle status tracking |
+| `008_odoo_integration.sql` | ERP integration preparation |
+| `009_auth.sql` | User authentication tables |
+| `010_item_extended_fields.sql` | Extended item metadata |
+
+Apply sequentially: `psql -f migrations/001_initial.sql`, then `002`, etc. There is no automated migration runner — apply manually against the database.
+
+## Part numbering schemas
+
+Part number generation is configured via YAML schemas in `mods/silo/schemas/`:
+
+- `kindred-rd.yaml` — Primary R&D part numbering schema with category codes, sequence segments, and validation rules
+- `kindred-locations.yaml` — Location hierarchy schema for physical inventory tracking
+
+## Directory structure
+
+```
+mods/silo/
+├── cmd/
+│   ├── silo/                  # CLI tool
+│   └── silod/                 # API server
+├── internal/
+│   ├── api/                   # HTTP handlers, routes, templates
+│   ├── config/                # Configuration loading
+│   ├── db/                    # PostgreSQL access
+│   ├── migration/             # Property migration utilities
+│   ├── partnum/               # Part number generation
+│   ├── schema/                # YAML schema parsing
+│   └── storage/               # MinIO file storage
+├── freecad/
+│   ├── InitGui.py             # SiloWorkbench registration
+│   ├── silo_commands.py       # 14 commands + dock widgets
+│   ├── silo_origin.py         # FileOrigin backend
+│   └── resources/icons/       # 10 silo-*.svg icons
+├── silo-client/               # Shared Python API client (nested submodule)
+│   └── silo_client/
+│       ├── client.py          # SiloClient HTTP wrapper
+│       └── settings.py        # SiloSettings config management
+├── migrations/                # 10 numbered SQL scripts
+├── schemas/                   # Part numbering YAML schemas
+└── deployments/               # Docker Compose + systemd configs
+```
+
+## Further reading
+
+- `mods/silo/README.md` — server quickstart and CLI usage
+- `mods/silo/ROADMAP.md` — strategic roadmap (6 phases, Q2 2026 → Q4 2027)

docs/src/guide/workbenches.md

@@ -0,0 +1,23 @@
+# Workbenches
+
+Kindred Create ships two custom workbenches on top of FreeCAD's standard set.
+
+## ztools
+
+A unified workbench that consolidates part design, assembly, and sketcher tools into a single interface. It is the **default workbench** when Kindred Create launches.
+
+ztools commands are also injected into the PartDesign workbench menus and toolbars via a manipulator mechanism, so they are accessible even when working in stock PartDesign.
+
+See the [ztools guide](./ztools.md) for details.
+
+## Silo
+
+A parts database workbench for managing CAD files, part numbers, revisions, and bills of materials across teams. Silo commands (New, Open, Save, Commit, Pull, Push, Info, BOM) are integrated into the File menu and toolbar across **all** workbenches via the origin system.
+
+Silo requires a running server instance. On first launch, Kindred Create prompts for server configuration.
+
+See the [Silo guide](./silo.md) for details.
+
+## Stock FreeCAD workbenches
+
+All standard FreeCAD workbenches are available: PartDesign, Sketcher, Assembly, TechDraw, Draft, BIM, CAM, FEM, Mesh, Spreadsheet, and others. Kindred Create does not remove or disable any stock functionality.

docs/src/guide/ztools.md

@@ -0,0 +1,133 @@
+# ztools
+
+ztools is a pure-Python FreeCAD workbench that consolidates part design, assembly, and sketcher tools into a single unified interface. It is the **default workbench** when Kindred Create launches.
+
+- **Submodule path:** `mods/ztools/`
+- **Source:** `git.kindred-systems.com/forbes/ztools`
+- **Stats:** 6,400+ lines of code, 24+ command classes, 33 custom icons, 17 toolbars
+
+## Commands
+
+### Datum Creator (`ZTools_DatumCreator`)
+
+Creates datum geometry (planes, axes, points) with 16 creation modes. The task panel auto-detects the geometry type from your selection and offers appropriate modes. Supports custom naming, spreadsheet linking, and body- or document-level creation.
+
+### Datum Manager (`ZTools_DatumManager`)
+
+Manages existing datums. (Stub — planned for Phase 1, Q1 2026.)
+
+### Enhanced Pocket (`ZTools_EnhancedPocket`)
+
+Extends FreeCAD's Pocket feature with **Flip Side to Cut** — a SOLIDWORKS-style feature that removes material *outside* the sketch profile rather than inside. Uses a Boolean Common operation internally. Supports all standard pocket types: Dimension, Through All, To First, Up To Face, Two Dimensions. Taper angle is supported for standard pockets (disabled for flipped).
+
+### Rotated Linear Pattern (`ZTools_RotatedLinearPattern`)
+
+Creates a linear pattern with incremental rotation per instance. Configure direction, spacing, number of occurrences, and cumulative or per-instance rotation. Source components are automatically hidden.
+
+### Assembly Linear Pattern (`ZTools_AssemblyLinearPattern`)
+
+Creates linear patterns of assembly components. Supports multi-component selection, direction vectors, total length or spacing modes, and creation as Links (recommended) or copies. Auto-detects the parent assembly.
+
+### Assembly Polar Pattern (`ZTools_AssemblyPolarPattern`)
+
+Creates polar (circular) patterns of assembly components. Supports custom or preset axes (X/Y/Z), full circle or custom angle, center point definition, and creation as Links or copies.
+
+### Spreadsheet Formatting (9 commands)
+
+| Command | Action |
+|---------|--------|
+| `ZTools_SpreadsheetStyleBold` | Toggle bold |
+| `ZTools_SpreadsheetStyleItalic` | Toggle italic |
+| `ZTools_SpreadsheetStyleUnderline` | Toggle underline |
+| `ZTools_SpreadsheetAlignLeft` | Left align |
+| `ZTools_SpreadsheetAlignCenter` | Center align |
+| `ZTools_SpreadsheetAlignRight` | Right align |
+| `ZTools_SpreadsheetBgColor` | Background color picker |
+| `ZTools_SpreadsheetTextColor` | Text color picker |
+| `ZTools_SpreadsheetQuickAlias` | Auto-create aliases from row/column labels |
+
+## Datum creation modes
+
+### Planes (7 modes)
+
+| Mode | Description | Input |
+|------|-------------|-------|
+| Offset from Face | Offsets a planar face along its normal | Face + distance (mm) |
+| Offset from Plane | Offsets an existing datum plane | Datum plane + distance (mm) |
+| Midplane | Plane halfway between two parallel faces | Two parallel faces |
+| 3 Points | Plane through three non-collinear points | Three vertices |
+| Normal to Edge | Plane perpendicular to an edge at a parameter location | Edge + parameter (0.0–1.0) |
+| Angled | Rotates a plane about an edge by a specified angle | Face + edge + angle (degrees) |
+| Tangent to Cylinder | Plane tangent to a cylindrical face at an angular position | Cylindrical face + angle (degrees) |
+
+### Axes (4 modes)
+
+| Mode | Description | Input |
+|------|-------------|-------|
+| 2 Points | Axis through two points | Two vertices |
+| From Edge | Axis along a linear edge | Linear edge |
+| Cylinder Center | Axis along the centerline of a cylinder | Cylindrical face |
+| Plane Intersection | Axis at the intersection of two planes | Two non-parallel planes |
+
+### Points (5 modes)
+
+| Mode | Description | Input |
+|------|-------------|-------|
+| At Vertex | Point at a vertex location | Vertex |
+| XYZ Coordinates | Point at explicit coordinates | x, y, z (mm) |
+| On Edge | Point at a location along an edge | Edge + parameter (0.0–1.0) |
+| Face Center | Point at the center of mass of a face | Face |
+| Circle Center | Point at the center of a circular or arc edge | Circular edge |
+
+## PartDesign injection
+
+ztools registers a `_ZToolsPartDesignManipulator` that hooks into the PartDesign workbench at startup. This injects the following commands into PartDesign's toolbars and menus:
+
+| PartDesign toolbar | Injected command |
+|--------------------|-----------------|
+| Part Design Helper Features | `ZTools_DatumCreator`, `ZTools_DatumManager` |
+| Part Design Modeling Features | `ZTools_EnhancedPocket` |
+| Part Design Transformation Features | `ZTools_RotatedLinearPattern` |
+
+The manipulator is registered in `InitGui.py` when the Create bootstrap module loads addon workbenches.
+
+## Directory structure
+
+```
+mods/ztools/
+├── ztools/ztools/
+│   ├── InitGui.py              # Workbench registration + manipulator
+│   ├── Init.py                 # Console initialization
+│   ├── commands/
+│   │   ├── datum_commands.py       # DatumCreator + DatumManager
+│   │   ├── datum_viewprovider.py   # ViewProvider + edit panel
+│   │   ├── pocket_commands.py      # EnhancedPocket + FlippedPocket
+│   │   ├── pattern_commands.py     # RotatedLinearPattern
+│   │   ├── assembly_pattern_commands.py  # Linear + Polar assembly patterns
+│   │   └── spreadsheet_commands.py      # 9 formatting commands
+│   ├── datums/
+│   │   └── core.py             # 16 datum creation functions
+│   └── resources/              # Icons and theme
+└── CatppuccinMocha/            # Theme preference pack
+```
+
+## Internal properties
+
+ztools stores metadata on feature objects using these properties (preserved for backward compatibility):
+
+| Property | Purpose |
+|----------|---------|
+| `ZTools_Type` | Feature type identifier |
+| `ZTools_Params` | JSON creation parameters |
+| `ZTools_SourceRefs` | JSON source geometry references |
+
+## Known gaps
+
+- Datum Manager is a stub — full implementation planned for Q1 2026
+- Datum parameter changes don't recalculate from source geometry yet
+- Enhanced Pocket taper angle is disabled for flipped pockets
+
+## Further reading
+
+- `mods/ztools/KINDRED_INTEGRATION.md` — integration architecture and migration options
+- `mods/ztools/ROADMAP.md` — phased development plan (Q1–Q4 2026)

docs/src/introduction.md

@@ -0,0 +1,37 @@
+# Kindred Create
+
+Kindred Create is a fork of [FreeCAD](https://www.freecad.org) 1.0+ that adds integrated tooling for professional engineering workflows. It ships custom workbenches and a dark theme on top of FreeCAD's parametric modeling core.
+
+- **License:** LGPL 2.1+
+- **Organization:** [Kindred Systems LLC](https://www.kindred-systems.com)
+- **Build system:** CMake + [pixi](https://pixi.sh)
+- **Current version:** Kindred Create v0.1.0 (FreeCAD base v1.0.0)
+
+## Key features
+
+**[ztools](./guide/ztools.md)** — A unified workbench that consolidates part design, assembly, and sketcher tools into a single interface. Adds custom datum creation (planes, axes, points with 16 creation modes), pattern tools for assemblies, an enhanced pocket with flip-side cutting, and spreadsheet formatting commands.
+
+**[Silo](./guide/silo.md)** — A parts database system for managing CAD files, part numbers, revisions, and bills of materials across teams. Includes a Go REST API server backed by PostgreSQL and MinIO, with FreeCAD commands for opening, saving, and syncing files directly from the application.
+
+**Catppuccin Mocha theme** — A dark theme applied across the entire application, including the 3D viewport, sketch editor, spreadsheet view, and tree view. Uses spanning-line branch indicators instead of disclosure arrows, with tuned preference defaults for document handling, selection behavior, and notifications.
+
+**Origin system** — A pluggable file backend abstraction. The origin selector in the File toolbar lets you switch between local filesystem operations and Silo database operations. Silo commands (Commit, Pull, Push, Info, BOM) are available across all workbenches when Silo is the active origin.
+
+**Update checker** — On startup, Kindred Create checks the Gitea releases API for newer versions and logs the result. Configurable check interval and skip-version preferences.
+
+## How it relates to FreeCAD
+
+Kindred Create is a fork/distribution of FreeCAD 1.0+. The design minimizes core modifications — custom functionality is delivered through submodule addons (ztools, Silo) that follow FreeCAD's standard workbench pattern. If the addon submodules are missing, Kindred Create still functions as a themed FreeCAD.
+
+The primary additions to FreeCAD's core are:
+- The **origin system** (`FileOrigin` interface in `src/Gui/`) for pluggable file backends
+- The **Create bootstrap module** (`src/Mod/Create/`) that loads addons at startup
+- The **Catppuccin Mocha theme** (`KindredCreate.qss`) and preference pack
+- Patches to **Assembly** (`findPlacement()` datum/origin handling)
+
+## Links
+
+- **Source:** <https://git.kindred-systems.com/kindred/create>
+- **Downloads:** <https://git.kindred-systems.com/kindred/create/releases>
+- **Issue tracker:** <https://git.kindred-systems.com/kindred/create/issues>
+- **Website:** <https://www.kindred-systems.com/create>

docs/src/reference/configuration.md

@@ -0,0 +1,117 @@
+# Configuration
+
+## Silo workbench
+
+### FreeCAD parameters
+
+Stored in `User parameter:BaseApp/Preferences/Mod/KindredSilo`:
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `ApiUrl` | String | (empty) | Silo server API endpoint URL |
+| `SslVerify` | Bool | true | Verify SSL certificates when connecting to server |
+| `CaCertPath` | String | (empty) | Path to custom CA certificate for self-signed certs |
+| `ApiToken` | String | (empty) | Stored authentication token (set by `Silo_Auth`) |
+| `FirstStartChecked` | Bool | false | Whether the first-start settings prompt has been shown |
+| `ProjectsDir` | String | `~/projects` | Local directory for checked-out CAD files |
+
+### Environment variables
+
+These override the FreeCAD parameter values when set:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SILO_API_URL` | `http://localhost:8080/api` | Silo server API endpoint |
+| `SILO_PROJECTS_DIR` | `~/projects` | Local directory for checked-out files |
+
+### Keyboard shortcuts
+
+Recommended shortcuts (prompted on first workbench activation):
+
+| Shortcut | Command |
+|----------|---------|
+| Ctrl+O | `Silo_Open` — Search and open items |
+| Ctrl+N | `Silo_New` — Create new item |
+| Ctrl+S | `Silo_Save` — Save locally and upload |
+| Ctrl+Shift+S | `Silo_Commit` — Save with revision comment |
+
+## Update checker
+
+Stored in `User parameter:BaseApp/Preferences/Mod/KindredCreate/Update`:
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `CheckEnabled` | Bool | true | Enable or disable update checks |
+| `CheckIntervalDays` | Int | 1 | Minimum days between checks |
+| `LastCheckTimestamp` | String | (empty) | ISO 8601 timestamp of last successful check |
+| `SkippedVersion` | String | (empty) | Version the user chose to skip |
+
+The checker queries:
+```
+https://git.kindred-systems.com/api/v1/repos/kindred/create/releases?limit=10
+```
+
+It compares the current version (injected at build time via `version.py.in`) against the latest non-draft, non-prerelease tag. The `latest` rolling tag is ignored. Checks run 10 seconds after GUI startup.
+
+To disable: set `CheckEnabled` to `false` in FreeCAD preferences, or set `CheckIntervalDays` to `0` for on-demand only.
+
+## Theme
+
+The default theme is **Catppuccin Mocha** applied via `KindredCreate.qss`.
+
+| Setting | Location |
+|---------|----------|
+| Canonical stylesheet | `src/Gui/Stylesheets/KindredCreate.qss` |
+| Preference pack | `src/Gui/PreferencePacks/KindredCreate/` |
+| Default theme name | `coal` (in mdBook docs) / `KindredCreate` (in app) |
+
+To switch themes: **Edit > Preferences > General > Stylesheet** and select a different `.qss` file.
+
+The preference pack is synced from the canonical stylesheet at build time via CMake's `configure_file()`. Edits should be made to the canonical file, not the preference pack copy.
+
+## Build configuration
+
+### Version constants
+
+Defined in the root `CMakeLists.txt`:
+
+| Constant | Value | Description |
+|----------|-------|-------------|
+| `KINDRED_CREATE_VERSION` | `0.1.0` | Kindred Create version |
+| `FREECAD_VERSION` | `1.0.0` | FreeCAD base version |
+
+These are injected into `src/Mod/Create/version.py` at build time via `version.py.in`.
+
+### CMake presets
+
+Defined in `CMakePresets.json`:
+
+| Preset | Platform | Build type |
+|--------|----------|------------|
+| `conda-linux-debug` | Linux | Debug |
+| `conda-linux-release` | Linux | Release |
+| `conda-macos-debug` | macOS | Debug |
+| `conda-macos-release` | macOS | Release |
+| `conda-windows-debug` | Windows | Debug |
+| `conda-windows-release` | Windows | Release |
+
+### ccache
+
+| Setting | Value |
+|---------|-------|
+| Max size | 4 GB |
+| Compression | zlib level 6 |
+| Sloppiness | `include_file_ctime,include_file_mtime,pch_defines,time_macros` |
+
+ccache is auto-detected by CMake at configure time. Clear with `ccache -C`.
+
+## Silo server
+
+Server configuration is defined in YAML. See `mods/silo/deployments/config.prod.yaml` for production settings and `mods/silo/config.example.yaml` for all available options.
+
+Key sections:
+- **database** — PostgreSQL connection string
+- **storage** — MinIO endpoint, bucket, access keys
+- **auth** — LDAP/OIDC provider settings
+- **server** — Listen address, TLS, CORS
+- **schemas** — Path to part numbering YAML schemas

docs/src/reference/glossary.md

@@ -0,0 +1,53 @@
+# Glossary
+
+## Terms
+
+**BOM** — Bill of Materials. A structured list of components in an assembly with part numbers, quantities, and reference designators.
+
+**Catppuccin Mocha** — A dark color palette used for Kindred Create's theme. Part of the [Catppuccin](https://github.com/catppuccin/catppuccin) color scheme family.
+
+**Datum** — Reference geometry (plane, axis, or point) used as a construction aid for modeling. Not a physical shape — used to position features relative to abstract references.
+
+**FCStd** — FreeCAD's standard document format. A ZIP archive containing XML model trees, BREP geometry, thumbnails, and embedded data.
+
+**FileOrigin** — Abstract C++ interface in `src/Gui/` that defines a pluggable file backend. Implementations: `LocalFileOrigin` (filesystem) and `SiloOrigin` (database).
+
+**FreeCAD** — Open-source parametric 3D CAD platform. Kindred Create is based on FreeCAD v1.0.0. Website: <https://www.freecad.org>
+
+**Kindred Create** — The full application: a FreeCAD fork plus Kindred's addon workbenches, theme, and tooling.
+
+**Manipulator** — FreeCAD mechanism for injecting commands from one workbench into another's menus and toolbars. Used by ztools to add commands to PartDesign.
+
+**MinIO** — S3-compatible object storage server. Used by Silo to store binary `.FCStd` files.
+
+**OndselSolver** — Lagrangian constraint solver for the Assembly workbench. Vendored as a submodule from a Kindred fork.
+
+**Origin** — In Kindred Create context: the pluggable file backend system. In FreeCAD context: the coordinate system origin (X/Y/Z axes and planes) of a Part or Body.
+
+**pixi** — Conda-based dependency manager and task runner. Used for all build operations. Website: <https://pixi.sh>
+
+**Preference pack** — FreeCAD mechanism for bundling theme settings, preferences, and stylesheets into an installable package.
+
+**QSS** — Qt Style Sheet. A CSS-like language for styling Qt widgets. Kindred Create's theme is defined in `KindredCreate.qss`.
+
+**rattler-build** — Cross-platform package build tool from the conda ecosystem. Used to create AppImage, DMG, and NSIS installer bundles.
+
+**Silo** — Kindred's parts database system. Consists of a Go server, FreeCAD workbench, and shared Python client library.
+
+**SSE** — Server-Sent Events. HTTP-based protocol for real-time server-to-client notifications. Used by Silo for the activity feed.
+
+**Workbench** — FreeCAD's plugin/module system. Each workbench provides a set of tools, menus, and toolbars for a specific task domain.
+
+**ztools** — Kindred's unified workbench combining Part Design, Assembly, and Sketcher tools with custom datum creation and assembly patterns.
+
+## Repository URLs
+
+| Repository | URL |
+|------------|-----|
+| Kindred Create | <https://git.kindred-systems.com/kindred/create> |
+| ztools | <https://git.kindred-systems.com/forbes/ztools> |
+| silo-mod | <https://git.kindred-systems.com/kindred/silo-mod> |
+| OndselSolver | <https://git.kindred-systems.com/kindred/solver> |
+| GSL | <https://github.com/microsoft/GSL> |
+| AddonManager | <https://github.com/FreeCAD/AddonManager> |
+| googletest | <https://github.com/google/googletest> |

docs/theme/kindred.css

@@ -0,0 +1,8 @@
+/* Kindred Create docs - minor overrides for coal theme */
+:root {
+    --sidebar-width: 280px;
+}
+
+.sidebar .sidebar-scrollbox {
+    padding: 10px 15px;
+}

package/debian/build-deb.sh

@@ -112,6 +112,10 @@ export XKB_CONFIG_ROOT="${KINDRED_CREATE_HOME}/share/X11/xkb"
 export FONTCONFIG_FILE="${KINDRED_CREATE_HOME}/etc/fonts/fonts.conf"
 export FONTCONFIG_PATH="${KINDRED_CREATE_HOME}/etc/fonts"
 
+# Qt Wayland fractional scaling — force integer rounding to avoid blurry text
+export QT_SCALE_FACTOR_ROUNDING_POLICY=RoundPreferFloor
+export QT_ENABLE_HIGHDPI_SCALING=1
+
 # Use system CA certificates so bundled Python trusts internal CAs (e.g. FreeIPA)
 # The bundled openssl has a hardcoded cafile from the build environment which
 # does not exist on the target system.

package/rattler-build/linux/AppDir/AppRun

@@ -9,8 +9,9 @@ export PATH_TO_FREECAD_LIBDIR=${HERE}/usr/lib
 export FONTCONFIG_FILE=/etc/fonts/fonts.conf
 export FONTCONFIG_PATH=/etc/fonts
 
-# Fix: Use X to run on Wayland
-export QT_QPA_PLATFORM=xcb
+# Qt HiDPI scaling — force integer rounding to avoid blurry text on fractional scales
+export QT_SCALE_FACTOR_ROUNDING_POLICY=RoundPreferFloor
+export QT_ENABLE_HIGHDPI_SCALING=1
 
 # Show packages info if DEBUG env variable is set
 if [ "$DEBUG" = 1 ]; then

package/rattler-build/recipe.yaml

@@ -25,6 +25,10 @@ requirements:
     - qt6-main>=6.8,<6.9
     - swig >=4.0,<4.4
 
+    - if: linux
+      then:
+        - patchelf
+
     - if: linux and x86_64
       then:
         - clang

resources/preferences/KindredCreate/KindredCreate.cfg

@@ -1,112 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
-<FCParameters>
-  <FCParamGroup Name="Root">
-    <FCParamGroup Name="BaseApp">
-      <FCParamGroup Name="Preferences">
-        <FCParamGroup Name="Editor">
-          <FCUInt Name="Text" Value="3453416703"/>
-          <FCUInt Name="Bookmark" Value="3032415999"/>
-          <FCUInt Name="Breakpoint" Value="4086016255"/>
-          <FCUInt Name="Keyword" Value="3416717311"/>
-          <FCUInt Name="Comment" Value="2139095295"/>
-          <FCUInt Name="Block comment" Value="2139095295"/>
-          <FCUInt Name="Number" Value="4206069759"/>
-          <FCUInt Name="String" Value="2799935999"/>
-          <FCUInt Name="Character" Value="4073902335"/>
-          <FCUInt Name="Class name" Value="2310339327"/>
-          <FCUInt Name="Define name" Value="2310339327"/>
-          <FCUInt Name="Operator" Value="2312199935"/>
-          <FCUInt Name="Python output" Value="2796290303"/>
-          <FCUInt Name="Python error" Value="4086016255"/>
-          <FCUInt Name="Current line highlight" Value="1162304255"/>
-        </FCParamGroup>
-        <FCParamGroup Name="OutputWindow">
-          <FCUInt Name="colorText" Value="3453416703"/>
-          <FCUInt Name="colorLogging" Value="2497893887"/>
-          <FCUInt Name="colorWarning" Value="4192382975"/>
-          <FCUInt Name="colorError" Value="4086016255"/>
-        </FCParamGroup>
-        <FCParamGroup Name="View">
-          <FCUInt Name="BackgroundColor" Value="505294591"/>
-          <FCUInt Name="BackgroundColor2" Value="286333951"/>
-          <FCUInt Name="BackgroundColor3" Value="404235775"/>
-          <FCUInt Name="BackgroundColor4" Value="825378047"/>
-          <FCBool Name="Simple" Value="0"/>
-          <FCBool Name="Gradient" Value="1"/>
-          <FCBool Name="UseBackgroundColorMid" Value="0"/>
-          <FCUInt Name="HighlightColor" Value="3416717311"/>
-          <FCUInt Name="SelectionColor" Value="3032415999"/>
-          <FCUInt Name="PreselectColor" Value="2497893887"/>
-          <FCUInt Name="DefaultShapeColor" Value="1482387711"/>
-          <FCBool Name="RandomColor" Value="0"/>
-          <FCUInt Name="DefaultShapeLineColor" Value="2470768383"/>
-          <FCUInt Name="DefaultShapeVertexColor" Value="2470768383"/>
-          <FCUInt Name="BoundingBoxColor" Value="1819509759"/>
-          <FCUInt Name="AnnotationTextColor" Value="3453416703"/>
-          <FCUInt Name="SketchEdgeColor" Value="3453416703"/>
-          <FCUInt Name="SketchVertexColor" Value="3453416703"/>
-          <FCUInt Name="EditedEdgeColor" Value="3416717311"/>
-          <FCUInt Name="EditedVertexColor" Value="4123402495"/>
-          <FCUInt Name="ConstructionColor" Value="4206069759"/>
-          <FCUInt Name="ExternalColor" Value="4192382975"/>
-          <FCUInt Name="FullyConstrainedColor" Value="2799935999"/>
-          <FCUInt Name="InternalAlignedGeoColor" Value="1959907071"/>
-          <FCUInt Name="FullyConstraintElementColor" Value="2799935999"/>
-          <FCUInt Name="FullyConstraintConstructionElementColor" Value="2497893887"/>
-          <FCUInt Name="FullyConstraintInternalAlignmentColor" Value="2312199935"/>
-          <FCUInt Name="FullyConstraintConstructionPointColor" Value="2799935999"/>
-          <FCUInt Name="ConstrainedIcoColor" Value="2310339327"/>
-          <FCUInt Name="NonDrivingConstrDimColor" Value="2139095295"/>
-          <FCUInt Name="ConstrainedDimColor" Value="3416717311"/>
-          <FCUInt Name="ExprBasedConstrDimColor" Value="4206069759"/>
-          <FCUInt Name="DeactivatedConstrDimColor" Value="1819509759"/>
-          <FCUInt Name="CursorTextColor" Value="3453416703"/>
-          <FCUInt Name="CursorCrosshairColor" Value="3416717311"/>
-          <FCUInt Name="CreateLineColor" Value="2799935999"/>
-          <FCUInt Name="ShadowLightColor" Value="2470768128"/>
-          <FCUInt Name="ShadowGroundColor" Value="286333952"/>
-          <FCUInt Name="HiddenLineColor" Value="825378047"/>
-          <FCUInt Name="HiddenLineFaceColor" Value="505294591"/>
-          <FCUInt Name="HiddenLineBackground" Value="505294591"/>
-          <FCBool Name="EnableBacklight" Value="1"/>
-          <FCUInt Name="BacklightColor" Value="1162304255"/>
-          <FCFloat Name="BacklightIntensity" Value="0.30"/>
-        </FCParamGroup>
-        <FCParamGroup Name="TreeView">
-          <FCUInt Name="TreeEditColor" Value="3416717311"/>
-          <FCUInt Name="TreeActiveColor" Value="2799935999"/>
-        </FCParamGroup>
-        <FCParamGroup Name="General">
-          <FCText Name="AutoloadModule">ZToolsWorkbench</FCText>
-        </FCParamGroup>
-        <FCParamGroup Name="MainWindow">
-          <FCText Name="StyleSheet">KindredCreate.qss</FCText>
-        </FCParamGroup>
-        <FCParamGroup Name="Mod">
-          <FCParamGroup Name="Start">
-            <FCUInt Name="BackgroundColor1" Value="404235775"/>
-            <FCUInt Name="BackgroundTextColor" Value="3453416703"/>
-            <FCUInt Name="PageColor" Value="505294591"/>
-            <FCUInt Name="PageTextColor" Value="3453416703"/>
-            <FCUInt Name="BoxColor" Value="825378047"/>
-            <FCUInt Name="LinkColor" Value="2310339327"/>
-            <FCUInt Name="BackgroundColor2" Value="286333951"/>
-          </FCParamGroup>
-          <FCParamGroup Name="Part">
-            <FCUInt Name="VertexColor" Value="3032415999"/>
-            <FCUInt Name="EdgeColor" Value="2310339327"/>
-          </FCParamGroup>
-          <FCParamGroup Name="PartDesign">
-            <FCUInt Name="DefaultDatumColor" Value="3416717311"/>
-          </FCParamGroup>
-          <FCParamGroup Name="Draft">
-            <FCUInt Name="snapcolor" Value="2799935999"/>
-          </FCParamGroup>
-          <FCParamGroup Name="Sketcher">
-            <FCUInt Name="GridLineColor" Value="1162304255"/>
-          </FCParamGroup>
-        </FCParamGroup>
-      </FCParamGroup>
-    </FCParamGroup>
-  </FCParamGroup>
-</FCParameters>

resources/preferences/package.xml

@@ -1,18 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
-<package format="1" xmlns="https://wiki.freecad.org/Package_Metadata">
-
-  <name>Kindred Create Preference Packs</name>
-  <description>Default preference packs for Kindred Create, featuring the Catppuccin Mocha color theme.</description>
-  <version>0.1.0</version>
-  <maintainer email="support@kindredsystems.net">Kindred Systems LLC</maintainer>
-  <license>LGPL-2.1-or-later</license>
-  <url type="website">https://kindredsystems.net</url>
-
-  <content>
-    <preferencepack>
-      <name>KindredCreate</name>
-      <description>The default Kindred Create theme based on Catppuccin Mocha - a soothing dark color palette.</description>
-    </preferencepack>
-  </content>
-
-</package>

src/Gui/OriginManagerDialog.cpp

@@ -31,6 +31,8 @@
 #include "OriginManager.h"
 #include "FileOrigin.h"
 #include "BitmapFactory.h"
+#include "Application.h"
+#include "Command.h"
 
 
 namespace Gui {
@@ -176,10 +178,7 @@ FileOrigin* OriginManagerDialog::selectedOrigin() const
 
 void OriginManagerDialog::onAddSilo()
 {
-    // TODO: Open SiloConfigDialog for adding new instance
-    QMessageBox::information(this, tr("Add Silo"),
-        tr("Silo configuration dialog not yet implemented.\n\n"
-           "To add a Silo instance, configure it in the Silo workbench preferences."));
+    Application::Instance->commandManager().runCommandByName("Silo_Settings");
 }
 
 void OriginManagerDialog::onEditOrigin()
@@ -189,10 +188,7 @@ void OriginManagerDialog::onEditOrigin()
         return;
     }
 
-    // TODO: Open SiloConfigDialog for editing
-    QMessageBox::information(this, tr("Edit Origin"),
-        tr("Origin editing not yet implemented.\n\n"
-           "To edit this origin, modify settings in the Silo workbench preferences."));
+    Application::Instance->commandManager().runCommandByName("Silo_Settings");
 }
 
 void OriginManagerDialog::onRemoveOrigin()

src/Gui/PreferencePacks/CMakeLists.txt

@@ -12,6 +12,14 @@ ADD_CUSTOM_TARGET(PreferencePacks_data ALL
 
 FILE(COPY ${PreferencePacks_Files} ${PreferencePacks_Directories} DESTINATION "${CMAKE_BINARY_DIR}/${CMAKE_INSTALL_DATADIR}/Gui/PreferencePacks")
 
+# Copy KindredCreate.qss from Stylesheets into the PreferencePacks build directory.
+# The canonical QSS lives in src/Gui/Stylesheets/; this avoids maintaining a duplicate. (#51)
+configure_file(
+        ${CMAKE_CURRENT_SOURCE_DIR}/../Stylesheets/KindredCreate.qss
+        ${CMAKE_BINARY_DIR}/${CMAKE_INSTALL_DATADIR}/Gui/PreferencePacks/KindredCreate/KindredCreate.qss
+        COPYONLY
+)
+
 fc_copy_sources(PreferencePacks_data "${CMAKE_BINARY_DIR}/${CMAKE_INSTALL_DATADIR}/Gui/PreferencePacks"
         ${PreferencePacks_Files}
         ${PreferencePacks_Directories})
@@ -23,9 +31,10 @@ INSTALL(
         ${CMAKE_INSTALL_DATADIR}/Gui/PreferencePacks
 )
 
+# Install from build directory so the generated QSS copy is included
 INSTALL(
         DIRECTORY
-        ${PreferencePacks_Directories}
+        ${CMAKE_BINARY_DIR}/${CMAKE_INSTALL_DATADIR}/Gui/PreferencePacks/KindredCreate
         DESTINATION
         ${CMAKE_INSTALL_DATADIR}/Gui/PreferencePacks
 )

src/Gui/PreferencePacks/KindredCreate/KindredCreate.cfg

@@ -25,6 +25,10 @@
           <FCUInt Name="colorLogging" Value="2497893887" />
           <FCUInt Name="colorWarning" Value="4192382975" />
           <FCUInt Name="colorError" Value="4086016255" />
+          <FCBool Name="checkError" Value="1" />
+          <FCBool Name="checkLogging" Value="1" />
+          <FCBool Name="checkShowReportViewOnError" Value="1" />
+          <FCBool Name="checkShowReportViewOnWarning" Value="1" />
         </FCParamGroup>
         <FCParamGroup Name="View">
           <FCUInt Name="BackgroundColor" Value="505294591" />
@@ -81,9 +85,29 @@
           <FCUInt Name="BacklightColor" Value="1162304255" />
           <FCFloat Name="BacklightIntensity" Value="0.30" />
         </FCParamGroup>
+        <FCParamGroup Name="Document">
+          <FCInt Name="MaxUndoSize" Value="50" />
+          <FCInt Name="AutoSaveTimeout" Value="5" />
+          <FCInt Name="CountBackupFiles" Value="3" />
+          <FCInt Name="prefLicenseType" Value="19" />
+          <FCText Name="prefLicenseUrl"></FCText>
+        </FCParamGroup>
         <FCParamGroup Name="TreeView">
           <FCUInt Name="TreeEditColor" Value="3416717311" />
           <FCUInt Name="TreeActiveColor" Value="2799935999" />
+          <FCBool Name="PreSelection" Value="1" />
+          <FCBool Name="SyncView" Value="1" />
+          <FCBool Name="SyncSelection" Value="1" />
+        </FCParamGroup>
+        <FCParamGroup Name="NotificationArea">
+          <FCInt Name="MaxWidgetMessages" Value="100" />
+          <FCInt Name="MaxOpenNotifications" Value="3" />
+          <FCInt Name="NotificiationWidth" Value="400" />
+          <FCInt Name="NotificationTime" Value="10" />
+          <FCInt Name="MinimumOnScreenTime" Value="3" />
+        </FCParamGroup>
+        <FCParamGroup Name="General">
+          <FCText Name="AutoloadModule">ZToolsWorkbench</FCText>
         </FCParamGroup>
         <FCParamGroup Name="MainWindow">
           <FCText Name="StyleSheet">KindredCreate.qss</FCText>

src/Gui/PreferencePages/DlgSettingsGeneral.cpp

@@ -28,6 +28,7 @@
 #include <QApplication>
 #include <QFileDialog>
 #include <QLocale>
+#include <QMenu>
 #include <QMessageBox>
 #include <QString>
 #include <algorithm>
@@ -96,7 +97,6 @@ DlgSettingsGeneral::DlgSettingsGeneral(QWidget* parent)
                 ui->SaveNewPreferencePack->setEnabled(false);
                 ui->ManagePreferencePacks->setEnabled(false);
                 ui->themesCombobox->setEnabled(false);
-                ui->moreThemesLabel->setEnabled(false);
             }
         }
     }
@@ -121,7 +121,6 @@ DlgSettingsGeneral::DlgSettingsGeneral(QWidget* parent)
             this,
             &DlgSettingsGeneral::onThemeChanged
         );
-        connect(ui->moreThemesLabel, &QLabel::linkActivated, this, &DlgSettingsGeneral::onLinkActivated);
     }
 
     // If there are any saved config file backs, show the revert button, otherwise hide it:
@@ -147,9 +146,6 @@ DlgSettingsGeneral::DlgSettingsGeneral(QWidget* parent)
     const auto visible = UnitsApi::isMultiUnitLength();
     ui->comboBox_FracInch->setVisible(visible);
     ui->fractionalInchLabel->setVisible(visible);
-    ui->moreThemesLabel->setEnabled(
-        Application::Instance->commandManager().getCommandByName("Std_AddonMgr") != nullptr
-    );
 }
 
 /**
@@ -166,7 +162,7 @@ void DlgSettingsGeneral::setRecentFileSize()
     auto recent = getMainWindow()->findChild<RecentFilesAction*>(QLatin1String("recentFiles"));
     if (recent) {
         ParameterGrp::handle hGrp = WindowParameter::getDefaultParameter()->GetGroup("RecentFiles");
-        recent->resizeList(hGrp->GetInt("RecentFiles", 4));
+        recent->resizeList(hGrp->GetInt("RecentFiles", 10));
     }
 }
 
@@ -264,6 +260,11 @@ void DlgSettingsGeneral::saveSettings()
     hGrp->SetInt("ToolbarIconSize", pixel);
     getMainWindow()->setIconSize(QSize(pixel, pixel));
 
+    QVariant menuSize = ui->menuIconSize->itemData(ui->menuIconSize->currentIndex());
+    int menuPixel = menuSize.toInt();
+    hGrp->SetInt("MenuIconSize", menuPixel);
+    applyMenuIconSize(menuPixel);
+
     int blinkTime {hGrp->GetBool("EnableCursorBlinking", true) ? -1 : 0};
     qApp->setCursorFlashTime(blinkTime);
 
@@ -348,6 +349,7 @@ void DlgSettingsGeneral::loadSettings()
     }
 
     addIconSizes(getCurrentIconSize());
+    addMenuIconSizes(getCurrentMenuIconSize());
 
     // TreeMode combobox setup.
     loadDockWindowVisibility();
@@ -395,8 +397,9 @@ void DlgSettingsGeneral::resetSettingsToDefaults()
     hGrp = WindowParameter::getDefaultParameter()->GetGroup("General");
     // reset "Language" parameter
     hGrp->RemoveASCII("Language");
-    // reset "ToolbarIconSize" parameter
+    // reset "ToolbarIconSize" and "MenuIconSize" parameters
     hGrp->RemoveInt("ToolbarIconSize");
+    hGrp->RemoveInt("MenuIconSize");
 
     // finally reset all the parameters associated to Gui::Pref* widgets
     PreferencePage::resetSettingsToDefaults();
@@ -534,6 +537,63 @@ void DlgSettingsGeneral::translateIconSizes()
     }
 }
 
+int DlgSettingsGeneral::getCurrentMenuIconSize() const
+{
+    ParameterGrp::handle hGrp = WindowParameter::getDefaultParameter()->GetGroup("General");
+    return hGrp->GetInt("MenuIconSize", 24);
+}
+
+void DlgSettingsGeneral::addMenuIconSizes(int current)
+{
+    ui->menuIconSize->clear();
+
+    QList<int> sizes {16, 20, 24, 28};
+    if (!sizes.contains(current)) {
+        sizes.append(current);
+    }
+
+    for (int size : sizes) {
+        ui->menuIconSize->addItem(QString(), QVariant(size));
+    }
+
+    int index = ui->menuIconSize->findData(QVariant(current));
+    ui->menuIconSize->setCurrentIndex(index);
+    translateMenuIconSizes();
+}
+
+void DlgSettingsGeneral::translateMenuIconSizes()
+{
+    auto getSize = [this](int index) {
+        return ui->menuIconSize->itemData(index).toInt();
+    };
+
+    QStringList sizes;
+    sizes << tr("Small (%1px)").arg(getSize(0));
+    sizes << tr("Medium (%1px)").arg(getSize(1));
+    sizes << tr("Large (%1px)").arg(getSize(2));
+    sizes << tr("Extra large (%1px)").arg(getSize(3));
+    if (ui->menuIconSize->count() > 4) {
+        sizes << tr("Custom (%1px)").arg(getSize(4));
+    }
+
+    for (int index = 0; index < sizes.size(); index++) {
+        ui->menuIconSize->setItemText(index, sizes[index]);
+    }
+}
+
+void DlgSettingsGeneral::applyMenuIconSize(int pixel)
+{
+    // Apply menu icon size via stylesheet override on all QMenu widgets
+    QString rule = QStringLiteral("QMenu::icon { width: %1px; height: %1px; }").arg(pixel);
+    for (auto* widget : qApp->allWidgets()) {
+        if (auto* menu = qobject_cast<QMenu*>(widget)) {
+            menu->setStyleSheet(rule);
+        }
+    }
+    // Store the rule so new menus pick it up via the main window
+    getMainWindow()->setProperty("_menuIconSizeRule", rule);
+}
+
 void DlgSettingsGeneral::retranslateUnits()
 {
     auto setItem = [&, index {0}](const std::string& item) mutable {
@@ -547,6 +607,7 @@ void DlgSettingsGeneral::changeEvent(QEvent* event)
 {
     if (event->type() == QEvent::LanguageChange) {
         translateIconSizes();
+        translateMenuIconSizes();
         retranslateUnits();
         int index = ui->UseLocaleFormatting->currentIndex();
         ui->retranslateUi(this);
@@ -823,24 +884,6 @@ void DlgSettingsGeneral::onThemeChanged(int index)
     themeChanged = true;
 }
 
-void DlgSettingsGeneral::onLinkActivated(const QString& link)
-{
-    auto const addonManagerLink = QStringLiteral("freecad:Std_AddonMgr");
-
-    if (link != addonManagerLink) {
-        return;
-    }
-
-    // Set the user preferences to include only preference packs.
-    // This is a quick and dirty way to open Addon Manager with only themes.
-    auto pref = App::GetApplication().GetParameterGroupByPath(
-        "User parameter:BaseApp/Preferences/Addons"
-    );
-    pref->SetInt("PackageTypeSelection", 3);  // 3 stands for Preference Packs
-    pref->SetInt("StatusSelection", 0);       // 0 stands for any installation status
-
-    Gui::Application::Instance->commandManager().runCommandByName("Std_AddonMgr");
-}
 
 ///////////////////////////////////////////////////////////
 namespace

src/Gui/PreferencePages/DlgSettingsGeneral.h

@@ -72,7 +72,6 @@ protected Q_SLOTS:
     void onManagePreferencePacksClicked();
     void onImportConfigClicked();
     void onThemeChanged(int index);
-    void onLinkActivated(const QString& link);
 
 public Q_SLOTS:
     void onUnitSystemIndexChanged(int index);
@@ -91,6 +90,12 @@ private:
     int getCurrentIconSize() const;
     void addIconSizes(int current);
     void translateIconSizes();
+    int getCurrentMenuIconSize() const;
+    void addMenuIconSizes(int current);
+    void translateMenuIconSizes();
+
+public:
+    static void applyMenuIconSize(int pixel);
 
 private:
     int localeIndex;

src/Gui/PreferencePages/DlgSettingsGeneral.ui

@@ -219,35 +219,35 @@ dot/period will always be printed</string>
          </property>
         </widget>
        </item>
-       <item row="1" column="0" colspan="2">
-        <widget class="QLabel" name="moreThemesLabel">
-         <property name="font">
-          <font>
-           <pointsize>8</pointsize>
-          </font>
-         </property>
-         <property name="text">
-          <string>Looking for more themes? You can obtain them using the &lt;a href=&quot;freecad:Std_AddonMgr&quot;&gt;Addon Manager&lt;/a&gt;.</string>
-         </property>
-         <property name="textFormat">
-          <enum>Qt::RichText</enum>
-         </property>
-        </widget>
-       </item>
-       <item row="2" column="0">
+
+       <item row="1" column="0">
         <widget class="QLabel" name="iconSizeLabel">
          <property name="text">
           <string>Size of toolbar icons</string>
          </property>
         </widget>
        </item>
-       <item row="2" column="1">
+       <item row="1" column="1">
         <widget class="QComboBox" name="toolbarIconSize">
          <property name="toolTip">
           <string>Icon size in the toolbar</string>
          </property>
         </widget>
        </item>
+       <item row="2" column="0">
+        <widget class="QLabel" name="menuIconSizeLabel">
+         <property name="text">
+          <string>Size of menu icons</string>
+         </property>
+        </widget>
+       </item>
+       <item row="2" column="1">
+        <widget class="QComboBox" name="menuIconSize">
+         <property name="toolTip">
+          <string>Icon size in context menus and dropdown menus</string>
+         </property>
+        </widget>
+       </item>
        <item row="3" column="0">
         <widget class="QLabel" name="treeModeLabel">
          <property name="text">
@@ -278,7 +278,7 @@ dot/period will always be printed</string>
           <string>How many files should be listed in recent files list</string>
          </property>
          <property name="value">
-          <number>4</number>
+          <number>10</number>
          </property>
          <property name="prefEntry" stdset="0">
           <cstring>RecentFiles</cstring>

src/Gui/PreferencePages/DlgSettingsUI.ui

@@ -23,7 +23,7 @@
       <item>
        <widget class="QLabel" name="label">
         <property name="text">
-         <string>Customize the current theme. The offered settings are optional for theme developers so they may or may not have an effect in the current theme.</string>
+         <string>Kindred Create Theme</string>
         </property>
         <property name="wordWrap">
          <bool>true</bool>
@@ -392,10 +392,10 @@
    <item>
     <widget class="QGroupBox" name="groupBox_3">
      <property name="title">
-      <string>Overlay</string>
+      <string>Panel Visibility</string>
      </property>
      <layout class="QGridLayout" name="gridLayout_2">
-      <item row="2" column="0">
+      <item row="0" column="0">
        <widget class="Gui::PrefCheckBox" name="hideTabBarCheckBox">
         <property name="toolTip">
          <string>Hide tab bar in dock overlay</string>
@@ -414,23 +414,7 @@
         </property>
        </widget>
       </item>
-      <item row="3" column="0">
-       <widget class="Gui::PrefCheckBox" name="hintShowTabBarCheckBox">
-        <property name="toolTip">
-         <string>Show tab bar on mouse over when auto hide</string>
-        </property>
-        <property name="text">
-         <string>Hint show tab bar</string>
-        </property>
-        <property name="prefEntry" stdset="0">
-         <cstring>DockOverlayHintTabBar</cstring>
-        </property>
-        <property name="prefPath" stdset="0">
-         <cstring>View</cstring>
-        </property>
-       </widget>
-      </item>
-      <item row="4" column="0">
+      <item row="1" column="0">
        <widget class="Gui::PrefCheckBox" name="hidePropertyViewScrollBarCheckBox">
         <property name="toolTip">
          <string>Hide property view scroll bar in dock overlay</string>
@@ -446,7 +430,7 @@
         </property>
        </widget>
       </item>
-      <item row="5" column="0">
+      <item row="2" column="0">
        <widget class="Gui::PrefCheckBox" name="overlayAutoHideCheckBox">
         <property name="toolTip">
          <string>Automatically hide overlaid dock panels when in non 3D view (e.g. TechDraw or Spreadsheet)</string>
@@ -465,13 +449,22 @@
         </property>
        </widget>
       </item>
-      <item row="6" column="0">
+     </layout>
+    </widget>
+   </item>
+   <item>
+    <widget class="QGroupBox" name="groupBox_3b">
+     <property name="title">
+      <string>Overlay Interaction</string>
+     </property>
+     <layout class="QGridLayout" name="gridLayout_2b">
+      <item row="0" column="0">
        <widget class="Gui::PrefCheckBox" name="mouseClickPassThroughCheckBox">
         <property name="toolTip">
-         <string>Auto mouse click through transparent part of dock overlay.</string>
+         <string>Auto mouse click through transparent part of dock overlay</string>
         </property>
         <property name="text">
-         <string>Automatically pass through of the mouse cursor</string>
+         <string>Automatically pass through mouse cursor</string>
         </property>
         <property name="checked">
          <bool>true</bool>
@@ -484,13 +477,13 @@
         </property>
        </widget>
       </item>
-      <item row="7" column="0">
+      <item row="1" column="0">
        <widget class="Gui::PrefCheckBox" name="mouseWheelPassThroughCheckBox">
         <property name="toolTip">
          <string>Automatically passes mouse wheel events through the transparent areas of an overlay panel</string>
         </property>
         <property name="text">
-         <string>Automatically pass through of the mouse wheel</string>
+         <string>Automatically pass through mouse wheel</string>
         </property>
         <property name="checked">
          <bool>true</bool>
@@ -503,6 +496,22 @@
         </property>
        </widget>
       </item>
+      <item row="2" column="0">
+       <widget class="Gui::PrefCheckBox" name="hintShowTabBarCheckBox">
+        <property name="toolTip">
+         <string>Show tab bar on mouse over when auto hide</string>
+        </property>
+        <property name="text">
+         <string>Hint show tab bar</string>
+        </property>
+        <property name="prefEntry" stdset="0">
+         <cstring>DockOverlayHintTabBar</cstring>
+        </property>
+        <property name="prefPath" stdset="0">
+         <cstring>View</cstring>
+        </property>
+       </widget>
+      </item>
      </layout>
     </widget>
    </item>

src/Gui/StartupProcess.cpp

@@ -56,6 +56,7 @@
 #include "Language/Translator.h"
 #include "Dialogs/DlgVersionMigrator.h"
 #include "FreeCADStyle.h"
+#include "PreferencePages/DlgSettingsGeneral.h"
 
 #include <App/Application.h>
 #include <Base/Console.h>
@@ -226,6 +227,7 @@ void StartupPostProcess::execute()
     setProcessMessages();
     setAutoSaving();
     setToolBarIconSize();
+    setMenuIconSize();
     setWheelEventFilter();
     setLocale();
     setCursorFlashing();
@@ -281,6 +283,15 @@ void StartupPostProcess::setToolBarIconSize()
     }
 }
 
+void StartupPostProcess::setMenuIconSize()
+{
+    ParameterGrp::handle hGrp = WindowParameter::getDefaultParameter()->GetGroup("General");
+    int size = int(hGrp->GetInt("MenuIconSize", 0));
+    if (size >= 16) {
+        Dialog::DlgSettingsGeneral::applyMenuIconSize(size);
+    }
+}
+
 void StartupPostProcess::setWheelEventFilter()
 {
     // filter wheel events for combo boxes

src/Gui/StartupProcess.h

@@ -64,6 +64,7 @@ private:
     void setProcessMessages();
     void setAutoSaving();
     void setToolBarIconSize();
+    void setMenuIconSize();
     void setWheelEventFilter();
     void setLocale();
     void setCursorFlashing();

src/Gui/Stylesheets/KindredCreate.qss

@@ -744,6 +744,33 @@ QGroupBox::title {
     background-color: #1e1e2e;
 }
 
+QGroupBox::indicator {
+    width: 18px;
+    height: 18px;
+    border: 2px solid #585b70;
+    border-radius: 4px;
+    background-color: #313244;
+}
+
+QGroupBox::indicator:hover {
+    border-color: #cba6f7;
+}
+
+QGroupBox::indicator:checked {
+    background-color: #cba6f7;
+    border-color: #cba6f7;
+}
+
+QGroupBox::indicator:checked:disabled {
+    background-color: #6c7086;
+    border-color: #6c7086;
+}
+
+QGroupBox::indicator:disabled {
+    background-color: #181825;
+    border-color: #45475a;
+}
+
 /* =============================================================================
    Tree View
    ============================================================================= */
@@ -985,6 +1012,11 @@ QLabel:disabled {
     color: #6c7086;
 }
 
+/* Hyperlinks — sets QPalette::Link via Application.cpp haslink mechanism */
+QLabel[haslink="true"] {
+    color: #b4befe;
+}
+
 /* =============================================================================
    Frames
    ============================================================================= */

src/Mod/Assembly/UtilsAssembly.py

@@ -49,7 +49,9 @@ def activePartOrAssembly():
 
 def activeAssembly():
     active_assembly = activePartOrAssembly()
-    if active_assembly is not None and active_assembly.isDerivedFrom("Assembly::AssemblyObject"):
+    if active_assembly is not None and active_assembly.isDerivedFrom(
+        "Assembly::AssemblyObject"
+    ):
         if active_assembly.ViewObject.isInEditMode():
             return active_assembly
 
@@ -59,7 +61,9 @@ def activeAssembly():
 def activePart():
     active_part = activePartOrAssembly()
 
-    if active_part is not None and not active_part.isDerivedFrom("Assembly::AssemblyObject"):
+    if active_part is not None and not active_part.isDerivedFrom(
+        "Assembly::AssemblyObject"
+    ):
         return active_part
 
     return None
@@ -120,7 +124,9 @@ def number_of_components_in(assembly):
 def isLink(obj):
     # If element count is not 0, then its a link group in which case the Link
     # is a container and it's the LinkElement that is linking to external doc.
-    return (obj.TypeId == "App::Link" and obj.ElementCount == 0) or obj.TypeId == "App::LinkElement"
+    return (
+        obj.TypeId == "App::Link" and obj.ElementCount == 0
+    ) or obj.TypeId == "App::LinkElement"
 
 
 def isLinkGroup(obj):
@@ -375,7 +381,9 @@ def getGlobalPlacement(ref, targetObj=None):
     if not isRefValid(ref, 1):
         return App.Placement()
 
-    if targetObj is None:  # If no targetObj is given, we consider it's the getObject(ref)
+    if (
+        targetObj is None
+    ):  # If no targetObj is given, we consider it's the getObject(ref)
         targetObj = getObject(ref)
         if targetObj is None:
             return App.Placement()
@@ -520,11 +528,17 @@ def findElementClosestVertex(ref, mousePos):
 
         for i, edge in enumerate(edges):
             curve = edge.Curve
-            if curve.TypeId == "Part::GeomCircle" or curve.TypeId == "Part::GeomEllipse":
+            if (
+                curve.TypeId == "Part::GeomCircle"
+                or curve.TypeId == "Part::GeomEllipse"
+            ):
                 center_points.append(curve.Location)
                 center_points_edge_indexes.append(i)
 
-            elif _type == "Part::GeomCylinder" and curve.TypeId == "Part::GeomBSplineCurve":
+            elif (
+                _type == "Part::GeomCylinder"
+                and curve.TypeId == "Part::GeomBSplineCurve"
+            ):
                 # handle special case of 2 cylinder intersecting.
                 for j, facej in enumerate(obj.Shape.Faces):
                     surfacej = facej.Surface
@@ -553,7 +567,9 @@ def findElementClosestVertex(ref, mousePos):
         if _type == "Part::GeomCylinder" or _type == "Part::GeomCone":
             centerOfG = face.CenterOfGravity - surface.Center
             centerPoint = surface.Center + centerOfG
-            centerPoint = centerPoint + App.Vector().projectToLine(centerOfG, surface.Axis)
+            centerPoint = centerPoint + App.Vector().projectToLine(
+                centerOfG, surface.Axis
+            )
             face_points.append(centerPoint)
         else:
             face_points.append(face.CenterOfGravity)
@@ -623,7 +639,8 @@ def color_from_unsigned(c):
 
 def getJointsOfType(asm, jointTypes):
     if not (
-        asm.isDerivedFrom("Assembly::AssemblyObject") or asm.isDerivedFrom("Assembly::AssemblyLink")
+        asm.isDerivedFrom("Assembly::AssemblyObject")
+        or asm.isDerivedFrom("Assembly::AssemblyLink")
     ):
         return []
 
@@ -763,7 +780,9 @@ def getSubMovingParts(obj, partsAsSolid):
 
     if isLink(obj):
         linked_obj = obj.getLinkedObject()
-        if linked_obj.isDerivedFrom("App::Part") or linked_obj.isDerivedFrom("Part::Feature"):
+        if linked_obj.isDerivedFrom("App::Part") or linked_obj.isDerivedFrom(
+            "Part::Feature"
+        ):
             return [obj]
 
     return []
@@ -996,7 +1015,7 @@ def findPlacement(ref, ignoreVertex=False):
     vtx = getElementName(ref[1][1])
 
     if not elt or not vtx:
-        # case of whole parts such as PartDesign::Body or App/PartDesign::CordinateSystem/Point/Line/Plane.
+        # Origin objects (App::Line, App::Plane, App::Point)
         if obj.TypeId == "App::Line":
             if obj.Role == "X_Axis":
                 return App.Placement(App.Vector(), App.Rotation(0.5, 0.5, 0.5, 0.5))
@@ -1005,9 +1024,25 @@ def findPlacement(ref, ignoreVertex=False):
             if obj.Role == "Z_Axis":
                 return App.Placement(App.Vector(), App.Rotation(-0.5, 0.5, -0.5, 0.5))
 
-        # PartDesign datum planes (including ZTools datums like ZPlane_Mid, ZPlane_Offset)
+        if obj.TypeId == "App::Plane":
+            if obj.Role == "XY_Plane":
+                return App.Placement()
+            if obj.Role == "XZ_Plane":
+                return App.Placement(
+                    App.Vector(), App.Rotation(App.Vector(1, 0, 0), -90)
+                )
+            if obj.Role == "YZ_Plane":
+                return App.Placement(
+                    App.Vector(), App.Rotation(App.Vector(0, 1, 0), 90)
+                )
+            return App.Placement()
+
+        if obj.TypeId == "App::Point":
+            return App.Placement()
+
+        # PartDesign datum planes
         if obj.isDerivedFrom("PartDesign::Plane"):
-            if hasattr(obj, "Shape") and obj.Shape.Faces:
+            if hasattr(obj, "Shape") and not obj.Shape.isNull() and obj.Shape.Faces:
                 face = obj.Shape.Faces[0]
                 surface = face.Surface
                 plc = App.Placement()
@@ -1015,9 +1050,28 @@ def findPlacement(ref, ignoreVertex=False):
                 if hasattr(surface, "Rotation") and surface.Rotation is not None:
                     plc.Rotation = App.Rotation(surface.Rotation)
                 return obj.Placement.inverse() * plc
+            return obj.Placement
+
+        # PartDesign datum lines
+        if obj.isDerivedFrom("PartDesign::Line"):
+            if hasattr(obj, "Shape") and not obj.Shape.isNull() and obj.Shape.Edges:
+                edge = obj.Shape.Edges[0]
+                points = getPointsFromVertexes(edge.Vertexes)
+                mid = (points[0] + points[1]) * 0.5
+                direction = round_vector(edge.Curve.Direction)
+                plane = Part.Plane(App.Vector(), direction)
+                plc = App.Placement()
+                plc.Base = mid
+                plc.Rotation = App.Rotation(plane.Rotation)
+                return obj.Placement.inverse() * plc
+            return obj.Placement
 
         # PartDesign datum points
         if obj.isDerivedFrom("PartDesign::Point"):
+            if hasattr(obj, "Shape") and not obj.Shape.isNull() and obj.Shape.Vertexes:
+                plc = App.Placement()
+                plc.Base = obj.Shape.Vertexes[0].Point
+                return obj.Placement.inverse() * plc
             return obj.Placement
 
         return App.Placement()
@@ -1080,9 +1134,14 @@ def findPlacement(ref, ignoreVertex=False):
             if surface.TypeId == "Part::GeomCylinder":
                 centerOfG = face.CenterOfGravity - surface.Center
                 centerPoint = surface.Center + centerOfG
-                centerPoint = centerPoint + App.Vector().projectToLine(centerOfG, surface.Axis)
+                centerPoint = centerPoint + App.Vector().projectToLine(
+                    centerOfG, surface.Axis
+                )
                 plc.Base = centerPoint
-            elif surface.TypeId == "Part::GeomTorus" or surface.TypeId == "Part::GeomSphere":
+            elif (
+                surface.TypeId == "Part::GeomTorus"
+                or surface.TypeId == "Part::GeomSphere"
+            ):
                 plc.Base = surface.Center
             elif surface.TypeId == "Part::GeomCone":
                 plc.Base = surface.Apex
@@ -1100,7 +1159,8 @@ def findPlacement(ref, ignoreVertex=False):
                 plc.Base = (center_point.x, center_point.y, center_point.z)
 
             elif (
-                surface.TypeId == "Part::GeomCylinder" and curve.TypeId == "Part::GeomBSplineCurve"
+                surface.TypeId == "Part::GeomCylinder"
+                and curve.TypeId == "Part::GeomBSplineCurve"
             ):
                 # handle special case of 2 cylinder intersecting.
                 plc.Base = findCylindersIntersection(obj, surface, edge, elt_index)
@@ -1394,13 +1454,16 @@ def generatePropertySettings(documentObject):
             commands.append(f"obj.{propertyName} = {propertyValue:.5f}")
         elif propertyType == "App::PropertyInt" or propertyType == "App::PropertyBool":
             commands.append(f"obj.{propertyName} = {propertyValue}")
-        elif propertyType == "App::PropertyString" or propertyType == "App::PropertyEnumeration":
+        elif (
+            propertyType == "App::PropertyString"
+            or propertyType == "App::PropertyEnumeration"
+        ):
             commands.append(f'obj.{propertyName} = "{propertyValue}"')
         elif propertyType == "App::PropertyPlacement":
             commands.append(
                 f"obj.{propertyName} = App.Placement("
                 f"App.Vector({propertyValue.Base.x:.5f},{propertyValue.Base.y:.5f},{propertyValue.Base.z:.5f}),"
-                f"App.Rotation(*{[round(n,5) for n in propertyValue.Rotation.getYawPitchRoll()]}))"
+                f"App.Rotation(*{[round(n, 5) for n in propertyValue.Rotation.getYawPitchRoll()]}))"
             )
         elif propertyType == "App::PropertyXLinkSubHidden":
             commands.append(

src/Mod/Create/CMakeLists.txt

@@ -1,11 +1,20 @@
 # Kindred Create core module
 # Handles auto-loading of ztools and Silo addons
 
+# Generate version.py from template with Kindred Create version
+configure_file(
+    ${CMAKE_CURRENT_SOURCE_DIR}/version.py.in
+    ${CMAKE_CURRENT_BINARY_DIR}/version.py
+    @ONLY
+)
+
 # Install Python init files
 install(
     FILES
         Init.py
         InitGui.py
+        update_checker.py
+        ${CMAKE_CURRENT_BINARY_DIR}/version.py
     DESTINATION
         Mod/Create
 )

src/Mod/Create/InitGui.py

@@ -148,6 +148,16 @@ def _setup_silo_activity_panel():
         FreeCAD.Console.PrintLog(f"Create: Silo activity panel skipped: {e}\n")
 
 
+def _check_for_updates():
+    """Check for application updates in the background."""
+    try:
+        from update_checker import _run_update_check
+
+        _run_update_check()
+    except Exception as e:
+        FreeCAD.Console.PrintLog(f"Create: Update check skipped: {e}\n")
+
+
 # Defer enhancements until the GUI event loop is running
 try:
     from PySide.QtCore import QTimer
@@ -156,5 +166,6 @@ try:
     QTimer.singleShot(2000, _setup_silo_auth_panel)
     QTimer.singleShot(3000, _check_silo_first_start)
     QTimer.singleShot(4000, _setup_silo_activity_panel)
+    QTimer.singleShot(10000, _check_for_updates)
 except Exception:
     pass

src/Mod/Create/update_checker.py

@@ -0,0 +1,165 @@
+"""Kindred Create update checker.
+
+Queries the Gitea releases API to determine if a newer version is
+available. Designed to run in the background on startup without
+blocking the UI.
+"""
+
+import json
+import re
+import urllib.request
+from datetime import datetime, timezone
+
+import FreeCAD
+
+_RELEASES_URL = "https://git.kindred-systems.com/api/v1/repos/kindred/create/releases"
+_PREF_PATH = "User parameter:BaseApp/Preferences/Mod/KindredCreate/Update"
+_TIMEOUT = 5
+
+
+def _parse_version(tag):
+    """Parse a version tag like 'v0.1.3' into a comparable tuple.
+
+    Returns None if the tag doesn't match the expected pattern.
+    """
+    m = re.match(r"^v?(\d+)\.(\d+)\.(\d+)$", tag)
+    if not m:
+        return None
+    return (int(m.group(1)), int(m.group(2)), int(m.group(3)))
+
+
+def check_for_update(current_version):
+    """Check if a newer release is available on Gitea.
+
+    Args:
+        current_version: Version string like "0.1.3".
+
+    Returns:
+        Dict with update info if a newer version exists, None otherwise.
+        Dict keys: version, tag, release_url, assets, body.
+    """
+    current = _parse_version(current_version)
+    if current is None:
+        return None
+
+    req = urllib.request.Request(
+        f"{_RELEASES_URL}?limit=10",
+        headers={"Accept": "application/json"},
+    )
+    with urllib.request.urlopen(req, timeout=_TIMEOUT) as resp:
+        releases = json.loads(resp.read())
+
+    best = None
+    best_version = current
+
+    for release in releases:
+        if release.get("draft"):
+            continue
+        if release.get("prerelease"):
+            continue
+
+        tag = release.get("tag_name", "")
+        # Skip the rolling 'latest' tag
+        if tag == "latest":
+            continue
+
+        ver = _parse_version(tag)
+        if ver is None:
+            continue
+
+        if ver > best_version:
+            best_version = ver
+            best = release
+
+    if best is None:
+        return None
+
+    assets = []
+    for asset in best.get("assets", []):
+        assets.append(
+            {
+                "name": asset.get("name", ""),
+                "url": asset.get("browser_download_url", ""),
+                "size": asset.get("size", 0),
+            }
+        )
+
+    return {
+        "version": ".".join(str(x) for x in best_version),
+        "tag": best["tag_name"],
+        "release_url": best.get("html_url", ""),
+        "assets": assets,
+        "body": best.get("body", ""),
+    }
+
+
+def _should_check(param):
+    """Determine whether an update check should run now.
+
+    Args:
+        param: FreeCAD parameter group for update preferences.
+
+    Returns:
+        True if a check should be performed.
+    """
+    if not param.GetBool("CheckEnabled", True):
+        return False
+
+    last_check = param.GetString("LastCheckTimestamp", "")
+    if not last_check:
+        return True
+
+    interval_days = param.GetInt("CheckIntervalDays", 1)
+    if interval_days <= 0:
+        return True
+
+    try:
+        last_dt = datetime.fromisoformat(last_check)
+        now = datetime.now(timezone.utc)
+        elapsed = (now - last_dt).total_seconds()
+        return elapsed >= interval_days * 86400
+    except (ValueError, TypeError):
+        return True
+
+
+def _run_update_check():
+    """Entry point called from the deferred startup timer."""
+    param = FreeCAD.ParamGet(_PREF_PATH)
+
+    if not _should_check(param):
+        return
+
+    try:
+        from version import VERSION
+    except ImportError:
+        FreeCAD.Console.PrintLog(
+            "Create: update check skipped — version module not available\n"
+        )
+        return
+
+    try:
+        result = check_for_update(VERSION)
+    except Exception as e:
+        FreeCAD.Console.PrintLog(f"Create: update check failed: {e}\n")
+        return
+
+    # Record that we checked
+    param.SetString(
+        "LastCheckTimestamp",
+        datetime.now(timezone.utc).isoformat(),
+    )
+
+    if result is None:
+        FreeCAD.Console.PrintLog("Create: application is up to date\n")
+        return
+
+    skipped = param.GetString("SkippedVersion", "")
+    if result["version"] == skipped:
+        FreeCAD.Console.PrintLog(
+            f"Create: update {result['version']} available but skipped by user\n"
+        )
+        return
+
+    FreeCAD.Console.PrintMessage(
+        f"Kindred Create {result['version']} is available (current: {VERSION})\n"
+    )

src/Mod/Create/version.py.in

@@ -0,0 +1 @@
+VERSION = "@KINDRED_CREATE_VERSION@"

tests/src/Gui/CMakeLists.txt

@@ -4,6 +4,7 @@
 add_executable(Gui_tests_run
         Assistant.cpp
         Camera.cpp
+        OriginManager.cpp
         StyleParameters/StyleParametersApplicationTest.cpp
         StyleParameters/ParserTest.cpp
         StyleParameters/ParameterManagerTest.cpp

tests/src/Gui/OriginManager.cpp

@@ -0,0 +1,382 @@
+// SPDX-License-Identifier: LGPL-2.1-or-later
+
+#include <gtest/gtest.h>
+
+#include <string>
+
+#include <App/Application.h>
+#include <App/Document.h>
+#include <App/DocumentObject.h>
+#include <App/PropertyStandard.h>
+#include <Gui/FileOrigin.h>
+#include <Gui/OriginManager.h>
+
+#include <src/App/InitApplication.h>
+
+
+namespace
+{
+
+/**
+ * Minimal FileOrigin implementation for testing OriginManager.
+ * All document operations are stubs -- we only need identity,
+ * capability, and ownership methods to test the manager.
+ */
+class MockOrigin : public Gui::FileOrigin
+{
+public:
+    explicit MockOrigin(std::string originId,
+                        Gui::OriginType originType = Gui::OriginType::PLM,
+                        bool ownsAll = false)
+        : _id(std::move(originId))
+        , _type(originType)
+        , _ownsAll(ownsAll)
+    {}
+
+    // Identity
+    std::string id() const override { return _id; }
+    std::string name() const override { return _id + " Name"; }
+    std::string nickname() const override { return _id; }
+    QIcon icon() const override { return {}; }
+    Gui::OriginType type() const override { return _type; }
+
+    // Characteristics
+    bool tracksExternally() const override { return _type == Gui::OriginType::PLM; }
+    bool requiresAuthentication() const override { return _type == Gui::OriginType::PLM; }
+
+    // Capabilities
+    bool supportsRevisions() const override { return _supportsRevisions; }
+    bool supportsBOM() const override { return _supportsBOM; }
+    bool supportsPartNumbers() const override { return _supportsPartNumbers; }
+
+    // Document identity
+    std::string documentIdentity(App::Document* /*doc*/) const override { return {}; }
+    std::string documentDisplayId(App::Document* /*doc*/) const override { return {}; }
+
+    bool ownsDocument(App::Document* doc) const override
+    {
+        if (!doc) {
+            return false;
+        }
+        return _ownsAll;
+    }
+
+    // Document operations (stubs)
+    App::Document* newDocument(const std::string& /*name*/) override { return nullptr; }
+    App::Document* openDocument(const std::string& /*identity*/) override { return nullptr; }
+    App::Document* openDocumentInteractive() override { return nullptr; }
+    bool saveDocument(App::Document* /*doc*/) override { return false; }
+    bool saveDocumentAs(App::Document* /*doc*/, const std::string& /*id*/) override
+    {
+        return false;
+    }
+    bool saveDocumentAsInteractive(App::Document* /*doc*/) override { return false; }
+
+    // Test controls
+    bool _supportsRevisions = true;
+    bool _supportsBOM = true;
+    bool _supportsPartNumbers = true;
+
+private:
+    std::string _id;
+    Gui::OriginType _type;
+    bool _ownsAll;
+};
+
+}  // namespace
+
+
+// =========================================================================
+// LocalFileOrigin identity tests
+// =========================================================================
+
+class LocalFileOriginTest : public ::testing::Test
+{
+protected:
+    static void SetUpTestSuite()
+    {
+        tests::initApplication();
+    }
+
+    void SetUp() override
+    {
+        _origin = std::make_unique<Gui::LocalFileOrigin>();
+    }
+
+    Gui::LocalFileOrigin* origin() { return _origin.get(); }
+
+private:
+    std::unique_ptr<Gui::LocalFileOrigin> _origin;
+};
+
+TEST_F(LocalFileOriginTest, LocalOriginId)
+{
+    EXPECT_EQ(origin()->id(), "local");
+}
+
+TEST_F(LocalFileOriginTest, LocalOriginName)
+{
+    EXPECT_EQ(origin()->name(), "Local Files");
+}
+
+TEST_F(LocalFileOriginTest, LocalOriginNickname)
+{
+    EXPECT_EQ(origin()->nickname(), "Local");
+}
+
+TEST_F(LocalFileOriginTest, LocalOriginType)
+{
+    EXPECT_EQ(origin()->type(), Gui::OriginType::Local);
+}
+
+TEST_F(LocalFileOriginTest, LocalOriginCapabilities)
+{
+    EXPECT_FALSE(origin()->tracksExternally());
+    EXPECT_FALSE(origin()->requiresAuthentication());
+    EXPECT_FALSE(origin()->supportsRevisions());
+    EXPECT_FALSE(origin()->supportsBOM());
+    EXPECT_FALSE(origin()->supportsPartNumbers());
+    EXPECT_FALSE(origin()->supportsAssemblies());
+}
+
+
+// =========================================================================
+// OriginManager tests
+// =========================================================================
+
+class OriginManagerTest : public ::testing::Test
+{
+protected:
+    static void SetUpTestSuite()
+    {
+        tests::initApplication();
+    }
+
+    void SetUp() override
+    {
+        // Ensure clean singleton state for each test
+        Gui::OriginManager::destruct();
+        _mgr = Gui::OriginManager::instance();
+    }
+
+    void TearDown() override
+    {
+        Gui::OriginManager::destruct();
+    }
+
+    Gui::OriginManager* mgr() { return _mgr; }
+
+private:
+    Gui::OriginManager* _mgr = nullptr;
+};
+
+// --- Registration ---
+
+TEST_F(OriginManagerTest, LocalOriginAlwaysPresent)
+{
+    auto* local = mgr()->getOrigin("local");
+    ASSERT_NE(local, nullptr);
+    EXPECT_EQ(local->id(), "local");
+}
+
+TEST_F(OriginManagerTest, RegisterCustomOrigin)
+{
+    auto* raw = new MockOrigin("test-plm");
+    EXPECT_TRUE(mgr()->registerOrigin(raw));
+    EXPECT_EQ(mgr()->getOrigin("test-plm"), raw);
+}
+
+TEST_F(OriginManagerTest, RejectDuplicateId)
+{
+    mgr()->registerOrigin(new MockOrigin("dup"));
+    // Second registration with same ID should fail
+    EXPECT_FALSE(mgr()->registerOrigin(new MockOrigin("dup")));
+}
+
+TEST_F(OriginManagerTest, RejectNullOrigin)
+{
+    EXPECT_FALSE(mgr()->registerOrigin(nullptr));
+}
+
+TEST_F(OriginManagerTest, OriginIdsIncludesAll)
+{
+    mgr()->registerOrigin(new MockOrigin("alpha"));
+    mgr()->registerOrigin(new MockOrigin("beta"));
+
+    auto ids = mgr()->originIds();
+    EXPECT_EQ(ids.size(), 3u);  // local + alpha + beta
+
+    auto has = [&](const std::string& id) {
+        return std::find(ids.begin(), ids.end(), id) != ids.end();
+    };
+    EXPECT_TRUE(has("local"));
+    EXPECT_TRUE(has("alpha"));
+    EXPECT_TRUE(has("beta"));
+}
+
+// --- Unregistration ---
+
+TEST_F(OriginManagerTest, UnregisterCustomOrigin)
+{
+    mgr()->registerOrigin(new MockOrigin("removable"));
+    EXPECT_TRUE(mgr()->unregisterOrigin("removable"));
+    EXPECT_EQ(mgr()->getOrigin("removable"), nullptr);
+}
+
+TEST_F(OriginManagerTest, CannotUnregisterLocal)
+{
+    EXPECT_FALSE(mgr()->unregisterOrigin("local"));
+    EXPECT_NE(mgr()->getOrigin("local"), nullptr);
+}
+
+TEST_F(OriginManagerTest, UnregisterCurrentSwitchesToLocal)
+{
+    mgr()->registerOrigin(new MockOrigin("ephemeral"));
+    mgr()->setCurrentOrigin("ephemeral");
+    EXPECT_EQ(mgr()->currentOriginId(), "ephemeral");
+
+    mgr()->unregisterOrigin("ephemeral");
+    EXPECT_EQ(mgr()->currentOriginId(), "local");
+}
+
+// --- Current origin selection ---
+
+TEST_F(OriginManagerTest, DefaultCurrentIsLocal)
+{
+    EXPECT_EQ(mgr()->currentOriginId(), "local");
+    EXPECT_NE(mgr()->currentOrigin(), nullptr);
+}
+
+TEST_F(OriginManagerTest, SetCurrentOrigin)
+{
+    mgr()->registerOrigin(new MockOrigin("plm1"));
+
+    std::string notified;
+    auto conn = mgr()->signalCurrentOriginChanged.connect([&](const std::string& id) {
+        notified = id;
+    });
+
+    EXPECT_TRUE(mgr()->setCurrentOrigin("plm1"));
+    EXPECT_EQ(mgr()->currentOriginId(), "plm1");
+    EXPECT_EQ(notified, "plm1");
+}
+
+TEST_F(OriginManagerTest, SetCurrentRejectsUnknown)
+{
+    EXPECT_FALSE(mgr()->setCurrentOrigin("nonexistent"));
+    EXPECT_EQ(mgr()->currentOriginId(), "local");
+}
+
+TEST_F(OriginManagerTest, SetCurrentSameIdNoSignal)
+{
+    int signalCount = 0;
+    auto conn = mgr()->signalCurrentOriginChanged.connect([&](const std::string&) {
+        signalCount++;
+    });
+
+    mgr()->setCurrentOrigin("local");  // already current
+    EXPECT_EQ(signalCount, 0);
+}
+
+// --- Document ownership ---
+
+class OriginManagerDocTest : public ::testing::Test
+{
+protected:
+    static void SetUpTestSuite()
+    {
+        tests::initApplication();
+    }
+
+    void SetUp() override
+    {
+        Gui::OriginManager::destruct();
+        _mgr = Gui::OriginManager::instance();
+        _docName = App::GetApplication().getUniqueDocumentName("test");
+        _doc = App::GetApplication().newDocument(_docName.c_str(), "testUser");
+    }
+
+    void TearDown() override
+    {
+        App::GetApplication().closeDocument(_docName.c_str());
+        Gui::OriginManager::destruct();
+    }
+
+    Gui::OriginManager* mgr() { return _mgr; }
+    App::Document* doc() { return _doc; }
+
+private:
+    Gui::OriginManager* _mgr = nullptr;
+    std::string _docName;
+    App::Document* _doc = nullptr;
+};
+
+TEST_F(OriginManagerDocTest, LocalOwnsPlainDocument)
+{
+    // A document with no SiloItemId property should be owned by local
+    auto* local = mgr()->getOrigin("local");
+    ASSERT_NE(local, nullptr);
+    EXPECT_TRUE(local->ownsDocument(doc()));
+}
+
+TEST_F(OriginManagerDocTest, LocalDisownsTrackedDocument)
+{
+    // Add an object with a SiloItemId property -- local should reject ownership
+    auto* obj = doc()->addObject("App::FeaturePython", "TrackedPart");
+    ASSERT_NE(obj, nullptr);
+    obj->addDynamicProperty("App::PropertyString", "SiloItemId");
+    auto* prop = dynamic_cast<App::PropertyString*>(obj->getPropertyByName("SiloItemId"));
+    ASSERT_NE(prop, nullptr);
+    prop->setValue("some-uuid");
+
+    auto* local = mgr()->getOrigin("local");
+    EXPECT_FALSE(local->ownsDocument(doc()));
+}
+
+TEST_F(OriginManagerDocTest, FindOwningOriginPrefersNonLocal)
+{
+    // Register a PLM mock that claims ownership of everything
+    auto* plm = new MockOrigin("test-plm", Gui::OriginType::PLM, /*ownsAll=*/true);
+    mgr()->registerOrigin(plm);
+
+    auto* owner = mgr()->findOwningOrigin(doc());
+    ASSERT_NE(owner, nullptr);
+    EXPECT_EQ(owner->id(), "test-plm");
+}
+
+TEST_F(OriginManagerDocTest, FindOwningOriginFallsBackToLocal)
+{
+    // No PLM origins registered -- should fall back to local
+    auto* owner = mgr()->findOwningOrigin(doc());
+    ASSERT_NE(owner, nullptr);
+    EXPECT_EQ(owner->id(), "local");
+}
+
+TEST_F(OriginManagerDocTest, OriginForNewDocumentReturnsCurrent)
+{
+    mgr()->registerOrigin(new MockOrigin("plm2"));
+    mgr()->setCurrentOrigin("plm2");
+
+    auto* origin = mgr()->originForNewDocument();
+    ASSERT_NE(origin, nullptr);
+    EXPECT_EQ(origin->id(), "plm2");
+}
+
+TEST_F(OriginManagerDocTest, SetAndClearDocumentOrigin)
+{
+    auto* local = mgr()->getOrigin("local");
+    mgr()->setDocumentOrigin(doc(), local);
+    EXPECT_EQ(mgr()->originForDocument(doc()), local);
+
+    mgr()->clearDocumentOrigin(doc());
+    // After clearing, originForDocument falls back to ownership detection
+    auto* resolved = mgr()->originForDocument(doc());
+    ASSERT_NE(resolved, nullptr);
+    EXPECT_EQ(resolved->id(), "local");
+}
+
+TEST_F(OriginManagerDocTest, NullDocumentHandling)
+{
+    EXPECT_EQ(mgr()->findOwningOrigin(nullptr), nullptr);
+    EXPECT_EQ(mgr()->originForDocument(nullptr), nullptr);
+}