#!/usr/bin/env bash # lib/tests/memory.test.sh — lib/memory.sh (add / status / journal / index / # check / upgrade) and the shared status parser. Hermetic fixtures under one # mktemp dir with its own git repo; flip-tests first (LRN-096), then the # real check on this repo's registries. set -u ROOT="$(cd "$(dirname "$0")/../.." && pwd)" MEM="${MEM_UNDER_TEST:-$ROOT/lib/memory.sh}" pass=0; fail=0 check() { if [ "$2" = "$3" ]; then pass=$((pass+1)); else fail=$((fail+1)); printf 'FAIL %s: got[%s] want[%s]\n' "$1" "$2" "$3"; fi; } FIX=$(mktemp -d); trap 'rm -rf "$FIX"' EXIT cd "$FIX" || exit 1 git init -q . && git config user.email t@t && git config user.name t export MEMORY_DATE=2026-10-27 mkdir -p .claude/memory reg() { # → a v2 registry with no entry printf -- '---\nformat: 2\ntype: %s\nentry_prefix: %s\n---\n\n# %s\n' \ "$2" "$3" "$4" > ".claude/memory/$1" } reg decisions.md decisions_registry BDR 'Decisions registry (BDR)' reg learnings.md learnings_registry LRN 'Learnings registry (LRN)' reg blockers.md blockers_registry BLK 'Blockers registry (BLK)' reg evals.md evals_registry EVAL 'Evals registry (EVAL)' printf -- '---\ntype: journal\n---\n\n# Journal\n\n## 2026-10-26\n- old\n' \ > .claude/memory/journal.md B=.claude/memory/blockers.md printf -- "- **Friction**: \`make\` red\n- **Cause**: x\n\n" > body.md # T1 add: next ID from headings, canonical heading, ID alone on stdout out=$(bash "$MEM" add blocker --title 'make red' --body-file body.md \ --status open) check T1-first-id "$out" BLK-001 check T1b-heading "$(grep -c '^## BLK-001 — make red \[open\] (2026-10-27)$' "$B")" 1 check T1c-body-trimmed "$(tail -1 "$B")" '- **Cause**: x' check T1d-second-id "$(bash "$MEM" add blocker --title 'two' --body-file body.md)" BLK-002 check T1e-check-green "$(bash "$MEM" check; echo $?)" 0 check T1f-index-row "$(bash "$MEM" index blocker | grep -c '^| BLK-001 | 2026-10-27 | make red | open |$')" 1 # T2 add refuses, rc 2, registry unchanged sum=$(cksum < "$B") refused() { # <name> <add args…> → the add is rc 2 local name="$1"; shift bash "$MEM" add "$@" >/dev/null 2>&1 check "T2-$name" "$?" 2 } refused kind unknown --title t --body-file body.md refused bracket blocker --title 'a[b]' --body-file body.md refused pipe blocker --title 'a|b' --body-file body.md refused no-body blocker --title t --body-file missing.md refused status-bracket blocker --title t --body-file body.md --status 'a]' refused cross-prefix blocker --title t --body-file body.md --supersedes LRN-001 refused unknown-sup blocker --title t --body-file body.md --supersedes BLK-099 refused no-value blocker --title t --body-file refused bad-option blocker --title t --body-file body.md --bogus x printf 'no backtick here\n' > plain.md bash "$MEM" add blocker --title t --body-file plain.md 2>/dev/null check T2b-blocker-needs-backtick "$?" 2 check T2c-unchanged "$(cksum < "$B")" "$sum" bash "$MEM" add learning --title t --body-file plain.md >/dev/null check T2d-learning-without-backtick "$?" 0 # T3 status: a dated line ends the entry, before the next heading's blank bash "$MEM" status BLK-001 'resolved abc1234' check T3-rc "$?" 0 check T3b-placed "$(awk '/^## BLK-001/{on=1} on && /^- \*\*Status/{print; exit}' "$B")" \ '- **Status (2026-10-27)**: resolved abc1234' check T3c-before-next "$(awk '/Status \(2026-10-27\)/{getline n; print n; exit}' "$B")" '' bash "$MEM" status BLK-002 'upstream, open' check T3d-at-eof "$(tail -1 "$B")" '- **Status (2026-10-27)**: upstream, open' bash "$MEM" status BLK-404 x 2>/dev/null check T3e-unknown-id "$?" 2 bash "$MEM" status BLK-001 "$(printf 'a\nb')" 2>/dev/null check T3f-multi-line "$?" 2 # T4 journal: appended under today, heading created once, old date untouched J=.claude/memory/journal.md bash "$MEM" journal 'first' bash "$MEM" journal '- second' check T4-heading-once "$(grep -c '^## 2026-10-27$' "$J")" 1 check T4b-order "$(tail -2 "$J" | tr '\n' '|')" '- first|- second|' check T4c-old-kept "$(sed -n '/^## 2026-10-26$/,/^$/p' "$J" | grep -c '^- old$')" 1 bash "$MEM" journal "$(printf 'a\nb')" 2>/dev/null check T4d-multi-line "$?" 2 # T5 --supersedes: forward link on the new entry, status line on the old one L=.claude/memory/learnings.md new=$(bash "$MEM" add learning --title 'better' --body-file plain.md \ --supersedes LRN-001) check T5-id "$new" LRN-002 check T5b-forward "$(tail -1 "$L")" 'Supersedes [[LRN-001]].' word() { # <file> <ID> → the entry's status word, through the lib # shellcheck source=/dev/null (. "$MEM"; memory_status_word "$(memory_entry_status "$1" "$2")") } check T5c-old-status "$(word "$L" LRN-001)" superseded check T5d-index "$(bash "$MEM" index learning | grep -c '^| LRN-001 | 2026-10-27 | t | superseded |$')" 1 # T6 lock: a held lock refuses, a stale one is stolen, concurrent adds get # distinct IDs lock="$(git rev-parse --git-common-dir)/memory.lock" date +%s > "$lock" sum=$(cksum < .claude/memory/evals.md) MEM_LOCK_TRIES=2 bash "$MEM" add eval --title t --body-file plain.md 2>/dev/null check T6-held-rc "$?" 2 check T6b-held-unchanged "$(cksum < .claude/memory/evals.md)" "$sum" echo $(( $(date +%s) - 60 )) > "$lock" check T6c-stale-stolen "$(bash "$MEM" add eval --title t --body-file plain.md)" EVAL-001 check T6d-lock-released "$([ -e "$lock" ] && echo held || echo free)" free for i in 1 2 3 4 5; do bash "$MEM" add decision --title "d$i" --body-file plain.md > "out$i" & done wait check T6e-distinct "$(cat out1 out2 out3 out4 out5 | sort -u | wc -l | tr -d ' ')" 5 check T6f-max "$(cat out1 out2 out3 out4 out5 | sort | tail -1)" BDR-005 check T6g-check-green "$(bash "$MEM" check; echo $?)" 0 # T7 check: shape, duplicate, Index in v2 are rc 2; v1 is named, not failed cp .claude/memory/decisions.md d.bak printf '\n## BDR-005 — again\nx\n' >> .claude/memory/decisions.md err=$(bash "$MEM" check 2>&1 >/dev/null); rc=$? check T7-duplicate-rc "$rc" 2 check T7b-duplicate-named "$(printf '%s\n' "$err" | grep -c 'duplicate BDR-005')" 1 cat d.bak > .claude/memory/decisions.md printf '\n## BDR-7 — short\nx\n' >> .claude/memory/decisions.md bash "$MEM" check 2>/dev/null check T7c-shape-rc "$?" 2 cat d.bak > .claude/memory/decisions.md printf '\n## Index\n' >> .claude/memory/decisions.md bash "$MEM" check 2>/dev/null check T7d-index-in-v2-rc "$?" 2 cat d.bak > .claude/memory/decisions.md mkdir v1 && printf '# Decisions\n\n## BDR-001 - legacy\n' > v1/decisions.md err=$(bash "$MEM" check v1 2>&1 >/dev/null); rc=$? check T7e-v1-rc "$rc" 0 check T7f-v1-named "$(printf '%s\n' "$err" | grep -c '^memory: v1: v1/decisions.md$')" 1 # T8 check --staged: an append passes, a removed entry line is rc 2 git add -A && git commit -qm base bash "$MEM" add blocker --title three --body-file body.md >/dev/null git add "$B" check T8-append-staged "$(bash "$MEM" check --staged; echo $?)" 0 git commit -qm three sed 's/^## BLK-001 — make red/## BLK-001 — make RED/' "$B" > b.tmp \ && cat b.tmp > "$B" git add "$B" err=$(bash "$MEM" check --staged 2>&1 >/dev/null); rc=$? check T8b-removed-line-rc "$rc" 2 check T8c-named "$(printf '%s\n' "$err" | grep -c 'removed inside an entry')" 1 git checkout -q HEAD -- "$B" # T9 upgrade: Index-only dates and statuses become body lines, the marker # lands, the Index goes, headings untouched; idempotent; refusals keep the file mkdir -p up/.claude/memory && cd up || exit 1 cat > .claude/memory/decisions.md <<'EOF' --- type: decisions_registry entry_prefix: BDR --- # Decisions registry (BDR) ## Index | ID | Date | Title | Status | |----|------|-------|--------| | BDR-001 | 2026-01-01 | kept | accepted | | BDR-002 | 2026-01-02 | stale index | accepted | | BDR-003 | 2026-01-03 | gone | superseded by BDR-004 | | BDR-004 | 2026-01-04 | no status | accepted | --- ## BDR-001 — kept (2026-01-01) - **Status**: accepted ## BDR-002 — stale index - **Date**: 2026-01-02 - **Status**: shipped ## BDR-003 — gone - **Status**: accepted ## BDR-004 — no status body EOF cat > .claude/memory/learnings.md <<'EOF' --- type: learnings_registry entry_prefix: LRN --- # Learnings registry (LRN) ## Index | ID | Date | Pattern | Applies to | |----|------|---------|------------| | LRN-001 | 2026-02-01 | old | superseded by LRN-002 | | LRN-002 | 2026-02-02 | new | any shell | ## LRN-001 — old x ## LRN-002 — new y EOF D=.claude/memory/decisions.md heads=$(grep '^## BDR-' "$D") bash "$MEM" upgrade >/dev/null 2>&1 check T9-rc "$?" 0 check T9b-marker "$(sed -n 2p "$D")" 'format: 2' check T9c-no-index "$(grep -c '^## Index$\|^| BDR-' "$D")" 0 check T9d-headings-same "$(grep '^## BDR-' "$D")" "$heads" check T9e-index-out "$(bash "$MEM" index decision | sed -n '5,8p' | tr '\n' '#')" \ '| BDR-001 | 2026-01-01 | kept | accepted |#| BDR-002 | 2026-01-02 | stale index | shipped |#| BDR-003 | 2026-01-03 | gone | superseded |#| BDR-004 | 2026-01-04 | no status | accepted |#' check T9f-lrn-superseded "$(bash "$MEM" index learning | grep -c '^| LRN-001 | 2026-02-01 | old | superseded |$')" 1 check T9g-lrn-applies-dropped "$(grep -c 'any shell' .claude/memory/learnings.md)" 0 check T9h-check-green "$(bash "$MEM" check; echo $?)" 0 sum=$(cksum < "$D") bash "$MEM" upgrade >/dev/null 2>&1 check T9i-idempotent "$(cksum < "$D")" "$sum" cat > .claude/memory/blockers.md <<'EOF' --- type: blockers_registry entry_prefix: BLK --- ## Index | ID | Date | Friction | Status | |----|------|----------|--------| | BLK-001 | 2026-03-01 | dup | open | ## BLK-001 — dup - **Status**: open ## BLK-001 — dup again EOF sum=$(cksum < .claude/memory/blockers.md) bash "$MEM" upgrade >/dev/null 2>&1 check T9j-oracle-refuses "$?" 2 check T9k-refused-untouched "$(cksum < .claude/memory/blockers.md)" "$sum" printf '# Evals\n\n## EVAL-001 | 2026 | pipe dialect\n' > .claude/memory/evals.md bash "$MEM" upgrade >/dev/null 2>&1 check T9l-no-frontmatter-rc "$?" 2 check T9m-dialect-untouched "$(sed -n 1p .claude/memory/evals.md)" '# Evals' cd "$FIX" || exit 1 # T10 parser: header tag and labelled lines only, last wins, open ranks last cp "$ROOT/lib/tests/fixtures/blockers-v2-status.md" st.md check T10-header-tag "$(word st.md BLK-032)" resolved check T10b-prose-open-ignored "$(word st.md BLK-033)" resolved check T10c-fail-open-ignored "$(word st.md BLK-034)" resolved check T10d-final-wins "$(word st.md BLK-008)" resolved check T10e-accepted-before-open "$(word st.md BLK-040)" accepted check T10f-mid-title-bracket "$(word st.md BLK-041)" open # shellcheck source=/dev/null (. "$MEM"; memory_entry_status st.md BLK-042) >/dev/null check T10g-no-candidate-rc "$?" 1 # T11 -C runs from elsewhere check T11-dash-C "$(cd / && bash "$MEM" -C "$FIX" index blocker | grep -c '^| BLK-00')" 3 bash "$MEM" -C /nonexistent check 2>/dev/null check T11b-bad-dir "$?" 2 bash "$MEM" frobnicate 2>/dev/null check T11c-usage "$?" 2 # T12 this repo's registries pass the check check T12-live-check "$(bash "$MEM" -C "$ROOT" check >/dev/null 2>&1; echo $?)" 0 echo "PASS=$pass FAIL=$fail" [ "$fail" -eq 0 ]