fix: macOS dock/UI branding and RAG chat retrieval quality

.github/WORKFLOW_README.md

@@ -55,28 +55,28 @@ git push origin v1.0.0
 
 ### Windows
 
-- **NSIS Installer**: `StratoSort-<version>-win-x64.exe`
-- **Portable**: `StratoSort-<version>-win-x64.portable.exe`
+- **NSIS Installer**: `StratoSortCore-Setup-<version>.exe`
+- **Portable**: `StratoSortCore-<version>-win-x64.exe`
 - **Checksums**: `checksums.sha256`
 - **Updater metadata**: `latest.yml`, `*.blockmap`
 
 ### macOS (manual only)
 
-- **DMG**: `StratoSort-<version>-mac-<arch>.dmg`
-- **ZIP**: `StratoSort-<version>-mac-<arch>.zip`
+- **DMG**: `StratoSortCore-<version>-mac-<arch>.dmg`
+- **ZIP**: `StratoSortCore-<version>-mac-<arch>.zip`
 
 ### Linux (manual only)
 
-- **AppImage**: `StratoSort-<version>-linux-x64.AppImage`
-- **DEB**: `StratoSort-<version>-linux-x64.deb`
+- **AppImage**: `StratoSortCore-<version>-linux-x64.AppImage`
+- **DEB**: `StratoSortCore-<version>-linux-x64.deb`
 
 ## Configuration Files
 
 ### `electron-builder.json`
 
 - Configures build outputs and installer settings
 - Publishing is handled by GitHub Actions; build commands use `--publish never`
-- Clean artifact naming: `StratoSort-${version}-${os}-${arch}.${ext}`
+- Clean artifact naming: `StratoSortCore-${version}-${os}-${arch}.${ext}`
 
 ## Required Secrets
 

CHANGELOG.md

@@ -215,7 +215,7 @@ notes.
 - Accessibility: Added `aria-live="polite"` to AnalysisProgress for screen readers
 - Replaced hardcoded timeout values with centralized constants
 
-## [1.0.0] - 2024-12-XX
+## [1.0.0] - 2024-12-01
 
 ### Added
 

CLAUDE.md

@@ -65,7 +65,8 @@ npm run dist:win         # Build Windows installer
 
 - **IPC channels** are defined in `src/shared/constants.js` and validated in preload. Run
   `npm run generate:channels:check` to verify channel consistency.
-- **Services** follow dependency injection patterns documented in `docs/DI_PATTERNS.md`.
+- **Services** follow dependency injection via `ServiceContainer`
+  (`src/main/services/ServiceContainer.js`).
 - **Error handling** uses custom error types in `src/main/errors/` with a centralized error
   classifier.
 - **File operations** use atomic writes via `src/shared/atomicFileOperations.js` (write-to-temp then
@@ -101,21 +102,20 @@ These are tracked gaps that the project slash commands help address:
 - ~~Test coverage unknown~~ - 50% global thresholds (branches/functions/lines/statements) enforced
   in `test/jest.config.js`; 346 suites / 5,500+ tests passing.
 
-## Cursor Rules & Commands
-
-The following capabilities are available as Cursor Rules. You can invoke them by asking for the
-specific audit or check in natural language.
-
-| Request               | Purpose                               | Rule File                               |
-| :-------------------- | :------------------------------------ | :-------------------------------------- |
-| "Run security audit"  | Full Electron security audit          | `.cursor/rules/audit-security.mdc`      |
-| "Harden electron"     | Verify sandbox, CSP, webPreferences   | `.cursor/rules/harden-electron.mdc`     |
-| "Audit IPC"           | Validate IPC contracts and security   | `.cursor/rules/audit-ipc.mdc`           |
-| "Check test coverage" | Run tests, analyze coverage gaps      | `.cursor/rules/check-coverage.mdc`      |
-| "Pre-release check"   | Pre-release checklist validation      | `.cursor/rules/check-prerelease.mdc`    |
-| "Performance audit"   | Performance and memory analysis       | `.cursor/rules/audit-perf.mdc`          |
-| "Accessibility audit" | Accessibility/WCAG compliance audit   | `.cursor/rules/audit-a11y.mdc`          |
-| "Dependency audit"    | Dependency security and license audit | `.cursor/rules/audit-deps.mdc`          |
-| "Check build"         | Build config and packaging validation | `.cursor/rules/check-build.mdc`         |
-| "Validate state"      | State persistence and migration audit | `.cursor/rules/validate-state.mdc`      |
-| "Fix production gaps" | Interactive production gap fixer      | `.cursor/rules/fix-production-gaps.mdc` |
+## Audits & Checks
+
+The following audits can be invoked by asking in natural language:
+
+| Request               | Purpose                               |
+| :-------------------- | :------------------------------------ |
+| "Run security audit"  | Full Electron security audit          |
+| "Harden electron"     | Verify sandbox, CSP, webPreferences   |
+| "Audit IPC"           | Validate IPC contracts and security   |
+| "Check test coverage" | Run tests, analyze coverage gaps      |
+| "Pre-release check"   | Pre-release checklist validation      |
+| "Performance audit"   | Performance and memory analysis       |
+| "Accessibility audit" | Accessibility/WCAG compliance audit   |
+| "Dependency audit"    | Dependency security and license audit |
+| "Check build"         | Build config and packaging validation |
+| "Validate state"      | State persistence and migration audit |
+| "Fix production gaps" | Interactive production gap fixer      |

CONTRIBUTING.md

@@ -42,13 +42,11 @@ npm run dev
 
 ## Where to Learn the Codebase
 
-| Document                                       | Purpose                       |
-| ---------------------------------------------- | ----------------------------- |
-| [Learning Guide](docs/LEARNING_GUIDE.md)       | Onboarding and glossary       |
-| [Architecture](docs/ARCHITECTURE.md)           | System design and data flow   |
-| [DI Patterns](docs/DI_PATTERNS.md)             | Dependency injection patterns |
-| [Error Handling](docs/ERROR_HANDLING_GUIDE.md) | Error handling standards      |
-| [Code Quality](docs/CODE_QUALITY_STANDARDS.md) | Style and review expectations |
+| Document                                       | Purpose                     |
+| ---------------------------------------------- | --------------------------- |
+| [Architecture](docs/ARCHITECTURE.md)           | System design and data flow |
+| [Error Handling](docs/ERROR_HANDLING_GUIDE.md) | Error handling standards    |
+| [IPC Contracts](docs/IPC_CONTRACTS.md)         | IPC communication specs     |
 
 ## Development Workflow
 

README.md

@@ -23,6 +23,8 @@
 
 <p align="center">
   <a href="#features">Features</a> •
+  <a href="#download">Download</a> •
+  <a href="#support-and-feedback">Support</a> •
   <a href="#quick-start">Quick Start</a> •
   <a href="#documentation">Documentation</a> •
   <a href="#contributing">Contributing</a> •
@@ -31,10 +33,35 @@
 
 ---
 
-**StratoSort Core** transforms file chaos into intelligent order using privacy-first local AI. It
-automatically categorizes, tags, and organizes your documents completely offline—leveraging
-**built-in AI** (node-llama-cpp) for intelligence and **Orama** for semantic search—ensuring your
-data never leaves your machine. **Zero external dependencies required.**
+StratoSort Core helps you organize messy files with local AI that runs on your machine. It analyzes
+content (not just filenames), suggests where files belong, and gives you semantic search with
+Knowledge OS and graph tools. Your data stays local, and you can start with a normal installer - no
+CLI setup required.
+
+## Download
+
+### End Users (No CLI)
+
+<p>
+  <a href="https://github.com/iLevyTate/StratoSortCore/releases"><img src="https://img.shields.io/badge/Download-Latest%20Release-2ea44f?style=for-the-badge" alt="Download Latest Release" /></a>
+</p>
+
+- **Windows/macOS installers:**
+  [GitHub Releases](https://github.com/iLevyTate/StratoSortCore/releases)
+- **Step-by-step install help:** [Install Guide](docs/INSTALL_GUIDE.md)
+- **How to use the app:** [User Guide](docs/USER_GUIDE.md)
+- **Want to help test?** [Beta Tester Guide](docs/BETA_TESTER_GUIDE.md)
+
+## Support and Feedback
+
+If you run into an issue or have an idea, these links are the fastest way to help:
+
+- **Issues tab:** [View all issues](https://github.com/iLevyTate/StratoSortCore/issues)
+- **Report a bug:**
+  [Open bug report template](https://github.com/iLevyTate/StratoSortCore/issues/new?template=bug_report.md)
+- **Request a feature:**
+  [Open feature request issue](https://github.com/iLevyTate/StratoSortCore/issues/new)
+- **Contributing guide:** [CONTRIBUTING.md](CONTRIBUTING.md)
 
 ## Demo
 
@@ -146,15 +173,16 @@ See **[SECURITY.md](SECURITY.md)** for the complete security policy.
 
 ## Documentation
 
-| Document                                       | Description                              |
-| :--------------------------------------------- | :--------------------------------------- |
-| **[Install Guide](docs/INSTALL_GUIDE.md)**     | End-user install (Windows & Mac, no CLI) |
-| **[Getting Started](docs/GETTING_STARTED.md)** | Developer setup and build guide          |
-| **[Architecture](docs/ARCHITECTURE.md)**       | System design and data flow              |
-| **[Learning Guide](docs/LEARNING_GUIDE.md)**   | Codebase onboarding                      |
-| **[Graph Features](docs/FEATURES_GRAPH.md)**   | Knowledge Graph capabilities             |
-| **[IPC Contracts](docs/IPC_CONTRACTS.md)**     | IPC communication specifications         |
-| **[Release Guide](docs/RELEASING.md)**         | Release process and checks               |
+| Document                                           | Description                              |
+| :------------------------------------------------- | :--------------------------------------- |
+| **[Install Guide](docs/INSTALL_GUIDE.md)**         | End-user install (Windows & Mac, no CLI) |
+| **[User Guide](docs/USER_GUIDE.md)**               | Feature walkthrough for everyday use     |
+| **[Beta Tester Guide](docs/BETA_TESTER_GUIDE.md)** | Testing + bug reporting for contributors |
+| **[Getting Started](docs/GETTING_STARTED.md)**     | Developer setup and build guide          |
+| **[Architecture](docs/ARCHITECTURE.md)**           | System design and data flow              |
+| **[Graph Features](docs/FEATURES_GRAPH.md)**       | Knowledge Graph capabilities             |
+| **[IPC Contracts](docs/IPC_CONTRACTS.md)**         | IPC communication specifications         |
+| **[Release Guide](docs/RELEASING.md)**             | Release process and checks               |
 
 ## Contributing
 

SECURITY.md

@@ -9,9 +9,9 @@
 
 | Version | Supported          |
 | ------- | ------------------ |
-| 1.1.x   | :white_check_mark: |
-| 1.0.x   | :white_check_mark: |
-| < 1.0   | :x:                |
+| 2.0.x   | :white_check_mark: |
+| 1.1.x   | :x:                |
+| < 1.1   | :x:                |
 
 ## Security Design Principles
 
@@ -112,4 +112,4 @@ Contributors who report valid security issues will be acknowledged here (with pe
 
 ---
 
-_Last updated: January 2026_
+_Last updated: February 2026_

TESTING.md

@@ -1,6 +1,6 @@
 # StratoSort Core Testing Guide
 
-**Version:** 2.0.0  
+**Version:** 2.0.1  
 **Date:** 2026-02-13  
 **Purpose:** Single source of truth for manual QA and automated test expectations.
 

docs/ARCHITECTURE.md

@@ -258,9 +258,4 @@ We maintain separate queues to manage different types of bottlenecks:
 
 ## Code Standards
 
-For information on coding patterns, error handling, and dependency injection, refer to the other
-documentation files:
-
-- [CODE_QUALITY_STANDARDS.md](CODE_QUALITY_STANDARDS.md)
-- [DI_PATTERNS.md](DI_PATTERNS.md)
-- [ERROR_HANDLING_GUIDE.md](ERROR_HANDLING_GUIDE.md)
+For error handling patterns and utilities, see [ERROR_HANDLING_GUIDE.md](ERROR_HANDLING_GUIDE.md).