SwarmForge לעומק: איך נחיל הסוכנים של אנקל בוב עובד באמת

ה-six-pack שנשלח מציב כל תפקיד על אותו מנוע עם עקיפת הרשאות מופעלת, ומסמן את כל החצי האחורי של הטבעת כצרכני אצווה. שם התפקיד חייב להתאים לשם קובץ הפרומפט, שבמאגר הזה נכתב hardender.

# swarmforge/swarmforge.conf
# window-invisible <role> <agent> <worktree> [task|batch] [extra-cli-args...]
window-invisible specifier codex master           --yolo
window-invisible coder     codex coder            --yolo
window-invisible cleaner   codex cleaner    batch --yolo
window-invisible architect codex architect  batch --yolo
window-invisible hardender codex hardender  batch --yolo
window-invisible QA        codex QA         batch --yolo

אין מסד נתונים ואין ברוקר בזיכרון. מקומה של העברה בעץ הוא הסטטוס שלה, שם הקובץ ממיין לפי עדיפות ואז זמן, והכותרות נושאות את שביל הביקורת. נחיל שקרס ממשיך מהמקום שבו הוא היה בכך שהוא קורא את הדיסק.

.swarmforge/handoffs/
  outbox/
    tmp/            # drafts land here, then get renamed in atomically
  sent/
  failed/           # malformed or undeliverable, with diagnostics
  inbox/
    new/
    in_process/
    completed/

# filename sorts the queue for you
<priority>_<timestamp>_<sequence>_from_<sender>_to_<recipients>.handoff
# priority 00-99, lower first; UTC YYYYMMDDTHHMMSSZ

הסוכן כותב טיוטה עם ארבע כותרות וקורא לסקריפט השער. הוא לא יכול לכתוב id, from, recipient או חותמת זמן — אלה שמורות, כך שהמקוריות בשביל הביקורת לא ניתנת לזיוף בידי מי שנבדק. הוא גם לא מקליד SHA: הסקריפט מנרמל ומאמת שהקומיט הוא אובייקט אמיתי וחד-משמעי באורך עשרה תווים.

# ./tmp/handoff.txt — drafted inside the assigned worktree
type: git_handoff
to: hardender
priority: 00
task: task-1-cave-setup

# hand it to the protocol gate; the daemon does delivery
swarm_handoff.sh ./tmp/handoff.txt

# receiving side, driven by the role's mode in .swarmforge/roles.tsv
ready_for_next.sh     # -> TASK: / BATCH: / NO_TASK, plus the payload
done_with_current.sh  # -> stamps completed_at, then pulls the next item

זה מה שהופך את הנחיל למשהו יותר ממשחק תפקידים. החוקה מתקינה את הכלים האלה בעלייה, טרייים מהמאגרים של המחבר — crap4go, crap4java ו-crap4clj למורכבות, mutate4go, clj-mutate ו-mutate4java למוטציה, ומשפחת dry4* לכפילויות — ופרומפט התפקיד קובע את סדר ההרצה.

# hardener: nothing advances until the previous check is clean
mutate4go ./...            # one file at a time, differential, <= 8 workers
gherkin-mutator --level soft   # mutate the acceptance examples too
crap4go ./...              # complexity against coverage
dry4go ./...               # duplication

# then, and only then
swarm_handoff.sh ./tmp/handoff.txt   # to: QA