diff options
| author | Craig Jennings <c@cjennings.net> | 2026-05-24 03:54:09 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-05-24 03:54:09 -0500 |
| commit | b26133c04b5e386ac3f2b4dd87709c6eb2a374c3 (patch) | |
| tree | 89e6fe7cd6c95169ded3a78ee8cd002ba018b855 /scripts/setup-email.sh | |
| parent | 2953c28445d6f7ebe4b879b5d0d45eff14a51007 (diff) | |
| download | dotemacs-b26133c04b5e386ac3f2b4dd87709c6eb2a374c3.tar.gz dotemacs-b26133c04b5e386ac3f2b4dd87709c6eb2a374c3.zip | |
docs(ai-kb): fold in review 6 and resolve the build-time decisions
The latest design review was a UX and performance pass, and I folded its findings into the spec and the implementation tasks. The important one: human Emacs edits now use the same write path as agent writes. An ai-kb minor mode runs index, full lint, and commit under flock on after-save, so a hand edit can't quietly skip the safety gate. The rest: the generated index.org is now invisible to backlink and orphan logic (excluded from the scan, referenced as plain text rather than id-links), a required :SUMMARY: property feeds the index and query without inference, query gains lexical ranking with recency only as a tie-break, the switch installs a full org-roam profile rather than a two-variable swap, and the browsing surface (dashboard, find, search, show, backlinks, map) is named.
I also answered the six build-time decisions: concrete raw and curation limits, performance budgets for the perf fixtures, the lexical scoring weights, org-roam-graph as the first map implementation, the after-save failure UX (the save always lands, the commit is gated, and a failure shows without trapping the buffer), and the after-save recursion guard. The numeric limits and budgets are starting points to calibrate. The rest are firm. Step 1 stays buildable.
Diffstat (limited to 'scripts/setup-email.sh')
0 files changed, 0 insertions, 0 deletions
