Chore roadmap v010x shift (#76)

Co-authored-by: Jeffrey Smith <jasafpro@gmail.com>
Co-committed-by: Jeffrey Smith <jasafpro@gmail.com>

ROADMAP.md

@@ -1,6 +1,6 @@
 # Armature — Roadmap
 
-## Current: v0.9.x — Workflow Redesign
+## Current: v0.9.x — Workflow Redesign + Multi-Surface Packages
 
 Self-hosted extensible platform kernel. Auth, identity, packages, Starlark
 sandbox, storage, realtime, and ops are kernel primitives. Everything else
@@ -143,65 +143,70 @@ Completes the workflow→package access story.
 
 ---
 
-### v0.10.x — Reference Extensions
+### v0.10.x — Panels + Composable Layout
+
+Panels are a new kernel rendering tier between surfaces (full-page) and
+block renderers (inline). They solve composable companion views — e.g.,
+a notes reference panel inside chat. Design doc: `docs/DESIGN-panels.md`.
+
+| Version | Title |
+|---------|-------|
+| v0.10.0 | Panel Manifest + Lifecycle |
+| v0.10.1 | FloatingPanel Primitive |
+| v0.10.2 | Docked Panels + Mode Transitions |
+| v0.10.3 | Panel Communication Patterns |
+| v0.10.4 | Reference Panel: Notes (basic) |
+
+---
+
+### v0.11.x — Notes Reference Extension
+
+Notes becomes the first reference extension — a production-quality
+knowledge base that exercises every kernel primitive. The UI/UX redesign
+is front-loaded as v0.11.0 so every subsequent feature version builds on
+a clean visual foundation. Design doc: `docs/DESIGN-notes-v011x.md`.
+
+| Version | Title |
+|---------|-------|
+| v0.11.0 | UI/UX Foundation — visual redesign |
+| v0.11.1 | Deep Folders + Navigation |
+| v0.11.2 | Wikilinks + Backlinks |
+| v0.11.3 | Live Preview + Rich Editing |
+| v0.11.4 | Note Sharing + Permissions |
+| v0.11.5 | Graph + Outline Hardening |
+| v0.11.6 | Quick Switcher + Commands |
+| v0.11.7 | Daily Notes + Templates |
+| v0.11.8 | Transclusion + Embeds |
+| v0.11.9 | Composability: Slots + Actions |
+| v0.11.10 | Panel Enhancement + Quality Gate |
+
+---
+
+### v0.12.x — Reference Extensions (Remaining)
 
 The kernel is complete. This series proves the platform by shipping
 first-party extensions that exercise every primitive. These are
 **extensions, not kernel code** — they ship as `.pkg` files and can be
 uninstalled.
 
-**v0.10.0 — `vector-store` Library**
-
-Document ingestion, chunk storage, embedding persistence, semantic
-similarity search. Consumes: `db.write`, `files.read`.
-
-**v0.10.1 — `llm-bridge` Library**
-
-Model abstraction, tool-use routing, provider BYOK via connections.
-Exposes `complete()`, `embed()`, `classify()`, `register_tool()`.
-Consumes: `connections.read`, `api.http`, `db.write`.
-
-**v0.10.2 — `file-share` Extension**
-
-File upload, storage via `files` module, download links, team/group
-ACLs via resource grants.
-
-**v0.10.3 — `code-workspace` Extension**
-
-Managed code repos via `workspace` module. Git operations, file browser
-surface, structural indexing. Consumes: `workspace.manage`, `files.write`.
-
-**v0.10.4 — `image-gen` + `image-edit` Extensions**
-
-Image generation/editing via external APIs. Composability demo:
-contributes to `chat:image-actions` slot.
-
-**v0.10.5 — Chat System**
-
-Generic 1-to-N messaging with slots. `chat-core` library + `chat`
-surface. Declares `chat:message-actions`, `chat:image-actions`,
-`chat:composer-tools` slots. Consumes: `db.write`, `realtime.publish`,
-`files.write`.
+| Version | Title |
+|---------|-------|
+| v0.12.0 | `vector-store` Library |
+| v0.12.1 | `llm-bridge` Library |
+| v0.12.2 | `file-share` Extension |
+| v0.12.3 | `code-workspace` Extension |
+| v0.12.4 | `image-gen` + `image-edit` Extensions |
+| v0.12.5 | Chat System |
 
 ---
 
-### v0.11.x — Sidecar Tier + Polish
+### v0.13.x — Sidecar Tier + Polish
 
-**v0.11.0 — Sidecar Tier**
-
-Out-of-process extensions for workloads that can't run in Starlark (ML
-inference, media transcoding, language servers, local git). Sidecars are
-independent processes that connect inward to the kernel, following the
-cluster registry pattern. Authentication via mTLS or registration tokens.
-
-**v0.11.1 — Native Dialog Audit**
-
-Replace `prompt()`/`confirm()`/`alert()` with `sw.dialog` SDK primitives.
-
-**v0.11.2 — Stability + Migration Tooling**
-
-Versioned migrations, `armature migrate` CLI, backup/restore validation,
-pre-1.0 schema freeze.
+| Version | Title |
+|---------|-------|
+| v0.13.0 | Sidecar Tier |
+| v0.13.1 | Native Dialog Audit |
+| v0.13.2 | Stability + Migration Tooling |
 
 ---
 
@@ -219,6 +224,10 @@ Gate criteria:
 - Headless E2E green on PG + SQLite
 - `armature-ca.sh` + mTLS deployment guide
 - Single-binary + Docker + K8s deployment paths documented
+- Notes reference extension shipped with all v0.11.x features
+- Notes UI/UX reviewed against v0.11.0 design principles — no placeholder UI
+- At least 1 panel shipped and consumed cross-package (notes.reference → chat)
+- Panel lifecycle test coverage in SDK test runner
 
 ---
 
@@ -269,5 +278,9 @@ These are candidates, not commitments. Each requires a design doc.
 | `workspace` for real filesystem | Flat blob store can't serve git/compilers/ffmpeg. Managed disk paths. |
 | Capability negotiation at install | Fail loud with actionable message, not silently at runtime. |
 | Vector column with three-tier fallback | Works everywhere, works fast with pgvector. |
-| Sidecar deferred to v0.11.x | HTTP module covers external APIs. Sidecars connect inward (no k8s RBAC needed). |
+| Sidecar deferred to v0.13.x | HTTP module covers external APIs. Sidecars connect inward (no k8s RBAC needed). |
 | Workflow redesign before reference extensions | Clean up debt and promote primitives before building on top. |
+| Panels as kernel primitive (v0.10.x) | Z-index coordination, drag/resize, layout negotiation are kernel concerns. |
+| UI/UX redesign as v0.11.0 | Every feature version builds on the visual foundation. Front-loading avoids double work. |
+| Notes as dedicated v0.11.x series (11 versions) | Complex enough to need changeset discipline. Each version independently shippable. |
+| Notes before remaining reference extensions | Notes proves the full primitive surface. Other extensions build on proven patterns. |