You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit f2f5a17
Browse filesBrowse the repository at this point in the historyBrowse files
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>
Copy file name to clipboardExpand all lines: content/docs/releases/v18/18-2.mdx
+36-22Lines changed: 36 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,21 +1,21 @@
1
1
---
2
2
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."
4
4
---
5
5
6
6
<Callouttype="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
9
9
`classifyReleaseBullet` in `scripts/release-github-releases.mjs`, the function
10
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, **6** are
11
+
headings, in its order, and its counts: **52** need you to act, **8** are
12
12
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
14
14
section. A version pass rehearsed in a throwaway clone wrote an `## 18.2.0`
15
15
section into 111 CHANGELOGs, and the same function placed each of their
16
16
distinct entries in the section this page lists it under. Each package's
17
17
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
19
19
version commit are not on this page. The
20
20
[upgrade checklist](#upgrade-checklist) is compiled from the changesets and
21
21
has not been walked.
@@ -31,10 +31,10 @@ has not been walked.
31
31
Console tarball. The 37 public `@object-ui/*` packages join the
32
32
`@objectstack/*` fixed group, so 18.2.0 is the first release in which both
33
33
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
36
36
`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
38
38
[the version number](#the-version-number-is-not-the-signal).
39
39
-**One access rule for a file reference.** A record write claims or copies
40
40
only a file its caller may read, and is refused at the field when it names
@@ -46,7 +46,8 @@ has not been walked.
46
46
`runAs: 'system'` hook, an action body, an inherited system context and
47
47
`ctx.api.sudo()` are refused writes to position holdings, permission-set
48
48
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
50
51
is no longer granted to its holders (`733b3c8`): name it in the position's
51
52
`permissionSets`. An environment that runs HotCRM takes HotCRM `v6.0.0` or
52
53
later first.
@@ -75,7 +76,7 @@ has not been walked.
75
76
76
77
## Release facts, as measured
77
78
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
79
80
a throwaway clone, and `npm view` on 2026-10-27:
80
81
81
82
|| Measured |
@@ -120,7 +121,7 @@ protocol** moved, and nothing else:
120
121
| Everything else: REST, drivers, services, the CLI, the Console, `feat:` and `fix!:` alike |`patch`|
121
122
122
123
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
124
125
`major`. Pin exact versions of both scopes, and read the release notes for
125
126
every version you cross.
126
127
@@ -409,9 +410,10 @@ names what you do; the CHANGELOG entry carries the full before and after.
409
410
410
411
### 自动迁移 — converted for you by `os migrate meta`[#migrated-for-you]
411
412
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
413
414
`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.
415
417
`os migrate meta --from 17` lists the edits for your sources (`--write`
416
418
applies the ones it can trace to one literal), and `os migrate meta --stored`
417
419
lists and rewrites a deployment's stored rows.
@@ -423,6 +425,8 @@ lists and rewrites a deployment's stored rows.
423
425
| 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`|
424
426
|`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`|
425
427
| 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`|
426
430
|`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`|
427
431
428
432
### 新增能力 — new capabilities [#new-capabilities]
@@ -556,15 +560,16 @@ lists and rewrites a deployment's stored rows.
556
560
(`f02e644`, #26277). A page that wrote `actions: []` and still wants New
557
561
deletes the key.
558
562
559
-
Three entries the Release body files elsewhere declare `Metadata-protocol:
563
+
Four entries the Release body files elsewhere declare `Metadata-protocol:
560
564
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
562
567
object-level `composite` / `repeater` (#25755) declare a `Clause-②: yes`
563
568
widening, so they are new capabilities.
564
569
565
570
### 其他修复 — other fixes [#other-fixes]
566
571
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
568
573
ones that touch an upgrade come first.
569
574
570
575
#### Packaging and module formats
@@ -713,6 +718,9 @@ ones that touch an upgrade come first.
713
718
layout (`f0b33ee`, #25975).
714
719
- The liveness author warnings read ledger rows at every depth of `children`
715
720
(`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).
716
724
717
725
#### Skills
718
726
@@ -834,9 +842,11 @@ ones that touch an upgrade come first.
834
842
#26396), module-level helpers (`d00215f`, #26152), identity import and
835
843
record navigation (`3db7bbf`, #26353), realtime refresh and record count
836
844
(`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).
838
847
-`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).
840
850
- Five Interfaces rail label tests share one Studio harness (`697a307`,
841
851
#26255).
842
852
- The Console's build-identity define no longer leaks into the other ui test
@@ -873,12 +883,12 @@ released (`2a61f08`, #25745).
873
883
-**The `objectui` authoring skill** ships in `@objectstack/skills`
874
884
(`a8f2afa`, #26097).
875
885
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
877
887
changesets touch an `@object-ui/*` package: 10 under
878
888
[需手动处理](#action-required) (most under "Console and the `@object-ui/*`
879
889
packages"), 1 under [自动迁移](#migrated-for-you) (the "(by name)" badge), 14
880
890
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
882
892
"Console (Studio)" groups hold them. What a Console user notices first:
883
893
884
894
-**Approvals.** An administrator who is not the approver sees one status line
@@ -948,7 +958,7 @@ the exact refusal.
948
958
```bash
949
959
os validate
950
960
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
952
962
```
953
963
954
964
Fix each refusal with its line in [需手动处理](#action-required) or
@@ -965,6 +975,8 @@ Fix each refusal with its line in [需手动处理](#action-required) or
0 commit comments