v0.8.4: Documentation refresh + surface sizing fix

Docs pass covering v0.7.5–v0.8.3 module additions:
- STARLARK-REFERENCE: workspace module, permissions module, settings.has_capability()
- EXTENSION-GUIDE: capabilities manifest, vector(N) column, user_permissions,
  gate_permission, updated permissions list
- Tutorial reviewed for v0.7+ accuracy (no changes needed)

Surface sizing fix: .surface-inner converted to flex column layout so
the shell topbar and surface container share vertical space correctly.
All surface containers changed from height:100% to flex:1;min-height:0.
Eliminates 44px scroll cutoff on docs, admin, settings, and all
extension surfaces.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

ROADMAP.md

@@ -1,6 +1,6 @@
 # Armature — Roadmap
 
-## Current: v0.8.4 — Documentation Refresh + Surface Sizing Fix
+## Current: v0.8.5 — Extension Composability
 
 Self-hosted extensible platform kernel. Auth, identity, packages, Starlark
 sandbox, storage, realtime, and ops are kernel primitives. Everything else
@@ -434,31 +434,15 @@ HNSW index on pgvector. `starlarkToGoValue` extended with list→JSON.
 New: `docs/DESIGN-vector-column.md`. Modified: `ext_db_schema.go`,
 `db_module.go`, `runner.go`, `extensions.go`, `main.go`. 13 new tests.
 
-**v0.8.4 — Documentation Refresh + Surface Sizing Fix**
+**v0.8.4 — Documentation Refresh + Surface Sizing Fix** ✅
 
-Two unrelated items bundled for a clean changeset before composability.
-
-*Documentation refresh:* Starlark/extension docs have drifted since v0.7.5.
-Modules added or significantly changed but not fully documented:
-- `workspace` module (v0.8.1) — undocumented in STARLARK-REFERENCE.md
-- `permissions` module (v0.7.7) — undocumented in STARLARK-REFERENCE.md
-- `settings.has_capability()` (v0.8.2) — not in settings section
-- `db.query_similar()` vector section (v0.8.3) — added but needs review pass
-- EXTENSION-GUIDE.md — needs `capabilities` manifest block, `vector(N)` column
-  type, `user_permissions`, `gate_permission`
-- TUTORIAL-FIRST-EXTENSION.md — review for v0.7+ accuracy
-
-*Surface sizing bug:* Extension surfaces (`height: 100%` + `overflow: hidden`)
-don't account for the 44px shell topbar. Content is cut off at the bottom
-with no scroll. Affected: chat, notes, dashboard, schedules, and likely all
-extension surfaces. Root cause: `.extension-mount` is `flex: 1` within the
-viewport column, but extensions set `height: 100%` on their root element
-which inherits the mount's full height — the topbar's 44px is already
-subtracted by flex, but the extension's internal layout overflows because
-child containers also use `height: 100%` + `overflow: hidden`, clipping
-the last 44px of content. Fix: audit all extension root CSS and ensure
-inner scroll containers use `flex: 1; min-height: 0; overflow: auto`
-instead of `height: 100%; overflow: hidden`.
+Docs pass covering v0.7.5–v0.8.3 additions. STARLARK-REFERENCE.md gains
+`workspace` module, `permissions` module, `settings.has_capability()`.
+EXTENSION-GUIDE.md gains `capabilities` manifest, `vector(N)` column type,
+`user_permissions`, `gate_permission`, updated permissions list. Surface
+sizing fix: `.surface-inner` converted to flex column layout so the shell
+topbar and surface container share vertical space correctly — eliminates
+44px scroll cutoff on all surfaces.
 
 **v0.8.5 — Extension Composability**