Skip to content

v0.15.0

Choose a tag to compare

@aaronsb aaronsb released this 02 Jun 02:56
· 146 commits to main since this release
v0.15.0

Knowledge Graph System v0.15.0

127 commits since v0.14.0. This release lands the ADR-102 backup/restore
overhaul, the ADR-207 freshness contract, ADR-705 capability gating with
mid-session expiry handling, and ADR-802/803 vision-provider support.

Component versions: platform 0.15.0 · CLI @aaronsb/kg-cli 0.14.0 ·
FUSE kg-fuse 0.12.1 (unchanged).

Added

Backup & restore — kg-backup/2 (ADR-102)

  • New self-describing kg-backup/2 export format with a versioned header.
  • kg admin verify-backup — validate a backup without restoring it.
  • Offline backup validator, including a concept embedding-dimension check.
  • kg restore --mode {idempotent,adjacent,integration} replaces the old
    --merge/--deps flags, with an adjacent-mode ID-remap layer.
  • kg restore --epoch {simple,faithful} — faithful epoch-replay restore with
    replay orchestration, an eligibility gate, and source-embedding rehydration.
  • ConceptMatcher integration engine ported into the API.

Freshness contract (ADR-207)

  • Trustworthy committed-epoch watermark; the freshness tick is now universal
    across all mutation kinds.
  • Grounding, confidence, and artifact caches migrated onto the freshness
    contract; artifact regenerate / cleanup / stale-guidance UX.
  • graph_accel.generation declared as a co-advancing sub-counter.

Capability gating & sessions (ADR-705)

  • Declarative capability-gating primitives with a gating-adoption linter for the
    web UI.
  • Session status endpoint + 401 interceptor for mid-session token expiry.
  • Ambient session-treatment banner.

Vision providers (ADR-802 / ADR-803)

  • kg admin vision commands (config / providers / set) and a vision-provider
    selector card in the System tab.
  • Image index decoupled from the text embedding space.
  • Active vision-provider slot — resolve, persist, configure.

Ontology, vocabulary & admin (ADR-701)

  • Vocabulary tab wired to the ontology lifecycle, with a Recent Runs log.
  • Admin/operator UI controls for worker lanes, ontology delete, and tombstones.
  • Global candidate-concept retrieval for reasoner context.

Changed

  • Vision provider hierarchy collapsed into the unified AIProvider interface.
  • serialization.py split into a serialization/ package.
  • Dead backup/restore code (TS + Python) purged after the ADR-102 migration.
  • CLI doc generator now driven from the command registry instead of a static list.
  • CLI publishing moved to npm OIDC Trusted Publishing (no token, no 2FA) via CI.

Fixed

  • Capture pg_restore exit codes and restore into an empty DB (#397, #398).
  • True-replace rollback (#483) and orphaned-epoch reconciliation (#485).
  • Refractory gate — defer cycles while ingestion is in flight.
  • Disable retired Anthropic model snapshots in seed + sketch reconcile.
  • Detect OpenAI describe_image data-URL MIME from magic bytes.
  • FUSE: use path-derived ontology in document frontmatter.

Container images

docker pull ghcr.io/aaronsb/knowledge-graph-system/kg-api:0.15.0
docker pull ghcr.io/aaronsb/knowledge-graph-system/kg-web:0.15.0
docker pull ghcr.io/aaronsb/knowledge-graph-system/kg-operator:0.15.0

Upgrade: sudo ./operator.sh upgrade