From 109596bc3beed72004af70e81376ad7cfcbf4f72 Mon Sep 17 00:00:00 2001
From: Eric Rakestraw <eric@rakestraw.us>
Date: Mon, 2 Nov 2026 22:34:19 +0000
Subject: [PATCH] Use the source-built CLI in maintainer recovery instructions

---
 docs/release.md                            | 18 +++++++++---------
 docs/roadmap/publication-reconciliation.md |  2 +-
 docs/roadmap/remediation.md                |  5 +++++
 3 files changed, 15 insertions(+), 10 deletions(-)

diff --git a/docs/release.md b/docs/release.md
index 1544396..cfa97d3 100644
--- a/docs/release.md
+++ b/docs/release.md
@@ -129,11 +129,11 @@ instructions below using the same immutable version.
 Each publication invocation attempts to save its captured identity before the
 tag push. The CLI reports the saved record path separately from publication
 success or failure and, after a push or immediate-reconciliation error, prints a
-copyable command that selects that exact record. Run that command to make a
-separate later observation:
+copyable command that selects that exact record. Run that command, or use the
+source-built executable prepared above, to make a separate later observation:
 
 ```sh
-'/path/to/releasekit' reconcile --record '/absolute/path/to/attempt-record.json'
+./.releasekit/bin/releasekit reconcile --record '/absolute/path/to/attempt-record.json'
 ```
 
 The saved evidence fixes the original endpoint and tag identity. Later recovery
@@ -150,15 +150,15 @@ If command output was lost, list local attempts and explicitly select the
 matching record by its module, full tag, and saved identity:
 
 ```sh
-releasekit publication-attempts --repo "$PWD"
-releasekit reconcile --record '/absolute/path/from-the-list/attempt-record.json'
+./.releasekit/bin/releasekit publication-attempts --repo "$PWD"
+./.releasekit/bin/releasekit reconcile --record '/absolute/path/from-the-list/attempt-record.json'
 ```
 
 Discovery only reads the local store. It neither queries remotes nor chooses an
-attempt automatically. Use a supported ReleaseKit CLI if the executable named
-in the printed handoff command is no longer available. An older record may lack
-the endpoint, tag-object ID, candidate commit, or another field required for a
-conclusive result.
+attempt automatically. If the original recovery entry point is unavailable,
+select another supported ReleaseKit CLI and pass the same record path explicitly.
+An older record may lack the endpoint, tag-object ID, candidate commit, or
+another field required for a conclusive result.
 
 A later observation that the tag is absent describes the remote at that time;
 it does not prove the version was never published. Never reuse a version known
diff --git a/docs/roadmap/publication-reconciliation.md b/docs/roadmap/publication-reconciliation.md
index 6926ba4..6ccb047 100644
--- a/docs/roadmap/publication-reconciliation.md
+++ b/docs/roadmap/publication-reconciliation.md
@@ -18,7 +18,7 @@ release version or prescribing a staged implementation plan.
 
 The current checkout contains the v0.7.0 release notes and publication workflow.
 The [publication guide](../consumers/publish.md) describes existing outcomes;
-the [maintainer runbook](../release.md#resolve-failures) describes manual recovery.
+the [maintainer runbook](../release.md#resolve-publication-failures) describes manual recovery.
 
 - `PublicationResult` supplies the repository and module identity, semantic
   version, full tag, candidate commit, captured endpoint, tag object when known,
diff --git a/docs/roadmap/remediation.md b/docs/roadmap/remediation.md
index 51913ab..1edc34f 100644
--- a/docs/roadmap/remediation.md
+++ b/docs/roadmap/remediation.md
@@ -347,6 +347,11 @@ linked-worktree behavior instead of introducing new pathname restrictions.
 
 ## R09: Align maintainer recovery instructions with the source bootstrap — P2
 
+**Completed:** Runbook discovery and reconciliation use the prepared source-built
+CLI, and the roadmap recovery link targets the current heading. Disposable local
+checks executed both snippets with no global `releasekit`, confirming discovery
+and the expected incomplete-evidence reconciliation status.
+
 **Relevant code/docs:** `scripts/release:9`; `docs/release.md:104` and
 `release.md:149`; `docs/roadmap/publication-reconciliation.md:21`.