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 | 6ebd0314c880c4f9fc15936618ad412cef6ea309 (patch) | |
| tree | 3d7125c2f43d4e17076aa854561c48314ff60e5f /modules/markdown-config.el | |
| parent | 8270a4e94e3bdd7cb52a93f9f4b74c1ae6ad6c4f (diff) | |
| download | dotemacs-6ebd0314c880c4f9fc15936618ad412cef6ea309.tar.gz dotemacs-6ebd0314c880c4f9fc15936618ad412cef6ea309.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/markdown-config.el')
0 files changed, 0 insertions, 0 deletions
