Skip to content

docs(learnings): archive 25 lessons — 14 RESOLVED + 11 aged ≥11d; clears the projection advisory - #1167

Merged
SQPferrer merged 2 commits into
masterfrom
dev/2026-07-27-memory-archive-resolved
Jul 27, 2026
Merged

docs(learnings): archive 25 lessons — 14 RESOLVED + 11 aged ≥11d; clears the projection advisory#1167
SQPferrer merged 2 commits into
masterfrom
dev/2026-07-27-memory-archive-resolved

Conversation

@Ljferrer

@Ljferrer Ljferrer commented Jul 27, 2026

Copy link
Copy Markdown
Owner

Two operator-directed archive passes on the memory corpus, run after /lessons-learned tighten found it had no lever to pull. Archiving is a move into archive/ plus a note — never a deletion. All 25 lessons stay queryable, and [[wikilinks]] into archive/ still resolve.

Net result: projection 23,112 B / 121 lines → 16,797 B / 96 lines. tighten-plan now reports verdict: ok against the 17,000 B advisory, which it had been failing since well before this session.

Why tighten itself could do nothing

The preflight returned verdict: warn with zero eligible candidates — all 114 projected rows sat behind a floor:

Floor Rows
Concept hub (≥2 inbound citers) 55
Younger than TIGHTEN_YOUNG_DAYS (14d) 49
user-confirmed tier 6
Undated (protected) 4

Usage-scored eviction cannot act on a corpus this new and this interlinked.

Commit 1 — aec4d94: 14 RESOLVED lessons

Every lesson whose description carries the RESOLVED stamp. MITIGATED (3) and ENCODED (1) were deliberately left hot — neither marker means resolved.

Seven are concept hubs with ≥2 genuine inbound citers, archived on explicit operator instruction against the standing guidance in retiring-a-resolved-memory-must-check-inbound-links-hubs-stay. Reversible per slug: git mv back out of archive/ and re-render.

Commit 2 — c686bc3: 11 lessons aged ≥11 days

Every lesson at or above 11 days old that clears tightenPlan's other floors.

Why 11 and not 10. Ages cluster rather than spread, so 11 days is the cliff — eight lessons sit at exactly 12 days, three at 11, then nothing until 7:

Threshold Eligible Freed Projection
<14d (default) 0 0 19,553 ✗
<12d 8 1,984 17,569 ✗
<11d 11 2,756 16,797 ✓
<10d 11 2,756 16,797 ✓
<9d 11 2,756 16,797 ✓

<10d and <9d buy nothing over <11d while costing extra days of protection, so the pass was cut at 11.

Two entries tripped archive's concept-hub WARN at "2 inbound refs", but that warning counts a cross-root-dupe citer once per root while the inbound verb dedupes by slug — deduped they are 1 inbound each, which is why tightenPlan's hub floor admitted them. Known quirk, recorded in archive-hub-warning-counts-cross-root-dupe-citer-twice.

Mechanics that matter

Both halves of every cross-root pair were archived, local first then repo. That order is load-bearing: archive's prefer-local rule means archiving one copy of a dupe frees zero projection bytes, because buildProjection re-collapses the surviving twin into the same row.

Safety

🤖 Generated with Claude Code

WAR Test and others added 2 commits July 27, 2026 15:50
Operator-directed archive pass. Every lesson whose description carries the
RESOLVED stamp moves from the hot set into docs/learnings/archive/ — a move
plus an archive note, never a deletion. All 14 stay queryable, and links into
archive/ still resolve.

Both halves of each cross-root pair were archived (local first, then repo) so
the projection row actually drops: archiving one copy of a dupe frees zero
bytes because buildProjection re-collapses the surviving twin.

Projection: 23,112 B / 121 lines -> 19,553 B / 107 lines. Still 2,553 B above
the 17,000 B advisory — usage-scored tighten cannot close the gap yet (all 114
rows sit behind a floor: 55 hubs, 49 younger than 14 days, 6 user-confirmed,
4 undated).

Seven of the 14 are concept hubs with >=2 inbound citers, archived on explicit
operator instruction against the standing hubs-stay guidance in
retiring-a-resolved-memory-must-check-inbound-links-hubs-stay. Reversible:
git mv the file back out of archive/ and re-render.

MITIGATED (3) and ENCODED (1) lessons were deliberately left hot — neither
marker means resolved.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…ection advisory

Second operator-directed archive pass on this branch. Archives every lesson
at or above 11 days old that clears tightenPlan's other floors (not a hub, not
user-confirmed, dated).

Threshold rationale: ages cluster rather than spread, so 11 days is the cliff.
<12d yields 8 lessons (17,569 B — still over); <11d yields 11 (16,797 B —
clears); <10d and <9d yield the same 11 and buy nothing extra. Lowering past
11 costs protection and returns zero bytes.

Both halves of each cross-root pair archived, local first then repo.

Projection: 19,553 B / 107 lines -> 16,797 B / 96 lines. tighten-plan now
reports verdict: ok against the 17,000 B advisory (was warn since well before
this session).

Two entries tripped archive's concept-hub WARN at 2 inbound refs, but that
warning counts a cross-root-dupe citer once per root while the inbound verb
dedupes by slug — deduped they are 1 inbound each, which is why tightenPlan's
hub floor admitted them. Known quirk, recorded in
archive-hub-warning-counts-cross-root-dupe-citer-twice.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@Ljferrer Ljferrer changed the title docs(learnings): archive 14 RESOLVED lessons docs(learnings): archive 25 lessons — 14 RESOLVED + 11 aged ≥11d; clears the projection advisory Jul 27, 2026
@SQPferrer
SQPferrer merged commit 90a5db3 into master Jul 27, 2026
1 check passed
@SQPferrer
SQPferrer deleted the dev/2026-07-27-memory-archive-resolved branch July 27, 2026 22:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants