Repository navigation
Commit 6ac8f35
feat: upload validation evidence per file and link it from the proof comment (#35)
## Overview
Validation evidence (screenshots, recordings, logs) is uploaded one
non-archived artifact per file, and the proof comment links every file
so it opens in the browser from the issue.
- New `upload-artifacts` operation: uploads each file under
`artifact_path` plus the result JSON via `@actions/artifact`
`skipArchive`; emits `artifact_links` / `artifact_count`; never fails
the step.
- Proof comment: `Artifacts` row (file count, links to the run's
artifact list), a download command under the overview table, and links
wherever an evidence cell mentions an uploaded file.
- `octestra.sh artifacts RUN_ID [DIR]`: bulk download through the API,
because `gh run download` cannot fetch non-archived artifacts
([cli/cli#13012](cli/cli#13012), noted in
`TODO.md`).
- Contract: the example cites evidence by relative path, and
`check-output.sh` rejects absolute paths and warns about missing files
when given the artifact directory.
- Template: the validation job runs `upload-artifacts` after the agent
(`if: always()`) and passes `artifact_links` to finalize.
<details>
<summary>Example proof comment (rendered from this branch; links point
at a made-up run)</summary>
## ✅ Passed validation proof
The settings screen opens from the home screen and every acceptance
criterion holds.
| Target | Result |
| --- | --- |
| Pull request | #57 |
| Validated commit | `0123456789ab` |
| Outcome | ✅ Passed |
| Known gaps | 1 |
| Artifacts | [5
files](https://github.com/example-org/consumer/actions/runs/123456#artifacts)
|
Download all files from a checkout of this repository:
```sh
.github/octestra/octestra.sh artifacts 123456
```
### Acceptance criteria
| ID | Criterion | Result | Evidence |
| --- | --- | --- | --- |
| AC-1 | The home screen shows the album title | ✅ Passed |
[screens/01-home.png](https://github.com/example-org/consumer/actions/runs/123456/artifacts/1001)
|
| AC-2 | Tapping the gear opens Settings | ✅ Passed |
[screens/02-settings.png](https://github.com/example-org/consumer/actions/runs/123456/artifacts/1002);
[journey.mp4](https://github.com/example-org/consumer/actions/runs/123456/artifacts/1003)
|
### Checks
| Check | Type | Scope | Result | Evidence |
| --- | --- | --- | --- | --- |
| Build (Debug) | build | — | ✅ Passed |
[logs/build.log](https://github.com/example-org/consumer/actions/runs/123456/artifacts/1004)
|
| Home → Settings journey | agentic E2E | AC-1, AC-2 | ✅ Passed |
[journey.mp4](https://github.com/example-org/consumer/actions/runs/123456/artifacts/1003)
|
### Evidence
| Evidence | Type | Reference |
| --- | --- | --- |
| Home screen after launch | image |
[screens/01-home.png](https://github.com/example-org/consumer/actions/runs/123456/artifacts/1001)
|
| Settings screen | image |
[screens/02-settings.png](https://github.com/example-org/consumer/actions/runs/123456/artifacts/1002)
|
| Journey recording | video |
[journey.mp4](https://github.com/example-org/consumer/actions/runs/123456/artifacts/1003)
|
### Known gaps
- Only the English locale was checked.
<details>
<summary>Additional details</summary>
1. Built the app and launched it on the simulator.
2. Opened Settings from the gear icon and recorded the journey.
</details>
<details>
<summary>Technical metadata</summary>
| Field | Value |
| --- | --- |
| Issue | #42 |
| Pull request | #57 |
| Subject SHA | `0123456789abcdef0123456789abcdef01234567` |
| Workflow run | [View
run](https://github.com/example-org/consumer/actions/runs/123456) |
| Run attempt | 1 |
| Actor | @Octestra[bot] |
| Task owner | @task-owner |
| Recorded at | 2026-09-29T12:00:00.000Z |
</details>
</details>
## Notes
- Evidence linking matches relative paths, and file names when unique,
anywhere in a cell: with a directory prefix, inside backticks, or glued
to prose. `xhome.png` / `home.png.bak` stay untouched. Nothing uploaded
→ comment identical to today's.
- Hidden entries are skipped as `actions/upload-artifact` does; symlinks
to files are followed; 500 artifacts per job is GitHub's cap.
- `octestra.sh artifacts` saves under `$TMPDIR` by default so the
checkout stays clean; archived artifacts get `.zip`.
## Verification
- `make all`: typecheck, vitest (116), ruby,
installer/maintenance/workflow tests, `dist/index.js` rebuilt.
- Probe run on a throwaway branch: four sample files uploaded
non-archived from this branch, served inline with the right content
type, and fetched back with `octestra.sh artifacts`.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---------
Co-authored-by: Claude Fable 5.1 <[email protected]>1 parent ddd241a commit 6ac8f35
20 files changed
Lines changed: 3394 additions & 275 deletions
File tree
- dist
- docs
- src
- lifecycle
- templates
- .github
- octestra
- workflows
- skills/octestra-contracts
- scripts
- test
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
37 | 37 | | |
38 | 38 | | |
39 | 39 | | |
40 | | - | |
| 40 | + | |
41 | 41 | | |
42 | 42 | | |
43 | 43 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
79 | 79 | | |
80 | 80 | | |
81 | 81 | | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
41 | 41 | | |
42 | 42 | | |
43 | 43 | | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
44 | 50 | | |
45 | 51 | | |
46 | 52 | | |
| |||
97 | 103 | | |
98 | 104 | | |
99 | 105 | | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
100 | 110 | | |
101 | 111 | | |
102 | 112 | | |
| |||
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
171 | 171 | | |
172 | 172 | | |
173 | 173 | | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
| 181 | + | |
| 182 | + | |
| 183 | + | |
| 184 | + | |
| 185 | + | |
| 186 | + | |
| 187 | + | |
| 188 | + | |
| 189 | + | |
| 190 | + | |
| 191 | + | |
| 192 | + | |
| 193 | + | |
| 194 | + | |
| 195 | + | |
| 196 | + | |
| 197 | + | |
| 198 | + | |
| 199 | + | |
| 200 | + | |
| 201 | + | |
174 | 202 | | |
175 | 203 | | |
176 | 204 | | |
| |||
0 commit comments