docs: move the session history into LOGS.md, record the compaction policy #62
No reviewers
Labels
No labels
NaNs
area/dsh
area/forgejo
experiment
priority/later
priority/next
priority/now
type/bug
type/task
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set
Reference
dsh-plugins/dsh-gitea!62
Loading…
Reference in a new issue
No description provided.
Delete branch "docs/logs-split"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
What
AGENTS.mdhad grown to 65 KB, past the workspace instruction budget (it was being truncated for agents), and about half of it was chronological session logs. This splits the two concerns:LOGS.md(new, 31 KB) — the full session history, verbatim: what was broken, what changed, how it was verified. Header says explicitly:README.mdis the user manual,AGENTS.mdthe agent manual, this file the lab notebook.AGENTS.md(38 KB) — keeps the current-state sections (setup, bugs table, settings contract, routes, ground rules, repo map) and replaces the logs with a one-line-per-session index linking toLOGS.md.Also recorded, per operator decision:
v0.8.*tags keep the old shas resolvable, narrative stays inCHANGELOG.md/LOGS.md.AGENTS.mdpoints at it as the 0.9.0 dependency.Verification
npm run check: 195 tests, leak scan clean, syntax clean (docs-only change).LOGS.mdstarts at the 2026-10-22 session and ends at the 0.8.8 entry; every## Session logheading fromAGENTS.mdis present exactly once.AGENTS.mdindex has 21 rows, oldest first, and the file is 38 KB — comfortably inside the budget.