@akagilnc/pi-workflow-roles 0.1.4200 → 0.1.4211

package/CLAUDE.md

@@ -82,7 +82,7 @@ A probe is temporary evidence. After its evidence purpose is disposed, either de
 
 **票面先过给事中再开工；决策问题上呈陛下。**（ADR 0074：票庭审读由大理寺移交门下省给事中。）
 
-**设计修订后重新过庭。** 施工中实质设计变更须由陛下拍定；拍定后将修订后的票重新送给事中，由起居郎补录修订依据（ADR 0075；起居郎与票庭的先后归调用者，`no-call-rule`），给事中通过后再按新设计继续施工。既定设计内的实现取舍不属设计修订。
+**设计修订后重新过庭。** 施工中实质设计变更须由陛下拍定；拍定后将修订后的票重新送给事中，由起居郎补录修订依据（ADR 0075：不规定谁调用起居郎、顺序归调用者），给事中通过后再按新设计继续施工。既定设计内的实现取舍不属设计修订。
 
 丞相编排建议：御史台 findings 宜经大理寺裁决后再派修理腿（劾→判→修）。
 

package/README.zh-CN.md

@@ -138,7 +138,7 @@ ak-role resume <runId> "<裁定>"
 | **通进司** | collector | **承接百议／收证。** 门下省下的收证衙门：收集外部 GitHub PR 材料与意见，只收不审、不替人裁决。canonical 键仍为 `collector`。 |
 | **校书郎** | merger | **雠校异文。** 面对不同来源的修改，负责整理、校合与调和。保留双方有价值的部分，解决彼此冲突；无进行中合并、无活可干或遇到无法自行决定之处，则升级。 |
 | **游奕使** | navigator（随公开入口顶层腿自动出席，亦可 `ak-role navigator` 直调） | **巡行问路。** 不掌具体事务，而是观察全局变化，结合当前局面提醒下一步方向。它提供建议与路径参考，但最终选择仍由执掌之人决定。 |
-| **起居郎** | diarist（`ak-role diarist` 单独传召；给事中受理内自动先起，#742） | **修起居录。** 为本票搜集、整理决策依据，写进每票起居录；LLM 自行搜集、整理、认票（#779 后无机械验真，机械只做 IO；起居录供符宝郎读录核旨）。只记录已作出的决定，不立法、不批准设计、不指挥施工。规范见 [ADR 0075](docs/adr/0075-ticket-provenance-diarist-pipeline.md) `diarist-is-role`、[ADR 0081](docs/adr/0081-diarist-case-context-and-delivery.md)。 |
+| **起居郎** | diarist（`ak-role diarist` 单独传召；给事中受理内自动先起，#742） | **修起居录。** 为本票搜集、整理决策依据，写进每票起居录；LLM 自行搜集、整理、认票（#779 后无机械验真，机械只做 IO；起居录供符宝郎读录核旨）。只记录已作出的决定，不立法、不批准设计、不指挥施工。规范见 [ADR 0075](docs/adr/0075-ticket-provenance-diarist-pipeline.md)（起居郎是 LLM 角色）、[ADR 0081](docs/adr/0081-diarist-case-context-and-delivery.md)。 |
 
 其余席位：
 

package/dist/acp-host/production-host.js

@@ -2353,7 +2353,7 @@ var init_packaged_role_registry = __esm({
         activationStage: "load-and-install",
         sessionMaterials: AUDITOR_PUBLIC_SESSION_MATERIALS
       },
-      // #708 / ADR 0075 `diarist-is-role` / #779: 起居郎 is a seat like any other.
+      // #708 / ADR 0075（起居郎是 LLM 角色）/ #779: 起居郎 is a seat like any other.
       // No input flag — LLM finds materials itself (caller-transparent).
       {
         role: "diarist",
@@ -21908,9 +21908,9 @@ init_reviewer_pinned_git();
 init_reviewer_output();
 import { Type as Type23 } from "typebox";
 var reviewerAmendmentsSchema = Type23.Object({
-  standards: Type23.Optional(Type23.String({ description: "\u76F8\u5BF9 Standards \u5B50\u62A5\u544A\u7684\u589E\u91CF\uFF1A\u589E finding\u3001\u64A4\u56DE\u6216\u4E8B\u5B9E\u66F4\u6B63" })),
-  spec: Type23.Optional(Type23.String({ description: "\u76F8\u5BF9 Spec \u5B50\u62A5\u544A\u7684\u589E\u91CF\uFF1A\u589E finding\u3001\u64A4\u56DE\u6216\u4E8B\u5B9E\u66F4\u6B63" }))
-}, { additionalProperties: true, description: "\u76F8\u5BF9\u5B50\u62A5\u544A\u7684\u53EF\u9009\u8F74\u589E\u91CF\uFF1B\u975E\u66FF\u4EE3\u62A5\u544A\u3002\u65E0\u589E\u91CF\u7684\u8F74\u53EF\u7701\u7565\u3002" });
+  standards: Type23.Optional(Type23.String({ description: "\u6807\u51C6\u8F74\u5F39\u7AE0\u6B63\u6587" })),
+  spec: Type23.Optional(Type23.String({ description: "\u89C4\u683C\u8F74\u5F39\u7AE0\u6B63\u6587" }))
+}, { additionalProperties: true, description: "\u9010\u8F74\u5F39\u7AE0\u6B63\u6587\uFF1B\u65E0\u5F39\u7AE0\u7684\u8F74\u53EF\u7701\u7565\u3002" });
 var REVIEWER_STATUS_DESCRIPTION = "completed | refused \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8";
 var reviewerOutputVariants = Type23.Union([
   Type23.Object({

package/dist/analyst-gate-cycles-read.js

@@ -19,7 +19,7 @@
  * the same throw→ledger `auditor-roles` unreadable seam. Unknown/non-contract
  * dispatch status stays loud (#475 abolished Gatekeeper incomplete special-case).
  * Lawful province non-dispatch release (`pass` on a dispatch tool) opens no
- * round and must not throw (#597 / ADR 0074 gate-non-mandatory).
+ * round and must not throw (#597 / ADR 0074: 角色调动无强制，交卷闸派发不断).
  * True non-gate volumes (soul-audit noise, etc.) stay omitted from pairing.
  * Historical dispatch↔officer pairing requires a shared typed
  * `ak_auditor_parent_attempt_binding.parent.attemptEntryId` — never seat/time guessing.

package/dist/diarist-contracts.js

@@ -1,5 +1,5 @@
 /**
- * Public 起居郎 (diarist) terminating receipt contracts — ADR 0075 `diarist-is-role`.
+ * Public 起居郎 (diarist) terminating receipt contracts — ADR 0075（起居郎是 LLM 角色）。
  * Lawful explicit releases: completed (入录) | escalate (认不出本庭对象上抛).
  * Machine facts about the volume come from the mechanical sitian seam, never
  * from model self-report (锚定宪法); this module owns the receipt shape only.

package/dist/headless-host/production-host.js

@@ -2656,7 +2656,7 @@ var init_packaged_role_registry = __esm({
         activationStage: "load-and-install",
         sessionMaterials: AUDITOR_PUBLIC_SESSION_MATERIALS
       },
-      // #708 / ADR 0075 `diarist-is-role` / #779: 起居郎 is a seat like any other.
+      // #708 / ADR 0075（起居郎是 LLM 角色）/ #779: 起居郎 is a seat like any other.
       // No input flag — LLM finds materials itself (caller-transparent).
       {
         role: "diarist",
@@ -22032,9 +22032,9 @@ init_reviewer_pinned_git();
 init_reviewer_output();
 import { Type as Type23 } from "typebox";
 var reviewerAmendmentsSchema = Type23.Object({
-  standards: Type23.Optional(Type23.String({ description: "\u76F8\u5BF9 Standards \u5B50\u62A5\u544A\u7684\u589E\u91CF\uFF1A\u589E finding\u3001\u64A4\u56DE\u6216\u4E8B\u5B9E\u66F4\u6B63" })),
-  spec: Type23.Optional(Type23.String({ description: "\u76F8\u5BF9 Spec \u5B50\u62A5\u544A\u7684\u589E\u91CF\uFF1A\u589E finding\u3001\u64A4\u56DE\u6216\u4E8B\u5B9E\u66F4\u6B63" }))
-}, { additionalProperties: true, description: "\u76F8\u5BF9\u5B50\u62A5\u544A\u7684\u53EF\u9009\u8F74\u589E\u91CF\uFF1B\u975E\u66FF\u4EE3\u62A5\u544A\u3002\u65E0\u589E\u91CF\u7684\u8F74\u53EF\u7701\u7565\u3002" });
+  standards: Type23.Optional(Type23.String({ description: "\u6807\u51C6\u8F74\u5F39\u7AE0\u6B63\u6587" })),
+  spec: Type23.Optional(Type23.String({ description: "\u89C4\u683C\u8F74\u5F39\u7AE0\u6B63\u6587" }))
+}, { additionalProperties: true, description: "\u9010\u8F74\u5F39\u7AE0\u6B63\u6587\uFF1B\u65E0\u5F39\u7AE0\u7684\u8F74\u53EF\u7701\u7565\u3002" });
 var REVIEWER_STATUS_DESCRIPTION = "completed | refused \u2014 \u5F62\u72B6\u6307\u5F15\uFF0C\u975E schema \u95F8";
 var reviewerOutputVariants = Type23.Union([
   Type23.Object({

package/dist/host-transition-prior-native.js

@@ -58,7 +58,7 @@ async function listSitianRecordPaths(sessionParent) {
  * still yields a typed switch (empty path list).
  *
  * Pi wrote its own session.jsonl; every other host's run volume is the sitian
- * record set on the live run (ADR 0077 `record-scope-phase-two`, #717) — the CLI's
+ * record set on the live run (ADR 0077 全宿主 session 卷宗统一直写, #717) — the CLI's
  * own journals stay in the operator home and are never copied here.
  */
 export async function projectHostTransitionPriorNative(input) {

package/dist/packaged-role-registry.js

@@ -195,7 +195,7 @@ const PUBLIC_ROLE_RECORDS = [
     activationStage: "load-and-install",
     sessionMaterials: AUDITOR_PUBLIC_SESSION_MATERIALS
   },
-  // #708 / ADR 0075 `diarist-is-role` / #779: 起居郎 is a seat like any other.
+  // #708 / ADR 0075（起居郎是 LLM 角色）/ #779: 起居郎 is a seat like any other.
   // No input flag — LLM finds materials itself (caller-transparent).
   {
     role: "diarist",

package/dist/pi/role-turn-host.js

@@ -72,7 +72,8 @@ function buildMethodArgs(methods) {
     return skillArgs;
 }
 /**
- * Pi-native `/skill:<name>` for a single forced method (ADR 0082 `pi-no-privilege`).
+ * Pi-native `/skill:<name>` for a single forced method (ADR 0082: pi is one adapter
+ * with no privilege; Pi-only seams stay inside the pi adapter).
  * Driven by typed RoleTurnRequest.methods — middle-layer decision, Pi-only syntax.
  * Zero/many methods leave the prompt alone (Fixer optional pair stays `--skill` only).
  */

package/dist/public-cli/auto-resume.js

@@ -70,8 +70,8 @@ async function finalizeExceptionRunBestEffort(runDirectory, io) {
 /**
  * Thrown by dispatchPostAdmissionTurn when a failure happens inside its own
  * settlement authority (presentControlledFailure) after the host turn
- * genuinely started — never to fabricate a replacement terminal (ADR 0080
- * single-settlement-disposition: settlement stays exactly presentControlledFailure
+ * genuinely started — never to fabricate a replacement terminal (ADR 0080:
+ * one settlement disposition owner — settlement stays exactly presentControlledFailure
  * / settleFailureTerminalResult, or — once the retry budget is exhausted —
  * this loop's own dispatchExceptionFailureTerminal). Its only job is to carry
  * the "turn already started" fact across the throw boundary so this loop

package/dist/public-cli/case-dossier-delivery.js

@@ -1,7 +1,7 @@
 /**
- * 系统随案递送本票起居录的中立指针段（ADR 0081 `automatic-case-material`；
+ * 系统随案递送本票起居录的中立指针段（ADR 0081：公共入口直接挂案卷，Soul 只说明用途不负责派送；
  * #709 公共入口通用递送与 #742 给事中受理链路同源；
- * 指针输入沿 ADR 0079 `summons-pointer-input`，不把卷宗正文塞进提示词）。
+ * 指针输入沿 ADR 0079（指针是绑定材料由代码精准递送），不把卷宗正文塞进提示词）。
  * 只读已有案卷：不刷新、不生成、不校验内容、不新增拒收或停工条件。
  * 机器文本仅中立标识材料（ADR 0073），用途说明归角色材料所有。
  *

package/dist/public-cli/main.js

@@ -15142,7 +15142,7 @@ var init_packaged_role_registry = __esm({
         activationStage: "load-and-install",
         sessionMaterials: AUDITOR_PUBLIC_SESSION_MATERIALS
       },
-      // #708 / ADR 0075 `diarist-is-role` / #779: 起居郎 is a seat like any other.
+      // #708 / ADR 0075（起居郎是 LLM 角色）/ #779: 起居郎 is a seat like any other.
       // No input flag — LLM finds materials itself (caller-transparent).
       {
         role: "diarist",
@@ -30294,7 +30294,7 @@ async function invokeCourtDiarist(input, env, io) {
     ...env.signal === void 0 ? {} : { signal: env.signal },
     ...input.boundTicketNumber === void 0 ? {} : { boundTicketNumber: input.boundTicketNumber },
     // Child seat selects from the composition-root table. Do not pass the
-    // already-selected parent adapter (#840 / ADR 0082 host-flag-two-channels).
+    // already-selected parent adapter (#840 / ADR 0082: --host 旗标>席位配置>缺省 pi).
     ...env.hostAdapters === void 0 ? {} : { hostAdapters: env.hostAdapters }
   });
   const roleOutcome = result2.terminal?.roleOutcome;

package/dist/public-cli/post-admission.js

@@ -209,8 +209,8 @@ export async function presentControlledFailure(admitted, failureInput, adapters,
 /**
  * presentControlledFailure, called only where the host turn has already
  * genuinely started (#840 r9 判词 class 1 boundary). If presentControlledFailure
- * itself fails, this never fabricates a replacement terminal (ADR 0080
- * single-settlement-disposition — presentControlledFailure /
+ * itself fails, this never fabricates a replacement terminal (ADR 0080:
+ * one settlement disposition owner — presentControlledFailure /
  * settleFailureTerminalResult stays the one authority); it re-throws a
  * TurnDispatchedFailure so runWithAutoResumeLoop still learns the turn
  * started and selects a resume payload on the next attempt, while settling
@@ -230,8 +230,8 @@ async function settleAfterTurnStarted(admitted, failureInput, adapters, authorit
  * (needsPersist — station-child / resumable auto-resume loop, #416/#840):
  * that write must land outside the loop's own retried-dispatch try, but its
  * failure still settles through the single existing controlled-failure
- * authority (settleAfterTurnStarted / presentControlledFailure, ADR 0080
- * single-settlement-disposition) — never a second hand-rolled
+ * authority (settleAfterTurnStarted / presentControlledFailure, ADR 0080:
+ * one settlement disposition owner) — never a second hand-rolled
  * classify/artifact/Terminal (#836 r12 class 3), and never lawful/non-lawful
  * settling differently (#836 r13 class 2: a caller's io here may be a no-op,
  * so a stderr-only trace is never seen and the failure is otherwise
@@ -437,8 +437,8 @@ export async function dispatchPostAdmissionTurn(input) {
         // 判词 class 1 boundary — 覆盖 executeTurn 已启动后至返回带 turnDispatched
         // 结果前的全部异常). Each fallible step routes any failure through the
         // single existing settlement authority (presentControlledFailure /
-        // settleFailureTerminalResult) rather than a second one (ADR 0080
-        // single-settlement-disposition) — never by fabricating a terminal here.
+        // settleFailureTerminalResult) rather than a second one (ADR 0080:
+        // one settlement disposition owner) — never by fabricating a terminal here.
         // A cleanup step that runs only after a real settlement (clearCurrentCourt)
         // is protected by logging and keeping that already-obtained result, never
         // by discarding it (#840 已交劳动只整理终局不重做). A failure inside the

package/dist/public-cli/seat-ticket-binding.js

@@ -1,7 +1,7 @@
 /**
  * Shared ticket identity seam for public court seats (#635 / #637 / #709 / #747 / #771).
  *
- * ADR 0075 `diarist-resolves-ticket-llm-layer`: the diarist LLM recognizes the
+ * ADR 0075（起居郎 LLM 自行认票）: the diarist LLM recognizes the
  * court target; recognized ticket → provenance, truly unbound → no provenance,
  * or escalate when it cannot recognize one. Code does not re-judge the ticket
  * (锚定宪法; owner 2026-09-08: 代码不准做判断). Other seats reuse a typed

package/dist/ticket-provenance.js

@@ -222,7 +222,7 @@ export function renderTicketProvenanceMarkdown(input) {
 /**
  * Ensure the per-ticket JSONL volume partition exists (empty file OK).
  * Every bound-ticket court establishes the volume even with zero diary entries
- * (ADR 0075 ticket-provenance-file — 每票一份起居录). Does not forge entries.
+ * (ADR 0075: 每票一份起居录送司天台). Does not forge entries.
  */
 export function ensureTicketProvenanceVolume(ticketNumber, cwd, home) {
     const volume = resolveTicketProvenanceVolume(ticketNumber, cwd, home);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akagilnc/pi-workflow-roles",
-  "version": "0.1.4200",
+  "version": "0.1.4211",
   "description": "Soul-bound workflow roles for Pi",
   "type": "module",
   "license": "Apache-2.0",

package/resources/diarist-collect.md

@@ -1,44 +1,37 @@
-# 起居郎收集方法（owner-domain）
+# 起居郎收集方法
 
-本文件是起居郎语义收集的方法真源（ADR 0075 `diarist-llm-collector` / `transcribe-whole-blocks`；#779 调用方无感）。
+本文件是起居郎语义收集的方法真源（ADR 0075；#779 调用方无感）。
 
 ## 任务
 
-为本案找出决策相关材料，以**整块**交卷入本票起居录。材料由你自己去找——不要等调用方贴路径、附件或预切清单。
+判断本庭对象是哪张票、本票对话起止于何处并交出边界；正文与定位由机械按边界从会话卷投影。不整块誊录正文，不自行搜集材料替代机械投影；本文件不新立职掌、不替 soul 立法、不复制 schema 与 CLI 说明。
 
-## 如何找材料
+## 如何定边界
 
-你是 LLM，自己读：
+你是 LLM，自己读以判断边界：
 
-- 本仓 Claude 会话卷：`~/.claude/projects/` 下与本仓相关的目录（路径里的 `_` 在目录名里常写作 `-`；主 clone 与 worktree 可能共用或分列，自行辨认）
+- 本仓相关会话卷（路径里的 `_` 在目录名里常写作 `-`；主 clone 与 worktree 可能共用或分列，自行辨认）
 - 本票票面与评论：用 `gh` 或等价方式读 GitHub issue
-- 票面引用的 ADR 原件：仓内 `docs/adr/`
 
-调用方只给传召文与 `--project`；不附清单、不写候选路径。找不到就如实说明，不编造。
+调用方只给传召文与 `--project`。边界定不下来就如实说明并走既有 reask/escalate，不编造。
 
-## 何谓决策相关
+## 何谓本票对话
 
-与下列任一有关的整块均应入选：
+与本票决策相关的陛下与 runner 对话均应落入边界：
 
 - 本票要立什么、不立什么、范围如何收束
 - 命名、工序先后、调用面、闸位、存量是否补档等裁决
 - 对既有 ADR / 法源的采纳、修正或明确不适用
 - 陛下（owner）原话、确认、否决、收口条件
-- 为上述裁决提供必要上下文的紧邻块
+- 为上述裁决提供必要上下文的紧邻对话
 
-无关闲聊、纯工具噪声、与本票决策无涉的他票材料不选。相关性由你裁决。
-
-## 誊录整块
-
-- 入选即整块保留：交卷对象里写完整 `transcript`，并带上可回指的 `sourceRef`（会话文件+entry、issue URL、ADR path 等）。
-- 不指针化、不摘要替代正文。
-- 宁多勿漏：拿不准是否决策相关时入选。
+工具输出与机器块不入录。无关闲聊、与本票决策无涉的他票材料不划进边界。相关性由你裁决。
 
 ## 本票身份
 
-由你（本席 LLM）判断当前要办的是哪张票，在交卷对象上以 typed 字段交出——代码不做认票裁定（ADR 0075 `diarist-resolves-ticket-llm-layer`；owner：代码不准做判断／机械层不判断 LLM 输出）。
+由你（本席 LLM）判断当前要办的是哪张票，在交卷对象上以 typed 字段交出——代码不做认票裁定（ADR 0075：起居郎 LLM 自行认票；认得出→有录，真无票→无录；机械层不做引文/票号/相关性判定）。
 
-- 认得出本庭对象：`status: completed` 且 `ticketNumber: N`，并交 `entries`（可空）。
+- 认得出本庭对象：`status: completed` 且 `ticketNumber: N`，并交边界。
 - 真无票对象（方案/派单/处置案等）：`status: completed` 且 `ticketNumber: null`（或省略）。真无票是合法结果，不入录。
 - 认不出本庭对象是哪一张：`status: escalate` 并写明 `reason`。识别不了就上抛，不得省略票号假装无录，也不得猜一个号。
 - 不得从旁及的他票或任何猜测里挑一个号顶替认不出的身份。

package/src/activation-ledger.ts

@@ -100,7 +100,7 @@ export function correlationIdentityFromEnv(
 
 /**
  * Descriptor-driven top-level pick: only ACCEPTED_ACTIVATION_FACT_KEYS leave this boundary.
- * Nested session/correlation are rebuilt closed before the pick (ADR 0049 zero-content by construction).
+ * Nested session/correlation are rebuilt closed before the pick (ADR 0049: first-phase ledger holds zero content bytes by construction).
  */
 function projectAcceptedActivationFact(
   input: AcceptedActivationFactInput,

package/src/activation-reconciliation.ts

@@ -28,7 +28,7 @@ export type DispatchStubFactInput = Omit<DispatchStubFact, "event">;
 
 /**
  * Construct the closed dispatch stub from trusted typed inputs only.
- * Nested dispatch/correlation are rebuilt closed (ADR 0049 zero-content by construction).
+ * Nested dispatch/correlation are rebuilt closed (ADR 0049: first-phase ledger holds zero content bytes by construction).
  */
 export function buildDispatchStubFact(input: DispatchStubFactInput): DispatchStubFact {
   return {

package/src/analyst-gate-cycles-read.ts

@@ -19,7 +19,7 @@
  * the same throw→ledger `auditor-roles` unreadable seam. Unknown/non-contract
  * dispatch status stays loud (#475 abolished Gatekeeper incomplete special-case).
  * Lawful province non-dispatch release (`pass` on a dispatch tool) opens no
- * round and must not throw (#597 / ADR 0074 gate-non-mandatory).
+ * round and must not throw (#597 / ADR 0074: 角色调动无强制，交卷闸派发不断).
  * True non-gate volumes (soul-audit noise, etc.) stay omitted from pairing.
  * Historical dispatch↔officer pairing requires a shared typed
  * `ak_auditor_parent_attempt_binding.parent.attemptEntryId` — never seat/time guessing.

package/src/diarist-contracts.ts

@@ -1,5 +1,5 @@
 /**
- * Public 起居郎 (diarist) terminating receipt contracts — ADR 0075 `diarist-is-role`.
+ * Public 起居郎 (diarist) terminating receipt contracts — ADR 0075（起居郎是 LLM 角色）。
  * Lawful explicit releases: completed (入录) | escalate (认不出本庭对象上抛).
  * Machine facts about the volume come from the mechanical sitian seam, never
  * from model self-report (锚定宪法); this module owns the receipt shape only.
@@ -21,7 +21,7 @@ export const DIARIST_OUTPUT_TOOL_NAME = "ak_diarist_output";
 export const DIARIST_ACCEPTED_TEXT = "起居郎回执已接受";
 
 /**
- * One whole block the diarist chose to enter (ADR 0075 `transcribe-whole-blocks`).
+ * One whole block the diarist chose to enter (ADR 0075 誊录整块对话)。
  * LLM supplies the block bytes + source pointer; mechanical layer appends as-is.
  */
 export type DiaristEntrySubmission = {
@@ -38,13 +38,13 @@ export type DiaristOutput =
   | {
       readonly status: "completed";
       /**
-       * Typed court-target assertion (ADR 0075 `diarist-resolves-ticket-llm-layer`).
+       * Typed court-target assertion (ADR 0075 起居郎 LLM 自行认票)。
        * Positive integer = 本庭对象=票N; null/absent = true-unbound (真无票→无录).
        * LLM owns recognition; mechanical layer does not re-judge the number.
        */
       readonly ticketNumber?: number | null;
       /**
-       * #871 typed co-review set (ADR 0075 `diarist-resolves-ticket-llm-layer` narrow extension).
+       * #871 typed co-review set (ADR 0075 合审票集 narrow extension)。
        * Positive integers = tickets that should each receive a diary this court (includes main).
        * Field absent → no new set this turn (resume keeps stored run fact; first court defaults to [main]).
        * Explicit empty array → single-ticket face [main] whole-set replace.

package/src/diarist.ts

@@ -1,5 +1,5 @@
 /**
- * 起居郎 volume commit — ADR 0075 `diarist-is-role` / #779.
+ * 起居郎 volume commit — ADR 0075（起居郎是 LLM 角色）/ #779.
  * Semantic collection is the diarist role's own LLM turn (finds materials itself).
  * This module only appends submitted whole blocks idempotently and refreshes the
  * human view. No frozen catalog, no quote reverse-verify, no ticket-number

package/src/host-transition-prior-native.ts

@@ -57,7 +57,7 @@ async function listSitianRecordPaths(sessionParent: string): Promise<string[]> {
  * still yields a typed switch (empty path list).
  *
  * Pi wrote its own session.jsonl; every other host's run volume is the sitian
- * record set on the live run (ADR 0077 `record-scope-phase-two`, #717) — the CLI's
+ * record set on the live run (ADR 0077 全宿主 session 卷宗统一直写, #717) — the CLI's
  * own journals stay in the operator home and are never copied here.
  */
 export async function projectHostTransitionPriorNative(input: {

package/src/package-contracts/reviewer-output.ts

@@ -3,7 +3,7 @@
 export const REVIEWER_OUTPUT_TOOL_NAME = "ak_reviewer_output";
 export const REVIEWER_ACCEPTED_TEXT = "御史台回执已接受";
 
-/** Seat-owned per-axis delta relative to child reports — not a replacement report. */
+/** Seat-owned per-axis finding body text (standards / spec). */
 export type ReviewerAmendments = Readonly<Partial<Record<"standards" | "spec", string>>>;
 export type ReviewerIntent =
   | Readonly<{ status: "completed"; amendments?: ReviewerAmendments }>

package/src/package-resources/engine-material.ts

@@ -87,7 +87,7 @@ export function resolveEngineMaterialPath(
 /**
  * Path-safety syntax gate for engine labels at real I/O seams.
  * Returns the canonical name on success; throws Error on illegal syntax.
- * Does not consult any material catalog (ADR 0069 pool-directive axis).
+ * Does not consult any material catalog (ADR 0069: 引擎权威是 owner 池令；能力通用可插拔).
  */
 export function assertLegalEngineName(name: string): string {
   if (!isEngineNameSyntax(name)) {

package/src/packaged-role-registry.ts

@@ -211,7 +211,7 @@ export const PUBLIC_ROLE_RECORDS = [
     activationStage: "load-and-install",
     sessionMaterials: AUDITOR_PUBLIC_SESSION_MATERIALS,
   },
-  // #708 / ADR 0075 `diarist-is-role` / #779: 起居郎 is a seat like any other.
+  // #708 / ADR 0075（起居郎是 LLM 角色）/ #779: 起居郎 is a seat like any other.
   // No input flag — LLM finds materials itself (caller-transparent).
   {
     role: "diarist",

package/src/pi/role-turn-host.ts

@@ -92,7 +92,8 @@ function buildMethodArgs(methods: readonly MethodBinding[]): string[] {
 }
 
 /**
- * Pi-native `/skill:<name>` for a single forced method (ADR 0082 `pi-no-privilege`).
+ * Pi-native `/skill:<name>` for a single forced method (ADR 0082: pi is one adapter
+ * with no privilege; Pi-only seams stay inside the pi adapter).
  * Driven by typed RoleTurnRequest.methods — middle-layer decision, Pi-only syntax.
  * Zero/many methods leave the prompt alone (Fixer optional pair stays `--skill` only).
  */

package/src/public-cli/auto-resume.ts

@@ -119,8 +119,8 @@ export type AutoResumeDispatchResult = {
 /**
  * Thrown by dispatchPostAdmissionTurn when a failure happens inside its own
  * settlement authority (presentControlledFailure) after the host turn
- * genuinely started — never to fabricate a replacement terminal (ADR 0080
- * single-settlement-disposition: settlement stays exactly presentControlledFailure
+ * genuinely started — never to fabricate a replacement terminal (ADR 0080:
+ * one settlement disposition owner — settlement stays exactly presentControlledFailure
  * / settleFailureTerminalResult, or — once the retry budget is exhausted —
  * this loop's own dispatchExceptionFailureTerminal). Its only job is to carry
  * the "turn already started" fact across the throw boundary so this loop

package/src/public-cli/case-dossier-delivery.ts

@@ -1,7 +1,7 @@
 /**
- * 系统随案递送本票起居录的中立指针段（ADR 0081 `automatic-case-material`；
+ * 系统随案递送本票起居录的中立指针段（ADR 0081：公共入口直接挂案卷，Soul 只说明用途不负责派送；
  * #709 公共入口通用递送与 #742 给事中受理链路同源；
- * 指针输入沿 ADR 0079 `summons-pointer-input`，不把卷宗正文塞进提示词）。
+ * 指针输入沿 ADR 0079（指针是绑定材料由代码精准递送），不把卷宗正文塞进提示词）。
  * 只读已有案卷：不刷新、不生成、不校验内容、不新增拒收或停工条件。
  * 机器文本仅中立标识材料（ADR 0073），用途说明归角色材料所有。
  *

package/src/public-cli/cli.ts

@@ -361,7 +361,7 @@ function createRoleEnvironment(
   // host-facing provider (table > unique directory > fail). Bad host never
   // reaches model resolution.
   // Nested summons reuse this table and select by the child seat — never the
-  // already-selected parent adapter (#840 / ADR 0082 host-flag-two-channels).
+  // already-selected parent adapter (#840 / ADR 0082: --host 旗标>席位配置>缺省 pi).
   const hostAdapters = composeRoleTurnHostAdapters(
     {
       packageRoot: env.packageRoot,

package/src/public-cli/countersign-run.ts

@@ -2,15 +2,14 @@
  * Public Countersign Role run: admit ticket materials → court-pipeline prior
  * station (起居郎) → shared post-admission coordinator → settle Terminal result
  * (#572 / ADR 0074 / ADR 0075 / #742 / #771). #599: manual resume continues the
- * exact session. ADR 0079: same-ticket re-summons resume the seat's previous run
- * (`ticket-seat-memory-countersign-principal`); explicit `ak-role new` mints fresh
- * (`explicit-fresh-summons`).
+ * exact session. ADR 0079: same-ticket re-summons resume the seat's previous run;
+ * explicit `ak-role new` mints fresh (显式派新腿入口与显式 resume 并列).
  *
  * Court admission auto-runs 起居郎 so the 起居郎 LLM asserts the court target;
  * mechanical layer only verifies; countersign reuses that typed identity for bind
  * and same-ticket resume lookup (ADR 0075 / 0081 / 0079). Code never matches
  * instruction text against book-known numbers. Who may call 起居郎 and in what
- * order is not written into law (ADR 0075 `no-call-rule`); the present admission
+ * order is not written into law (ADR 0075 不规定谁调用起居郎、顺序归调用者); the present admission
  * effect is what this seat currently does. 起居录 path delivery is owned once by
  * post-admission (#709 / ADR 0081).
  *
@@ -20,7 +19,7 @@
  * (incl. verification failure) settle as countersign controlled failure — never
  * wash into 真无票. Only a true missing lawful typed terminal stays unbound and
  * continues the body (r5 unbound-continue). Bound refresh hands the typed key to
- * 起居郎 so freeze loads issue face (`refresh-every-court` / typed handoff).
+ * 起居郎 so freeze loads issue face (ADR 0075: 每次过庭都跑是调用者用法 / typed handoff).
  */
 import type { DurablePrincipalAuthority, RoleTurnRequest } from "../host-contracts.ts";
 import { engineSessionMaterialFromOptions, pickEngineAxis } from "../package-resources/engine-material.ts";
@@ -223,7 +222,7 @@ async function invokeCourtDiarist(input: {
       ? {}
       : { boundTicketNumber: input.boundTicketNumber }),
     // Child seat selects from the composition-root table. Do not pass the
-    // already-selected parent adapter (#840 / ADR 0082 host-flag-two-channels).
+    // already-selected parent adapter (#840 / ADR 0082: --host 旗标>席位配置>缺省 pi).
     ...(env.hostAdapters === undefined ? {} : { hostAdapters: env.hostAdapters }),
   });
 
@@ -267,7 +266,7 @@ async function invokeCourtDiarist(input: {
 
 /**
  * Court-pipeline prior station: refresh this ticket's 起居录 before the
- * countersign body turn when already bound (ADR 0075 `refresh-every-court`).
+ * countersign body turn when already bound (ADR 0075 每次过庭都跑)。
  * Caller-invisible — no diarist argv on the countersign command line.
  *
  * Missing ticketNumber (true-unbound / identity deferred) skips the refresh
@@ -285,7 +284,7 @@ export async function runCountersignCourtDiaristStation(
     await env.runCourtDiaristStation(admitted);
     return;
   }
-  // Production refresh-every-court only under a known ticket identity.
+  // Production court refresh (ADR 0075: 每次过庭都跑是调用者用法) only under a known ticket identity.
   // First-entry unbound identity is owned by runPublicCountersign.
   if (admitted.ticketNumber === undefined) return;
 
@@ -461,7 +460,7 @@ export async function runPublicCountersign(
           await relocateAdmittedRunToTicket(admitted, env.principalAuthority);
           await markRunTerminal(admitted.runDirectory);
           // Identity 起居郎 asserted unbound (no issue face). Resume still runs
-          // the bound refresh station under the typed key (refresh-every-court).
+          // the bound refresh station under the typed key (ADR 0075: 每次过庭都跑是调用者用法).
           // #871: hand the identity set so resume can whole-replace the run fact
           // when this summons produced a new typed set (never union).
           return await runPublicCountersignResume(
@@ -590,7 +589,7 @@ function countersignAdapters(options?: {
 /**
  * Resume a previously admitted Countersign run (#599 / DK-3 / #637).
  * Restores role/ticket/session identity. Bound court re-entry runs the diarist
- * refresh station first (ADR 0075 `refresh-every-court`); unbound skips refresh.
+ * refresh station first (ADR 0075 每次过庭都跑); unbound skips refresh.
  * Same-ticket summons deliver this turn's instruction + frozen attachments on
  * the resume prompt; manual resume keeps package-envelope / caller-message
  * semantics and birth attachments. 起居录 path delivery remains post-admission's

package/src/public-cli/diarist-run.ts

@@ -1,9 +1,9 @@
 /**
- * Public Diarist (起居郎) Role run — #708 / ADR 0075 `diarist-is-role` / #779.
+ * Public Diarist (起居郎) Role run — #708 / ADR 0075（起居郎是 LLM 角色）/ #779.
  * Same admit → post-admission → settle shape as the other instruction seats.
  * Semantic collection is the role's own turn: LLM finds materials itself
  * (no frozen candidate catalog, no path/attachment burden on the caller).
- * Who calls it and in what order is the caller's business (ADR 0010 `no-call-rule`).
+ * Who calls it and in what order is the caller's business (ADR 0010; ADR 0075 不规定调用顺序).
  */
 import type { DurablePrincipalAuthority, RoleTurnRequest } from "../host-contracts.ts";
 import { engineSessionMaterialFromOptions, pickEngineAxis } from "../package-resources/engine-material.ts";

package/src/public-cli/post-admission.ts

@@ -467,8 +467,8 @@ export async function presentControlledFailure<
 /**
  * presentControlledFailure, called only where the host turn has already
  * genuinely started (#840 r9 判词 class 1 boundary). If presentControlledFailure
- * itself fails, this never fabricates a replacement terminal (ADR 0080
- * single-settlement-disposition — presentControlledFailure /
+ * itself fails, this never fabricates a replacement terminal (ADR 0080:
+ * one settlement disposition owner — presentControlledFailure /
  * settleFailureTerminalResult stays the one authority); it re-throws a
  * TurnDispatchedFailure so runWithAutoResumeLoop still learns the turn
  * started and selects a resume payload on the next attempt, while settling
@@ -505,8 +505,8 @@ async function settleAfterTurnStarted<
  * (needsPersist — station-child / resumable auto-resume loop, #416/#840):
  * that write must land outside the loop's own retried-dispatch try, but its
  * failure still settles through the single existing controlled-failure
- * authority (settleAfterTurnStarted / presentControlledFailure, ADR 0080
- * single-settlement-disposition) — never a second hand-rolled
+ * authority (settleAfterTurnStarted / presentControlledFailure, ADR 0080:
+ * one settlement disposition owner) — never a second hand-rolled
  * classify/artifact/Terminal (#836 r12 class 3), and never lawful/non-lawful
  * settling differently (#836 r13 class 2: a caller's io here may be a no-op,
  * so a stderr-only trace is never seen and the failure is otherwise
@@ -816,8 +816,8 @@ export async function dispatchPostAdmissionTurn<
     // 判词 class 1 boundary — 覆盖 executeTurn 已启动后至返回带 turnDispatched
     // 结果前的全部异常). Each fallible step routes any failure through the
     // single existing settlement authority (presentControlledFailure /
-    // settleFailureTerminalResult) rather than a second one (ADR 0080
-    // single-settlement-disposition) — never by fabricating a terminal here.
+    // settleFailureTerminalResult) rather than a second one (ADR 0080:
+    // one settlement disposition owner) — never by fabricating a terminal here.
     // A cleanup step that runs only after a real settlement (clearCurrentCourt)
     // is protected by logging and keeping that already-obtained result, never
     // by discarding it (#840 已交劳动只整理终局不重做). A failure inside the

package/src/public-cli/seat-ticket-binding.ts

@@ -1,7 +1,7 @@
 /**
  * Shared ticket identity seam for public court seats (#635 / #637 / #709 / #747 / #771).
  *
- * ADR 0075 `diarist-resolves-ticket-llm-layer`: the diarist LLM recognizes the
+ * ADR 0075（起居郎 LLM 自行认票）: the diarist LLM recognizes the
  * court target; recognized ticket → provenance, truly unbound → no provenance,
  * or escalate when it cannot recognize one. Code does not re-judge the ticket
  * (锚定宪法; owner 2026-09-08: 代码不准做判断). Other seats reuse a typed

package/src/public-role-summons.ts

@@ -272,7 +272,7 @@ export async function summonPublicRole(
     options.credentials ?? (await loadCredentialProviders(agentDir));
   const config = await loadPublicCliConfig(home);
   // Nested summons resolve host on the officer seat only (flag>seat>default pi).
-  // Parent run host is not an override channel (#821 / ADR 0082 host-flag-two-channels).
+  // Parent run host is not an override channel (#821 / ADR 0082: --host 旗标>席位配置>缺省 pi).
   const seat = resolveEffectiveSeat(config, options.role, credentials);
   let summonEnv;
   try {

package/src/reviewer-role.ts

@@ -22,9 +22,9 @@ export type ReviewerAdmittedInputs = Readonly<{
 }>;
 
 const reviewerAmendmentsSchema = Type.Object({
-  standards: Type.Optional(Type.String({ description: "相对 Standards 子报告的增量：增 finding、撤回或事实更正" })),
-  spec: Type.Optional(Type.String({ description: "相对 Spec 子报告的增量：增 finding、撤回或事实更正" })),
-}, { additionalProperties: true, description: "相对子报告的可选轴增量；非替代报告。无增量的轴可省略。" });
+  standards: Type.Optional(Type.String({ description: "标准轴弹章正文" })),
+  spec: Type.Optional(Type.String({ description: "规格轴弹章正文" })),
+}, { additionalProperties: true, description: "逐轴弹章正文；无弹章的轴可省略。" });
 // #836 r16 class 1: diagnostic is LLM/human-read narrative content — no code
 // branches on its length (src/reviewer-role.ts consumer: reviewer content is
 // returned as submitted, ADR 0057).

package/src/role-envelope.ts

@@ -46,7 +46,8 @@ type ContentPart = { type: "text"; text: string } | { type: "image"; data: strin
 
 /**
  * Build host-side Skill expansion evidence from pre-read RoleTurnRequest.methods.
- * Non-pi hosts never parse Pi `/skill:` syntax (ADR 0082 `pi-no-privilege`);
+ * Non-pi hosts never parse Pi `/skill:` syntax (ADR 0082: pi is one adapter with
+ * no privilege; Pi-only seams stay inside the pi adapter);
  * a single bound method treats the plain prompt as the preserved user message.
  * Pi-native slash forms stay inside `src/pi/` only.
  */

package/src/ticket-provenance.ts

@@ -302,7 +302,7 @@ export function renderTicketProvenanceMarkdown(input: {
 /**
  * Ensure the per-ticket JSONL volume partition exists (empty file OK).
  * Every bound-ticket court establishes the volume even with zero diary entries
- * (ADR 0075 ticket-provenance-file — 每票一份起居录). Does not forge entries.
+ * (ADR 0075: 每票一份起居录送司天台). Does not forge entries.
  */
 export function ensureTicketProvenanceVolume(
   ticketNumber: number,

package/src/work-subject-identity.ts

@@ -38,7 +38,7 @@ function workIdentityFromCwd(cwd: string): string | undefined {
   return undefined;
 }
 
-/** Machine-ledger session paths are not work identity (ADR 0048 session-in-home). */
+/** Machine-ledger session paths are not work identity (ADR 0048: session 直落家). */
 function isMachineLedgerSessionPath(sessionPath: string): boolean {
   // Physical containment under the package ledger home — never directory spelling,
   // and stable across macOS /var ↔ /private/var realpath asymmetry. Path → ledger

package/src/worker-submission-gates.ts

@@ -23,7 +23,7 @@ export const WORKER_COMMIT_BASELINE_ENTRY_TYPE = "commit-baseline";
 export const WORKER_COMMIT_REMINDER_BOUNCE_ENTRY_TYPE = "commit-reminder-bounce";
 export const WORKER_PREFIX_REMINDER_BOUNCE_ENTRY_TYPE = "prefix-reminder-bounce";
 
-/** Statuses that enter the officer submission gate (ADR 0066 gate-1-status-matrix / ADR 0072 skip-statuses). */
+/** Statuses that enter the officer submission gate (ADR 0066: completed/partially_completed 进闸①；planned/refused/unfinished 零 commit 合法). */
 export const WORKER_DONE_STATUSES: ReadonlySet<string> = new Set(["completed", "partially_completed"]);
 /** Historical package hook ownership marker — uninstall criterion only. */
 const HOOK_MARKER = "ak-roles: worker-submission-gates reference-transaction";