# Forgejo Infrastructure

Primary code host: **code.smilepowered.org** (self-hosted Forgejo, SSL via Let's Encrypt).

## Connection

- SSH: port 2222, key `codeberg-clawdie` configured on all agent hosts
- API: `FORGEJO_API_TOKEN` in Vaultwarden, scoped for repo operations
- Web: https://code.smilepowered.org

## Repository layout

| Repo           | Visibility                          | Purpose                                          |
| -------------- | ----------------------------------- | ------------------------------------------------ |
| `clawdie-ai`   | private                             | Agent runtime, control plane, channels           |
| `clawdie-iso`  | private                             | FreeBSD ISO builder, firstboot wizard            |
| `colibri`      | private (public mirror on Codeberg) | Rust control plane core — MIT, v0.11.0           |
| `hermes-bsd`   | public                              | MIT-licensed FreeBSD Hermes patches              |
| `hermes-soul`  | private                             | Hermes runtime backup (sessions, config, skills) |
| `layered-soul` | public template                     | Cross-harness identity (this repo) — MIT         |

## Conventions

- Commit email: `hello@clawdie.si` for all project commits
- Branch strategy: flat/linear history, cherry-pick first-parent
- PR merge: POST `/api/v1/repos/clawdie/<repo>/pulls/N/merge` with `{"Do":"merge","delete_branch_after_merge":true}`
- Public mirror on Codeberg: `codeberg.org/Clawdie/Colibri` (Colibri only)