Pārlūkot izejas kodu

docs: record v3-packedset and the 2026-10-23 session tags

Eric Streit 16 stundas atpakaļ
vecāks
revīzija
adba8ebba5
2 mainītis faili ar 22 papildinājumiem un 10 dzēšanām
  1. 21 9
      docs/git-branches-tags.md
  2. 1 1
      docs/summary_session-2026-10-23.md

+ 21 - 9
docs/git-branches-tags.md

@@ -1,7 +1,9 @@
 # Git branches and tags — how this repository is organised
 
-**Snapshot:** 2026-10-22, stop point. `master` = `c2664ac`, in sync
-with `origin/master`. 298 tags (mostly historical `v3-*` checkpoints).
+**Snapshot:** 2026-10-23, after `v3-packedset`. `master` =
+`6b2df4c` (the PACKEDSET feature commit) plus a docs follow-up;
+`origin/master` = `2d1c658`.  The new commits are local and **not
+pushed yet**.  300 tags (mostly historical `v3-*` checkpoints).
 
 Mental model:
 
@@ -12,7 +14,7 @@ Mental model:
 
 | Branch | State | What it is |
 | --- | --- | --- |
-| **`master`** | `c2664ac`, in sync with `origin/master` | The only active branch; all current work is here. |
+| **`master`** | `6b2df4c` + docs, ahead of origin | The only active branch; all current work is here. |
 | `ast-stage-c` | `0f611c0` (2026-10-08), local only | Old stage branch, fully merged into master. Stale. |
 | `generics-inc1` | `6639c19`, 6 commits behind `origin/generics-inc1` | Old generics work, fully merged into master. Stale. |
 | `resolve-check` | `95ca4d6`, in sync with origin | Old branch merged into master. Stale. |
@@ -40,6 +42,8 @@ Each points at the commit that landed a feature, all with green gates:
 | `v3-word16` | `a5d0f16` | true 16-bit `WORD16`/`CARDINAL16`/`INTEGER16` |
 | `v3-sysclock` | `4d05afe` | ISO `SysClock` (+2) |
 | `v3-smallfix` | `87e8605` | small conformance items (+6) |
+| `v3-rangechecks` | `54d84b9` | runtime subrange range checks (+3 trap tests) |
+| `v3-packedset` | `6b2df4c` | ISO `PACKEDSET`, 1/2/4-byte storage |
 
 These are immutable checkpoints.  Useful commands:
 
@@ -53,10 +57,18 @@ git diff v3-sysclock v3-smallfix      # what the last step changed
 | Tag | Points at | Meaning |
 | --- | --- | --- |
 | `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` | final docs commit | **Final immutable 2026-10-23 tag** (PACKEDSET + docs). |
 | `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.
+
 For "where did the 2026-10-22 session end?":
 
 - **canonical:** `v3-session-2026-10-22-end` (or `master`, same commit);
@@ -72,18 +84,18 @@ git tag -d v3-session-2026-10-22-final
 git push origin :refs/tags/v3-session-2026-10-22-final
 ```
 
-## Why 298 tags?
+## Why 300 tags?
 
 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` = 298 is expected; only the recent ones above
+`git tag --list | wc -l` = 300 is expected; only the recent ones above
 matter for the current session.
 
 ## Current state
 
-- `master` = `c2664ac`, **synced** with `origin/master`.
-- All feature tags and session tags are on the remote.
-- Nothing to push.
+- `master` = `6b2df4c` + docs, **ahead** of `origin/master` (`2d1c658`).
+- `v3-rangechecks`, `v3-packedset` and the 2026-10-23 session tags are
+  local; push them with `master` when ready.
 - Next session: start from `master` and read
-  `docs/handoff-2026-10-22-next.md`.
+  `docs/handoff-2026-10-23-next.md`.

+ 1 - 1
docs/summary_session-2026-10-23.md

@@ -51,7 +51,7 @@ Regressions: `t_trap_range` (assignment), `t_trap_range_arg` (actual),
 | commit | tag | work |
 | --- | --- | --- |
 | `54d84b9` | `v3-rangechecks` | runtime subrange range checks (+3 trap tests) |
-| `pending` | `v3-packedset` | PACKEDSET 1/2/4-byte storage |
+| `6b2df4c` | `v3-packedset` | PACKEDSET 1/2/4-byte storage |
 
 ## Remaining