Feature description
Add optional temporal claims to summary, concept, and entity pages.
Each claim must have these fields:
id
text
as_of
status
source_anchor
supersedes
superseded_by
A claim can also have an authority field.
Motivation
OpenKB pages store factual state as prose. A page cannot identify the date of a claim. A page cannot separate proposed assistant output from source evidence. A page also cannot show how new evidence corrects an old claim.
The feature must preserve claim history. It must also provide strict current reads that return only validated claims.
Proposed solution
- Create deterministic claim IDs in code.
- Store claims as a one-line JSON array in YAML frontmatter.
- Validate the
as_of, status, source_anchor, and authority fields.
- Apply page-local supersession links.
- Reject backward supersession links.
- Keep stored claims unchanged when an incoming duplicate claim has the same ID.
- Limit assistant authority.
- Set model claims from the document compiler to
document authority.
- Add a query tool for strict current reads.
- Preserve old claims as history.
Alternatives considered
OpenKB can keep factual state only in prose. This option does not provide deterministic current-state reads or an audit trail.
A transport-specific conversation system can also manage claims. This option would couple OpenKB core to one source format. A generic claim layer keeps transport policy outside OpenKB.
Scope
Medium.
The change affects:
- Frontmatter helpers
- Compiler output and page writes
- Query tools
- Schema documentation
- Deterministic tests
The change does not add transport adapters, scheduler rules, privacy rules, or live-ingestion code.
Feature description
Add optional temporal claims to summary, concept, and entity pages.
Each claim must have these fields:
idtextas_ofstatussource_anchorsupersedessuperseded_byA claim can also have an
authorityfield.Motivation
OpenKB pages store factual state as prose. A page cannot identify the date of a claim. A page cannot separate proposed assistant output from source evidence. A page also cannot show how new evidence corrects an old claim.
The feature must preserve claim history. It must also provide strict current reads that return only validated claims.
Proposed solution
as_of,status,source_anchor, andauthorityfields.documentauthority.Alternatives considered
OpenKB can keep factual state only in prose. This option does not provide deterministic current-state reads or an audit trail.
A transport-specific conversation system can also manage claims. This option would couple OpenKB core to one source format. A generic claim layer keeps transport policy outside OpenKB.
Scope
Medium.
The change affects:
The change does not add transport adapters, scheduler rules, privacy rules, or live-ingestion code.