# fairsplit

> 

- Documentation: https://pr-1-10d18e06d3bf.thally.app
- GitHub: https://github.com/fairsplitt/fairsplit-docs
- Full docs for LLMs: https://pr-1-10d18e06d3bf.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://pr-1-10d18e06d3bf.thally.app/ai.txt
- Structured docs index (JSON): https://pr-1-10d18e06d3bf.thally.app/api/docs-index
- OpenAPI spec: https://pr-1-10d18e06d3bf.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://pr-1-10d18e06d3bf.thally.app/api/docs/{page-id}
- Search API: https://pr-1-10d18e06d3bf.thally.app/api/search?q={query}
- Capability manifest (skill): https://pr-1-10d18e06d3bf.thally.app/skill.md
- Agent guidance (editing these docs): https://pr-1-10d18e06d3bf.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://pr-1-10d18e06d3bf.thally.app/api/mcp
- Agent readiness: https://pr-1-10d18e06d3bf.thally.app/api/agent-readiness

### Recommended workflow

1. Use this index, the search API, or `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get started

### Get started

- [Introduction](https://pr-1-10d18e06d3bf.thally.app/): Webhook signing, verification, and delivery-retry policy for Node.js — deterministic, dependency-free, and the single source of truth for the Sigil signature format.
- [Quickstart](https://pr-1-10d18e06d3bf.thally.app/quickstart): Install @sigil/core, sign a webhook request, and verify it on the receiving end.

### Signing and verification

- [Signing](https://pr-1-10d18e06d3bf.thally.app/signing): Produce a Sigil-Signature header that binds the timestamp into the signed material.
- [Verification](https://pr-1-10d18e06d3bf.thally.app/verification): Verify a Sigil-Signature header, enforce a tolerance window, and decode the payload.
- [Key rotation](https://pr-1-10d18e06d3bf.thally.app/key-rotation): Change a webhook secret without dropping events, using multi-signature headers.

## Reference

### Reference

- [Signature format](https://pr-1-10d18e06d3bf.thally.app/signature-format): The Sigil-Signature wire format — header grammar, signed bytes, and stability guarantees.
- [Retry policy](https://pr-1-10d18e06d3bf.thally.app/retry-policy): The built-in exponential-backoff delivery schedule, with optional jitter and injectable randomness.
- [Error codes](https://pr-1-10d18e06d3bf.thally.app/error-codes): Every SigilError code, what it means, and when it is returned.