alan/docs/gitea-import.md

Gitea-Import

Repo-Name

Empfohlen: alan-agents-workstation

Schnellweg

cd /pfad/zu/alan

git init
git branch -M main
git add .
git commit -m "Initial workstation stack for Hermes + OpenClaw coexistence"

git remote add origin ssh://git@<dein-gitea-host>/<dein-user>/alan-agents-workstation.git
git push -u origin main

Branching

Einfach und robust fuer Single-Workstation-Infra:

• main fuer den stabilen Stand
• feat/... fuer lokale Erweiterungen
• Tags fuer getestete Snapshots, z. B. v0.1.0

Was ins Repo gehoert

• Compose-Dateien
• Skripte
• Doku
• Beispiel-Env-Dateien
• systemd-User-Units

Was nicht ins Repo gehoert

• echte API-Keys
• echte Hermes-Daten aus state/hermes
• Backup-Archive
• lokale Debug-Logs

Empfohlene Zusatzdateien fuer Gitea

Dieses Repo bringt bereits mit:

• CHANGELOG.md
• CONTRIBUTING.md
• .gitea/ISSUE_TEMPLATE/*
• .gitea/pull_request_template.md
• .gitea/workflows/repo-check.yml
• docs/release-process.md
• docs/upgrade-policy.md

Damit bekommst du in Gitea:

• strukturierte Fehlermeldungen und Feature-Wuensche
• einheitliche PR-Checklisten
• einfache serverseitige Grundpruefungen fuer das Repo
• nachvollziehbare Releases mit Tagging und Upgrade-Hinweisen

Release-Empfehlung

Fuer jedes verteilte Repo-Update:

1. CHANGELOG.md pflegen
2. ./scripts/release-check ausfuehren
3. Release-Tag setzen, z. B. v0.1.1
4. in Gitea Release Notes mit Upgrade-Hinweisen anlegen

Beispiel fuer Release Notes

Neu:
- robusteres br0-Uplink-Handling
- verbesserter Rollback-Workflow

Wichtig fuer bestehende Installationen:
- `.env.example` geaendert: neuer Key XYZ
- vor Upgrade bitte `./scripts/alanctl backup` ausfuehren
- Rollback bleibt ueber `./scripts/alanctl rollback-hermes` moeglich