Recent Decisions
Last reviewed: 2026-07-05
| Date | Decision | Reason | Source |
|---|---|---|---|
| 2026-07-05 | Keep AGENTS.md concise and place expanded operational docs under docs/core and docs/state. |
Repository already has concise operating contract; user requested docs/core and docs/state. | AGENTS.md, current documentation pass |
| 2026-07-05 | Treat the Python Server as a deterministic single-active-job worker. | worker.max_active_jobs is constrained to 1; manual claims block busy worker by default. |
src/anuva_python_server/config/settings.py, src/anuva_python_server/jobs/runner.py |
| 2026-07-05 | Keep Web App contracts behind webapp/ abstractions. |
Endpoint layout may evolve; real Web App is external. | AGENTS.md, src/anuva_python_server/webapp/client.py |
| 2026-07-05 | Prefer signed S3 upload for real Web App mode while retaining direct Payload fallback. | Web API doc says signed upload is current V1 path; client strategy supports both. | docs/AnuvaWeb_API_Doc.md, src/anuva_python_server/webapp/uploads.py |
| 2026-07-05 | Keep simulator behavior first-class. | Simulator has state machine, HTTP app, fake client, scenarios, tests, and launcher scripts. | src/anuva_python_server/simulator/, tests/integration/test_simulator_app.py |
| 2026-07-05 | Use localhost-only defaults for local worker services. | Reduces accidental exposure of dashboard/content/ZMQ/simulator surfaces. | src/anuva_python_server/config/settings.py, tests/unit/test_operations.py |
| 2026-07-05 | Validate local content URLs before sending render.start. |
Avoids claiming/running Unity against missing config/assets. | src/anuva_python_server/jobs/runner.py, tests/unit/test_output_and_completion.py |
| 2026-07-05 | Treat upload failure as uploadFailed plus a failure report. |
Preserves recoverability while surfacing failure to Web App. | src/anuva_python_server/jobs/runner.py, tests/unit/test_output_and_completion.py |
| 2026-07-05 | Generate a thumbnail artifact in Python completion flow. | Requirements/open question say thumbnail generation is Python-owned; code implements fallback PNG. | src/anuva_python_server/jobs/output.py |
| 2026-07-05 | Do not claim EXE-mode dashboard runs before Unity is ready. | Keeps Web App job queued if local Unity is not launched/ready. | docs/User_Guide.md, tests/unit/test_dashboard.py |
Update this file when a repository-visible architecture or workflow decision changes.