Refactor documentation and remove obsolete files

- Updated main README to direct users to the project root for full documentation.
- Consolidated backend and frontend README files into the main documentation.
- Changed frontend installation commands from Yarn to NPM in agent instructions.
- Deleted outdated backend and frontend README files to streamline documentation.
- Removed symmetry-unified-backend README to centralize information in the main README.

Author: franc00018

README.md

@@ -67,7 +67,6 @@
     "tailwind-merge": "^2.3.0",
     "tailwindcss-animate": "^1.0.7"
   },
-  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e",
   "overrides": {
     "tar": "^7.5.11",
     "tmp": "^0.2.4",

desktop-electron-frontend/README.md

@@ -1,176 +1,13 @@
 # Project Symmetry — Documentation
 
-Cross-language Wikipedia article gap analysis tool.
+> The main README at the project root contains the full documentation (setup, architecture, API reference, CI/CD, contributing).
+> See [../README.md](../README.md).
 
 ---
 
-## Documents
+## Additional Documents
 
 | File | Description |
 |------|-------------|
-| [backend/README.md](./backend/README.md) | Backend API reference, architecture, configuration |
-| [frontend/README.md](./frontend/README.md) | Frontend architecture, project structure, development |
 | [similarity-threshold-algorithm.md](./similarity-threshold-algorithm.md) | Complete similarity scoring algorithm documentation (prototype + production) |
 | [agent-instructions.md](./agent-instructions.md) | LLM/agent development instructions, conventions, pitfalls |
-
----
-
-## Overview
-
-**A semantic analysis tool that compares Wikipedia articles across languages section-by-section and paragraph-by-paragraph to identify content gaps, missing information, and added content.**
-
-Repository: [grey-box/symmetry-project](https://github.com/grey-box/symmetry-project)
-
-![CI](https://github.com/grey-box/symmetry-project/actions/workflows/ci.yml/badge.svg) ![Release](https://github.com/grey-box/symmetry-project/actions/workflows/release.yml/badge.svg) ![Latest Release](https://img.shields.io/github/v/release/grey-box/symmetry-project)
-
----
-
-## Tech Stack
-
-| Layer | Technologies |
-|-------|-------------|
-| Frontend | Electron 26 + React 18 + TypeScript + Vite + Tailwind CSS + shadcn/ui |
-| Backend | Python + FastAPI + sentence-transformers + spaCy + MarianMT |
-| Comparison Engine | LaBSE sentence embeddings (cosine similarity) + Levenshtein distance |
-
----
-
-## Prerequisites
-
-- Node.js v18+
-- Python 3.8–3.11
-- yarn / npm
-- Docker (optional, for containerized deployment)
-
----
-
-## Quick Start
-
-### Unified Script (Recommended)
-
-```bash
-# Start both backend and frontend
-./start.sh all
-
-# Start with frontend in development mode
-./start.sh all --dev
-```
-
-### Docker Compose
-
-```bash
-./start.sh docker       # Foreground
-./start.sh docker-up    # Detached
-./start.sh docker-down  # Stop
-```
-
-### Manual — Backend
-
-```bash
-cd symmetry-unified-backend
-python3 -m venv venv
-source venv/bin/activate
-pip install -r requirements.txt
-uvicorn app.main:app --reload --host 127.0.0.1 --port 8000
-```
-
-### Manual — Frontend
-
-```bash
-cd desktop-electron-frontend
-yarn install
-yarn start
-```
-
----
-
-## Access Points
-
-- **Frontend**: <http://localhost:5173>
-- **Backend API**: <http://localhost:8000>
-- **API Documentation (Swagger)**: <http://localhost:8000/docs>
-
----
-
-## Docker Images
-
-Released images are available from GHCR:
-
-```bash
-# Pull specific version
-docker pull ghcr.io/grey-box/symmetry-project/backend:1.1.0
-docker pull ghcr.io/grey-box/symmetry-project/frontend:1.1.0
-
-# Pull latest
-docker pull ghcr.io/grey-box/symmetry-project/backend:latest
-docker pull ghcr.io/grey-box/symmetry-project/frontend:latest
-```
-
----
-
-## API Endpoints Summary
-
-### Section Comparison (Primary)
-
-- `POST /symmetry/v1/articles/compare-sections` — Compare two Wikipedia articles section-by-section with paragraph-level diffs
-
-### Structured Wiki
-
-- `GET /symmetry/v1/wiki/structured-article` — Parse article into sections/citations/references
-
-### Legacy Comparison
-
-- `POST /symmetry/v1/articles/compare` — Plain-text semantic comparison
-
-### Models Management
-
-- `GET /models/comparison` — List comparison models
-
-See [backend/README.md](./backend/README.md) for the full API reference.
-
----
-
-## Testing
-
-```bash
-cd symmetry-unified-backend
-source venv/bin/activate
-python -m pytest              # Run all tests
-python -m pytest -v           # Verbose
-python -m pytest --cov=app    # With coverage
-```
-
----
-
-## CI/CD
-
-GitHub Actions workflows:
-
-| Workflow | Trigger | What it does |
-|----------|---------|-------------|
-| **CI** (`.github/workflows/ci.yml`) | Push/PR to `main` or `develop` | Runs backend tests, builds frontend web bundle, builds & smoke-tests frontend Docker image, runs docker-compose integration |
-| **Release** (`.github/workflows/release.yml`) | Push to `main` | Runs full CI → bumps version (semver) → creates git tag → creates GitHub release → publishes Docker images to GHCR |
-
----
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/your-feature`)
-3. Install dependencies (see Quick Start above)
-4. Make changes and run tests
-5. Use [Conventional Commits](https://www.conventionalcommits.org/) for commit messages
-6. Submit a pull request to `develop`
-7. After review, PRs are merged to `develop`, then promoted to `main` for release
-
----
-
-## Community
-
-- **Project Website**: <https://www.grey-box.ca/project-symmetry/>
-- **GitHub Issues**: <https://github.com/grey-box/Project-Symmetry-AI/issues>
-- **Design Resources (Figma)**: <https://www.figma.com/design/yN89gDcV3rdbje70X9RJGL/Project-Symmetry>
-
----
-
-**Last Updated**: April 2026 | **Version**: 2.0.0 | **Maintainers**: [grey-box](https://github.com/grey-box)

desktop-electron-frontend/package.json

@@ -33,9 +33,9 @@ python -m pytest -v --tb=short      # verbose with short tracebacks
 
 ```bash
 cd desktop-electron-frontend
-yarn install
-yarn start                # dev mode
-yarn build                # production build
+npm install
+npm start                # dev mode
+npm run build            # production build
 ```
 
 ---