@akagilnc/pi-workflow-roles 0.1.3837 → 0.1.3873

package/dist/host-descriptions.js

@@ -48,6 +48,7 @@ export const HOST_DESCRIPTIONS = Object.freeze({
 /**
  * Headless CLI family (#645). Claude is the first row; codex (#646) adds another.
  * fixedArgs: print mode, isolation without `--bare` (OAuth stays), full permissions.
+ * stream-json + verbose: live host events for sitian records (#811); result is last line.
  * `--setting-sources` empty = load no user/project/local CLAUDE.md/hooks/skills
  * (role envelope is delivered via `--system-prompt` wholesale replace).
  * `--strict-mcp-config` with no `--mcp-config` drops operator MCP + claude.ai connectors.
@@ -57,8 +58,10 @@ export const HEADLESS_HOST_DESCRIPTIONS = Object.freeze({
         binaryFromHome: Object.freeze([".local", "bin", "claude"]),
         sessionBindingFile: "claude-headless-session.json",
         fixedArgs: Object.freeze([
-            // One result envelope (not stream-json): typed receipt only; no event-stream copy.
-            "--output-format", "json",
+            // Live NDJSON events → sitian host-session records (#811); last line is the result receipt.
+            "--output-format", "stream-json",
+            // Intermediate assistant/tool/system events require verbose with stream-json.
+            "--verbose",
             "--permission-mode", "bypassPermissions",
             // Empty sources: no user/project/local operator surface (envelope owns materials).
             "--setting-sources", "",

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

@@ -12,6 +12,7 @@ import { promisify } from "node:util";
 import { randomUUID } from "node:crypto";
 import { ExplicitInternalActivationError } from "../host-contracts.js";
 import { applyEngineChildEnv } from "../engine-detour.js";
+import { projectActivationFlags } from "../role-activation-flags.js";
 /** Package-relative Internal role entrypoint (ADR 0052; same path as public-cli registry). */
 const INTERNAL_ROLE_ENTRYPOINT_RELATIVE = "extensions/role-runtime.ts";
 export function resolveInternalRoleEntrypoint(packageRoot) {
@@ -45,95 +46,20 @@ function buildSeatModelCliArgs(model) {
         ...(model.thinking === undefined ? [] : ["--thinking", model.thinking]),
     ];
 }
-function buildActivationFlagArgs(activation) {
-    switch (activation.role) {
-        case "judge":
-            return ["--ak-role", "judge"];
-        case "coder":
-            return [
-                "--ak-role",
-                "coder",
-                "--ak-coder-phase",
-                activation.phase,
-                "--ak-coder-task",
-                activation.taskPath,
-            ];
-        case "fixer":
-            return [
-                "--ak-role",
-                "fixer",
-                "--ak-fixer-phase",
-                activation.phase,
-                "--ak-fix-packet",
-                activation.packetPath,
-                ...(activation.prerequisitesPath === undefined
-                    ? []
-                    : ["--ak-fixer-prerequisites", activation.prerequisitesPath]),
-            ];
-        case "reviewer":
-            return [
-                "--ak-role",
-                "reviewer",
-                "--ak-review-base",
-                activation.baseRevision,
-                ...(activation.authorityRefs.length === 0
-                    ? []
-                    : ["--ak-review-authority-refs", JSON.stringify([...activation.authorityRefs])]),
-                ...(activation.ticketNumber === undefined
-                    ? []
-                    : ["--ak-review-ticket-number", String(activation.ticketNumber)]),
-            ];
-        case "merger":
-            return ["--ak-role", "merger", "--ak-merger-input", activation.inputPath];
-        case "collector":
-            return [
-                "--ak-role",
-                "collector",
-                "--ak-collector-repo",
-                activation.repo,
-                ...(activation.pr === undefined ? [] : ["--ak-collector-pr", activation.pr]),
-                ...(activation.requestManifestPath === undefined
-                    ? []
-                    : ["--ak-collector-request-manifest", activation.requestManifestPath]),
-                ...(activation.waitMs === undefined ? [] : ["--ak-collector-wait-ms", activation.waitMs]),
-            ];
-        case "doctor":
-            return ["--ak-role", "doctor", "--ak-doctor-case", activation.casePath];
-        case "notary":
-            return [
-                "--ak-role",
-                "notary",
-                "--ak-notary-source-run",
-                activation.sourceRun,
-                ...(activation.ticketNumber === undefined
-                    ? []
-                    : ["--ak-notary-ticket-number", String(activation.ticketNumber)]),
-            ];
-        case "countersign":
-            // ticketNumber rides activation/admission/invocation only (#632: no private flag).
-            return ["--ak-role", "countersign"];
-        case "gleaner-left":
-            return [
-                "--ak-role",
-                "gleaner-left",
-                "--ak-gleaner-left-base",
-                activation.baseRevision,
-            ];
-        case "inspector":
-            return ["--ak-role", "inspector"];
-        case "gatekeeper":
-            return ["--ak-role", "gatekeeper"];
-        case "navigator":
-            return ["--ak-role", "navigator"];
-        case "auditor":
-            return ["--ak-role", "auditor"];
-        case "diarist":
-            return ["--ak-role", "diarist"];
-        default: {
-            const _exhaustive = activation;
-            return _exhaustive;
-        }
+/**
+ * Pi last hop only: shared envelope flags → controlled-session argv pairs (#819).
+ * Flag membership/values stay in projectActivationFlags (middle layer).
+ */
+function activationFlagsToPiArgv(flags) {
+    const args = [];
+    for (const [name, value] of flags) {
+        if (value === false)
+            continue;
+        args.push(`--${name}`);
+        if (value !== true)
+            args.push(String(value));
     }
+    return args;
 }
 function buildMethodArgs(methods) {
     const skillArgs = [];
@@ -166,9 +92,10 @@ export function applyPiNativeSkillInvocation(methods, prompt) {
     return prompt.length === 0 ? token : `${token} ${prompt}`;
 }
 /**
- * Translate a closed RoleTurnRequest into Pi argv after `--no-extensions -e entry`.
- * Controlled session constants and session coordinates are adapter-internal.
- * Single forced method → Pi-native `/skill:` on the argv prompt (coder/reviewer/merger).
+ * Pi last-hop argv after `--no-extensions -e entry` (#819).
+ * Activation flag membership comes from middle-layer projectActivationFlags;
+ * this function only renders session coords, controlled constants, and pairs.
+ * Single forced method → Pi-native `/skill:` on the argv prompt (#822).
  */
 export function buildPiTurnExtraArgs(request, authority, extraPiArgs = []) {
     const { sessionFile, sessionDirectory } = authority.decode(request.principal);
@@ -190,7 +117,8 @@ export function buildPiTurnExtraArgs(request, authority, extraPiArgs = []) {
         "--session-dir",
         sessionDirectory,
         ...extraPiArgs,
-        ...buildActivationFlagArgs(request.activation),
+        // Envelope assembly = projectActivationFlags; pi only renders argv pairs.
+        ...activationFlagsToPiArgv(projectActivationFlags(request)),
         "--mode",
         "json",
         ...buildSeatModelCliArgs(request.model),

package/dist/public-cli/load-production-acp-host.js

@@ -36,5 +36,5 @@ export async function loadProductionAcpHostFactory(packageRoot, host) {
     const href = pathToFileURL(target).href;
     const mod = (await import(__rewriteRelativeImportExtension(href)));
     const create = mod.createProductionAcpRoleTurnHost;
-    return (options) => create({ ...options, description });
+    return (options) => create({ ...options, description, hostName: host });
 }

package/dist/public-cli/load-production-external-host.js

@@ -17,3 +17,13 @@ export async function loadProductionExternalHostFactory(packageRoot, host) {
     }
     throw new Error(`unregistered host: ${host}`);
 }
+/** Lazy production external host — sole builder for CLI adapter table + public summons (#820). */
+export function createLazyProductionExternalHost(options) {
+    let hostPromise;
+    return {
+        executeTurn: async (request) => {
+            hostPromise ??= loadProductionExternalHostFactory(options.packageRoot, options.hostName).then((create) => create({ packageRoot: options.packageRoot, principalAuthority: options.principalAuthority }));
+            return (await hostPromise).executeTurn(request);
+        },
+    };
+}

package/dist/public-cli/load-production-headless-host.js

@@ -32,5 +32,5 @@ export async function loadProductionHeadlessHostFactory(packageRoot, host) {
     const href = pathToFileURL(target).href;
     const mod = (await import(__rewriteRelativeImportExtension(href)));
     const create = mod.createProductionHeadlessRoleTurnHost;
-    return (options) => create({ ...options, description });
+    return (options) => create({ ...options, description, hostName: host });
 }

package/dist/public-cli/main.js

@@ -15090,6 +15090,12 @@ var init_diarist_contracts = __esm({
 function packagedRoleMetadata(role) {
   return PACKAGED_ROLE_REGISTRY.find((entry) => entry.role === role);
 }
+function packagedRoleInputFlag(role) {
+  return packagedRoleMetadata(role)?.inputFlag;
+}
+function packagedRolePhaseFlag(role) {
+  return packagedRoleMetadata(role)?.phaseFlag;
+}
 var NOTARY_SESSION_MATERIALS, INSPECTOR_SESSION_MATERIALS, AUDITOR_PUBLIC_SESSION_MATERIALS, PUBLIC_ROLE_RECORDS, PACKAGED_ROLE_REGISTRY;
 var init_packaged_role_registry = __esm({
   "src/packaged-role-registry.ts"() {
@@ -15527,9 +15533,11 @@ var init_host_descriptions = __esm({
         binaryFromHome: Object.freeze([".local", "bin", "claude"]),
         sessionBindingFile: "claude-headless-session.json",
         fixedArgs: Object.freeze([
-          // One result envelope (not stream-json): typed receipt only; no event-stream copy.
+          // Live NDJSON events → sitian host-session records (#811); last line is the result receipt.
           "--output-format",
-          "json",
+          "stream-json",
+          // Intermediate assistant/tool/system events require verbose with stream-json.
+          "--verbose",
           "--permission-mode",
           "bypassPermissions",
           // Empty sources: no user/project/local operator surface (envelope owns materials).
@@ -16180,7 +16188,7 @@ async function loadProductionAcpHostFactory(packageRoot2, host) {
   const href = pathToFileURL(target).href;
   const mod = await import(href);
   const create = mod.createProductionAcpRoleTurnHost;
-  return (options) => create({ ...options, description });
+  return (options) => create({ ...options, description, hostName: host });
 }
 var init_load_production_acp_host = __esm({
   "src/public-cli/load-production-acp-host.ts"() {
@@ -16204,7 +16212,7 @@ async function loadProductionHeadlessHostFactory(packageRoot2, host) {
   const href = pathToFileURL2(target).href;
   const mod = await import(href);
   const create = mod.createProductionHeadlessRoleTurnHost;
-  return (options) => create({ ...options, description });
+  return (options) => create({ ...options, description, hostName: host });
 }
 var init_load_production_headless_host = __esm({
   "src/public-cli/load-production-headless-host.ts"() {
@@ -16224,6 +16232,17 @@ async function loadProductionExternalHostFactory(packageRoot2, host) {
   }
   throw new Error(`unregistered host: ${host}`);
 }
+function createLazyProductionExternalHost(options) {
+  let hostPromise;
+  return {
+    executeTurn: async (request) => {
+      hostPromise ??= loadProductionExternalHostFactory(options.packageRoot, options.hostName).then(
+        (create) => create({ packageRoot: options.packageRoot, principalAuthority: options.principalAuthority })
+      );
+      return (await hostPromise).executeTurn(request);
+    }
+  };
+}
 var init_load_production_external_host = __esm({
   "src/public-cli/load-production-external-host.ts"() {
     "use strict";
@@ -16258,11 +16277,17 @@ var init_host_contracts = __esm({
 });
 
 // src/engine-detour.ts
+function normalizeEngineName(engine) {
+  if (engine === void 0) return void 0;
+  const trimmed = engine.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
 function applyEngineChildEnv(childEnv, engine) {
   delete childEnv[AK_ROLE_ENGINE_ENV];
-  if (engine !== void 0 && engine.trim() !== "") {
-    childEnv[AK_ROLE_ENGINE_ENV] = engine.trim();
-  } else {
+  const normalized = normalizeEngineName(engine);
+  if (normalized !== void 0) {
+    childEnv[AK_ROLE_ENGINE_ENV] = normalized;
+  } else if (childEnv !== process.env) {
     childEnv[AK_ROLE_ENGINE_ENV] = void 0;
   }
 }
@@ -16275,6 +16300,50 @@ var init_engine_detour = __esm({
   }
 });
 
+// src/role-activation-flags.ts
+function projectActivationFlags(request) {
+  const activation = request.activation;
+  const flags = /* @__PURE__ */ new Map([["ak-role", activation.role]]);
+  const inputFlag = packagedRoleInputFlag(activation.role);
+  const phaseFlag = packagedRolePhaseFlag(activation.role);
+  if ("phase" in activation && phaseFlag !== void 0) flags.set(phaseFlag, activation.phase);
+  if (inputFlag !== void 0) {
+    const path = "taskPath" in activation ? activation.taskPath : "packetPath" in activation ? activation.packetPath : "casePath" in activation ? activation.casePath : "inputPath" in activation ? activation.inputPath : "sourceRun" in activation ? activation.sourceRun : void 0;
+    if (path !== void 0) flags.set(inputFlag, path);
+  }
+  if (activation.role === "fixer" && activation.prerequisitesPath !== void 0) {
+    flags.set("ak-fixer-prerequisites", activation.prerequisitesPath);
+  }
+  if (activation.role === "reviewer") {
+    flags.set("ak-review-base", activation.baseRevision);
+    flags.set("ak-review-authority-refs", JSON.stringify(activation.authorityRefs));
+    if (activation.ticketNumber !== void 0) {
+      flags.set("ak-review-ticket-number", String(activation.ticketNumber));
+    }
+  }
+  if (activation.role === "notary" && activation.ticketNumber !== void 0) {
+    flags.set("ak-notary-ticket-number", String(activation.ticketNumber));
+  }
+  if (activation.role === "gleaner-left") {
+    flags.set("ak-gleaner-left-base", activation.baseRevision);
+  }
+  if (activation.role === "collector") {
+    flags.set("ak-collector-repo", activation.repo);
+    if (activation.pr !== void 0) flags.set("ak-collector-pr", activation.pr);
+    if (activation.requestManifestPath !== void 0) {
+      flags.set("ak-collector-request-manifest", activation.requestManifestPath);
+    }
+    if (activation.waitMs !== void 0) flags.set("ak-collector-wait-ms", activation.waitMs);
+  }
+  return flags;
+}
+var init_role_activation_flags = __esm({
+  "src/role-activation-flags.ts"() {
+    "use strict";
+    init_packaged_role_registry();
+  }
+});
+
 // src/sitian-contracts.ts
 function attachDirectErrnoCode(error, cause) {
   if (cause === null || typeof cause !== "object" || !("code" in cause)) return;
@@ -16604,84 +16673,14 @@ function buildSeatModelCliArgs(model) {
     ...model.thinking === void 0 ? [] : ["--thinking", model.thinking]
   ];
 }
-function buildActivationFlagArgs(activation) {
-  switch (activation.role) {
-    case "judge":
-      return ["--ak-role", "judge"];
-    case "coder":
-      return [
-        "--ak-role",
-        "coder",
-        "--ak-coder-phase",
-        activation.phase,
-        "--ak-coder-task",
-        activation.taskPath
-      ];
-    case "fixer":
-      return [
-        "--ak-role",
-        "fixer",
-        "--ak-fixer-phase",
-        activation.phase,
-        "--ak-fix-packet",
-        activation.packetPath,
-        ...activation.prerequisitesPath === void 0 ? [] : ["--ak-fixer-prerequisites", activation.prerequisitesPath]
-      ];
-    case "reviewer":
-      return [
-        "--ak-role",
-        "reviewer",
-        "--ak-review-base",
-        activation.baseRevision,
-        ...activation.authorityRefs.length === 0 ? [] : ["--ak-review-authority-refs", JSON.stringify([...activation.authorityRefs])],
-        ...activation.ticketNumber === void 0 ? [] : ["--ak-review-ticket-number", String(activation.ticketNumber)]
-      ];
-    case "merger":
-      return ["--ak-role", "merger", "--ak-merger-input", activation.inputPath];
-    case "collector":
-      return [
-        "--ak-role",
-        "collector",
-        "--ak-collector-repo",
-        activation.repo,
-        ...activation.pr === void 0 ? [] : ["--ak-collector-pr", activation.pr],
-        ...activation.requestManifestPath === void 0 ? [] : ["--ak-collector-request-manifest", activation.requestManifestPath],
-        ...activation.waitMs === void 0 ? [] : ["--ak-collector-wait-ms", activation.waitMs]
-      ];
-    case "doctor":
-      return ["--ak-role", "doctor", "--ak-doctor-case", activation.casePath];
-    case "notary":
-      return [
-        "--ak-role",
-        "notary",
-        "--ak-notary-source-run",
-        activation.sourceRun,
-        ...activation.ticketNumber === void 0 ? [] : ["--ak-notary-ticket-number", String(activation.ticketNumber)]
-      ];
-    case "countersign":
-      return ["--ak-role", "countersign"];
-    case "gleaner-left":
-      return [
-        "--ak-role",
-        "gleaner-left",
-        "--ak-gleaner-left-base",
-        activation.baseRevision
-      ];
-    case "inspector":
-      return ["--ak-role", "inspector"];
-    case "gatekeeper":
-      return ["--ak-role", "gatekeeper"];
-    case "navigator":
-      return ["--ak-role", "navigator"];
-    case "auditor":
-      return ["--ak-role", "auditor"];
-    case "diarist":
-      return ["--ak-role", "diarist"];
-    default: {
-      const _exhaustive = activation;
-      return _exhaustive;
-    }
+function activationFlagsToPiArgv(flags) {
+  const args = [];
+  for (const [name, value] of flags) {
+    if (value === false) continue;
+    args.push(`--${name}`);
+    if (value !== true) args.push(String(value));
   }
+  return args;
 }
 function buildMethodArgs(methods) {
   const skillArgs = [];
@@ -16723,7 +16722,8 @@ function buildPiTurnExtraArgs(request, authority, extraPiArgs = []) {
     "--session-dir",
     sessionDirectory,
     ...extraPiArgs,
-    ...buildActivationFlagArgs(request.activation),
+    // Envelope assembly = projectActivationFlags; pi only renders argv pairs.
+    ...activationFlagsToPiArgv(projectActivationFlags(request)),
     "--mode",
     "json",
     ...buildSeatModelCliArgs(request.model),
@@ -16940,6 +16940,7 @@ var init_role_turn_host = __esm({
     "use strict";
     init_host_contracts();
     init_engine_detour();
+    init_role_activation_flags();
     init_sitian_facade();
     INTERNAL_ROLE_ENTRYPOINT_RELATIVE2 = "extensions/role-runtime.ts";
     execFileAsync = promisify(execFile);
@@ -32019,23 +32020,15 @@ function resolveRoleTurnHost(env, options) {
     { name: "pi", create: () => ({ ok: true, host: piHost }) },
     ...packagedExternalHostNames().map((name) => ({
       name,
-      create: () => {
-        let hostPromise;
-        return {
-          ok: true,
-          host: {
-            executeTurn: async (request) => {
-              hostPromise ??= loadProductionExternalHostFactory(env.packageRoot, name).then(
-                (create) => create({
-                  packageRoot: env.packageRoot,
-                  principalAuthority: options.principalAuthority
-                })
-              );
-              return (await hostPromise).executeTurn(request);
-            }
-          }
-        };
-      }
+      create: () => ({
+        ok: true,
+        // Factory loads outside the public bin static graph (ADR 0052 peer-free discovery).
+        host: createLazyProductionExternalHost({
+          packageRoot: env.packageRoot,
+          hostName: name,
+          principalAuthority: options.principalAuthority
+        })
+      })
     }))
   ];
   const hostName = options.seat.host;

package/dist/public-role-summons.js

@@ -100,24 +100,17 @@ async function createSummonEnv(options) {
   let roleTurnHost = piHost;
   if (hostName !== "pi") {
     const { lookupHostFamily } = await import("./host-descriptions.js");
-    const { loadProductionExternalHostFactory } = await import("./public-cli/load-production-external-host.js");
+    const { createLazyProductionExternalHost } = await import("./public-cli/load-production-external-host.js");
     if (lookupHostFamily(hostName) === void 0) {
       throw new Error(
         `public role summons host unregistered: host=${hostName} seat=${options.role}`
       );
     }
-    let hostPromise;
-    roleTurnHost = {
-      executeTurn: async (request) => {
-        hostPromise ??= loadProductionExternalHostFactory(options.packageRoot, hostName).then(
-          (create) => create({
-            packageRoot: options.packageRoot,
-            principalAuthority
-          })
-        );
-        return (await hostPromise).executeTurn(request);
-      }
-    };
+    roleTurnHost = createLazyProductionExternalHost({
+      packageRoot: options.packageRoot,
+      hostName,
+      principalAuthority
+    });
   }
   const { loadHostProvidersTable, projectHostFacingProvider } = await import("./public-cli/host-providers.js");
   const hostFacingSelection = options.seat.selection === void 0 ? void 0 : projectHostFacingProvider(
@@ -151,8 +144,7 @@ async function summonPublicRole(options) {
   } = await import("./public-cli/config.js");
   const credentials = options.credentials ?? await loadCredentialProviders(agentDir);
   const config = await loadPublicCliConfig(home);
-  const invocation = options.host === void 0 ? void 0 : { host: options.host };
-  const seat = resolveEffectiveSeat(config, options.role, credentials, invocation);
+  const seat = resolveEffectiveSeat(config, options.role, credentials);
   const env = {
     ...await createSummonEnv({
       role: options.role,
@@ -264,38 +256,6 @@ async function summonPublicRole(options) {
     ...stderr === void 0 || stderr === "" ? {} : { stderr }
   };
 }
-async function parentInvocationHost(sourceRunDirectory) {
-  const { readFile } = await import("node:fs/promises");
-  const path = join(sourceRunDirectory, "invocation.json");
-  let text;
-  try {
-    text = await readFile(path, "utf8");
-  } catch (error) {
-    const code = error instanceof Error && "code" in error ? error.code : void 0;
-    throw new Error(
-      `parent invocation.json required for gate source run at ${path}: ${code ?? (error instanceof Error ? error.message : String(error))}`,
-      { cause: error }
-    );
-  }
-  let raw;
-  try {
-    raw = JSON.parse(text);
-  } catch (error) {
-    throw new Error(
-      `parent invocation.json unreadable at ${path}: ${error instanceof Error ? error.message : String(error)}`,
-      { cause: error }
-    );
-  }
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    throw new Error(`parent invocation.json has non-object shape at ${path}`);
-  }
-  const host = raw.host;
-  if (host === void 0) return void 0;
-  if (typeof host !== "string" || host.trim() === "") {
-    throw new Error(`parent invocation.json host must be a non-empty string at ${path}`);
-  }
-  return host;
-}
 async function summonGateOfficer(options) {
   let home = options.home;
   if (home === void 0) {
@@ -309,7 +269,6 @@ async function summonGateOfficer(options) {
       submission: options.submission
     });
   }
-  const parentHost = await parentInvocationHost(options.sourceRunDirectory);
   const common = {
     cwd: options.cwd,
     ...home === void 0 ? {} : { home },
@@ -318,7 +277,6 @@ async function summonGateOfficer(options) {
     ...options.signal === void 0 ? {} : { signal: options.signal },
     ...options.reask === void 0 ? {} : { reviewReask: options.reask },
     ...gateReviewInstruction === void 0 ? {} : { gateReviewInstruction },
-    ...parentHost === void 0 ? {} : { host: parentHost },
     ...options.roleTurnHost === void 0 ? {} : { roleTurnHost: options.roleTurnHost },
     ...options.createRunId === void 0 ? {} : { createRunId: options.createRunId }
   };

package/dist/reviewer-agent.js

@@ -76,6 +76,7 @@ export function createReviewerAgentRunner(dependencies = {}) {
                         ...(dependencies.packageRoot === undefined
                             ? {}
                             : { packageRoot: dependencies.packageRoot }),
+                        ...(options.getFlag === undefined ? {} : { getFlag: options.getFlag }),
                     });
                     const disposition = await workspaceOwner.dispose(workspace);
                     return [leg.axis, Object.freeze({ status: "successful", report: child.report, usage: child.usage, target: batch.target, prompt: child.prompt, workspaceDisposition: disposition })];

package/dist/reviewer-child-executor.js

@@ -1,5 +1,5 @@
 import { createEngineDetourToolDefinition } from "./engine-detour-tool.js";
-import { engineNameFromEnv } from "./engine-detour.js";
+import { resolveEngineName } from "./engine-detour.js";
 import { appendEngineSessionMaterial, engineSessionMaterialFromOptions, } from "./package-resources/engine-material.js";
 import { readPackageMaterial } from "./session-opening-materials.js";
 import { hasUpstreamErrorTestimony, isNonSuccessHttpStatus } from "./upstream-error-testimony.js";
@@ -98,7 +98,8 @@ export async function executeReviewerChild(workspace, leg, context, options = {}
         const selection = await parentSelection(context);
         const { openPiInProcessSession } = await import("./pi/in-process-session.js");
         const { createRecordSession } = await import("./archivist-record-entry.js");
-        const engineName = engineNameFromEnv();
+        // One gate with parent registration (#818): request flag, else pi child env.
+        const engineName = resolveEngineName(options.getFlag);
         const engineMaterial = engineName === undefined
             ? undefined
             : options.packageRoot === undefined || options.packageRoot.trim() === ""

package/dist/role-activation-flags.js

@@ -0,0 +1,50 @@
+import { packagedRoleInputFlag, packagedRolePhaseFlag } from "./packaged-role-registry.js";
+/** Project closed RoleTurnActivation onto the shared host flag map. */
+export function projectActivationFlags(request) {
+    const activation = request.activation;
+    const flags = new Map([["ak-role", activation.role]]);
+    const inputFlag = packagedRoleInputFlag(activation.role);
+    const phaseFlag = packagedRolePhaseFlag(activation.role);
+    if ("phase" in activation && phaseFlag !== undefined)
+        flags.set(phaseFlag, activation.phase);
+    if (inputFlag !== undefined) {
+        const path = "taskPath" in activation ? activation.taskPath
+            : "packetPath" in activation ? activation.packetPath
+                : "casePath" in activation ? activation.casePath
+                    : "inputPath" in activation ? activation.inputPath
+                        : "sourceRun" in activation ? activation.sourceRun
+                            : undefined;
+        if (path !== undefined)
+            flags.set(inputFlag, path);
+    }
+    if (activation.role === "fixer" && activation.prerequisitesPath !== undefined) {
+        flags.set("ak-fixer-prerequisites", activation.prerequisitesPath);
+    }
+    if (activation.role === "reviewer") {
+        flags.set("ak-review-base", activation.baseRevision);
+        flags.set("ak-review-authority-refs", JSON.stringify(activation.authorityRefs));
+        if (activation.ticketNumber !== undefined) {
+            flags.set("ak-review-ticket-number", String(activation.ticketNumber));
+        }
+    }
+    // countersign ticketNumber stays on activation/admission/invocation only —
+    // no private transport flag (inner-gate material path deleted in #632).
+    if (activation.role === "notary" && activation.ticketNumber !== undefined) {
+        flags.set("ak-notary-ticket-number", String(activation.ticketNumber));
+    }
+    if (activation.role === "gleaner-left") {
+        flags.set("ak-gleaner-left-base", activation.baseRevision);
+    }
+    if (activation.role === "collector") {
+        flags.set("ak-collector-repo", activation.repo);
+        // #676 D1: pr optional at admission; omit flag when role binds from materials.
+        if (activation.pr !== undefined)
+            flags.set("ak-collector-pr", activation.pr);
+        if (activation.requestManifestPath !== undefined) {
+            flags.set("ak-collector-request-manifest", activation.requestManifestPath);
+        }
+        if (activation.waitMs !== undefined)
+            flags.set("ak-collector-wait-ms", activation.waitMs);
+    }
+    return flags;
+}