Refactor codebase, enhance documentation, and add new features

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,44 @@
+---
+name: Bug report
+about: Report a reproducible problem in training, inference, API, or UI
+title: "[Bug]: "
+labels: bug
+assignees: ""
+---
+
+## Summary
+
+A short description of the bug.
+
+## Area
+
+- [ ] C++ core
+- [ ] Backend API
+- [ ] Frontend UI
+- [ ] PyTorch engine
+- [ ] iGPU path
+- [ ] Docs
+
+## Steps To Reproduce
+
+1. Go to "..."
+2. Run "..."
+3. See error
+
+## Expected Behavior
+
+What should have happened instead?
+
+## Actual Behavior
+
+What happened?
+
+## Logs Or Screenshots
+
+Paste relevant output, stack traces, or screenshots here.
+
+## Environment
+
+- OS:
+- Compiler / Python / Node version:
+- GPU / CPU:

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions and general discussion
+    url: https://github.com/Eamon2009/Quadtrix.cpp/discussions
+    about: Use discussions for ideas, questions, and open-ended conversation.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,24 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: "[Feature]: "
+labels: enhancement
+assignees: ""
+
+---
+
+## Problem
+
+What limitation or workflow pain are you running into?
+
+## Proposed Solution
+
+Describe the change you would like to see.
+
+## Alternatives Considered
+
+What other approaches did you consider?
+
+## Additional Context
+
+Add mockups, examples, references, or related issues here.

.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "npm"
+    directory: "/frontend"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "pip"
+    directory: "/backend"
+    schedule:
+      interval: "weekly"

.github/pull_request_template.md

@@ -0,0 +1,14 @@
+## Summary
+
+Describe the change and the user-facing impact.
+
+## Checks
+
+- [ ] C++ build still works
+- [ ] Backend changes were smoke-tested locally
+- [ ] Frontend build still passes
+- [ ] Docs or screenshots were updated if needed
+
+## Notes
+
+Anything reviewers should pay attention to, including follow-up work or known limitations.

.github/workflows/ci.yml

@@ -0,0 +1,75 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - exp
+      - master
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  cpp-build:
+    name: C++ build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Install compiler
+        run: sudo apt-get update && sudo apt-get install -y g++
+
+      - name: Build Quadtrix
+        run: g++ -std=c++17 -O2 -I. -Iinclude -o quadtrix main.cpp
+
+  backend-smoke:
+    name: Backend smoke checks
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install backend runtime dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install fastapi "uvicorn[standard]" pydantic pydantic-settings httpx redis
+
+      - name: Compile Python sources
+        run: python -m compileall backend engine iGPU
+
+      - name: Import FastAPI application
+        working-directory: backend
+        run: |
+          python -c "from main import app; print(app.title)"
+
+  frontend-build:
+    name: Frontend build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install frontend dependencies
+        working-directory: frontend
+        run: npm ci
+
+      - name: Build frontend
+        working-directory: frontend
+        run: npm run build

.github/workflows/release.yml

@@ -0,0 +1,57 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  build-release:
+    name: Build release artifacts
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Build C++ binary
+        run: g++ -std=c++17 -O2 -I. -Iinclude -o quadtrix main.cpp
+
+      - name: Compile Python sources
+        run: python -m compileall backend engine iGPU
+
+      - name: Build frontend
+        working-directory: frontend
+        run: |
+          npm ci
+          npm run build
+
+      - name: Package release files
+        run: |
+          tar \
+            --exclude='*.pt' \
+            --exclude='engine/logs' \
+            --exclude='__pycache__' \
+            -czf quadtrix-linux.tar.gz \
+            quadtrix README.md LICENSE run.md backend engine iGPU include src data config frontend/dist
+
+      - name: Create GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: quadtrix-linux.tar.gz
+          generate_release_notes: true

.gitignore

@@ -7,5 +7,10 @@ libtorch-win-shared-with-deps-2.11.0+cpu (2)
 frontend/node_modules/
 frontend/dist/
 .venv
+.npm-cache/
 build
-CMakeCache.txt
+CMakeCache.txt
+engine/fine-tune/input.txt
+*best_model.pt
+*.pt
+*exe

.npmignore

@@ -0,0 +1,25 @@
+__pycache__/
+*.pyc
+*.pyo
+*.pt
+*.bin
+*.exe
+.git/
+.github/
+.npm-cache/
+.venv/
+.vscode/
+build/
+frontend/node_modules/
+frontend/src/
+frontend/public/
+frontend/package-lock.json
+frontend/package.json
+frontend/postcss.config.js
+frontend/tailwind.config.ts
+frontend/tsconfig.json
+frontend/vite.config.ts
+engine/logs/
+engine/fine-tune/
+engine/fineweb_30mb.txt
+engine/data/input.txt

.vscode/c++.json

@@ -13,7 +13,7 @@
                         "_UNICODE"
                   ],
                   "windowsSdkVersion": "10.0.19041.0",
-                  "compilerPath": "C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.34.31933/bin/Hostx64/x64/cl.exe",
+                  "compilerPath": "",
                   "cStandard": "c17",
                   "cppStandard": "c++17",
                   "intelliSenseMode": "windows-msvc-x64",

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eamon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.