TODO.md had reached 1050 lines and 72 open items across 28 sections, read mostly on a phone. It is now a directory: todo/<theme>/<item>.md, one card per file, with frontmatter carrying id, status, created date and order, and the prose body copied across verbatim. TODO.md becomes a generated index (bun run todo:index). Dates: where an item's prose stated one it is used; otherwise its old section's; otherwise 2026-08-20, floored at the day before the split rather than invented. date_source records which. Shaped for a two-way Kanban board, filed as todo/tooling — a card is a file, id is the identity, frontmatter is the machine's half and the body is the owner's. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1.4 KiB
id, title, theme, status, created, date_source, order
| id | title | theme | status | created | date_source | order |
|---|---|---|---|---|---|---|
| infra/revisit-the-frozen-lockfile-rule-in-claude-md | Revisit the frozen-lockfile rule in `CLAUDE.md`, now that plugins resolve at install time | infra | open | 2026-08-20 | stated | 5 |
Revisit the frozen-lockfile rule in CLAUDE.md, now that plugins resolve at install time.
Raised by the owner 2026-08-20, to be discussed rather than decided alone.
The rule as written is absolute: bunfig.toml sets frozenLockfile = true, bun install resolves
from bun.lock and nothing else, and an unexplained lockfile change in a diff is the signal the
whole arrangement exists to produce. The reasoning is the 2026-08-04 compromise, and it is good.
npmDependencies does not follow it. Plugin packages are declared as RANGES and installed with a
plain bun install into plugins/node_modules/, so they resolve per machine and per install. That
was chosen deliberately — ranges are what let two plugins share one copy of sharp — but it means
the codebase now holds two different postures on the same risk, and only one of them is written down.
Worth settling: whether the rule should say "the platform's own dependencies" rather than reading as
universal; whether the merged plugins/bun.lock should be committed after all (it would pin the
tree, at the cost of a per-machine file in git); and whether bun install --frozen-lockfile in
plugins/ is achievable once that lockfile exists.