@wemuda/launchrail 1.19.0 → 1.20.0

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
+import { spawnSync } from "node:child_process";
 import { AVAILABLE_MODULES, runAdd } from "./commands/add.js";
-import { runAdrIndex, runAdrMergeDriver } from "./commands/adr.js";
+import { runAdrIndex } from "./commands/adr.js";
 import { printDiff, runDiff } from "./commands/diff.js";
 import { runDev } from "./commands/dev.js";
 import { runDoctor, printDoctor } from "./commands/doctor.js";
@@ -24,7 +25,7 @@ Commands:
   diff      Preview upstream changes
   sync      Synchronize managed capabilities and run migrations
   eject     Stop managing a selected module or file
-  adr       Maintain the decision-record registry (adr index [--check])
+  adr       Print the decision-record index (adr index)
   promote   Inspect potential reusable local improvements
 
 Options:
@@ -53,8 +54,7 @@ eject usage:
   launchrail eject --all [--dry-run]           Vendor mode: eject everything
 
 adr usage:
-  launchrail adr index [--check]               Regenerate docs/adr/README.md's index table from the records (--check: report only)
-  launchrail adr merge-driver <O> <A> <B> [P]  Resolve a docs/adr/README.md index conflict by regeneration (git invokes this; install via init / sync / doctor)`;
+  launchrail adr index                         Print the ADR index from the records in docs/adr/ (never written to a file)`;
 const NOT_IMPLEMENTED = ["promote"];
 const args = process.argv.slice(2);
 const command = args[0];
@@ -136,19 +136,22 @@ if (command === "eject") {
 }
 if (command === "adr") {
     if (args[1] === "index") {
-        process.exit(runAdrIndex({ cwd: process.cwd(), check: flags.has("--check") }).code);
+        process.exit(runAdrIndex({ cwd: process.cwd() }).code);
     }
     if (args[1] === "merge-driver") {
-        // Invoked by git as the merge driver bound in .gitattributes; args are
-        // git's %O %A %B %P (base, ours, theirs, path).
-        const [base, ours, theirs, path] = [args[2], args[3], args[4], args[5]];
-        if (!base || !ours || !theirs) {
-            console.error("launchrail: usage: launchrail adr merge-driver <base> <ours> <theirs> [path]");
+        // Retired with the committed index (2026-10-01-adr-index-is-printed-not-committed).
+        // A clone that still binds it — an older branch's .gitattributes, before
+        // sync or doctor drop the clone's config — gets git's own text merge, so a
+        // conflict shows the usual markers instead of an untouched file.
+        const [base, ours, theirs] = [args[2], args[3], args[4]];
+        if (!base || !ours || !theirs)
             process.exit(2);
-        }
-        process.exit(runAdrMergeDriver({ cwd: process.cwd(), base, ours, theirs, path }).code);
+        const merged = spawnSync("git", ["merge-file", "-L", "ours", "-L", "base", "-L", "theirs", ours, base, theirs], {
+            stdio: "inherit",
+        });
+        process.exit(merged.status ?? 1);
     }
-    console.error("launchrail: usage: launchrail adr index [--check]");
+    console.error("launchrail: usage: launchrail adr index");
     process.exit(1);
 }
 if (NOT_IMPLEMENTED.includes(command)) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/adr.d.ts

@@ -1,6 +1,12 @@
 export declare const ADR_DIR = "docs/adr";
 export declare const ADR_TEMPLATE_FILENAME = "0000-template.md";
 export declare const ADR_REGISTRY_PATH = "docs/adr/README.md";
+/**
+ * The markers that once bracketed the generated table committed into the
+ * registry. The index is printed now, never committed
+ * (2026-10-01-adr-index-is-printed-not-committed); the markers survive only so
+ * the migration and doctor can find a table an older version left behind.
+ */
 export declare const ADR_INDEX_START = "<!-- adr-index:start \u2014 generated by `launchrail adr index`; edit the records, not this table -->";
 export declare const ADR_INDEX_END = "<!-- adr-index:end -->";
 export interface AdrEntry {
@@ -23,14 +29,6 @@ export interface AdrEntry {
 export declare function isAdrRecordFilename(file: string): boolean;
 /** Parse one record's file and source into an entry; null when the filename is not a record. */
 export declare function parseAdrEntry(file: string, source: string): AdrEntry | null;
-/**
- * The record list built from an explicit set of file→source pairs, sorted by
- * filename exactly as scanAdrs sorts the directory — numbered records first,
- * dated records after them in date order. The merge driver uses this to
- * assemble the corpus from the working tree plus the records only the incoming
- * side carries, which are not yet on disk when git invokes the driver.
- */
-export declare function entriesFromSources(sources: Iterable<readonly [string, string]>): AdrEntry[];
 /**
  * The decision records already in a repository's docs/adr/ (template and
  * registry excluded), sorted by filename — numbered records first, dated
@@ -46,8 +44,6 @@ export declare function adrDuplicates(entries: AdrEntry[]): {
     id: string;
     files: string[];
 }[];
-/** Records whose filename never appears in the registry — rows the index is missing. */
-export declare function unindexedAdrs(registrySource: string, entries: AdrEntry[]): AdrEntry[];
 type Relation = "supersedes" | "amends" | "extends";
 /**
  * The relation graph declared across the corpus. A record declares what it
@@ -63,40 +59,54 @@ export declare function adrRelations(entries: AdrEntry[]): Map<string, Record<Re
  * their successor(s), the one fact a reader must not miss.
  */
 export declare function adrStatusCell(entry: AdrEntry, entries: AdrEntry[], graph?: Map<string, Record<Relation, AdrEntry[]>>): string;
-/** The generated index table, markers included. */
-export declare function adrIndexTable(entries: AdrEntry[]): string;
-/**
- * A single-line placeholder the merge driver substitutes for the index region
- * while it 3-way merges the registry's prose, then swaps back out for the freshly
- * regenerated table. Comment-shaped so it is inert if it ever leaks into a file,
- * and identical across all three sides so the prose merge sees no index diff.
- */
-export declare const ADR_INDEX_SENTINEL = "<!-- launchrail:adr-index-merge-placeholder -->";
 /**
- * Replace the registry's index region with `replacement`: everything between the
- * markers when they exist; otherwise the first table under `## Index`, with the
- * region newline-padded (a registry written before the generator migrates on its
- * first run). Null when the registry has neither — there is nothing to replace.
+ * The index table: one row per record in timeline order, each with its live
+ * status. Printed by `launchrail adr index`, never committed — a table every
+ * ADR-adding branch rewrites is a table parallel branches conflict over
+ * (2026-10-01-adr-index-is-printed-not-committed).
  */
-export declare function replaceIndexRegion(registrySource: string, replacement: string): string | null;
+export declare function adrIndexTable(entries: AdrEntry[]): string;
+/** Printed under the index when some record carries no `## Status` yet (an adopted corpus). */
+export declare const ADR_UNCLASSIFIED_NOTE = "Rows marked **Unclassified** carry no `## Status` section yet. Classify each as you next touch its area: give the record a status line (`Accepted`, `Superseded by [id](file)`, \u2026).";
+/** What the registry's `## Index` section says in place of a committed table. */
+export declare const ADR_INDEX_POINTER = "The index is generated from the records each time it is read, and never committed \u2014 so branches that add ADRs in parallel have no shared table to conflict over. Print it with `npx @wemuda/launchrail adr index`: every record in date order, with its live status (superseded, amended, extended) derived from the records' own `## Status` lines.";
 /**
- * The registry with its index table regenerated in place. Between the markers
- * when they exist; otherwise the first table under `## Index` is replaced and
- * the markers introduced around it. Null when the registry has neither.
+ * The registry with the generated table an older Launchrail committed between
+ * the markers replaced by {@link ADR_INDEX_POINTER}. Only the marked region is
+ * touched — those rows were always Launchrail's, regenerated wholesale on every
+ * `adr index` — so a hand-kept table without markers, and every other line,
+ * stays the project's. Null when there is no marked table.
  */
-export declare function withRegeneratedIndex(registrySource: string, entries: AdrEntry[]): string | null;
+export declare function withoutCommittedIndex(registrySource: string): string | null;
 /** The seeded ADR template: date-and-slug titled, teaching the forward-declared relation model. */
-export declare const ADR_TEMPLATE = "# Short decision title\n\n## Status\nProposed | Accepted | Superseded by [slug](YYYY-MM-DD-slug.md)\n\nName here what this record supersedes, amends, or extends, linking the earlier record by file (`Accepted \u2014 amends [slug](YYYY-MM-DD-slug.md): what changed`). The registry index ([README.md](README.md)) derives the reverse links, so an earlier record need not be edited when this one amends it; when this record is superseded later, this line is rewritten to name the successor. Re-run `launchrail adr index` after any change here.\n\n## Context\nWhat requirement or constraint requires a decision?\n\n## Decision\nWhat was selected?\n\n## Alternatives considered\nWhat realistic alternatives were rejected?\n\n## Consequences\nWhat becomes easier, harder, or constrained?\n\n## Revisit when\nWhat change would justify reconsidering this decision?\n";
+export declare const ADR_TEMPLATE = "# Short decision title\n\n## Status\nProposed | Accepted | Superseded by [slug](YYYY-MM-DD-slug.md)\n\nName here what this record supersedes, amends, or extends, linking the earlier record by file (`Accepted \u2014 amends [slug](YYYY-MM-DD-slug.md): what changed`). The registry index (`launchrail adr index`) derives the reverse links, so an earlier record need not be edited when this one amends it; when this record is superseded later, this line is rewritten to name the successor.\n\n## Context\nWhat requirement or constraint requires a decision?\n\n## Decision\nWhat was selected?\n\n## Alternatives considered\nWhat realistic alternatives were rejected?\n\n## Consequences\nWhat becomes easier, harder, or constrained?\n\n## Revisit when\nWhat change would justify reconsidering this decision?\n";
+/** The template seeded while the index was committed — it pointed at the registry file and asked for a re-run (byte-stable until the printed index). */
+export declare const COMMITTED_INDEX_ADR_TEMPLATE = "# Short decision title\n\n## Status\nProposed | Accepted | Superseded by [slug](YYYY-MM-DD-slug.md)\n\nName here what this record supersedes, amends, or extends, linking the earlier record by file (`Accepted \u2014 amends [slug](YYYY-MM-DD-slug.md): what changed`). The registry index ([README.md](README.md)) derives the reverse links, so an earlier record need not be edited when this one amends it; when this record is superseded later, this line is rewritten to name the successor. Re-run `launchrail adr index` after any change here.\n\n## Context\nWhat requirement or constraint requires a decision?\n\n## Decision\nWhat was selected?\n\n## Alternatives considered\nWhat realistic alternatives were rejected?\n\n## Consequences\nWhat becomes easier, harder, or constrained?\n\n## Revisit when\nWhat change would justify reconsidering this decision?\n";
 /** The `# ADR-NNNN:`-titled template seeded before the dated-identifier ADR (byte-stable until then). */
 export declare const PRE_DATE_SLUG_ADR_TEMPLATE = "# ADR-NNNN: Short decision title\n\n## Status\nProposed | Accepted | Accepted \u2014 amended by ADR-NNNN | Superseded by ADR-NNNN\n\nWhen a later ADR amends or supersedes this one, update this line and the registry index ([README.md](README.md)) in the same commit.\n\n## Context\nWhat requirement or constraint requires a decision?\n\n## Decision\nWhat was selected?\n\n## Alternatives considered\nWhat realistic alternatives were rejected?\n\n## Consequences\nWhat becomes easier, harder, or constrained?\n\n## Revisit when\nWhat change would justify reconsidering this decision?\n";
+/**
+ * The registry bullets Launchrail seeded about the committed index table, byte
+ * for byte: the dated-identifier version, then the merge-driver version. Each
+ * tells agents to regenerate and commit a table that no longer exists, so the
+ * printed-index migration swaps exactly these lines for the current bullet.
+ */
+export declare const COMMITTED_INDEX_BULLETS: string[];
+/** The current registry bullet about the index — the one the committed-index bullets heal to. */
+export declare const PRINTED_INDEX_BULLET = "- The index is **printed, never committed**: `launchrail adr index` builds it from the records each time it runs, so adding or re-statusing a record touches only that record \u2014 there is no table to regenerate, commit, or merge.";
 /** The registry's project-owned summary of how records are minted; defers to the managed contract. */
-export declare const ADR_MAINTAINING_SECTION = "## Maintaining this registry\n\n- New ADRs copy [0000-template.md](0000-template.md) to `YYYY-MM-DD-short-slug.md` \u2014 the date the decision was made, then a slug unique in this directory. There is no sequence number to claim, so parallel branches never collide, and nothing is renumbered.\n- The index table between the markers is **generated**: run `launchrail adr index` after adding or re-statusing a record, and commit the result. Never hand-edit the rows; the rest of this file is yours. Parallel branches do not collide on it \u2014 Launchrail installs a git merge driver (`launchrail doctor` registers it in each clone) that rebuilds the table from the records on merge or rebase, so both branches' new rows land in date order with no conflict. If you ever do see a conflict here \u2014 a fresh clone before `launchrail doctor` ran, say \u2014 never resolve it by editing rows: run `launchrail adr index && git add docs/adr/README.md` and continue the merge or rebase.\n- A new ADR declares what it supersedes, amends, or extends in its own `## Status` line, linking the earlier record by file. The index derives the reverse links, so amending an ADR does not require editing it. A superseded ADR's `## Status` line is still rewritten to name its successor \u2014 that is the one fact a reader of the record alone must not miss.\n- Never delete or rename an ADR once it is referenced; superseded ADRs are historical records other documents link to.\n- The naming and relation mechanics above summarize a contract Launchrail keeps current in the managed workflow instructions (`.launchrail/CLAUDE.generated.md`); if this seeded summary ever drifts from that managed contract, the managed contract is what holds.";
+export declare const ADR_MAINTAINING_SECTION = "## Maintaining this registry\n\n- New ADRs copy [0000-template.md](0000-template.md) to `YYYY-MM-DD-short-slug.md` \u2014 the date the decision was made, then a slug unique in this directory. There is no sequence number to claim, so parallel branches never collide, and nothing is renumbered.\n- The index is **printed, never committed**: `launchrail adr index` builds it from the records each time it runs, so adding or re-statusing a record touches only that record \u2014 there is no table to regenerate, commit, or merge.\n- A new ADR declares what it supersedes, amends, or extends in its own `## Status` line, linking the earlier record by file. The index derives the reverse links, so amending an ADR does not require editing it. A superseded ADR's `## Status` line is still rewritten to name its successor \u2014 that is the one fact a reader of the record alone must not miss.\n- Never delete or rename an ADR once it is referenced; superseded ADRs are historical records other documents link to.\n- The naming and relation mechanics above summarize a contract Launchrail keeps current in the managed workflow instructions (`.launchrail/CLAUDE.generated.md`); if this seeded summary ever drifts from that managed contract, the managed contract is what holds.";
 /**
  * The "Maintaining this registry" section seeded before the dated-identifier ADR —
  * the one that told agents to "take the next free number". Byte-stable from
  * ADR-0031 until that ADR, so `healRegistryMinting` matches it exactly.
  */
 export declare const PRE_DATE_SLUG_MAINTAINING_SECTION = "## Maintaining this registry\n\n- New ADRs copy [0000-template.md](0000-template.md), take the next free number (`NNNN-short-slug.md` \u2014 check both this index and the files on disk), and add their row here **in the same commit**. The shared row turns two branches minting the same number into a visible merge conflict instead of a silent collision.\n- When a new ADR supersedes or amends an earlier one \u2014 including reversing part of the earlier one's context \u2014 update the earlier ADR's `## Status` line and its row here in the same commit.\n- Never delete or renumber an ADR once it is referenced; superseded ADRs are historical records other documents link to.";
+/**
+ * The registry with each seeded committed-index bullet swapped for the printed-
+ * index one. Only exact lines Launchrail wrote are touched; a project's own
+ * wording stays. Null when there is nothing to heal.
+ */
+export declare function healCommittedIndexBullet(source: string): string | null;
 export type MintingGuidanceState = "healed" | "current" | "modified" | "absent";
 /**
  * Correct a registry's minting guidance in place. Returns `healed` (with the
@@ -111,11 +121,23 @@ export declare function healRegistryMinting(source: string): {
     next: string;
 };
 /**
- * The seeded ADR registry. When init/sync adopts a repository that already has
- * decision records, the index prefills from them; a fresh repository gets the
- * empty index. Seeded once, then project-owned — but the table between the
- * markers is regenerated by `launchrail adr index`, so the project maintains
- * the records and the live picture, never the rows.
+ * The seeded ADR registry: the reading doctrine, a pointer to the printed index,
+ * a live picture the project writes, and the minting summary. Seeded once, then
+ * project-owned. It carries no table — the index is printed from the records on
+ * demand — so its content depends on the corpus only for the live-picture prompt.
  */
 export declare function adrRegistryContent(entries: AdrEntry[]): string;
+export declare const GITATTRIBUTES_FILENAME = ".gitattributes";
+export declare const RETIRED_ADR_MERGE_DRIVER_NAME = "launchrail-adr-index";
+export declare const RETIRED_ADR_MERGE_ATTRIBUTE_LINE = "docs/adr/README.md merge=launchrail-adr-index";
+/**
+ * `.gitattributes` without the line Launchrail added: the remaining content, or
+ * `""` when that line was all the file held (delete it). Null when the line is
+ * absent — a project's own attribute rules are never touched.
+ */
+export declare function withoutRetiredMergeAttribute(cwd: string): string | null;
+/** Whether this clone's git config still defines the retired driver. */
+export declare function hasRetiredMergeDriverConfig(cwd: string): boolean;
+/** Drop the retired driver from this clone's git config. Idempotent; returns whether anything was removed. */
+export declare function removeRetiredMergeDriverConfig(cwd: string): boolean;
 export {};

package/dist/lib/adr.js

@@ -1,8 +1,15 @@
+import { execFileSync } from "node:child_process";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 export const ADR_DIR = "docs/adr";
 export const ADR_TEMPLATE_FILENAME = "0000-template.md";
 export const ADR_REGISTRY_PATH = `${ADR_DIR}/README.md`;
+/**
+ * The markers that once bracketed the generated table committed into the
+ * registry. The index is printed now, never committed
+ * (2026-10-01-adr-index-is-printed-not-committed); the markers survive only so
+ * the migration and doctor can find a table an older version left behind.
+ */
 export const ADR_INDEX_START = "<!-- adr-index:start — generated by `launchrail adr index`; edit the records, not this table -->";
 export const ADR_INDEX_END = "<!-- adr-index:end -->";
 /** Legacy numbered records: `0031-adr-registry.md`. A dated filename is not a numbered one. */
@@ -46,22 +53,6 @@ export function parseAdrEntry(file, source) {
         return null;
     return { ...parsed, file, title: adrTitle(source, file), status: adrStatus(source) };
 }
-/**
- * The record list built from an explicit set of file→source pairs, sorted by
- * filename exactly as scanAdrs sorts the directory — numbered records first,
- * dated records after them in date order. The merge driver uses this to
- * assemble the corpus from the working tree plus the records only the incoming
- * side carries, which are not yet on disk when git invokes the driver.
- */
-export function entriesFromSources(sources) {
-    const entries = [];
-    for (const [file, source] of [...sources].sort(([a], [b]) => a.localeCompare(b))) {
-        const entry = parseAdrEntry(file, source);
-        if (entry)
-            entries.push(entry);
-    }
-    return entries;
-}
 /**
  * The decision records already in a repository's docs/adr/ (template and
  * registry excluded), sorted by filename — numbered records first, dated
@@ -85,7 +76,13 @@ export function scanAdrs(cwd) {
         }
         sources.push([file, source]);
     }
-    return entriesFromSources(sources);
+    const entries = [];
+    for (const [file, source] of sources.sort(([a], [b]) => a.localeCompare(b))) {
+        const entry = parseAdrEntry(file, source);
+        if (entry)
+            entries.push(entry);
+    }
+    return entries;
 }
 /**
  * Ids (numbers or slugs) claimed by more than one record, each with the files
@@ -97,10 +94,6 @@ export function adrDuplicates(entries) {
         byId.set(entry.id, [...(byId.get(entry.id) ?? []), entry.file]);
     return [...byId.entries()].filter(([, files]) => files.length > 1).map(([id, files]) => ({ id, files }));
 }
-/** Records whose filename never appears in the registry — rows the index is missing. */
-export function unindexedAdrs(registrySource, entries) {
-    return entries.filter((entry) => !registrySource.includes(entry.file));
-}
 const FORWARD = { supersedes: "supersedes", amends: "amends", extends: "extends" };
 const BACKWARD = {
     "superseded by": "supersedes",
@@ -174,8 +167,9 @@ function stateOf(status) {
         return "Unclassified";
     return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
 }
+/** Links resolve from the repository root, where `launchrail adr index` runs. */
 function idLink(entry) {
-    return `[${entry.id}](${entry.file})`;
+    return `[${entry.id}](${ADR_DIR}/${entry.file})`;
 }
 /**
  * One record's status cell: its state, the relations it declares, and the
@@ -215,51 +209,35 @@ export function adrStatusCell(entry, entries, graph = adrRelations(entries)) {
         parts.push(`extended by ${list(received.extends)}`);
     return parts.join("; ");
 }
-/** The generated index table, markers included. */
+/**
+ * The index table: one row per record in timeline order, each with its live
+ * status. Printed by `launchrail adr index`, never committed — a table every
+ * ADR-adding branch rewrites is a table parallel branches conflict over
+ * (2026-10-01-adr-index-is-printed-not-committed).
+ */
 export function adrIndexTable(entries) {
     const graph = adrRelations(entries);
     const header = "| ADR | Decided | Title | Status |\n| --- | --- | --- | --- |";
     const rows = entries.map((e) => `| ${idLink(e)} | ${e.date ?? "—"} | ${e.title.replace(/\|/g, "\\|")} | ${adrStatusCell(e, entries, graph)} |`);
-    return [ADR_INDEX_START, header, ...rows, ADR_INDEX_END].join("\n");
+    return [header, ...rows].join("\n");
 }
+/** Printed under the index when some record carries no `## Status` yet (an adopted corpus). */
+export const ADR_UNCLASSIFIED_NOTE = "Rows marked **Unclassified** carry no `## Status` section yet. Classify each as you next touch its area: give the record a status line (`Accepted`, `Superseded by [id](file)`, …).";
+/** What the registry's `## Index` section says in place of a committed table. */
+export const ADR_INDEX_POINTER = "The index is generated from the records each time it is read, and never committed — so branches that add ADRs in parallel have no shared table to conflict over. Print it with `npx @wemuda/launchrail adr index`: every record in date order, with its live status (superseded, amended, extended) derived from the records' own `## Status` lines.";
 /**
- * A single-line placeholder the merge driver substitutes for the index region
- * while it 3-way merges the registry's prose, then swaps back out for the freshly
- * regenerated table. Comment-shaped so it is inert if it ever leaks into a file,
- * and identical across all three sides so the prose merge sees no index diff.
- */
-export const ADR_INDEX_SENTINEL = "<!-- launchrail:adr-index-merge-placeholder -->";
-/**
- * Replace the registry's index region with `replacement`: everything between the
- * markers when they exist; otherwise the first table under `## Index`, with the
- * region newline-padded (a registry written before the generator migrates on its
- * first run). Null when the registry has neither — there is nothing to replace.
+ * The registry with the generated table an older Launchrail committed between
+ * the markers replaced by {@link ADR_INDEX_POINTER}. Only the marked region is
+ * touched — those rows were always Launchrail's, regenerated wholesale on every
+ * `adr index` — so a hand-kept table without markers, and every other line,
+ * stays the project's. Null when there is no marked table.
  */
-export function replaceIndexRegion(registrySource, replacement) {
+export function withoutCommittedIndex(registrySource) {
     const start = registrySource.indexOf("<!-- adr-index:start");
     const end = registrySource.indexOf(ADR_INDEX_END);
-    if (start !== -1 && end !== -1 && end > start) {
-        return registrySource.slice(0, start) + replacement + registrySource.slice(end + ADR_INDEX_END.length);
-    }
-    const heading = /^##\s+Index\s*$/m.exec(registrySource);
-    if (!heading)
+    if (start === -1 || end === -1 || end < start)
         return null;
-    const afterHeading = heading.index + heading[0].length;
-    const rest = registrySource.slice(afterHeading);
-    const tableMatch = /\n(\|[^\n]*\n)+/.exec(rest);
-    if (!tableMatch)
-        return null;
-    const before = registrySource.slice(0, afterHeading + tableMatch.index);
-    const after = rest.slice(tableMatch.index + tableMatch[0].length);
-    return `${before}\n${replacement}\n${after}`;
-}
-/**
- * The registry with its index table regenerated in place. Between the markers
- * when they exist; otherwise the first table under `## Index` is replaced and
- * the markers introduced around it. Null when the registry has neither.
- */
-export function withRegeneratedIndex(registrySource, entries) {
-    return replaceIndexRegion(registrySource, adrIndexTable(entries));
+    return registrySource.slice(0, start) + ADR_INDEX_POINTER + registrySource.slice(end + ADR_INDEX_END.length);
 }
 // --- Minting guidance: a managed contract, a seeded summary, a one-time heal ----
 //
@@ -277,6 +255,29 @@ export const ADR_TEMPLATE = `# Short decision title
 ## Status
 Proposed | Accepted | Superseded by [slug](YYYY-MM-DD-slug.md)
 
+Name here what this record supersedes, amends, or extends, linking the earlier record by file (\`Accepted — amends [slug](YYYY-MM-DD-slug.md): what changed\`). The registry index (\`launchrail adr index\`) derives the reverse links, so an earlier record need not be edited when this one amends it; when this record is superseded later, this line is rewritten to name the successor.
+
+## Context
+What requirement or constraint requires a decision?
+
+## Decision
+What was selected?
+
+## Alternatives considered
+What realistic alternatives were rejected?
+
+## Consequences
+What becomes easier, harder, or constrained?
+
+## Revisit when
+What change would justify reconsidering this decision?
+`;
+/** The template seeded while the index was committed — it pointed at the registry file and asked for a re-run (byte-stable until the printed index). */
+export const COMMITTED_INDEX_ADR_TEMPLATE = `# Short decision title
+
+## Status
+Proposed | Accepted | Superseded by [slug](YYYY-MM-DD-slug.md)
+
 Name here what this record supersedes, amends, or extends, linking the earlier record by file (\`Accepted — amends [slug](YYYY-MM-DD-slug.md): what changed\`). The registry index ([README.md](README.md)) derives the reverse links, so an earlier record need not be edited when this one amends it; when this record is superseded later, this line is rewritten to name the successor. Re-run \`launchrail adr index\` after any change here.
 
 ## Context
@@ -317,11 +318,23 @@ What becomes easier, harder, or constrained?
 ## Revisit when
 What change would justify reconsidering this decision?
 `;
+/**
+ * The registry bullets Launchrail seeded about the committed index table, byte
+ * for byte: the dated-identifier version, then the merge-driver version. Each
+ * tells agents to regenerate and commit a table that no longer exists, so the
+ * printed-index migration swaps exactly these lines for the current bullet.
+ */
+export const COMMITTED_INDEX_BULLETS = [
+    "- The index table between the markers is **generated**: run `launchrail adr index` after adding or re-statusing a record (and after merging), and commit the result. Never hand-edit the rows; the rest of this file is yours.",
+    "- The index table between the markers is **generated**: run `launchrail adr index` after adding or re-statusing a record, and commit the result. Never hand-edit the rows; the rest of this file is yours. Parallel branches do not collide on it — Launchrail installs a git merge driver (`launchrail doctor` registers it in each clone) that rebuilds the table from the records on merge or rebase, so both branches' new rows land in date order with no conflict. If you ever do see a conflict here — a fresh clone before `launchrail doctor` ran, say — never resolve it by editing rows: run `launchrail adr index && git add docs/adr/README.md` and continue the merge or rebase.",
+];
+/** The current registry bullet about the index — the one the committed-index bullets heal to. */
+export const PRINTED_INDEX_BULLET = "- The index is **printed, never committed**: `launchrail adr index` builds it from the records each time it runs, so adding or re-statusing a record touches only that record — there is no table to regenerate, commit, or merge.";
 /** The registry's project-owned summary of how records are minted; defers to the managed contract. */
 export const ADR_MAINTAINING_SECTION = `## Maintaining this registry
 
 - New ADRs copy [0000-template.md](0000-template.md) to \`YYYY-MM-DD-short-slug.md\` — the date the decision was made, then a slug unique in this directory. There is no sequence number to claim, so parallel branches never collide, and nothing is renumbered.
-- The index table between the markers is **generated**: run \`launchrail adr index\` after adding or re-statusing a record, and commit the result. Never hand-edit the rows; the rest of this file is yours. Parallel branches do not collide on it — Launchrail installs a git merge driver (\`launchrail doctor\` registers it in each clone) that rebuilds the table from the records on merge or rebase, so both branches' new rows land in date order with no conflict. If you ever do see a conflict here — a fresh clone before \`launchrail doctor\` ran, say — never resolve it by editing rows: run \`launchrail adr index && git add docs/adr/README.md\` and continue the merge or rebase.
+${PRINTED_INDEX_BULLET}
 - A new ADR declares what it supersedes, amends, or extends in its own \`## Status\` line, linking the earlier record by file. The index derives the reverse links, so amending an ADR does not require editing it. A superseded ADR's \`## Status\` line is still rewritten to name its successor — that is the one fact a reader of the record alone must not miss.
 - Never delete or rename an ADR once it is referenced; superseded ADRs are historical records other documents link to.
 - The naming and relation mechanics above summarize a contract Launchrail keeps current in the managed workflow instructions (\`.launchrail/CLAUDE.generated.md\`); if this seeded summary ever drifts from that managed contract, the managed contract is what holds.`;
@@ -335,6 +348,22 @@ export const PRE_DATE_SLUG_MAINTAINING_SECTION = `## Maintaining this registry
 - New ADRs copy [0000-template.md](0000-template.md), take the next free number (\`NNNN-short-slug.md\` — check both this index and the files on disk), and add their row here **in the same commit**. The shared row turns two branches minting the same number into a visible merge conflict instead of a silent collision.
 - When a new ADR supersedes or amends an earlier one — including reversing part of the earlier one's context — update the earlier ADR's \`## Status\` line and its row here in the same commit.
 - Never delete or renumber an ADR once it is referenced; superseded ADRs are historical records other documents link to.`;
+/**
+ * The registry with each seeded committed-index bullet swapped for the printed-
+ * index one. Only exact lines Launchrail wrote are touched; a project's own
+ * wording stays. Null when there is nothing to heal.
+ */
+export function healCommittedIndexBullet(source) {
+    const lines = source.split("\n");
+    let healed = false;
+    const next = lines.map((line) => {
+        if (!COMMITTED_INDEX_BULLETS.includes(line.trimEnd()))
+            return line;
+        healed = true;
+        return PRINTED_INDEX_BULLET;
+    });
+    return healed ? next.join("\n") : null;
+}
 const MAINTAINING_HEADING = "## Maintaining this registry";
 /** Slice a registry into the text before/at/after its "Maintaining this registry" section (to the next `## ` heading or EOF). */
 function maintainingSlice(source) {
@@ -368,28 +397,24 @@ export function healRegistryMinting(source) {
     return { state: "modified", next: source };
 }
 /**
- * The seeded ADR registry. When init/sync adopts a repository that already has
- * decision records, the index prefills from them; a fresh repository gets the
- * empty index. Seeded once, then project-owned — but the table between the
- * markers is regenerated by `launchrail adr index`, so the project maintains
- * the records and the live picture, never the rows.
+ * The seeded ADR registry: the reading doctrine, a pointer to the printed index,
+ * a live picture the project writes, and the minting summary. Seeded once, then
+ * project-owned. It carries no table — the index is printed from the records on
+ * demand — so its content depends on the corpus only for the live-picture prompt.
  */
 export function adrRegistryContent(entries) {
-    const unclassifiedNote = entries.some((e) => e.status === "")
-        ? "\n\nRows marked **Unclassified** carry no `## Status` section yet. Classify each as you next touch its area: give the record a status line (`Accepted`, `Superseded by [id](file)`, …) and re-run `launchrail adr index`."
-        : "";
     const livePicture = entries.length === 0
         ? "_No decisions recorded yet. When ADRs land, summarize here how they compose into the current system, and name the few a newcomer should read first._"
         : "_Not yet written. Summarize how the accepted decisions compose into the current system, and name the few ADRs a newcomer should read first._";
     return `# ADR registry
 
-The index of every architecture decision record in this repository. Read this first, then open only the ADRs that touch the area you are working in — the index is the cheap surface; the records are depth.
+Every architecture decision record in this repository lives in this directory. Start from the index, then open only the ADRs that touch the area you are working in — the index is the cheap surface; the records are depth.
 
 An ADR records a decision and the context it was made in. It is **not documentation of the current system**: never treat an ADR as evidence that a component exists or still works as described — the code is the source of truth for what exists today.
 
 ## Index
 
-${adrIndexTable(entries)}${unclassifiedNote}
+${ADR_INDEX_POINTER}
 
 ## The live picture
 
@@ -400,4 +425,58 @@ ${livePicture}
 ${ADR_MAINTAINING_SECTION}
 `;
 }
+// --- Retired: the index merge driver -------------------------------------------
+//
+// While the index was committed, Launchrail bound it to a git merge driver: one
+// line in the project's `.gitattributes`, plus a per-clone git config entry
+// (2026-09-21-adr-index-merge-driver). With nothing generated left to merge, the
+// printed-index migration removes the line Launchrail added, and sync / doctor
+// drop the clone's config so a stale binding can never invoke a removed command.
+export const GITATTRIBUTES_FILENAME = ".gitattributes";
+export const RETIRED_ADR_MERGE_DRIVER_NAME = "launchrail-adr-index";
+export const RETIRED_ADR_MERGE_ATTRIBUTE_LINE = `${ADR_REGISTRY_PATH} merge=${RETIRED_ADR_MERGE_DRIVER_NAME}`;
+/**
+ * `.gitattributes` without the line Launchrail added: the remaining content, or
+ * `""` when that line was all the file held (delete it). Null when the line is
+ * absent — a project's own attribute rules are never touched.
+ */
+export function withoutRetiredMergeAttribute(cwd) {
+    const path = join(cwd, GITATTRIBUTES_FILENAME);
+    if (!existsSync(path))
+        return null;
+    const lines = readFileSync(path, "utf8").split("\n");
+    const kept = lines.filter((line) => line.trim() !== RETIRED_ADR_MERGE_ATTRIBUTE_LINE);
+    if (kept.length === lines.length)
+        return null;
+    const rest = kept.join("\n");
+    return rest.trim() === "" ? "" : rest;
+}
+/** Whether this clone's git config still defines the retired driver. */
+export function hasRetiredMergeDriverConfig(cwd) {
+    try {
+        execFileSync("git", ["config", "--local", "--get-regexp", `^merge\\.${RETIRED_ADR_MERGE_DRIVER_NAME}\\.`], {
+            cwd,
+            stdio: "ignore",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Drop the retired driver from this clone's git config. Idempotent; returns whether anything was removed. */
+export function removeRetiredMergeDriverConfig(cwd) {
+    if (!hasRetiredMergeDriverConfig(cwd))
+        return false;
+    try {
+        execFileSync("git", ["config", "--local", "--remove-section", `merge.${RETIRED_ADR_MERGE_DRIVER_NAME}`], {
+            cwd,
+            stdio: "ignore",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 //# sourceMappingURL=adr.js.map