docs: sort three theme-studio specs into docs/specs with status headings

First spec-sort pass under the docs-lifecycle convention: color-families -> READY (its status field carried the 2026-06-10 confirmation), palette-columns and palette-ramps -> DRAFT. Each got the authoritative status heading with an :ID: UUID; six inbound links rewritten. subr-mock-migration-spec is -spec-named but lacks the spec spine, so it stays put until it's renamed or retrofitted.

4 files changed, 31 insertions, 7 deletions

diff --git a/docs/design/theme-studio-color-harmony.org b/docs/design/theme-studio-color-harmony.org
index b07ccb42..f722d4ee 100644
--- a/docs/design/theme-studio-color-harmony.org
+++ b/docs/design/theme-studio-color-harmony.org
@@ -5,7 +5,7 @@
 
 Color harmony in a theme palette is mostly calculable. Work in OKLCH, borrow the hue from a semantic accent, fix lightness and chroma across a tier, and let three hard constraints bound the free dials: contrast (WCAG, with APCA as a diagnostic), ΔE separation between palette entries, and the sRGB gamut. What remains for taste is small and deliberate: which hues carry which semantic roles, and how warm or cool the whole page should sit.
 
-This document captures the method worked out on 2026-06-09. The ramp generator and background-contrast safety shipped in theme-studio implement the first two applications (see [[file:../theme-studio-palette-ramps-spec.org][the palette-ramps spec]]); harmonic fill remains a future feature.
+This document captures the method worked out on 2026-06-09. The ramp generator and background-contrast safety shipped in theme-studio implement the first two applications (see [[file:../specs/theme-studio-palette-ramps-spec.org][the palette-ramps spec]]); harmonic fill remains a future feature.
 
 * Why OKLCH
 
@@ -60,7 +60,7 @@ A background-over-text effect (region, hl-line, highlight, lazy-highlight, isear
 
 The right question: define the face's foreground set (the distinct syntax hexes plus the default fg), and rate the background by its floor, the minimum contrast over that set. The limiting foreground (the argmin) names which color caps you. From the floor follows L_max: at a chosen hue and chroma, the lightest background whose floor still clears the target. The usable background lightness is capped by the darkest or nearest foreground in the set, not by the average.
 
-This shipped in theme-studio: the five covered overlay faces show the worst-case floor and name the limiting foreground, and the OKLCH picker shades the lightness band that is too light for the selected face (the lMax ceiling). Contracts and defaults live in the [[file:../theme-studio-palette-ramps-spec.org][ramps spec]].
+This shipped in theme-studio: the five covered overlay faces show the worst-case floor and name the limiting foreground, and the OKLCH picker shades the lightness band that is too light for the selected face (the lMax ceiling). Contracts and defaults live in the [[file:../specs/theme-studio-palette-ramps-spec.org][ramps spec]].
 
 * Ramp generation (shipped)
 
diff --git a/docs/theme-studio-color-families-spec.org b/docs/specs/theme-studio-color-families-spec.org
index ce3b7a9f..f2e883d9 100644
--- a/docs/theme-studio-color-families-spec.org
+++ b/docs/specs/theme-studio-color-families-spec.org
@@ -1,12 +1,20 @@
 #+TITLE: theme-studio Color Families — Spec
 #+AUTHOR: Craig Jennings
 #+DATE: 2026-06-09
+#+TODO: TODO | DONE
+#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED
+
+* READY theme-studio Color Families — Spec
+:PROPERTIES:
+:ID:       d1ccfea7-6a38-4e1c-820b-6e8e631d5308
+:END:
+- 2026-07-02 Thu @ 01:01:46 -0400 — retrofitted by spec-sort; status set to READY (evidence-based, human-confirmed)
 
 * Metadata
-| Status   | Ready (Craig confirmed 2026-06-10); review incorporated, hex grouping |
+| Status   | ready                                                                 |
 | Owner    | Craig                                                                  |
 | Reviewer | Codex                                                                  |
-| Related  | [[file:../todo.org][todo.org: theme-studio color families]]            |
+| Related  | [[file:../../todo.org][todo.org: theme-studio color families]]            |
 
 * Summary
 
diff --git a/docs/theme-studio-palette-columns-spec.org b/docs/specs/theme-studio-palette-columns-spec.org
index d1dba035..ae94a5b0 100644
--- a/docs/theme-studio-palette-columns-spec.org
+++ b/docs/specs/theme-studio-palette-columns-spec.org
@@ -1,11 +1,19 @@
 #+TITLE: Theme-Studio Spec: Declared Palette Columns
 #+DATE: 2026-06-10
+#+TODO: TODO | DONE
+#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED
+
+* DRAFT Theme-Studio Spec: Declared Palette Columns
+:PROPERTIES:
+:ID:       c1befaf0-9da2-4d7f-8b00-005409e441a0
+:END:
+- 2026-07-02 Thu @ 01:01:46 -0400 — retrofitted by spec-sort; status set to DRAFT (evidence-based, human-confirmed)
 
 * Metadata
 
 - Status: Draft (Ready after Craig's read)
 - Source: design discussion 2026-06-10 (Craig + session), folding in the shipped ramps v1 and color-families work it supersedes
-- Related: [[file:theme-studio-palette-ramps-spec.org][palette-ramps spec]] (ramp math, floor/L_max safety — still in force), [[file:theme-studio-color-families-spec.org][color-families spec]] (superseded in its grouping half), [[file:design/theme-studio-color-harmony.org][color-harmony explainer]]
+- Related: [[file:theme-studio-palette-ramps-spec.org][palette-ramps spec]] (ramp math, floor/L_max safety — still in force), [[file:theme-studio-color-families-spec.org][color-families spec]] (superseded in its grouping half), [[file:../design/theme-studio-color-harmony.org][color-harmony explainer]]
 
 * Summary
 
diff --git a/docs/theme-studio-palette-ramps-spec.org b/docs/specs/theme-studio-palette-ramps-spec.org
index 849fea0f..5030e63a 100644
--- a/docs/theme-studio-palette-ramps-spec.org
+++ b/docs/specs/theme-studio-palette-ramps-spec.org
@@ -1,12 +1,20 @@
 #+TITLE: theme-studio Palette Ramps & Background-Contrast Safety — Spec
 #+AUTHOR: Craig Jennings
 #+DATE: 2026-06-09
+#+TODO: TODO | DONE
+#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED
+
+* DRAFT theme-studio Palette Ramps & Background-Contrast Safety — Spec
+:PROPERTIES:
+:ID:       9b92166f-9e16-41e0-a8ad-e9be529ff951
+:END:
+- 2026-07-02 Thu @ 01:01:46 -0400 — retrofitted by spec-sort; status set to DRAFT (evidence-based, human-confirmed)
 
 * Metadata
-| Status   | draft — review incorporated (Codex, 2026-06-09)                     |
+| Status   | draft                                                               |
 | Owner    | Craig                                                               |
 | Reviewer | Codex                                                               |
-| Related  | [[file:../todo.org][todo.org: theme-studio color-harmony explainer + ramp/fill features]]  |
+| Related  | [[file:../../todo.org][todo.org: theme-studio color-harmony explainer + ramp/fill features]]  |
 
 * Summary