Skip to content

Commit e8146cf

Browse files
raffelinoclaude
andcommitted
docs: add smoke-test step to release-tasks skill
Adds step 10: extract, install, start, and verify the built offline ZIP on the current platform before releasing. Catches issues like missing wheels or dependency conflicts early. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent bfda1df commit e8146cf

1 file changed

Lines changed: 37 additions & 1 deletion

File tree

.claude/skills/release-tasks/SKILL.md

Lines changed: 37 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,4 +68,40 @@ bash scripts/build-online-mac-and-linux.sh
6868
Verify:
6969
- All ZIPs are created under `dist/`
7070
- Spot-check at least one ZIP: extract it, confirm it contains `frontend_dist/`, `backend/`, install/start scripts, and wheels
71-
- Ensure the version in the built artifacts matches the release version
71+
- Ensure the version in the built artifacts matches the release version
72+
73+
## 10. Smoke-Test the Distribution ZIP
74+
75+
Before releasing, do a real smoke-test of the built archive for the current platform:
76+
77+
```bash
78+
# 1. Extract the ZIP into a temporary directory
79+
SMOKE_DIR=$(mktemp -d)
80+
unzip dist/roboscope-offline-*.zip -d "$SMOKE_DIR"
81+
cd "$SMOKE_DIR/roboscope-offline-"*
82+
83+
# 2. Run the install script (macOS/Linux)
84+
bash install.sh
85+
# On Windows: install-windows.bat
86+
87+
# 3. Start the server
88+
bash start.sh &
89+
# On Windows: start-windows.bat
90+
91+
# 4. Wait for startup and verify
92+
sleep 5
93+
curl -sf http://localhost:8145/api/v1/health && echo "Health OK"
94+
curl -sf http://localhost:8145/ | head -5 && echo "Frontend OK"
95+
96+
# 5. Clean up
97+
kill %1 2>/dev/null
98+
rm -rf "$SMOKE_DIR"
99+
```
100+
101+
Verify:
102+
- Install script completes without dependency resolution errors
103+
- Server starts and responds on the configured port
104+
- Frontend is served correctly
105+
- Health endpoint returns OK
106+
107+
If the smoke-test fails (e.g., missing wheels, dependency conflicts), fix the build script and rebuild before proceeding.

0 commit comments

Comments
 (0)