Skip to content

Commit 0e2e1f3

Browse files
chore(plans): add gitsheets-2.9
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011Q2tgjZEUrtvVk6k8SpdXJ
1 parent e13d7da commit 0e2e1f3

1 file changed

Lines changed: 55 additions & 0 deletions

File tree

‎plans/gitsheets-2.9.md‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
status: in-progress
3+
depends: [slug-references]
4+
specs:
5+
- specs/behaviors/storage.md
6+
- specs/behaviors/slug-handles.md
7+
---
8+
9+
# Plan: adopt gitsheets 2.9
10+
11+
## Scope
12+
13+
gitsheets 2.8 and 2.9 shipped the asks this repo filed
14+
(JarvusInnovations/gitsheets #301–#308; 2.9 removed 2.8's `injectedFields`
15+
in favor of the principle that a record carries its own path). This plan
16+
is the bump plus the swaps that need no new design:
17+
18+
- **Bump** to `^2.9.0` (core-napi 0.7.0, `linux-x64-musl` published).
19+
#304's open-time check (every static template field must be required)
20+
passes unchanged, because [`slug-references`](slug-references.md) made
21+
every path field required.
22+
- **#306:** attachments stream with `Content-Length` from `blob.size`
23+
instead of buffering via `read()`.
24+
- **#302:** renames use gitsheets' native rename-on-upsert (the path
25+
annotation carried across, attachments moved by gitsheets), replacing
26+
`services/slug-rename.ts`'s take/restore dance. That covers project,
27+
person, event and series renames, the reference cascade's moved
28+
children, and buzz `?regenerateSlug`, which never carried its image.
29+
30+
Out (own plans): #301 `repo.sync()` → [`gitsheets-sync`](gitsheets-sync.md);
31+
#303/#305 script cleanups → [`gitsheets-scripts`](gitsheets-scripts.md)
32+
follow-up; #307 import-merge runbook.
33+
34+
## Implements
35+
36+
- [behaviors/storage.md](../specs/behaviors/storage.md): attachments
37+
stream with `Content-Length`.
38+
- [behaviors/slug-handles.md](../specs/behaviors/slug-handles.md):
39+
attachments move with renamed records (unchanged rule, new mechanism).
40+
41+
## Validation
42+
43+
- [ ] `gitsheets` resolves to 2.9.x; the musl core-napi is in the lockfile
44+
and loads in the Alpine image
45+
- [ ] Attachments: 200 streams with `Content-Length` and `ETag`; 304 and
46+
404 unchanged; a > 1 MiB blob streams intact (test)
47+
- [ ] No `takeAttachments`/`restoreAttachments` left; rename tests
48+
(person, project, event, cascade) still show attachments moved;
49+
buzz regenerateSlug keeps its image (test)
50+
- [ ] `type-check` + `lint` + full suite green
51+
- [ ] Sandbox and production boot on the release
52+
53+
## Notes
54+
55+
## Follow-ups

0 commit comments

Comments
 (0)