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 | 70a12fd2c540922764d8dbbbecc8cc92a1efea3c (patch) | |
| tree | ea1dbe893d0f26bcf0e79ef1721ac05605de92b1 /tests/test-prog-python-setup.el | |
| parent | 903bfaa9eb9ff0b1f03d799b2c84f4eae541b28a (diff) | |
| download | dotemacs-70a12fd2c540922764d8dbbbecc8cc92a1efea3c.tar.gz dotemacs-70a12fd2c540922764d8dbbbecc8cc92a1efea3c.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 'tests/test-prog-python-setup.el')
0 files changed, 0 insertions, 0 deletions
