Skip to content

[T-122] Clean-machine quick-start verification (SC-6, doc 29 §10 checklist) with timed log #223

Open

Description

@CodewithJha

Task T-122 · Milestone M11 — Release 1.0 · Size S · Priority P0 · Epic #11

Implements 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 Unreleased updated 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

No one assigned

    Labels

    area:deployDocker images, compose, release packagingarea:evalEvaluation campaigns and success criteriamilestone:M11M11 — Release 1.0priority:P0Critical path / blocks otherssize:S<= 1 daytaskChild task of a milestone epictype:testTest suites and test infrastructure

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions