@akagilnc/pi-workflow-roles 0.1.3549 → 0.1.3554

package/CLAUDE.md

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

package/README.zh-CN.md

@@ -135,7 +135,7 @@ ak-role resume <runId> "<裁定>"
 | **大理寺** | judge | **审理定谳。** 承接各方意见与材料，依照既定规则逐项判断，辨明是非曲直。可以准行、退回或请示更高决定，但自身不参与建设与修改。 |
 | **审刑院** | judge-auditor／doctor-auditor（无 CLI，共享内部接缝；御史台侧闸已退役） | **复核成案。** 不重新争论事情本身，而是检查整个办理过程是否合乎规矩。关注是否有人越过职责、是否遗漏必要步骤、是否以错误方式得出正确结果。直属陛下，不入门下省编制。 |
 | **门下省** | gatekeeper（交卷闸不再自动出席；可 `ak-role gatekeeper` 独立直调） | **审署诏敕与质量保证的省。** 交卷闸按受审物直接传召察院/符宝郎，本省不介入选席；调用者仍可独立传召本省作 dispatch/pass；给事中票庭由调用者开工前传召；左拾遗由调用者合并前传召；省内政，不是外层编排器。规范见 [ADR 0067](docs/adr/0067-menxia-province-founding-jishizhong-fubaolang.md)、[ADR 0072](docs/adr/0072-menxia-pre-pr-submission-hooks.md)、[ADR 0074](docs/adr/0074-gate-province-reorg-jishizhong-chaiyuan-split.md)、[ADR 0079](docs/adr/0079-direct-officer-summons-ticket-memory-pointer-input.md)。 |
-| **给事中** | countersign（无交卷闸派发；开工前由调用者传召） | **票庭审读五问。** 制度符合／授权真实（以起居录为据）／文书符意／退回重议／发布资格；读码取证是本职，实现细节不上票面。票庭流水线在本席 turn 前跑起居郎工序（调用者无感）；交卷闸出席符宝郎。署＝放行开工，封驳＝退票重议，上呈＝陛下裁决。规范见 [ADR 0074](docs/adr/0074-gate-province-reorg-jishizhong-chaiyuan-split.md)、[ADR 0075](docs/adr/0075-ticket-provenance-diarist-pipeline.md)。 |
+| **给事中** | countersign（无交卷闸派发；开工前由调用者传召） | **票庭审读五问。** 制度符合／授权真实（以起居录为据）／文书符意／退回重议／发布资格；读码取证是本职，实现细节不上票面。起居录由起居郎（独立角色）修，先后归调用者；交卷闸出席符宝郎。署＝放行开工，封驳＝退票重议，上呈＝陛下裁决。规范见 [ADR 0074](docs/adr/0074-gate-province-reorg-jishizhong-chaiyuan-split.md)、[ADR 0075](docs/adr/0075-ticket-provenance-diarist-pipeline.md)。 |
 | **左拾遗** | gleaner-left（无交卷闸派发；合并前由调用者传召） | **合并前无锚定风闻。** 对全幅合并候选作冷眼评审；只上弹章、不封驳不裁决。规范见 [ADR 0067](docs/adr/0067-menxia-province-founding-jishizhong-fubaolang.md) 修正案。 |
 | **察院** | inspector | **事后察举：复杂度与测试质量两轴。** 受审物是将作监／修内司完成侧交卷；封驳＝当场打回重写，不是本局失败。可被门下省派发，也可 `ak-role inspector` 单独调。原给事中，ADR 0074 分立。 |
 | **符宝郎** | notary | **首责唯一：核实实际授权出处**（防乱编乱扩）。行事两步：读该票起居录→以录核旨；引语真伪与票面对齐为手段。受审物是大理寺拟判与给事中署章；可被门下省派发，也可 `ak-role notary` 单独调。规范见 [ADR 0075](docs/adr/0075-ticket-provenance-diarist-pipeline.md)。 |
@@ -150,7 +150,7 @@ ak-role resume <runId> "<裁定>"
 | doctor | **太医署** | 单案诊断工厂机制，开 `keep｜thin｜delete` 方 | 已建 |
 | analyst | **太史** | 司天台分析席：只读司天记录、出高阶指标；确定性机制，非 LLM，可单独调用 | 已建（[ADR 0068](docs/adr/0068-taishi-analysis-seat-reads-records-writes-sibling-home.md)；机器面键 `analyst`，[#445](https://github.com/Akagilnc/ak-pi-workflow-roles/issues/445) 拼音清零） |
 | — | **司天台** | 记候簿——只打点、只指针，不分析不执法；二期含每票起居录 kind `ticket-provenance` | **一期不是角色**（[ADR 0047](docs/adr/0047-sitian-phase-one-mechanism-not-role.md)：零 LLM 双面对账）；分析席已由太史承担；起居录见 [ADR 0075](docs/adr/0075-ticket-provenance-diarist-pipeline.md)；机器面键 `archivist`（[#445](https://github.com/Akagilnc/ak-pi-workflow-roles/issues/445)） |
-| — | **起居郎** | 票庭流水线前序工序：LLM 语义收集＋机械保全，按票刷新起居录 | **非公开席位**（无 soul 开府、不出席闸；[ADR 0075](docs/adr/0075-ticket-provenance-diarist-pipeline.md)；机器面键 `diarist`） |
+| `diarist` | **起居郎** | 为本票搜集、整理决策依据并修订起居录：LLM 语义收集＋机械保全带 | **LLM 角色**（soul、席位表一行、公开入口 `ak-role diarist`、交卷工具；建制施工见 #708 r2；[ADR 0075](docs/adr/0075-ticket-provenance-diarist-pipeline.md) `diarist-is-role`；谁调用、何时调用归调用者，`no-call-rule`） |
 | marshal | **尚书省** | 审→判→修 质量收敛环的省部级驱动角色：调用方递票号与 baseline，尚书省驱动御史台/大理寺/修内司滚到收敛（converged 唯庭可判）或 escalate 上呈，交回 typed 报告；不弹、不判、不修，只让链条转到收敛 | 已定名（#145）；席位待落地（#146） |
 | — | **兰台** | 读档议制——耗时／缺口／冗余三条，上奏不执法 | 未建 |
 | — | **考功司** | 考具体效率——角色与档位的升档率、一次通过率、每票成本 | 留档，需要时另立票 |

package/dist/grok/production-host.js

@@ -6952,6 +6952,16 @@ var SUPPORT_COMMAND_HELP = {
       "ak-role --host grok-build resume 01abc\u2026",
       "ak-role --engine agy resume 01abc\u2026"
     ]
+  },
+  new: {
+    command: "new",
+    summary: "Explicit fresh summons: same role options as a direct call, but always mint a new run (skip same-ticket auto-resume). Caller chooses new vs resume; no overflow judgment.",
+    usage: ["ak-role new <role> [options] \u2026"],
+    examples: [
+      'ak-role new countersign --attach ./ticket.md "\u88C1\uFF1A\u672C\u7968 #708 \u662F\u5426\u8DB3\u4EE5\u5F00\u5DE5\u3002"',
+      "ak-role new notary --source-run 01abc\u2026@countersign",
+      "ak-role --host grok-build new inspector --attach ./change.patch"
+    ]
   }
 };
 var PUBLIC_COMMAND_HELP = {

package/dist/public-cli/main.js

@@ -15270,7 +15270,8 @@ var init_registry2 = __esm({
       "roles",
       "config",
       "help",
-      "resume"
+      "resume",
+      "new"
     ];
     STARTUP_CANDIDATES = {
       judge: [
@@ -19356,6 +19357,16 @@ var init_option_definitions = __esm({
           "ak-role --host grok-build resume 01abc\u2026",
           "ak-role --engine agy resume 01abc\u2026"
         ]
+      },
+      new: {
+        command: "new",
+        summary: "Explicit fresh summons: same role options as a direct call, but always mint a new run (skip same-ticket auto-resume). Caller chooses new vs resume; no overflow judgment.",
+        usage: ["ak-role new <role> [options] \u2026"],
+        examples: [
+          'ak-role new countersign --attach ./ticket.md "\u88C1\uFF1A\u672C\u7968 #708 \u662F\u5426\u8DB3\u4EE5\u5F00\u5DE5\u3002"',
+          "ak-role new notary --source-run 01abc\u2026@countersign",
+          "ak-role --host grok-build new inspector --attach ./change.patch"
+        ]
       }
     };
     PUBLIC_COMMAND_HELP = {
@@ -23705,6 +23716,7 @@ async function resolveSeatTicketBinding(admitted, env = {}) {
   return resolution;
 }
 async function tryResumeSameTicketSeatRun(input) {
+  if (input.freshSummons === true) return void 0;
   const previousRunId = await findLatestRunIdForSeatTicket({
     home: input.home,
     bookKey: resolveBookKeyFromGit(input.projectRoot),
@@ -29353,6 +29365,7 @@ async function runPublicCountersign(argv, env, io, parseCountersignArgv2) {
       projectRoot,
       role: "countersign",
       ticketNumber: probedTicketNumber,
+      freshSummons: env.freshSummons,
       summons,
       resume: (runId, materials) => runPublicCountersignResume(
         { runId, ...materials === void 0 ? {} : { summons: materials } },
@@ -29978,6 +29991,7 @@ async function runPublicNotary(argv, env, io, parseNotaryArgv2) {
       projectRoot,
       role: "notary",
       ticketNumber,
+      freshSummons: env.freshSummons,
       summons,
       resume: (runId, materials) => runPublicNotaryResume(
         { runId, ...materials === void 0 ? {} : { summons: materials } },
@@ -30133,6 +30147,7 @@ async function runPublicInspector(argv, env, io, parseInspectorArgv2) {
       projectRoot,
       role: "inspector",
       ticketNumber: probedTicketNumber,
+      freshSummons: env.freshSummons,
       summons,
       resume: (runId, materials) => runPublicInspectorResume(
         { runId, ...materials === void 0 ? {} : { summons: materials } },
@@ -33060,7 +33075,8 @@ function createRoleEnvironment(env, options) {
     ...projectSeatHost(options.seat),
     ...timeoutMs === void 0 ? {} : { timeoutMs },
     ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId },
-    ...options.config?.autoResumeLimit === void 0 ? {} : { autoResumeLimit: options.config.autoResumeLimit }
+    ...options.config?.autoResumeLimit === void 0 ? {} : { autoResumeLimit: options.config.autoResumeLimit },
+    ...env.freshSummons === true ? { freshSummons: true } : {}
   };
 }
 function cliResultFromRoleRun(result2) {
@@ -33547,8 +33563,8 @@ async function runAkRole(argv, env) {
       packageRoot: await realpath6(env.packageRoot),
       principalAuthority: env.principalAuthority ?? piDurablePrincipalAuthority
     };
-    const parsed = parseArgv(argv);
-    const acceptsSeatAxes = parsed.command !== void 0 && (isPublicCallableRole(parsed.command) || parsed.command === "resume");
+    let parsed = parseArgv(argv);
+    const acceptsSeatAxes = parsed.command !== void 0 && (isPublicCallableRole(parsed.command) || parsed.command === "resume" || parsed.command === "new");
     if (parsed.host !== void 0 && !parsed.help && parsed.command !== void 0 && parsed.command !== "help" && !acceptsSeatAxes) {
       throw new CliUsageError(`host axis is role commands only; refused command ${parsed.command}`);
     }
@@ -33593,6 +33609,21 @@ async function runAkRole(argv, env) {
         exitCode: await runConfigCommand(parsed.args, home, env.packageRoot, io)
       };
     }
+    if (parsed.command === "new") {
+      const role = parsed.args[0];
+      if (role === void 0) {
+        throw new CliUsageError("usage: ak-role new <role> \u2026");
+      }
+      if (!isPublicCallableRole(role)) {
+        throw new CliUsageError(`usage: ak-role new <role> \u2026; unknown role: ${role}`);
+      }
+      parsed = {
+        ...parsed,
+        command: role,
+        args: parsed.args.slice(1)
+      };
+      env = { ...env, freshSummons: true };
+    }
     if (parsed.command === "resume") {
       const agentDir = resolveAgentDir(env, home);
       const cwd = env.cwd ?? process.cwd();
@@ -33622,7 +33653,7 @@ async function runAkRole(argv, env) {
       );
       return cliResultFromRoleRun(result2);
     }
-    if (isPublicCliSupportCommand(parsed.command)) {
+    if (parsed.command !== void 0 && isPublicCliSupportCommand(parsed.command)) {
       throw new CliUsageError(`unhandled support command: ${parsed.command}`);
     }
     if (parsed.command === "judge") {

package/dist/public-cli/registry.js

@@ -12,7 +12,8 @@ const PUBLIC_CLI_SUPPORT_COMMANDS = [
   "roles",
   "config",
   "help",
-  "resume"
+  "resume",
+  "new"
 ];
 function seatModelOnly(seat) {
   if (seat?.provider === void 0 || seat.model === void 0) return void 0;

package/package.json

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

package/src/public-cli/cli.ts

@@ -294,6 +294,11 @@ export type CliEnv = {
   /** Override Notary role-run timeout (tests). */
   notaryTimeoutMs?: number;
   createRunId?: () => string;
+  /**
+   * #724: set by the `new` support verb before role dispatch; seat runners
+   * skip same-ticket auto-resume. Not a public flag — the verb is the choice.
+   */
+  freshSummons?: true;
 };
 
 /** Compose the Pi turn host for one role dispatch (sole public-cli → pi contact). */
@@ -437,6 +442,7 @@ function createRoleEnvironment(
     ...(options.config?.autoResumeLimit === undefined
       ? {}
       : { autoResumeLimit: options.config.autoResumeLimit }),
+    ...(env.freshSummons === true ? { freshSummons: true as const } : {}),
   };
 }
 
@@ -1084,12 +1090,14 @@ export async function runAkRole(
       packageRoot: await realpath(env.packageRoot),
       principalAuthority: env.principalAuthority ?? piDurablePrincipalAuthority,
     };
-    const parsed = parseArgv(argv);
-    // Host/engine axes: callable roles + resume (#617 DK-3: resume shares seat axes).
+    let parsed = parseArgv(argv);
+    // Host/engine axes: callable roles + resume + new (#617 DK-3; #724 new shares seat axes).
     // Support commands (roles/config/…) still refuse both flags.
     const acceptsSeatAxes =
       parsed.command !== undefined &&
-      (isPublicCallableRole(parsed.command) || parsed.command === "resume");
+      (isPublicCallableRole(parsed.command) ||
+        parsed.command === "resume" ||
+        parsed.command === "new");
     if (
       parsed.host !== undefined &&
       !parsed.help &&
@@ -1160,6 +1168,24 @@ export async function runAkRole(
       };
     }
 
+    // #724 explicit fresh summons: `ak-role new <role> …` — same role argv, always mint.
+    // Rewrites onto the role command with freshSummons; auto-resume and resume stay intact.
+    if (parsed.command === "new") {
+      const role = parsed.args[0];
+      if (role === undefined) {
+        throw new CliUsageError("usage: ak-role new <role> …");
+      }
+      if (!isPublicCallableRole(role)) {
+        throw new CliUsageError(`usage: ak-role new <role> …; unknown role: ${role}`);
+      }
+      parsed = {
+        ...parsed,
+        command: role,
+        args: parsed.args.slice(1),
+      };
+      env = { ...env, freshSummons: true };
+    }
+
     // Resume reopens an exact Role run (#416): caller decides; session principal
     // must still exist. Seat and dispatch follow the durable admitted role.
     // #471: unique parser owns {runId, message?}; five role paths only consume it.
@@ -1202,7 +1228,10 @@ export async function runAkRole(
       return cliResultFromRoleRun(result);
     }
 
-    if (isPublicCliSupportCommand(parsed.command)) {
+    if (
+      parsed.command !== undefined &&
+      isPublicCliSupportCommand(parsed.command)
+    ) {
       throw new CliUsageError(`unhandled support command: ${parsed.command}`);
     }
 

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

@@ -122,6 +122,7 @@ export async function runPublicCountersign(
       projectRoot,
       role: "countersign",
       ticketNumber: probedTicketNumber,
+      freshSummons: env.freshSummons,
       summons,
       resume: (runId, materials) =>
         runPublicCountersignResume(

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

@@ -109,6 +109,7 @@ export async function runPublicInspector(
       projectRoot,
       role: "inspector",
       ticketNumber: probedTicketNumber,
+      freshSummons: env.freshSummons,
       summons,
       resume: (runId, materials) =>
         runPublicInspectorResume(

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

@@ -119,6 +119,7 @@ export async function runPublicNotary(
       projectRoot,
       role: "notary",
       ticketNumber,
+      freshSummons: env.freshSummons,
       summons,
       resume: (runId, materials) =>
         runPublicNotaryResume(

package/src/public-cli/option-definitions.ts

@@ -1271,6 +1271,17 @@ const SUPPORT_COMMAND_HELP = {
       "ak-role --engine agy resume 01abc…",
     ],
   },
+  new: {
+    command: "new",
+    summary:
+      "Explicit fresh summons: same role options as a direct call, but always mint a new run (skip same-ticket auto-resume). Caller chooses new vs resume; no overflow judgment.",
+    usage: ["ak-role new <role> [options] …"],
+    examples: [
+      'ak-role new countersign --attach ./ticket.md "裁：本票 #708 是否足以开工。"',
+      "ak-role new notary --source-run 01abc…@countersign",
+      "ak-role --host grok-build new inspector --attach ./change.patch",
+    ],
+  },
 } as const satisfies Record<string, PublicCommandHelpFacts>;
 
 /**

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

@@ -110,6 +110,11 @@ export type PostAdmissionEnv = {
   sessionAppender: SessionCustomEntryAppender;
   autoResumeLimit?: number;
   createRunId?: () => string;
+  /**
+   * #724 explicit fresh summons (`ak-role new <role>`): skip same-ticket auto-resume
+   * and mint a new run. Absent on ordinary role commands and on `ak-role resume`.
+   */
+  freshSummons?: true;
 };
 
 /**

package/src/public-cli/registry.ts

@@ -27,6 +27,7 @@ export const PUBLIC_CLI_SUPPORT_COMMANDS = [
   "config",
   "help",
   "resume",
+  "new",
 ] as const;
 
 export type PublicCliSupportCommand = (typeof PUBLIC_CLI_SUPPORT_COMMANDS)[number];

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

@@ -149,22 +149,26 @@ export async function resolveSeatTicketBinding(
 }
 
 /**
- * Shared same-ticket → resume decision (#637).
+ * Sole same-ticket → resume decision (#637 / #724).
  * Looks up the latest retained run for seat+ticket; when found, runs resume with
  * this summons' materials. Lookup/resume failures propagate (失败诚实) — never
- * wash into a fresh mint. Returns undefined only when no prior run exists.
+ * wash into a fresh mint. Returns undefined when the caller declared an explicit
+ * fresh summons (`ak-role new`) or when no prior run exists; both mint new.
+ * freshSummons is required so no seat can drift back into its own skip branch.
  */
 export async function tryResumeSameTicketSeatRun<T>(input: {
   readonly home: string;
   readonly projectRoot: string;
   readonly role: RoleRunRecord["role"];
   readonly ticketNumber: number;
+  readonly freshSummons: true | undefined;
   readonly summons?: SameTicketSummonsMaterials;
   readonly resume: (
     runId: string,
     summons: SameTicketSummonsMaterials | undefined,
   ) => Promise<T>;
 }): Promise<T | undefined> {
+  if (input.freshSummons === true) return undefined;
   const previousRunId = await findLatestRunIdForSeatTicket({
     home: input.home,
     bookKey: resolveBookKeyFromGit(input.projectRoot),