Amr Gharbeia
95d1ea3fed
- Add deepseek and nvidia entries to gateway-provider config - Add DEEPSEEK_API_KEY and NVIDIA_API_KEY to .env.example - Add deepseek and nvidia to doctor's LLM provider check - Fix remaining harness-log → log-message reference
39 lines
1.9 KiB
Org Mode
39 lines
1.9 KiB
Org Mode
#+TITLE: Kernel Bootstrap (setup.org)
|
|
#+AUTHOR: Amr
|
|
#+FILETAGS: :harness:kernel:bootstrap:
|
|
#+STARTUP: content
|
|
|
|
* Overview: Architectural Intent
|
|
|
|
The Kernel Bootstrap is the transition from a bare POSIX shell to a running Lisp environment. It's the only part of Passepartout that executes before the Lisp image is ready.
|
|
|
|
The bootstrap has exactly three jobs, nothing more:
|
|
1. **Directory Resolution**: Locating and creating XDG paths for config, data, and state
|
|
2. **System Tangle**: Transforming literate Org sources into runnable Lisp files
|
|
3. **Dependency Check**: Ensuring SBCL, Quicklisp, and Emacs are available
|
|
|
|
This minimal interface is deliberate. The bootstrap should NOT know about LLM providers, diagnostic suites, or gateway configuration. Those are the job of the Lisp-level setup wizard, which runs after the bootstrap is complete.
|
|
|
|
* Phase A: Demand (Thinking)
|
|
** The Minimalist Kernel
|
|
To maintain sovereignty, the harness must remain a "dumb" bus. It should not know about LLM providers or diagnostic suites. Its only responsibilities are:
|
|
1. **Directory Resolution**: Locating XDG paths.
|
|
2. **System Tangle**: Transforming literate Org sources into runnable Lisp.
|
|
3. **Dependency Check**: Ensuring SBCL and Quicklisp are available.
|
|
|
|
* Phase B: Protocol (Success Criteria)
|
|
** Bootstrap Verification
|
|
1. `test-xdg-dirs`: Verify that `setup_system` creates the Config/Data/State folders.
|
|
2. `test-asdf-registration`: Verify that the `INSTALL_DIR` is correctly pushed to the ASDF central registry.
|
|
|
|
* Phase C: Implementation (Build)
|
|
|
|
** The Installer Script (passepartout)
|
|
The shell script is the primary entry point. It handles the initial git clone, dependency installation, and literate tangle.
|
|
|
|
#+begin_src bash :tangle no
|
|
#!/bin/bash
|
|
# (The content here is a duplicate of the main passepartout for literate consistency)
|
|
# [Note: Implementation is already verified in the top-level script]
|
|
#+end_src
|