Skip to content

Two docs/skill sites still teach the plural /meta/objects/:name/state/:field, which step ② of #9180 retires #10178

Description

@os-elon

Measured while implementing #10077 (step ② of the #9180 ruling, PR #10177). Filed unassigned; recording only, not claiming.

#10077's scope note routes docs prose to the docs card, and the 2026-08-17 re-weigh (#9180 comment 5311434183, item 2) scopes step ③ to "any docs that teach a plural spelling". #10078 names exactly two sites — the SDK item-route typing and content/docs/api/metadata-api.mdx:31-36. These two are not in that list, and one of them stops being merely a spelling preference once PR #10177 lands:

  1. content/docs/protocol/objectql/state-machine.mdx:126

    Over HTTP, GET /api/v1/meta/objects/:name/state/:field?from=:state returns { object, field, from, next }

    PR fix(rest,client): the /meta FSM state route is singular — retire the plural registration (#10077) #10177 deletes that registration. After it merges, this line documents a path that answers the transport 404 on a REST-fronted server — a doc teaching a retired route, not a doc preferring the wrong spelling. The singular twin (/api/v1/meta/object/:name/state/:field) is what the sentence should name.

  2. skills/objectstack-automation/SKILL.md:281GET /metadata/objects/:name/state/:field?from=:state.

    ⚠️ Measured, and different from site 1: this one names the legacy dispatcher path (/metadata/...), whose branch in packages/runtime/src/domains/meta.ts matches parts[0] === 'objects' || parts[0] === 'object' and is not touched by Retire the plural /meta/objects/:name/state/:field registration: SDK moves to the singular twin, the collision's registration-order pin is deleted (step ② of the #9180 ruling) #10077. So this line stays literally true after that PR — it teaches a spelling the ruling retires as canonical, which is a step-③ correction, not a broken instruction. Kept separate here so nobody "fixes" it as if it were the same urgency as site 1.

Both are one-line edits, and neither changes accept/reject behaviour, so this sits at the step-③ tier (opus), not the fable floor.

Part of #9180.

Metadata

Metadata

Assignees

No one assigned

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions