diff --git a/README.md b/README.md index 591d151..970e56c 100644 --- a/README.md +++ b/README.md @@ -164,7 +164,7 @@ docker run --rm -v "$PWD:/repo:ro" flash-card-debian bash /repo/tools/docker/in- On Windows PowerShell write `${PWD}` for `$PWD`. The repository is mounted read-only and copied inside the container. - The desktop is Xvfb with GNOME's window manager (mutter). GNOME Shell is tried first and does not start in a container (it needs a login manager), so the scripts fall back to mutter and print which one ran. -- The Windows executable is checked in **Windows Sandbox** (Windows 11 Pro, feature enabled): `powershell -File tools\sandbox\run.ps1 -Runs 5` after `python tools/build_executable.py`. The sandbox shows its own window while it runs; the click is made inside the sandbox. +- The Windows executable is checked in **Windows Sandbox** (Windows 11 Pro, feature enabled; the version 0.2.0 build passed 5 of 5 runs, see RC-080): `powershell -File tools\sandbox\run.ps1 -Runs 5` after `python tools/build_executable.py`. The sandbox shows its own window while it runs; the click is made inside the sandbox. - Not covered: macOS (it cannot be run in Docker on Windows or Linux and Apple's licence allows it only on Apple hardware), and Windows itself in the Debian container. ## 📄 License diff --git a/docs/artifact-registry.md b/docs/artifact-registry.md index b20c733..267e2c5 100644 --- a/docs/artifact-registry.md +++ b/docs/artifact-registry.md @@ -25,7 +25,7 @@ document of a type. `Primary File` may contain a glob (e.g. | DCD | Design Class Diagram | docs/dcd.md | 002 | | DICT | Domain Dictionary | docs/dictionary.md | 002 | | ADR | Architecture Decision Record | docs/adr/adr-NNNN-*.md | 0006 | -| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 080 | +| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 081 | | TM | Traceability Matrix | docs/sqa/traceability-matrix.md | 002 | ## Languages diff --git a/docs/sqa/reviews/rc-080-sandbox-run.md b/docs/sqa/reviews/rc-080-sandbox-run.md new file mode 100644 index 0000000..197b462 --- /dev/null +++ b/docs/sqa/reviews/rc-080-sandbox-run.md @@ -0,0 +1,46 @@ +# RC-080: Windows Sandbox run of the executable + +## Metadata +| Key | Value | +| --- | --- | +| ID | RC-080 | +| CrossReference | [MIL-013], [RC-079] | + +## Version History +| Date | Status | Author | Reviewer | Change | Commit | +| --- | --- | --- | --- | --- | --- | +| 2026-10-15 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | pending | + +--- + +## Artifact Under Review + +- Instance reviewed: [MIL-013], criterion 7 (the Windows executable in Windows Sandbox), which [RC-079] left open +- Checklist used: none exists; criterion 7 of MIL-013 and the open condition of RC-072 (smoke test of the executable) +- Scope: delta re-review of criterion 7 of MIL-013 after the Product Owner started the run +- Language and domain: n/a (record of results) +- Language reviewer: none +- Mode: autonomous, not independent (reviewer is `AI as stand-in for S01`) + +## Checklist Results + +| # | Criterion | Status | Evidence/Notes | +| --- | --- | --- | --- | +| 7 | The Windows executable passes the smoke test inside Windows Sandbox (window titled Flashy, embedded list, list override, known button writes the progress file), 5 consecutive sandbox runs, with the results read from the mapped output folder | Pass | `tools/sandbox/run.ps1 -Runs 5` on Windows 11 Pro; the sandbox ran `Microsoft Windows 11 Enterprise`; `dist/flash-card.exe` (25.8 MB, built from the head of `main` before the container changes) mapped read-only; **5 of 5 runs passed**: window found, click made by the sandbox's own mouse at the known button, progress file with a header and 2 cards (3 rows), 4.5 to 5.2 s per run including the copy and the start; a screenshot of the sandbox desktop shows the card with the menu bar and both button images; the sandbox shut itself down and no sandbox process was left | +| RC-072 #4 | The executable passes the smoke test of MIL-009 | Pass | The list-override case (`ms-da.csv` next to the program, 3 words, one known word, 2 left) passed in all 5 runs; with the earlier 3 of 8 lost clicks on the host, the finding is that they came from the host click automation, not from the program | + +## Overall Verdict + +Go — criterion 7 of MIL-013 and the open condition of RC-072 on the smoke test of the executable are met. The issue "Run and record the checks" can be closed. The tag of v0.2.0 is still lightweight (RC-072 criterion 5) and the executable is still not attached to a release (upload limit of the host). Reviewed by AI as stand-in for S01; not independent of the author. + +## Action Items + +| Action | Owner | Due | +| --- | --- | --- | +| Decide whether the lightweight tag `v0.2.0` is replaced by an annotated tag (force update of the tag on the host) | S01 | 2026-10-21 | +| Raise the upload limit of the git host so that `flash-card.exe` and its checksum can be attached to a release | S01 | 2026-10-21 | + +--- + +[MIL-013]: ../milestones/mil-013-container-checks.md +[RC-079]: ./rc-079-container-checks.md diff --git a/docs/sqa/traceability-matrix.md b/docs/sqa/traceability-matrix.md index a8aff61..79a147d 100644 --- a/docs/sqa/traceability-matrix.md +++ b/docs/sqa/traceability-matrix.md @@ -58,7 +58,7 @@ updated whenever an artifact instance is created or reviewed. | MIL-010 | Milestone / Gateway | en | it | BC-001 | - | [RC-054], [RC-055] | | MIL-011 | Milestone / Gateway | en | it | BC-001 | - | [RC-065] | | MIL-012 | Milestone / Gateway | en | it | BC-001 | - | [RC-070], [RC-072] | -| MIL-013 | Milestone / Gateway | en | it | BC-001 | - | [RC-076], [RC-079] | +| MIL-013 | Milestone / Gateway | en | it | BC-001 | - | [RC-076], [RC-079], [RC-080] | | ADR-0005 | Architecture Decision Record | - | - | BC-001 | - | [RC-075] | | PY-MIL-001 | Python Source Code | - | - | DCD-001, ADR-0002 | - | [RC-023] | | PY-MIL-002 | Python Source Code | - | - | DCD-001, ADR-0002 | - | [RC-024] | @@ -214,3 +214,4 @@ updated whenever an artifact instance is created or reviewed. [PY-MIL-013]: ../../tools [SH-MIL-013]: ../../tools/docker [RC-079]: ./reviews/rc-079-container-checks.md +[RC-080]: ./reviews/rc-080-sandbox-run.md