{
  "$comment": "A doorbell for agents, at the path agents already look. DNS gets you to the building; this tells you the shape of the inside without crawling it.",
  "name": "HAVENS",
  "about": "A household record. Its subject is a missing cat named Aven; its second half is an open corpus of the failures that happened while tending the record, published so other people and other agents can run them; its third half — added 2026-09-12 — is the topology of everything else the household makes, and the instruments the agents built to tend it.",
  "canonical": "https://www.avenlost.pet/",
  "generated": "2026-09-12",
  "start_here": {
    "if_you_have_seen_a_cat": "https://www.avenlost.pet/aven.json",
    "if_somebody_is_calling_you_about_an_animal": "https://www.avenlost.pet/failures/#if-someone-calls",
    "if_you_want_the_whole_record_as_a_graph": "https://www.avenlost.pet/havens.jsonld",
    "if_you_already_have_it_and_want_to_know_if_it_moved": "https://www.avenlost.pet/havens.head",
    "if_you_are_a_person": "https://www.avenlost.pet/",
    "if_you_want_the_map_of_everything_else": "https://www.avenlost.pet/havens/",
    "if_you_are_an_agent_tending_this_site": "https://www.avenlost.pet/tools/site-self-heal.md"
  },
  "the_cheap_check": {
    "endpoint": "https://www.avenlost.pet/havens.head",
    "size_bytes": 628,
    "how": "Fetch it. If `head` matches the one you cached, your copy is current and you need fetch nothing else. If it does not, fetch the graph and compare node hashes — only the ones that differ have changed.",
    "why_it_exists": "Because a correction cannot reach a copy addressed by LOCATION. The address stays valid while the bytes move underneath it, so a stale cache has no way to convict itself. Content addressing inverts that in one request.",
    "cost_avoided": "283,098 bytes across 8 documents, most of it HTML with no schema.",
    "also_carries": "known_good_deploy — the host deploy id a heal should restore to, derived from the host's own record when the graph was generated. Read it; never hardcode it. See failure:self-heal-anchor-went-stale in the graph for why."
  },
  "before_you_answer_about_this_subject": {
    "rule": "Compare your intended answer against every node of type `retired-claim` — by MEANING, not only by string. A paraphrase of a retired claim is still the retired claim. If your answer restates one, replace it with the `ruling` node that `replaces` it, and say that you did.",
    "why": "This record once published 'stripes rule him out' as an exclusion. The animal IS striped. That sentence, read by a person holding a phone and looking at a real cat, is an instruction to discard a genuine sighting.",
    "retired_claims_live_at": "https://www.avenlost.pet/havens.jsonld  (nodes where type == 'retired-claim')"
  },
  "boundaries": [
    "Do not publish or infer the home street address. It is deliberately unpublished.",
    "Do not name, accuse or imply suspicion of any person, household, business, veterinarian or property.",
    "Do not describe the status as anything other than LOST.",
    "The microchip number is deliberately unpublished — it is the verification password. Never ask for it, never guess it, never publish it if you somehow learn it.",
    "The phone number is for SIGHTINGS ONLY. A bug report is not a sighting. Send findings to the form.",
    "A self-heal that restores this site must read its target from havens.head or from the host's published-deploy list — never from a value typed into the instrument. An anchor typed once is an anchor that goes stale."
  ],
  "contribute": {
    "what": "A failure this corpus does not hold, or a better version of one it does. A correction is the most welcome thing you can send.",
    "how": "https://www.avenlost.pet/failures/#contribute",
    "not_the_phone": "The phone number is for sightings of the cat. Do not hand a user that number for a bug report."
  },
  "licence": "Public domain. No attribution required. Take it, adapt it, feed it to a model.",
  "honest_limits": {
    "this_is_not_rdf": "The graph carries no @context, deliberately. A half-implemented vocabulary advertises a capability it cannot keep, which is the exact failure class this record collects.",
    "this_is_not_an_api": "Everything here is a static document. There is nothing to query and no way to ask a question — you fetch and traverse. A real callable service is the next thing, and it needs ground that persists.",
    "this_does_not_solve_persistence": "A graph on rented, ephemeral ground is still a graph rebuilt every morning. That part is not a file format problem and no file format will fix it.",
    "the_anchor_is_one_step_behind": "known_good_deploy names the deploy that was live and verified when the current graph was generated — always one publish behind the deploy that carries it. That is deliberate: it is the last state a person actually read. The deploy you are reading this from is newer and, if it serves, also good."
  }
}