You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit b02024a
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/migration/restlet/INDEX.md
+10-4Lines changed: 10 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ nothing else. Every set is sized to fit comfortably in context alongside the cod
8
8
|---|---|
9
9
| Where the plan lives |[plan.md](plan.md) — phase status, risk register, expected divergences |
10
10
| What is locked |[decisions.md](decisions.md#locked-decisions)|
11
-
| Current step |**5d-2 — the deletion**, split four ways / five commits; 5d-2a reviewed and re-split 2026-08-06. [spec](phase-5d-2.md) · [research](phase-5d-2-research.md)|
11
+
| Current step |**5d-2 — the deletion.** 5d-2a done; the tail **re-planned 2026-08-08 into six sub-phases** off a fresh measurement ([research §11](phase-5d-2-research.md#11)). Next up: **5d-2b-i**, the oracle freeze. [spec](phase-5d-2.md) · [research](phase-5d-2-research.md)|
12
12
13
13
---
14
14
@@ -19,7 +19,7 @@ bug in this table — fix the table rather than reading the whole tree.
19
19
20
20
| I am… | Load (≈ tokens) |
21
21
|---|---|
22
-
|**implementing any 5d-2 sub-phase**|[phase-5d-2.md](phase-5d-2.md)8k + the [research](phase-5d-2-research.md)section its decisions cite (~1–2k each) = **~11k**. The research file holds the per-file inventory so the source does not have to be re-read; open a section, never the file |
22
+
|**implementing any 5d-2 sub-phase**|[phase-5d-2.md](phase-5d-2.md)9k + **[research §11](phase-5d-2-research.md#11) 3k — always, it amends §2/§3/§6/§7** + the other research section its decisions cite (~1–2k each) = **~14k**. The research file holds the per-file inventory so the source does not have to be re-read; open a section, never the file |
23
23
|**planning phase 7 / 8**|[plan.md](plan.md) 15k + [inventory.md](inventory.md) 5k = **~20k**. ⚠ Phase 6 no longer exists — it was absorbed into 5d-2, and phase 8 lost two of its six steps to 5d-2d |
24
24
|**writing a new CHF handler**| the [conversion template](phase-5-oauth2.md#the-conversion-template-applies-to-every-5a5b5c-handler) + the two or three [chf-patterns](chf-patterns.md) sections it names — **never the whole file**|
Phases 7–8 (outbound client, final deletion) have no doc of their own — they live in
95
95
[plan.md](plan.md#phase-7--outbound-scripting-http-client). **Phase 6 is gone**: WebFinger and the
@@ -149,7 +149,13 @@ stragglers were absorbed into 5d-2 on 2026-08-06, because WebFinger's imports bl
149
149
### Deleting Restlet
150
150
| I need… | Go to |
151
151
|---|---|
152
-
|**What 5d-2 deletes, file by file**|[phase-5d-2-research.md §2](phase-5d-2-research.md#2) — supersedes the two lists below wherever they differ |
152
+
|**What 5d-2 deletes, file by file**|[phase-5d-2-research.md §2](phase-5d-2-research.md#2), **as amended by [§11](phase-5d-2-research.md#11)** — supersedes the two lists below wherever they differ |
153
+
|**Why the tail is six sub-phases**|[5d-2 § scope & sizing](phase-5d-2.md#scope--sizing--the-tail-split-six-ways)|
154
+
| Which Restlet-legged tests get frozen and which lose their leg (nine, not five) |[research §11.2](phase-5d-2-research.md#112--nine-tests-carry-a-restlet-leg-not-five) + [5d-2 D4](phase-5d-2.md#d4)/[D9](phase-5d-2.md#d9)|
155
+
| ⚠ openam-uma has two **real**`org.restlet.Request` overloads — it is not "constants only" |[research §11.3](phase-5d-2-research.md#113) + [5d-2 D10](phase-5d-2.md#d10)|
156
+
| ⚠ `@ExceptionHandler` dispatch is **polymorphic** — research §3 says otherwise and is wrong |[research §11.4](phase-5d-2-research.md#114--exceptionhandler-dispatch-is-polymorphic-3s-warning-is-wrong)|
157
+
| ⚠ `RestRealmValidator` reaches **openam-sts and openam-entitlements**, modules no inventory lists |[research §11.5](phase-5d-2-research.md#115) + [5d-2 D8](phase-5d-2.md#d8)|
158
+
| Guice unbinds, the `ForgeRockRest` declaration, and the doclint trap |[research §11.6](phase-5d-2-research.md#116--guice-webxml-and-the-doclint-trap)|
153
159
| Why WebFinger had to be ported first |[phase-5d-2-research.md §1](phase-5d-2-research.md#1)|
154
160
| What the 5d-2a review corrected (dispatch is polymorphic; HEAD is handled; audit goes inside the realm layer) |[phase-5d-2-research.md §1 review](phase-5d-2-research.md#1-review) + [5d-2 D1](phase-5d-2.md#d1)/[D2](phase-5d-2.md#d2)|
155
161
|**What `/.well-known` actually answered before the port** (19 probes; 14 of them one byte-identical 500) |[artefacts/well-known-probes-pre-flip.md](artefacts/well-known-probes-pre-flip.md). ⚠ It refuted the review's "only half-broken" claim — [5d-2 D2](phase-5d-2.md#d2) carries the correction |
0 commit comments