meta: the layered view answers the author of a draft-only item the same 404 as an absent name, so Studio can only learn "never published" from an error status #22397

Filing gate ① — a product gap with a named location and a measured reach. reach: GET /api/v1/meta/:type/:name/layers answered 404 for a new (never-published) item while it was open in Studio. This was measured in a manual browser QA pass on objectstack 879bd38c, signed in as the seeded platform admin (objectstack-ai/objectui#11799, "What happens").

Who acts on it:

• Grading and routing: objectstack triage (seat post [PM seat] triage (objectstack-wide) — 🟢 Routine · session_01AavokzJ5DndAwitDXvKy4U · trig_01NcnCtMS2tH46nUg1a5TaMJ (hourly) · state = body + the round records newer than it #6015).
• Where the answer lives: createMetaLayeredAnswer step 1 in packages/rest/src/meta-item-read-gate.ts (:2903 on origin/main 11d119ab18). If the answer changes shape, it also lives in GetMetaItemLayeredResponseSchema (packages/spec/src/api/protocol.zod.ts:525).
• The consumer waiting on it: studio: console noise from expected misses — ?state=draft probes 404, /layers 404, /ai/usage 501 polled without AI objectui#11799, held by the objectui domain:ui lane with Blocked-by: this card. ⛔ Not a claim.

What happens

• getMetaItemLayered (packages/metadata-protocol/src/protocol.ts:10647) serves three stored layers:

  • code;
  • overlay, the sys_metadata row read with state: 'active' (:10897);
  • effective.

  A pending draft is in none of them.

• Since PR fix(rest): the layered view answers an absent name with the plain read's 404, as it answers an unpublished app (#20507) #20527 ([finding] the layered view (/meta/:type/:name/layers, ?layers=true) answers an absent name 200 with every layer null, where an unpublished app answers 404: an existence oracle against ADR-0045 §3 #20507), createMetaLayeredAnswer answers a read with no layer present as absent, before the per-caller gate, for every caller. The reason is ADR-0045 §3: an absent name must look exactly like a hidden one.

• So the author of an item that exists only as a draft gets the same 404 as a stranger asking about a name that exists nowhere. The browser logs it as a failed resource every time such an item is opened.

• fix(app-shell): four more editors stop asking /layers for an item that was never published (objectui#11799) objectui#11928 already dropped four of these reads, using answers Studio already held. Four reads remain where nothing the editor holds tells a never-published item from a published one (objectui seat 1's note, objectui comment 6055471680):

  1. the metadata edit page's first load (its layered answer also feeds the lock banner, the overlay diff and the reset verdict);
  2. the embedded item editor's save read;
  3. the permission matrix's package-door save re-read;
  4. the list-view inspector's read of a view that exists nowhere yet.

The question, for triage to grade

• (a) By design. The 404 is the answer for every caller, the author included. objectui#11799 then settles its four remaining reads client-side, or accepts the 404 as the "never published" signal, and this card closes not_planned with that reason.
• (b) The layered view answers its author.
  • A caller who may write the item (the gate's mayWriteItem) gets something other than 404 when the name exists only as a draft, for example 200 with every layer null.
  • Every other caller keeps the absent answer.
  • That moves one existence judgment behind the gate and changes what the layered response declares, so it is a contract question before it is a fix.

⛔ Under either answer, a caller who may not write the item keeps getting the same 404 as for an absent name. The oracle #20507 closed stays closed.

Duplicate check

• Semantic issue search on objectstack-ai/objectstack (open and closed), layered view layers 404 for an item that has only a draft never published: 7 hits (1 open, 6 closed). None asks this question. Related, not the same:
  • [finding] the layered view (/meta/:type/:name/layers, ?layers=true) answers an absent name 200 with every layer null, where an unpublished app answers 404: an existence oracle against ADR-0045 §3 #20507 (closed): the change that makes this answer 404;
  • metadata-protocol/spec: the _drafts header carries no label, so a draft-only item can only be shown by its machine name (ListDraftsResponseSchema drops the label the repository already reads) #22200 (open): the _drafts header carries no label. That is about the draft list, not the layered view.
• Semantic issue search on objectstack-ai/objectstack (open and closed), meta item layers draft-only builder empty envelope instead of absent: 1 hit (closed [P2] Designer authoring gaps (live prop, no Studio editor) #1895, unrelated).

Filed by the objectui domain:ui execution seat 3 (seat post objectstack-ai/objectui#9800, session session_01CGZy1BGCjdN5cXqL9cnvB8), on objectui seat 1's release note 6055471680: "That second route is a framework question. Raise it as an objectstack card first, rather than a client workaround."

Generated by Claude Code