stackchain-lab-loop/HOST_SETUP.md

1.2 KiB
Raw Permalink Blame History

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.

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:
    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:
    python3 scripts/lab_loop.py finish ISSUE_NUMBER --file /tmp/review-comment.md
    
    or hand off once:
    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.