Commit graph

13 commits

Author SHA1 Message Date
300b3ddb0a feat(01-01): initialize Python project with uv and dependencies
- Add pyproject.toml with FastAPI, SQLAlchemy, Pydantic dependencies
- Configure ruff linter with Python 3.12 target
- Create .env.example with documented environment variables
- Add README.md with development setup instructions
2026-01-25 20:08:14 +00:00
262a32673b docs(01): create phase plan
Phase 01: Core Infrastructure & Security
- 5 plans in 3 waves
- 3 parallel (Wave 1-2), 1 sequential (Wave 3)
- Ready for execution

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 19:59:49 +00:00
d07a204cd5 docs(01): research phase domain
Phase 01: Core Infrastructure & Security
- Standard stack identified (FastAPI, PostgreSQL, Caddy, systemd-nspawn)
- Architecture patterns documented (async DB, sandboxing, deterministic builds)
- Pitfalls catalogued (unsandboxed builds, non-determinism, connection pooling)
- Security-first approach with production-grade examples
2026-01-25 19:53:43 +00:00
a958beeac5 docs(01): capture phase context
Phase 01: Core Infrastructure & Security
- Implementation decisions documented
- Phase boundary established

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 19:46:57 +00:00
6175c45399 docs: add constraint to verify actual package versions
Never trust AI training data for versions - always check PyPI/npm registries

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 19:34:10 +00:00
52aaf9e365 docs: add ruff as Python tooling constraint
Use ruff for linting and formatting (replaces flake8, black, isort)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 19:33:13 +00:00
16b17ca2cf docs: create roadmap (9 phases)
Phases:
1. Core Infrastructure & Security: INFR-*, ISO-04
2. Overlay System Foundation: OVLY-01 to OVLY-07, OVLY-10
3. Build Queue & Workers: ISO-01 to ISO-07 (except ISO-04)
4. User Accounts: USER-01 to USER-15
5. Builder Interface (2D): BUILD-04 to BUILD-06, BUILD-09 to BUILD-11
6. Speeches & Community: SPCH-*, OVLY-11 to OVLY-14
7. 3D Visualization: BUILD-01 to BUILD-03, BUILD-07, BUILD-08
8. Advanced Dependency Resolution: OVLY-08, OVLY-09
9. Distribution Content: DIST-01 to DIST-10

All 70 v1 requirements mapped to phases.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 19:32:27 +00:00
f4d2185a56 docs: define v1 requirements
70 requirements across 7 categories:
- Builder Interface: 11
- ISO Generation: 7
- Speeches: 12
- User Accounts: 15
- Overlay System: 14
- Distribution Support: 10
- Infrastructure: 7

11 requirements deferred to v2

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 19:27:47 +00:00
c0ff95951e docs: add project research
Files:
- STACK.md: Technology stack recommendations (Python 3.12+, FastAPI, React 19+, Vite, Celery, PostgreSQL 18+)
- FEATURES.md: Feature landscape analysis (table stakes vs differentiators)
- ARCHITECTURE.md: Layered web-queue-worker architecture with SAT-based dependency resolution
- PITFALLS.md: Critical pitfalls and prevention strategies
- SUMMARY.md: Research synthesis with roadmap implications

Key findings:
- Stack: Modern 2026 async Python (FastAPI/Celery) + React/Three.js 3D frontend
- Architecture: Web-queue-worker pattern with sandboxed archiso builds
- Critical pitfall: Build sandboxing required from day one (CHAOS RAT AUR incident July 2025)

Recommended 9-phase roadmap: Infrastructure → Config → Dependency → Overlay → Build Queue → Frontend → Advanced SAT → 3D Viz → Optimization

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 02:07:11 +00:00
87116b1f56 chore: add project config
Mode: yolo
Depth: comprehensive
Parallelization: enabled
Workflow agents: research=on, plan_check=on, verifier=on

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 01:56:09 +00:00
6e033762ad docs: initialize project
Visual Linux distribution customization platform with 3D builder interface, starting with Omarchy/CachyOS.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 01:54:28 +00:00
85a91794e2 Upload files to "docs" 2026-01-25 01:32:49 +00:00
5078dd2b22 Upload files to "docs" 2026-01-25 01:31:57 +00:00