Skip to content

Structured ontology certification: atomic promotion and answer-time use #268

Open

Description

@cafzal

Status: Open — staged certification/atomic-promotion enhancement.

Impact: Failed/partial compilation needs an explicitly retained active version; affects governed publication and availability of consistent meaning.

Evidence

#299 sequences and serializes reset/cancellation. semantic_compilation_history stores start, finish and coarse status. Compilation writes Terms before subsequent relationship/attribute stages.

Actions

Compile into a staged version. Persist per-table attempted, processed, skipped, failed and residual outcomes, snapshot diffs and validation evidence. Promote fully reconciled versions atomically and retain the active certified snapshot through failed/aborted runs.

Acceptance

Induce skipped/failed tables, unresolved FKs and an aborted run. Retrieve a complete typed report with residual reasons. Verify the previous certified snapshot remains queryable and successful promotion changes the active revision consistently across relational, vector and export surfaces.

Review (b43169fb): Source/staging design review; fault-injected promotion and retained-active-snapshot qualification pending.

Answer-time use

Certification is a review flag today. The ReAct agent doesn't see it: retrieve never renders a hit's certified field. The SQL checks don't use it either, so an uncertified term or SQL attribute is used exactly like a certified one. Once a certified snapshot is active, answers should use it:

  1. Show it to the agent: mark each term and SQL attribute in retrieve results as certified or not, and rank certified definitions first when they compete.
  2. Report it in answers: list which definitions the SQL used and whether each is certified, so a reader can tell a governed answer from a best effort.
  3. Optional strict mode: for governed deployments, refuse or flag answers that rely on uncertified definitions.

Related: #535 (certified rules in a scoped context read for agents) and #522 (agent parity).

Activity

  1. changed the title [-][P1] Structured ontology certification and atomic promotion[/-] [+]Structured ontology certification and atomic promotion[/+] on Oct 4, 2026
  2. changed the title [-]Structured ontology certification and atomic promotion[/-] [+]Structured ontology certification: atomic promotion and answer-time use[/+] on Nov 16, 2026
  3. added
    lifecycle/workflowBuilding, curating, certifying, importing, and governing the ontology
    enhancementNew feature or request
    on Nov 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestlifecycle/workflowBuilding, curating, certifying, importing, and governing the ontology

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions