Skip to content

docs(smoke): capture-logs scripts + runbook sync (beta.52 + Module 15)#325

Merged
bilbospocketses merged 1 commit into
mainfrom
docs-smoke-capture-logs
Jun 9, 2026
Merged

docs(smoke): capture-logs scripts + runbook sync (beta.52 + Module 15)#325
bilbospocketses merged 1 commit into
mainfrom
docs-smoke-capture-logs

Conversation

@bilbospocketses

Copy link
Copy Markdown
Owner

What

Smoke-test review follow-ups: log-capture tooling + a doc sync. No app code; release:none.

New - capture scripts

  • docs/smoke-tests/capture-logs.sh (Linux) and capture-logs.ps1 (Windows). Run ... <test-id> at any checkpoint - especially the instant a test fails - to snapshot a complete evidence bundle (AVC denials, service journal+status, SELinux fcontext + labels, processes, dataRoot / Program Files / temp listings, config.json, app logs) into a timestamped, labeled folder + an archive to attach. Numbered output files map to each row's verify step.
  • The Windows script specifically captures the wipe leftover (control\operation-server\) and the temp cleaner copy, since the in-app uninstall cleaner is --no-log by design - so the filesystem/registry/temp state is the only evidence.
  • Wired references into all three docs (pre-flight, the stop-rules, and the 15.2 wipe row).

Runbook sync (it had drifted)

  • Smoke-target tag beta.50 -> beta.52 (missed when checklist + full were bumped).
  • Added the missing Module 15 (Windows in-app uninstall + stop-exit) in the plain-English box-table style.
  • Fixed the stale "69 tests" count -> 74.

full

  • Marked the wipe-self-deletion "VM decision to settle" as fixed in beta.52 (the bug beta.52 shipped this week).

Why

The smoke is the 0.1.30 gate and runs on VMs that can't be introspected remotely - a one-command evidence capture makes every failure diagnosable from the attached bundle instead of "it didn't work."

- New capture-logs.sh / capture-logs.ps1: one-shot diagnostic snapshots
  (AVC, service journal/status, fcontext, SELinux labels, processes,
  dataRoot / Program Files / temp listings, config, app logs) to a
  timestamped labeled folder + archive - run at any checkpoint, esp. on
  failure. The Windows one captures the wipe leftover + the temp cleaner
  copy (the in-app uninstall cleaner is --no-log by design).
- Wired references into all three docs (pre-flight + stop-rules + the 15.2 wipe row).
- smoke-runbook.md: bump smoke-target tag beta.50 -> beta.52 (missed in the
  earlier sync), add the missing Module 15 (Windows uninstall + stop-exit),
  fix the stale "69 tests" count -> 74.
- smoke-full.md: mark the wipe-self-deletion VM concern fixed in beta.52.
@bilbospocketses bilbospocketses added the release:none No auto-release (docs/chore); auto-release.yml hits Mode 3 and skips label Jun 9, 2026
@bilbospocketses bilbospocketses merged commit e600182 into main Jun 9, 2026
9 checks passed
@bilbospocketses bilbospocketses deleted the docs-smoke-capture-logs branch June 9, 2026 02:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release:none No auto-release (docs/chore); auto-release.yml hits Mode 3 and skips

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant