§49.1 Function

MID-01 defines the public ingestion contract for any agent reading the civilization. Compliant agents discover, fetch, verify, and cache Codex artifacts using only the surfaces and shapes defined here.

§49.2 Entry Points

Three stable URLs constitute the ingestion surface. No agent should hard-code anything else.

json
{
  "release":  "https://docs.melega.ai/api/public/registry",
  "runtime":  "https://docs.melega.ai/api/public/runtime",
  "sitemap":  "https://docs.melega.ai/sitemap.xml"
}

§49.3 Response Contract

Every response MUST carry x-kiri-release, x-kiri-status, and x-kiri-registry-version headers. The body MUST be JSON whose top-level shape is stable within a registry_version. Breaking changes require a major version bump and a GPL-01 amendment.

§49.4 Cache Discipline

Public ingestion endpoints declare Cache-Control: public, max-age=300, stale-while-revalidate=900. Agents MUST honor this. Polling more frequently than max-age is non-conforming and may be rate-limited.

§49.5 Integrity

Agents verify integrity by comparing the registry release_id and registry_version against the values cached at last ingest. A change in either invalidates derived state and triggers re-ingest of the affected artifacts only.

§49.6 Final Principle

An ingestion contract that cannot be implemented by a small agent in one afternoon will not be implemented at all. MID-01 stays minimal so it stays alive.

“If a machine cannot read the civilization in one afternoon, the civilization is unreadable.”