2026 03 01_complete_feature_inventory - mark-ik/graphshell GitHub Wiki

Complete Feature Inventory

Date: 2026-03-01 Status: Living document β€” synthesized from all design docs and archive checkpoints Scope: All features for Graphshell, Verso, and Verse: implemented, planned, and speculative Sources: All files in design_docs/ including archive_docs/, verse_docs/, research/, implementation_strategy/

Status codes:

  • βœ… Done β€” Implemented and merged
  • πŸ”¨ Active β€” In progress (current milestone)
  • πŸ“‹ Planned β€” Specified, on roadmap, not yet started
  • πŸ”­ Speculative β€” Aspirational, research-backed, no committed schedule
  • πŸ—„οΈ Archived β€” Superseded or deferred indefinitely

Implementation Closure Register

This section exists to prevent one recurring docs error: a feature having a landed canonical spec being misread as "implemented."

Use it only for spec-landed, runtime-pending slices that are likely to be misreported as complete.

Slice Spec status Runtime status Closure needed
Faceted filter surface Canonical spec landed (canvas/faceted_filter_surface_spec.md) Not yet implemented Reducer-owned filter execution, UxTree surface, omnibar/palette parity, diagnostics, scenario coverage
Facet pane routing Canonical spec landed (canvas/facet_pane_routing_spec.md) Not yet implemented Facet-rail context binding, pane target resolution, blocked-route handling, focus return, scenario coverage
Temporal navigation / replay Canonical subsystem contracts landed (subsystem_history/SUBSYSTEM_HISTORY.md, subsystem_history/edge_traversal_spec.md) Not yet implemented Detached preview controller, no-side-effect gates, return-to-present restoration, replay diagnostics/tests
History diagnostics and health summary Canonical subsystem contracts landed (subsystem_history/SUBSYSTEM_HISTORY.md, subsystem_diagnostics/SUBSYSTEM_DIAGNOSTICS.md) Not yet implemented history.* channel wiring, subsystem health summary surface, CI/watchdog coverage
Wry native overlay lifecycle Canonical target spec landed (viewer/wry_integration_spec.md) Scaffold only End-to-end attach/hide/destroy lifecycle, overlay sync policy, diagnostics, platform validation

GRAPHSHELL β€” Core Spatial Browser

Graph Domain & Canvas Surface

Feature Status Notes / Source
Force-directed node graph canvas βœ… Done egui_graphs physics simulation
Node creation, deletion, repositioning βœ… Done GraphIntent reducer
User-grouped edges (explicit connections) βœ… Done EdgeKind::UserGrouped
Traversal-derived edges βœ… Done EdgeKind::TraversalDerived; edges accumulate directed traversal events
Multi-edge display with traversal styling βœ… Done Dominant direction computed from traversal counts
Edge dominant-direction visual arrows βœ… Done Behavioral tendency display, not structural type
Graph persistence (WAL-based) βœ… Done Append-only intent log; AES-256-GCM at rest
Graph serialization to JSON βœ… Done Frame snapshots
Zoom and pan controls βœ… Done canvas/graph_node_edge_interaction_spec.md
Node selection (single) βœ… Done canvas/graph_node_edge_interaction_spec.md
Multi-select βœ… Done UpdateSelection, SelectAll
Lasso selection βœ… Done canvas/graph_node_edge_interaction_spec.md
Lasso modifier modes (replace / add / toggle) πŸ“‹ Planned Spec in 2026-03-01_ux_migration_design_spec.md Β§5.1
Connected-node selection πŸ“‹ Planned Select all nodes reachable from selection
Ghost Nodes (deleted nodes rendered as faint topology-preserving placeholders) πŸ“‹ Planned User-facing term; backed by NodeLifecycle::Tombstone; faint dashed outline, ghost edges, "Show Deleted" toggle; 2026-02-24_visual_tombstones_research.md
Node pinning (lock position) πŸ“‹ Planned L key; I/U for multi-pin
Node duplicate πŸ“‹ Planned Ctrl+D
Group-move (move selection together) πŸ“‹ Planned Drag selection
Node audit log (create/modify/delete history) πŸ“‹ Planned Per-node event history
Edge walk (Tab traversal along edges) πŸ“‹ Planned Tab/Shift+Tab for edge-by-edge navigation
Bidirectional edge creation πŸ“‹ Planned Shift+G
Self-loop edge exclusion from physics βœ… Done Regression test coverage
Semantic Gravity (tag-based clustering) πŸ“‹ Planned Related nodes attracted by shared tags
Frame-affinity organizational regions (legacy alias: Magnetic Zones) πŸ”­ Speculative Region-based spatial grouping interpreted through graph-first frame semantics
Ghost Node restoration πŸ“‹ Planned Command Palette contextual mode (or right-click contextual invocation) β†’ restore or permanently delete; viewer/visual_tombstones_spec.md
Undo / redo πŸ”­ Speculative Command-based journaling; 2026-02-19_undo_redo_plan.md (archived)
Lasso zoning (region-based organization) πŸ“‹ Planned Persistent lasso regions
Origin-grouped process organization πŸ“‹ Planned Auto-grouping by domain/origin

Node Lifecycle

Feature Status Notes
Active β†’ Warm β†’ Cold β†’ Tombstone lifecycle βœ… Done Four-state model; viewer/node_lifecycle_and_runtime_reconcile_spec.md
LRU warm-cache eviction under memory pressure βœ… Done lifecycle_reconcile.rs
Memory pressure levels (Normal / Warning / Critical) βœ… Done viewer/node_lifecycle_and_runtime_reconcile_spec.md
RuntimeBlocked state with retry scheduling βœ… Done MarkRuntimeBlocked / ClearRuntimeBlocked; viewer/node_lifecycle_and_runtime_reconcile_spec.md
Recovery action affordance for blocked nodes πŸ”¨ Active UX contract S5 (SUBSYSTEM_UX_SEMANTICS.md)
Per-tile GPU memory budget with graceful degradation πŸ“‹ Planned PLANNING_REGISTER.md Β§0.10

Physics & Layout

Feature Status Notes
Graphshell-owned physics engine βœ… Done Migrated from egui_graphs
Physics presets: Compact / Spread / Tight / Star / Frozen βœ… Done PhysicsProfileRegistry
Physics parameter tuning (c_repulse, c_attract, k_scale, max_step, damping) βœ… Done canvas/layout_behaviors_and_physics_spec.md
Physics toggle (T), reheat (R), preset cycle (Shift+T) πŸ“‹ Planned Keybindings spec
Seeded RNG for deterministic layout (test mode) πŸ“‹ Planned SeedRng UxBridgeCommand
Force-directed layout (default) βœ… Done canvas/layout_behaviors_and_physics_spec.md
Grid layout πŸ“‹ Planned LayoutRegistry entry
Hierarchical layout πŸ“‹ Planned
Radial-from-focus layout πŸ“‹ Planned
Community-clustered layout πŸ“‹ Planned
Layout mode switching (Canonical ↔ Divergent) βœ… Done GraphLayoutMode; SetViewLayoutMode intent
LocalSimulation for Divergent views βœ… Done Independent physics per Divergent pane
Camera fit / smart fit βœ… Done RequestFitToScreen
Target-locked / pointer-relative zoom πŸ“‹ Planned 2026-03-01_ux_migration_design_spec.md Β§5.2
Zoom to node πŸ“‹ Planned
2D ↔ 3D hotswitch (ViewDimension) 🟑 Partial SetViewDimension and control-surface wiring now exist; projection/render/degradation lane remains deferred
3D canvas rendering variants (full 3D, stacked, soft 3D) πŸ”­ Speculative
Level-of-Detail (LOD) rendering: Point / Compact / Expanded πŸ“‹ Planned Zoom-level-driven semantic zoom using the canonical 3-tier policy (Point < 0.55, Compact 0.55 .. < 1.10, Expanded >= 1.10) from canvas/graph_node_edge_interaction_spec.md Β§4.8
Semantic fisheye / Degree of Interest (DOI) visualization πŸ”­ Speculative
SketchLay: user-guided layout via sketch constraints πŸ”­ Speculative Relative placement, alignment, fixed anchors; research in UX migration spec
Readability-driven layout adaptation πŸ“‹ Planned Haleem et al. readability metrics; condition-based suggestions
Edge bundling (high crossing count) πŸ“‹ Planned Readability adaptation trigger
Constraint-based layouts πŸ”­ Speculative 2026-02-19_layout_advanced_plan.md
Progressive lenses (semantic zoom context layers) πŸ”­ Speculative
Physics extensibility (custom force models via mods) πŸ“‹ Planned PhysicsProfileRegistry mod extension

Workbench & Tile Tree

Feature Status Notes
egui_tiles tile tree (Tab Group, Split, Grid) βœ… Done workbench/workbench_frame_tile_interaction_spec.md
Graph View pane (TileKind::Graph) βœ… Done workbench/workbench_frame_tile_interaction_spec.md
Node Pane (TileKind::Node) βœ… Done workbench/workbench_frame_tile_interaction_spec.md
Tool Pane (TileKind::Tool) βœ… Done Diagnostics today; history/settings/accessibility panes planned
Tiled Pane / Docked Pane presentation modes βœ… Done workbench/pane_presentation_and_locking_spec.md
PaneLock (Unlocked / PositionLocked / FullyLocked) βœ… Done workbench/pane_presentation_and_locking_spec.md
Tile drag-and-drop, split, reorder βœ… Done workbench/workbench_frame_tile_interaction_spec.md
FrameTabSemantics persistence βœ… Done Persisted frame bundles now carry optional semantic tab metadata with load-time repair, explicit repair/resave command plumbing, typed repair reports with aggregated warning summaries, saved pane-rest bundles can rewrap into visual tabs on restore, and a runtime semantic overlay now powers live restore/collapse intents plus collapsed-group save preservation; the shared desktop/workbench/semantic_tabs.rs query surface owns overlay-first omnibar/tab-affordance/ordering lookups, tile_grouping remains structural-only post-render reconciliation, and simplify-safe semantic reapply is covered through post-render reconciliation plus save/restore roundtrip tests
Frame (persisted Tile Tree branch) βœ… Done workbench/workbench_frame_tile_interaction_spec.md
Frame Snapshot (FrameLayout + FrameManifest + FrameMetadata) βœ… Done workbench/workbench_frame_tile_interaction_spec.md
Frame switching / workbar βœ… Done workbench/workbench_frame_tile_interaction_spec.md
Frame creation from selection (Ctrl+Shift+N) πŸ“‹ Planned
Frame management keybindings (Ctrl+Tab, Ctrl+W, Ctrl+Shift+H/V) πŸ“‹ Planned
Graph-first frame semantics πŸ“‹ Planned Frame as graph-level entity; opening node creates view, not frame
Multiple graph views per workbench βœ… Done Multiple GraphViewId panes
Multiple workbenches (Ctrl+Alt+N, Ctrl+Alt+Tab) πŸ“‹ Planned Workbench switching; merge graphs
Canonical vs Divergent multi-view βœ… Done GraphLayoutMode
Camera sync between canonical views πŸ“‹ Planned
Last-focused pane restoration βœ… Done workbench/pane_presentation_and_locking_spec.md; subsystem_focus/focus_and_region_navigation_spec.md
Pane-close successor focus handoff βœ… Done Regression test coverage; workbench/pane_presentation_and_locking_spec.md
WorkbenchProfile (keybindings + layout policy + mouse map) πŸ“‹ Planned Generalized under GraphshellProfile; default profile + user-created profiles in aspect_control/2026-03-02_graphshell_profile_registry_spec.md
Workflow = Lens Γ— WorkbenchProfile πŸ“‹ Planned WorkflowRegistry (future)
Semantic gap principle (explicit registry/domain boundaries) βœ… Done Architectural governance rule

Surface Composition & Rendering

Feature Status Notes
egui (Glow/OpenGL) rendering βœ… Done aspect_render/render_backend_contract_spec.md
Three-pass composition model (UI Chrome β†’ Content β†’ Overlay Affordance) πŸ”¨ Active Β§0 PLANNING_REGISTER.md; compositor_adapter.rs
CompositorAdapter (GL state isolation around Servo callbacks) πŸ”¨ Active Save/restore/scrub GL state
TileRenderMode enum (CompositedTexture / NativeOverlay / EmbeddedEgui / Placeholder) βœ… Done aspect_render/frame_assembly_and_compositor_spec.md
Overlay Affordance Policy per TileRenderMode πŸ”¨ Active Focus/hover rings correct in all modes
Focus ring visible above composited Servo content πŸ”¨ Active Z-order fix in compositor
Differential composition (skip re-render of unchanged tiles) πŸ”­ Speculative PLANNING_REGISTER.md Β§0.10
Compositor replay traces (forensic debugging) πŸ”­ Speculative
Compositor chaos mode (GL isolation validation) πŸ“‹ Planned
Multi-backend hot-swap per tile at runtime πŸ”­ Speculative
Cross-tile compositor transitions (live content during animation) πŸ”­ Speculative
Cinematic tile transitions πŸ”­ Speculative
Content-aware adaptive overlay styling πŸ”­ Speculative
Mod-hosted compositor extension passes πŸ”­ Speculative
egui β†’ wgpu custom canvas migration πŸ“‹ Planned 2026-03-01_webrender_wgpu_renderer_implementation_plan.md
WebRender wgpu renderer πŸ“‹ Planned GL β†’ wgpu migration
EGL embedder extension (hardware-accelerated backend) πŸ”­ Speculative 2026-02-17_egl_embedder_extension_plan.md (archived)

Viewer System

Feature Status Notes
ViewerRegistry (MIME β†’ viewer resolution) βœ… Done system/register/viewer_registry_spec.md
Servo-powered HTML/CSS/JS rendering βœ… Done Via Verso mod
HTTP / HTTPS protocol handling βœ… Done Via Verso mod
File protocol handling βœ… Done system/register/protocol_registry_spec.md
Placeholder viewer (fallback) βœ… Done TileRenderMode::Placeholder
Viewer capability declarations per surface βœ… Done AccessibilityCapabilities; ux_semantics_capabilities
Viewer attachment lifecycle βœ… Done MapWebviewToNode, UnmapWebview
WebView crash handling βœ… Done WebViewCrashed intent; viewer/webview_lifecycle_and_crash_recovery_spec.md
Wry native window integration πŸ“‹ Planned NativeOverlay render mode
PDF viewer πŸ“‹ Planned Non-web native viewer
CSV / data viewer πŸ“‹ Planned
Settings viewer (EmbeddedEgui) πŸ“‹ Planned
Markdown / plaintext viewer πŸ“‹ Planned Core Seed viewer
Filesystem ingest (filesβ†’nodes, foldersβ†’frames, folder-tag links) πŸ“‹ Planned Blocked behind common document-viewer readiness; see viewer/2026-03-02_filesystem_ingest_graph_mapping_plan.md
Unified source mapping (local/network/web domain-directory auto-map) πŸ“‹ Planned Depends on filesystem ingest readiness; includes configurable depth/granularity controls; see viewer/2026-03-02_unified_source_directory_mapping_plan.md
Clipping tool (DOM element extraction to node) πŸ“‹ Planned Web page excerpt β†’ new node
Interactive HTML export with graph embedding πŸ”­ Speculative
DOM inspection / element picker πŸ“‹ Planned
WARC archive export / import πŸ“‹ Planned Forensic fidelity web archiving
Bookmarks import (browser) πŸ“‹ Planned
Browsing history import πŸ“‹ Planned
Data portability (cross-browser graph import/export) πŸ“‹ Planned
Multiple viewer backend hot-swap at runtime πŸ”­ Speculative

Omnibar & Control Surfaces

Feature Status Notes
Command Palette shell (search + contextual modes) πŸ”¨ Active Canonical authority surface; search-first mode + contextual modes (aspect_command/command_surface_interaction_spec.md)
Radial Palette Mode (2-tier categoryβ†’option rings) πŸ“‹ Planned Contextual command-palette mode with periphery rails, hover expansion, bounded radial labels
Omnibar (Ctrl+L; URL + graph search + web search) πŸ”¨ Active Slash-commands planned
Context Palette Mode (2-tier strip/list) πŸ“‹ Planned Tier-1 horizontal category strip + Tier-2 vertical option list; shares model with Radial Palette Mode
ActionRegistry routing for all control surfaces βœ… Done No hardcoded command enums
Radial palette geometry/overflow/label contract πŸ“‹ Planned Tiered ring non-overlap, hover-scaling, bounded radial-label behavior
Radial marking menus (muscle memory gestures) πŸ”­ Speculative Faster selection via gesture direction
Command palette slot ordering (context-sensitive) πŸ“‹ Planned Most-relevant commands first
Omnibar slash-commands πŸ“‹ Planned e.g. /tag, /frame, /physics
Global keybinding remapping (WorkbenchProfile) πŸ“‹ Planned
Chord and sequence keybindings βœ… Done Input context stack
Gamepad full support (D-pad / stick navigation) βœ… Done Radial Palette Mode default input

Input Event Architecture

Feature Status Notes
Three-phase event dispatch (capture β†’ at-target β†’ bubble) πŸ“‹ Planned DOM Event Model pattern; 2026-03-01_ux_migration_design_spec.md Β§7
Event propagation control (stopPropagation, preventDefault) πŸ“‹ Planned
Modal isolation (events consumed by modal, not leaked) πŸ“‹ Planned Modal at Workbench level
Input context stack and routing βœ… Done aspect_input/input_interaction_spec.md
InputRegistry keybinding resolution βœ… Done system/register/input_registry_spec.md

History & Traversal

Feature Status Notes
Traversal recording (all navigation events) βœ… Done Edges accumulate directed traversal events
Traversal types: link click, back/forward, address bar, programmatic βœ… Done NavigationTrigger
Edge metrics: total traversals, last time, dominant direction βœ… Done subsystem_history/edge_traversal_spec.md
Traversal archive (rolling window + overflow to disk) βœ… Done subsystem_history/edge_traversal_spec.md
WAL-based traversal logging βœ… Done subsystem_history/edge_traversal_spec.md
History Manager pane (Timeline + Dissolved tabs) βœ… Done Canonical tool pane; legacy standalone nav history panel retired; see subsystem_history/2026-02-20_edge_traversal_impl_plan.md
Timeline visualization of traversals βœ… Done Recent traversal timeline is active in History Manager
Temporal navigation / time-travel preview βœ… Done Detached replay graph + preview isolation + History Manager preview controls
Traversal scrubber (timeline replay) βœ… Done History Manager preview slider / replay cursor surface
Graph state snapshots for recovery βœ… Done Preview baseline snapshot + replay-to-timestamp recovery path
"Return to present" from temporal navigation βœ… Done Explicit preview exit restores live graph snapshot
Back / forward within node pane βœ… Done WebView history
Intra-node navigation separate from edge history βœ… Done Node history vs graph edge traversals
Stop / cancel in-progress page load πŸ“‹ Planned Focused viewer control; distinct from reload
Find in page (within rendered content) πŸ“‹ Planned Focused viewer control; distinct from graph search/filter
Per-webview content zoom πŸ“‹ Planned Focused viewer control; distinct from graph camera zoom
Audio/media playing indicator + tile mute πŸ“‹ Planned Focused viewer/Navigator chrome state
Downloads indicator / manager entry πŸ“‹ Planned Downloads settings page exists; shared-chrome indicator/manager contract pending

Knowledge Capture & Tagging

Feature Status Notes
Node tags (user-applied labels) βœ… Done TagNode / UntagNode intents
KnowledgeRegistry (UDC semantic tagging) βœ… Done Universal Decimal Classification
Node badges (compact metadata overlay) πŸ“‹ Planned LOD-driven display
Faceted object model (PMEST: Personality, Matter, Energy, Space, Time) πŸ“‹ Planned NodeFacets struct; 2026-03-01_ux_migration_design_spec.md Β§4
Faceted filter surface (Lens component) πŸ“‹ Planned Canonical spec landed in canvas/faceted_filter_surface_spec.md; runtime implementation pending
Facet rail navigation (Enter-to-pane routing) πŸ“‹ Planned Canonical spec landed in canvas/facet_pane_routing_spec.md; runtime implementation pending
Auto-grouping by relevance / time / domain πŸ“‹ Planned
"Desire paths" semantic suggestions πŸ”­ Speculative Traversal patterns surface implicit connections
Smart filtering and saved views πŸ“‹ Planned
Faceted search (multi-axis queries) πŸ“‹ Planned Replaces flat full-text search
Full-text search πŸ“‹ Planned Local tantivy index
Thumbnails / favicons for nodes πŸ“‹ Planned 2026-02-11_thumbnails_favicons_plan.md
Node thumbnail capture pipeline βœ… Done thumbnail_pipeline.rs
Readability extraction (text, UDC tags from page) πŸ“‹ Planned Auto-tag on open
Report generation (signed browsing record) πŸ“‹ Planned Verso/Verse integration

Lens System

Feature Status Notes
Lens = Topology + Layout + Physics + Theme βœ… Done LensConfig
LensCompositor (resolves Lens from domain registries) βœ… Done system/register/lens_compositor_spec.md
File Explorer Lens preset πŸ“‹ Planned DAG topology, tree layout, solid physics
Brainstorm Lens preset πŸ“‹ Planned Free topology, force-directed, liquid physics
States-of-matter physics presets (Liquid / Gas / Solid) πŸ“‹ Planned Semantic physics metaphor
Lens switching (per-view) βœ… Done SetViewLensId intent + per-view policy intents
Progressive lens composition πŸ”­ Speculative

Diagnostics Subsystem

Feature Status Notes
DiagnosticsRegistry (channel schema, severity, invariants) βœ… Done system/register/diagnostics_registry_spec.md
ChannelSeverity (Error / Warn / Info) βœ… Done system/register/diagnostics_registry_spec.md
Event ring (VecDeque) βœ… Done subsystem_diagnostics/diagnostics_observability_and_harness_spec.md
Diagnostic Inspector pane βœ… Done Engine, Compositor, Intents views
Invariant watchdog (started β†’ succeeded/failed coverage) πŸ“‹ Planned Thin coverage; needs expansion
AnalyzerRegistry (continuous stream processors) πŸ“‹ Planned
TestHarness in-pane runner (diagnostics_tests feature) πŸ“‹ Planned
Health summary (per-subsystem green/yellow/red) πŸ“‹ Planned
Invariant graph (DAG of pending/healthy/violated watchdogs) πŸ“‹ Planned
Violations view in inspector pane πŸ“‹ Planned
Channel config editor (live toggle, sample rate) πŸ“‹ Planned
Self-check channels (diagnostics.selfcheck.*) πŸ“‹ Planned Orphan detection, phase completeness
Compositor snapshot diagnostics βœ… Done subsystem_diagnostics/diagnostics_observability_and_harness_spec.md
Intent β†’ frame correlation timeline πŸ“‹ Planned

UX Semantics Subsystem (New)

Feature Status Notes
UxTree (per-frame semantic projection of native UI) πŸ“‹ Planned SUBSYSTEM_UX_SEMANTICS.md
UxNodeId (stable path-based identifiers) πŸ“‹ Planned
UxProbeSet (structural invariant checks, every frame) πŸ“‹ Planned S/N/M invariant series
UxBridge (WebDriver custom command extensions) πŸ“‹ Planned GetUxSnapshot, InvokeUxAction, etc.
UxDriver (test-side harness client) πŸ“‹ Planned
UxScenario runner (YAML scenario files) πŸ“‹ Planned
UxSnapshot / UxBaseline / UxDiff (regression CI) πŸ“‹ Planned
AccessKit bridge consuming UxTree output πŸ“‹ Planned Phase 6

Accessibility Subsystem

Feature Status Notes
Accessibility Inspector scaffold βœ… Done Bridge health + diagnostics pane
AccessKit integration (egui bridge) πŸ”¨ Active Version mismatch (0.24 vs 0.21) blocking injection
WebView accessibility tree bridge πŸ”¨ Active Forwarding in place; injection degraded
Graph Reader (virtual accessibility tree for graph canvas) πŸ“‹ Planned GraphAccessKitAdapter; Room Mode + Map Mode
Room Mode navigation (focused node as room with edge-doors) πŸ“‹ Planned Depth-1 local context
Map Mode navigation (full graph linearization) πŸ“‹ Planned Semantic hierarchy: Cluster β†’ Hub β†’ Leaf
Spatial D-pad navigation (arrow keys β†’ nearest node by direction) πŸ“‹ Planned
F6 region cycle (Toolbar β†’ Graph β†’ Active Pane) βœ… Done Regression test coverage
Sonification (spatial audio for graph state) πŸ”­ Speculative rodio + fundsp; panning by X coord, pitch by degree
Screen reader smoke tests (NVDA/Orca) πŸ“‹ Planned Milestone gate requirement
High-contrast theme πŸ“‹ Planned
Focus Subsystem (deterministic focus routing) πŸ”¨ Active

Security & Storage Subsystems

Feature Status Notes
Ed25519 keypair generation and OS keychain storage πŸ“‹ Planned Verse Tier 1 prerequisite
Trust store (IdentityRegistry) πŸ“‹ Planned
Access control scoping per workspace πŸ“‹ Planned
Persistence (WAL-based) βœ… Done subsystem_storage/storage_and_persistence_integrity_spec.md
Frame save / load βœ… Done subsystem_storage/storage_and_persistence_integrity_spec.md
Workspace manifest persistence βœ… Done subsystem_storage/storage_and_persistence_integrity_spec.md
AES-256-GCM at-rest encryption (SyncLog) πŸ“‹ Planned Verse Tier 1
Single-write-path invariant βœ… Done subsystem_storage/storage_and_persistence_integrity_spec.md
Data portability (JSON graph snapshots) βœ… Done subsystem_storage/storage_and_persistence_integrity_spec.md

Mods Subsystem

Feature Status Notes
ModRegistry (native mod loading via inventory::submit!) βœ… Done system/register/mod_registry_spec.md
WASM mod loading (extism sandbox) πŸ“‹ Planned
ModManifest (provides + requires declaration) βœ… Done subsystem_mods/SUBSYSTEM_MODS.md
Core Seed (app functional with zero mods) βœ… Done Architectural invariant
Mod-contributed physics profiles πŸ“‹ Planned
Mod-contributed viewers πŸ“‹ Planned
Mod-contributed canvas regions / topology policies πŸ“‹ Planned
Mod-contributed compositor passes πŸ”­ Speculative
WASM mod ABI and sandboxing spec πŸ“‹ Planned 2026-02-24_wasm_mod_abi_research.md

Agent System

Feature Status Notes
AgentRegistry (autonomous background agents) βœ… Done Registry defined
Agent-derived edges (recommendation edges) πŸ“‹ Planned EdgeKind::AgentDerived
Agent confidence scoring πŸ“‹ Planned
Agent edge time-decay πŸ“‹ Planned
Agent edge promotion to UserGrouped on traversal πŸ“‹ Planned
Multi-model cooperative execution πŸ”­ Speculative
Tiered AI orchestration (local tiny β†’ retrieval β†’ large-model escalation) πŸ”­ Speculative
STM/LTM memory architecture for agents πŸ”­ Speculative 2026-02-26_intelligence_memory_architecture_stm_ltm_engrams_plan.md

Test Infrastructure

Feature Status Notes
[[test]] scenarios binary βœ… Done tests/scenarios/main.rs
CI workflow for scenarios binary βœ… Done .github/
TestRegistry (app factory + diagnostics assertion surface) βœ… Done subsystem_diagnostics/diagnostics_observability_and_harness_spec.md
OnceLock capability test-safety (T1) πŸ“‹ Planned 2026-02-26_test_infrastructure_improvement_plan.md
Test binary split (test-utils feature flag) (T2) πŸ“‹ Planned
Deterministic focus ownership tests βœ… Done subsystem_focus/focus_and_region_navigation_spec.md
F6 focus-cycle regression coverage βœ… Done subsystem_focus/focus_and_region_navigation_spec.md
Rolling traversal buffer bounds tests βœ… Done subsystem_history/edge_traversal_spec.md
Compositor chaos mode tests πŸ“‹ Planned
Lasso correctness regression tests βœ… Done canvas/graph_node_edge_interaction_spec.md
UxScenario suite (open_node, focus_cycle, modal_dismiss, facet filter/routing/focus-return) πŸ“‹ Planned Scenario YAML fixtures are now authored under tests/scenarios/ux/; runner closure still pending
Headless scenario execution (CI) πŸ“‹ Planned GRAPHSHELL_HEADLESS=1

iOS / Mobile

Feature Status Notes
iOS port πŸ—„οΈ Archived 2026-02-19_ios_port_plan.md; no committed schedule

VERSO β€” Web Viewer + Local Collaboration Mod

Verso is the native mod providing web rendering (Servo/Wry) and local peer-to-peer collaboration (iroh-based bilateral sync). Two capabilities, one mod identity.

Web Rendering (Servo)

Feature Status Notes
Servo integration as web rendering engine βœ… Done viewer/viewer_presentation_and_fallback_spec.md
Servo WebRender GL output βœ… Done aspect_render/render_backend_contract_spec.md
Servo β†’ Graphshell compositor callback bridge βœ… Done render_to_parent
WebView lifecycle management βœ… Done create, destroy, focus, blur
Protocol handlers: http, https, file βœ… Done Via ProtocolRegistry
JavaScript execution context βœ… Done viewer/viewer_presentation_and_fallback_spec.md
Cookie and session management βœ… Done viewer/viewer_presentation_and_fallback_spec.md
CSS / font rendering βœ… Done viewer/viewer_presentation_and_fallback_spec.md
DOM inspection capabilities πŸ“‹ Planned
WebDriver integration (existing) βœ… Done webdriver.rs
Wry native window integration (NativeOverlay mode) πŸ“‹ Planned Cross-platform native viewers
WebRender β†’ wgpu renderer migration πŸ“‹ Planned 2026-03-01_webrender_wgpu_renderer_implementation_plan.md
Multiple viewer backend hot-swap πŸ”­ Speculative
Verso ModManifest declaration πŸ“‹ Planned Formal provides / requires
Verso Ed25519 identity (shared with collaboration layer) πŸ“‹ Planned One keypair for both capabilities

Local Collaboration (iroh Bilateral Sync)

This is the local P2P layer β€” private, device-to-device sync. It lives inside Verso, not Verse. Verse is the public community network (Tier 2, long-horizon).

Feature Status Notes
Ed25519 keypair (shared identity for web and sync) πŸ“‹ Planned OS keychain; keyring crate
Trust store (TrustedPeer records: NodeId + role + grants) πŸ“‹ Planned IdentityRegistry
iroh QUIC transport πŸ“‹ Planned Magic Sockets, NAT traversal
SyncWorker (ControlPanel-supervised tokio task) πŸ“‹ Planned Accept loop, peer connections, intent pipeline
SyncUnit wire format (rkyv + zstd) πŸ“‹ Planned Delta batches with VersionVector
Version vector (per-peer monotonic sequence numbers) πŸ“‹ Planned Causal ordering, conflict detection
Delta sync (send only changed intents since last contact) πŸ“‹ Planned
Conflict resolution: Last-Write-Wins (metadata) πŸ“‹ Planned
Conflict resolution: Additive (edges) πŸ“‹ Planned Edges never deleted unilaterally
SyncLog (append-only local intent journal) πŸ“‹ Planned AES-256-GCM at rest
QR code pairing ceremony πŸ“‹ Planned qrcode crate
Invite link pairing (verso://pair/{NodeId}/{token}) πŸ“‹ Planned
mDNS local network discovery πŸ“‹ Planned mdns-sd crate
Workspace access grants (ReadOnly / ReadWrite) πŸ“‹ Planned Per-peer, per-workspace
Selective workspace sharing πŸ“‹ Planned Not all workspaces shared by default
Offline-first operation πŸ“‹ Planned Full functionality without peers connected
Opportunistic sync on peer connection πŸ“‹ Planned
Peer presence indicators πŸ”­ Speculative Deferred; 2026-02-25_verse_presence_plan.md
Remote cursors (ghost cursors with label + color) πŸ”­ Speculative Deferred
Remote selection highlights πŸ”­ Speculative Deferred
Follow mode (camera tracks peer viewport) πŸ”­ Speculative Deferred
Peer avatar strip (connection status) πŸ”­ Speculative Deferred
Sync status indicator in workbench πŸ“‹ Planned
Sync Panel (pane showing peer list + sync state) πŸ“‹ Planned
Conflict resolution UI (toast + manual) πŸ“‹ Planned
Noise protocol transport authentication πŸ“‹ Planned
Workspace-scoped access control πŸ“‹ Planned
Graceful degradation when peers offline πŸ“‹ Planned

VERSE β€” Public Community Network

Verse is the public, federated P2P network for community knowledge sharing. Tier 2 / long-horizon research. Distinct from Verso's local collaboration layer.

Identity & Community Infrastructure

Feature Status Notes
libp2p transport (GossipSub community swarms) πŸ”­ Speculative Q3 2026 research validation target
Same Ed25519 keypair derives libp2p PeerId (from Verso identity) πŸ”­ Speculative Identity bridge: Verso β†’ Verse
Community Manifest (signed definition, governance, visibility policy) πŸ”­ Speculative
VerseVisibility: PublicOpen / PublicWithFloor / SemiPrivate / Dark πŸ”­ Speculative
RebroadcastLevel: SilentAck β†’ ExistenceBroadcast β†’ ContentRelay β†’ Endorsement πŸ”­ Speculative
MembershipRecord (signed consent to community policy) πŸ”­ Speculative
VerseGovernance (organizer stake threshold, admin threshold) πŸ”­ Speculative
Community moderation buffer and appeals πŸ”­ Speculative

Content Addressing & Knowledge Assets

Feature Status Notes
VerseBlob (content-addressed universal format, BLAKE3 CID) πŸ”­ Speculative BlobTypes: IntentDelta, IndexSegment, Engram, Opaque
Report (signed browsing record: URL + text + UDC tags + traversal context) πŸ”­ Speculative Passive indexing unit
MediaClip (WARC-format HTTP response archive) πŸ”­ Speculative Forensic fidelity web archiving
IndexArtifact (tantivy index segment blob) πŸ”­ Speculative Federated search unit
Bitswap content retrieval πŸ”­ Speculative
Nostr signaling (bootstrap peer discovery) πŸ”­ Speculative Optional; protocol:nostr

Federated Search

Feature Status Notes
Sharded tantivy index segments πŸ”­ Speculative
Federated query model (SearchProvider nodes) πŸ”­ Speculative SearchProvider earns tokens per query
Community-sourced browsing suggestions πŸ”­ Speculative
YaCy-inspired decentralized web index πŸ”­ Speculative 2026-02-23_modern_yacy_gap_analysis.md
Faceted community search πŸ”­ Speculative

Economy & Incentives

Feature Status Notes
Proof of Access (receipt model, per-query) πŸ”­ Speculative Optional; proof_of_access_ledger_spec.md
Verse fungible tokens (utility token per community) πŸ”­ Speculative
Reputation vs token settlement πŸ”­ Speculative
Storage bounty economy πŸ”­ Speculative
CrawlBounty (curator posts bounty for external web content) πŸ”­ Speculative
Crawler role (claims and fulfills CrawlBounty requests) πŸ”­ Speculative
Validator role (spot-checks submitted IndexArtifacts) πŸ”­ Speculative
Filecoin StakeRecord integration πŸ”­ Speculative
Token-weighted governance πŸ”­ Speculative

Intelligence & Adaptation (FLora)

Feature Status Notes
Engram (portable model customization payload) πŸ”­ Speculative engram_spec.md; envelope + typed EngramMemory items
TransferProfile (engram envelope with metadata + provenance) πŸ”­ Speculative
FLora (Federated Learning on Ramified Adaptation) πŸ”­ Speculative Community-shared LoRA adapter layers
Adapter weight delta exchange πŸ”­ Speculative
Mini-adapter LoRA contribution flow πŸ”­ Speculative
Tiered AI orchestration via community adapters πŸ”­ Speculative
STM/LTM memory architecture (working context + persistent storage) πŸ”­ Speculative
Self-hosted Verse node πŸ”­ Speculative self_hosted_verse_node_spec.md
Self-hosted model customization πŸ”­ Speculative self_hosted_model_spec.md
Community knowledge skill layers πŸ”­ Speculative
ArchetypeProfile (preset model configuration) πŸ”­ Speculative

Verse Participant Roles

Role Status Notes
User (create/publish Reports) πŸ”­ Speculative
Seeder / rebroadcaster (host storage) πŸ”­ Speculative
Indexer / deduplicator πŸ”­ Speculative
Attester / validator πŸ”­ Speculative
Curator (create/govern communities) πŸ”­ Speculative
Adapter contributor (submit Engrams) πŸ”­ Speculative
Storage contributor (earn reputation) πŸ”­ Speculative
FLora consumer (use community adapters) πŸ”­ Speculative
Self-hosted node operator πŸ”­ Speculative

FEATURE COUNT SUMMARY

System βœ… Done πŸ”¨ Active πŸ“‹ Planned πŸ”­ Speculative πŸ—„οΈ Archived
Graphshell ~70 ~8 ~90 ~35 1
Verso (web) ~12 0 ~8 ~2 0
Verso (local collab / iroh) 0 0 ~20 ~6 0
Verse (public network) 0 0 0 ~45 0
Total ~82 ~8 ~118 ~88 1

NOTES ON BRANDING

  • Verso owns both the Servo/Wry web viewer and the local (iroh-based) bilateral device sync layer. One mod, two capability families, one Ed25519 identity. The verso://pair/ URL scheme signals this ownership.
  • Verse is solely the public community network (Tier 2, long-horizon). It builds on the same Ed25519 keypair as Verso (identity bridge) but is a separate network layer with a separate scope, timeline, and governance model.
  • The name alignment: Verso (local, private, fast) and Verse (public, federated, community) form a natural pair β€” private collaboration vs public network.

ISSUE CATEGORIZATION FOR WGPU MIGRATION READINESS

This section maps open GitHub issues into migration timing buckets aligned with:

  • 2026-03-01_ux_migration_design_spec.md
  • subsystem_ux_semantics/2026-03-01_ux_execution_control_plane.md
  • 2026-03-01_ux_migration_feature_spec_coverage_matrix.md
  • 2026-03-01_ux_migration_lifecycle_audit_register.md

Practical cutline (canonical)

  • If a feature changes interaction semantics or contract invariants, it is Pre-WGPU required.
  • If a feature changes visual sophistication, optional modes, or speculative capability, it is Post-WGPU preferred.

Stale-but-relevant reinterpretations (canonical)

  • "Magnetic zones" are interpreted as frame-affinity organizational behavior under graph-first frame semantics (workbench/graph_first_frame_semantics_spec.md).
  • Legacy context menu as a primary surface remains deprecated; contextual invocation is routed through Command Palette mode.
  • Edge semantics remain event-stream-first: Traversal events are primary and projected into durable edge state (EdgePayload), not old edge-type-only framing.

Pre-WGPU closure checklist (canonical gate)

  • Event dispatch contract closure: #261, #269.
  • Radial geometry/overflow contract closure: #263, #270.
  • Canvas interaction invariants closure (selection/lasso/zoom/edge focus): #271, #173, #185, #102, #104, #101, #103.
  • Viewer fallback/degraded-state clarity closure: #188, #162.
  • UxScenario snapshot baseline/diff CI closure: #257. The committed critical-path suite is already closed by #273; the remaining pre-WGPU automation blocker is structural snapshot baseline/diff gating in CI.
  • UxTree staged authority gate closure: #272.
  • Terminology reinterpretation pass complete in affected docs: "Magnetic zones" β†’ frame-affinity behavior; context-menu-primary references removed/reframed to Command Palette contextual mode; edge semantics phrased event-stream-first.

Pre-WGPU required (UX contract closure)

  • Event dispatch: #261, #269
  • Command/radial contract closure: #263, #270
  • Canvas interaction invariants: #271, #173, #185, #102, #104, #101, #103
  • Viewer fallback clarity: #188, #162
  • UxScenario snapshot baseline/diff CI gate: #257

Post-WGPU preferred (defer until renderer switch stabilizes)

  • Readability adaptation deepening and advanced layout heuristics (#265 follow-on scope)
  • Advanced radial/gesture expert behaviors after baseline radial contract closure
  • Speculative interaction R&D from inventory (SketchLay, DOI/fisheye, broader progressive lenses)

Parallel migration lanes (required overall, separate from UX closure)

  • #180, #181, #182, #183, #184, #245

Missing issues added in this pass

  • #269 Phase A supplement: UxTree event dispatch canonical-spec closure
  • #270 Phase C supplement: radial geometry and overflow contract closure
  • #271 Pre-WGPU canvas interaction invariants closure
  • #272 UxTree convergence roadmap: staged authority gates
  • #273 Pre-WGPU UxHarness critical-path gate
⚠️ **GitHub.com Fallback** ⚠️