docs: use canonical ADR statuses (Accepted/Proposed, drop Completed)

dfa1 · claude · dfa1 · commit e5dcea19ae59 · 2026-06-27T08:53:19.000+02:00
Completed is not a standard ADR status and blurs decision-state against
implementation-done. Switch to canonical statuses: status now tracks the
decision lifecycle only (Accepted until Superseded), independent of whether the
code has shipped.

- Completed -&gt; Accepted for decisions settled on main (0001-0009, 0013, 0014).
- 0011 (JPMS, unmerged branch), 0012 (benchmark methodology, not ratified) -&gt;
  Proposed; 0010 already Proposed.
- Drop the non-canonical Implementation section from 0005; keep commit
  provenance under References.
- Rewrite the status legend; note Accepted is decoupled from shipping.

Co-Authored-By: Claude Opus 4.8 &lt;noreply@anthropic.com&gt;
diff --git a/adr/0001-ffm-over-jni.md b/adr/0001-ffm-over-jni.md
@@ -1,6 +1,6 @@
 # ADR 0001: FFM bindings over JNI
 
-- **Status:** Completed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/0002-zig-cc-native-build.md b/adr/0002-zig-cc-native-build.md
@@ -1,6 +1,6 @@
 # ADR 0002: Build the native library with `zig cc`
 
-- **Status:** Completed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/0003-segment-first-api.md b/adr/0003-segment-first-api.md
@@ -1,6 +1,6 @@
 # ADR 0003: MemorySegment-first API with thin `byte[]` overloads
 
-- **Status:** Completed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/0004-per-classifier-native-jars.md b/adr/0004-per-classifier-native-jars.md
@@ -1,6 +1,6 @@
 # ADR 0004: Per-classifier native JARs
 
-- **Status:** Completed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/0005-no-lib-path-override.md b/adr/0005-no-lib-path-override.md
@@ -1,6 +1,6 @@
 # ADR 0005: No `-Dzstd.lib.path` override
 
-- **Status:** Completed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
@@ -39,15 +39,9 @@ directory created atomically, and `dlopen`s that. To run a self-built
 - **`-Dzstd.lib.path` override:** convenient, but an RCE-shaped foot-gun.
 - **Allow override only when a flag is set:** still ships the dangerous path.
 
-## Implementation
-
-- `9e505c6` / `8d0ea6a` (#8) — bundled-only native loader; removed any path
-  override, load solely from the classpath artifact.
-- `b2ed28b` — set owner-only (`0700`) temp dir permissions atomically (Sonar
-  S5443).
-- `c9929b9` (#20) — follow-up Sonar SECURITY-category fixes.
-
 ## References
 
 - [NativeLibrary.java], [docs/how-to.md](../docs/how-to.md)
 - [ADR 0004 — per-classifier native jars](0004-per-classifier-native-jars.md)
+- Implemented in `9e505c6` / `8d0ea6a` (#8, bundled-only loader), `b2ed28b`
+  (owner-only temp dir, Sonar S5443), `c9929b9` (#20, follow-up Sonar fixes).
diff --git a/adr/0006-native-compile-flags.md b/adr/0006-native-compile-flags.md
@@ -1,6 +1,6 @@
 # ADR 0006: Native compile flags
 
-- **Status:** Completed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/0007-integration-tests-ground-truth.md b/adr/0007-integration-tests-ground-truth.md
@@ -1,6 +1,6 @@
 # ADR 0007: Integration tests as ground truth
 
-- **Status:** Completed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/0008-size-t-mapping-and-sentinels.md b/adr/0008-size-t-mapping-and-sentinels.md
@@ -1,6 +1,6 @@
 # ADR 0008: `size_t` maps to `JAVA_LONG`, guard sentinels
 
-- **Status:** Completed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/0009-nativeobject-idempotent-close.md b/adr/0009-nativeobject-idempotent-close.md
@@ -1,6 +1,6 @@
 # ADR 0009: `NativeObject` — AutoCloseable, idempotent close
 
-- **Status:** Completed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/0011-jpms-module-descriptor.md b/adr/0011-jpms-module-descriptor.md
@@ -1,6 +1,6 @@
 # ADR 0011: JPMS module descriptor
 
-- **Status:** Accepted — implemented on `feat/jpms-module-info`, not yet merged to main
+- **Status:** Proposed
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/0012-benchmark-methodology.md b/adr/0012-benchmark-methodology.md
@@ -1,6 +1,6 @@
 # ADR 0012: Benchmark methodology and publishing
 
-- **Status:** Accepted
+- **Status:** Proposed
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/0013-binding-coverage-scope.md b/adr/0013-binding-coverage-scope.md
@@ -1,6 +1,6 @@
 # ADR 0013: Binding coverage scope — exclude legacy/deprecated
 
-- **Status:** Completed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/0014-single-threaded-native-build.md b/adr/0014-single-threaded-native-build.md
@@ -1,6 +1,6 @@
 # ADR 0014: Single-threaded native build (no `nbWorkers`)
 
-- **Status:** Completed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 
diff --git a/adr/ADR.md b/adr/ADR.md
@@ -7,7 +7,10 @@ This directory contains ADRs following the
 
 Each ADR is a Markdown file named `NNNN-short-title.md`. Use `template.md` as the starting point.
 
-**Status values:** Proposed → Accepted → Completed | Deferred | Deprecated | Superseded
+**Status values:** Proposed → Accepted → Deprecated → Superseded (also: Rejected, Deferred)
+
+`Accepted` is the decision's lifecycle state — it stays Accepted until something
+Supersedes it — tracked independently of whether the code has shipped.
 
 Most of the early ADRs are retrospective: they record decisions already made and
 shipped, so contributors can see *why* the project looks the way it does.
@@ -16,17 +19,17 @@ shipped, so contributors can see *why* the project looks the way it does.
 
 | ADR  | Title                                              | Status    |
 |------|----------------------------------------------------|-----------|
-| 0001 | FFM bindings over JNI                               | Completed |
-| 0002 | Build the native library with `zig cc`             | Completed |
-| 0003 | MemorySegment-first API with thin `byte[]` overloads | Completed |
-| 0004 | Per-classifier native JARs                          | Completed |
-| 0005 | No `-Dzstd.lib.path` override                       | Completed |
-| 0006 | Native compile flags                               | Completed |
-| 0007 | Integration tests as ground truth                  | Completed |
-| 0008 | `size_t` maps to `JAVA_LONG`, guard sentinels      | Completed |
-| 0009 | `NativeObject`: AutoCloseable, idempotent close    | Completed |
+| 0001 | FFM bindings over JNI                               | Accepted  |
+| 0002 | Build the native library with `zig cc`             | Accepted  |
+| 0003 | MemorySegment-first API with thin `byte[]` overloads | Accepted  |
+| 0004 | Per-classifier native JARs                          | Accepted  |
+| 0005 | No `-Dzstd.lib.path` override                       | Accepted  |
+| 0006 | Native compile flags                               | Accepted  |
+| 0007 | Integration tests as ground truth                  | Accepted  |
+| 0008 | `size_t` maps to `JAVA_LONG`, guard sentinels      | Accepted  |
+| 0009 | `NativeObject`: AutoCloseable, idempotent close    | Accepted  |
 | 0010 | Bounded native-context pool for virtual threads    | Proposed  |
-| 0011 | JPMS module descriptor                             | Accepted  |
-| 0012 | Benchmark methodology and publishing               | Accepted  |
-| 0013 | Binding coverage scope — exclude legacy/deprecated | Completed |
-| 0014 | Single-threaded native build (no `nbWorkers`)      | Completed |
+| 0011 | JPMS module descriptor                             | Proposed  |
+| 0012 | Benchmark methodology and publishing               | Proposed  |
+| 0013 | Binding coverage scope — exclude legacy/deprecated | Accepted  |
+| 0014 | Single-threaded native build (no `nbWorkers`)      | Accepted  |
