Commit 86aa9f2
committed
docs(kindle-dedrm): normalize the last PowerShell comment em dashes (G27)
Comment-only across all three files, proven by PowerShell token-stream identity.
- firewall.ps1: the five em dashes in its comment-based help become the `--`
form this repo's PowerShell already uses. The six em dashes inside
`Write-Output`/`Write-Error` strings are emitted bytes and are deliberately
untouched. This was the last .ps1/.psm1 in the tree carrying a comment em
dash; none remain anywhere.
- firewall.ps1: two comments describing the enable and disable guards move from
past to present tense.
- firewall.Tests.ps1: "the truthiness test this PR removed" becomes "the
truthiness test this suite rules out", replacing a branch back-reference a
future reader cannot follow with the artifact in front of them.
- sync-prep.sh: a comment claiming the script disables the firewall rule is
replaced. It does not; it prints the elevated command for a human to run.
Removed narration, preserved here: "`-not $rule.Enabled` was therefore always
false and a disabled rule was never re-enabled."; "a bare truthiness test took
the disable path even for a rule that was already disabled."; "the guard
collapses to the truthiness test this PR removed."; and the deleted
"# Disable firewall rule (requires admin)".
No firewall rule, update-lock step or deletion path was weakened. All five
protected scripts are absent from the diff, and none was executed.
Verified by an independent fresh-context refutation verifier:
- The sync-prep.sh comment states a safety property, so its truth was checked
rather than assumed. All 73 lines were analysed for execution constructs:
the only child process is a read-only status probe guarded by an execute-bit
test, the firewall text lives in `echo` calls and a quoted heredoc, and there
is no eval, backtick, exec, source, xargs, runas, sudo or shell -c anywhere.
The cited test assertion exists and passes at all nine call sites, including
the live-run case that exercises the code the comment sits above.
- Every em dash in the HEAD file was enumerated and classified by reading the
line, then cross-checked against the AST: lines 1-24 resolve to a single
comment token, and all six survivors are string-literal tokens. Diffing every
Write-Output/Write-Error line old versus new shows zero output change.
- Token-stream identity was re-derived independently rather than trusting a
count: comparing the full Kind|Text sequence and its SHA-256, both files match
exactly. The worker's 309/754 versus the verifier's 308/753 is an
EndOfInput counting convention, and retaining that token reproduces the
worker's numbers.
- The rewritten guard comments were checked to still prevent the defect
returning: they state the failure as a property of the guard shape, so a
future reader cannot simplify the correct comparison back into the bug. The
test file's new claim is verifiable from two cases asserting the guard text.
- No rule-defining token appears on any changed line; the rule name, direction,
action, program, profile and enabled flag are byte-identical.
- Pester 5.7.1: 10 passed, 0 failed, 1 skipped, and the skip is self-declared
via Set-ItResult with a stated reason rather than a silent environmental one.
sync-prep.test.sh: 73 ok, 0 failed.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LRWf55tWpxcSdpxEMh2eJD1 parent d17bc13 commit 86aa9f2
3 files changed
Lines changed: 16 additions & 14 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
| |||
13 | 13 | | |
14 | 14 | | |
15 | 15 | | |
16 | | - | |
17 | | - | |
18 | | - | |
19 | | - | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
20 | 20 | | |
21 | 21 | | |
22 | 22 | | |
| |||
71 | 71 | | |
72 | 72 | | |
73 | 73 | | |
74 | | - | |
75 | | - | |
76 | | - | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
77 | 78 | | |
78 | 79 | | |
79 | 80 | | |
| |||
102 | 103 | | |
103 | 104 | | |
104 | 105 | | |
105 | | - | |
106 | | - | |
| 106 | + | |
| 107 | + | |
107 | 108 | | |
108 | 109 | | |
109 | 110 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
35 | 35 | | |
36 | 36 | | |
37 | 37 | | |
38 | | - | |
| 38 | + | |
| 39 | + | |
39 | 40 | | |
40 | 41 | | |
41 | 42 | | |
| |||
Lines changed: 3 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
150 | 150 | | |
151 | 151 | | |
152 | 152 | | |
153 | | - | |
154 | | - | |
155 | | - | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
156 | 156 | | |
157 | 157 | | |
158 | 158 | | |
| |||
0 commit comments