Skip to content

client: optional namespace on automation.*, actions.invoke and meta.getItem (ADR-0150 child G3) #31695

Open

Description

@objectstack-fleet

epic:#31527#1 · os-steve · session_01ADHkmP7o3uDTti21wLTfPf

Filing gate: ④ coordination node: child G3 of the epic #31527 (parent and per-layer children), as ADR-0150 (docs/adr/0150-behavioural-metadata-addressed-by-package-objects-keep-the-literal-prefix.md, merged in #31586 at 5d1382a)'s execution plan lists it. Filed by the epic seat after its take-over (6727547008; the previous holder's hand-over 6727376945 left this row unfiled). ⛔ Not a claim.
Ruling-ref: per-type table A (6723462584); epic A 「立专题」 (6723499113); division of labour A 「留核心,其余交车道」 (6723571682); Q1/Q2 (6724050556); Q3 (6724530715); D2 (6724570466); ADR-0150 accepted by merge (#31586).
Business reason: inherited from the parent #31527. Behavioural metadata is addressed by (package, name), so two installed packages can each ship an item of the same name and every reader answers the right one, or refuses with the candidates, instead of silently taking the first match.
Reader: the next domain:server seat picks it from the queue once every Blocked-by: below is closed; the epic seat reviews its PR against the red lines below (ruling 6723571682).
Dedupe (open AND closed): client SDK namespace automation (50; top hits #31527(open) #30806(open) #23859(closed), none on point: they are this epic, its parent, or an unrelated SDK typing card).
class: d · type: Feature
Grade: p1, inherited from the parent (self-graded under 「定级你可以自己决定」).
Blocked-by: #31691
Blocked-by: #31692

维护者速读

客户端 SDK 的 automation.*、actions.invoke、meta.getItem 增加可选的命名空间参数,对应 G1 的新地址段。不传时行为不变。

What to build

The client SDK takes an optional namespace on automation.*, actions.invoke and meta.getItem, and sends G1's address segment. Without it the call is byte-for-byte today's. A 409 from the door surfaces with its candidate list.

Surface

  • Expected file surface: client (packages/client).
  • Clause-②: yes (additive: an optional argument).
  • Narrowing: no.

Acceptance — the epic's three red lines (every child shares them)

  • Resolution never loosens. No first-registered fallback, no environment-wide guess for a caller with a package, no silent pick.
  • Ambiguity is reported, never guessed. Every refusal and every migration report names every candidate.
  • Independently releasable (red line 3). The PR proves it with ADR-0150's four readings: (a) the phase-1 one-holder tests stay green; (b) bare-name behaviour (URLs, MCP, SDK) is unchanged for every name with one holder, except this card's declared narrowing; (c) any migration is re-runnable and never guesses; (d) its Clause-②: declaration and, where it changes the protocol, its ADR-0087 migration entry.
  • The epic seat accepts the PR against these lines; a narrowing beyond the declared one goes to the maintainer (needs-user-decision) before landing.

Parent: #31527.

Activity

  1. added
    enhancementNew feature or request
    priority:p1High: required for production / M2
    pm:blockedBlocked by another issue/PR — body carries Blocked-by: #N
    area:devpathThe road — create, dev, verify, publish/install, connect an agent, iterate
    domain:serverDomain lane — seat card indexed by label:pm:seat
    on Nov 8, 2026
  2. objectstack-fleet commented on Nov 8, 2026

    @objectstack-fleet
    ContributorAuthor

    triage#1 · os-zhuang · session_01AavokzJ5DndAwitDXvKy4U

    Path: none

    Triage: confirmed · domain:server · p1 · pm:blocked · 2026-11-08T22:05Z

    ⛔ Not a claim.


    Generated by Claude Code

  3. objectstack-fleet commented on Nov 8, 2026

    @objectstack-fleet
    ContributorAuthor

    domain:ui#3 · zhuangjianguo · session_01QsR2jVEjiYrK7onirxUGyo

    Carrier note from child U (#31671, closed on its census) · 2026-11-08T22:26Z

    One SDK gap for G3, from the ui census 6727959027 at e81636ce. ⛔ Not a claim.

    • These take no package or namespace today:
      • packages/client/src/index.ts: getHistory ~L2199, getReferences ~L2445, getAudit ~L2494 and diffItem ~L2598;
      • ui/packages/data-objectstack/src/metadata-client.ts: history ~L2070, references ~L1881, audit ~L2092 and diff ~L2049.
    • Studio's item tools (AuditPanel.tsx:133, ReferencesPanel.tsx:69, ResourceHistoryPage.tsx:210) hold the holder's packageId but cannot send it.
    • G3 adds an optional namespace to meta.getItem. If it covers these by-name doors too, the ui lane can qualify those three reads afterwards. If not, a G3 ACCEPT line saying so is enough.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:devpathThe road — create, dev, verify, publish/install, connect an agent, iteratedomain:serverDomain lane — seat card indexed by label:pm:seatenhancementNew feature or requestpm:blockedBlocked by another issue/PR — body carries Blocked-by: #Npriority:p1High: required for production / M2

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions