@akagilnc/pi-workflow-roles 0.1.3549 → 0.1.3552

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.3552",
   "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),