M16: GUI Infrastructure & Layout Architecture
Phase: A1 Amendment -- Phase 2 Roadmap: SPEC-GAP-IMPLEMENTATION-PLAN.md Phase 2 Version target:
web/v0.16.0
Phase Context
Goal: Implement the foundational GUI systems that all A1 features depend on: three-tier composition model (workspaces, panes, panels), widget dock zones, plugin manifest expansion to 14 contribution types, application shell restructure (TopBar, Navigator decomposition, region resizing), focused-pane context model, URL schema, Dexie schema expansion, and session state boundary with custom workspace presets.
Key constraint: Plugin manifest expansion (M16-002) is on the critical path -- hover card tabs, toolbar items, widgets, and all new contribution types in M17+ depend on it. Dock zones (M16-008) must exist before Navigator can be decomposed.
ZenHub Configuration
| Field | Value |
|---|---|
| Milestone | M16: GUI Infrastructure & Layout Architecture |
| Due Date | TBD |
| Default Pipeline | Product Backlog |
| Primary Epic(s) | Plugin & Composition Architecture, Application Shell Restructure |
Prerequisites
- M15 Phase 1 (M15-009/012/013) -- node-label rename + Cypher alignment + Content service label-rename handlers
Epic: Plugin & Composition Architecture
Plugin host, manifest system, three-tier composition model, Dexie schema, session state boundary, focused-pane context.
Issues
| Issue | Title | Status | Notes |
|---|---|---|---|
| M16-001 | Data Fetching Infrastructure | 🔶 Partial | TanStack Query installed; query-keys.ts, utils.ts missing |
| M16-002 | Plugin Manifest Expansion | 🔶 Partial | Only 3 of 10 core plugins; missing 11 of 14 contribution types |
| M16-003 | Three-Tier Composition Model | 🔶 Partial | dockview-react installed; A1 pane lifecycle not implemented |
| M16-004 | Dexie Schema v6 | 🔶 Partial | Dexie v5 present; missing 4 new tables for A1 |
| M16-005 | Session State Boundary & Custom Workspace Presets | 🔶 Partial | Sessions exist but boundary per A1 not fully enforced |
| M16-006 | Focused-Pane Context Model | 🔶 Partial | useRegionFocus.ts exists but wrong region names |
| M16-014 | @gospelib/scripture-ref Package | ✅ Done | Completed 2026-06-11 -- batch B0.2 |
| M16-015 | @gospelib/core Package Extraction | ✅ Done | Completed 2026-06-11 -- 81 unit tests |
Epic: Application Shell Restructure
TopBar, Navigator decomposition, dock zones, region resizing, URL schema, plugin event bus.
Issues
| Issue | Title | Status | Notes |
|---|---|---|---|
| M16-007 | URL Schema Implementation | ❌ To Do | Not implemented per A1 |
| M16-008 | Widget Dock Zone System | ❌ To Do | Not implemented |
| M16-009 | Navigator Panel Decomposition | ❌ To Do | Not implemented |
| M16-010 | TopBar Restructure | ❌ To Do | Not implemented |
| M16-011 | Region Resizing | ❌ To Do | Not implemented |
| M16-012 | Focus Cycling Region Update | ❌ To Do | Not implemented |
| M16-013 | Plugin Event Bus | ❌ To Do | Not implemented |
Progress: 2 Done · 6 Partial · 7 To Do (~20%)
Summary
| Metric | Count |
|---|---|
| Total Issues | 15 |
| Sub-Issues | 0 |
| Total Estimate (pts) | 91 |
| Sprints | S4--S5 |
| Dependencies (blocking) | 10 |
| Dependencies (blocked by) | 10 |