Windows diagnostic collection and analysis toolkit producing structured, machine-readable findings from system evidence.
This repository has been archived on 2026-09-16. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Dandaedre 91eb474dc0
Win Diagnostics CI All diagnostic checks passed.
Beffroi/win-diagnostics/pipeline/head This commit looks good Details
chore: move test tooling under tests
2026-09-16 02:55:49 +02:00
docs chore: move test tooling under tests 2026-09-16 02:55:49 +02:00
examples feat: define diagnostic v1 contract and evidence validator 2026-09-15 16:32:36 +02:00
rules refactor: port diagnostic runtime to shell and jq 2026-09-16 00:27:49 +02:00
schemas feat: migrate first diagnostic event rule batch 2026-09-15 22:47:19 +02:00
tests chore: move test tooling under tests 2026-09-16 02:55:49 +02:00
tools fix: mark incomplete legacy collections 2026-09-16 02:50:15 +02:00
.gitignore feat: define diagnostic v1 contract and evidence validator 2026-09-15 16:32:36 +02:00
Jenkinsfile chore: move test tooling under tests 2026-09-16 02:55:49 +02:00
LICENSE Initial commit 2026-09-15 14:51:04 +02:00
README.md docs: simplify diagnostic usage 2026-09-16 02:02:45 +02:00

README.md

Win Diagnostics

Win Diagnostics turns stored Windows captures into versioned, traceable diagnostic.json files. It does not render PDFs.

Analyse one capture

bash tools/analyse.sh capture.json \
  --evidence-root /path/to/evidence \
  --output diagnostic.json \
  --reference-time 2026-09-15T12:00:00Z \
  --producer-version "$(git rev-parse HEAD)"

The result records collection coverage, source JSON pointers, reviewed findings, and unmatched evidence marked unanalysed.

Analyse everything in a directory

bash tools/analyse-all.sh /path/to/captures \
  --evidence-root /path/to/evidence \
  --output-dir /path/to/diagnostics \
  --reference-time 2026-09-15T12:00:00Z \
  --producer-version "$(git rev-parse HEAD)"

Validate

bash tools/validate.sh diagnostic.json --evidence-root /path/to/evidence
bash tools/validate-all.sh /path/to/diagnostics --evidence-root /path/to/evidence

See docs/diagnostic-contract.md for the file format, docs/standalone.md for operating guidance, and docs/development.md for tests and rule maintenance.