# 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.