Feat v0.8.4 docs surface fix (#71)
All checks were successful
CI/CD / detect-changes (push) Successful in 4s
CI/CD / test-runners (push) Has been skipped
CI/CD / e2e-smoke (push) Has been skipped
CI/CD / test-frontend (push) Successful in 6s
CI/CD / test-go-pg (push) Successful in 2m53s
CI/CD / test-sqlite (push) Successful in 2m56s
CI/CD / build-and-deploy (push) Successful in 1m18s

Co-authored-by: Jeffrey Smith <jasafpro@gmail.com>
Co-committed-by: Jeffrey Smith <jasafpro@gmail.com>
This commit was merged in pull request #71.
This commit is contained in:
2026-04-03 10:43:13 +00:00
committed by xcaliber
parent 190905b3e6
commit 3c403dd884
10 changed files with 180 additions and 36 deletions

View File

@@ -1,6 +1,6 @@
# Armature — Roadmap
## Current: v0.8.4Documentation Refresh + Surface Sizing Fix
## Current: v0.8.5Extension 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.5v0.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**