ADR-0006 D2 (SDK half): rename client.projects.* to client.environments.*; unwrap keys follow the wire; JSDoc tells the truth

[hotlong]

Part of #12865 (epic parent; unparked 2026-08-28 by maintainer ruling recorded there). Filed by epic PM session session_65d2faee-1ff4-4be8-be28-72b972c539d9.

Scope (the SDK half of one coordinated rename)

• packages/client/src/index.ts: the projects method namespace becomes environments — all methods including the nested projects.packages block. No aliases (standing v5.0 rename rule; ADR-0006 D3 permanently declined a mapping layer).
• The declared unwrap shapes' keys follow the wire rename: the list shape's projects key becomes environments (the total key stays), and every single-row project key becomes environment. The producer half is the paired cloud card (link in the comment below) — the two halves declare the SAME wire truth.
• The JSDoc sentence naming ProjectProvisioningService.provisionProject: measured 2026-08-28 — zero hits for that class spelling in cloud's packages/service-cloud/src (positive control: the routes files exist and produce these envelopes). Measure what the server actually does today and rewrite the sentence to describe the running system truthfully (ADR-0006 D1 point 3). Do not copy the old class name forward.
• CLI consumers follow in the SAME PR: packages/cli/src/commands/environments/list.ts, create.ts, show.ts — and measure the sibling files bind.ts, switch.ts, environments.test.ts for the same envelope/namespace consumption before assuming they are clean.
• Changeset: major for @objectstack/client (breaking API rename); the changeset text carries the migration entry — that is the release-notes input. Never touch content/docs/releases/**.

Blocked-by: #12038

(PR #12848, which fixes #12038, edits packages/client/src/index.ts, packages/client/exported-any-returns.json, and the client tests — the same files this card must edit. Hard same-file serial: branch from main only AFTER PR #12848 merges. Its diff does not touch the projects block lines, but the exported-any-returns baseline overlaps textually.)

Landing constraint (HARD)

DRAFT PR; do not merge, do not arm auto-merge. Must land in the same coordinated release window as the producer half (cloud). Neither half ships alone: SDK-half-alone is ADR-0006 D3, permanently declined; the maintainer opens the window (see the epic parent).

[hotlong]

Claim: PM loop round 2 (epic #12865, maintainer-directed; blocking edge resolved — PR #12848 merged as dc75ba8 and #12038 closed)
Session: session_65d2faee-1ff4-4be8-be28-72b972c539d9
Branch: claude/issue-12866-adr0006-d2-sdk-environments
Worktree: objectstack-issue-12866
Domain: domain:cli (epic territory declared on #12865)
File surface: packages/client/src/index.ts (the projects namespace region), packages/client tests, packages/client/exported-any-returns.json, packages/cli/src/commands/environments/** (stop on breach; explain in the report)
Container & model: M, mode:subagent, model: opus (tier probe run this dispatch: no path-derived mandate — PM judgment, default judgment tier)
Clause-②: no
(Rationale: implements the already-ruled rename — #12473 option 3, ADR-0006 D2, the maintainer's 2026-08-28 unpark ruling on #12865. packages/spec declares none of these envelope shapes, measured 2026-08-28; the spec contract's accept/reject behavior is unchanged. The breaking surface is the SDK package API, ruled three times over.)
Serial constraints cleared: predecessor PR #12848 (same files: index.ts, exported-any-returns.json, client tests) is MERGED — branch from post-merge origin/main dc75ba8 or later. Re-verified on that ref: the projects namespace still carries the old spelling (now near line 1833), no environments namespace exists. Read-coupling sibling: objectstack-ai/cloud#1691 (producer half, in flight this epic) produces the wire truth these unwrap keys pin; both PRs draft-park and land only in the epic's coordinated window. No other open PR touches this surface (checked the open-PR list this round).

[hotlong]

Claim: dev seat starting the SDK half of the ADR-0006 D2 coordinated rename.

• Session: session_65d2faee-1ff4-4be8-be28-72b972c539d9 / subagent agent-a1d45b69a14c2302b (os-dev, dispatched by the epic PM on ADR-0006 D2 execution carrier (SDK half): rename client.projects.* → client.environments.* + wire unwrap shapes + JSDoc — parked until the next SDK/protocol breaking major #12865)
• Branch: claude/issue-12866-adr0006-d2-sdk-environments (pushed empty as a write-route probe before the first edit)
• Worktree: objectstack-issue-12866, branched from dc75ba857 (current origin/main; contains PR Bind published response contracts for the 17 unbound client-SDK methods; retire the false PackageRollbackResponseSchema (#12038, ruling 1C·2C·3A·4A·5A) #12848, the serial predecessor named on this card)
• Declared file surface: packages/client/src/index.ts (the projects namespace region), packages/client tests, packages/client/exported-any-returns.json, packages/cli/src/commands/environments/**, plus one .changeset/*.md
• Not touched: packages/spec/**, content/docs/releases/**

Landing constraint acknowledged: DRAFT PR only. No un-drafting, no auto-merge arming. This half lands only in the maintainer-coordinated window together with the producer half (objectstack-ai/cloud#1691).

Issue body read in full; no sanitizer truncation observed (the JSDoc class spelling named in the Scope section survived intact, and the body ends on a complete "Landing constraint" section).

Generated by Claude Code