Skip to main content

GitHub Fronting

GitHub demonstrates governed repository and delivery behavior on top of native GitHub APIs.

The package is:

What It Proves

GitHub has powerful write paths: issue creation, PR comments, workflow dispatch, and release publication flows. ANIP narrows those into repo-scoped capabilities with preview, approval, denial, and audit.

The contract is intentionally not a renamed GitHub API catalog:

  • Repository access is allowlisted.
  • Issue creation is prepared before mutation.
  • PR comments are draft/approval flows, not direct writes.
  • Workflow dispatch requires declared purpose and approval posture.
  • Release notes are bounded drafts unless a separate publishing path is implemented.
  • Secrets, raw repository exports, unbounded org search, and workflow bypasses are denied.

Capability Surface

CapabilityIntent
github.repo.search_contextSearch bounded repository context.
github.issue.preparePrepare a governed issue preview.
github.pr.comment.preparePrepare a pull-request comment preview.
github.workflow.dispatch.requestRequest a workflow dispatch through approval posture.
github.release_notes.preparePrepare bounded release notes.

Backend Boundary

Native GitHub REST/GraphQL APIs are backend bindings. The ANIP contract owns what an agent is allowed to ask for, when approval is required, what must be denied, and what evidence is audited.

This is the distinction the showcase should make clear: GitHub's backend allows many operations; the ANIP product contract allows only the governed operations.

Artifacts

ArtifactPath
Source specdocs/examples/github-fronting-showcase/source-spec.md
Packageexamples/showcase/github_fronting/registry-packages/github-fronting-showcase-0.2.0.anip-package.json
Service definitionexamples/showcase/github_fronting/registry-packages/github-fronting-showcase-0.2.0-service-definition.json
Custom bundlesexamples/showcase/github_fronting/custom-code-bundles/
Generated servicesexamples/showcase/github_fronting/generated/

Live Validation

Credential file:

/tmp/anip-github.env

Typical test scope:

  • dedicated repository such as anip-protocol/anip-fronting-test;
  • bounded read/search smoke;
  • issue preparation smoke;
  • approved issue creation smoke only when ANIP_GITHUB_ALLOW_MUTATION=true and an approval grant is supplied.