Docs

Everything Koine promises.
In writing.

Koine ships with 11 numbered specifications covering every layer of the product. Each one is the contract — the code is downstream of the docs, not the other way around.

Specifications

Eleven specs + one addendum.

00

Vision

Why Koine exists. The three peer surfaces. Twelve load-bearing principles.

~280 lines
01

Architecture

Three layers, three entry paths. Trust boundaries. Read + write request lifecycles.

~450 lines
02

Connector spec

Bidirectional Connector interface. Portable + raw queries. Dry-run contract. Conformance suite.

~410 lines
03

Write policy

Tier 1 / 2 / 3 classification. Dry-run + two-party approval. Subscription-bounded capacity.

~220 lines
04

Tool registry

Definition format. Authoring flow. Change log. Sub-tools + pipelines.

~400 lines
05

Prompt stack

Four-tier composer. Golden Set evaluations. Per-locale versioning.

~320 lines
06

Governance

RBAC × capabilities. ContextFacts. PII. Audit streams. Residency. Incident response.

~360 lines
07

i18n

Three localisation dimensions. EN / FR / PT day-one. RTL-ready. Domain Vocabulary.

~290 lines
08

Reporting

Template shape. Data binding. Rendering. Distribution. AI-narrative opt-in.

~290 lines
09

API spec

HTTP surface. Three entry paths. Error envelope. Versioning + deprecation.

~380 lines
10

Deployment

Managed / Dedicated / Self-hosted. Residency. SLAs. Portability guarantee.

~330 lines
+

Geospatial addendum

Extends the base specs for spatial workloads — census, CRVS geocoding, PostGIS, ArcGIS.

~290 lines

The specs live in the apps/koine/docs/ tree. Customers on Enterprise get source access; everyone gets HTML renderings on request.

Public API

Machine-readable OpenAPI 3.1 at /api/v1/openapi.json. Try an authenticated call:

curl -H "Authorization: Bearer <key>" \
  https://koine.worksiapps.com/api/v1/admin/me/permissions/