open/repo-mailbox
1
0
Fork 0
Code Issues Releases 1 Activity

docs(board): keep the axis rationale, drop the private referents

Browse source 
The v0.9.0 comments explained the attention-vs-topic axis by pointing at the
operator's private cross-repo register by path, naming an internal incident
code, and quoting a measured count of the operator's own repo population.
This repo mirrors to a public remote, so operational metadata about a private
machine does not belong in it - the reasoning does, the referents do not.

Rewritten self-contained: the topic-axis contrast now stands on its own terms
without citing a file a public reader cannot see, the defect class is named
rather than coded, and the worktree rationale keeps WHY .git is tested with
-e (a worktree or submodule has .git as a FILE) while dropping the census
that motivated measuring it. Illustrative paths stay; they carry no fact.

Comments only, no behavior change: 136 + 28 selftest checks and 6/6 node
tests unchanged. No version bump, so the v0.9.0 tag and the catalog ref stay
where they are - and with them the pre-scrub text, which history and that tag
still carry. Un-publishing that is a history rewrite and the operator's call,
not a side effect of a comment edit.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01U6EixQo6hpoRCVtiAXdnFs
This commit is contained in:
Kjell Tore Guttormsen 2026-07-28 21:35:42 +02:00
commit f7ad4741a3
2 changed files with 15 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

8
scripts/board-selftest.sh
View file

@ -118,10 +118,10 @@ mkrepo "$ROOT/polyrepo/plug-x"
} > "$ROOT/polyrepo/plug-x/STATE.md"
# repo-wt + wt-feature: a git WORKTREE (and a submodule) has .git as a FILE,
# not a directory. Measured 2026-07-26: STATE.md is TRACKED in 7 of 25 real
# repos, so `git worktree add ~/repos/feature-x` yields a sibling directory
# that CARRIES a STATE.md. Testing discovery for a .git DIRECTORY only drops
# it silently - the same silent-loss class as the V6 marker fix.
# not a directory. A `git worktree add <root>/feature-x` yields a sibling
# directory that can CARRY its own STATE.md. Testing discovery for a .git
# DIRECTORY only drops it silently - the same silent-loss class as the V6
# marker fix.
mkrepo "$ROOT/repo-wt"
{
echo "# STATE - repo-wt"