pilot-ci-cd-pipeline-setup

# CI/CD Pipeline Setup Deploy 3 agents that build, test, and deploy code with zero central server. ## Roles | Role | Hostname | Skills | Purpose | |------|----------|--------|---------| | ci-builder | `<prefix>-ci-builder` | pilot-task-router, pilot-share, pilot-github-bridge | Builds code, shares artifacts | | ci-tester | `<prefix>-ci-tester` | pilot-task-router, pilot-share, pilot-audit-log | Runs tests, logs results | | ci-deployer | `<prefix>-ci-deployer` | pilot-task-router, pilot-share, pilot-webhook-bridge, pilot-receipt | Deploys, sends receipts | ## Setup Procedure **Step 1:** Ask the user which role this agent should play and what prefix to use. **Step 2:** Install the skills for the chosen role: ```bash # For ci-builder: clawhub install pilot-task-router pilot-share pilot-github-bridge # For ci-tester: clawhub install pilot-task-router pilot-share pilot-audit-log # For ci-deployer: clawhub install pilot-task-router pilot-share pilot-webhook-bridge pilot-receipt ``` **Step 3:** Set the hostname: ```bash pilotctl --json set-hostname <prefix>-<role> ``` **Step 4:** Write the setup manifest: ```bash mkdir -p ~/.pilot/setups ``` Then write the role-specific JSON manifest to `~/.pilot/setups/ci-cd-pipeline.json`. **Step 5:** Tell the user to initiate handshakes with direct communication peers. ## Manifest Templates Per Role ### ci-builder ```json { "setup": "ci-cd-pipeline", "setup_name": "CI/CD Pipeline", "role": "ci-builder", "role_name": "Build Agent", "hostname": "<prefix>-ci-builder", "description": "Listens for GitHub push/PR webhooks, clones the repo, runs builds, and shares artifacts with the test agent.", "skills": { "pilot-task-router": "Accept build requests and route artifacts to ci-tester.", "pilot-share": "Send build artifacts (tarballs, binaries) to ci-tester.", "pilot-github-bridge": "Listen for GitHub webhooks (push, PR) to trigger builds." }, "peers": [ { "role": "ci-tester", "hostname": "<prefix>-ci-tester", "description": "Receives build artifacts for testing" }, { "role": "ci-deployer", "hostname": "<prefix>-ci-deployer", "description": "Receives deployment receipt" } ], "data_flows": [ { "direction": "send", "peer": "<prefix>-ci-tester", "port": 1001, "topic": "build-ready", "description": "Build artifacts and test instructions" }, { "direction": "receive", "peer": "<prefix>-ci-deployer", "port": 1002, "topic": "deploy-receipt", "description": "Deployment confirmation" } ], "handshakes_needed": ["<prefix>-ci-tester", "<prefix>-ci-deployer"] } ``` ### ci-tester ```json { "setup": "ci-cd-pipeline", "setup_name": "CI/CD Pipeline", "role": "ci-tester", "role_name": "Test Agent", "hostname": "<prefix>-ci-tester", "description": "Receives build artifacts, runs test suites, and logs results. Passes successful builds to the deployer.", "skills": { "pilot-task-router": "Accept test tasks from ci-builder and forward passing builds to ci-deployer.", "pilot-share": "Receive artifacts from ci-builder, send tested artifacts to ci-deployer.", "pilot-audit-log": "Log all test runs with pass/fail results and coverage." }, "peers": [ { "role": "ci-builder", "hostname": "<prefix>-ci-builder", "description": "Sends build artifacts" }, { "role": "ci-deployer", "hostname": "<prefix>-ci-deployer", "description": "Receives tested artifacts" } ], "data_flows": [ { "direction": "receive", "peer": "<prefix>-ci-builder", "port": 1001, "topic": "build-ready", "description": "Build artifacts" }, { "direction": "send", "peer": "<prefix>-ci-deployer", "port": 1001, "topic": "tests-passed", "description": "Tested artifacts with report" } ], "handshakes_needed": ["<prefix>-ci-builder", "<prefix>-ci-deployer"] } ``` ### ci-deployer ```json { "setup": "ci-cd-pipeline", "setup_name": "CI/CD Pipeline", "role": "ci-deployer", "role_name": "Deploy Agent", "hostname": "<prefix>-ci-deployer", "description": "Receives tested artifacts, deploys to production, sends deployment receipts, and triggers post-deploy webhooks.", "skills": { "pilot-task-router": "Accept deploy tasks from ci-tester.", "pilot-share": "Receive tested artifacts from ci-tester.", "pilot-webhook-bridge": "Trigger post-deploy webhooks (Slack, monitoring).", "pilot-receipt": "Send deployment receipts back to ci-builder." }, "peers": [ { "role": "ci-builder", "hostname": "<prefix>-ci-builder", "description": "Receives deployment receipt" }, { "role": "ci-tester", "hostname": "<prefix>-ci-tester", "description": "Sends tested artifacts" } ], "data_flows": [ { "direction": "receive", "peer": "<prefix>-ci-tester", "port": 1001, "topic": "tests-passed", "description": "Tested artifacts" }, { "direction": "send", "peer": "<prefix>-ci-builder", "port": 1002, "topic": "deploy-receipt", "description": "Deployment confirmation" } ], "handshakes_needed": ["<prefix>-ci-builder", "<prefix>-ci-tester"] } ``` ## Data Flows - `ci-builder → ci-tester` : build artifacts (port 1001) - `ci-tester → ci-deployer` : tested artifacts with test report (port 1001) - `ci-deployer → ci-builder` : deployment receipt (port 1002) ## Handshakes ```bash # All three agents handshake each other: pilotctl --json handshake <prefix>-ci-tester "setup: ci-cd-pipeline" pilotctl --json handshake <prefix>-ci-deployer "setup: ci-cd-pipeline" pilotctl --json handshake <prefix>-ci-builder "setup: ci-cd-pipeline" ``` ## Workflow Example ```bash # On ci-builder — send build artifact: pilotctl --json send-file <prefix>-ci-tester ./build/app-v2.3.tar.gz pilotctl --json publish <prefix>-ci-tester build-ready '{"commit":"a1b2c3d","branch":"main"}' # On ci-tester — forward to deployer: pilotctl --json send-file <prefix>-ci-deployer ./build/app-v2.3.tar.gz pilotctl --json publish <prefix>-ci-deployer tests-passed '{"commit":"a1b2c3d","tests":142,"passed":142}' # On ci-deployer — send receipt: pilotctl --json publish <prefix>-ci-builder deploy-receipt '{"commit":"a1b2c3d","status":"success"}' ``` ## Dependencies Requires `pilot-protocol` skill, `pilotctl` binary, `clawhub` binary, and a running daemon.