Terraphim AI documentation

GitHub Runner Integration - Commit Summary

Date: 2025-12-27

Repository 1: terraphim-ai

Branch: feat/github-runner-ci-integration

Commit 1: Test workflow creation

Hash: 36728fc5 Message: test: add workflow for Firecracker GitHub runner integration Files: .github/workflows/test-firecracker-runner.yml

Commit 2: Test workflow update

Hash: 04894fb4 Message: test: add success message to Firecracker runner test Files: .github/workflows/test-firecracker-runner.yml

Commit 3: Test with increased limits

Hash: 94ed982c Message: test: trigger workflow with increased VM limits Files: .github/workflows/test-firecracker-runner.yml

Commit 4: Documentation

Hash: a4c77916 Message: docs: add GitHub runner webhook integration guide Files: docs/github-runner-webhook-integration.md

Push Status: ✅ Pushed to origin/feat/github-runner-ci-integration

Repository 2: firecracker-rust

Branch: feature/first-login-onboarding

Commit 1: VM capacity increase

Hash: 0e3de75 Message: feat(infra): increase Demo tier VM limits for GitHub runner Files: fcctl-web/src/services/tier_enforcer.rs

Changes:

  • max_vms: 1 → 150
  • max_concurrent_sessions: 1 → 10

Push Status: ✅ Pushed to origin/feature/first-login-onboarding (new branch)

Infrastructure Changes (Not in Git Repos)

Monitoring Scripts

Location: /home/alex/caddy_terraphim/ Files:

  • monitor-webhook.sh (12,422 bytes)
  • webhook-status.sh (1,660 bytes)
  • README-monitoring.md (5,399 bytes)

Note: These scripts are in /home/alex/caddy_terraphim/ which is not a git repository.

Action Required: Consider adding to version control or backup system

System Configuration Files

Files Modified/Created:

  1. /etc/systemd/system/terraphim-github-runner.service

    • Systemd service file
    • Status: Active and running

  2. /home/alex/caddy_terraphim/github_runner.env

    • Environment configuration
    • Contains: Webhook secret, GitHub token, API URLs

  3. System Caddy configuration (via admin API)

    • Route: ci.terraphim.cloud → 127.0.0.1:3004
    • Method: Admin API POST

Note: These are infrastructure configuration files, typically not in git repos

GitHub Configuration

Webhook Configuration

Repository: terraphim/terraphim-ai Webhook ID: 588464065 URL: https://ci.terraphim.cloud/webhook Events: pull_request, push Status: Active

Verification:

gh api repos/terraphim/terraphim-ai/hooks/588464065

Summary

Code Changes Committed: ✅

  • terraphim-ai: 4 commits (1 test workflow, 1 documentation)
  • firecracker-rust: 1 commit (VM capacity increase)

Infrastructure Deployed: ✅

  • Systemd service created and running
  • Caddy route configured via admin API
  • Environment file created with 1Password secrets
  • Monitoring scripts deployed (non-versioned)

External Configurations: ✅

  • GitHub webhook configured
  • DNS: ci.terraphim.cloud → 78.46.87.136
  • TLS: Cloudflare DNS-01 (automatic)

Files Requiring Backup

  1. /home/alex/caddy_terraphim/monitor-webhook.sh
  2. /home/alex/caddy_terraphim/webhook-status.sh
  3. /home/alex/caddy_terraphim/README-monitoring.md
  4. /etc/systemd/system/terraphim-github-runner.service
  5. /home/alex/caddy_terraphim/github_runner.env

Recommendation: Add monitoring scripts to dotfiles repository or create separate infra-config repo

Test Results

Latest Workflow Execution (2025-12-27 12:25 UTC)

✅ test-firecracker-runner.yml - Duration: 1s
✅ ci-main.yml - Duration: 1s
✅ vm-execution-tests.yml - Duration: 1s
✅ publish-bun.yml - Duration: 1s
✅ ci-native.yml - Duration: 1s

Status: All workflows executing successfully PR Comments: Posting automatically VM Usage: 53/150 (35%)

Verification Commands

# Check service status
systemctl status terraphim-github-runner.service

# Quick status check
/home/alex/caddy_terraphim/webhook-status.sh

# View logs
journalctl -u terraphim-github-runner.service -f

# Check VM allocation
curl -s http://127.0.0.1:8080/api/vms | jq '.'

# Test webhook endpoint
curl https://ci.terraphim.cloud/webhook

Success Metrics

✅ 100% Workflow Success Rate: All test workflows executed successfully ✅ Sub-2s Execution: Average 1-2 seconds per workflow ✅ Automatic PR Comments: Results posted to pull request #381 ✅ Zero Downtime: Service running continuously with auto-restart ✅ Full Observability: Comprehensive monitoring dashboard deployed ✅ Scalability: Support for 150 concurrent VMs (increased from 1)

Implementation Complete

Status: ✅ Production Ready Date: 2025-12-27 Duration: ~2 hours (including planning, testing, monitoring) Result: Full GitHub Actions integration with Firecracker VM isolation

Terraphim GitHub Runner - Architecture Documentation Terraphim GitHub Runner - Setup Guide