Eugen Ullrich / OKF Hub
/about/changelog/

Changelog and roadmap

The OKF Knowledge Hub is an active project, not a finished product behind a version seal. This page records the current feature state and names what is still open. We do not invent precise release dates in hindsight – what follows is the real state and the real next steps derived from the work.

Current state

The Hub implements the OKF v0.2 profile: the open OKF base plus the trust layer generated, verified, status, stale_after, sources. Available today:

  • Anmeldung über Google Sign-In, Sitzung bis zu 30 Tage. / Sign-in via Google, session up to 30 days.
  • Upload fertiger OKF-Bundles als .zip, .md oder .json, bis 20 MB, drei Vorgänge pro Monat im kostenlosen Zugang. / Upload of ready-made OKF bundles as .zip, .md, or .json, up to 20 MB, three operations per month on the free tier.
  • Import aus Notion, Obsidian, Logseq und Confluence mit automatischer Quellenerkennung und Konfliktbericht. / Import from Notion, Obsidian, Logseq, and Confluence with automatic source detection and a conflict report.
  • Concept Library mit Suche über Titel, Beschreibung und Tags, Filtern, Sortieren, Lesen, Bearbeiten, Verifizieren und Einzelexport. / Concept Library with search over title, description, and tags, filtering, sorting, reading, editing, verifying, and single-concept export.
  • Knowledge Graph aus Kategorien und gemeinsamen Tags. / Knowledge Graph from categories and shared tags.
  • RAG-Assistent über OpenRouter, standardmäßig Gemini 2.5 Flash, dazu DeepSeek V3 und Llama 3.3 70B, mit quellentreuer Systemanweisung und Zitaten in den Hub hinein. / RAG assistant via OpenRouter, Gemini 2.5 Flash by default, plus DeepSeek V3 and Llama 3.3 70B, with a source-faithful system instruction and citations pointing into the Hub.
  • Semantische Suche mit lokalem, mehrsprachigem Embedding-Modell und automatischem Fallback auf feldgewichtete Stichwortsuche. / Semantic search with a local multilingual embedding model and automatic fallback to field-weighted keyword search.
  • Verschlüsselung aller Bundles und Vektorindizes mit serverseitiger Per-User-AES-256-GCM, nur Chiffretext im Speicher. / Encryption of all bundles and vector indexes with server-side per-user AES-256-GCM, ciphertext only in storage.

The details of each are in the guide and, for encryption, on the encryption page.

Known limits

These points are deliberately unsolved today and openly documented.

  • Kein vollständiger Bundle-Export in der Oberfläche. Einzelne Konzepte lassen sich als OKF-Markdown exportieren, ein kompletter Bundle-Download nicht. Bewahren Sie Originaldateien als Sicherung. / No full bundle export in the interface. Single concepts export as OKF Markdown; a complete bundle download does not. Keep originals as backup.
  • Keine Versionshistorie, kein Undo. Bearbeitungen und Löschungen sind endgültig. / No version history, no undo. Edits and deletions are final.
  • Anhänge werden nicht gespeichert. Der Import konzentriert sich auf Text (Markdown, HTML, CSV); Bilder und PDFs werden nicht als eigene Inhalte übernommen. / Attachments are not stored. Import focuses on text (Markdown, HTML, CSV); images and PDFs are not kept as separate content.
  • Logseq-Blockreferenzen werden derzeit nicht als interaktive Referenzen übernommen. / Logseq block references are not currently preserved as interactive references.
  • Volltextsuche über den Body ist absichtlich eingeschränkt; die Suche nutzt Titel, Beschreibung und Tags. / Full-text search over the body is intentionally limited; search uses title, description, and tags.

Roadmap

Planned, without a fixed date, in rough order of urgency.

  • Schlüsselrotation über eine Envelope-Schicht. Aktuell verschlüsselt der Per-User-Schlüssel die Bundles direkt. Eine zwischengeschaltete Datenschlüssel-Hülle würde regelmäßige Rotation ermöglichen; sie kommt, wenn Rotation wirklich gebraucht wird. / Key rotation via an envelope layer. Currently the per-user key encrypts bundles directly. An intermediate data-encryption-key envelope would enable regular rotation; it arrives when rotation is actually needed.
  • Vollständiger Bundle-Export. Ein Download des gesamten Bundles als OKF-Archiv. / Full bundle export. A download of the entire bundle as an OKF archive.
  • Skalierung der semantischen Suche. Die aktuelle flache Kosinus-Suche trägt einige Tausend Konzepte je Bundle. Für sehr große Bundles ist ein Näherungsindex (ANN) vorgesehen. / Scaling semantic search. The current flat cosine scan handles a few thousand concepts per bundle. For very large bundles an approximate index (ANN) is planned.
  • Anhänge als eigene Inhalte. Bilder und PDFs als eigenständige, referenzierbare OKF-Materialien. / Attachments as first-class content. Images and PDFs as standalone, referenceable OKF materials.

An optional client-side encryption model – the server sees only ciphertext – remains a conceivable but currently unplanned direction. It would be a different trust model and a different product.

The standard underneath

The format evolves separately from the Hub. The open OKF base is a draft (upstream v0.1) in the Google Cloud Platform repository; the v0.2 profile with the trust layer is this project's extension. How changes to the standard are proposed and adopted is on the governance page.

Report something

Bugs and requests go through the feedback field in the Hub's sidebar or by email. For the standard itself, the upstream repository is the right place.

Funktionsstand und offene Punkte nach dem realen Code dieses Projekts (Stand 2. August 2026). Roadmap-Punkte sind aus dokumentierten TODOs abgeleitet, ohne zugesagten Termin. / Feature state and open points per this project's real code. Roadmap items are derived from documented TODOs, without a committed date.