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 | e0db4e5e43f7b34913774b4ccdd7ee62d6a9ab6a (patch) | |
| tree | bc6a8dd3f290f1dd8464c0fa7d410f2bbc81d347 /scripts | |
| parent | cf598db3328586c2d466412167c8984b15ffd059 (diff) | |
| download | dotemacs-e0db4e5e43f7b34913774b4ccdd7ee62d6a9ab6a.tar.gz dotemacs-e0db4e5e43f7b34913774b4ccdd7ee62d6a9ab6a.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')
0 files changed, 0 insertions, 0 deletions
