Skip to content

Commit 4d57c59

Browse files
committed
docs(releases): 18.2.0 page lists what the version commit consumed
The version commit 27f38ad (#25640) consumed 231 changesets. The navigation group default (#26427) merged while the version pull request was open and stays pending, so it leaves 自动迁移 and the upgrade checklist. Counts become 52 / 7 / 41 / 3 / 128; the version commit and the publish date are filled in, and the page now reads from the real CHANGELOGs. Co-authored-by: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ADHkmNukkSDNQzLfynSUVv
1 parent 8c8ba88 commit 4d57c59

2 files changed

Lines changed: 32 additions & 35 deletions

File tree

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

Lines changed: 30 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,24 @@
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 eight breaking changes that os migrate meta carries."
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 seven breaking changes that os migrate meta carries."
44
---
55

66
<Callout type="info">
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
9-
`classifyReleaseBullet` in `scripts/release-github-releases.mjs`, the function
10-
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, **8** are
12-
converted for you, **41** add capabilities, **3** declare a semantic change,
13-
and **128** are other fixes. Every changeset is listed once, under its
14-
section. A version pass rehearsed in a throwaway clone wrote an `## 18.2.0`
15-
section into 111 CHANGELOGs, and the same function placed each of their
16-
distinct entries in the section this page lists it under. Each package's
7+
**How this page was compiled.** From the 231 changesets the version commit
8+
`27f38ada49` (#25640) consumed, each placed by `classifyReleaseBullet` in
9+
`scripts/release-github-releases.mjs`, the function that groups the GitHub
10+
Release body. The five sections below use its five headings, in its order, and
11+
its counts: **52** need you to act, **7** are converted for you, **41** add
12+
capabilities, **3** declare a semantic change, and **128** are other fixes.
13+
Every changeset is listed once, under its section. The version commit wrote an
14+
`## 18.2.0` section into 111 CHANGELOGs, and the same function places each of
15+
their distinct entries in the section this page lists it under. Each package's
1716
Release also carries an `Updated dependencies` bullet under 其他修复, which this
18-
page does not repeat. Changesets merged after `00a4593ad7` and before the
19-
version commit are not on this page. The
17+
page does not repeat. Four changesets merged while the version pull request
18+
was open are not in 18.2.0 and wait in `.changeset/` for the next release:
19+
the navigation group default (#26427), missed scheduled runs (#26485), every
20+
cell error of an import row (#26454), and the copy button on keyboard focus
21+
(#26487). The
2022
[upgrade checklist](#upgrade-checklist) is compiled from the changesets and
2123
has not been walked.
2224
</Callout>
@@ -31,10 +33,10 @@ has not been walked.
3133
Console tarball. The 37 public `@object-ui/*` packages join the
3234
`@objectstack/*` fixed group, so 18.2.0 is the first release in which both
3335
scopes publish at one version. See [Console (Studio)](#console).
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
36+
- ⚠️ **A minor that breaks.** 59 of the 231 changesets are declared breaking:
37+
15 graded `minor` because they narrow the metadata protocol, and 44 graded
3638
`patch` under the level rule (#25105, ruling A). 52 of them need you to act;
37-
8 are converted by `os migrate meta`. Read
39+
7 are converted by `os migrate meta`. Read
3840
[the version number](#the-version-number-is-not-the-signal).
3941
- **One access rule for a file reference.** A record write claims or copies
4042
only a file its caller may read, and is refused at the field when it names
@@ -76,13 +78,13 @@ has not been walked.
7678

7779
## Release facts, as measured
7880

79-
Read before the cut, from `main` at `00a4593ad7`, a version pass rehearsed in
80-
a throwaway clone, and `npm view` on 2026-10-27:
81+
Read from the version commit `27f38ada49`, its CHANGELOGs, and `npm view` on
82+
2026-10-27:
8183

8284
| | Measured |
8385
| :--- | :--- |
84-
| Version commit | `__VERSION_COMMIT__` (to be filled at the cut) |
85-
| Published | `__PUBLISH_DATE__` (to be filled at the cut) |
86+
| Version commit | `27f38ada49` (#25640) |
87+
| Published | 2026-10-27 |
8688
| Packages | 110 publish at 18.2.0: 72 `@objectstack/*`, `create-objectstack`, and 37 `@object-ui/*`. The VS Code extension (`object-ui`) takes the version and is private |
8789
| `@object-ui/*` before this release | every one of the 37 reads `latest` `18.1.0` on npm, published from the objectui repository |
8890
| `@object-ui/sdui-parser` | not released. It is deleted from the workspace (`80f267d`, #26343); its 18.1 line on npm is its last. Use `@objectstack/sdui-parser` |
@@ -92,8 +94,7 @@ a throwaway clone, and `npm view` on 2026-10-27:
9294

9395
Two notes for reading the 18.2.0 CHANGELOGs:
9496

95-
- **Each entry names its own commit.** In the rehearsed version pass every
96-
bullet opened with the commit that added its changeset, as the generator
97+
- **Each entry names its own commit.** Every 18.2.0 CHANGELOG bullet opens with the commit that added its changeset, as the generator
9798
has done since #25804. This page cites the same commits.
9899
- **objectui's last 65 changesets are one entry.** The changes objectui made
99100
between its 18.1.0 release and the import came across under
@@ -121,7 +122,7 @@ protocol** moved, and nothing else:
121122
| Everything else: REST, drivers, services, the CLI, the Console, `feat:` and `fix!:` alike | `patch` |
122123

123124
So 18.2.0 carries 44 changesets graded `patch` that say **BREAKING**, beside
124-
16 graded `minor`. Of all 232, 39 are graded `minor` and 193 `patch`; none is
125+
15 graded `minor`. Of all 231, 38 are graded `minor` and 193 `patch`; none is
125126
`major`. Pin exact versions of both scopes, and read the release notes for
126127
every version you cross.
127128

@@ -410,7 +411,7 @@ names what you do; the CHANGELOG entry carries the full before and after.
410411

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

413-
Eight breaking changes carry an ADR-0087 registration on the protocol-18 step, and
414+
Seven breaking changes carry an ADR-0087 registration on the protocol-18 step, and
414415
`os migrate meta` does each one: it converts what has one meaning and lists
415416
the rest for you. A live author of a narrowing is refused at parse, with the
416417
prescription.
@@ -426,7 +427,6 @@ lists and rewrites a deployment's stored rows.
426427
| `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` |
427428
| 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 |
428429
| 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` |
430430
| `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` |
431431

432432
### 新增能力 — new capabilities [#new-capabilities]
@@ -560,10 +560,9 @@ lists and rewrites a deployment's stored rows.
560560
(`f02e644`, #26277). A page that wrote `actions: []` and still wants New
561561
deletes the key.
562562

563-
Four entries the Release body files elsewhere declare `Metadata-protocol:
563+
Three entries the Release body files elsewhere declare `Metadata-protocol:
564564
semantic` too. The flow screen field typed `file` (#26134) is breaking, so it
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
565+
is listed under 需手动处理. The action copy `template` slots (#25637) and
567566
object-level `composite` / `repeater` (#25755) declare a `Clause-②: yes`
568567
widening, so they are new capabilities.
569568

@@ -883,7 +882,7 @@ released (`2a61f08`, #25745).
883882
- **The `objectui` authoring skill** ships in `@objectstack/skills`
884883
(`a8f2afa`, #26097).
885884

886-
Every Console change is listed once, in its section above. 89 of the 232
885+
Every Console change is listed once, in its section above. 89 of the 231
887886
changesets touch an `@object-ui/*` package: 10 under
888887
[需手动处理](#action-required) (most under "Console and the `@object-ui/*`
889888
packages"), 1 under [自动迁移](#migrated-for-you) (the "(by name)" badge), 14
@@ -919,7 +918,7 @@ it.
919918

920919
<Callout type="warn">
921920
**How far this list has been walked.** Not at all. It is compiled from the
922-
changesets before the cut, and no app has been moved from 18.1.0 to 18.2.0 for
921+
changesets, and no app has been moved from 18.1.0 to 18.2.0 for
923922
this page. Each step names the entry it comes from; read that entry above for
924923
the exact refusal.
925924
</Callout>
@@ -958,7 +957,7 @@ the exact refusal.
958957
```bash
959958
os validate
960959
os build
961-
os migrate meta --from 17 # the protocol-18 step, with this release's eight entries
960+
os migrate meta --from 17 # the protocol-18 step, with this release's seven entries
962961
```
963962

964963
Fix each refusal with its line in [需手动处理](#action-required) or
@@ -993,8 +992,6 @@ and `FilterBuilderRow.value` (`0489214`, `57ab06b`).
993992
- **Run `os migrate meta --stored`** to list and rewrite the stored rows the
994993
conversions touch: permission sets that store `allowDelete: false` beside
995994
`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`).
998995
- **Name each permission set a position should grant in its
999996
`permissionSets`.** The `position_name_fold_grant` warning, now logged with
1000997
`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/*`. 60 of its 232 changesets are declared breaking: 52
140-
need you to act and 8 are converted by `os migrate meta`. Its
139+
with `@objectstack/*`. 59 of its 231 changesets are declared breaking: 52
140+
need you to act and 7 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)