From 028dbc85e2a73b65a7b9bdaf9088c92685576dc1 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 1 Sep 2026 02:24:50 +0000 Subject: [PATCH] docs(pm-skills): retract the REST issues-list completeness certificate The dedup ladder's REST branch certified the list endpoint's results as complete. Measured in one container against this repo: walking the `Link: rel="next"` cursor the endpoint returns reports itself exhausted at 102 items, while the `&page=1,2,3...` walk over the identical query returns 448 and matches `open_issues_count` (449 at re-read, 23 open PRs). A dedup grep over the returned 102 answers "no duplicate" with total confidence -- the failure the ladder routes seats INTO when `search_issues` goes to a session-level zero. The certificate is replaced in place by the obligation it was standing in for: completeness is self-proved, by the page-number walk plus a total-count cross-check. Line-neutral -- the file stays at its 314-line ceiling, and the change is a correction of a measured-false line, not an addition. The cause is NOT explained here and is not claimed to be: whether the truncation is GitHub's own cursor behaviour or the session egress proxy rewriting the `Link` header is unmeasured. The prescription removes the dependency on that header; it does not diagnose it. --- .../skills/pm-dispatch/references/platform-readings.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/.claude/skills/pm-dispatch/references/platform-readings.md b/.claude/skills/pm-dispatch/references/platform-readings.md index ac074f15df..1970159b8c 100644 --- a/.claude/skills/pm-dispatch/references/platform-readings.md +++ b/.claude/skills/pm-dispatch/references/platform-readings.md @@ -144,10 +144,10 @@ 才验」:归零下空结果与真无重复逐字节同形,读作「搜过了,没有」⇒ 重复卡照开、空车道 照停(实测:控制词对一张刚派发几分钟的卡回 0)。控制词回 0 ⇒ 本会话 search 已坏,**立刻 换通道,⛔ 不重试**(重试只烧配额);换哪条按上面的探针与降级梯 —— 探针绿走 **REST 列 - 表端点** `GET /repos/{o}/{r}/issues?state=open&labels=a,b&per_page=N`(core 桶、结果**完整**、 - `labels` 真 AND;`GET /search/issues` **不是**退路,见下条),403 走降级梯 MCP 档(单标签一次 - 读全 + 本地求交 —— ⛔ **不是翻页手扫**:实测 226 张 open 只扫了 100 张,**不完整枚举比零 - 结果更危险**)。⛔ 已推翻别再追:「限定符打零」两次实测反证,限定符只收窄不破坏。 + 表端点** `GET /repos/{o}/{r}/issues?state=open&labels=a,b&per_page=N`(core 桶、 `labels` 真 AND;⛔ 完整性 + 自证:`&page=N` + 总数核对;`GET /search/issues` **不是**退路,见下条),403 走降级梯 MCP 档(单标签一 + 次读全 + 本地求交 —— ⛔ **不是翻页手扫**:实测 226 张 open 只扫了 100 张,**不完整枚举比 + 零结果更危险**)。⛔ 已推翻别再追:「限定符打零」两次实测反证,限定符只收窄不破坏。 - **会话代理只服务 repo-scoped 路径,`/search/*` 的 403 体解析成净零**:代理回 403 + 体 `sessions are bound to their configured repositories`,而那是**合法 JSON** —— 读 `total_count` 得 None、 打印成 `total: None`,与真空集只差一个字符,三连查重于是回三个干净的零,而请求根本没跑