# NOTES - general context + session notes
# Free-form companion file. Append a dated note each session.

## Session notes
[2026-08-10] NOTE: started the decision log. Fork rule, three states
  (LOCKED / OPEN / REVISED), append-only with SUPERSEDES back-links.
  Boot recall is the product: start.py surfaces last decisions + OPEN.

## Session notes
SESSION NOTE (2026-08-09): built agent-decision-log (initial release, [Unreleased]). Fork rule, three states (LOCKED/OPEN/REVISED), append-only with SUPERSEDES back-links, boot recall in start.py, --review compounding loop. Companion to agent-error-log; cross-linked in README. 95 unit tests.

SESSION NOTE (2026-08-09): v0.4.0 released (PR #12 -> master 790fc5b). Bundles the --stats analytics command, the _topic_of heuristic docs, and the OPEN-decision resolve chore accumulated since v0.3.0. Release decision dogfooded first (26 decisions, lint 0/0). Master CI 9/9 green - commit-message gate success, drift guard success, release workflow tagged v0.4.0 and published the draft (draft: false). 124 tests unchanged. Pattern worth remembering: small verified batches accumulate in [Unreleased], then ship in one version bump.

SESSION NOTE (2026-08-10): real-test re-run vs shipped masters - 2293/2293 green (error-log 749, decision-log 770, log-ai 774 incl live Ollama) with the stdin-utf8 fix live in all 3 (masters 1e4441e/73fa3f2/97036db). Re-run caught a 3rd recurrence of the HEAD-anchored-SHA-pin class: 3 VERIFY pins used `git log --oneline -1`, broke on every PR merge. Hardened all 5 to history-anchored `git log --oneline | grep -q`, fixed stale test-count pins (128/127/95 -> 132/131/96), added workspace rule 13 (VERIFY SHA PINS MUST BE HISTORY-ANCHORED). Workspace 98/98 pins, boot rc=0. Lesson: pins referencing commits must use history membership, never HEAD.

NOTE: AREA marker used on this repo's merge commits MUST match a log entry title in this repo's own decisions.txt (the commit-message gate checks it). For the stdin fix, the correct marker is 'fix unicode stdin double-encoding on Windows' - not the error-log phrasing.
