Skip to content

docs(repo): describe roles instead of build-machine topology - #286

Merged
forkwright merged 1 commit into
mainfrom
fix/public-repo-hygiene
Sep 16, 2026
Merged

forkwright merged 1 commit into
mainfrom
fix/public-repo-hygiene

Conversation

@forkwright

Copy link
Copy Markdown
Owner

Removes private fleet topology from surfaces that are public in this repository.

What this closes

  • A private research-archive path in CHANGELOG.md, replaced by a description of the note.
  • Host topology named as a defers_to authority in CLAUDE.md frontmatter.
  • A machine name in the rust-toolchain.toml warning. The concrete version-drift figures are kept: they are what make the warning persuasive.
  • Private ecosystem naming in README.md and _llm/decisions.toml.

At HEAD, a repo-wide search for the removed classes returns nothing: operator home paths, build-host names, CPU/GPU model numbers, internal .lan hostnames, private host-operations repo references, and co-resident service names.

What this provably cannot close

This is a forward-only commit. Every removed string remains reachable in this repository's history, and nothing here rewrites or removes it. Anyone with read access can recover all of it from prior commits.

It also does not touch commit author metadata, a separate class that content-level changes do not reach at all.

Both are deliberately left to the forge's history-cut capability rather than hand-rolled here, so one owner performs the operation once across the fleet.

Verification

Prose and comments only — no executable code changed. Verified by config equivalence rather than a build: the parsed .kanon-ci.toml is identical to main's, so CI behaviour is unchanged by construction. That is a stronger claim for a comment change than a green test run, and costs no build slot.

Theatron is published; the machine it happens to build on is not part
of its public contract. Replace host and private-path references with
the role that is actually true of the software:

- CLAUDE.md/README.md: name the forkwright ecosystem as the repo group
  it is, rather than pairing it with a build-host name.
- CLAUDE.md: drop the machine-topology deferral and point the standards
  reference at the kanon repo path already used by SECURITY.md rather
  than a local checkout location.
- CHANGELOG.md: cite the consumer-pull research notes by date and name
  instead of by private archive path.
- _llm/decisions.toml: the Linux-first context is about fleet consumers,
  not a named machine.
- rust-toolchain.toml: keep the version-gap rationale whole -- a dev
  machine resolving `stable` two minors below CI is the reason the pin
  is exact -- while dropping the host identity.

No behavior, pin, or version changes.
@forkwright
forkwright merged commit daab615 into main Sep 16, 2026
10 checks passed
@forkwright
forkwright deleted the fix/public-repo-hygiene branch September 16, 2026 20:00
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