Files

Sam Rolfe 441d859afe Phase 1: file one Paperclip job from a script

Add scripts/paperclip-roundtrip.sh. It files one Paperclip issue and prints
the returned id and identifier. The key comes from the environment, then from
environment.d. The script never prints the key.

Fix the runbook: the create route is POST /api/companies/{companyId}/issues.
The old POST /api/issues route returns 404.

Record the first filed job: AUD-55 (d58891ce-9934-4710-9bba-d37974251ed9).

Co-Authored-By: Paperclip <noreply@paperclip.ing>

2026-10-10 17:21:03 +11:00

2.3 KiB

Raw Blame History

Central AI Hub — AI Agent Runbook

Writing Style: ASD-STE100 Simplified Technical English (ste-writing).

Phase 1 — Prove the Paperclip Round Trip

This phase has no Hub code. It proves the missing link: a job that leaves and a result that returns.

Steps

Create a Paperclip agent API key for this project. DONE.
- Paperclip board: http://192.168.20.13:3100.
- Agent: Hub, id 108c6220-c9e1-4b62-9e0a-6a763e0d28fd.
- Key name: hub-service.
- The key is stored in /home/sam/.config/environment.d/10-secrets.conf as PAPERCLIP_API_KEY. Never commit it.
- Verification: GET /api/agents/me with the key returns 200 and the name Hub.
- Note: POST /api/agents/{id}/keys is board-only. A run JWT gets 403 Board access required. Mint keys with the local board key.
File one job with the round-trip script. The script uses the issue-create endpoint: POST /api/companies/{companyId}/issues.
- The old POST /api/issues route does not exist. It returns 404.
- Company id: d4921013-e5da-4d88-8016-57d5746e2d03.
- Script: scripts/paperclip-roundtrip.sh.
Confirm the job appears in the Paperclip board.
Wait for the agent to close the job.
Send the result to Jervis POST /announce so the house speaks it.
Record the result in this file.

Commands

# File one job with the script. It reads PAPERCLIP_API_KEY from the
# environment, then from ~/.config/environment.d/10-secrets.conf.
scripts/paperclip-roundtrip.sh \
  --title "Hub round-trip job: confirm the return path" \
  --description "Prove the outbound Paperclip path." \
  --assignee 403de1f7-645c-4d35-bc7e-19b01d77bacc \
  --priority high \
  --project 7ae791bb-8d9a-462f-99bf-013421d20623

# Speak the result.
curl -s -X POST http://192.168.20.13:8501/announce \
  -H "Content-Type: application/json" \
  -d '{"text":"Round trip works."}'

Definition of Done

The job appears in Paperclip.
The job closes.
The house speaks the result.
This file records the result.

After Phase 1

Follow the build order in AGENTS.md. Do not start a destination before the round trip works.

Health Checks

curl -s http://192.168.20.13:3100/health        # Paperclip
curl -s http://192.168.20.13:8501/health        # Jervis
curl -s -o /dev/null -w '%{http_code}\n' http://192.168.20.30:8123/   # HA

2.3 KiB Raw Blame History