Skip to content

Project Roadmap

As of March 7, 2026

Design Intent and Current State

Knowledge Platform is intended to be a local-first, graph-first desktop host where modules define domain semantics (graph types), service workflows, and UI projections without hard-wiring module code into the app shell.

Current repository state:

  • v0.1.0 alpha with one bundled module (outline).
  • Config-driven module loading is in place (entry points + modules.yaml support).
  • Core layers are implemented: graph engine, type registry, services, SQLite persistence, and PySide6 UI shell.
  • Workspaces persist to local SQLite files and can be reopened from the UI.
  • Automated validation is strong for this stage: 104 tests passed locally on March 7, 2026 (./.venv/bin/pytest tests/unit tests/integration --no-cov).

Known gaps that shape the roadmap:

  • Startup session restore and smoother workspace/document reopening.
  • Undo/redo and richer outline UX interactions.
  • Export/import, search, cross-graph navigation, and multiple projections per module.
  • A second module to fully validate the plugin host architecture against a different graph shape.

Roadmap Summary

The roadmap is focused on moving from a solid single-module alpha into a reusable multi-module platform:

  1. Improve day-to-day usability for the current Outline workflow.
  2. Add portability and interoperability (import/export and history).
  3. Validate platform extensibility with additional modules and projection types.
  4. Keep the architecture portable for a future cross-platform implementation target.

Recent Changes (Ordered by Date)

2026-02-27

  • Landed plugin-host improvements (PR #4): module configuration, loader, registry updates, and expanded module tests.
  • Completed first-pass comprehensive docs and then refined MkDocs structure/navigation for root-level doc workflows.
  • Migrated docs theme/tooling to zensical and fixed Mermaid rendering/docs integration.
  • Updated architecture/design documentation and diagrams to match the plugin-driven direction.

2026-02-26

  • Established initial platform architecture: core graph model, services, persistence, UI shell, and Outline module.
  • Added broad unit/integration coverage and raised coverage quality (commit notes indicate 96% at that point).
  • Bootstrapped repository baseline with packaging and test/docs scaffolding.

Milestones and Planned Items

Milestone Focus Planned Items
Milestone 1 Workspace Session Polish Persist last-opened workspace, add startup open/create chooser, persist last-opened document per module
Milestone 2 Outline UX Polish Drag-and-drop reordering, keyboard shortcuts, inline title editing, undo/redo
Milestone 3 Export and Import Export to Markdown/plain text/HTML, import Markdown into outline graphs
Milestone 4 Second Module Validation Ship a second independently loaded module (e.g. Kanban/concept map) via install + config only
Milestone 5 Search and Cross-Graph Navigation Workspace search across title/content, backlink navigation
Milestone 6 Version History Expose entity versions, graph change log, diff and point-in-time restore
Milestone 7 Multiple Projections per Module Support multiple projections per module and projection switcher in module UI
Milestone 8 Cross-Platform Target Define portable on-disk format shared between Python implementation and future Swift target

How to Update This Roadmap

To keep this page aligned with actual delivery history:

  1. Pull recent commits with dates, for example: git log --date=short --pretty=format:'%h|%ad|%s' -n 30.
  2. Update Recent Changes by grouping notable commits under date headers in descending order.
  3. Keep change bullets factual and landed-only (no planned work in this section).
  4. Move completed milestone items out of the milestone table into Recent Changes summaries.
  5. Update the “As of ...” date at the top whenever this page is revised.