forked from heavy-duty/rig
docs: the provenance comment matches #61's pinned contract, not the old story
Review found `commands/platform.sh` still telling future readers that a missing converged_* pair is a legitimate state on a freshly bootstrapped box. It is not, and the rest of this PR already says so: #61's writer records both pairs equally at bootstrap, so no writer produces that manifest -- its absence means partial or hand-edited. README and the fixtures were corrected in an earlier commit of this series; the comment beside the code was not, which left the one artifact a future change actually reads while editing this block still arguing the retired position. Also corrects two examples that went stale under this PR rather than in it. #76 and #77 merged while this was in review, so the marker example in the same file -- and the sample `rig platform` output in README -- still showed `role=dev class=human host=yes join=authkey`, a spelling bootstrap no longer writes. Now `role=dev-server root-door=closed host=yes join=authkey`, with a note that the renderer prints whatever fields a marker carries, so a pre-rename box still shows its own class= line unchanged. Comments and docs only; no behaviour change. Same defect class both times -- prose that contradicts the contract the tests pin -- which is why the sweep went wider than the one site reported. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
parent
d3577b9954
commit
e11247b467
2 changed files with 12 additions and 6 deletions
|
|
@ -740,7 +740,7 @@ VIRT kvm
|
||||||
PROVENANCE
|
PROVENANCE
|
||||||
CONVERGED 0.6.0, 2026-08-02T09:11:03Z
|
CONVERGED 0.6.0, 2026-08-02T09:11:03Z
|
||||||
BOOTSTRAP 0.4.0, 2026-07-19T14:24:51Z
|
BOOTSTRAP 0.4.0, 2026-07-19T14:24:51Z
|
||||||
ROLE dev (class=human host=yes join=authkey)
|
ROLE dev-server (root-door=closed host=yes join=authkey)
|
||||||
```
|
```
|
||||||
|
|
||||||
"Is this the 32GB one, or the M900?" was previously a question you answered by
|
"Is this the 32GB one, or the M900?" was previously a question you answered by
|
||||||
|
|
|
||||||
|
|
@ -170,9 +170,12 @@ if [ -r "$MANIFEST" ]; then
|
||||||
if [ -z "$M_SCHEMA$B_BY$B_AT$C_BY$C_AT" ]; then
|
if [ -z "$M_SCHEMA$B_BY$B_AT$C_BY$C_AT" ]; then
|
||||||
field RIG "manifest present but carries no recognised fields ($MANIFEST)"
|
field RIG "manifest present but carries no recognised fields ($MANIFEST)"
|
||||||
else
|
else
|
||||||
# 'not recorded' rather than 'unknown': under #61's rule 2 converged_* is
|
# 'not recorded' rather than 'unknown', and it does NOT describe a fresh
|
||||||
# written only when the version actually differs, so its absence is a
|
# box: #61's writer records both pairs equally at bootstrap, so no writer
|
||||||
# legitimate state on a freshly bootstrapped box, not a lost value.
|
# produces a manifest missing converged_* — its absence means the file is
|
||||||
|
# partial or hand-edited. Deliberately not backfilled from bootstrapped_*,
|
||||||
|
# because inferring a convergence that never happened is worse than saying
|
||||||
|
# the record is not there. README and the fixtures pin exactly this.
|
||||||
field CONVERGED "${C_BY:-not recorded}${C_AT:+, $C_AT}"
|
field CONVERGED "${C_BY:-not recorded}${C_AT:+, $C_AT}"
|
||||||
field BOOTSTRAP "${B_BY:-not recorded}${B_AT:+, $B_AT}"
|
field BOOTSTRAP "${B_BY:-not recorded}${B_AT:+, $B_AT}"
|
||||||
[ -n "$M_SCHEMA" ] && [ "$M_SCHEMA" != "1" ] && \
|
[ -n "$M_SCHEMA" ] && [ "$M_SCHEMA" != "1" ] && \
|
||||||
|
|
@ -182,8 +185,11 @@ else
|
||||||
field RIG "not bootstrapped (no $MANIFEST)"
|
field RIG "not bootstrapped (no $MANIFEST)"
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# The role marker is bootstrap's own line — 'role=dev class=human host=yes
|
# The role marker is bootstrap's own line — 'role=dev-server
|
||||||
# join=authkey' — printed as the role plus its traits.
|
# root-door=closed host=yes join=authkey' — printed as the role plus its
|
||||||
|
# traits. The example tracks the CURRENT vocabulary (#76's -server/-box role
|
||||||
|
# suffixes, #77's root-door trait); this command renders whatever fields the
|
||||||
|
# marker carries, so a pre-rename box still prints its own class= line as-is.
|
||||||
MARKER_LINE="$(read_role_marker "$MARKER")"
|
MARKER_LINE="$(read_role_marker "$MARKER")"
|
||||||
if [ -n "$MARKER_LINE" ]; then
|
if [ -n "$MARKER_LINE" ]; then
|
||||||
ROLE_NAME="" ROLE_TRAITS=""
|
ROLE_NAME="" ROLE_TRAITS=""
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue