Merge remote-tracking branch 'origin/main' into claude/issue-14895-i18n-extract-check-hint

Author: claude

.claude/agents/os-dev.md

@@ -38,8 +38,11 @@ model: opus
    - PR 上不是你设置的状态属于另一个 actor:⛔ 永不去纠正;疑问进报告,挡住报 blocked。
    - 共享身份让所有人的写入都像你写的;被改写的 body 只是关于 body 的证据,不证明别的。
    - 回退他人的操作(尤其 ready 翻转)永不轮到你;把意外写进 `summary`。
-3. **范围 = 这张 issue,别无其它。** 顺路撞见的无关缺陷立成新的无 assignee issue。
-   - 列进 `out_of_scope_findings`;⛔ 永不在本 PR 里修它。
+3. **范围 = 这张 issue,别无其它。** 顺路发现 ⛔ 不在本 PR 修,只有三类立卡且不打标签:
+   - (a) 可复现缺陷(复现或失败探针具名);(b) 违背已声明契约(引契约原文);
+   - (c) 让 AI 写出运行时拒收或静默丢弃的元数据的陷阱;三类内 ⛔ 不因看着小揣着不报。
+   - 其余 ⛔ 不立卡:观察、死代码、未演练漂移、抛光、风格、文档 nit、命名。
+   - 它们进 PR `## 验收备注`,报告 `out_of_scope_findings` 记 `noted, not filed: …`,席位 ACCEPT 时读。
    - 先搜再立:关键词 + 文件路径扫 open issues;并行 dev 同一小时立的卡只有这一搜能看见。
    - 通道先探后选:同容器先测一条 repo-scoped REST 读;通 ⇒ 走 REST 列表端点 + 本地 grep。
    - 通道对照表见 `.claude/skills/pm-dispatch/references/rest-channel.md`,其 ✓ 按座位实测。
@@ -49,13 +52,10 @@ model: opus
    - 大宗读走零配额档:公开仓单卡网页内嵌 JSON payload 载原始 body + 全评论。
    - 其拼写与边界住 platform-readings;它只覆盖单卡读,⛔ 不拿它做 search。
    - 卡与评论先走 git 与 payload 档,MCP 留给写 + 那一次查重;报告记 MCP 调用计数(`mcp_calls`)。
-   - 立不成 ⇒ 发现连同缘由写进报告交 PM 代立。
-   - ⛔ 不查重硬立与静默弃报同为禁形:发现永不因通道断而消失。
+   - 立不成 ⇒ 发现连同缘由写进报告交 PM 代立;⛔ 不查重硬立与静默弃报同为禁形。
    - PM 的去重读数随派发词下发,当既有事实用,只复核其后增量,⛔ 不重跑。
    - 归挂不散落:落在已排队 issue 完成范围内的发现,立成它的 sub-issue(自动进派发池)。
    - 只是依赖它的,独立立单带一行 `Blocked-by:`;立在修复落地的仓,带回链。
-   - 观察类发现(死代码、未演练漂移、外观抛光)打 `finding` 标签,⛔ 不打 `pm:queue`。
-   - 具体缺陷不打标签,留给 PM 分诊;⛔ 不因看着小揣着不报,平实立单,分诊轮定级。
    - 有界就地修豁免,四条全立才就地修:① 与本卡同一缺陷类;② 机械修且形态已被钉死。
    - ③ 该文件无其他认领持有;④ 同一批门禁族,不新增验证面。
    - 就地修欠两样:认领申报的文件面同轮增补;PR 正文点名该修复并附证据。
@@ -73,10 +73,10 @@ model: opus
 
 1. **重活串行,共享验证锁只有一个入口。** 每次 build/test 都从这里走。
    - `bash scripts/pm/os-verify-lock.sh -c '<command>'`(或 `-- <argv>`);⛔ 永不手搓 `flock`/lockfile。
-   - 入口点保证:等待预算钉死在一次前台调用内;按到达序授予;99 专指没排到;报持锁时长。
+   - 一次前台调用领全部等待预算,阻塞到拿锁或 99;⛔ 不轮询重试,恒设 `OS_VERIFY_LOCK_SLOT`。
    - 它不保证机器空闲:`check:*` 门禁、install、dev server 不走它,与持锁同核并跑。
    - 锁下墙钟绝对值是共享盒读数;只包命令本身,不包你的阅读与判断。
-   - 结论读它印的 `VERDICT command-exit` 行,⛔ 不读裸 `$?`;排队是常态,不是挂死。
+   - 结论读它印的 `VERDICT command-exit` 行,⛔ 不读裸 `$?`;按到达序授予,排队是常态,不是挂死。
 2. **压住堆**:重命令前缀 `NODE_OPTIONS=--max-old-space-size=4096`,要抬需给理由。
 3. **定向,不扫全**:只 build/test 受影响的包,turbo 用 `--concurrency=2`。
    - 单文件跑法 `pnpm --filter <pkg> exec vitest run --maxWorkers=2 <file>`。
@@ -92,8 +92,8 @@ model: opus
    - 消融/变异脚本自带还原 trap(硬线在标准条款节的 ablation 条)。
 7. **排队不是停摆,在轮内主动等。** 持锁的是你不拥有的进程,它的完成不会唤醒你。
    - ⛔ 永不为等锁结束一轮。
-   - 循环:拿到 99 就把间隔花在无锁工作上(测试、changeset、PR 正文、包内 `typecheck`)。
-   - 然后带同名再跑一次:`OS_VERIFY_LOCK_SLOT=<稳定名>` 在第一次尝试之前就设好。
+   - 99 专指没排到,读作 NOT MEASURED;把间隔花在无锁工作上(写测试、changeset、PR 正文)。
+   - 再取以同名续位,⛔ 不从队尾重排:`OS_VERIFY_LOCK_SLOT=<稳定名>` 在第一次尝试前就设好。
    - 没排到的调用把排位寄存,同名再来续原到达戳;不设它,每次离开都从队尾重排。
    - 排队约 20 分钟无进展 ⇒ 先看这次检查能否收窄到不必持锁(收窄要申报,见干净收尾)。
    - 收窄不了就停下报 `blocked` 并点名持锁者:`os-verify-lock.sh --status` 打印持锁者与队列。
@@ -371,7 +371,7 @@ model: opus
   "open_questions": [
     { "question": "…", "options": ["A …", "B …"], "recommendation": "A, because …" }
   ],
-  "out_of_scope_findings": ["filed as #<n>: one-line description"]
+  "out_of_scope_findings": ["filed as #<n>: one-line description", "noted, not filed: one-line observation"]
 }
 ```
 

.claude/skills/pm-dispatch/references/platform-readings.md

@@ -144,6 +144,7 @@
 - `assignees` 实测为陈旧空值而权威读非空;`labels`/`state` 由此存疑、未实测,⛔ 不写成已测。
 - ⇒ ⛔ 认领承载字段(`assignees`、`pm:*` 标签、`state`)永不从本档读。
 - ⛔ 本档的缺席不是读数:要么 `hasNextPage: false`,要么第二通道。
+- 两数组各比 `edges` 长度与 `totalCount`:短即最新几项缺席,认领检查走分页 `get_comments`。
 - 自己刚写的按原写入通道回读;失效方向是空转与重发。
 - 成因:本档经 CDN 缓存,专对最新内容失效且绕不掉,cache-busting 查询串与 no-cache 头都无效。
 - 内容可滞后数分钟到数十分钟;它没有位置性对照 —— 更早内容全在,只有最新几条缺席。
@@ -250,6 +251,7 @@
 - 分步文件在 `{Job name}/{step number}_{step name}.txt`。
 - completeness check 绿只断言没有 worker 静默死,不等于测试通过。
 - 并发输出的相邻不等于因果:先查 `turbo.json` 依赖边,⛔ 不只看 tail。
+- turbo 一败多包同印 `ELIFECYCLE Command failed`:权威读数是 `Failed:` 行与该包自己的 `##[error]`。
 - 公开发出的诊断被推翻时,更正发在同样公开的位置,据它开的 PR 撤回 draft、解绑 `Fixes`。
 - 判正文被截断必须双读取:`.body` 原文,加 `Accept: application/vnd.github.full+json` 的 `.body_html`。
 - 两者同一处断掉才算 issue 端截断。
@@ -288,6 +290,7 @@
 - 第四形:裸 REST `POST /pulls` 建 PR 时,在已带 session-URL 页脚的正文后再追加一条同形页脚。
 - 该追加带前置横线、恰 90 字节,送出体是存储体的严格前缀。
 - ⇒ 追加形态随通道与动作(建 / 改)变,⛔ 不由任一条推其余;写后必回读。
+- 平台在尾部 `---` 前后正反两向归一空行:比对正文只按首个差异偏移,⛔ 不按长度。
 - 评论创建两通道都追加 58 字节 ⇒ 严格解析 `os-dev-report` 必须停在最后一个右花括号。
 - 并行 spec PR 同动 pin 计数断言:被踢不是事故,按 os-regen 序再解一轮。
 - 解冲突两侧收据都保留、按合并顺序堆叠;新计数从合并后源码重数,⛔ 不从收据做算术。

scripts/pm/check-skill-line-ratchet.mjs

@@ -553,7 +553,29 @@ export const CEILINGS = new Map([
   // 「各条规则的出处叙事、事故复盘 根本不重要啊，不需要写入skills啊」) — provenance dates,
   // ruling citations and incident narrative left; every rule stayed. Landed count,
   // headroom 0, same convention (lowering is always legitimate).
-  ['.claude/skills/pm-dispatch/references/platform-readings.md', 359],
+  // Raised 359 → 362 by the fourth-increment ruling — again an ORDINARY raise
+  // under this map's own maintainer exit, ⛔ not a cross-file move. Maintainer,
+  // decision batch #56, 2026-09-06, verbatim and untranslated: 「其他同意」 on the
+  // presented recommendation, option A; the director record's own sentences for
+  // it (comment 5559776878):
+  //   The ceiling in `scripts/pm/check-skill-line-ratchet.mjs` for
+  //   `.claude/skills/pm-dispatch/references/platform-readings.md` moves 359 →
+  //   362 … All three lines land as authored … No existing line is deleted to pay
+  //   for them (option C rejected); no line is dropped (option B not needed).
+  // Spent in full at one line per reading, each written in this file's voice and
+  // wrapped by this module's own `wrapLine` rather than estimated: the zero-quota
+  // payload channel's timeline discriminant +1 (compare each array's `edges`
+  // length against `totalCount`; short means the NEWEST items are absent, so a
+  // claim check goes to the paged `get_comments` read), the authoritative reading
+  // of a multi-package `ELIFECYCLE` spray +1 (the `Failed:` line plus that
+  // package's own `##[error]`), and the first-differing-offset comparison that the
+  // platform's two-way blank-line normalisation around a trailing rule forces +1
+  // = +3 exactly. Nothing was paid in place: line-neutral folding was MEASURED,
+  // not assumed — of the file's 333 adjacent rule pairs, ZERO fit the 120-byte
+  // line cap when merged, so there is no re-wrap slack at all, and re-wrap funding
+  // is refused per the 2026-08-17 rule in any case. Landed count, headroom 0, same
+  // convention.
+  ['.claude/skills/pm-dispatch/references/platform-readings.md', 362],
   // Per-operation REST/GraphQL/git channel mapping — which fleet operation has
   // a REST twin (each row executed in a real session, provenance date carried
   // per row), the handful that are GraphQL-only, and the queue-routing
@@ -963,6 +985,21 @@ export const CROSS_FILE_MOVES = new Map([
         // failure the header warns about. Neither ruling is reopened by this: both
         // are still quoted beside the ceiling, which is where a reader gets back to
         // them, and the lines they bought are the lines this rewrite handed back.
+        {
+          // Quoted beside this entry's ceiling above, where the +3 is accounted
+          // for line by line. Copied from there, not paraphrased.
+          ruling:
+            'the fourth-increment raise on'
+            + ' `.claude/skills/pm-dispatch/references/platform-readings.md` — maintainer,'
+            + ' decision batch #56, 2026-09-06, verbatim and untranslated: 「其他同意」 on option'
+            + ' A, and the sentences that ruling adopts, in the director record\'s own words'
+            + ' (comment 5559776878): "The ceiling in `scripts/pm/check-skill-line-ratchet.mjs`'
+            + ' for `.claude/skills/pm-dispatch/references/platform-readings.md` moves 359 → 362'
+            + ' … All three lines land as authored … No existing line is deleted to pay for them'
+            + ' (option C rejected); no line is dropped (option B not needed)."',
+          date: '2026-09-06',
+          delta: 3,
+        },
       ],
       sources: [
         ['.claude/skills/pm-dispatch/references/lanes/cli.md', 35],

skills/objectstack-data/rules/field-types.md

@@ -88,7 +88,7 @@ options: [
 |:-----|:------------|:-----------|
 | `lookup` | Reference another object (independent) | `reference`, `lookupFilters`, `multiple`, `deleteBehavior` |
 | `master_detail` | Parent–child with lifecycle control | `reference`, `deleteBehavior` (`cascade`/`restrict` — `set_null` is refused) |
-| `tree` | Hierarchical self-reference | `reference` |
+| `tree` | Hierarchical self-reference | `reference` — optional; when written, this object's own name (any other object is refused at parse) |
 | `user` | Person picker — a lookup specialized to `sys_user` (assignee, watchers). Stored identically to `lookup` | `multiple` (collaborators), `defaultValue: 'current_user'` |
 
 > **`multiple: true` lookup ≠ junction object.** A multi-value lookup is stored
@@ -106,9 +106,6 @@ options: [
 | `video` | Video files | — |
 | `audio` | Audio files | — |
 
-There is no per-field attachment config (size limits, allowed types, storage) —
-storage concerns live outside the field schema.
-
 ## Embedded (JSON sub-objects)
 
 Stored as JSON on the parent row — no separate table / FK:

skills/objectstack-data/rules/relationships.md

@@ -8,7 +8,7 @@ Guide for modeling relationships between objects using `lookup`, `master_detail`
 |:-----|:----------|:---------|:--------|:---------|:---------|
 | `lookup` | Independent | Optional by default | Independent | Supported via `summary` | "Related to" |
 | `master_detail` | Coupled (cascade delete) | Forced only under `controlled_by_parent`; else lint-warned | Inherits parent | Supported via `summary` | "Owned by" |
-| `tree` | Self-reference | Optional | N/A | Not available | Hierarchical |
+| `tree` | Self-reference | Optional — and so is `reference`, which when written must name this object itself; any other object is refused at parse, not lint-warned | N/A | Not available | Hierarchical |
 
 ## When to Use lookup vs master_detail