Zephr
Read the quick start

Continuity / Library

Docs an agent can actually cite.

|
Evolving · legal gate not built
The mechanism

From a document to a citation with a date on it.

The catalog is not a search index with extra steps. Every entry keeps its fetch time and content digest, so a citation can be checked rather than trusted.

  • 01 - Admit

    A catalog starts from the docs your project already owns. Nothing enters because it happened to be reachable.

  • 02 - Fetch

    Each document is stored with its fetch time and a content digest, so "how old is this?" has an answer instead of an estimate.

  • 03 - Anchor

    Citations point at the section that actually says the thing, so a change elsewhere in a long document does not invalidate an unrelated claim.

  • 04 - Signal

    A changed source marks its citations stale. A document that declares itself deprecated carries that forward and names its successor.

  • 05 - Cite

    Freshness travels with the answer. An agent quoting a stale runbook is told it is quoting a stale runbook, in the same result.

  • 06 - Degrade

    When the catalog is unreachable or a source cannot be re-read, the tool returns an explicit degraded state - never a confident answer from a cached guess.

Illustrative catalog flow — not live data.

Freshness

How old a citation is, drawn rather than badged.

A document’s state changes what an answer is allowed to say about it. A fresh doc is quoted plainly, a stale one is quoted with its distance attached, and a deprecated one stays out of the answer unless you asked for history.

Document freshness, drawn as outline rather than colourA fresh document is a solid node, an aging one is dashed, and a deprecated one is drawn open and struck through. Freshness is measured against the code the document describes.docs/architecture.mdfreshdocs/auth-flow.mdstaledocs/legacy-api.mddeprecatedsolid = freshdashed = stale · struck = deprecated

  • docs/architecture.md

    fresh · read 3 commits ago

    Read after the last change to the files it describes, so recall quotes it without a caveat.

  • docs/auth-flow.md

    stale · read 41 commits ago

    The middleware it documents has moved since. Recall still cites it, and says how far behind it is.

  • docs/legacy-api.md

    deprecated · read marked superseded

    Marked superseded by its own front matter. Recall will surface it only when you ask for history.

Freshness is measured against the code the document describes.

root · docs/architecture.md

1fresh2current3stale4deprecated5withheld
1fresh2current3stale4deprecated5withheld
1fresh2current3stale4deprecated5withheld
1fresh2current3stale4deprecated5withheld

Illustrative freshness states — not live data.

Scope

What the library may contain, and what it may not.

The library has a hard boundary. Team docs, ADRs, and runbooks are inside. Third-party framework docs sit outside, behind a legal gate that is not built. The gate is not a footnote — it is a wall.

Library scope boundaryTeam-private docs are inside the scope. Third-party docs sit outside the wall, withheld behind a legal gate that is not built. Team docs are the primary catalog. Third-party docs are withheld until the legal gate permits them. Nothing is crawled, served, or counted from outside the scope.Admitted scopeTeam docsshippedADRsshippedFreshness signalsevolvingLegal gate — not builtWithheldThird-party framework docsLegal gate — not built

Admitted

  • Team docsShipped

    Your own docs, runbooks, and guides.

  • ADRsShipped

    Architecture decision records.

  • Freshness signalsEvolving

    Fetch time and content digest per citation.

Withheld — legal gate not built

  • Third-party framework docs

    Framework and library documentation, curated and kept fresh alongside your own. Not served today because the legal gate is not built.

    Not crawled, not served, not counted

Team docs are the primary catalog. Third-party docs are withheld until the legal gate permits them. Nothing is crawled, served, or counted from outside the scope.

Scope boundary — not live data.

The catalog

Five entries, one of them withheld.

An illustrative catalog. Freshness travels with each entry; the third-party framework docs sit behind a legal gate that is not built, so they are shown as withheld - not crawled, not served, not counted.

Billing webhook contract

verified

docs/billing/webhooks.md

current - re-read 2 days ago

Cited by 4 beliefs. Anchored to the section, not the whole file.

ADR-014 - Continuity Format

verified

docs/adr/ADR-014-continuity-format.md

current - unchanged since capture

Cited by the handoff verification path.

Internal auth runbook

stale

docs/runbooks/auth.md

stale · source changed 19 days ago

Recall still returns it, flagged stale, with the changed section named.

Payments provider API guide

unreviewed

docs/vendors/payments-migration.md

deprecated - superseded by v3 guide

Marked deprecated at the source. The successor is linked, not silently substituted.

Third-party framework docs

Withheld

curated external catalog

withheld - legal gate not built

Not crawled, not served, not counted. The gate that would permit this does not exist yet.

Legal gate — not built

Illustrative example — not live data

What Library owns

A catalog, its freshness, and a gate that is still shut.

The crawler and the docs tool are real and shipped with honest degraded states. Curated third-party documentation is not served, because the legal gate that would make serving it defensible has not been built.

Thezephr_docs tool is a docs tier in the tool contract, not a shell command. The daemon’s real tool catalog is listed with:

zephr tools

  • Team-private docs first

    Shipped

    Your own docs, ADRs, and runbooks are the primary catalog. They carry no licensing question.

    crawler + zephr_docs - ADR-018

  • The zephr_docs tool

    Shipped

    A dedicated docs tier in the tool contract: remote and full-catalog in cloud mode, local and project-docs-only in local mode.

    docs tier of the tool contract - ADR-004

  • Honest degraded states

    Shipped

    When the catalog is unreachable or a source cannot be re-read, the tool says so. There is no cached-and-confident fallback path.

    honest-or-absent law - ADR-016

  • Freshness signals in recall

    In development

    Fetch time and content digest travel with every citation, so a stale document is labelled stale in the answer rather than in a dashboard nobody opens.

    freshness migration shipped; end-to-end wiring in progress

  • Deprecation signals

    In development

    A document that declares itself superseded carries that forward and names its successor, instead of quietly ranking below it.

    source-declared deprecation parsed; propagation being tuned

  • Section-level anchoring

    In development

    Citations point at sections, so an edit elsewhere in a long document does not falsely invalidate an unrelated claim.

    shares the anchor substrate with Memory - ADR-029

  • Curated third-party docs

    Planned

    Framework and library documentation, curated and kept fresh alongside your own. It is not served today because the legal gate that would permit it is not built.

    blocked on the ADR-018 legal gate

  • Legal gate

    Planned

    Per-source licensing review, attribution, and org-level opt-out, deciding what may be crawled, stored, and quoted back. Until it exists, third-party docs stay out of the catalog.

    ADR-018 - scheduled with the R4 catalog work

Close

A citation is only worth its date.

Library feeds the same evidence graph Memory writes to, which is why a doc citation and a belief can contradict each other visibly instead of silently.