githome-conform

Overview ¶

Command githome-conform certifies a running Githome instance against the compatibility matrix: it points at a base URL with an auth token and a target repository, runs the section-3 surface (repository read, conditional requests, issue listing and pagination, the search endpoints, and GraphQL introspection plus a connection query), and prints a pass/fail report.

It is a black-box client: it speaks only HTTP and reads only the wire shapes, so it certifies any Githome build the same way a real client would see it. It exits non-zero when any check fails, so it can gate a release.

Usage:

githome-conform [flags] <owner>/<repo>

  -url string      instance origin (env GITHOME_URL), e.g. https://git.example.com
  -token string    auth token (env GITHOME_TOKEN)
  -api string      REST base override (default <url>/api/v3)
  -graphql string  GraphQL endpoint override (default <url>/api/graphql)

The REST and GraphQL bases follow the GitHub Enterprise layout (/api/v3 and /api/graphql) and can be overridden for an instance that mounts them elsewhere.