diff options
| author | Craig Jennings <c@cjennings.net> | 2026-05-25 04:44:38 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-05-25 04:44:38 -0500 |
| commit | 9f15d1823f388910f695da25ad5878312cc80330 (patch) | |
| tree | 9782a2c9aad6c80fc2bc420c1b484d69b7330112 /package-summary.md | |
| parent | 619d4ce0294ff318a96e2f82a8f9401111bb619d (diff) | |
| download | pearl-9f15d1823f388910f695da25ad5878312cc80330.tar.gz pearl-9f15d1823f388910f695da25ad5878312cc80330.zip | |
docs: incorporate the spec reviews and move four specs to Ready
I folded the Codex reviews into four draft specs and brought each to Ready. The reviews surfaced real failure modes, not nits, so the changes are substantive.
The comment-deletion spec is Ready: I verified Linear's commentDelete contract against the live API. The mutation is commentDelete(id: String!) returning success, and the comment is not found immediately after, so there's no restore path and undo is impossible. The dirty-local-comment policy is allow-with-discard-wording, the prompt names both the remote delete and the local removal, and the d c keymap / K transient slots are settled.
The multi-account spec is Ready. The original "set the globals on switch and let downstream stay oblivious" model leaked across accounts in the async code, so it's redesigned around an account-context layer: dispatch-time context snapshots, #+LINEAR-ACCOUNT file ownership with wrong/unmarked-buffer guards, a runtime (not persisted) active-account, a mode-line indicator, and an exact startup rule. The five safety calls are settled as the safer defaults.
The sort-order spec is Ready. Client-side sort now moves whole issue subtrees by LINEAR-ID byte-for-byte rather than reparsing and rewriting, which would have dropped unsaved edits. Header persistence is atomic with the reorder, and Custom Views refuse server-side sort in v1 since customView.issues has no verified orderBy.
The labels-as-org-tags spec is Ready: collisions render the shared tag once with the drawer authoritative, Pearl owns the whole issue-heading tag set, manual tag edits are overwritten and never pushed, and Unicode alphanumerics are preserved.
Diffstat (limited to 'package-summary.md')
0 files changed, 0 insertions, 0 deletions
