ShipGate Intent Gate — GitHub Action

Verifies a pull request against an approved ISL mission spec, emits a canonical .shipgate-proof.json artifact, and posts a PR comment with the verdict (SHIP / BLOCK / REVIEW).

Usage

name: ShipGate Intent Verification

on:
  pull_request:

jobs:
  verify-intent:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - uses: shipgate/intent-gate@v1
        with:
          mission: shipgate.isl
          mode: pr
          fail-on: block

Inputs

| Name | Default | Description | | -------------- | ----------------------- | ------------------------------------------------------------------- | | mission | shipgate.isl | Path to the approved mission ISL file. | | mode | pr | Run mode (only pr is supported in v1). | | fail-on | block | Verdict that should fail the workflow: block, review, never. | | proof-output | .shipgate-proof.json | Where the proof bundle is written. | | artifact-name| shipgate-proof | Name of the uploaded artifact. | | comment | true | Set to false to skip the PR comment. | | github-token | ${{ github.token }} | Token used for the PR comment. | | base-ref | (auto) | Base ref override; defaults to GITHUB_BASE_REF or HEAD~1. |

Outputs

| Name | Description | | ------------ | ---------------------------------------------------------- | | verdict | SHIP, BLOCK, or REVIEW. | | summary | One-line summary of the verdict. | | proof-path | Workspace-relative path of the emitted proof. | | mission-id | Active mission id used during verification. |