Rebuild org-roam DB independently from CMake
Table of Contents
Deferred from Sprint 18 on 2026-05-29 — not started; carried forward to product backlog. This page documents a story in Sprint 18. It captures the goal, current status, acceptance criteria, and the tasks that compose it.
Goal
The org-roam DB sync is currently embedded inside .build-site.el so
the only way to get a fresh .org-roam.db is to run a full site
build. This story extracts that logic into a standalone
.build-org-roam.el and wires it to a rebuild_org_roam_db cmake
target, giving contributors and the LLM a fast, lightweight way to
keep the DB current without triggering the whole publish pipeline.
Status
| Field | Value |
|---|---|
| State | BACKLOG |
| Parent sprint | Sprint 18 |
| Now | Not yet started. |
| Waiting on | Nothing. |
| Next | Implement .build-org-roam.el and cmake target. |
| Last touched | 2026-05-24 |
Acceptance
.build-org-roam.elexists at the repo root and syncs the org-roam DB in the same way as the current.build-site.elblock.CMakeLists.txtdefines arebuild_org_roam_dbtarget that runsemacs -Q --script .build-org-roam.el.deploy_siteno longer contains inline org-roam sync code; it calls or depends on the new target instead.- Running
cmake --build . --target rebuild_org_roam_dbfrom the build directory updates.org-roam.dbwithout regenerating the site.
Tasks
| Task | State | Start | End | Description |
|---|---|---|---|---|
| Task: Implement .build-org-roam.el and rebuild_org_roam_db cmake target | BACKLOG | 2026-05-24 | Extract org-roam DB sync from .build-site.el into a standalone .build-org-roam.el; add rebuild_org_roam_db cmake target; update deploy_site to depend on it. |
Decisions
Out of scope
- Live file watching or inotify-based auto-sync.
- Changing how
compass.sh indexupdates the compass FTS5 cache; that is a separate step after the org-roam DB is fresh.