@akagilnc/pi-workflow-roles 0.1.2107 → 0.1.2114

package/dist/public-cli/main.js

@@ -14336,6 +14336,9 @@ function listHelpCapabilities() {
   );
   return [...support, ...roles, ...deterministic];
 }
+function isPublicCallableRole(value) {
+  return PUBLIC_CALLABLE_ROLES.includes(value);
+}
 function isPublicConfigurableSeat(value) {
   return PUBLIC_CONFIGURABLE_SEATS.includes(value);
 }
@@ -14440,12 +14443,9 @@ function setPersistentSeatConfig(config, seat, selection) {
   };
 }
 function isEngineAxisSeat(seat) {
-  return seat === "judge" || seat === "reviewer";
+  return isPublicCallableRole(seat);
 }
 function setPersistentSeatEngine(config, seat, engine) {
-  if (!isEngineAxisSeat(seat)) {
-    throw new Error(`engine axis is judge+reviewer only; refused seat ${seat}`);
-  }
   const previous = config.seats[seat];
   if (previous === void 0) {
     throw new Error(
@@ -14477,7 +14477,7 @@ function validatePublicCliConfigEngines(config, _packageRoot) {
     if (row?.engine === void 0) continue;
     if (!isEngineAxisSeat(seat)) {
       throw new Error(
-        `config seat ${seat} engine is not allowed; engine axis is judge+reviewer only`
+        `config seat ${seat} cannot persist engine: no independent activation path; storing would be silently ineffective`
       );
     }
     try {
@@ -15909,8 +15909,8 @@ var init_option_definitions = __esm({
         repeatable: false,
         form: "option",
         description: {
-          en: "Optional Judge/Reviewer labor engine for this invocation (owner pool-directive name; packaged notes attached when present; judge+reviewer only).",
-          zh: "\u672C\u8C03\u7528\u53EF\u9009 Judge/Reviewer \u52B3\u52A8\u5F15\u64CE\uFF08\u6C60\u4EE4\u540D\u5B57\uFF1B\u6709\u5305\u5185\u8C03\u6CD5\u7B14\u8BB0\u5219\u9644\u5377\uFF1B\u4EC5 Judge+Reviewer\uFF09\u3002"
+          en: "Optional labor engine for this invocation (owner pool-directive name; packaged notes attached when present; any role).",
+          zh: "\u672C\u8C03\u7528\u53EF\u9009\u52B3\u52A8\u5F15\u64CE\uFF08\u6C60\u4EE4\u540D\u5B57\uFF1B\u6709\u5305\u5185\u8C03\u6CD5\u7B14\u8BB0\u5219\u9644\u5377\uFF1B\u5168\u90E8\u89D2\u8272\u53EF\u7528\uFF09\u3002"
         }
       },
       {
@@ -16776,7 +16776,7 @@ async function admitCoderInvocation(options) {
     ...ticketFields
   };
 }
-function buildCoderTransportPrompt(admitted) {
+function buildCoderTransportPrompt(admitted, engineMaterial) {
   const lines = [admitted.instruction];
   if (admitted.attachments.length > 0) {
     lines.push("");
@@ -16785,7 +16785,7 @@ function buildCoderTransportPrompt(admitted) {
       lines.push(`- ${attachment.frozenPath}`);
     }
   }
-  return lines.join("\n");
+  return appendEngineSessionMaterial(lines, engineMaterial).join("\n");
 }
 async function admitFixerInvocation(options) {
   if (options.project !== void 0) {
@@ -16893,7 +16893,7 @@ async function admitFixerInvocation(options) {
     ...ticketFields
   };
 }
-function buildFixerTransportPrompt(admitted) {
+function buildFixerTransportPrompt(admitted, engineMaterial) {
   const lines = [admitted.instruction];
   if (admitted.attachments.length > 0) {
     lines.push("");
@@ -16902,7 +16902,7 @@ function buildFixerTransportPrompt(admitted) {
       lines.push(`- ${attachment.frozenPath}`);
     }
   }
-  return lines.join("\n");
+  return appendEngineSessionMaterial(lines, engineMaterial).join("\n");
 }
 function parsePositivePrOption(raw) {
   if (raw === void 0 || raw.trim() === "") throw new CliUsageError("--pr requires a positive pull request number");
@@ -17133,8 +17133,8 @@ async function admitCollectorInvocation(options) {
     ...ticketFields
   };
 }
-function buildCollectorTransportPrompt(_admitted) {
-  return COLLECTOR_FIXED_KICKOFF;
+function buildCollectorTransportPrompt(_admitted, engineMaterial) {
+  return appendEngineSessionMaterial([COLLECTOR_FIXED_KICKOFF], engineMaterial).join("\n");
 }
 function parseDoctorIssueNumber(raw) {
   const trimmed = raw.trim();
@@ -17360,7 +17360,7 @@ async function admitDoctorInvocation(options) {
     ...ticketFields
   };
 }
-function buildDoctorTransportPrompt(admitted) {
+function buildDoctorTransportPrompt(admitted, engineMaterial) {
   const lines = [admitted.instructionEmpty ? "" : admitted.instruction];
   if (admitted.attachments.length > 0) {
     lines.push("");
@@ -17369,7 +17369,7 @@ function buildDoctorTransportPrompt(admitted) {
       lines.push(`- ${attachment.frozenPath}`);
     }
   }
-  return lines.join("\n");
+  return appendEngineSessionMaterial(lines, engineMaterial).join("\n");
 }
 function parseReviewerArgv(args) {
   const attachmentPaths = [];
@@ -17672,7 +17672,7 @@ async function admitMergerInvocation(options) {
     ...ticketFields
   };
 }
-function buildMergerTransportPrompt(admitted) {
+function buildMergerTransportPrompt(admitted, engineMaterial) {
   const lines = [
     `/skill:resolving-merge-conflicts ${admitted.instruction}`
   ];
@@ -17683,7 +17683,7 @@ function buildMergerTransportPrompt(admitted) {
       lines.push(`- ${attachment.frozenPath}`);
     }
   }
-  return lines.join("\n");
+  return appendEngineSessionMaterial(lines, engineMaterial).join("\n");
 }
 function parseTaishiTicketNumber(raw, flag = "--ticket") {
   const trimmed = raw.trim();
@@ -18204,6 +18204,24 @@ var init_explicit_internal = __esm({
   }
 });
 
+// src/engine-detour.ts
+function applyEngineChildEnv(childEnv, engine) {
+  delete childEnv[AK_ROLE_ENGINE_ENV];
+  if (engine !== void 0 && engine.trim() !== "") {
+    childEnv[AK_ROLE_ENGINE_ENV] = engine.trim();
+  } else {
+    childEnv[AK_ROLE_ENGINE_ENV] = void 0;
+  }
+}
+var ENGINE_DETOUR_TOOL_NAME, AK_ROLE_ENGINE_ENV;
+var init_engine_detour = __esm({
+  "src/engine-detour.ts"() {
+    "use strict";
+    ENGINE_DETOUR_TOOL_NAME = "ak_engine_detour";
+    AK_ROLE_ENGINE_ENV = "AK_ROLE_ENGINE";
+  }
+});
+
 // src/package-resources/method-skill.ts
 import { createHash as createHash3 } from "node:crypto";
 import { readFile as readFile6, realpath as realpath4 } from "node:fs/promises";
@@ -19149,16 +19167,6 @@ var init_auditor_dossier_tool = __esm({
   }
 });
 
-// src/engine-detour.ts
-var ENGINE_DETOUR_TOOL_NAME, AK_ROLE_ENGINE_ENV;
-var init_engine_detour = __esm({
-  "src/engine-detour.ts"() {
-    "use strict";
-    ENGINE_DETOUR_TOOL_NAME = "ak_engine_detour";
-    AK_ROLE_ENGINE_ENV = "AK_ROLE_ENGINE";
-  }
-});
-
 // src/engine-labor-fallback.ts
 function buildEngineLaborFallbackField(input) {
   return Object.freeze({
@@ -22381,7 +22389,10 @@ var init_settlement = __esm({
 import { writeFile as writeFile6 } from "node:fs/promises";
 import { join as join12 } from "node:path";
 function buildCoderActivationExtraArgs(admitted, options) {
-  const prompt = buildCoderTransportPrompt(admitted);
+  const prompt = buildCoderTransportPrompt(
+    admitted,
+    engineSessionMaterialFromOptions(options)
+  );
   const skillArgs = admitted.phase === "apply" ? [
     "--skill",
     resolvePackagedMethodSkillPath(options.packageRoot, "tdd")
@@ -22486,7 +22497,7 @@ async function presentControlledFailure2(admitted, failureInput, io) {
   };
 }
 async function dispatchAdmittedCoder(input) {
-  const { admitted, env, io, extraArgs, lease, methodProvenance } = input;
+  const { admitted, env, io, extraArgs, lease, methodProvenance, effectiveEngine } = input;
   try {
     const missingCredential = missingCredentialPreDispatchFailure(
       env.model,
@@ -22499,7 +22510,7 @@ async function dispatchAdmittedCoder(input) {
         io
       );
     }
-    await markRunRunning(admitted.runDirectory, env.model);
+    await markRunRunning(admitted.runDirectory, env.model, effectiveEngine);
     await clearTypedProviderHttpObservation(admitted.runDirectory);
     const childEnv = {
       ...process.env,
@@ -22507,6 +22518,7 @@ async function dispatchAdmittedCoder(input) {
       PI_CODING_AGENT_DIR: env.agentDir,
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
+    applyEngineChildEnv(childEnv, env.engine);
     const correlationId = admitted.correlationId ?? env.correlationId;
     if (correlationId !== void 0 && correlationId.trim() !== "") {
       childEnv.AK_CORRELATION_ID = correlationId;
@@ -22652,6 +22664,7 @@ async function runPublicCoder(argv, env, io, parseCoderArgv2) {
   const extraArgs = buildCoderActivationExtraArgs(admitted, {
     packageRoot: env.packageRoot,
     ...env.model === void 0 ? {} : { model: env.model },
+    ...env.engine === void 0 ? {} : { engine: env.engine },
     ...env.extraPiArgs === void 0 ? {} : { extraPiArgs: env.extraPiArgs }
   });
   return await dispatchAdmittedCoder({
@@ -22663,7 +22676,8 @@ async function runPublicCoder(argv, env, io, parseCoderArgv2) {
     io,
     extraArgs,
     lease,
-    ...methodProvenance === void 0 ? {} : { methodProvenance }
+    ...methodProvenance === void 0 ? {} : { methodProvenance },
+    ...env.engine === void 0 ? {} : { effectiveEngine: env.engine }
   });
 }
 async function runPublicCoderResume(argv, env, io) {
@@ -22746,6 +22760,8 @@ async function runPublicCoderResume(argv, env, io) {
 var init_coder_run = __esm({
   "src/public-cli/coder-run.ts"() {
     "use strict";
+    init_engine_detour();
+    init_engine_material();
     init_method_skill();
     init_explicit_internal();
     init_cli_errors();
@@ -22761,7 +22777,10 @@ var init_coder_run = __esm({
 import { writeFile as writeFile7 } from "node:fs/promises";
 import { join as join13 } from "node:path";
 function buildCollectorActivationExtraArgs(admitted, options = {}) {
-  const prompt = buildCollectorTransportPrompt(admitted);
+  const prompt = buildCollectorTransportPrompt(
+    admitted,
+    engineSessionMaterialFromOptions(options)
+  );
   return [
     "--no-skills",
     "--no-prompt-templates",
@@ -22809,7 +22828,7 @@ async function presentControlledFailure3(admitted, failureInput, io) {
   };
 }
 async function dispatchAdmittedCollector(input) {
-  const { admitted, env, io, extraArgs, lease } = input;
+  const { admitted, env, io, extraArgs, lease, effectiveEngine } = input;
   try {
     const missingCredential = missingCredentialPreDispatchFailure(
       env.model,
@@ -22822,7 +22841,7 @@ async function dispatchAdmittedCollector(input) {
         io
       );
     }
-    await markRunRunning(admitted.runDirectory, env.model);
+    await markRunRunning(admitted.runDirectory, env.model, effectiveEngine);
     await clearTypedProviderHttpObservation(admitted.runDirectory);
     const childEnv = {
       ...process.env,
@@ -22830,6 +22849,7 @@ async function dispatchAdmittedCollector(input) {
       PI_CODING_AGENT_DIR: env.agentDir,
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
+    applyEngineChildEnv(childEnv, env.engine);
     const correlationId = admitted.correlationId ?? env.correlationId;
     if (correlationId !== void 0 && correlationId.trim() !== "") {
       childEnv.AK_CORRELATION_ID = correlationId;
@@ -22957,7 +22977,9 @@ async function runPublicCollector(argv, env, io, parseCollectorArgv2) {
     throw error;
   }
   const extraArgs = buildCollectorActivationExtraArgs(admitted, {
+    packageRoot: env.packageRoot,
     ...env.model === void 0 ? {} : { model: env.model },
+    ...env.engine === void 0 ? {} : { engine: env.engine },
     ...env.extraPiArgs === void 0 ? {} : { extraPiArgs: env.extraPiArgs }
   });
   return await dispatchAdmittedCollector({
@@ -22968,12 +22990,15 @@ async function runPublicCollector(argv, env, io, parseCollectorArgv2) {
     },
     io,
     extraArgs,
-    lease
+    lease,
+    ...env.engine === void 0 ? {} : { effectiveEngine: env.engine }
   });
 }
 var init_collector_run = __esm({
   "src/public-cli/collector-run.ts"() {
     "use strict";
+    init_engine_detour();
+    init_engine_material();
     init_explicit_internal();
     init_cli_errors();
     init_invocation();
@@ -22988,7 +23013,10 @@ var init_collector_run = __esm({
 import { writeFile as writeFile8 } from "node:fs/promises";
 import { join as join14 } from "node:path";
 function buildDoctorActivationExtraArgs(admitted, options = {}) {
-  const prompt = buildDoctorTransportPrompt(admitted);
+  const prompt = buildDoctorTransportPrompt(
+    admitted,
+    engineSessionMaterialFromOptions(options)
+  );
   return [
     "--no-skills",
     "--no-prompt-templates",
@@ -23030,7 +23058,7 @@ async function presentControlledFailure4(admitted, failureInput, io) {
   };
 }
 async function dispatchAdmittedDoctor(input) {
-  const { admitted, env, io, extraArgs, lease } = input;
+  const { admitted, env, io, extraArgs, lease, effectiveEngine } = input;
   try {
     const missingCredential = missingCredentialPreDispatchFailure(
       env.model,
@@ -23043,7 +23071,7 @@ async function dispatchAdmittedDoctor(input) {
         io
       );
     }
-    await markRunRunning(admitted.runDirectory, env.model);
+    await markRunRunning(admitted.runDirectory, env.model, effectiveEngine);
     await clearTypedProviderHttpObservation(admitted.runDirectory);
     const childEnv = {
       ...process.env,
@@ -23051,6 +23079,7 @@ async function dispatchAdmittedDoctor(input) {
       PI_CODING_AGENT_DIR: env.agentDir,
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
+    applyEngineChildEnv(childEnv, env.engine);
     if (env.correlationId !== void 0 && env.correlationId.trim() !== "") {
       childEnv.AK_CORRELATION_ID = env.correlationId;
     }
@@ -23183,7 +23212,9 @@ async function runPublicDoctor(argv, env, io, parseDoctorArgv2) {
     throw error;
   }
   const extraArgs = buildDoctorActivationExtraArgs(admitted, {
+    packageRoot: env.packageRoot,
     ...env.model === void 0 ? {} : { model: env.model },
+    ...env.engine === void 0 ? {} : { engine: env.engine },
     ...env.extraPiArgs === void 0 ? {} : { extraPiArgs: env.extraPiArgs }
   });
   return await dispatchAdmittedDoctor({
@@ -23191,12 +23222,15 @@ async function runPublicDoctor(argv, env, io, parseDoctorArgv2) {
     env,
     io,
     extraArgs,
-    lease
+    lease,
+    ...env.engine === void 0 ? {} : { effectiveEngine: env.engine }
   });
 }
 var init_doctor_run = __esm({
   "src/public-cli/doctor-run.ts"() {
     "use strict";
+    init_engine_detour();
+    init_engine_material();
     init_explicit_internal();
     init_cli_errors();
     init_invocation();
@@ -23211,7 +23245,10 @@ var init_doctor_run = __esm({
 import { writeFile as writeFile9 } from "node:fs/promises";
 import { join as join15 } from "node:path";
 function buildFixerActivationExtraArgs(admitted, options) {
-  const prompt = buildFixerTransportPrompt(admitted);
+  const prompt = buildFixerTransportPrompt(
+    admitted,
+    engineSessionMaterialFromOptions(options)
+  );
   const diagnosisSkillPath = resolvePackagedMethodSkillPath(
     options.packageRoot,
     "diagnosing-bugs"
@@ -23325,7 +23362,7 @@ async function presentControlledFailure5(admitted, failureInput, io) {
   };
 }
 async function dispatchAdmittedFixer(input) {
-  const { admitted, env, io, extraArgs, lease, methodMaterial } = input;
+  const { admitted, env, io, extraArgs, lease, methodMaterial, effectiveEngine } = input;
   try {
     const missingCredential = missingCredentialPreDispatchFailure(
       env.model,
@@ -23338,7 +23375,7 @@ async function dispatchAdmittedFixer(input) {
         io
       );
     }
-    await markRunRunning(admitted.runDirectory, env.model);
+    await markRunRunning(admitted.runDirectory, env.model, effectiveEngine);
     await clearTypedProviderHttpObservation(admitted.runDirectory);
     const childEnv = {
       ...process.env,
@@ -23346,6 +23383,7 @@ async function dispatchAdmittedFixer(input) {
       PI_CODING_AGENT_DIR: env.agentDir,
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
+    applyEngineChildEnv(childEnv, env.engine);
     const correlationId = admitted.correlationId ?? env.correlationId;
     if (correlationId !== void 0 && correlationId.trim() !== "") {
       childEnv.AK_CORRELATION_ID = correlationId;
@@ -23507,6 +23545,7 @@ async function runPublicFixer(argv, env, io, parseFixerArgv2) {
   const extraArgs = buildFixerActivationExtraArgs(admitted, {
     packageRoot: env.packageRoot,
     ...env.model === void 0 ? {} : { model: env.model },
+    ...env.engine === void 0 ? {} : { engine: env.engine },
     ...env.extraPiArgs === void 0 ? {} : { extraPiArgs: env.extraPiArgs }
   });
   return await dispatchAdmittedFixer({
@@ -23518,7 +23557,9 @@ async function runPublicFixer(argv, env, io, parseFixerArgv2) {
     io,
     extraArgs,
     lease,
-    methodMaterial
+    methodMaterial,
+    // #391: only initial Fixer dispatch records mechanical engine provenance.
+    ...env.engine === void 0 ? {} : { effectiveEngine: env.engine }
   });
 }
 async function runPublicFixerResume(argv, env, io) {
@@ -23594,6 +23635,8 @@ async function runPublicFixerResume(argv, env, io) {
 var init_fixer_run = __esm({
   "src/public-cli/fixer-run.ts"() {
     "use strict";
+    init_engine_detour();
+    init_engine_material();
     init_method_skill();
     init_explicit_internal();
     init_cli_errors();
@@ -23724,12 +23767,7 @@ async function dispatchAdmittedJudge(input) {
       // and role-runtime can record typed provider HTTP observations.
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
-    delete childEnv[AK_ROLE_ENGINE_ENV];
-    if (env.engine !== void 0 && env.engine.trim() !== "") {
-      childEnv[AK_ROLE_ENGINE_ENV] = env.engine.trim();
-    } else {
-      childEnv[AK_ROLE_ENGINE_ENV] = void 0;
-    }
+    applyEngineChildEnv(childEnv, env.engine);
     const correlationId = admitted.correlationId ?? env.correlationId;
     if (correlationId !== void 0 && correlationId.trim() !== "") {
       childEnv.AK_CORRELATION_ID = correlationId;
@@ -23957,7 +23995,10 @@ var init_judge_run = __esm({
 import { mkdir as mkdir4, writeFile as writeFile11 } from "node:fs/promises";
 import { join as join17, resolve as resolve6 } from "node:path";
 function buildMergerActivationExtraArgs(admitted, options) {
-  const prompt = buildMergerTransportPrompt(admitted);
+  const prompt = buildMergerTransportPrompt(
+    admitted,
+    engineSessionMaterialFromOptions(options)
+  );
   const skillPath = resolvePackagedMethodSkillPath(
     options.packageRoot,
     "resolving-merge-conflicts"
@@ -24060,7 +24101,7 @@ async function presentControlledFailure7(admitted, failureInput, io) {
   };
 }
 async function dispatchAdmittedMerger(input) {
-  const { admitted, env, io, extraArgs, lease, methodMaterial } = input;
+  const { admitted, env, io, extraArgs, lease, methodMaterial, effectiveEngine } = input;
   try {
     const missingCredential = missingCredentialPreDispatchFailure(
       env.model,
@@ -24073,7 +24114,7 @@ async function dispatchAdmittedMerger(input) {
         io
       );
     }
-    await markRunRunning(admitted.runDirectory, env.model);
+    await markRunRunning(admitted.runDirectory, env.model, effectiveEngine);
     await clearTypedProviderHttpObservation(admitted.runDirectory);
     const childEnv = {
       ...process.env,
@@ -24081,6 +24122,7 @@ async function dispatchAdmittedMerger(input) {
       PI_CODING_AGENT_DIR: env.agentDir,
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
+    applyEngineChildEnv(childEnv, env.engine);
     const correlationId = admitted.correlationId ?? env.correlationId;
     if (correlationId !== void 0 && correlationId.trim() !== "") {
       childEnv.AK_CORRELATION_ID = correlationId;
@@ -24312,6 +24354,7 @@ async function runPublicMerger(argv, env, io, parseMergerArgv2) {
   const extraArgs = buildMergerActivationExtraArgs(admitted, {
     packageRoot: env.packageRoot,
     ...env.model === void 0 ? {} : { model: env.model },
+    ...env.engine === void 0 ? {} : { engine: env.engine },
     ...env.extraPiArgs === void 0 ? {} : { extraPiArgs: env.extraPiArgs }
   });
   return await dispatchAdmittedMerger({
@@ -24323,7 +24366,8 @@ async function runPublicMerger(argv, env, io, parseMergerArgv2) {
     io,
     extraArgs,
     lease,
-    methodMaterial
+    methodMaterial,
+    ...env.engine === void 0 ? {} : { effectiveEngine: env.engine }
   });
 }
 async function runPublicMergerResume(argv, env, io) {
@@ -24402,6 +24446,8 @@ var init_merger_run = __esm({
     "use strict";
     init_activation_ledger_topology();
     init_sitian_role_run_coordinates();
+    init_engine_detour();
+    init_engine_material();
     init_method_skill();
     init_uuidv7();
     init_explicit_internal();
@@ -24554,12 +24600,7 @@ async function dispatchAdmittedReviewer(input) {
       PI_CODING_AGENT_DIR: env.agentDir,
       AK_ROLE_RUN_DIR: admitted.runDirectory
     };
-    delete childEnv[AK_ROLE_ENGINE_ENV];
-    if (env.engine !== void 0 && env.engine.trim() !== "") {
-      childEnv[AK_ROLE_ENGINE_ENV] = env.engine.trim();
-    } else {
-      childEnv[AK_ROLE_ENGINE_ENV] = void 0;
-    }
+    applyEngineChildEnv(childEnv, env.engine);
     const correlationId = admitted.correlationId ?? env.correlationId;
     if (correlationId !== void 0 && correlationId.trim() !== "") {
       childEnv.AK_CORRELATION_ID = correlationId;
@@ -27036,6 +27077,19 @@ function requireLegalEngineName(name) {
     );
   }
 }
+function requireEngineAxisSeat(seat, verb) {
+  if (seat === AUTOMATIC_NAVIGATOR_SEAT) {
+    throw new CliUsageError(
+      `config ${verb} refuses navigator: no independent activation path; storing would be silently ineffective`
+    );
+  }
+  if (!isEngineAxisSeat(seat)) {
+    throw new CliUsageError(`unknown engine-axis seat: ${seat}`);
+  }
+}
+function projectSeatEngine(seat) {
+  return seat.engine === void 0 ? {} : { engine: seat.engine };
+}
 function loadAndValidateConfig(home, packageRoot2) {
   return loadPublicCliConfig(home).then((config) => {
     try {
@@ -27107,7 +27161,7 @@ function renderHelp() {
     "",
     "Role options: ak-role help <command>",
     "Persistent config: ak-role config set <seat> <provider/model[:thinking]>",
-    "Persistent engine (judge|reviewer): ak-role config set-engine <seat> <name> | unset-engine <seat>",
+    "Persistent engine (callable roles): ak-role config set-engine <seat> <name> | unset-engine <seat>",
     "Effective seats: ak-role roles"
   );
   return `${lines.join("\n")}
@@ -27212,19 +27266,12 @@ async function runConfigCommand(args, home, packageRoot2, io) {
   if (args[0] === "set-engine") {
     if (args.length !== 3) {
       throw new CliUsageError(
-        "usage: ak-role config set-engine <judge|reviewer> <name>"
+        "usage: ak-role config set-engine <seat> <name>"
       );
     }
     const seat = args[1];
     const name = args[2];
-    if (!isPublicConfigurableSeat(seat)) {
-      throw new CliUsageError(`unknown configurable seat: ${seat}`);
-    }
-    if (!isEngineAxisSeat(seat)) {
-      throw new CliUsageError(
-        `engine axis is judge+reviewer only; refused seat ${seat}`
-      );
-    }
+    requireEngineAxisSeat(seat, "set-engine");
     requireLegalEngineName(name);
     let config = await loadAndValidateConfig(home, packageRoot2);
     try {
@@ -27242,18 +27289,11 @@ async function runConfigCommand(args, home, packageRoot2, io) {
   if (args[0] === "unset-engine") {
     if (args.length !== 2) {
       throw new CliUsageError(
-        "usage: ak-role config unset-engine <judge|reviewer>"
+        "usage: ak-role config unset-engine <seat>"
       );
     }
     const seat = args[1];
-    if (!isPublicConfigurableSeat(seat)) {
-      throw new CliUsageError(`unknown configurable seat: ${seat}`);
-    }
-    if (!isEngineAxisSeat(seat)) {
-      throw new CliUsageError(
-        `engine axis is judge+reviewer only; refused seat ${seat}`
-      );
-    }
+    requireEngineAxisSeat(seat, "unset-engine");
     let config = await loadAndValidateConfig(home, packageRoot2);
     try {
       config = setPersistentSeatEngine(config, seat, void 0);
@@ -27277,9 +27317,9 @@ async function runAkRole(argv, env) {
     const parsed = parseArgv(argv);
     if (parsed.engine !== void 0) {
       requireLegalEngineName(parsed.engine);
-      if (!parsed.help && parsed.command !== void 0 && parsed.command !== "help" && !isEngineAxisSeat(parsed.command)) {
+      if (!parsed.help && parsed.command !== void 0 && parsed.command !== "help" && !isPublicCallableRole(parsed.command)) {
         throw new CliUsageError(
-          `engine axis is judge+reviewer only; refused command ${parsed.command}`
+          `engine axis is role commands only; refused command ${parsed.command}`
         );
       }
     }
@@ -27473,7 +27513,7 @@ async function runAkRole(argv, env) {
           ...env.correlationId === void 0 ? {} : { correlationId: env.correlationId },
           ...env.piRunner === void 0 ? {} : { piRunner: env.piRunner },
           ...seat.selection === void 0 ? {} : { model: seat.selection },
-          ...seat.engine === void 0 ? {} : { engine: seat.engine },
+          ...projectSeatEngine(seat),
           ...env.judgeExtraPiArgs === void 0 ? {} : { extraPiArgs: env.judgeExtraPiArgs },
           ...env.judgeTimeoutMs === void 0 ? {} : { timeoutMs: env.judgeTimeoutMs },
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
@@ -27508,6 +27548,7 @@ async function runAkRole(argv, env) {
           ...env.correlationId === void 0 ? {} : { correlationId: env.correlationId },
           ...env.piRunner === void 0 ? {} : { piRunner: env.piRunner },
           ...seat.selection === void 0 ? {} : { model: seat.selection },
+          ...projectSeatEngine(seat),
           ...env.coderExtraPiArgs === void 0 ? {} : { extraPiArgs: env.coderExtraPiArgs },
           ...env.coderTimeoutMs === void 0 ? {} : { timeoutMs: env.coderTimeoutMs },
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
@@ -27542,6 +27583,7 @@ async function runAkRole(argv, env) {
           ...env.correlationId === void 0 ? {} : { correlationId: env.correlationId },
           ...env.piRunner === void 0 ? {} : { piRunner: env.piRunner },
           ...seat.selection === void 0 ? {} : { model: seat.selection },
+          ...projectSeatEngine(seat),
           ...env.fixerExtraPiArgs === void 0 ? {} : { extraPiArgs: env.fixerExtraPiArgs },
           ...env.fixerTimeoutMs === void 0 ? {} : { timeoutMs: env.fixerTimeoutMs },
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
@@ -27576,6 +27618,7 @@ async function runAkRole(argv, env) {
           ...env.correlationId === void 0 ? {} : { correlationId: env.correlationId },
           ...env.piRunner === void 0 ? {} : { piRunner: env.piRunner },
           ...seat.selection === void 0 ? {} : { model: seat.selection },
+          ...projectSeatEngine(seat),
           ...env.collectorExtraPiArgs === void 0 ? {} : { extraPiArgs: env.collectorExtraPiArgs },
           ...env.collectorTimeoutMs === void 0 ? {} : { timeoutMs: env.collectorTimeoutMs },
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
@@ -27610,7 +27653,7 @@ async function runAkRole(argv, env) {
           ...env.correlationId === void 0 ? {} : { correlationId: env.correlationId },
           ...env.piRunner === void 0 ? {} : { piRunner: env.piRunner },
           ...seat.selection === void 0 ? {} : { model: seat.selection },
-          ...seat.engine === void 0 ? {} : { engine: seat.engine },
+          ...projectSeatEngine(seat),
           ...env.reviewerExtraPiArgs === void 0 ? {} : { extraPiArgs: env.reviewerExtraPiArgs },
           ...env.reviewerTimeoutMs === void 0 ? {} : { timeoutMs: env.reviewerTimeoutMs },
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
@@ -27645,6 +27688,7 @@ async function runAkRole(argv, env) {
           ...env.correlationId === void 0 ? {} : { correlationId: env.correlationId },
           ...env.piRunner === void 0 ? {} : { piRunner: env.piRunner },
           ...seat.selection === void 0 ? {} : { model: seat.selection },
+          ...projectSeatEngine(seat),
           ...env.doctorExtraPiArgs === void 0 ? {} : { extraPiArgs: env.doctorExtraPiArgs },
           ...env.doctorTimeoutMs === void 0 ? {} : { timeoutMs: env.doctorTimeoutMs },
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }
@@ -27679,6 +27723,7 @@ async function runAkRole(argv, env) {
           ...env.correlationId === void 0 ? {} : { correlationId: env.correlationId },
           ...env.piRunner === void 0 ? {} : { piRunner: env.piRunner },
           ...seat.selection === void 0 ? {} : { model: seat.selection },
+          ...projectSeatEngine(seat),
           ...env.mergerExtraPiArgs === void 0 ? {} : { extraPiArgs: env.mergerExtraPiArgs },
           ...env.mergerTimeoutMs === void 0 ? {} : { timeoutMs: env.mergerTimeoutMs },
           ...env.createRunId === void 0 ? {} : { createRunId: env.createRunId }

package/package.json

@@ -1,11 +1,25 @@
 {
   "name": "@akagilnc/pi-workflow-roles",
-  "version": "0.1.2107",
+  "version": "0.1.2114",
   "description": "Soul-bound workflow roles for Pi",
   "type": "module",
   "license": "Apache-2.0",
   "keywords": [
-    "pi-package"
+    "pi-package",
+    "ai-agents",
+    "agents",
+    "agentic",
+    "multi-agent",
+    "agent-framework",
+    "agent-orchestration",
+    "ai-governance",
+    "human-in-the-loop",
+    "claude-code",
+    "codex",
+    "code-review",
+    "llm",
+    "ai",
+    "typescript"
   ],
   "bin": {
     "ak-role": "dist/public-cli/main.js"