Repository navigation
Description
Task
T-122· Milestone M11 — Release 1.0 · Size S · Priority P0 · Epic #11Implements NFR-USE-001 · NFR-DEP-001
Branch
test/t-122-clean-machine-quick-start-verification— one task = one branch = one PR (doc 32 §6)
Summary
On a fresh machine/VM, follow only the README to install from the release-candidate images, start the demo, run a campaign, open the report; record timings and run doc 29 §10 post-deployment checklist in docs/evidence/T-122-clean-machine.md.
Context / motivation
SC-6 / release go-no-go (doc 26 §9).
Scope
In scope
- Linux; macOS/Windows (WSL2) if available.
Implementation guidance
- Clean environment: a new VM (Ubuntu 24.04, 4 vCPU / 8 GB) or a fresh user account with only Docker installed; follow the README quick-start verbatim with the RC images (
ROBOPROBE_IMAGE_TAG=vX.Y.Z-rc.N). - Time each step (pull, start, open dashboard, start campaign, first failure, report export) and tick the doc 29 §10 checklist item by item in the evidence.
- Any README deviation is fixed in the same PR; product problems are filed as issues.
- Standards: respect the layering contracts (doc 16 §2) and conventions in doc 34; no hard-coded tunables — thresholds/defaults come from typed settings (doc 27); no magic numbers (ruff
PLR2004); public APIs typed (mypy strict) and documented.
Acceptance criteria
- Checklist fully green; time-to-first-campaign ≤ 5 min after images pulled.
- Every doc 29 §10 checklist item ticked with evidence.
- README changes (if any) merged before release.
- Tests listed below added and green in CI; coverage of new code meets the gate in doc 18 §3.
- Docs, config reference and CHANGELOG
Unreleasedupdated where behaviour, keys or interfaces changed. - Definition of Done (doc 32 §3) satisfied.
Tests required
- N/A (verification).
Dependencies
Blocked by: #222 (T-121), #221 (T-124)
Blocks: #224 (T-123)
Parallelization notes
Files / paths owned by this task — avoid editing other paths; shared files (pyproject.toml entry points, cli/main.py, api/routers/__init__.py, router.tsx, docker/compose.yaml, ci.yml) are append-only:
docs/evidence/T-122-clean-machine.md
Sequential.
Definition of Done
Per doc 32 §3 and AGENTS.md §5: lint, format, mypy strict and import-linter green; tests added and passing; docs updated; PR template completed with Closes #<this issue>; Conventional Commit messages referencing T-122 (doc 16 §6); commits authored only by the repository owner identity (AGENTS.md §4); CI green; reviewer checklist (doc 32 §5.1) satisfied.
References
Design docs: doc 29 §10 · doc 26 §9 · doc 01 §7
Requirements: NFR-USE-001 · NFR-DEP-001 (traceability: doc 28)
Metadata
Metadata
Assignees
Labels
Projects
- StatusShow more project fieldsBacklog
Activity
release.yml: on tag → images, GitHub Release with CHANGELOG section, SBOMs, demo report #221