From 059dd6f87791bbae10e65330b1b1edce49cd5271 Mon Sep 17 00:00:00 2001 From: os-zhuang Date: Sat, 11 Jul 2026 07:37:20 +0000 Subject: [PATCH] =?UTF-8?q?docs(releases):=20source=20v12=E2=80=93v14=20Co?= =?UTF-8?q?nsole=20sections=20from=20real=20objectui=20ranges?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Now that the objectui repo is available, replace the inferred Console (Studio) sections with per-commit frontend detail pulled via scripts/objectui-range.mjs over each major's bundled .objectui-sha range (resolved from the spec version tags): v12 = 77826989..b0aa2512 (58 commits), v13 = b0aa2512..397dcad7 (12), v14 = 397dcad7..6fa8e6ae (9). Each section leads with the reproducible SHA range and notes the frontend/backend phase offset (e.g. the enable.* Attachments UI shipped in the 13.x console, a release ahead of the v14 backend gates). Ratchet the role-word baseline down (v13 17→15, v14 7→9→7) since the corrected copy drops several "role" mentions. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01SXFPRKA2ixrZmRFwK7Cxh6 --- content/docs/releases/v12.mdx | 43 +++++++++++++++++---------------- content/docs/releases/v13.mdx | 26 ++++++++++++++------ content/docs/releases/v14.mdx | 32 +++++++++++++----------- scripts/role-word-baseline.json | 4 +-- 4 files changed, 60 insertions(+), 45 deletions(-) diff --git a/content/docs/releases/v12.mdx b/content/docs/releases/v12.mdx index 482ccff73e..b2b0d6a1a7 100644 --- a/content/docs/releases/v12.mdx +++ b/content/docs/releases/v12.mdx @@ -175,27 +175,28 @@ validation rejects mappings targeting undefined objects at build time. ## New in Console (Studio) -The Console build frozen into `@objectstack/console` 12.x renders the adaptive -surfaces and related-list model this release derives: - -- **Records open at the right size automatically** — the renderer consumes - `deriveRecordSurface` / `deriveRecordFlowSurface`: field-heavy records open as - a full page, light ones as a drawer/modal, and create/edit tasks always as an - overlay that returns losslessly to its origin. An explicit form/navigation - config still wins. -- **Related lists gain structure** — a `relatedList: 'primary'` child gets its - own detail-page tab while the rest collapse into one shared **Related** tab; - every eligible FK surfaces its own list (a child referencing the parent - through several relationships now shows each), self-referential hierarchies - surface a "child" list, and the lookup picker and related list of the same - object share one `highlightFields` column source. -- **Parameterized nav landings** — an `ObjectNavItem.filters` entry resolves to - the bare data surface (`/:object/data?filter[…]`) with removable filter chips, - for drill-throughs and "assigned to me" links. -- **Dependent picklists** — `SelectOption.visibleWhen` hides options client-side - as a UX affordance (the value is still authorized server-side). - -For exhaustive, per-commit frontend detail, see the +The Console frozen into `@objectstack/console` across the 12.x line (objectui +`77826989..b0aa2512`, 58 commits) is a broad Studio and record-UX push: + +- **Studio authoring surfaces** — metadata-driven **Validations / Hooks / + Actions** config panels, per-object **API / Hooks / Actions** tabs, a form + designer whose column density matches the runtime form, and a + **review-then-publish** confirmation with field-level change detail. +- **Security authoring UI** (pairing with the v12–v13 security work) — an OWD + **sharing-model control** in Studio Settings, ADR-0066 **posture / + per-operation `requiredPermissions` / capability-lint** surfaced in the + authoring UI, and ADR-0090 D2 **provenance + default badges** replacing the + old profile toggles. +- **Record UX** — create/edit **task flows as derived overlays** with a lossless + return to origin (framework#2604), the **`/:objectName/data`** parameterized + bare data surface with removable filter chips, **URL-driven detail tabs** + (`?tab=` survives remounts), **per-user persisted list filters**, + `Action.order` honored in the record header, cascading **`visibleWhen`** + select options, and **registered import mappings** in the import wizard. +- **Infrastructure** — a **data-invalidation bus** (refresh data, don't rebuild + the UI) behind the snappier navigation. + +Per-commit detail: the [objectui CHANGELOG](https://github.com/objectstack-ai/objectui/blob/main/CHANGELOG.md). ## Notable fixes diff --git a/content/docs/releases/v13.mdx b/content/docs/releases/v13.mdx index b814af843a..2da82af5ca 100644 --- a/content/docs/releases/v13.mdx +++ b/content/docs/releases/v13.mdx @@ -168,14 +168,24 @@ the package prefix, atomically, with an actionable message. ## New in Console (Studio) -Permission Model v2 is a backend-heavy release; the matching Console surfaces — -the Roles → Positions relabel across Setup, the Studio cross-reference picker -moving its `role` kind to `position`, and the standalone **Explain**, **Access -Matrix**, and **Delegated Administration** admin pages that expose the D6/D12 -engines — roll out across the v13–v14 line. See -[v14](/docs/releases/v14)'s Console notes for the shipped surfaces, and the -[objectui CHANGELOG](https://github.com/objectstack-ai/objectui/blob/main/CHANGELOG.md) -for per-commit detail. +The Console bundled during the 13.x line (objectui `b0aa2512..397dcad7`, 12 +commits) is the Permission Model v2 UI fallout, plus the frontend for v14's +object-capability gates (bundled a release ahead of the backend): + +- **Adopt @objectstack/spec 13** — the Permission Model v2 (ADR-0090) rename + wave lands across app-shell / console / types. +- **"Why can this user access?" explain panel** in the Studio Access pillar + (ADR-0090 D6). +- **Suggested audience-binding** install prompt + Access-pillar banner (D5/D9), + and **book audience gated by permission set** (mirrors the `{ permissionSet }` + shape). +- **Record Attachments panel** gated on `enable.files`, and **`enable.feeds` / + `enable.activities` opt-out** honored — the frontend for v14's object gates. +- A **Connect-an-agent** page widget and a form-layout **group-properties + inspector**. + +Per-commit detail: the +[objectui CHANGELOG](https://github.com/objectstack-ai/objectui/blob/main/CHANGELOG.md). ## Removed: declared-but-never-enforced subsystems (ADR-0056 D8) diff --git a/content/docs/releases/v14.mdx b/content/docs/releases/v14.mdx index 902b0c3660..2e297348c1 100644 --- a/content/docs/releases/v14.mdx +++ b/content/docs/releases/v14.mdx @@ -198,20 +198,24 @@ real enforced consumer. ## New in Console (Studio) -The version-locked `@objectstack/console` bundle carries the frontend for this -line, including the Permission Model v2 alignment that spans v13–v14: - -- **Position assignment panels** — the generic `record:related_list` Add-picker - and `relationshipValueField` support render the `sys_user` **Positions** tab - and the `sys_position` **Holders** / **Permission Sets** tabs. With older - renderers these degrade to read-only lists. -- **Record Attachments** — `RecordAttachmentsPanel` (upload / list / download / - delete over the three-step presigned storage flow) renders on record pages - when the object sets `enable: { files: true }`. -- **Permission Model v2 surfaces** — Setup relabels Roles → Positions, the - Studio cross-reference picker moves its `role` kind to `position`, and - standalone **Explain**, **Access Matrix**, and **Delegated Administration** - pages expose the D6/D12 engines. +The Console bundled across the 14.x line (objectui `397dcad7..6fa8e6ae`) carries: + +- **Position assignment panels** — `relationshipValueField` renderer support + (aligned to 14.3) renders the `sys_user` **Positions** tab and the + `sys_position` **Holders** / **Permission Sets** tabs; older renderers degrade + to read-only lists. +- **Phone-number auth** — SMS one-time-code **login** and **password reset** + (framework#2780 frontend). +- **Object Capabilities section** in the Settings panel (the `enable.*` gates), + and an **effective-holders list** for permission sets with a more discoverable + explain user-picker. +- **Dynamic runtime branding** consumed across the console, a cloud **AI + model-status** admin panel, and spreadsheet attachments that reach the build + agent. + +The record **Attachments panel** and the **"why can this user access?" explain +panel** landed in the console bundled during the 13.x line — see +[v13](/docs/releases/v13). For exhaustive, per-commit frontend detail, see the [objectui CHANGELOG](https://github.com/objectstack-ai/objectui/blob/main/CHANGELOG.md). diff --git a/scripts/role-word-baseline.json b/scripts/role-word-baseline.json index ec85c13204..f8faf87fbc 100644 --- a/scripts/role-word-baseline.json +++ b/scripts/role-word-baseline.json @@ -37,8 +37,8 @@ "content/docs/protocol/objectui/widget-contract.mdx": 3, "content/docs/releases/implementation-status.mdx": 1, "content/docs/releases/index.mdx": 1, - "content/docs/releases/v13.mdx": 17, - "content/docs/releases/v14.mdx": 9, + "content/docs/releases/v13.mdx": 15, + "content/docs/releases/v14.mdx": 7, "content/docs/ui/forms.mdx": 3, "skills/objectstack-ai/SKILL.md": 8, "skills/objectstack-api/SKILL.md": 1,