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-cli0.14.0·
FUSEkg-fuse0.12.1(unchanged).
Added
Backup & restore — kg-backup/2 (ADR-102)
- New self-describing
kg-backup/2export 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/--depsflags, with anadjacent-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.generationdeclared 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 visioncommands (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
AIProviderinterface. serialization.pysplit into aserialization/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_restoreexit 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_imagedata-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.0Upgrade: sudo ./operator.sh upgrade