R77.B — Execution Packet

Concrete Edit operations to satisfy the contract. Must be approved before Step 4.

Commit strategy

Single implementation commit (per 5-step chain): fix(r77-b-refs-config): correct lowercase ADR + stray docs/ prefix refs + pin theme version.

Edit 1 — docs/architecture/decisions/ADR-004-tool-surface.md

File: docs/architecture/decisions/ADR-004-tool-surface.md

Target line: 99

Tool: Edit

old_string:

| Router | all δ tools | Deferred to Phase 1.5 per [ADR-005](adr-005-multi-model-defer.md). Phase 0 is Claude-only. |

new_string:

| Router | all δ tools | Deferred to Phase 1.5 per [ADR-005](ADR-005-multi-model-defer.md). Phase 0 is Claude-only. |

Diff: adr-005-multi-model-defer.md → ADR-005-multi-model-defer.md (two uppercase letters in the URL target).

Uniqueness check: the string (adr-005-multi-model-defer.md) is unique within ADR-004-tool-surface.md (confirmed by audit §1.4).

Edit 2 — docs/world-schema.md

File: docs/world-schema.md

Target line: 3

Tool: Edit

old_string:

> Derived from the handwritten layer sketch (2026-04-13), [`docs/colibri-system.md`](docs/colibri-system.md), and a full 7-pass review of all 672 repo .md files (224 docs/ + 257 .agents/ + 79 data/ + 112 other zones).

new_string:

> Derived from the handwritten layer sketch (2026-04-13), [`docs/colibri-system.md`](colibri-system.md), and a full 7-pass review of all 672 repo .md files (224 docs/ + 257 .agents/ + 79 data/ + 112 other zones).

Diff: ](docs/colibri-system.md) → ](colibri-system.md). Link text (inside [ ]) stays byte-identical.

Uniqueness check: the full quoted line is unique within world-schema.md (no second “7-pass review” sentence).

Edit 3 — docs/_config.yml — pin remote_theme

File: docs/_config.yml

Target lines: 10

Tool: Edit

old_string:

# Theme — use remote_theme for GitHub Pages compatibility
remote_theme: just-the-docs/just-the-docs

new_string:

# Theme — use remote_theme for GitHub Pages compatibility
# Pinned to v0.12.0 (latest stable as of 2026-04-19) to guard against upstream drift.
remote_theme: just-the-docs/just-the-docs@v0.12.0

# Color scheme — just-the-docs supports "light" (default), "dark", or a custom scheme.
# Setting "light" explicitly so that an upstream default change cannot silently flip us.
color_scheme: light

Diff:

1. Line added: # Pinned to v0.12.0 … (comment).
2. Line edited: remote_theme: just-the-docs/just-the-docs → remote_theme: just-the-docs/just-the-docs@v0.12.0.
3. Blank line added.
4. 2 comment lines added explaining the color_scheme: choice.
5. Line added: color_scheme: light.

Uniqueness check: The # Theme — use remote_theme comment on line 9 is unique in the file.

Edit 4 — docs/_config.yml — add callouts: + mermaid: blocks

File: docs/_config.yml

Placement: after back_to_top_text: (current line 43), before the existing # Markdown processing comment (current line 45).

Tool: Edit

old_string:

# Navigation settings
nav_sort: case_insensitive
back_to_top: true
back_to_top_text: "Back to top"

# Markdown processing

new_string:

# Navigation settings
nav_sort: case_insensitive
back_to_top: true
back_to_top_text: "Back to top"

# Callouts — just-the-docs standard variants.
# Unlocks `{: .note }`, `{: .warning }`, etc. in Markdown pages.
callouts:
  highlight:
    color: yellow
  important:
    title: Important
    color: blue
  new:
    title: New
    color: green
  note:
    title: Note
    color: purple
  warning:
    title: Warning
    color: red

# Mermaid diagrams — opt-in via just-the-docs.
# Version pinned to match the theme's canonical reference (v0.12.0 _config.yml).
mermaid:
  version: "9.1.6"

# Markdown processing

Diff: insert a contiguous 23-line block between back_to_top_text: and # Markdown processing. No existing lines are modified, only inserted-around.

Uniqueness check: The six-line window # Navigation settings → # Markdown processing is unique in the file (confirmed by visual read of _config.yml in audit §2.1).

Operation order

1. Edit 1 (ADR-004) — isolated file.
2. Edit 2 (world-schema) — isolated file.
3. Edit 3 (remote_theme + color_scheme) — _config.yml first touch.
4. Edit 4 (callouts + mermaid) — _config.yml second touch. Order matters: Edit 3 happens first because its old_string is above Edit 4’s old_string in the file.

Verification sequence (Step 5)

1. Grep ]\(adr- across docs/ excluding audits/packets/verification — expect zero hits.
2. Grep ]\(docs/ across docs/ excluding audits/packets/verification — expect zero hits.
3. Read docs/_config.yml and confirm:
   • remote_theme: just-the-docs/just-the-docs@v0.12.0 present
   • color_scheme: light present
   • callouts: block with 5 children present
   • mermaid: block with version: "9.1.6" present
   • All keys from I2 list unchanged
4. npm run build — exit 0.
5. npm run lint — exit 0.
6. npm test — exit 0, 1085 or more passing.
7. Git diff sanity — confirm only 3 files touched outside the 5-step chain artefacts.

Rollback plan

Per contract §6: single branch, clean git history. If Pages rendering or CI fails post-merge:

git revert <final-sha>
git push

Pages will redeploy to pre-R77.B state within minutes.

Packet gate

Step 3 complete. Step 4 (implement) applies Edits 1–4 in order.