Bläddra i källkod

docs: map open-array M5 summary/session tags

Eric Streit 4 dagar sedan
förälder
incheckning
d5670812d2
1 ändrade filer med 23 tillägg och 18 borttagningar
  1. 23 18
      docs/git-branches-tags.md

+ 23 - 18
docs/git-branches-tags.md

@@ -1,10 +1,10 @@
 # Git branches and tags — how this repository is organised
 
-**Snapshot:** 2026-10-23, after the open-array M4 session summary.
-`master` = `707b7e4`; `origin/master` = `b3d049f`.  The open-array
-M1/M2/M3/M4 work is local and **not pushed yet**; earlier
-exceptions/pointer/functionException/finally work is also local where
-noted.  312 tags (310 `v3-*` checkpoints).
+**Snapshot:** 2026-10-24, after the open-array M5 session summary.
+`master` = the current docs commit (M5 summary + tag map);
+`origin/master` = `6e40e26`.  M5 (record fields and constructors) is
+local; the earlier M1–M4 work is already reflected on `origin/master`.
+315 tags (313 `v3-*` checkpoints).
 
 Mental model:
 
@@ -53,6 +53,8 @@ Each points at the commit that landed a feature, all with green gates:
 | `v3-open-arrays-m3` | `557addb` | open multi-array views + call conversion |
 | `v3-open-arrays-m4` | `df72d03` | payload `SIZE`/`TSIZE` and view `ADR` |
 | `v3-open-arrays-m4-summary` | `707b7e4` | M4 session summary/comparison/README refresh |
+| `v3-open-arrays-m5` | `04ab8b5` | flat multi-dimensional record fields and constructors |
+| `v3-open-arrays-m5-summary` | `680ace0` | M5 summary/docs refresh |
 
 These are immutable checkpoints.  Useful commands:
 
@@ -69,17 +71,20 @@ git diff v3-sysclock v3-smallfix      # what the last step changed
 | `v3-session-2026-10-23` | `2d1c658` | **Moving** session tag, advanced once for the range-check summary. |
 | `v3-session-2026-10-23-end` | `adba8eb` | Immutable PACKEDSET/range-check stop point (earlier the same day). |
 | `v3-session-2026-10-23-exceptions-end` | `96a3080` | Immutable 2026-10-23 exceptions session tag. |
-| `v3-session-2026-10-23-open-arrays-end` | `707b7e4` | **Final immutable 2026-10-23 open-array session tag.** |
+| `v3-session-2026-10-23-open-arrays-end` | `707b7e4` | 2026-10-23 open-array M1–M4 session tag. |
+| `v3-session-2026-10-24-open-arrays-end` | `680ace0` | **Final immutable 2026-10-24 open-array M5 session tag.** |
 | `v3-session-2026-10-22` | `c2664ac` | **Moving** session tag. Advanced several times and force-pushed to the final commit. |
 | `v3-session-2026-10-22-final` | `0e81019` | **Early checkpoint** created before the session continued (byte/word16/SysClock/smallfix came after). Historical noise now. |
 | `v3-session-2026-10-22-end` | `c2664ac` | **Final immutable session tag.** Use this one. |
 
 For "where did the 2026-10-23 session end?":
 
-- **canonical:** `v3-session-2026-10-23-open-arrays-end`;
-- the earlier checkpoints are `v3-session-2026-10-23-end` (range
-  checks/PACKEDSET) and `v3-session-2026-10-23-exceptions-end`
-  (exceptions); `v3-session-2026-10-23` is a *moving* tag by convention.
+- **canonical:** `v3-session-2026-10-24-open-arrays-end` for the M5
+  stop point;
+- earlier checkpoints are `v3-session-2026-10-23-open-arrays-end`
+  (M1–M4), `v3-session-2026-10-23-exceptions-end` (exceptions) and
+  `v3-session-2026-10-23-end` (range checks/PACKEDSET);
+  `v3-session-2026-10-23` is a *moving* tag by convention.
 
 For "where did the 2026-10-22 session end?":
 
@@ -101,18 +106,18 @@ git push origin :refs/tags/v3-session-2026-10-22-final
 The project convention is one `v3-*` tag per green step across all
 sessions (two-phase parse slices, generics increments, Unicode, stdlib,
 …).  They are a searchable history of passing states, not branches.
-`git tag --list | wc -l` = 312 (310 `v3-*`) is expected; only the
+`git tag --list | wc -l` = 315 (313 `v3-*`) is expected; only the
 recent ones above matter for the current session.
 
 ## Current state
 
-- `master` = `707b7e4` (open-array M4 summary), **9 commits ahead** of
-  `origin/master` (`b3d049f`): the open-array design, M1/M2/M3/M4 and
-  their docs/session follow-ups.
-- `v3-finally`, `v3-open-arrays-m2/m3/m4`,
-  `v3-open-arrays-m4-summary` and the 2026-10-23 open-array session
-  tag are local; push them with `master` when ready.  Earlier
-  exception/pointer/functionException tags are already on the remote.
+- `master` = current docs commit (open-array M5 summary + tag map),
+  **3 commits ahead** of `origin/master` (`6e40e26`): M5 code, docs and
+  this tag map.
+- `v3-open-arrays-m5`, `v3-open-arrays-m5-summary` and
+  `v3-session-2026-10-24-open-arrays-end` are local; push them with
+  `master` when ready.  The earlier open-array tags through M4 are
+  already on the remote.
 - Next session: start from `master` and read
   `docs/handoff-2026-10-23-next.md`; continue with open-array M5
   (records/constructors) and the optional pointer-based 1-D view.