Skip to content

Record the installer divergence, and why the dead block stays - #699

Merged
MongLong0214 merged 2 commits into
mainfrom
docs-post-101-state
Aug 16, 2026
Merged

Record the installer divergence, and why the dead block stays#699
MongLong0214 merged 2 commits into
mainfrom
docs-post-101-state

Conversation

@MongLong0214

Copy link
Copy Markdown
Owner

Documentation only. Continues docs/handoff/20260815-after-v1.md past v1.0.1.

Two things came out of looking at what v1.0.1's fixes touched:

The part worth keeping

Two assertions passed for years while the shell wired nothing:

test/agent-configs.test.ts   host config paths are present in install.sh
T-1121                       both installers say the same sentences, so they cannot drift

Presence, not reachability. Parity between a live script and a dead block. #689,
#697 and half of #660 were invisible underneath them.

An assertion that names a file is not an assertion that the file does
anything.

And why #691 stays open

install.sh's 291 dead lines look deletable. install.ps1's wiring is not their
dead twin — it delegates and wires, so Windows does every host twice. The Codex
gap proves the two sides are not equivalent, so the order is fixed: confirm the
enumeration performs each row, remove the duplicate, then the dead block. The
reverse deletes a step nothing else performs, on a platform the author cannot
run.

No code, no artifact change.

v1.0.1 shipped and looking at what its fixes touched turned up two more: the hook
pinned a release, and the two platform installers do different things.

The second is the one worth writing down. install.sh carried host wiring it never
called, install.ps1 both delegates and wires, and Windows does every host twice.
Deleting the POSIX copy looks obvious and is wrong until each row is confirmed --
the Codex plugin gap proves the two sides are not equivalent, so removing one on
the assumption that they are would delete a step nothing else performs.

The trap section is the part that generalises. Two assertions passed for years
while the shell wired nothing: one checked that config paths were present in
install.sh, the other that both installers said the same sentences. Presence, not
reachability; parity between a live script and a dead block. Three issues were
invisible underneath them.

Limit: an assertion that names a file does not assert the file does anything
Blast: system
Undo: easy
Certainty: firm
Provenance: authored
Record-Id: r-post101
@github-actions

github-actions Bot commented Aug 16, 2026

Copy link
Copy Markdown

CommitLore — record lint

Trailers: clean — 2 commits in origin/main..3cfc902ff33009731c403afae1050fcb7574b7d9
Active constraints: not read — commitlore: the index is incomplete: the build stopped after its time budget with 727 commit(s) or note(s) unread — records in them are missing from this answer. fix: commitlore init (or commitlore index) to finish the index (1 changed path)

Trailer violations fail this check. Active constraints are informational — they are what the repository already decided, not a verdict on this PR.

@MongLong0214
MongLong0214 merged commit cd53f87 into main Aug 16, 2026
12 checks passed
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.

1 participant