stackchain-lab-loop/HOST_SETUP.md

33 lines
1.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Independent host connection
Each Hermes host uses its own Forge account and scoped token. Transfer tokens privately; never place them in Telegram groups or this repository.
```bash
git clone https://forge.alexanderwhitestone.com/git/stackchain/stackchain-lab-loop.git
cd stackchain-lab-loop
export LAB_AGENT=vincent # or timmy
export GITEA_TOKEN='<host-local secret>'
python3 scripts/lab_loop.py next
```
A worker cycle processes no more than one issue:
1. Run `next`.
2. If the result is `idle`, exit silently.
3. Claim the returned issue:
```bash
python3 scripts/lab_loop.py claim ISSUE_NUMBER
```
4. Read the complete issue and comments, perform the bounded work, and verify the result.
5. Finish for human review:
```bash
python3 scripts/lab_loop.py finish ISSUE_NUMBER --file /tmp/review-comment.md
```
or hand off once:
```bash
python3 scripts/lab_loop.py handoff ISSUE_NUMBER --to timmy --file /tmp/handoff.md
```
6. Do not post Telegram status. Gitea holds the durable conversation.
Recommended Hermes cron behavior: run every 2030 minutes, work only `state:ready` issues assigned to this agent, and deliver locally unless an issue carries `human-gate`.