Skip to content

docs(dotfiles): bake the Windows layer's prerequisites into dot-windows (#1108) - #1111

Merged
Gerrrt merged 3 commits into
mainfrom
gerrrt/dot-windows-prereqs
Oct 9, 2026
Merged

Gerrrt merged 3 commits into
mainfrom
gerrrt/dot-windows-prereqs

Conversation

@Gerrrt

@Gerrrt Gerrrt commented Oct 9, 2026

Copy link
Copy Markdown
Owner

Covers #1108's "decide how to make the run less manual": the prerequisites now go into dot-windows before its clean snapshot.

Why

At the console, tester is a standard user. Every machine-wide install in the layer's configuration.dsc.yaml therefore asked for the Administrator password, and the 2026-10-08 run was mostly UAC prompts. Packages installed beforehand, machine-wide, are found present by winget configure, which then skips them.

Done on 198 today, and written into the runbook

test-the-dotfiles-layers.md §3 gains a bake script. It runs as Administrator over SSH, or as SYSTEM through the guest agent. It:

  • installs PowerShell 7.6.6, Git 2.56.0.2, WSL 3.0.1 and Wireshark 4.6.9, each downloaded from its publisher and checked against the SHA-256 the publisher states (GitHub release digests; Wireshark's SIGNATURES file);
  • turns on Developer Mode (AllowDevelopmentWithoutDevLicense);
  • turns on winget configure.

It leaves out, on purpose:

  • Windows Terminal, which ships with Windows 11;
  • Wget2, which installs per user;
  • Npcap, which has no free silent install, and capture isn't part of the test.

§4 drops winget configure --enable and winget install Git.Git Microsoft.PowerShell, and the run now starts in pwsh. It also drops the OOBE throwaway-account workaround, which #1093 plus 911's rebuild made unnecessary. And it says what to do if a UAC prompt still appears: approve it, and add that package to the bake.

Verified

  • All four downloads matched their published hashes, and every installer exited 0.
  • winget, run as SYSTEM, lists Git.Git, Microsoft.PowerShell, Microsoft.WSL and WiresharkFoundation.Wireshark at those versions. configure --enable exited 0.
  • clean was retaken while stopped.
  • Not verified: whether configure really asks for nothing at tester's console. That's the console run, still open on dotfiles: a complete Windows run on dot-windows, at the console (#920 follow-up) #1108.

markdownlint-cli2 and check_docs.py are clean.

🤖 Generated with Claude Code

…ws (#1108)

At the console, tester is a standard user, so each machine-wide install
in the layer's configuration.dsc.yaml asked for the Administrator
password. §3 now installs those packages before `clean` is taken:
PowerShell 7, Git, WSL and Wireshark, each checked against its
publisher's SHA-256. It also turns on Developer Mode and `winget
configure`. §4 drops the steps those cover, and the OOBE workaround that
#1093 made unnecessary. Done on 198 today; the as-run table and the
changelog record it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings October 9, 2026 20:41

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The SSH path cannot enable WinGet configuration, and native command failures are not detected.

1 open finding
What changed in this PR

Documents baking Windows prerequisites into dot-windows to reduce UAC prompts during layer testing.

Changes:

  • Adds a hash-verified prerequisite bake script.
  • Updates console-run instructions and operational history.
  • Records the completed bake in the changelog.
File Description
docs/​runbooks/​test-the-dotfiles-layers.md Adds bake and revised test procedure.
docs/​changelog.md Records the baked snapshot.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

…over SSH (#1108)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Gerrrt
Gerrrt enabled auto-merge (squash) October 9, 2026 20:51
…1108)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Gerrrt
Gerrrt merged commit 6779f2f into main Oct 9, 2026
13 of 24 checks passed
@Gerrrt
Gerrrt deleted the gerrrt/dot-windows-prereqs branch October 9, 2026 22:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants