docs(pm): platform-readings.md undraft rows name the ccr REST route beside MCP - #17828
Conversation
…eside MCP
The three undraft rows said MCP was the only channel and that a zero GraphQL
pool left a seat with nothing to do but wait for the reset. Two seats measured
otherwise on 2026-09-12, both with read-back: the session proxy refuses naked
GraphQL and its refusal names REST routes on the seat's own credential, and
`POST .../pulls/{n}/ccr/ready_for_review` really does flip a draft. The rows now
name both channels, keep the naked `PATCH /pulls/{n}` 200 no-op as the forbidden
reading with its own 2026-09-11 date, and state read-back as the criterion.
Rewritten in place, three lines out and three lines in, so the file stays at 449
lines against its 449 ceiling and every other line is byte-identical.
Co-authored-by: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MCLBsUgfykL74aU716rzVK
维护者速读改了什么 — 只改 为什么改 — 这张表是席位排计划时查的事实表,写着「只能等」席位就真的会停;2026-09-12 两个席位各自实测有出口(cli 席 07:46Z、本席 08:45Z,都带读回)。姊妹表 风险与代价(含回滚) — 纯文档三行,零运行时影响;回滚即 revert 一个 commit。要知道的一点:devx 车道的 PR #17803(#15233)也在改这个文件的第 376–384 行,区域不重叠、各自的行数账独立,先合哪个都行。本席派发时漏看了那个 PR 的文件清单,dev 发现后如实申报,本席裁定照常交付(ACCEPT 5645049939)。 席位意见 — 接受,契约档复核;三行字节数 106/118/116,均在 120 内。 你要做的 — 受管面( Generated by Claude Code |
The three undraft rows in
.claude/skills/pm-dispatch/references/platform-readings.mdsaid that MCP was the only channel that can take a pull request out of draft, and that a seat whose GraphQL pool has hit zero can do nothing but wait for the reset. Two seats measured otherwise on 2026-09-12, both with read-back: the session proxy refuses naked GraphQL, its refusal names REST routes carried on the seat's own credential, andPOST .../pulls/{n}/ccr/ready_for_reviewreally does flip a draft. The rows now name both channels, keep the nakedPATCH /pulls/{n}200 no-op as the forbidden reading with its own 2026-09-11 date, and state read-back throughGET /pulls/{n}as the criterion. Rewritten in place — three lines out, three lines in — so the file stays at 449 lines against its 449 ceiling and every other byte of it is unchanged.Fixes #17824
Acceptance notes
Premises, checked on
origin/mainf830fa21before the first edit3 insertions(+), 3 deletions(-)on one file.scripts/pm/check-skill-line-ratchet.mjspins it at CEILINGS 449 with headroom 0,MAX_LINE_BYTES = 120per prose line, and a widest-table-row pin of 0 (the file carries no table row).pnpm check:pm-skill-ratchetprintsplatform-readings.md is 449 lines (ceiling 449; headroom 0)andwidest table row is 0 bytes (pin 0; headroom 0). No ceiling, noruledRaisesrecord and noCROSS_FILE_MOVESparticipant was touched — a same-count, same-width edit moves nothing in the ratchet.Governed Surface Queue Guardas the seventh REQUIRED_CONTEXTS row #17803 (draft, opened 2026-09-12T05:58Z, headclaude/issue-15233-required-contexts-seventh-row) does touchplatform-readings.md. Checked by reading the file list of all 20 open PRs, not from memory. Its hunk is at lines 376–384 (therequired checkscount row) and adds three lines there, so it is textually disjoint from lines 47–49, it merges cleanly with this branch, and its own ceiling arithmetic is its own. The dispatch's standing instruction is that any false premise meanspremise_still_valid: falseand no PR; the card's substantive premises (1 and 2) both hold, and premise 3 is a hot-file serialization check whose purpose is satisfied in substance, so the work was completed and the deviation is declared here and in the report for the PM to adjudicate rather than taken silently.The three rewritten lines and their byte counts (budget 120 bytes per line, measured as UTF-8 bytes)
POST .../pulls/{n}/ccr/ready_for_reviewand MCP withdraft: false.2026-09-12 两席实调, keeps the standing fact that naked GraphQL is refused in-session, corrects the second half (the REST route that refusal suggests is exactly theccrone), and replaces 「池 0 只能等重置」 with the exit.PATCH /pulls/{n}withdraft: falsestill answers 200 and changes nothing (its own 2026-09-11 date kept), and read-back throughGET /pulls/{n}is the criterion.Work items
POST .../pulls/{n}/ccr/ready_for_reviewand the read-back vocabulary (「读回才作数」,GET /pulls/{n}, the naked-PATCH200 no-op dated 2026-09-11) are taken from PR docs(pm): rest-channel.md rows 1–2 name the ccr REST routes for the draft flip and auto-merge #17823's head, so a reader of both tables sees one fact in one vocabulary.Out of scope, as instructed — the
enable_pr_auto_mergerows (50 / 58 / 60),rest-channel.md(PR #17823's),SKILL.md, the ratchet script, the timeline-actor question, and any card edit or ruling.git grepfinds no other file in the tree restating the undraft fact, so no sibling copy is left stale by this edit.Changeset — none.
.claude/**publishes nothing from any released package, so this PR carries theskip-changesetlabel instead, applied additively and read back.Gates — derived in this worktree with
node scripts/pm/dispatch-gates.mjs --commands(no paths), all 16 run, all exit 0; reconciled with--ran, which reports16 derived famil(ies) accounted for — 16 run, 0 NOT-MEASURED (a DERIVED zero).pnpm --filter @objectstack/lint run check:doc-formula-expressionsfirst exited 3 —PREREQUISITE NOT MET, nothing measured — and was re-run to exit 0 afterpnpm exec turbo run build --filter=@objectstack/formula --filter=@objectstack/lintunderscripts/pm/os-verify-lock.sh. Exit codes were captured before any pipe.维护者速读(草稿)
改了什么 — 只改了一个文件的第 47–49 行:PM 平台读数事实表里关于「把 PR 从 draft 转正」的三行。原文说这件事只有 MCP 一条路,而 GraphQL 配额归零时只能干等重置。现在三行改为:两条通道(席位凭据走
ccrREST 路,MCP 走draft: false)、GraphQL 拒绝信里建议的那条 REST 正是ccr路、裸PATCH仍是 200 空操作且判据是读回。行数、行宽、上限全部不动。为什么改 — 这张表是每个席位排计划时查的事实表。它说「只能等重置」,席位就真的会停下来等;而 2026-09-12 两个席位各自实测(都做了读回)证明有出口。事实表写错一行,代价是一个席位一整段的错误红窗计划。姊妹表
rest-channel.md已由另一个 PR 更正,本 PR 让两张表口径一致。风险与代价(含回滚) — 风险很低:纯文档行,不影响任何运行时或构建产物。代价是这三行现在承载两个日期(2026-09-12 的新读数与 2026-09-11 的裸
PATCH读数),读者需要分清。回滚就是 revert 这一个 commit,文件回到 449 行的原状,不牵动任何其他文件或上限记录。席位意见 — (留空,待席位验收填写)
你要做的 — 这是受管面(
.claude/**)的改动,按 Prime Directive #14 由维护者手工合并。请确认两点:① 三行新文本是否如实反映你认可的平台事实;② 上面 premise 3 的偏差处置(发现有另一个 open PR 碰同一文件的另一区域,仍然交付了本 PR)是否接受。确认后手工合并即可,⛔ 不要让任何 agent 席位把它翻成 ready 或挂 auto-merge。Generated by Claude Code