feat: add agent-os bootstrap bundle

2026-07-02 14:48:49 +00:00
parent d0a9a267fd
commit 5f9302abc5
20 changed files with 715 additions and 0 deletions
@@ -0,0 +1,32 @@
+# Agent OS Bootstrap
+
+This directory owns the source for the generic Agent OS bootstrap bundle.
+
+The Linux Server design docs are the source specification:
+
+- `/home/nxm/Documents/NxM Linux Server/Services/Agents.md` defines the Agent OS foundation, the `/opt/agent-os` runtime root, and the agent output contract.
+- `/home/nxm/Documents/NxM Linux Server/Operations/Git Workflow.md` defines the Gitea source-of-truth flow and says generated runtime state must stay out of commits.
+- `/home/nxm/Documents/NxM Linux Server/Current Work.md` records the clone synchronization baseline for Agent OS.
+
+## Files
+
+- `bundle-manifest.json` lists the canonical files and directories in the generic bundle.
+- `export-rules.json` defines which metadata is exported and which paths must verify.
+- `templates/generic/` holds the canonical bootstrap templates.
+- `generate-export.py` creates `bootstrap/exports/generic` from the manifest and rules.
+
+## Generate
+
+From a checked-out Agent OS clone:
+
+```bash
+python3 bootstrap/generate-export.py
+```
+
+To generate the live runtime export requested by the server workflow:
+
+```bash
+sudo -n python3 bootstrap/generate-export.py --output /opt/agent-os/bootstrap/exports/generic
+```
+
+Generated exports are intentionally ignored by Git.