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 | b0759bbf7a8e0164b798c477aaee44b1df665292 (patch) | |
| tree | 2f68b327269b7e29dd0f6896bc9526f5e5ec6aa9 /modules/system-commands.el | |
| parent | 72b9f81c165111b486263625c3f70f646e450653 (diff) | |
| download | dotemacs-b0759bbf7a8e0164b798c477aaee44b1df665292.tar.gz dotemacs-b0759bbf7a8e0164b798c477aaee44b1df665292.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 'modules/system-commands.el')
0 files changed, 0 insertions, 0 deletions
