Skip to content

Commit f2f5a17

Browse files
committed
docs(releases): fold the five changesets merged since the first count into the 18.2.0 page
main moved to 00a4593 with five more changesets: two converted entries (the identity-write refusal at save and the navigation group default) and three other fixes. The counts move to 232 (52 / 8 / 41 / 3 / 128), and the v18 index line moves with them. Claude-Session: https://claude.ai/code/session_01ADHkmNukkSDNQzLfynSUVv Co-authored-by: Claude <noreply@anthropic.com>
1 parent fb473b9 commit f2f5a17

2 files changed

Lines changed: 38 additions & 24 deletions

File tree

‎content/docs/releases/v18/18-2.mdx‎

Lines changed: 36 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
---
22
title: 18.2.0
3-
description: "Release notes and upgrade checklist for 18.2.0, the first release that ships the Console and the @object-ui packages from this repository. A minor that carries breaking changes: one access rule for file references, app automation refused identity writes under elevation, installs that check declared dependencies, action copy refused at publish, and six narrowings that os migrate meta converts."
3+
description: "Release notes and upgrade checklist for 18.2.0, the first release that ships the Console and the @object-ui packages from this repository. A minor that carries breaking changes: one access rule for file references, app automation refused identity writes under elevation, installs that check declared dependencies, action copy refused at publish, and eight breaking changes that os migrate meta carries."
44
---
55

66
<Callout type="info">
7-
**How this page was compiled.** From the 227 changesets added to `.changeset/`
8-
between the 18.1.0 tag and `main` at `f9e871a1c4`, each placed by
7+
**How this page was compiled.** From the 232 changesets added to `.changeset/`
8+
between the 18.1.0 tag and `main` at `00a4593ad7`, each placed by
99
`classifyReleaseBullet` in `scripts/release-github-releases.mjs`, the function
1010
that groups the GitHub Release body. The five sections below use its five
11-
headings, in its order, and its counts: **52** need you to act, **6** are
11+
headings, in its order, and its counts: **52** need you to act, **8** are
1212
converted for you, **41** add capabilities, **3** declare a semantic change,
13-
and **125** are other fixes. Every changeset is listed once, under its
13+
and **128** are other fixes. Every changeset is listed once, under its
1414
section. A version pass rehearsed in a throwaway clone wrote an `## 18.2.0`
1515
section into 111 CHANGELOGs, and the same function placed each of their
1616
distinct entries in the section this page lists it under. Each package's
1717
Release also carries an `Updated dependencies` bullet under 其他修复, which this
18-
page does not repeat. Changesets merged after `f9e871a1c4` and before the
18+
page does not repeat. Changesets merged after `00a4593ad7` and before the
1919
version commit are not on this page. The
2020
[upgrade checklist](#upgrade-checklist) is compiled from the changesets and
2121
has not been walked.
@@ -31,10 +31,10 @@ has not been walked.
3131
Console tarball. The 37 public `@object-ui/*` packages join the
3232
`@objectstack/*` fixed group, so 18.2.0 is the first release in which both
3333
scopes publish at one version. See [Console (Studio)](#console).
34-
- ⚠️ **A minor that breaks.** 58 of the 227 changesets are declared breaking:
35-
14 graded `minor` because they narrow the metadata protocol, and 44 graded
34+
- ⚠️ **A minor that breaks.** 60 of the 232 changesets are declared breaking:
35+
16 graded `minor` because they narrow the metadata protocol, and 44 graded
3636
`patch` under the level rule (#25105, ruling A). 52 of them need you to act;
37-
6 are converted by `os migrate meta`. Read
37+
8 are converted by `os migrate meta`. Read
3838
[the version number](#the-version-number-is-not-the-signal).
3939
- **One access rule for a file reference.** A record write claims or copies
4040
only a file its caller may read, and is refused at the field when it names
@@ -46,7 +46,8 @@ has not been walked.
4646
`runAs: 'system'` hook, an action body, an inherited system context and
4747
`ctx.api.sudo()` are refused writes to position holdings, permission-set
4848
grants, invitations and memberships, as a system flow already was
49-
(`073f08b`, `6a6ebff`). A permission set that only shares a position's name
49+
(`073f08b`, `6a6ebff`), and a hook or action body that writes one in its
50+
source is refused at save (`07586f5`). A permission set that only shares a position's name
5051
is no longer granted to its holders (`733b3c8`): name it in the position's
5152
`permissionSets`. An environment that runs HotCRM takes HotCRM `v6.0.0` or
5253
later first.
@@ -75,7 +76,7 @@ has not been walked.
7576

7677
## Release facts, as measured
7778

78-
Read before the cut, from `main` at `f9e871a1c4`, a version pass rehearsed in
79+
Read before the cut, from `main` at `00a4593ad7`, a version pass rehearsed in
7980
a throwaway clone, and `npm view` on 2026-10-27:
8081

8182
| | Measured |
@@ -120,7 +121,7 @@ protocol** moved, and nothing else:
120121
| Everything else: REST, drivers, services, the CLI, the Console, `feat:` and `fix!:` alike | `patch` |
121122

122123
So 18.2.0 carries 44 changesets graded `patch` that say **BREAKING**, beside
123-
14 graded `minor`. Of all 227, 37 are graded `minor` and 190 `patch`; none is
124+
16 graded `minor`. Of all 232, 39 are graded `minor` and 193 `patch`; none is
124125
`major`. Pin exact versions of both scopes, and read the release notes for
125126
every version you cross.
126127

@@ -409,9 +410,10 @@ names what you do; the CHANGELOG entry carries the full before and after.
409410

410411
### 自动迁移 — converted for you by `os migrate meta` [#migrated-for-you]
411412

412-
Six narrowings carry an ADR-0087 registration on the protocol-18 step, and
413+
Eight breaking changes carry an ADR-0087 registration on the protocol-18 step, and
413414
`os migrate meta` does each one: it converts what has one meaning and lists
414-
the rest for you. A live author is refused at parse, with the prescription.
415+
the rest for you. A live author of a narrowing is refused at parse, with the
416+
prescription.
415417
`os migrate meta --from 17` lists the edits for your sources (`--write`
416418
applies the ones it can trace to one literal), and `os migrate meta --stored`
417419
lists and rewrites a deployment's stored rows.
@@ -423,6 +425,8 @@ lists and rewrites a deployment's stored rows.
423425
| The package upgrade model leaves `@objectstack/spec`: `UpgradePlanSchema` and its family, `IPackageService.planUpgrade` / `upgrade` / `rollback` / `getSnapshot`, and `PackageUpgradeResponse.data.plan` (`557973d`, #25757) | `kernel-package-upgrade-family-retired` | lists it; nothing ever read or produced these shapes. Delete the imports. A new version over an installed package is `POST /api/v1/packages` with `overwrite: true`; the package rollback served is `POST /api/v1/packages/:id/rollback` with a `commitId` |
424426
| `PackageDependency.optional` and `AppManifest.dependencies` are tombstones (`436d284`, #26401) | `dependency-unread-spellings-retired` | lists it; nothing read either key. Delete the key, and declare each dependency with its range in `manifest.dependencies` |
425427
| A locale must be a BCP-47 tag: `zh_CN`, a padded value or a language name is refused (`39a78b1`, #25983) | `translation-locale-tag-canonicalized`, `translation-locale-non-tag-refused` | rewrites `zh_CN` to `zh-CN` and trims whitespace, in stored rows and with `--from 17 --write` in sources; any other value is reported as a TODO. Replace a language name with its tag |
428+
| A `runAs: 'system'` hook or a `type: 'script'` action whose sandboxed JS body writes `sys_user_position`, `sys_user_permission_set`, `sys_invitation` or `sys_member` is refused at save, not only when it runs (`07586f5`, #26430) | `hook-action-body-system-identity-assignment-write-refused` | lists each one; no conversion, because the route is your choice. Set the hook's `runAs` to `'user'`, or move an action's grant into a `runAs: 'user'` flow; use the organization endpoints for invitations and memberships |
429+
| `GroupNavItem.expanded` defaults to `true`, so a navigation group that says nothing opens on first view (`21a13f1`, #26427) | `ui-nav-group-expanded-default-open` | lists it. A group meant to start collapsed writes `expanded: false`; recompile an `os compile` artifact, which still carries the old written `false` |
426430
| `PositionGrantVia` loses `'name'`, and Setup → Positions drops its "(by name)" badge (`9494dd8`, #26398) | `position-grant-via-name-retired` | lists it; no server serves the value. Delete a branch that compares with `'name'`, and name the set in the position's `permissionSets` |
427431

428432
### 新增能力 — new capabilities [#new-capabilities]
@@ -556,15 +560,16 @@ lists and rewrites a deployment's stored rows.
556560
(`f02e644`, #26277). A page that wrote `actions: []` and still wants New
557561
deletes the key.
558562

559-
Three entries the Release body files elsewhere declare `Metadata-protocol:
563+
Four entries the Release body files elsewhere declare `Metadata-protocol:
560564
semantic` too. The flow screen field typed `file` (#26134) is breaking, so it
561-
is listed under 需手动处理. The action copy `template` slots (#25637) and
565+
is listed under 需手动处理, and the navigation group default (#26427) is
566+
breaking with a registration, so it is listed under 自动迁移. The action copy `template` slots (#25637) and
562567
object-level `composite` / `repeater` (#25755) declare a `Clause-②: yes`
563568
widening, so they are new capabilities.
564569

565570
### 其他修复 — other fixes [#other-fixes]
566571

567-
The 125 entries that declare no breaking change and no protocol kind. The
572+
The 128 entries that declare no breaking change and no protocol kind. The
568573
ones that touch an upgrade come first.
569574

570575
#### Packaging and module formats
@@ -713,6 +718,9 @@ ones that touch an upgrade come first.
713718
layout (`f0b33ee`, #25975).
714719
- The liveness author warnings read ledger rows at every depth of `children`
715720
(`13136f7`, #26379).
721+
- The `onSuccess.navigate` and `type: 'url'` `target` describes say an in-app
722+
path is an app-qualified console route, `/apps/APP/OBJECT/record/ID`
723+
(`ab0bc89`, #26435).
716724

717725
#### Skills
718726

@@ -834,9 +842,11 @@ ones that touch an upgrade come first.
834842
#26396), module-level helpers (`d00215f`, #26152), identity import and
835843
record navigation (`3db7bbf`, #26353), realtime refresh and record count
836844
(`b9cd980`, #26336), view options (`96635f5`, #26233), tab strip and header
837-
chrome (`08ed7e2`, #26412), and toolbar affordances (`3acbeff`, #26374).
845+
chrome (`08ed7e2`, #26412), toolbar affordances (`3acbeff`, #26374), and page header and record overlay
846+
(`a7f4b99`, #26434).
838847
- `ObjectGrid`'s module-level helpers (`7158025`, #26323) and its host-facing
839-
props types (`222755e`, #26354) move into sibling modules.
848+
props types (`222755e`, #26354) move into sibling modules, and its
849+
authored-input diagnostics into a sibling hook (`eeaa827`, #26364).
840850
- Five Interfaces rail label tests share one Studio harness (`697a307`,
841851
#26255).
842852
- The Console's build-identity define no longer leaks into the other ui test
@@ -873,12 +883,12 @@ released (`2a61f08`, #25745).
873883
- **The `objectui` authoring skill** ships in `@objectstack/skills`
874884
(`a8f2afa`, #26097).
875885

876-
Every Console change is listed once, in its section above. 87 of the 227
886+
Every Console change is listed once, in its section above. 89 of the 232
877887
changesets touch an `@object-ui/*` package: 10 under
878888
[需手动处理](#action-required) (most under "Console and the `@object-ui/*`
879889
packages"), 1 under [自动迁移](#migrated-for-you) (the "(by name)" badge), 14
880890
under [新增能力](#new-capabilities), 1 under
881-
[语义变化](#semantic-changes), and 61 under [其他修复](#other-fixes), where the
891+
[语义变化](#semantic-changes), and 63 under [其他修复](#other-fixes), where the
882892
"Console (Studio)" groups hold them. What a Console user notices first:
883893

884894
- **Approvals.** An administrator who is not the approver sees one status line
@@ -948,7 +958,7 @@ the exact refusal.
948958
```bash
949959
os validate
950960
os build
951-
os migrate meta --from 17 # the protocol-18 step, with this release's six conversions
961+
os migrate meta --from 17 # the protocol-18 step, with this release's eight entries
952962
```
953963

954964
Fix each refusal with its line in [需手动处理](#action-required) or
@@ -965,6 +975,8 @@ Fix each refusal with its line in [需手动处理](#action-required) or
965975
- `allowDelete: false` beside `modifyAllRecords: true` (`f6ba134`);
966976
- a locale that is not a BCP-47 tag, such as `zh_CN` (`39a78b1`);
967977
- `visibleOn`, `hiddenOn` or `disabledOn` on a page node (`e843b5b`);
978+
- a `runAs: 'system'` hook or `script` action whose body writes an
979+
identity-assignment object (`07586f5`);
968980
- `optional` on a marketplace dependency entry, or `dependencies` on an app
969981
install manifest (`436d284`).
970982

@@ -981,6 +993,8 @@ and `FilterBuilderRow.value` (`0489214`, `57ab06b`).
981993
- **Run `os migrate meta --stored`** to list and rewrite the stored rows the
982994
conversions touch: permission sets that store `allowDelete: false` beside
983995
`modifyAllRecords: true`, and `translation` rows under `zh_CN`-style locales.
996+
- **Write `expanded: false` on each navigation group that should start
997+
collapsed**; a group that says nothing now opens (`21a13f1`).
984998
- **Name each permission set a position should grant in its
985999
`permissionSets`.** The `position_name_fold_grant` warning, now logged with
9861000
`granted: false`, names each position whose same-named set is no longer

‎content/docs/releases/v18/index.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -136,8 +136,8 @@ its own upgrade checklist.
136136

137137
- **[18.2.0](/docs/releases/v18/18-2)** — the first release that ships the
138138
Console and the `@object-ui/*` packages from this repository, at one version
139-
with `@objectstack/*`. 58 of its 227 changesets are declared breaking: 52
140-
need you to act and 6 are converted by `os migrate meta`. Its
139+
with `@objectstack/*`. 60 of its 232 changesets are declared breaking: 52
140+
need you to act and 8 are converted by `os migrate meta`. Its
141141
[upgrade checklist](/docs/releases/v18/18-2#upgrade-checklist) moves an
142142
18.1.0 app to 18.2.0, and is compiled from the changesets, not walked.
143143
- **[18.1.0](/docs/releases/v18/18-1)** — the first minor, and a minor that

0 commit comments

Comments
 (0)