Skip to content

# Arkon Release Notes — Version v0.9.0 (Big Update)

Choose a tag to compare

View all tags
@nduckmink nduckmink released this 01 Jun 09:39
· 9 commits to main since this release
v0.9.0
a3b03b6

Welcome to the release notes for Arkon v0.9.0. This release represents a significant architectural simplification and a major step forward in user experience polish:

  • Workspace (Projects) Silo Elimination: The legacy "Project" layer has been fully removed, consolidating our data and security boundaries entirely under the Organization Realm (Global vs. Department-scoped).
  • Dynamic Role-Based Landing Page: Eliminated laggy client-side redirect routing. The homepage / now dynamically renders either the System Statistics Dashboard (for Admins) or the Wiki Index Page (for standard employees) directly during the rendering cycle.
  • Unified Knowledge Wiki UX: Added clickable status badges, an independently scrollable dual-sidebar listing pages and source documents side-by-side, clickable document titles, and new quick view/download tools.

🚀 Key Features & UX Improvements

1. Dynamic Role-Based Landing Page (Zero-Redirects)

Instead of relying on slow client-side redirect paths (router.replace) which cause screen flicker and lag, the root endpoint / now inspects the user identity and dynamically loads the target layout in a single high-performance render:

  • System Admins: Land instantly on the System Statistics & Diagnostics Dashboard at / to monitor knowledge coverage, pending drafts, Linter diagnostics, and active MCP calls.
  • Standard Employees: Land instantly on the Knowledge Wiki Homepage at / to start reading right away.
  • Smart Active Navigation: The sidebar automatically highlights the Wiki menu item as active when a standard user lands on /, maintaining navigation layout continuity.

2. Dual Page & Source Sidebar Split

To support fast references, the Knowledge Wiki sidebar now displays both pages and ingested documents in a split independently scrollable format:

  • PAGES Section: Displays the hierarchical wiki page tree under the active scope.
  • SOURCES Section: Displays a collapsible, scrollable list of ready-to-use documents ingested into the knowledge base, complete with specific file-type icons.
  • Clicking any source document instantly opens its unified read-only wiki source sheet side-by-side.

3. Interactive Wiki Lifecycle Management

The Wiki Status Badge displayed on wiki page headers is no longer static. Editors and Admins can now transition wiki pages across their lifecycle directly from the UI:

  • Status Dropdown: Click on the header status badge to trigger a dropdown selector.
  • Lifecycle Phases: Select between seed 🌱, developing 🛠️, mature 🌳, or evergreen ❄️.
  • PATCH Endpoint: Powered by a clean, secure @router.patch("/wiki/pages/{slug}/status") backend endpoint.

4. Enriched Knowledge Base Actions

Ingested documents inside the Knowledge Base table now feature highly interactive paths:

  • Clickable Document Titles: The file names are now links that navigate directly to their generated wiki source view.
  • View Document: Instantly jump to the read-only wiki page using the "View" action.
  • Direct Download: Trigger a direct download of the processed document using a new "Download" action linked to the backend cloud-storage URL.

🛠️ Architectural & Backend Simplifications

1. Database Purification

We dropped three obsolete database tables, pruned the polymophic scope configurations, and permanently removed project scopes:

  • Tables Dropped: project_sources, project_members, and projects.
  • Alembic Migration (53ddb764523d): Successfully drops tables and permanently purges any wiki page, draft, branch, skill, or source row where scope_type = 'project' during upgrade.
  • Polymorphic Scope Consolidation: Supported scope_type values are strictly consolidated to "global" and "department".

2. Streamlined Permission Engine

Authorization checks have been greatly simplified by removing the "Workspace Realm":

  • Deleted can_access_workspace, get_workspace_role, and workspace_role_can methods in permission_engine.py.
  • Stripped project ID maps, source maps, and roles from the mcp_auth_service.py verification tokens, reducing payload sizes.
  • Streamlined draft reviewer notifications in notification_service.py to route to global reviewers (Admins and Knowledge Managers) only.

⚠️ Breaking Changes & Cleanups

1. Route Deprecations & File Deletions

  • Removed Route: /admin/statistics has been completely deleted. System statistics are now hosted exclusively under / for Admins.
  • Removed Routers: Backend /api/projects/* endpoints have been removed.
  • Asset Purge: Old /workspaces folders, /projects portal page, and the frontend /components/projects widgets directory have been permanently deleted from the codebase.

2. Database Data Purge

All existing data assigned to project scopes is permanently deleted. If you are upgrading from older version in a production environment, please back up any critical pages under project scopes and recreate them as Department or Global resources prior to running migrations.

📈 System Metrics & Status

  • Backend Tests: 50 passed in 2.69s (100% pass rate).
  • TypeScript Static Verification: tsc --noEmit completed successfully with zero errors.
Assets 2
Loading