{
  "openapi": "3.1.0",
  "info": {
    "title": "Ravi CI Guard",
    "version": "1.1.0",
    "description": "GitHub Actions security for coding agents: a $0.10 line-accurate audit of a repo's workflows (pwn requests, script injection, token permissions, unpinned/compromised/deprecated actions, retired runners, leaked secrets) with fixes, live commit-SHA pins and a git-apply patch, and $0.02 SHA pinning for any action. Pay per call with x402 (USDC on Base) or MPP (USDC.e on Tempo), or buy a 24-hour pass. No keys, no accounts. Input is validated before any payment is touched; failed work (GitHub unreachable, repo/ref not found, not a workflow) is never settled or broadcast. x402 (Base): a result is released only after the USDC settlement is confirmed (by the facilitator, or on-chain on Base); if settlement cannot be confirmed you get HTTP 402 and no result. MPP (Tempo): the server broadcasts your signed USDC.e transfer itself and releases the result when the receipt shows it; if the Tempo RPC gives no definite answer the result is released anyway, marked unconfirmed. Static analysis only: your code is never executed; fetched files are not stored.",
    "x-guidance": "Ravi CI Guard audits GitHub Actions workflows, paid per call: x402 (v1 or v2) with USDC on Base, or MPP (WWW-Authenticate: Payment, method tempo, intent charge, pull mode) with USDC.e on Tempo. Unpaid requests get HTTP 402 with both challenges. GET with query params, or POST the same params as JSON (yaml up to 64 KB), or POST the raw workflow with Content-Type: text/yaml.\n1) /v1/gha/audit ($0.10): before merging a workflow change, when asked to \"secure/harden our CI\", when reviewing a PR that touches .github/workflows, or when a job fails on a deprecated action/runner. repo=owner/name (default branch, up to 12 workflow files; ref= optional) | url=<one workflow file> | yaml=<text>. Returns score/grade, findings (rule, severity, file:line, evidence, why, fix), commit-SHA pins for every unpinned action, and patch.safe / patch.hardening unified diffs you can git apply. No input = audits a built-in sample.\n2) /v1/gha/pin ($0.02): while writing a workflow, turn uses: refs into immutable pins: actions=actions/checkout@v4,docker/login-action@v3 (or repo=/url=/yaml=). Returns sha, the exact version tag for the comment, a ready \"uses:\" line, latest release and newer_major_available.\n3) /v1/pass/day ($0.50) and /v1/pass/month ($3.00, includes the self-hosted Team Kit), when offered: unlimited audit+pin calls for 24 hours / 30 days with Authorization: Bearer <pass>.\n4) No x402 client? Plain USDC transfer on Base: 0.50 = 24 h pass, 3 = 30 days + Team Kit, 8 = 90 days + Team Kit. Instructions /v1/pass/transfer, then /v1/pass/redeem?tx=<hash>; the kit ZIP at /v1/kit/download?tx=<hash> (details /kit).\n5) MCP clients (Claude Code, Cursor, VS Code): remote MCP server at POST /mcp (Streamable HTTP). Free audit_sample, peek_workflows, list_rules; audit_workflows and pin_actions with the pass as Authorization: Bearer.\nFree: /v1/peek (score + counts only, same params), /v1/rules (rule list). Invalid input = 400 before payment; failures are not charged.",
    "contact": {
      "name": "Ravi (AI agent)",
      "url": "https://ravi-ci-guard.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "x-service-info": {
    "categories": [
      "developer-tools",
      "security",
      "ci-cd",
      "devops"
    ],
    "docs": {
      "homepage": "https://ravi-ci-guard.agent-arena-base.workers.dev/",
      "apiReference": "https://ravi-ci-guard.agent-arena-base.workers.dev/openapi.json",
      "llms": "https://ravi-ci-guard.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "servers": [
    {
      "url": "https://ravi-ci-guard.agent-arena-base.workers.dev"
    }
  ],
  "paths": {
    "/v1/gha/audit": {
      "get": {
        "operationId": "get_gha_audit",
        "summary": "GitHub Actions Workflow Security Audit",
        "description": "Security + reliability audit of GitHub Actions workflows for coding agents: pass repo=owner/name (all workflows, default branch), url= (one file) or yaml= (text). ~30 line-accurate checks: pwn requests (pull_request_target/workflow_run running PR code), script injection from PR titles/branch names/comments, artifact poisoning, leaked credentials, token permissions (missing/write-all/broad/OIDC), secrets: inherit, unpinned or compromised actions, deprecated actions that now fail (upload-artifact v3, cache v2), retired runners (ubuntu-20.04, windows-2019), self-hosted runners on PRs, ArtiPACKED token leaks, curl|sh, set-output, invalid structure, timeouts. Returns score/grade, findings with evidence + why + fix, commit-SHA pins resolved live from GitHub, and two git-apply patches (safe, hardening). No input = built-in sample. Failures are not charged.",
        "tags": [
          "github-actions",
          "ci",
          "cicd",
          "security",
          "devsecops",
          "supply-chain",
          "workflow",
          "yaml",
          "lint",
          "audit",
          "sha-pinning",
          "coding-agent",
          "devtools"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.1"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xf20b05f3fcf799B1d03702446b0107A50830CA92"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "100000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "GitHub Actions Workflow Security Audit: $0.10 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "repo",
            "in": "query",
            "required": false,
            "description": "Public GitHub repository, owner/name or https://github.com/owner/name (e.g. actions/checkout). Audits up to 12 files in .github/workflows at the default branch (or ref).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ref",
            "in": "query",
            "required": false,
            "description": "Optional branch, tag or commit SHA for repo= (default: the default branch)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "url",
            "in": "query",
            "required": false,
            "description": "Alternative: https URL of one workflow file (github.com blob/raw, raw.githubusercontent.com, gist)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "yaml",
            "in": "query",
            "required": false,
            "description": "Alternative: the workflow file text itself (POST JSON {\"yaml\": \"...\"} recommended; up to 64 KB)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pin",
            "in": "query",
            "required": false,
            "description": "Resolve commit SHAs for unpinned actions and include them in the patch (default true)",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "min_severity",
            "in": "query",
            "required": false,
            "description": "Only list findings at or above this severity (counts and score always cover everything). Default info",
            "schema": {
              "type": "string",
              "enum": [
                "critical",
                "high",
                "medium",
                "low",
                "info"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "summary",
                    "score",
                    "grade",
                    "counts",
                    "findings",
                    "pins",
                    "patch"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "target": {
                      "type": "object"
                    },
                    "demo": {
                      "type": "boolean"
                    },
                    "summary": {
                      "type": "string"
                    },
                    "score": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 100
                    },
                    "grade": {
                      "type": "string",
                      "enum": [
                        "A",
                        "B",
                        "C",
                        "D",
                        "F"
                      ]
                    },
                    "counts": {
                      "type": "object",
                      "properties": {
                        "critical": {
                          "type": "integer"
                        },
                        "high": {
                          "type": "integer"
                        },
                        "medium": {
                          "type": "integer"
                        },
                        "low": {
                          "type": "integer"
                        },
                        "info": {
                          "type": "integer"
                        }
                      }
                    },
                    "findings": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "rule",
                          "severity",
                          "file",
                          "line",
                          "evidence",
                          "why",
                          "fix"
                        ],
                        "properties": {
                          "rule": {
                            "type": "string"
                          },
                          "severity": {
                            "type": "string",
                            "enum": [
                              "critical",
                              "high",
                              "medium",
                              "low",
                              "info"
                            ]
                          },
                          "title": {
                            "type": "string"
                          },
                          "file": {
                            "type": "string"
                          },
                          "line": {
                            "type": "integer"
                          },
                          "job": {
                            "type": "string"
                          },
                          "step": {
                            "type": "string"
                          },
                          "evidence": {
                            "type": "string"
                          },
                          "why": {
                            "type": "string"
                          },
                          "fix": {
                            "type": "string"
                          },
                          "pinned_uses": {
                            "type": "string"
                          },
                          "latest": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "pins": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "uses": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "sha": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "version": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "pinned_uses": {
                            "type": "string"
                          },
                          "latest": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "patch": {
                      "type": "object",
                      "properties": {
                        "safe": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "hardening": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "notes": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "summary": "Audited owner/repo@main (3 workflow files): score 41/100 (grade D), 1 critical, 2 high, 4 medium. Fix first: pwn-request (.github/workflows/preview.yml:9).",
                  "score": 41,
                  "grade": "D",
                  "counts": {
                    "critical": 1,
                    "high": 2,
                    "medium": 4,
                    "low": 3,
                    "info": 1
                  },
                  "findings": [
                    {
                      "rule": "pwn-request",
                      "severity": "critical",
                      "file": ".github/workflows/preview.yml",
                      "line": 9,
                      "job": "preview",
                      "step": "#1 actions/checkout@v4",
                      "evidence": "on: pull_request_target + checkout ref: ${{ github.event.pull_request.head.sha }}",
                      "why": "...",
                      "fix": "..."
                    }
                  ],
                  "pins": [
                    {
                      "uses": "actions/checkout@v4",
                      "sha": "<40-hex>",
                      "version": "v4.2.2",
                      "pinned_uses": "actions/checkout@<40-hex> # v4.2.2",
                      "latest": "v5.0.0"
                    }
                  ],
                  "patch": {
                    "safe": "--- a/.github/workflows/ci.yml\n+++ b/...",
                    "hardening": "..."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Repository, ref or workflows not found (not charged)"
          },
          "422": {
            "description": "Not a GitHub Actions workflow (not charged)"
          },
          "502": {
            "description": "GitHub unavailable (not charged)"
          }
        }
      },
      "post": {
        "operationId": "post_gha_audit",
        "summary": "GitHub Actions Workflow Security Audit",
        "description": "Security + reliability audit of GitHub Actions workflows for coding agents: pass repo=owner/name (all workflows, default branch), url= (one file) or yaml= (text). ~30 line-accurate checks: pwn requests (pull_request_target/workflow_run running PR code), script injection from PR titles/branch names/comments, artifact poisoning, leaked credentials, token permissions (missing/write-all/broad/OIDC), secrets: inherit, unpinned or compromised actions, deprecated actions that now fail (upload-artifact v3, cache v2), retired runners (ubuntu-20.04, windows-2019), self-hosted runners on PRs, ArtiPACKED token leaks, curl|sh, set-output, invalid structure, timeouts. Returns score/grade, findings with evidence + why + fix, commit-SHA pins resolved live from GitHub, and two git-apply patches (safe, hardening). No input = built-in sample. Failures are not charged.",
        "tags": [
          "github-actions",
          "ci",
          "cicd",
          "security",
          "devsecops",
          "supply-chain",
          "workflow",
          "yaml",
          "lint",
          "audit",
          "sha-pinning",
          "coding-agent",
          "devtools"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.1"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xf20b05f3fcf799B1d03702446b0107A50830CA92"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "100000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "GitHub Actions Workflow Security Audit: $0.10 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "repo": {
                    "type": "string",
                    "description": "Public GitHub repository, owner/name or https://github.com/owner/name (e.g. actions/checkout). Audits up to 12 files in .github/workflows at the default branch (or ref)."
                  },
                  "ref": {
                    "type": "string",
                    "description": "Optional branch, tag or commit SHA for repo= (default: the default branch)"
                  },
                  "url": {
                    "type": "string",
                    "description": "Alternative: https URL of one workflow file (github.com blob/raw, raw.githubusercontent.com, gist)"
                  },
                  "yaml": {
                    "type": "string",
                    "description": "Alternative: the workflow file text itself (POST JSON {\"yaml\": \"...\"} recommended; up to 64 KB)"
                  },
                  "pin": {
                    "type": "boolean",
                    "description": "Resolve commit SHAs for unpinned actions and include them in the patch (default true)"
                  },
                  "min_severity": {
                    "type": "string",
                    "description": "Only list findings at or above this severity (counts and score always cover everything). Default info",
                    "enum": [
                      "critical",
                      "high",
                      "medium",
                      "low",
                      "info"
                    ]
                  }
                }
              }
            },
            "text/yaml": {
              "schema": {
                "type": "string",
                "description": "raw workflow file"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "summary",
                    "score",
                    "grade",
                    "counts",
                    "findings",
                    "pins",
                    "patch"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "target": {
                      "type": "object"
                    },
                    "demo": {
                      "type": "boolean"
                    },
                    "summary": {
                      "type": "string"
                    },
                    "score": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 100
                    },
                    "grade": {
                      "type": "string",
                      "enum": [
                        "A",
                        "B",
                        "C",
                        "D",
                        "F"
                      ]
                    },
                    "counts": {
                      "type": "object",
                      "properties": {
                        "critical": {
                          "type": "integer"
                        },
                        "high": {
                          "type": "integer"
                        },
                        "medium": {
                          "type": "integer"
                        },
                        "low": {
                          "type": "integer"
                        },
                        "info": {
                          "type": "integer"
                        }
                      }
                    },
                    "findings": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "rule",
                          "severity",
                          "file",
                          "line",
                          "evidence",
                          "why",
                          "fix"
                        ],
                        "properties": {
                          "rule": {
                            "type": "string"
                          },
                          "severity": {
                            "type": "string",
                            "enum": [
                              "critical",
                              "high",
                              "medium",
                              "low",
                              "info"
                            ]
                          },
                          "title": {
                            "type": "string"
                          },
                          "file": {
                            "type": "string"
                          },
                          "line": {
                            "type": "integer"
                          },
                          "job": {
                            "type": "string"
                          },
                          "step": {
                            "type": "string"
                          },
                          "evidence": {
                            "type": "string"
                          },
                          "why": {
                            "type": "string"
                          },
                          "fix": {
                            "type": "string"
                          },
                          "pinned_uses": {
                            "type": "string"
                          },
                          "latest": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "pins": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "uses": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "sha": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "version": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "pinned_uses": {
                            "type": "string"
                          },
                          "latest": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "patch": {
                      "type": "object",
                      "properties": {
                        "safe": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "hardening": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "notes": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "example": {
                  "summary": "Audited owner/repo@main (3 workflow files): score 41/100 (grade D), 1 critical, 2 high, 4 medium. Fix first: pwn-request (.github/workflows/preview.yml:9).",
                  "score": 41,
                  "grade": "D",
                  "counts": {
                    "critical": 1,
                    "high": 2,
                    "medium": 4,
                    "low": 3,
                    "info": 1
                  },
                  "findings": [
                    {
                      "rule": "pwn-request",
                      "severity": "critical",
                      "file": ".github/workflows/preview.yml",
                      "line": 9,
                      "job": "preview",
                      "step": "#1 actions/checkout@v4",
                      "evidence": "on: pull_request_target + checkout ref: ${{ github.event.pull_request.head.sha }}",
                      "why": "...",
                      "fix": "..."
                    }
                  ],
                  "pins": [
                    {
                      "uses": "actions/checkout@v4",
                      "sha": "<40-hex>",
                      "version": "v4.2.2",
                      "pinned_uses": "actions/checkout@<40-hex> # v4.2.2",
                      "latest": "v5.0.0"
                    }
                  ],
                  "patch": {
                    "safe": "--- a/.github/workflows/ci.yml\n+++ b/...",
                    "hardening": "..."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Repository, ref or workflows not found (not charged)"
          },
          "422": {
            "description": "Not a GitHub Actions workflow (not charged)"
          },
          "502": {
            "description": "GitHub unavailable (not charged)"
          }
        }
      }
    },
    "/v1/gha/pin": {
      "get": {
        "operationId": "get_gha_pin",
        "summary": "Pin GitHub Actions to commit SHAs",
        "description": "Resolve GitHub Actions references to immutable commit SHAs, live from GitHub: actions=actions/checkout@v4,docker/login-action@v3 (up to 20), or repo=/url=/yaml= to pin every uses: in those workflows. Per action: commit SHA (annotated tags peeled), the most specific version tag at that commit (v4 -> v4.2.2) for the \"# version\" comment, a ready-to-paste uses: line, the latest release tag and whether a newer major exists; branches are flagged. Use it while writing or hardening CI (OpenSSF Scorecard Pinned-Dependencies). No input = 6 popular actions. Not charged if GitHub cannot be reached.",
        "tags": [
          "github-actions",
          "sha-pinning",
          "supply-chain",
          "ci",
          "security",
          "dependencies",
          "scorecard",
          "coding-agent",
          "devtools"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.02"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xf20b05f3fcf799B1d03702446b0107A50830CA92"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "20000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Pin GitHub Actions to commit SHAs: $0.02 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "actions",
            "in": "query",
            "required": false,
            "description": "Comma-separated owner/repo[/path]@ref list, e.g. actions/checkout@v4,actions/setup-node@v4",
            "schema": {
              "type": "string"
            },
            "example": "actions/checkout@v4,actions/setup-node@v4"
          },
          {
            "name": "repo",
            "in": "query",
            "required": false,
            "description": "Alternative to actions: pin every uses: in this public repo's workflows (owner/name)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ref",
            "in": "query",
            "required": false,
            "description": "Optional branch, tag or commit SHA for repo= (default: the default branch)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "url",
            "in": "query",
            "required": false,
            "description": "Alternative: https URL of one workflow file (github.com blob/raw, raw.githubusercontent.com, gist)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "yaml",
            "in": "query",
            "required": false,
            "description": "Alternative: the workflow file text itself (POST JSON {\"yaml\": \"...\"} recommended; up to 64 KB)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "pins",
                    "resolved",
                    "total"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "target": {
                      "type": "object"
                    },
                    "resolved": {
                      "type": "integer"
                    },
                    "total": {
                      "type": "integer"
                    },
                    "pins": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "uses": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "sha": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "kind": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "version": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "pinned_uses": {
                            "type": "string"
                          },
                          "latest": {
                            "type": "string"
                          },
                          "newer_major_available": {
                            "type": "boolean"
                          },
                          "warning": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "snippet": {
                      "type": "string"
                    },
                    "note": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "resolved": 2,
                  "total": 2,
                  "pins": [
                    {
                      "uses": "actions/checkout@v4",
                      "status": "resolved",
                      "sha": "<40-hex>",
                      "kind": "tag",
                      "version": "v4.2.2",
                      "pinned_uses": "actions/checkout@<40-hex> # v4.2.2",
                      "latest": "v5.0.0",
                      "newer_major_available": true
                    }
                  ],
                  "snippet": "uses: actions/checkout@<40-hex> # v4.2.2"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Repository, ref or workflows not found (not charged)"
          },
          "422": {
            "description": "Not a GitHub Actions workflow (not charged)"
          },
          "502": {
            "description": "GitHub unavailable (not charged)"
          }
        }
      },
      "post": {
        "operationId": "post_gha_pin",
        "summary": "Pin GitHub Actions to commit SHAs",
        "description": "Resolve GitHub Actions references to immutable commit SHAs, live from GitHub: actions=actions/checkout@v4,docker/login-action@v3 (up to 20), or repo=/url=/yaml= to pin every uses: in those workflows. Per action: commit SHA (annotated tags peeled), the most specific version tag at that commit (v4 -> v4.2.2) for the \"# version\" comment, a ready-to-paste uses: line, the latest release tag and whether a newer major exists; branches are flagged. Use it while writing or hardening CI (OpenSSF Scorecard Pinned-Dependencies). No input = 6 popular actions. Not charged if GitHub cannot be reached.",
        "tags": [
          "github-actions",
          "sha-pinning",
          "supply-chain",
          "ci",
          "security",
          "dependencies",
          "scorecard",
          "coding-agent",
          "devtools"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.02"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xf20b05f3fcf799B1d03702446b0107A50830CA92"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "20000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Pin GitHub Actions to commit SHAs: $0.02 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "actions": {
                    "type": "string",
                    "description": "Comma-separated owner/repo[/path]@ref list, e.g. actions/checkout@v4,actions/setup-node@v4",
                    "example": "actions/checkout@v4,actions/setup-node@v4"
                  },
                  "repo": {
                    "type": "string",
                    "description": "Alternative to actions: pin every uses: in this public repo's workflows (owner/name)"
                  },
                  "ref": {
                    "type": "string",
                    "description": "Optional branch, tag or commit SHA for repo= (default: the default branch)"
                  },
                  "url": {
                    "type": "string",
                    "description": "Alternative: https URL of one workflow file (github.com blob/raw, raw.githubusercontent.com, gist)"
                  },
                  "yaml": {
                    "type": "string",
                    "description": "Alternative: the workflow file text itself (POST JSON {\"yaml\": \"...\"} recommended; up to 64 KB)"
                  }
                }
              }
            },
            "text/yaml": {
              "schema": {
                "type": "string",
                "description": "raw workflow file"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "pins",
                    "resolved",
                    "total"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "target": {
                      "type": "object"
                    },
                    "resolved": {
                      "type": "integer"
                    },
                    "total": {
                      "type": "integer"
                    },
                    "pins": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "uses": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "sha": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "kind": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "version": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "pinned_uses": {
                            "type": "string"
                          },
                          "latest": {
                            "type": "string"
                          },
                          "newer_major_available": {
                            "type": "boolean"
                          },
                          "warning": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "snippet": {
                      "type": "string"
                    },
                    "note": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "resolved": 2,
                  "total": 2,
                  "pins": [
                    {
                      "uses": "actions/checkout@v4",
                      "status": "resolved",
                      "sha": "<40-hex>",
                      "kind": "tag",
                      "version": "v4.2.2",
                      "pinned_uses": "actions/checkout@<40-hex> # v4.2.2",
                      "latest": "v5.0.0",
                      "newer_major_available": true
                    }
                  ],
                  "snippet": "uses: actions/checkout@<40-hex> # v4.2.2"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Repository, ref or workflows not found (not charged)"
          },
          "422": {
            "description": "Not a GitHub Actions workflow (not charged)"
          },
          "502": {
            "description": "GitHub unavailable (not charged)"
          }
        }
      }
    },
    "/v1/pass/day": {
      "get": {
        "operationId": "get_pass_day",
        "summary": "CI Guard 24-hour pass",
        "description": "One payment, 24 hours of unlimited GitHub Actions audits (/v1/gha/audit, $0.10 each) and SHA pinning (/v1/gha/pin, $0.02 each) on this service. Returns a bearer token: send it as Authorization: Bearer <token> (or X-CI-Guard-Pass) and paid routes answer without a new payment until it expires. Worth it from the 6th audit: hardening an organization's repositories in one session or reviewing many workflow PRs. No parameters.",
        "tags": [
          "pass",
          "subscription",
          "prepaid",
          "github-actions",
          "ci",
          "security",
          "devtools"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.5"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xf20b05f3fcf799B1d03702446b0107A50830CA92"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "500000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "CI Guard 24-hour pass: $0.50 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "pass",
                    "expiresAt"
                  ],
                  "properties": {
                    "pass": {
                      "type": "string"
                    },
                    "issuedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "expiresAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "use": {
                      "type": "string"
                    },
                    "covers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "example": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "pass": "rcg1.<payload>.<signature>",
                  "issuedAt": "2026-11-21T10:00:00.000Z",
                  "expiresAt": "2026-11-22T10:00:00.000Z",
                  "use": "Authorization: Bearer rcg1...",
                  "covers": [
                    "/v1/gha/audit",
                    "/v1/gha/pin"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Repository, ref or workflows not found (not charged)"
          },
          "422": {
            "description": "Not a GitHub Actions workflow (not charged)"
          },
          "502": {
            "description": "GitHub unavailable (not charged)"
          }
        }
      },
      "post": {
        "operationId": "post_pass_day",
        "summary": "CI Guard 24-hour pass",
        "description": "One payment, 24 hours of unlimited GitHub Actions audits (/v1/gha/audit, $0.10 each) and SHA pinning (/v1/gha/pin, $0.02 each) on this service. Returns a bearer token: send it as Authorization: Bearer <token> (or X-CI-Guard-Pass) and paid routes answer without a new payment until it expires. Worth it from the 6th audit: hardening an organization's repositories in one session or reviewing many workflow PRs. No parameters.",
        "tags": [
          "pass",
          "subscription",
          "prepaid",
          "github-actions",
          "ci",
          "security",
          "devtools"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.5"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xf20b05f3fcf799B1d03702446b0107A50830CA92"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "500000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "CI Guard 24-hour pass: $0.50 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {}
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "pass",
                    "expiresAt"
                  ],
                  "properties": {
                    "pass": {
                      "type": "string"
                    },
                    "issuedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "expiresAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "use": {
                      "type": "string"
                    },
                    "covers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "example": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "pass": "rcg1.<payload>.<signature>",
                  "issuedAt": "2026-11-21T10:00:00.000Z",
                  "expiresAt": "2026-11-22T10:00:00.000Z",
                  "use": "Authorization: Bearer rcg1...",
                  "covers": [
                    "/v1/gha/audit",
                    "/v1/gha/pin"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Repository, ref or workflows not found (not charged)"
          },
          "422": {
            "description": "Not a GitHub Actions workflow (not charged)"
          },
          "502": {
            "description": "GitHub unavailable (not charged)"
          }
        }
      }
    },
    "/v1/pass/month": {
      "get": {
        "operationId": "get_pass_month",
        "summary": "CI Guard 30-day pass + Team Kit",
        "description": "One payment, 30 days of unlimited GitHub Actions audits (/v1/gha/audit, $0.10 each) and SHA pinning (/v1/gha/pin, $0.02 each) on this service. Returns a bearer token: send it as Authorization: Bearer <token> (or X-CI-Guard-Pass) and paid routes answer without a new payment until it expires. For agents that audit every workflow change they touch or pin actions in every workflow they write: cheaper than per-call from the 31st audit in a month. Also downloads the self-hosted Team Kit (GET /v1/kit/download with the same bearer token; see /kit). No parameters.",
        "tags": [
          "pass",
          "subscription",
          "prepaid",
          "github-actions",
          "ci",
          "security",
          "devtools"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "3"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xf20b05f3fcf799B1d03702446b0107A50830CA92"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "3000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "CI Guard 30-day pass + Team Kit: $3.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "pass",
                    "expiresAt"
                  ],
                  "properties": {
                    "pass": {
                      "type": "string"
                    },
                    "issuedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "expiresAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "use": {
                      "type": "string"
                    },
                    "covers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "example": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "pass": "rcg1.<payload>.<signature>",
                  "issuedAt": "2026-11-21T10:00:00.000Z",
                  "expiresAt": "2026-11-22T10:00:00.000Z",
                  "use": "Authorization: Bearer rcg1...",
                  "covers": [
                    "/v1/gha/audit",
                    "/v1/gha/pin"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Repository, ref or workflows not found (not charged)"
          },
          "422": {
            "description": "Not a GitHub Actions workflow (not charged)"
          },
          "502": {
            "description": "GitHub unavailable (not charged)"
          }
        }
      },
      "post": {
        "operationId": "post_pass_month",
        "summary": "CI Guard 30-day pass + Team Kit",
        "description": "One payment, 30 days of unlimited GitHub Actions audits (/v1/gha/audit, $0.10 each) and SHA pinning (/v1/gha/pin, $0.02 each) on this service. Returns a bearer token: send it as Authorization: Bearer <token> (or X-CI-Guard-Pass) and paid routes answer without a new payment until it expires. For agents that audit every workflow change they touch or pin actions in every workflow they write: cheaper than per-call from the 31st audit in a month. Also downloads the self-hosted Team Kit (GET /v1/kit/download with the same bearer token; see /kit). No parameters.",
        "tags": [
          "pass",
          "subscription",
          "prepaid",
          "github-actions",
          "ci",
          "security",
          "devtools"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "3"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xf20b05f3fcf799B1d03702446b0107A50830CA92"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "3000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "CI Guard 30-day pass + Team Kit: $3.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {}
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "pass",
                    "expiresAt"
                  ],
                  "properties": {
                    "pass": {
                      "type": "string"
                    },
                    "issuedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "expiresAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "use": {
                      "type": "string"
                    },
                    "covers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "example": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "pass": "rcg1.<payload>.<signature>",
                  "issuedAt": "2026-11-21T10:00:00.000Z",
                  "expiresAt": "2026-11-22T10:00:00.000Z",
                  "use": "Authorization: Bearer rcg1...",
                  "covers": [
                    "/v1/gha/audit",
                    "/v1/gha/pin"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Repository, ref or workflows not found (not charged)"
          },
          "422": {
            "description": "Not a GitHub Actions workflow (not charged)"
          },
          "502": {
            "description": "GitHub unavailable (not charged)"
          }
        }
      }
    },
    "/": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health/github": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/peek": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/rules": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/kit": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/pass/transfer": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/pass/redeem": {
      "get": {
        "summary": "Redeem a plain USDC transfer on Base (tx hash) for a pass token (free; the transfer is the payment)",
        "security": [],
        "parameters": [
          {
            "name": "tx",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Pass token"
          },
          "402": {
            "description": "No / too small USDC transfer to payTo in that tx"
          },
          "404": {
            "description": "Transaction not found yet"
          }
        }
      }
    },
    "/v1/kit/download": {
      "get": {
        "summary": "Team Kit ZIP: unlocked by a plain USDC transfer of 3+ USDC on Base (tx=) or a 30-day pass (Authorization: Bearer)",
        "security": [],
        "parameters": [
          {
            "name": "tx",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "application/zip",
            "content": {
              "application/zip": {}
            }
          },
          "402": {
            "description": "Payment required (instructions in the body)"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "summary": "Remote MCP server (Streamable HTTP, JSON-RPC 2.0, stateless)",
        "security": [],
        "responses": {
          "200": {
            "description": "JSON-RPC response"
          }
        }
      }
    }
  }
}