kayg/calternal
Watch
1
0
Fork
You've already forked calternal
 0
Code Issues 190 Pull requests 61 Projects Releases Packages Wiki Activity Actions 26

Foundation docs: ADRs, CONTEXT.md, TASTE.md #15

Closed
kayg wants to merge 0 commits from issue/2-foundation-docs into dev
pull from: issue/2-foundation-docs
merge into: kayg:dev
Conversation 1 Commits - Files changed -
kayg commented 2026-10-13 15:01:32 +00:00
Owner
Copy link

Closes #2

The decisions from the 2026-10-13 grill, written down:

  • docs/adr/: 38 one-page ADRs (decision, why, rejected), grouped: how we work, architecture, editor, notes on disk, sign-in, search, running Calternal, design. Index in docs/adr/README.md.
  • CONTEXT.md: the glossary in plain words.
  • TASTE.md: design principles and starting tokens (type, spacing, radii, sizes, colour, motion). The mockup decides the final values.

Includes kayg's corrections: only default and source mode (no Obsidian-style), properties read-only in the info sheet and visible in source mode, Google Fonts directory deferred, the corruption trap catalogue keeps growing (#3).

ADR 0020 now carries all 17 guards kayg adopted from the #3 catalogue (G1-G17: check before write, idempotency keys, base-required replace, UTF-16 offsets, line endings and BOM, filename normalisation, no editor drift, IME-safe remote apply, cross-file undo, fresh pasted block ids, one atomic write recipe, offline honesty, no server save loops, restore as forward edit, lock handover, protocol handshake, daily-note ids from user and date). Each guard's test is a permanent merge gate. 0005, 0011, 0021, 0023, 0024, 0026 and 0032 got matching one-line notes; 0005 also notes the perf VM runs without host disk cache, so budgets are conservative.

🤖 Generated with Claude Code

https://claude.ai/code/session_018Yyy8fQGxPLkLa8v8NXz7T

Closes #2 The decisions from the 2026-10-13 grill, written down: - `docs/adr/`: 38 one-page ADRs (decision, why, rejected), grouped: how we work, architecture, editor, notes on disk, sign-in, search, running Calternal, design. Index in `docs/adr/README.md`. - `CONTEXT.md`: the glossary in plain words. - `TASTE.md`: design principles and starting tokens (type, spacing, radii, sizes, colour, motion). The mockup decides the final values. Includes kayg's corrections: only default and source mode (no Obsidian-style), properties read-only in the info sheet and visible in source mode, Google Fonts directory deferred, the corruption trap catalogue keeps growing (#3). ADR 0020 now carries all 17 guards kayg adopted from the #3 catalogue (G1-G17: check before write, idempotency keys, base-required replace, UTF-16 offsets, line endings and BOM, filename normalisation, no editor drift, IME-safe remote apply, cross-file undo, fresh pasted block ids, one atomic write recipe, offline honesty, no server save loops, restore as forward edit, lock handover, protocol handshake, daily-note ids from user and date). Each guard's test is a permanent merge gate. 0005, 0011, 0021, 0023, 0024, 0026 and 0032 got matching one-line notes; 0005 also notes the perf VM runs without host disk cache, so budgets are conservative. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_018Yyy8fQGxPLkLa8v8NXz7T
Closes #2

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Yyy8fQGxPLkLa8v8NXz7T
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Yyy8fQGxPLkLa8v8NXz7T
kayg commented 2026-10-15 08:35:45 +00:00
Author
Owner
Copy link

Closing: this branch is already fully contained in dev (it landed through a merge train). Branch cleanup, 2026-10-15.

Closing: this branch is already fully contained in `dev` (it landed through a merge train). Branch cleanup, 2026-10-15.
kayg closed this pull request 2026-10-15 08:35:45 +00:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
backend
Rust server

  
design
Mockups, UI and TASTE

  
docs
ADRs, CONTEXT, TASTE

  
idea
Parked idea, never worked until promoted

  
infra
Deploy, CI, VMs

  
perf
Performance and budgets

  
reliability
Data integrity, corruption traps

  
web
Web client

No labels
backend
design
docs
idea
infra
perf
reliability
web
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
kayg/calternal!15
No description provided.