@akagilnc/pi-workflow-roles 0.1.4802 → 0.1.4874

package/dist/packaged-role-registry.js

@@ -1,10 +1,11 @@
 import { COLLECTOR_OUTPUT_TOOL } from "./package-contracts/collector-output.js";
+import { COLLECTOR_WAIT_TOOL } from "./collector-ledger.js";
 import { GATEKEEPER_OUTPUT_TOOL_NAME } from "./package-contracts/gatekeeper-output.js";
 import { NAVIGATOR_OUTPUT_TOOL_NAME } from "./package-contracts/navigator-output.js";
 import { JUDGE_OUTPUT_TOOL_NAME } from "./package-contracts/judge-output.js";
 import { REVIEWER_OUTPUT_TOOL_NAME } from "./package-contracts/reviewer-output.js";
 import { CODER_OUTPUT_TOOL_NAME, FIXER_OUTPUT_TOOL_NAME } from "./package-contracts/worker-output.js";
-import { DOCTOR_OUTPUT_TOOL_NAME } from "./doctor-contracts.js";
+import { DOCTOR_AUDIT_TOOL_NAME, DOCTOR_OUTPUT_TOOL_NAME } from "./doctor-contracts.js";
 import { MERGER_OUTPUT_TOOL_NAME } from "./merger-contracts.js";
 import { NOTARY_OUTPUT_TOOL_NAME } from "./notary-contracts.js";
 import { COUNTERSIGN_OUTPUT_TOOL_NAME } from "./countersign-contracts.js";
@@ -13,6 +14,7 @@ import { INSPECTOR_OUTPUT_TOOL_NAME } from "./inspector-contracts.js";
 import { AUDITOR_OUTPUT_TOOL_NAME } from "./package-contracts/auditor-output.js";
 import { DIARIST_OUTPUT_TOOL_NAME } from "./diarist-contracts.js";
 import { SECRETARIAT_OUTPUT_TOOL_NAME } from "./secretariat-contracts.js";
+import { JUDGE_AUDIT_TOOL_NAME } from "./judge-auditor.js";
 const NOTARY_SESSION_MATERIALS = [
   "CLAUDE.md",
   "souls/notary.md",
@@ -37,11 +39,25 @@ const AUDITOR_PUBLIC_SESSION_MATERIALS = [
 const PUBLIC_ROLE_RECORDS = [
   {
     role: "judge",
+    inCallAutoResume: true,
+    presentSettled: "default",
+    summonResume: false,
+    admission: "instruction",
+    /** Public argv rejects a burden selector. */
+    bareToken: "burden",
+    sameParent: "none",
     phases: [null],
     outputTool: JUDGE_OUTPUT_TOOL_NAME,
-    inputFlag: void 0,
-    phaseFlag: void 0,
+    auditTool: JUDGE_AUDIT_TOOL_NAME,
+    settlement: "sealed",
+    runnerFailure: "engine-detour-known-first",
+    acceptedText: "\u5927\u7406\u5BFA\u56DE\u6267\u5DF2\u63A5\u53D7",
+    /** Factory board: court until another station has started, then marshal. */
+    boardPlacement: "judge-history",
+    /** Navigator subject is the public admitted instruction when the run is bound. */
+    navigatorSubject: "public-instruction",
     activationStage: "load-and-install",
+    receiptStatusKey: "judgeStatus",
     sessionMaterials: [
       "CLAUDE.md",
       "souls/judge.md",
@@ -52,10 +68,35 @@ const PUBLIC_ROLE_RECORDS = [
   },
   {
     role: "fixer",
+    inCallAutoResume: true,
+    presentSettled: "default",
+    summonResume: false,
+    admission: "worker-packet",
+    sameParent: "none",
+    worker: true,
+    methodSkills: ["diagnosing-bugs", "tdd"],
+    settleMethod: "diagnosing-bugs",
     phases: ["plan", "apply"],
     outputTool: FIXER_OUTPUT_TOOL_NAME,
-    inputFlag: "ak-fix-packet",
-    phaseFlag: "ak-fixer-phase",
+    settlement: "sealed",
+    artifactFace: {
+      reportPhase: true,
+      evidenceRole: true,
+      leaves: [
+        { key: "phase" },
+        { key: "packetPath" },
+        { key: "prerequisitesPath", omitUndefined: true },
+        { key: "prerequisites" }
+      ],
+      method: "observed"
+    },
+    acceptedText: "\u4FEE\u5185\u53F8\u56DE\u6267\u5DF2\u63A5\u53D7",
+    boardPlacement: "marshal",
+    activationFlags: [
+      { field: "packetPath", flag: "ak-fix-packet", binds: "input" },
+      { field: "phase", flag: "ak-fixer-phase", binds: "phase" },
+      { field: "prerequisitesPath", flag: "ak-fixer-prerequisites" }
+    ],
     activationStage: "load-and-install",
     sessionMaterials: [
       "CLAUDE.md",
@@ -66,10 +107,33 @@ const PUBLIC_ROLE_RECORDS = [
   },
   {
     role: "coder",
+    inCallAutoResume: true,
+    presentSettled: "default",
+    summonResume: false,
+    admission: "worker-task",
+    sameParent: "none",
+    worker: true,
+    applyMethod: "tdd",
+    /** Method-material load failure keeps the activation cause (not reviewer/fixer). */
+    methodLoadFailureCause: "activation",
+    boardPlacement: "coder",
     phases: ["plan", "apply"],
     outputTool: CODER_OUTPUT_TOOL_NAME,
-    inputFlag: "ak-coder-task",
-    phaseFlag: "ak-coder-phase",
+    settlement: "sealed",
+    artifactFace: {
+      reportPhase: true,
+      evidenceRole: true,
+      leaves: [
+        { key: "phase" },
+        { key: "taskPath" }
+      ],
+      method: "optional"
+    },
+    acceptedText: "\u5C06\u4F5C\u76D1\u56DE\u6267\u5DF2\u63A5\u53D7",
+    activationFlags: [
+      { field: "taskPath", flag: "ak-coder-task", binds: "input" },
+      { field: "phase", flag: "ak-coder-phase", binds: "phase" }
+    ],
     activationStage: "load-and-install",
     sessionMaterials: [
       "CLAUDE.md",
@@ -80,11 +144,47 @@ const PUBLIC_ROLE_RECORDS = [
   },
   {
     role: "reviewer",
+    inCallAutoResume: true,
+    presentSettled: "default",
+    summonResume: false,
+    admission: "review-basis",
+    /** --base is a single Skill-arg token, and authority refs are always emitted. */
+    baseValue: "revision",
+    emitAuthorityRefs: true,
+    sameParent: "none",
+    methodSkills: ["ak-cross-m-review"],
+    settleMethod: "ak-cross-m-review",
+    /** Omitted public lens starts two ordinary single-axis runs (ADR 0052). */
+    parallelLenses: true,
+    /** Every turn runs in a fresh worktree; durable projectRoot stays the caller project (#946). */
+    freshExecutionCopy: true,
     phases: [null],
     bareCommand: false,
     outputTool: REVIEWER_OUTPUT_TOOL_NAME,
-    inputFlag: void 0,
-    phaseFlag: void 0,
+    settlement: "sealed",
+    /** Publish only an accepted ledger outcome; audit escalation stays unsettled here. */
+    sealedAcceptedOnly: true,
+    artifactFace: {
+      evidenceRole: true,
+      leaves: [
+        { key: "baseRevision" },
+        { key: "lens" },
+        { key: "authorityRefs", copyArray: true },
+        { key: "callerProvenance", callerProvenance: true }
+      ],
+      method: "observed"
+    },
+    /** Frozen base/lens/authority become the initial prompt; instruction follows. */
+    transportPrompt: "skill-args",
+    runnerFailure: "engine-detour-record-first",
+    acceptedText: "\u5FA1\u53F2\u53F0\u56DE\u6267\u5DF2\u63A5\u53D7",
+    boardPlacement: "marshal",
+    activationFlags: [
+      { field: "baseRevision", flag: "ak-review-base" },
+      { field: "lens", flag: "ak-review-lens" },
+      { field: "authorityRefs", flag: "ak-review-authority-refs" },
+      { field: "ticketNumber", flag: "ak-review-ticket-number" }
+    ],
     activationStage: "load-and-install",
     sessionMaterials: [
       "CLAUDE.md",
@@ -96,60 +196,189 @@ const PUBLIC_ROLE_RECORDS = [
   // ak-collector-repo is GitHub owner/repo identity, not a local material path (#438).
   {
     role: "collector",
+    inCallAutoResume: false,
+    presentSettled: "always",
+    summonResume: false,
+    admission: "collect-target",
+    /** Public no_receipt projects a durable bind-target rejection. */
+    projectTargetBindRejection: true,
+    sameParent: "none",
     phases: [null],
     bareCommand: false,
     outputTool: COLLECTOR_OUTPUT_TOOL,
-    inputFlag: void 0,
-    phaseFlag: void 0,
+    settlement: "residual",
+    /** #633: a prior wait-tool residual must not mask this attempt. */
+    residualScan: "current-attempt",
+    residualTool: COLLECTOR_WAIT_TOOL,
+    runnerFailure: "collector-known-first",
+    artifactFace: {
+      evidenceRole: true,
+      leaves: [
+        { key: "prNumber", omitUndefined: true },
+        { key: "repository", from: "repository.canonical" },
+        { key: "manifestDigest" }
+      ]
+    },
+    acceptedText: "\u901A\u8FDB\u53F8\u56DE\u6267\u5DF2\u63A5\u53D7",
+    boardPlacement: "collector",
+    /** Taishi acceptance is a typed groups array, not a status leaf. */
+    analystTerminal: "groups",
+    activationFlags: [
+      { field: "repo", from: "repository.display", flag: "ak-collector-repo" },
+      { field: "pr", from: "prNumber", text: true, flag: "ak-collector-pr" },
+      { field: "requestManifestPath", flag: "ak-collector-request-manifest" },
+      { field: "waitMs", from: "waitWindowMs", text: true, flag: "ak-collector-wait-ms" }
+    ],
     activationStage: "load-and-install",
     sessionMaterials: ["CLAUDE.md", "souls/collector.md"]
   },
   {
     role: "doctor",
+    inCallAutoResume: false,
+    presentSettled: "typed",
+    summonResume: false,
+    admission: "case-identity",
+    sameParent: "none",
     phases: [null],
     bareCommand: false,
     outputTool: DOCTOR_OUTPUT_TOOL_NAME,
-    inputFlag: "ak-doctor-case",
-    phaseFlag: void 0,
+    auditTool: DOCTOR_AUDIT_TOOL_NAME,
+    settlement: "sealed",
+    artifactFace: {
+      evidenceRole: true,
+      leaves: [
+        { key: "issueNumber" },
+        { key: "caseRunsPath" },
+        { key: "caseIdentity" }
+      ],
+      doctorReportFacts: true
+    },
+    acceptedText: "\u592A\u533B\u7F72\u56DE\u6267\u5DF2\u63A5\u53D7",
+    /** Navigator subject is the doctor case, not the case-path file bytes. */
+    navigatorSubject: "case",
+    activationFlags: [
+      { field: "casePath", from: "caseRunsPath", flag: "ak-doctor-case", binds: "input" }
+    ],
     activationStage: "load-and-install",
     sessionMaterials: ["CLAUDE.md", "souls/doctor.md"]
   },
   {
     role: "merger",
+    inCallAutoResume: true,
+    presentSettled: "typed",
+    summonResume: false,
+    admission: "merge-envelope",
+    /** Public argv rejects packet fields the adapter reads from Git. */
+    bareToken: "packet",
+    sameParent: "none",
+    methodSkills: ["resolving-merge-conflicts"],
+    settleMethod: "resolving-merge-conflicts",
+    /** Method-material load failure keeps the activation cause (not reviewer/fixer). */
+    methodLoadFailureCause: "activation",
     phases: [null],
     outputTool: MERGER_OUTPUT_TOOL_NAME,
-    inputFlag: "ak-merger-input",
-    phaseFlag: void 0,
+    settlement: "residual",
+    /** #836: residual scan stays on the whole host session. */
+    residualScan: "session",
+    residualTool: MERGER_OUTPUT_TOOL_NAME,
+    artifactFace: {
+      evidenceRole: true,
+      leaves: [
+        { key: "mergerInputPath" },
+        { key: "derived" }
+      ],
+      method: "observed"
+    },
+    acceptedText: "\u5408\u5E76\u56DE\u6267\u5DF2\u63A5\u53D7",
+    activationFlags: [
+      { field: "inputPath", from: "mergerInputPath", flag: "ak-merger-input", binds: "input" }
+    ],
     activationStage: "prepare-git-and-install",
+    receiptCommitKey: "mergeCommitId",
+    receiptCommitWhen: "completed",
     sessionMaterials: ["CLAUDE.md", "souls/merger.md"]
   },
   {
     role: "notary",
+    inCallAutoResume: false,
+    presentSettled: "always",
+    summonResume: false,
+    admission: "source-locator",
+    /** Public argv is only the source-run locator; stored text is not trimmed. */
+    bareToken: "instruction",
+    sourceRunStored: "raw",
+    argvResult: "source-run",
+    sameParent: "source-locator",
+    /** Infrastructure failure at this stage has no accepted gate cycle to project. */
+    skipGateOnInfrastructureStage: true,
+    /** 符宝郎 is a review officer and inherits the gatekeeper model. */
+    reviewOfficer: true,
+    provinceConfig: true,
+    modelInheritsFrom: "gatekeeper",
     phases: [null],
     bareCommand: false,
     outputTool: NOTARY_OUTPUT_TOOL_NAME,
-    inputFlag: "ak-notary-source-run",
-    phaseFlag: void 0,
+    settlement: "accepted",
+    /** Court reask replaces the initial prompt. Otherwise the fixed kickoff. */
+    reaskPrompt: true,
+    transportPrompt: "fixed-kickoff",
+    acceptedText: "\u7B26\u5B9D\u90CE\u56DE\u6267\u5DF2\u63A5\u53D7",
+    gateStageLabel: "\u7B26\u5B9D\u90CE",
+    /** Gate summon binds --source-run and keeps dialogue off the argv. */
+    gateSummon: "source-run",
+    /** Navigator subject is the source-run locator, not the path file bytes. */
+    navigatorSubject: "source-run",
+    activationFlags: [
+      { field: "sourceRun", from: "sourceRunPath", flag: "ak-notary-source-run", binds: "input" },
+      { field: "ticketNumber", flag: "ak-notary-ticket-number" }
+    ],
     activationStage: "load-and-install",
     sessionMaterials: NOTARY_SESSION_MATERIALS
   },
   {
     role: "countersign",
+    inCallAutoResume: false,
+    presentSettled: "always",
+    summonResume: false,
+    admission: "court-materials",
+    /** Durable custom entry names this officer. */
+    durableOfficerEntry: true,
+    sameParent: "none",
     phases: [null],
     outputTool: COUNTERSIGN_OUTPUT_TOOL_NAME,
-    inputFlag: void 0,
-    phaseFlag: void 0,
+    settlement: "accepted",
+    acceptedText: "\u7ED9\u4E8B\u4E2D\u56DE\u6267\u5DF2\u63A5\u53D7",
+    gateStageLabel: "\u7ED9\u4E8B\u4E2D",
+    /** Gate queue reads countersignStatus, not the shared three-state status. */
+    gateDecision: "countersign-status",
+    /** Gate summon carries the parent payload as the instruction and a parent run id. */
+    gateSummon: "parent-instruction",
+    activationFlags: [
+      { field: "ticketNumber" }
+    ],
     activationStage: "load-and-install",
+    receiptStatusKey: "countersignStatus",
     // #924: 公用《票面法》三席同装
     sessionMaterials: ["CLAUDE.md", "souls/countersign.md", "souls/ticket-law.md"]
   },
   {
     role: "secretariat",
+    inCallAutoResume: false,
+    presentSettled: "always",
+    summonResume: false,
+    admission: "instruction",
+    sameParent: "court-diarist",
     phases: [null],
     outputTool: SECRETARIAT_OUTPUT_TOOL_NAME,
-    inputFlag: void 0,
-    phaseFlag: void 0,
+    settlement: "accepted",
+    /** Project the durable 给事中 officer entry onto the shared accepted-tool settlement. */
+    projectCountersignTerminal: true,
+    acceptedText: "\u4E2D\u4E66\u7701\u56DE\u6267\u5DF2\u63A5\u53D7",
+    activationFlags: [
+      { field: "ticketNumber" }
+    ],
     activationStage: "load-and-install",
+    receiptStatusKey: "secretariatStatus",
     // #924: owner-finalized Soul + 票面法 + 给事中/符宝郎行为指南
     sessionMaterials: [
       "CLAUDE.md",
@@ -161,11 +390,23 @@ const PUBLIC_ROLE_RECORDS = [
   },
   {
     role: "gleaner-left",
+    inCallAutoResume: false,
+    presentSettled: "always",
+    summonResume: false,
+    admission: "gleaner",
+    /** Public argv keeps the instruction and drops attachment paths. */
+    argvResult: "instruction",
+    sameParent: "none",
     phases: [null],
     bareCommand: false,
     outputTool: GLEANER_LEFT_OUTPUT_TOOL_NAME,
-    inputFlag: void 0,
-    phaseFlag: void 0,
+    settlement: "accepted",
+    /** Bound comparison base is the initial prompt; instruction follows. */
+    transportPrompt: "baseline",
+    acceptedText: "\u5DE6\u62FE\u9057\u56DE\u6267\u5DF2\u63A5\u53D7",
+    activationFlags: [
+      { field: "baseRevision", flag: "ak-gleaner-left-base" }
+    ],
     activationStage: "load-and-install",
     sessionMaterials: [
       "CLAUDE.md",
@@ -175,10 +416,35 @@ const PUBLIC_ROLE_RECORDS = [
   },
   {
     role: "inspector",
+    inCallAutoResume: false,
+    presentSettled: "always",
+    summonResume: false,
+    admission: "instruction",
+    sameParent: "gate-pointer",
+    /** Resume restores an optional source-run path onto the admitted face. */
+    resumeSourcePath: true,
+    /** Infrastructure failure at this stage has no accepted gate cycle to project. */
+    skipGateOnInfrastructureStage: true,
+    /** 台院 is a review officer and inherits the gatekeeper model. */
+    reviewOfficer: true,
+    provinceConfig: true,
+    modelInheritsFrom: "gatekeeper",
     phases: [null],
     outputTool: INSPECTOR_OUTPUT_TOOL_NAME,
-    inputFlag: "ak-inspector-source-run",
-    phaseFlag: void 0,
+    settlement: "accepted",
+    /** Court reask replaces the initial prompt. */
+    reaskPrompt: true,
+    acceptedText: "\u53F0\u9662\u56DE\u6267\u5DF2\u63A5\u53D7",
+    gateStageLabel: "\u53F0\u9662",
+    activationFlags: [
+      {
+        field: "sourceRun",
+        from: "sourceRunPath",
+        fallback: "gate-pointer",
+        flag: "ak-inspector-source-run",
+        binds: "input"
+      }
+    ],
     activationStage: "load-and-install",
     sessionMaterials: INSPECTOR_SESSION_MATERIALS
   },
@@ -187,30 +453,63 @@ const PUBLIC_ROLE_RECORDS = [
   // unchanged and orthogonal to callability.
   {
     role: "gatekeeper",
+    inCallAutoResume: false,
+    presentSettled: "always",
+    summonResume: true,
+    admission: "instruction",
+    /** Infrastructure failure at this stage has no accepted gate cycle to project. */
+    skipGateOnInfrastructureStage: true,
+    sameParent: "none",
+    /** Province model root. Officers name this seat via modelInheritsFrom. */
+    provinceConfig: true,
     phases: [null],
     outputTool: GATEKEEPER_OUTPUT_TOOL_NAME,
-    inputFlag: void 0,
-    phaseFlag: void 0,
+    settlement: "accepted",
+    runnerFailure: "engine-detour-record-first",
+    acceptedText: "\u95E8\u4E0B\u7701\u51B3\u8BAE\u5DF2\u53D7\u7406",
     activationStage: "load-and-install",
     // Province materials; officers reuse their own public records below.
     sessionMaterials: ["CLAUDE.md", "souls/gatekeeper.md", "souls/quality-law.md", "souls/gate-output-guide.md"]
   },
   {
     role: "navigator",
+    inCallAutoResume: false,
+    presentSettled: "always",
+    summonResume: true,
+    admission: "instruction",
+    sameParent: "none",
     phases: [null],
     outputTool: NAVIGATOR_OUTPUT_TOOL_NAME,
-    inputFlag: void 0,
-    phaseFlag: void 0,
+    settlement: "accepted",
+    runnerFailure: "engine-detour-record-first",
+    acceptedText: "\u6E38\u5955\u4F7F\u5EFA\u8BAE\u5DF2\u53D7\u7406",
     activationStage: "load-and-install",
     sessionMaterials: ["CLAUDE.md", "souls/navigator.md"]
   },
   // #675: 审刑院 is a role like any other — public ak-role entry. (#744: evidence-child deleted)
   {
     role: "auditor",
+    inCallAutoResume: false,
+    presentSettled: "always",
+    summonResume: true,
+    admission: "instruction",
+    sameParent: "subject-source",
+    /** --subject chooses which audited seat the soul comes from. */
+    subjectChoices: ["judge", "doctor"],
+    /** 审刑院 is a review officer. Model stays on its own seat row. */
+    reviewOfficer: true,
+    /** Subject input selects the soul. The public materials list is the ship roster. */
+    soulSource: "subject",
     phases: [null],
     outputTool: AUDITOR_OUTPUT_TOOL_NAME,
-    inputFlag: void 0,
-    phaseFlag: void 0,
+    settlement: "accepted",
+    /** Court reask replaces the initial prompt. */
+    reaskPrompt: true,
+    runnerFailure: "engine-detour-record-first",
+    acceptedText: "\u5BA1\u5211\u9662\u56DE\u6267\u5DF2\u63A5\u53D7",
+    gateStageLabel: "\u5BA1\u5211\u9662",
+    /** Gate summon binds --subject judge and --source-run. */
+    gateSummon: "subject-source",
     activationStage: "load-and-install",
     sessionMaterials: AUDITOR_PUBLIC_SESSION_MATERIALS
   },
@@ -218,10 +517,15 @@ const PUBLIC_ROLE_RECORDS = [
   // No input flag — LLM finds materials itself (caller-transparent).
   {
     role: "diarist",
+    inCallAutoResume: false,
+    presentSettled: "always",
+    summonResume: false,
+    admission: "instruction",
+    sameParent: "board-ticket",
     phases: [null],
     outputTool: DIARIST_OUTPUT_TOOL_NAME,
-    inputFlag: void 0,
-    phaseFlag: void 0,
+    settlement: "accepted",
+    acceptedText: "\u8D77\u5C45\u90CE\u56DE\u6267\u5DF2\u63A5\u53D7",
     activationStage: "load-and-install",
     sessionMaterials: [
       "CLAUDE.md",
@@ -234,23 +538,201 @@ const PACKAGED_ROLE_REGISTRY = PUBLIC_ROLE_RECORDS.map(({ sessionMaterials: _omi
 function packagedRoleMetadata(role) {
   return PACKAGED_ROLE_REGISTRY.find((entry) => entry.role === role);
 }
+function isOfficerReviewSeat(role) {
+  const record = packagedRoleMetadata(role);
+  return record !== void 0 && "reviewOfficer" in record && record.reviewOfficer === true;
+}
+function packagedProvinceConfig(role) {
+  const record = packagedRoleMetadata(role);
+  return record !== void 0 && "provinceConfig" in record && record.provinceConfig === true;
+}
+function packagedModelParent(role) {
+  const record = packagedRoleMetadata(role);
+  if (record === void 0 || !("modelInheritsFrom" in record)) return void 0;
+  return record.modelInheritsFrom;
+}
+function packagedRoleAcceptedOutputTool(role) {
+  const record = packagedRoleMetadata(role);
+  if (record === void 0 || !("settlement" in record) || record.settlement !== "accepted") {
+    return void 0;
+  }
+  return record.outputTool;
+}
+function packagedRoleActivationFlags(role) {
+  const record = packagedRoleMetadata(role);
+  if (record === void 0 || !("activationFlags" in record)) return [];
+  return record.activationFlags;
+}
 function packagedRoleInputFlag(role) {
-  return packagedRoleMetadata(role)?.inputFlag;
+  return packagedRoleActivationFlags(role).find((spec) => spec.binds === "input")?.flag;
 }
 function packagedRolePhaseFlag(role) {
-  return packagedRoleMetadata(role)?.phaseFlag;
+  return packagedRoleActivationFlags(role).find((spec) => spec.binds === "phase")?.flag;
 }
 function packagedRoleOutputTool(role) {
   return packagedRoleMetadata(role)?.outputTool;
 }
+function packagedRoleAcceptedText(role) {
+  const record = packagedRoleMetadata(role);
+  if (record === void 0) {
+    throw new Error(`Unsupported workflow role: ${String(role)}`);
+  }
+  return record.acceptedText;
+}
+function packagedMethodLoadFailureCause(role) {
+  const record = packagedRoleMetadata(role);
+  if (record === void 0 || !("methodLoadFailureCause" in record)) return void 0;
+  return record.methodLoadFailureCause;
+}
+function packagedBindsBoardTicket(role) {
+  const record = packagedRoleMetadata(role);
+  return record?.sameParent === "board-ticket";
+}
+function packagedRebindSourceOnResume(role) {
+  return packagedRoleMetadata(role)?.admission === "source-locator";
+}
+function packagedAdmitsCountersign(role) {
+  return packagedRoleMetadata(role)?.admission === "court-materials";
+}
+function packagedBareToken(role) {
+  const record = packagedRoleMetadata(role);
+  if (record === void 0 || !("bareToken" in record)) return void 0;
+  return record.bareToken;
+}
+function packagedArgvResult(role) {
+  const record = packagedRoleMetadata(role);
+  if (record !== void 0 && "argvResult" in record) return record.argvResult;
+  return "material";
+}
+function packagedStoresSourceRunRaw(role) {
+  const record = packagedRoleMetadata(role);
+  return record !== void 0 && "sourceRunStored" in record && record.sourceRunStored === "raw";
+}
+function packagedBaseIsRevision(role) {
+  const record = packagedRoleMetadata(role);
+  return record !== void 0 && "baseValue" in record && record.baseValue === "revision";
+}
+function packagedEmitsAuthorityRefs(role) {
+  const record = packagedRoleMetadata(role);
+  return record !== void 0 && "emitAuthorityRefs" in record && record.emitAuthorityRefs === true;
+}
+function packagedSubjectChoices(role) {
+  const record = packagedRoleMetadata(role);
+  if (record === void 0 || !("subjectChoices" in record)) return void 0;
+  return record.subjectChoices;
+}
+function packagedAdmittedSubject(role, value) {
+  const choices = packagedSubjectChoices(role);
+  if (choices === void 0 || !choices.includes(value)) return void 0;
+  const match = choices.find((choice) => choice === value);
+  if (match === "judge" || match === "doctor") return match;
+  return void 0;
+}
+function packagedAuditToolName(role) {
+  const record = packagedRoleMetadata(role);
+  if (record === void 0 || !("auditTool" in record)) return void 0;
+  return record.auditTool;
+}
+function packagedSkipsGateOnInfrastructureStage(stage) {
+  return typeof stage === "string" && PUBLIC_ROLE_RECORDS.some(
+    (record) => "skipGateOnInfrastructureStage" in record && record.skipGateOnInfrastructureStage === true && record.role === stage
+  );
+}
+function packagedDurableOfficerEntry(officer) {
+  return typeof officer === "string" && PUBLIC_ROLE_RECORDS.some(
+    (record) => "durableOfficerEntry" in record && record.durableOfficerEntry === true && record.role === officer
+  );
+}
+function packagedPublicInstructionSubject(role) {
+  return typeof role === "string" && PUBLIC_ROLE_RECORDS.some(
+    (record) => "navigatorSubject" in record && record.navigatorSubject === "public-instruction" && record.role === role
+  );
+}
+function packagedResumeSourcePath(role) {
+  const record = packagedRoleMetadata(role);
+  return record !== void 0 && "resumeSourcePath" in record && record.resumeSourcePath === true;
+}
+function packagedProjectsTargetBindRejection(role) {
+  const record = packagedRoleMetadata(role);
+  return record !== void 0 && "projectTargetBindRejection" in record && record.projectTargetBindRejection === true;
+}
+function packagedNavigatorSubject(role) {
+  const record = packagedRoleMetadata(role);
+  if (record !== void 0 && "navigatorSubject" in record) return record.navigatorSubject;
+  return "file";
+}
+function packagedBoardPlacement(role) {
+  const record = packagedRoleMetadata(role);
+  if (record === void 0 || !("boardPlacement" in record)) return void 0;
+  return record.boardPlacement;
+}
+function packagedAnalystTerminal(role) {
+  const record = packagedRoleMetadata(role);
+  if (record === void 0 || !("analystTerminal" in record)) return void 0;
+  return record.analystTerminal;
+}
+function packagedRoleSessionMaterials(role) {
+  return PUBLIC_ROLE_RECORDS.find((entry) => entry.role === role)?.sessionMaterials;
+}
+function isNavigatorSeat(role) {
+  return packagedRoleOutputTool(role) === NAVIGATOR_OUTPUT_TOOL_NAME;
+}
+function packagedGateStageLabel(role) {
+  const record = packagedRoleMetadata(role);
+  if (record === void 0 || !("gateStageLabel" in record)) return void 0;
+  return record.gateStageLabel;
+}
+function packagedGateSummon(role) {
+  const record = packagedRoleMetadata(role);
+  if (record !== void 0 && "gateSummon" in record) return record.gateSummon;
+  return "pointer";
+}
+function packagedGateDecision(role) {
+  const record = packagedRoleMetadata(role);
+  if (record !== void 0 && "gateDecision" in record && record.gateDecision === "countersign-status") {
+    return "countersign-status";
+  }
+  return "three-state";
+}
 export {
   AUDITOR_PUBLIC_SESSION_MATERIALS,
   INSPECTOR_SESSION_MATERIALS,
   NOTARY_SESSION_MATERIALS,
   PACKAGED_ROLE_REGISTRY,
   PUBLIC_ROLE_RECORDS,
+  isNavigatorSeat,
+  isOfficerReviewSeat,
+  packagedAdmitsCountersign,
+  packagedAdmittedSubject,
+  packagedAnalystTerminal,
+  packagedArgvResult,
+  packagedAuditToolName,
+  packagedBareToken,
+  packagedBaseIsRevision,
+  packagedBindsBoardTicket,
+  packagedBoardPlacement,
+  packagedDurableOfficerEntry,
+  packagedEmitsAuthorityRefs,
+  packagedGateDecision,
+  packagedGateStageLabel,
+  packagedGateSummon,
+  packagedMethodLoadFailureCause,
+  packagedModelParent,
+  packagedNavigatorSubject,
+  packagedProjectsTargetBindRejection,
+  packagedProvinceConfig,
+  packagedPublicInstructionSubject,
+  packagedRebindSourceOnResume,
+  packagedResumeSourcePath,
+  packagedRoleAcceptedOutputTool,
+  packagedRoleAcceptedText,
+  packagedRoleActivationFlags,
   packagedRoleInputFlag,
   packagedRoleMetadata,
   packagedRoleOutputTool,
-  packagedRolePhaseFlag
+  packagedRolePhaseFlag,
+  packagedRoleSessionMaterials,
+  packagedSkipsGateOnInfrastructureStage,
+  packagedStoresSourceRunRaw,
+  packagedSubjectChoices
 };