Skip to content

Commit a1fb6f0

Browse files
committed
Add VSC v2.10 CI artifact upload
1 parent efb6e77 commit a1fb6f0

3 files changed

Lines changed: 93 additions & 0 deletions

File tree

.github/workflows/vsc-conformance.yml

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,3 +42,16 @@ jobs:
4242
4343
- name: Run full VSC verification
4444
run: npm run vsc -- verify-all
45+
46+
- name: Create comparison report
47+
shell: bash
48+
run: |
49+
node -e "const fs = require('fs'); const data = JSON.parse(fs.readFileSync('comparison-result.json', 'utf8')); const lines = []; lines.push('# VSC CI Conformance Report'); lines.push(''); lines.push(\`Result: \${data.result}\`); lines.push(\`Fixtures total: \${data.fixtures_total}\`); lines.push(\`Fixtures passed: \${data.fixtures_passed}\`); lines.push(\`Fixtures failed: \${data.fixtures_failed}\`); lines.push(''); lines.push('## Comparisons'); lines.push(''); lines.push('| Fixture | Expected | Actual | Comparison |'); lines.push('|---|---:|---:|---|'); for (const item of data.comparisons || []) { lines.push(\`| \${item.fixture_id} | \${item.expected_result} | \${item.actual_result} | \${item.comparison} |\`); } fs.writeFileSync('comparison-report.md', lines.join('\n') + '\n');"
50+
51+
- name: Upload comparison artifacts
52+
uses: actions/upload-artifact@v4
53+
with:
54+
name: vsc-comparison-artifacts
55+
path: |
56+
comparison-result.json
57+
comparison-report.md

README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,17 @@ The JSON comparison output must be valid JSON and must report:
5252

5353
This CI check validates fixture-level comparison behavior and full repository verification status. It does not change VSC verification semantics.
5454

55+
### CI artifacts
56+
57+
Successful CI conformance runs publish downloadable workflow artifacts:
58+
59+
```text
60+
comparison-result.json
61+
comparison-report.md
62+
```
63+
64+
`comparison-result.json` is the machine-readable comparison result generated by `npm run vsc -- compare:fixtures --json`. `comparison-report.md` is a small human-readable summary of the same CI comparison result. These artifacts make CI conformance results easier to inspect and archive.
65+
5566
---
5667

5768
## Core Concept
Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# VSC v2.10 — CI Artifact Upload
2+
3+
Release: v2.10
4+
Project: DigiEmu VSC / VSC Core
5+
6+
## Summary
7+
8+
VSC v2.10 extends the CI conformance workflow introduced in v2.9.
9+
10+
The workflow now preserves the machine-readable comparison result as a downloadable GitHub Actions artifact.
11+
12+
This makes CI conformance runs easier to inspect, archive, and reference.
13+
14+
## Added
15+
16+
CI artifact upload for:
17+
18+
```text
19+
comparison-result.json
20+
comparison-report.md
21+
```
22+
23+
`comparison-result.json` is generated by:
24+
25+
```powershell
26+
npm run vsc -- compare:fixtures --json
27+
```
28+
29+
`comparison-report.md` is a lightweight human-readable report generated from the JSON comparison output.
30+
31+
## CI behavior
32+
33+
The workflow still validates:
34+
35+
```powershell
36+
npm run vsc -- compare:fixtures
37+
npm run vsc -- compare:fixtures --json
38+
npm run vsc -- verify-all
39+
```
40+
41+
CI fails unless the comparison JSON reports:
42+
43+
```json
44+
{
45+
"result": "COMPARE_PASS"
46+
}
47+
```
48+
49+
## Unchanged
50+
51+
v2.10 does not change:
52+
53+
- Go verifier semantics
54+
- Node runner comparison semantics
55+
- Conformance fixture expected results
56+
- PASS / FAIL / ERROR meaning
57+
- Evidence bundle verification logic
58+
59+
## Release meaning
60+
61+
v2.10 makes CI conformance output more auditable by preserving both machine-readable and human-readable comparison artifacts.
62+
63+
It continues the path from local verification to automated, inspectable repository-level conformance checks.
64+
65+
## Next possible step
66+
67+
```text
68+
v2.11 — CI Badge / README Conformance Status
69+
```

0 commit comments

Comments
 (0)