Skip to content

armgit / bento

Public Imported from GitHub
0

Bento, the office suite that fits in a file

docs: settle the dash name, fix the app roster and the format field (#206)

nyblnet21fc89cbeb4a
diff --git a/docs/DECISIONS.md b/docs/DECISIONS.md
index 76755eb1..cf709696 100644
--- a/docs/DECISIONS.md
+++ b/docs/DECISIONS.md
@@ -14,6 +14,45 @@ Decision. Why. Pointers.
---
+## 2026-08-02 — `bento/dash` is settled, and it stands for DAta SHeets
+
+**Keep `bento/dash`.** The name contracts **DA**ta **SH**eets — the two halves
+of the app, the typed data model and the grid. It is not short for "dashboard";
+a dashboard is something the app can produce, not what it is.
+
+Recorded because the 2026-07-24 naming entry justifies it as "spreadsheet +
+tables + dashboards", which leads with the output surface and reads as
+mis-scoped. That framing is what caused the name to be re-opened and argued at
+length today. Don't re-open it without a new argument.
+
+This blocked the first commit that writes a `FORMAT` constant — PLATFORM §3
+puts the string into every saved file and there is no server to migrate
+anything — and it is now unblocked.
+
+**Weighed and set aside** (collisions verified live, not recalled):
+
+- `cells` — best suite fit, but it sounds like Ex**cel**. A replacement that
+ echoes the incumbent's name reads as derivative of it.
+- `views` — genuinely dual (a SQL view *and* a visual view), but it names
+ *looking* when the app's own boundary rule is *reckoning* ("does it
+ recalculate → dash").
+- `measures` — the BI term of art, and the convergent pick of two independent
+ root analyses, but "bento measures" parses as a verb clause.
+- `base` — its retirement reason above has **inverted**: it was dropped partly
+ for reading as "database, which this platform does not have", and dash now
+ is one. Set aside as flat rather than wrong; reconsider only if `dash` ever
+ proves to mis-signal in the field.
+- `figures` parses as a verb clause; `grid` collides with "bento grid", an
+ established UI design-trend phrase; `rows` is rows.com, a live "AI Data
+ Analyst" product; `calc` is LibreOffice Calc, and is clipped besides.
+
+**Namespace was deliberately down-weighted.** PyPI `dash` is Plotly's dataviz
+framework and npm `dash` is the cryptocurrency, but the app never ships as a
+bare word — it is `bento/dash`, at `bento.page/dash`, in
+`Bento_Dash.bento.html`. That is the mitigation the 2026-07-24 entry already
+prescribes for the crowded Bento namespace: always carry the `bento/<app>`
+form and the descriptor.
+
## 2026-07-28 — Vault is a capability broker; identity is multi-user from commit one
**Refines the 2026-07-27 vault entry rather than superseding it.** Three
diff --git a/docs/PLATFORM.md b/docs/PLATFORM.md
index c6924fd0..0f44a809 100644
--- a/docs/PLATFORM.md
+++ b/docs/PLATFORM.md
@@ -47,8 +47,10 @@ checks) before any release.
## 3. Document identity & format
-- `doc.type` names the format (`bento/slides`; provisionally `bento/spaces`,
- `bento/dash`) with an integer format version.
+- `doc.format` names the format (`bento/slides`, `bento/spaces`; `bento/dash`
+ to come) with an integer format version in `doc.version`. The field is
+ `format` — `slides/src/model.ts` exports `FORMAT = 'bento/slides'` and writes
+ it as `format`, and every reader keys off that.
- **Formats are additive.** Every version opens files from every earlier
version; unknown fields are preserved, not stripped. Breaking reads of old
files is not an option — there is no server to migrate them.
@@ -210,7 +212,7 @@ the document model, the renderer, the editor UX, starter documents, panels.
A new Bento app is on-platform when it:
- [ ] builds to ONE self-contained HTML file passing the §2 conformance gate
-- [ ] declares `doc.type` + format version; opens its own older files
+- [ ] declares `doc.format` + `doc.version`; opens its own older files
- [ ] mints and preserves `docId` per §3
- [ ] self-saves (FSA + download) and autosaves per §4
- [ ] supports the `bento/enc` envelope per §4 (or explicitly documents why not yet)
diff --git a/docs/agents.md b/docs/agents.md
index d2308d68..5c26ab9c 100644
--- a/docs/agents.md
+++ b/docs/agents.md
@@ -5,12 +5,14 @@ guide matches the bento/slides shell of the same version. A deck's `#bento-doc`
JSON is always the source of truth — if it was written by a newer shell it may
carry features beyond this guide; unknown keys are ignored, never fatal.
-> **Bento is a suite.** Slides is the first app. **Docs** (`bento/docs`) and
-> **Sheets** (`bento/sheets`) follow, each shipping as its own self-contained
-> distributable — `Bento_Slides.bento.html`, `Bento_Docs.bento.html`,
-> `Bento_Sheets.bento.html` — with its own agent guide at
+> **Bento is a suite.** Slides is the first app and the only one shipping
+> today. **Spaces** (`bento/spaces`, notes) and **Dash** (`bento/dash`, data
+> and sheets) are in development, and a word processor is planned. Each ships
+> as its own self-contained distributable — `Bento_Slides.bento.html`,
+> `Bento_Spaces.bento.html`, and so on — with its own agent guide at
> `bento.page/<app>/agents.md`. **This guide covers Slides only.** Before you
-> edit a file, check its `"format"` and use the matching guide.
+> edit a file, check its `"format"` field and use the matching guide; if the
+> format is one you have no guide for, don't guess at its shape.
*Drop this file into your context (or point your harness at it) and you can
author and edit Bento presentations directly. Also published at