Просмотр исходного кода

docs: map open-array M4 summary/session tags

Eric Streit 1 день назад
Родитель
Сommit
6e40e26c6e
1 измененных файлов с 19 добавлено и 16 удалено
  1. 19 16
      docs/git-branches-tags.md

+ 19 - 16
docs/git-branches-tags.md

@@ -1,10 +1,10 @@
 # Git branches and tags — how this repository is organised
 
-**Snapshot:** 2026-10-23, after open-array M4.  `master` =
-`df72d03` (array payload `SIZE` and view `ADR`); `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.  310 tags (308 `v3-*` checkpoints).
+**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).
 
 Mental model:
 
@@ -52,6 +52,7 @@ Each points at the commit that landed a feature, all with green gates:
 | `v3-open-arrays-m2` | `4616e51` | fixed rank-2/3 flat storage + views |
 | `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 |
 
 These are immutable checkpoints.  Useful commands:
 
@@ -67,16 +68,18 @@ git diff v3-sysclock v3-smallfix      # what the last step changed
 | `v3-session-2026-10-19` | `c9c1121` | Previous session's final summary. |
 | `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` | **Final immutable 2026-10-23 exceptions session tag.** |
+| `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-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-end`;
-- `v3-session-2026-10-23` is the earlier range-check checkpoint and is
-  a *moving* tag by convention.
+- **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.
 
 For "where did the 2026-10-22 session end?":
 
@@ -98,18 +101,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` = 307 (305 `v3-*`) is expected; only the
+`git tag --list | wc -l` = 312 (310 `v3-*`) is expected; only the
 recent ones above matter for the current session.
 
 ## Current state
 
-- `master` = `df72d03` (open-array M4), **7 commits ahead** of
+- `master` = `707b7e4` (open-array M4 summary), **9 commits ahead** of
   `origin/master` (`b3d049f`): the open-array design, M1/M2/M3/M4 and
-  their docs follow-ups.
-- `v3-finally`, `v3-open-arrays-m2`, `v3-open-arrays-m3` and
-  `v3-open-arrays-m4` are local; push them with `master` when ready.
-  Earlier exception/pointer/functionException tags are already on the
-  remote.
+  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.
 - 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.