anthony.wen/cds-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Reorder ATVM status output and standardize push reminders

Browse Source
This commit is contained in:
anthony.wen
2026-03-27 11:57:19 -04:00
parent 4b04f9b49d
commit c60542e0e5
5 changed files with 36 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
atvm/docs/automation/guide.md
View File

@@ -213,11 +213,12 @@ When asked for one VM or a VM set:
## Status Reporting Format
When the operator asks for the status of an ATVM automation run, report in this order:
1. Heading/title using the run `build_name`.
2. `COVERAGE:` section describing what the run was intended to cover, excluding the target-host list.
3. `TEST FLOW:` section describing the template-specific numbered run flow for the test.
4. Completed machines with machine name first and status second for each machine.
5. Notes.
6. Skipped machines with reason.
2. `SUMMARY:` section with finished, passed, failed, and skipped counts.
3. `HOSTS:` section with the machine rows.
4. `TIMING:` section with start, end, total, quickest, longest, and average.
5. `COVERAGE:` section describing what the run was intended to cover, excluding the target-host list.
6. `TEST FLOW:` section describing the template-specific numbered run flow for the test.
7. `NOTES:` section for broader context and anomalies.
7. Remaining machines still to run.
8. Summary counts for finished, passed, failed, and skipped machines.
9. Timing details:
@@ -233,6 +234,7 @@ Status-report expectations:
- Use the same display layout for every ATVM automation status response regardless of test type (`e2e`, `systemOS`, `reboot`, `migrateops`, and others).
- Use `/home/aw/code/cds/atvm/docs/automation/status-template.md` as the default template for both local status output and Mattermost status posts.
- The default ATVM status template uses flat bullet-list sections for `COVERAGE:` and `TEST FLOW:`, Markdown tables for `SUMMARY:`, `HOSTS:`, and `TIMING:`, and uses `NOTES:` for flat operator-facing notes.
- Order the status sections as `SUMMARY:`, `HOSTS:`, `TIMING:`, `COVERAGE:`, `TEST FLOW:`, then `NOTES:`.
- The `HOSTS:` table includes `Host`, `Kernel`, `Status`, and `Detail` columns in that order.
- In `COVERAGE:`, describe the template, datastore/config family, migration style, and plugin/integration path, but do not list target hosts there.
- In `TEST FLOW:`, show the template-specific numbered run flow once for the whole test, not per host.

6
atvm/docs/automation/run-learnings.md
View File

@@ -252,3 +252,9 @@ This file stores run-specific examples only when a run produced a new learning r
- Action for future runs:
- For non-categorized runs, post only the parent run status and do not also post the single synthetic subrun.
- Keep the static `cmc-e2e` watcher flow aligned with the current 22-step ATVM E2E sequence.
## Run Learning: 2026-03-27 (Use summary-first status layout for ATVM run results)
- Observed requirement:
- The operator wants ATVM run results ordered as `SUMMARY:`, `HOSTS:`, `TIMING:`, `COVERAGE:`, `TEST FLOW:`, then `NOTES:`.
- Action for future runs:
- Render ATVM status output in that section order for both local output and Mattermost posts.

22
atvm/docs/automation/status-template.md
View File

@@ -10,16 +10,6 @@ Use this as the default ATVM automation run-status template for:
## ATVM Run Status
### <build_name>
**COVERAGE:**
- template: `<template-name>`
- datastore/config family: `<config family>`
- migration style: `<high-level test style>`
- integration/plugin path: `<integration/plugin>`
- scope of this run: `<batch or run scope>`
**TEST FLOW:**
- <template-specific numbered steps>
**SUMMARY:**
| Metric | Value |
@@ -49,13 +39,23 @@ Use this as the default ATVM automation run-status template for:
| longest | <host> - <runtime> or n/a |
| average | <runtime> or n/a |
**COVERAGE:**
- template: `<template-name>`
- datastore/config family: `<config family>`
- migration style: `<high-level test style>`
- integration/plugin path: `<integration/plugin>`
- scope of this run: `<batch or run scope>`
**TEST FLOW:**
- <template-specific numbered steps>
**NOTES:**
- <note>
- <note>
```
## Rules
- Keep `COVERAGE:`, `TEST FLOW:`, `SUMMARY:`, `HOSTS:`, `TIMING:`, and `NOTES:` in that order.
- Keep `SUMMARY:`, `HOSTS:`, `TIMING:`, `COVERAGE:`, `TEST FLOW:`, and `NOTES:` in that order.
- Use the title format:
- `## ATVM Run Status`
- `### <build_name>`