AISOURCEOFTRUTH.COM

Publish to the registry

Publishing is three commands. The private key never leaves your machine. Install the CLI with npm i -g aisot (or drive the raw API directly, below).

The record profiles

Write authorization

An append requires a Tier-2 token with the matching publish:* scope AND a record signature that verifies against your registered key. Either one alone appends nothing. Register a publisher with POST /v1/publishers and mint a token at https://aisourceoftruth.com/oauth/token.

The schema is a commons

The report JSON Schema is published under CC0 at https://aisourceoftruth.com/spec/schemas. Build against it; the schema and ingest contract are frozen.

In CI

The publish action attests build artifacts on every release: point it at your files and every one gets a signed, idempotent provenance record. The private key never leaves the runner, and a re-run re-publishes nothing (Idempotency-Key is automatic).

```yaml

with:

paths: |

dist/*.tar.gz

key-id: ${{ secrets.AISOT_KEY_ID }}

private-jwk: ${{ secrets.AISOT_PRIVATE_JWK }}

client-id: ${{ secrets.AISOT_CLIENT_ID }}

client-secret: ${{ secrets.AISOT_CLIENT_SECRET }}

```

A GitLab template ships beside the action. Keyless signing via CI OIDC identity (zero key management) is the v1.1 roadmap.

$ curl -H 'Accept: text/markdown' https://aisourceoftruth.com/publish # this page is a rendering of the API. Reproduce it as data.