docs+tests(sort-order): update for code-binding order on stories/tasks

- Rewrite docs/patterns/sort-order.md: float-insertion PBI only; story/task
  sort_order = parseCodeNumber(code), never drag/membership mutated
- Update plan-to-pbi-flow.md: sort_order auto, sprint_id param, priority=label
- Update make-plan.md: priority=label, array order = execution order
- Update rest-contract.md: fix sprint-tasks ordering, remove reorder endpoint
- Add ADR-0011: code is bindende volgordesleutel voor stories/taken
- Regenerate docs/INDEX.md via npm run docs
- Remove reorderStoriesAction/reorderTasksAction mocks from backlog tests
- Remove dnd-kit mocks from task-panel test (panel no longer uses dnd)
- Extend materializeIdeaPlanAction test: assert sort_order=parseCodeNumber(code)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

docs/patterns/sort-order.md

@@ -1,15 +1,22 @@
 ---
-title: "Float sort_order (drag-and-drop volgorde)"
+title: "sort_order — PBI drag-and-drop vs. code-bindende volgorde voor stories/taken"
 status: active
 audience: [ai-agent, contributor]
 language: nl
-last_updated: 2026-05-03
-when_to_read: "When implementing drag-and-drop reordering or inserting between items."
+last_updated: 2026-05-14
+when_to_read: "When implementing ordering for PBIs (drag-and-drop) or stories/tasks (code-binding)."
 ---
 
-# Patroon: Float sort_order (drag-and-drop volgorde)
+# Patroon: sort_order — PBI vs. Story/Taak
 
-## Berekening bij tussenvoeging
+`sort_order` heeft voor PBI's een andere betekenis dan voor stories en taken.
+
+---
+
+## PBI — float-insertion (drag-and-drop)
+
+PBI's ondersteunen drag-and-drop herordening. `sort_order` is een `Float` die via de
+midpoint-formule wordt berekend bij tussenvoeging:
 
 ```ts
 function getSortOrder(before: number | null, after: number | null): number {
@@ -20,9 +27,9 @@ function getSortOrder(before: number | null, after: number | null): number {
 }
 ```
 
-## Herindexeer als precisie opraakt
+### Herindexeer als precisie opraakt
 
-Trigger wanneer het kleinste verschil tussen twee opeenvolgende items < 0.001 is.
+Trigger wanneer het kleinste verschil tussen twee opeenvolgende PBI's < 0.001 is:
 
 ```ts
 async function reindexIfNeeded(items: { id: string; sort_order: number }[]) {
@@ -37,12 +44,62 @@ async function reindexIfNeeded(items: { id: string; sort_order: number }[]) {
 }
 ```
 
-## Reorder Server Actions
+### Reorder Server Action (PBI-only)
 
-Een drag-and-drop reorder stuurt altijd client-controlled ID-lijsten naar de server. Behandel die lijst als onbetrouwbaar.
+Een drag-and-drop reorder stuurt client-controlled ID-lijsten naar de server.
+Behandel die lijst als onbetrouwbaar:
 
 - Weiger dubbele IDs.
-- Haal alle IDs op met de parent-scope, bijvoorbeeld `product_id`, `pbi_id`, `sprint_id` of `story_id`.
+- Haal alle IDs op met de parent-scope (`product_id`).
 - Weiger de operatie als het aantal gevonden records niet exact gelijk is aan het aantal aangeleverde IDs.
 - Update pas daarna `sort_order` in een transactie.
 - Gebruik bij priority changes dezelfde parent uit de database, niet een los meegegeven `productId`.
+
+---
+
+## Story / Taak — code-bindende volgorde (geen drag-and-drop)
+
+Voor stories en taken is `sort_order` een **numerieke spiegel van `code`**, berekend via
+`parseCodeNumber(code)` uit `lib/code.ts`. Drag-and-drop herordening bestaat niet voor
+stories en taken.
+
+### Wanneer `sort_order` wordt gezet
+
+| Moment | Wat er gebeurt |
+|---|---|
+| `story.create` / `task.create` | `sort_order = parseCodeNumber(code)` |
+| Idea-materialisatie (`materializeIdeaPlanAction`) | idem — stories en taken krijgen `sort_order = parseCodeNumber(storyCode / taskCode)` |
+| Code-edit (PATCH met nieuw `code`) | `sort_order = parseCodeNumber(newCode)` wordt bijgewerkt |
+| Sprint-membership-acties | `sort_order` wordt **niet** aangeraakt |
+
+### `parseCodeNumber`
+
+Extraheert het trailertal uit een code-string:
+
+```ts
+// lib/code.ts
+export function parseCodeNumber(code: string): number {
+  const match = code.match(/(\d+)$/)
+  return match ? parseInt(match[1], 10) : 0
+}
+```
+
+Voorbeelden: `"ST-042"` → `42`, `"T-7"` → `7`, `"CUSTOM-FOO"` → `0`.
+
+### Ordering queries
+
+Stories en taken worden **uitsluitend** op `sort_order` geordend — nooit op `priority`:
+
+```ts
+// stories binnen een sprint
+orderBy: [{ sort_order: 'asc' }]
+
+// taken binnen een story
+orderBy: { sort_order: 'asc' }
+
+// taken binnen een sprint (story-volgorde eerst)
+orderBy: [{ story: { sort_order: 'asc' } }, { sort_order: 'asc' }]
+```
+
+`priority` is een **label** (urgentie-aanduiding voor de gebruiker), geen
+sorteerkriteria voor stories of taken.