ores.lisp

ores.lisp is the Emacs Lisp tooling layer for ORE Studio development. It provides a per-checkout interactive console (ores-dashboard), database management UI (ores-db), shell integration (ores-shell), environment loading (ores-env), org-roam export pipeline (ores-org-roam-export), and process supervision via Prodigy (ores-prodigy). None of these modules are part of the production system; they exist solely to improve developer ergonomics.

• .env — checkout-specific environment variables (label, preset, passwords, per-service DB credentials).
• sql-connection-alist — populated at session start via ores-db/setup-connections.
• build/scripts/ — shell scripts invoked for init, build, site, NATS, and DB operations.

• ORES Dashboard Emacs buffer — interactive card-based console with keyboard shortcuts for every action.
• *ores-<label>-db-<svc>* SQL interaction buffers.
• *ores-<label>-shell* ores.shell REPL buffer.
• Compilation buffers for build, site, services, and DB scripts.
• Org-roam HTML export artefacts (via ores-org-roam-export).

• M-x ores/dashboard — primary developer console; opens the ORES Dashboard card layout.
• M-x ores-db/list-databases — tabulated database browser; list, connect, kill, teardown, and recreate.
• M-x ores-shell — launch (or switch to) an ores.shell REPL comint buffer.
• M-x ores/capture — capture a product-backlog note via compass.sh capture --note (CLI-driven; for interactive Org Capture use yasnippet trigger cap in an .org buffer).

• ores-env.el — parses the checkout .env file into an alist and exposes ores/load-dotenv and ores/checkout-root. Foundation module; required by all others.
• ores-dashboard.el — per-checkout interactive development console. Renders a card-based layout (Environment, Database, Services, Compass, Build, Site, Skills, Bookmarks, Links, Shell, NATS) with global keyboard shortcuts (a=–=z, A=–=Z). Entry point: M-x ores/dashboard.
• ores-db.el — tabulated database browser and SQL connection manager. Discovers all ores_* databases on localhost, supports connect, kill connections, teardown, and recreate operations. Entry point: M-x ores-db/list-databases.
• ores-shell.el — launches an ores.shell REPL as a comint buffer, pointed at the preset's published binary. Entry point: M-x ores-shell.
• ores-shell-mode.el — trivial major mode for the ores.shell REPL buffer. Provides font-lock highlighting for shell commands (connect, login, accounts, create, exit) so they stand out from arguments.
• ores-babel.el — configures Org Babel #+begin_src sh blocks in recipe files to run with default-directory set to the repo root, so paths like ./projects/ores.compass/compass.sh resolve consistently regardless of where the .org file lives.
• ores-prodigy.el — registers all ORE Studio background services (databases, NATS, HTTP server, domain services) with Prodigy for point-and-click process lifecycle management.
• ores-capture.el — product-backlog capture integration. Provides ores/setup-capture-templates (registers key "c" in org-capture-templates; creates a timestamped file in inbox/ and expands the capture yasnippet for interactive filling via TAB) and ores/capture (interactive command that delegates to compass.sh capture --note; for LLM-driven and CLI-style use). The yasnippet at snippets/org-mode/capture (trigger "cap") is the single template source shared by both entry points.
• ores-org-roam-export.el — org-roam → HTML export pipeline; walks the node graph and publishes the documentation site.

• sql-mode (Emacs built-in) — interactive SQL buffers.
• nerd-icons — icon glyphs in the dashboard.
• org-roam — node graph for export pipeline.
• prodigy — service process management.
• compilation-mode (Emacs built-in) — script output buffers.

The ORES Dashboard buffer is divided into cards. Each card groups related actions under a short heading and maps them to single-keystroke bindings.

• ORE Studio Site — how the site is built, the menu bar definition, the 404 page, and the org-roam graph injection.
• ORE Studio Manual — how the PDF user manual is built via ox-latex, Tufte layout, margin figures, and version stamping.
• Emacs — editor overview and the build targets (deploy_site, deploy_manual, etc.) that ores.lisp scripts drive.
• org-roam — the knowledge graph layer that ores-org-roam-export.el exports.
• System Model — architectural context.
• ores.shell — the REPL that the dashboard launches.
• ores.sql — database scripts invoked by the dashboard.