Compare snapshots on configuration, leave session copies out, spell JSON values as the listing does

[donislawdev]

Package E of the stability report: snapshot comparison and the spelling of values in machine-readable output.

What changes for somebody using the tool

• snapshot diff --exit-code and "differs" answer about configuration only. An entry added or removed, or one set up differently, ends with 5. An entry that only stopped or started by itself is still reported, under "Changed" and marked as running state, and no longer fails a nightly check.
• Per-user session copies are left out of a comparison and counted - one line at the top of the text report, "instancesLeftOut": {"earlier": n, "later": n} in --json. Matched by the role the type bits give an entry, never by its name. The template is still compared.
• Snapshot schema 5. The metadata records operatingSystemVersion (Windows down to the monthly update, e.g. 10.0.26200.9550) and namesLanguage (the language the service manager names things in). Version 4 files are still read and compared, with a line saying what they do not record. A version 5 file is refused by 0.3.0.
• New caveats in the comparison: a different Windows update, a different account, a different names language (display names and descriptions are then not compared on any entry), and notKnown in --json for metadata one side does not carry.
• Fixed: a snapshot with a null in an entry's notRead list gets a sentence naming the entry and exit code 2 instead of a null dereference and exit code 1. snapshot create given a folder refuses at once instead of verifying every signature and then failing with "Access to the path is denied".
• Breaking in 0.x: every enumerated value in the JSON of a plan (action, operation, reason, outcome, skippedBecause, warning kind) and of a comparison (group) is spelled the way the listing and the snapshot spell theirs - "Succeeded" beside "Running". Table of old and new values in CHANGELOG.md.

How it was checked

• Narrow test runs of the classes this touches (core, command line, architecture, the text guards of the window, integration) - green after two passes. The full gate was not run.
• Mutations of the new and re-anchored entries and their neighbours: 51 of 51 caught.
• On a real machine, read-only: snapshot create <folder> refuses in 239 ms with exit code 2 (1545 ms and "Access denied" before), a fresh snapshot compared with the live machine reports nothing and 23 session copies left out on each side, a hand-damaged notRead gets the sentence and exit code 2, a file rewritten as schema 4 compares with exit code 0 and the notKnown line, bws restart AxInstSV --dry-run --json writes Restart, Start/Requested and RestartOnlyStarts.

Not checked

• Whether the service manager names services in the calling user's own display language - only the calling thread's language was measured (it has no effect). Two accounts on one machine are caught by the "different account" caveat.
• A comparison of two real machines with different system languages.

🤖 Generated with Claude Code

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Repository UI (base), Organization UI (inherited)

Review profile: ASSERTIVE

Plan: Advanced

Run ID: b7522d93-087d-456d-9513-41c81a73c0fa

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}