@@ -0,0 +1,30 @@
+---
+'@object-ui/i18n': patch
+'@object-ui/app-shell': patch
+---
+
+refactor(i18n, app-shell)!: Studio names an item's state with one word everywhere
+
+Clause-②: no (narrowing)
+Metadata-protocol: none
+
+<!-- adr-0087: not-required (no-migration-prescription) the four retired keys are rows of the Studio designer's own string table (the studio namespace of @object-ui/i18n, typed as a plain string record, outside the locale packs and TranslationKeys); no packages/spec schema, stored shape or metadata names them, and after this change no t() call in the workspace reads them -->
+
+The All metadata tiles, the list and item headers, the rail marks and the landing now use the words the Studio pillars use for an item's state: Read-only, Writable, Can be customized, Can be added, Customized and Added (zh: 只读, 可写, 可定制, 可新增, 已定制, 新增).
+
+A tile's word answers "what can I do here" for the open package. On a read-only package (a code or installed package), a type that takes a customization reads "Can be customized" instead of "writable"; any other type there reads "Read-only", because the All metadata area offers no create on a read-only package. On a writable package, an overlay type reads "Writable" and a create-only type reads "Can be added". The `OS_METADATA_WRITABLE` hatch opens nothing on a read-only package, so its types read "Read-only" there. The list and item headers draw the same word as the tile.
+
+The All metadata lead sentence now says what a person can do, without counting protocol types, and the "Writable only" filter is now "Hide read-only".
+
+In zh, the Access sharing settings drop their English doublets: `Private 私有` reads `私有`, `Public read 公共只读` reads `公共只读`, `Public read/write 公共读写` reads `公共读写`, `Controlled by parent 受父级控制` reads `受父级控制`, and the matrix's bare `OWD` column reads `记录共享模型`. English is unchanged.
+
+**BREAKING** (`@object-ui/i18n`): four keys of the Studio namespace retire. A `t()` call that still names one reads the key back.
+
+| Removed key | Replacement |
+|:---|:---|
+| `engine.badge.readOnly` | `engine.studio.pkg.readonly` |
+| `engine.badge.writable` | `engine.studio.pkg.writable` on a writable package, `engine.studio.customize.available` on a read-only one |
+| `engine.badge.createOnly` | `engine.studio.customize.addable` |
+| `engine.directory.writableOnly` | `engine.directory.hideReadOnly` |
+
+New keys: `engine.studio.customize.available`, `engine.studio.customize.availableTitle`, `engine.studio.customize.addable`, `engine.studio.customize.addableTitle`, `engine.directory.hideReadOnly`. `engine.directory.description` no longer takes the `count` and `writable` placeholders.
@@ -14,7 +14,8 @@
  *
  *  - the five overlay types (`view`, `dashboard`, `report`, `translation`,
  *    `email_template`), served as the S2 server writes them, are badged
- *    writable and counted by "Writable only";
+ *    writable and counted by "Hide read-only" (objectstack#29705 renamed the
+ *    filter and capitalised the words: the pillars' Writable and Read-only);
  *  - a type whose ONLY open door is the overlay flag — `agent` elevated by the
  *    `OS_METADATA_WRITABLE` hatch, which grants no runtime create — is badged
  *    writable and counted, so the disjunction reads the new field and not just
@@ -124,31 +125,31 @@ describe('DirectoryPage — the type tiles read `allowEnvironmentOverlay` (objec
     renderDirectory();
 
     for (const type of OVERLAY_TYPES) {
-      const badge = within(await tile(type)).getByText('writable');
+      const badge = within(await tile(type)).getByText('Writable');
       expect(badge).toHaveAttribute('title', 'Writable per ADR-0005 overlay opt-in');
     }
 
-    const hatched = within(await tile('agent')).getByText('writable');
+    const hatched = within(await tile('agent')).getByText('Writable');
     const title = hatched.getAttribute('title') ?? '';
     expect(title).toContain(HATCH_TITLE_FRAGMENT);
     expect(title).toContain('never an item a package ships');
     expect(title).not.toContain('OBJECTSTACK_METADATA_WRITABLE');
 
-    expect(within(await tile('api')).getByText('read-only')).toBeInTheDocument();
-    expect(within(await tile('api')).queryByText('writable')).toBeNull();
+    expect(within(await tile('api')).getByText('Read-only')).toBeInTheDocument();
+    expect(within(await tile('api')).queryByText('Writable')).toBeNull();
 
-    // "Writable only" counts the five and the hatched type: six of seven.
-    expect(screen.getByRole('button', { name: /Writable only \(6\)/ })).toBeInTheDocument();
+    // "Hide read-only" counts the five and the hatched type: six of seven.
+    expect(screen.getByRole('button', { name: /Hide read-only \(6\)/ })).toBeInTheDocument();
   });
 
   it('the hatch-elevated type served WITHOUT the field is read-only and not counted', async () => {
     const { allowEnvironmentOverlay: _omitted, ...withoutField } = HATCHED_AGENT;
     served = [withoutField, API];
     renderDirectory();
 
-    expect(within(await tile('agent')).getByText('read-only')).toBeInTheDocument();
-    expect(within(await tile('agent')).queryByText('writable')).toBeNull();
-    expect(screen.getByRole('button', { name: /Writable only \(0\)/ })).toBeInTheDocument();
+    expect(within(await tile('agent')).getByText('Read-only')).toBeInTheDocument();
+    expect(within(await tile('agent')).queryByText('Writable')).toBeNull();
+    expect(screen.getByRole('button', { name: /Hide read-only \(0\)/ })).toBeInTheDocument();
   });
 });
 
@@ -165,27 +166,27 @@ describe('PageShell — the header badge reads `allowEnvironmentOverlay` (object
 
   it.each(OVERLAY_TYPES)('%s: badged writable from the registry opt-in', (type) => {
     renderShell(overlayEntry(type));
-    expect(screen.getByText('writable')).toHaveAttribute('title', 'Writable per ADR-0005 overlay opt-in');
+    expect(screen.getByText('Writable')).toHaveAttribute('title', 'Writable per ADR-0005 overlay opt-in');
   });
 
   it('a hatch-elevated type: the tooltip names OS_METADATA_WRITABLE and what it opens', () => {
     renderShell(HATCHED_AGENT);
-    const title = screen.getByText('writable').getAttribute('title') ?? '';
+    const title = screen.getByText('Writable').getAttribute('title') ?? '';
     expect(title).toContain(HATCH_TITLE_FRAGMENT);
     expect(title).toContain('never an item a package ships');
     expect(title).not.toContain('OBJECTSTACK_METADATA_WRITABLE');
   });
 
   it('negative control: `api` without the field is badged read-only', () => {
     renderShell(API);
-    expect(screen.getByText('read-only')).toBeInTheDocument();
-    expect(screen.queryByText('writable')).toBeNull();
+    expect(screen.getByText('Read-only')).toBeInTheDocument();
+    expect(screen.queryByText('Writable')).toBeNull();
   });
 
   it('the hatch-elevated entry served WITHOUT the field is not badged writable', () => {
     const { allowEnvironmentOverlay: _omitted, ...withoutField } = HATCHED_AGENT;
     renderShell(withoutField);
-    expect(screen.queryByText('writable')).toBeNull();
-    expect(screen.getByText('read-only')).toBeInTheDocument();
+    expect(screen.queryByText('Writable')).toBeNull();
+    expect(screen.getByText('Read-only')).toBeInTheDocument();
   });
 });