dito pilot: 730 break-glass edit pass #10

Merged
jsutter merged 2 commits from dito-bglass into main 2026-09-22 05:52:10 +00:00
Owner

The dito manual's pilot edit pass (page map row 7.3): tighten 730-breakglass.md to its two jobs — getting back into a host, and how NixOS snapshotting preserves data — and strike the mechanical audit's markers. The Operator reads this page in full before merge (pilot protocol, like the ditc 105 pilot).

What changed

  • Narrative (2 struck): "the morning sync" (the gate-counted hit) → plain mechanism; the past-lockout anecdote → the grep-before-delete imperative. Commands kept verbatim.
  • Provenance (5 struck + 2 same-class finds): both infra/docs/runbooks/host-access.md paths, the [sec:secrets-model] §-token, dit-operator #668, and the two "before the custody store" temporal frames — each replaced with its plain mechanism. runbooks added to see_also.
  • Vendors (2 fixed): Bitwarden → "the password manager (Bitwarden)" once, then plain (no collision with "the custody vault (OpenBao)", already compliant); GRUB → "the boot menu (GRUB)". GATE-BW-UNLOCKED and bw sync stay verbatim (tool output).
  • H2 shapes: topic headings → how-to imperatives; the To…/Before-you-begin/steps procedure voice unchanged.
  • Kept: every trust/restore/snapshot fact (two-store doctrine, verify fields + caveats, rotate order + snapshot restore + rotated-degraded, record write-once/--force, exec audit-before-run, host-switch blast radius, full console-recovery walk). 251 → 250 lines.

Frontmatter

doc_type: how-to, introduces: [break-glass] (glossary entry already exists, defined_in: breakglass), and requires = the term-provenance chain (host-fleet first, then 11 stems) — see integration commit.

Gates (all green on 60da114)

build-docs --no-coverage --draft 0 · check-prose.py --manual dito clean · check-lockstep --synthesize 0 (0 fail) · build-docs --draft 0 · armada check-prose.sh 0 (narrative 0, source-path 0, term-before-job 0; assumptions_line cleared by the About literacy line).

Integration deltas (second commit)

  1. requires: [host-fleet] alone activates the lockstep CONCEPT check; the page's 17 glossary terms resolve outside the host-fleet ancestry. Expanded to the provenance chain (lockstep 0 fail verified). host-fleet leads the list.
  2. The armada gate's assumptions_line check requires the manual's front page to carry the literacy line; dito 000-about.md now carries the page map's sentence verbatim.
The dito manual's pilot edit pass (page map row 7.3): tighten `730-breakglass.md` to its two jobs — getting back into a host, and how NixOS snapshotting preserves data — and strike the mechanical audit's markers. **The Operator reads this page in full before merge (pilot protocol, like the ditc 105 pilot).** ## What changed - **Narrative (2 struck):** "the morning sync" (the gate-counted hit) → plain mechanism; the past-lockout anecdote → the grep-before-delete imperative. Commands kept verbatim. - **Provenance (5 struck + 2 same-class finds):** both `infra/docs/runbooks/host-access.md` paths, the `[sec:secrets-model]` §-token, `dit-operator #668`, and the two "before the custody store" temporal frames — each replaced with its plain mechanism. `runbooks` added to `see_also`. - **Vendors (2 fixed):** Bitwarden → "the password manager (Bitwarden)" once, then plain (no collision with "the custody vault (OpenBao)", already compliant); GRUB → "the boot menu (GRUB)". `GATE-BW-UNLOCKED` and `bw sync` stay verbatim (tool output). - **H2 shapes:** topic headings → how-to imperatives; the To…/Before-you-begin/steps procedure voice unchanged. - **Kept:** every trust/restore/snapshot fact (two-store doctrine, verify fields + caveats, rotate order + snapshot restore + rotated-degraded, record write-once/--force, exec audit-before-run, host-switch blast radius, full console-recovery walk). 251 → 250 lines. ## Frontmatter `doc_type: how-to`, `introduces: [break-glass]` (glossary entry already exists, `defined_in: breakglass`), and `requires` = the term-provenance chain (host-fleet first, then 11 stems) — see integration commit. ## Gates (all green on 60da114) build-docs --no-coverage --draft 0 · check-prose.py --manual dito clean · check-lockstep --synthesize 0 (0 fail) · build-docs --draft 0 · armada check-prose.sh 0 (narrative 0, source-path 0, term-before-job 0; assumptions_line cleared by the About literacy line). ## Integration deltas (second commit) 1. `requires: [host-fleet]` alone activates the lockstep CONCEPT check; the page's 17 glossary terms resolve outside the host-fleet ancestry. Expanded to the provenance chain (lockstep 0 fail verified). host-fleet leads the list. 2. The armada gate's assumptions_line check requires the manual's front page to carry the literacy line; dito `000-about.md` now carries the page map's sentence verbatim.
Pilot edit pass per the dito page map row 7.3: the page now carries exactly
its two jobs — getting back into a host, and how NixOS snapshotting
preserves data. Strikes: the 'morning sync' narrative hit and the past-lockout
anecdote (mechanisms kept as imperatives), 5 provenance markers plus 2
same-class finds (runbook paths, the [sec:] token, the issue ref, two
'before the custody store' temporal frames), and the 2 bare vendor names
(Bitwarden, GRUB — each now named once in parentheses after its plain name).
H2 shapes moved to how-to imperatives; the To…/Before-you-begin/steps
procedure voice unchanged. Every trust/restore/snapshot fact kept (251 →
250 lines). Frontmatter: doc_type: how-to, requires: [host-fleet],
introduces: [break-glass]; runbooks added to see_also.

Assisted-by: author:synthetic/hf:moonshotai/Kimi-K3
Integration on the author's edit pass, two gate-driven deltas:

- requires: [host-fleet] alone activates the lockstep CONCEPT check (730 is
  the only dito page declaring requires so far), and the page's 17 glossary
  terms take defined_in from pages outside the host-fleet ancestry — the
  check fails 17 CONCEPT rows. Expanded requires to the term-provenance
  chain in reading order (verified: lockstep 0 fail). host-fleet stays
  first — the contracted dependency leads the list.
- The armada prose gate's assumptions_line check requires the manual's
  front page to carry the literacy line; dito 000-about.md now carries the
  page map's sentence verbatim within its first 15 body lines.

Assisted-by: deepnet:synthetic/hf:zai-org/GLM-5.3-Flash
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
deepnet/ditdocs!10
No description provided.