@akagilnc/pi-workflow-roles 0.1.5368 → 0.1.5375

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

@@ -71,6 +71,8 @@ import {
   type ReviewerLens,
 } from "./invocation.ts";
 
+import { isRecord, errorText, isEnoent } from "../unknown-value.ts";
+
 /** Providers eligible for v1 typed-429 resume (Codex / xAI only).
  * @deprecated v1 429-only gate removed by #416 (owner 2026-08-22: "根本不要有限制"). Kept for compatibility; do not use for new branching.
  */
@@ -241,8 +243,8 @@ type RoleRunStateDisk = {
 function parseSameTicketSummonsMaterials(
   raw: unknown,
 ): SameTicketSummonsMaterials | undefined {
-  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return undefined;
-  const record = raw as Record<string, unknown>;
+  if (!isRecord(raw)) return undefined;
+  const record = raw;
   const instruction =
     typeof record.instruction === "string" ? record.instruction : undefined;
   const instructionEmpty =
@@ -256,9 +258,7 @@ function parseSameTicketSummonsMaterials(
       : undefined;
   let sourceRun: NotarySourceRunLocator | undefined;
   if (
-    record.sourceRun !== null &&
-    typeof record.sourceRun === "object" &&
-    !Array.isArray(record.sourceRun)
+    isRecord(record.sourceRun)
   ) {
     const sr = record.sourceRun as Record<string, unknown>;
     if (
@@ -297,8 +297,8 @@ function parseSameTicketSummonsMaterials(
 }
 
 function parseCurrentCourtState(raw: unknown): CurrentCourtState | undefined {
-  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return undefined;
-  const record = raw as Record<string, unknown>;
+  if (!isRecord(raw)) return undefined;
+  const record = raw;
   if (typeof record.courtAttemptId !== "string" || record.courtAttemptId.length === 0) {
     return undefined;
   }
@@ -333,10 +333,10 @@ function parseRoleRunIdentity(raw: unknown, runDirectory: string): {
   readonly runDirectory: string;
   readonly state: RoleRunState;
 } {
-  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+  if (!isRecord(raw)) {
     throw new TypeError("Invalid run-state.json");
   }
-  const record = raw as Record<string, unknown>;
+  const record = raw;
   if (typeof record.runId !== "string" || record.runId.trim() === "") {
     throw new TypeError("Invalid run-state.json");
   }
@@ -390,11 +390,8 @@ async function readRoleRunStateDisk(
   };
   let resumable: TypedHttp429Observation | undefined;
   if (record.resumable !== undefined && record.resumable !== null) {
-    if (
-      typeof record.resumable === "object" &&
-      !Array.isArray(record.resumable)
-    ) {
-      const r = record.resumable as Record<string, unknown>;
+    if (isRecord(record.resumable)) {
+      const r = record.resumable;
       if (
         r.httpStatus === 429 &&
         typeof r.provider === "string" &&
@@ -702,7 +699,6 @@ export type RunWriterLease = {
 /** Kind of a writer-lease diagnostic sent on the existing sink. */
 export type WriterLeaseDiagnosticKind = "stale-reclaimed";
 
-
 /**
  * True error identity for diagnostics — name/code/message as-is, never a
  * guessed label (failure-honesty constitution).
@@ -741,7 +737,6 @@ function isProcessAlive(pid: number): boolean {
   }
 }
 
-
 export type WriterLockAutopsy =
   | { verdict: "absent" }
   | { verdict: "unknown"; reason: "unparseable"; content: string }
@@ -1072,10 +1067,10 @@ export async function readRunParentPath(
     if (errorCodeOf(error) === "ENOENT") return undefined;
     throw error;
   }
-  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+  if (!isRecord(raw)) {
     return undefined;
   }
-  const record = raw as Record<string, unknown>;
+  const record = raw;
   if (typeof record.sourceRunPath === "string" && record.sourceRunPath.trim() !== "") {
     return record.sourceRunPath;
   }
@@ -1280,7 +1275,7 @@ async function loadResumableRunRecord(
     const raw: unknown = JSON.parse(
       await readFile(run.admittedRequestPath, "utf8"),
     );
-    if (raw !== null && typeof raw === "object" && !Array.isArray(raw)) {
+    if (isRecord(raw)) {
       const record = raw as Record<string, unknown>;
       const storedRunDirectory =
         typeof record.runDirectory === "string" && record.runDirectory.trim() !== ""
@@ -1353,9 +1348,7 @@ async function loadResumableRunRecord(
         caseRunsPath = record.caseRunsPath;
       }
       if (
-        record.caseIdentity !== null &&
-        typeof record.caseIdentity === "object" &&
-        !Array.isArray(record.caseIdentity)
+        isRecord(record.caseIdentity)
       ) {
         const ci = record.caseIdentity as Record<string, unknown>;
         if (
@@ -1373,9 +1366,7 @@ async function loadResumableRunRecord(
         sourceRunPath = record.sourceRunPath;
       }
       if (
-        record.sourceRun !== null &&
-        typeof record.sourceRun === "object" &&
-        !Array.isArray(record.sourceRun)
+        isRecord(record.sourceRun)
       ) {
         const sr = record.sourceRun as Record<string, unknown>;
         if (
@@ -1413,9 +1404,7 @@ async function loadResumableRunRecord(
         mergerInputPath = record.mergerInputPath;
       }
       if (
-        record.derived !== null &&
-        typeof record.derived === "object" &&
-        !Array.isArray(record.derived)
+        isRecord(record.derived)
       ) {
         const d = record.derived as Record<string, unknown>;
         if (
@@ -1452,9 +1441,7 @@ async function loadResumableRunRecord(
       await readFile(join(run.runDirectory, "invocation.json"), "utf8"),
     );
     if (
-      invocationRaw !== null &&
-      typeof invocationRaw === "object" &&
-      !Array.isArray(invocationRaw)
+      isRecord(invocationRaw)
     ) {
       const rec = invocationRaw as Record<string, unknown>;
       if (typeof rec.provider === "string" && typeof rec.model === "string") {
@@ -1478,13 +1465,7 @@ async function loadResumableRunRecord(
     ) {
       throw error;
     }
-    if (
-      !(
-        error instanceof Error &&
-        "code" in error &&
-        (error as { code?: unknown }).code === "ENOENT"
-      )
-    ) {
+    if (!isEnoent(error)) {
       throw new CliUsageError(
         `role run invocation identity is unreadable: ${runId}`,
         { cause: error },
@@ -1583,7 +1564,6 @@ function seatLoadedResult<R extends AdmittedRoleInvocation>(
   };
 }
 
-
 export async function peekRoleRunRole(
   home: string,
   runId: string,
@@ -1594,7 +1574,6 @@ export async function peekRoleRunRole(
   return run?.role;
 }
 
-
 export type LoadedResumablePublicRole = {
   readonly admitted: AdmittedRoleInvocation;
   readonly run: RoleRunRecord;
@@ -1793,7 +1772,7 @@ function admitResumedRole(loaded: {
       try {
         parsedRepository = parseCollectorRepository(repositoryDisplay);
       } catch (error) {
-        const detail = error instanceof Error ? error.message : String(error);
+        const detail = errorText(error);
         throw new CliUsageError(detail, { cause: error });
       }
       if (parsedRepository.canonical !== repository) {

package/src/public-cli/settlement.ts

@@ -346,6 +346,8 @@ import {
   type TerminalRoleOutcome,
 } from "./terminal.ts";
 
+import { isEnoent, isMissingPathError, isRecord } from "../unknown-value.ts";
+
 export type { ControlledFailureCause };
 
 export {
@@ -467,7 +469,7 @@ export async function inspectJudgeSession(
     await readFile(sessionFile, "utf8");
     return { state: "present" };
   } catch (error) {
-    if (isMissingPathError(error)) return { state: "missing" };
+    if (isEnoent(error)) return { state: "missing" };
     return {
       state: "unreadable",
       diagnostic:
@@ -834,24 +836,6 @@ type SessionEntry = {
   parentSession?: string;
 };
 
-function isMissingPathError(error: unknown): boolean {
-  return (
-    error instanceof Error &&
-    "code" in error &&
-    (error as { code?: unknown }).code === "ENOENT"
-  );
-}
-
-/** Face clear only: path not enterable as a face (ENOENT or file mid-path). */
-function isAbsentFacePathError(error: unknown): boolean {
-  return (
-    error instanceof Error &&
-    "code" in error &&
-    ((error as { code?: unknown }).code === "ENOENT" ||
-      (error as { code?: unknown }).code === "ENOTDIR")
-  );
-}
-
 /**
  * Preserve session-read failure identity as a typed session cause.
  * SyntaxError keeps its name so durable settlement does not wash malformed JSONL
@@ -1064,7 +1048,7 @@ async function loadBoundAuditorVolumes(
   try {
     parentEntries = await readBoundSessionEntries(sessionFile);
   } catch (error) {
-    if (isMissingPathError(error)) return undefined;
+    if (isEnoent(error)) return undefined;
     throw sessionReadFailure(error, "failed to read parent session for auditor binding");
   }
   const parentId = parentEntries.find((entry) => entry.type === "session")?.id;
@@ -1078,7 +1062,7 @@ async function loadBoundAuditorVolumes(
       names = await readdir(childDirectory);
       sawAnyDirectory = true;
     } catch (error) {
-      if (isMissingPathError(error)) continue;
+      if (isEnoent(error)) continue;
       throw sessionReadFailure(error, "failed to read bound auditor session directory");
     }
     for (const file of names.filter((name) => name.endsWith(".jsonl")).sort().reverse()) {
@@ -1313,7 +1297,7 @@ export async function resolveAuditedRunnerFailureResolution(input: {
     );
     if (terminatingFailure !== undefined) return resolutionOf(terminatingFailure);
   } catch (error) {
-    if (!isMissingPathError(error)) {
+    if (!isEnoent(error)) {
       const failure = sessionReadFailure(error, "failed to recover typed terminating-tool failure");
       return resolutionOf({
         cause: "session",
@@ -1459,10 +1443,6 @@ export function controlledFailureInputFromResolution(
   };
 }
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
 function safelyRead(object: object, key: string): { readable: true; value: unknown } | { readable: false } {
   try {
     return { readable: true, value: (object as Record<string, unknown>)[key] };
@@ -1478,9 +1458,7 @@ function toolResultText(message: SessionMessage): string {
   return content
     .map((part) => {
       if (
-        typeof part === "object" &&
-        part !== null &&
-        !Array.isArray(part) &&
+        isRecord(part) &&
         typeof (part as { text?: unknown }).text === "string"
       ) {
         return (part as { text: string }).text;
@@ -2234,7 +2212,7 @@ async function extractNavigatorFactFromAdmittedSession(
     const entries = await readBoundSessionEntries(sessionFile);
     return extractNavigatorFact(entries);
   } catch (error) {
-    if (isMissingPathError(error)) {
+    if (isEnoent(error)) {
       return {
         disposition: "unavailable",
         source: "unknown",
@@ -2261,7 +2239,7 @@ async function removeFaceIfPresent(path: string): Promise<void> {
     // force:true already ignores ENOENT; ENOTDIR = face path not enterable
     // (artifacts-as-file mid-path) — same absent-face semantics as the reader.
     // Other errno stay loud (失败诚实).
-    if (isAbsentFacePathError(error)) return;
+    if (isMissingPathError(error)) return;
     throw error;
   }
 }
@@ -2392,7 +2370,7 @@ async function readLawfulSettlementEntries(
     return await readBoundSessionEntries(sessionFile);
   } catch (error) {
     // Missing path is absence of a lawful outcome; callers classify via session inspect.
-    if (isMissingPathError(error)) return undefined;
+    if (isEnoent(error)) return undefined;
     // Malformed JSONL and other read failures keep typed session identity.
     throw error instanceof Error &&
       (error as { knownCause?: unknown }).knownCause === "session"
@@ -2839,7 +2817,7 @@ function countersignTerminalFromEntries(
     if (entry?.type !== "custom") continue;
     if (entry.customType !== SECRETARIAT_GATE_OFFICER_ENTRY_TYPE) continue;
     const data =
-      entry.data !== null && typeof entry.data === "object" && !Array.isArray(entry.data)
+      isRecord(entry.data)
         ? (entry.data as Record<string, unknown>)
         : undefined;
     if (data === undefined || !packagedDurableOfficerEntry(data.officer)) continue;

package/src/public-role-summons.ts

@@ -26,10 +26,11 @@ import type {
 import type { TerminalResult } from "./public-cli/terminal.ts";
 import type { HostSelectionFailure, NamedRoleTurnHostAdapter } from "./public-cli/role-turn-host-resolution.ts";
 
+import { isRecord, errorText } from "./unknown-value.ts";
+
 /** Env published by the parent activation so nested summons never re-derive root. */
 export const AK_ROLE_PACKAGE_ROOT_ENV = "AK_ROLE_PACKAGE_ROOT" as const;
 
-
 export type PublicSummonRole =
   | "inspector"
   | "notary"
@@ -591,7 +592,7 @@ export async function summonParallelReviewerLenses(options: {
     if (error instanceof AggregateError) {
       return [error.message, ...error.errors.map(describeFailure)].join("\n");
     }
-    return error instanceof Error ? error.message : String(error);
+    return errorText(error);
   };
   const failedResult = (error: unknown): PublicSummonResult => ({
     exitCode: 1,
@@ -839,7 +840,7 @@ export async function summonGateOfficer(options: {
     const correlationId = parentRunId;
     const { isSafePositiveTicketNumber, readBoardTicketNumber } = await import("./run-ticket-number.ts");
     const parentTicket = await readBoardTicketNumber(options.sourceRunDirectory);
-    const submittedTicket = options.submission !== null && typeof options.submission === "object" && !Array.isArray(options.submission)
+    const submittedTicket = isRecord(options.submission)
       ? (options.submission as { ticketNumber?: unknown }).ticketNumber
       : undefined;
     const courtTicket = isSafePositiveTicketNumber(submittedTicket) ? submittedTicket : parentTicket;

package/src/receipt-delivery-policy.ts

@@ -1,3 +1,4 @@
+import { isRecord } from "./unknown-value.ts";
 /** Shared accepted-receipt delivery budget for role, auditor, and Navigator sessions (#288). */
 export const RECEIPT_DELIVERY_TURN_LIMIT = 2 as const;
 
@@ -14,10 +15,6 @@ export type NoReceiptLifecycleFacts = {
   acceptedReceipt: false;
 };
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
 /** Read only the facts required by Terminal consumers; persisted extensions are ignored. */
 export function parseNoReceiptLifecycleFacts(input: unknown): NoReceiptLifecycleFacts {
   if (!isRecord(input)

package/src/reviewer-role.ts

@@ -41,7 +41,6 @@ export type ReviewerRoleDependencies = {
 };
 export type ReviewerRoleHostActions = { failInfrastructure(error: unknown, ctx: HostContext, toolCallId?: string): never };
 
-
 export type ReviewerActivation = Readonly<{
   fixedBaseRevision: string;
   soul: string;

package/src/role-envelope.ts

@@ -35,6 +35,8 @@ import {
 } from "./navigator-invocation-identity.ts";
 import { serializeThrownValue } from "./serialize-thrown-value.ts";
 
+import { isRecord, errorText } from "./unknown-value.ts";
+
 export { projectActivationFlags };
 
 type Handler = HostEventRegistration[1];
@@ -158,7 +160,7 @@ export async function prepareRoleEnvelope(options: {
       try {
         await appendFile(sessionFile, line, "utf8");
       } catch (error) {
-        const diagnostic = error instanceof Error ? error.message : String(error);
+        const diagnostic = errorText(error);
         armDurableWriteFailure?.(customType, diagnostic);
       }
     });
@@ -291,7 +293,7 @@ export async function prepareRoleEnvelope(options: {
     content: ContentPart[],
   ): void {
     if (infrastructureRoundFailure !== undefined) return;
-    const record = typeof details === "object" && details !== null && !Array.isArray(details)
+    const record = isRecord(details)
       ? details as Record<string, unknown>
       : undefined;
     const isInfra = record !== undefined && (
@@ -336,7 +338,7 @@ export async function prepareRoleEnvelope(options: {
     content: ContentPart[];
     details: Record<string, unknown>;
   } {
-    const diagnostic = error instanceof Error ? error.message : String(error);
+    const diagnostic = errorText(error);
     const content: ContentPart[] = [{ type: "text", text: diagnostic }];
     const errorCode = typeof (error as unknown as { code?: unknown })?.code === "string"
       ? (error as unknown as { code: string }).code

package/src/role-run-placement.ts

@@ -7,6 +7,8 @@ import {
 } from "./activation-ledger-topology.ts";
 import { requireSafePositiveTicketNumber } from "./run-ticket-number.ts";
 
+import { isEnoent } from "./unknown-value.ts";
+
 export type RoleRunSubject =
   | { readonly ticketNumber: number }
   | { readonly unbound: true };
@@ -19,14 +21,6 @@ export type RoleRunPlacement = {
   readonly attachmentsDirectory: string;
 };
 
-function isMissingPathError(error: unknown): boolean {
-  return (
-    error instanceof Error &&
-    "code" in error &&
-    (error as NodeJS.ErrnoException).code === "ENOENT"
-  );
-}
-
 /**
  * Sole book-level run directory walk: flat legacy `runs/` plus each
  * `subject/runs/` child (ticket / unbound). One authority for read-side
@@ -42,7 +36,7 @@ export async function listBookRunDirectories(bookDir: string): Promise<string[]>
     try {
       entries = await readdir(runsDir, { withFileTypes: true });
     } catch (error) {
-      if (isMissingPathError(error)) return;
+      if (isEnoent(error)) return;
       throw error;
     }
     for (const entry of entries) {
@@ -60,7 +54,7 @@ export async function listBookRunDirectories(bookDir: string): Promise<string[]>
   try {
     subjects = await readdir(bookDir, { withFileTypes: true });
   } catch (error) {
-    if (isMissingPathError(error)) return out.sort();
+    if (isEnoent(error)) return out.sort();
     throw error;
   }
   for (const subject of subjects) {

package/src/role-run-relocation.ts

@@ -12,6 +12,8 @@ import { join, sep } from "node:path";
 
 import { AUDITOR_PARENT_ATTEMPT_BINDING_ENTRY_TYPE } from "./compliance-transport.ts";
 
+import { isRecord, isEnoent } from "./unknown-value.ts";
+
 const ADMITTED_PAGE_FIELDS = [
   "runDirectory",
   "admittedRequestPath",
@@ -50,14 +52,6 @@ export type RunDirectoryPathRewrite = {
   readonly newRunDirectory: string;
 };
 
-function isEnoent(error: unknown): boolean {
-  return (
-    error instanceof Error &&
-    "code" in error &&
-    (error as NodeJS.ErrnoException).code === "ENOENT"
-  );
-}
-
 /** Rewrite one path value that points at or under oldRunDirectory. */
 export function rewriteRunDirectoryPathValue(
   value: unknown,
@@ -158,16 +152,12 @@ function collectRewrites(input: {
   return out;
 }
 
-function isPlainObject(value: unknown): value is Record<string, unknown> {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
 /** Typed notary/source-run locator: only runDirectory is a path. */
 function rewriteSourceRunLocator(
   value: unknown,
   rewrites: readonly RunDirectoryPathRewrite[],
 ): void {
-  if (!isPlainObject(value)) return;
+  if (!isRecord(value)) return;
   rewriteRunDirectoryPathFieldsAgainstRewrites(
     value,
     SOURCE_RUN_LOCATOR_FIELDS,
@@ -180,7 +170,7 @@ function rewriteSummonsMaterials(
   value: unknown,
   rewrites: readonly RunDirectoryPathRewrite[],
 ): void {
-  if (!isPlainObject(value)) return;
+  if (!isRecord(value)) return;
   rewriteRunDirectoryPathFieldsAgainstRewrites(
     value,
     SUMMONS_PATH_FIELDS,
@@ -204,12 +194,12 @@ export function rewriteAdmittedRoleRunPage(
   rewriteSourceRunLocator(page.sourceRun, rewrites);
   if (Array.isArray(page.attachments)) {
     for (const attachment of page.attachments) {
-      if (isPlainObject(attachment)) {
+      if (isRecord(attachment)) {
         rewriteRunDirectoryPathFieldsAgainstRewrites(attachment, ["frozenPath"], rewrites);
       }
     }
   }
-  if (isPlainObject(page.principal)) {
+  if (isRecord(page.principal)) {
     rewriteRunDirectoryPathFieldsAgainstRewrites(
       page.principal,
       ["sessionDirectory", "sessionFile"],
@@ -224,7 +214,7 @@ async function rewriteOfficerPointerFile(
 ): Promise<void> {
   if (!existsSync(path)) return;
   const page = JSON.parse(await readFile(path, "utf8")) as unknown;
-  if (!isPlainObject(page)) return;
+  if (!isRecord(page)) return;
   // Only the typed direct-officer pointer shape — never arbitrary .pointer.json.
   if (page.kind !== "direct-officer-run-pointer") return;
   const before = JSON.stringify(page);
@@ -267,7 +257,7 @@ async function rewriteSitianRecordsJsonl(
       out.push(line);
       continue;
     }
-    if (!isPlainObject(parsed)) {
+    if (!isRecord(parsed)) {
       out.push(line);
       continue;
     }
@@ -325,7 +315,7 @@ async function rewriteSessionTranscriptBindings(
       out.push(line);
       continue;
     }
-    if (!isPlainObject(parsed)) {
+    if (!isRecord(parsed)) {
       out.push(line);
       continue;
     }
@@ -341,8 +331,8 @@ async function rewriteSessionTranscriptBindings(
     } else if (
       parsed.type === "custom" &&
       parsed.customType === AUDITOR_PARENT_ATTEMPT_BINDING_ENTRY_TYPE &&
-      isPlainObject(parsed.data) &&
-      isPlainObject(parsed.data.parent)
+      isRecord(parsed.data) &&
+      isRecord(parsed.data.parent)
     ) {
       const parent = parsed.data.parent;
       const before = parent.sessionFile;
@@ -454,7 +444,7 @@ export async function rewriteRoleRunDurablePages(input: {
       RUN_STATE_PAGE_FIELDS,
       rewrites,
     );
-    if (isPlainObject(page.principal)) {
+    if (isRecord(page.principal)) {
       rewriteRunDirectoryPathFieldsAgainstRewrites(
         page.principal,
         ["sessionDirectory", "sessionFile"],
@@ -462,7 +452,7 @@ export async function rewriteRoleRunDurablePages(input: {
       );
     }
     // Open court summons: source-run locators + frozen attachment path pointers.
-    if (isPlainObject(page.currentCourt)) {
+    if (isRecord(page.currentCourt)) {
       rewriteSummonsMaterials(page.currentCourt.summons, rewrites);
     }
     if (JSON.stringify(page) !== before) {

package/src/role-runtime.ts

@@ -188,7 +188,7 @@ function decodeReviewerAdmittedInputs(getFlag: (name: string) => unknown): Revie
       parsed = JSON.parse(rawAuthorityRefs);
     } catch (error) {
       throw new Error(
-        `Reviewer authority refs transport error: JSON decode failed: ${error instanceof Error ? error.message : String(error)}`,
+        `Reviewer authority refs transport error: JSON decode failed: ${errorText(error)}`,
       );
     }
     if (!Array.isArray(parsed) || parsed.some((ref) => typeof ref !== "string")) {
@@ -297,6 +297,8 @@ export type { GatekeeperResult, GatekeeperSubject, SubmissionGateNonPassResult,
 import { ParentQueueReaskError, unreadableDiscriminatorNotice } from "./submission-errors.ts";
 import { REVIEW_QUEUE_STATUSES } from "./review-submission.ts";
 
+import { isRecord, errorText, isEnoent } from "./unknown-value.ts";
+
 export {
   DOCTOR_EVIDENCE_TOOL_NAME,
   DOCTOR_OUTPUT_TOOL_NAME,
@@ -507,7 +509,7 @@ export function publicNavigatorSettlement(role: string, phase: NavigatorPhase, e
     return { kind: "role_infrastructure_failure", role, phase };
   }
   // accepted/human — project role/phase status; classifier already rejected infra/contradiction.
-  const details = typeof event.details === "object" && event.details !== null && !Array.isArray(event.details)
+  const details = isRecord(event.details)
     ? event.details as Record<string, unknown>
     : {};
   const status = typeof details.status === "string"
@@ -710,7 +712,7 @@ export function createNavigatorRoleRuntime(
           dependencies.recordRoutePlaybookReadFailure?.(undefined);
           if (content.trim() !== "") parts.push(content);
         } catch (error) {
-          const message = error instanceof Error ? error.message : String(error);
+          const message = errorText(error);
           if (message.trim() !== "") {
             dependencies.recordRoutePlaybookReadFailure?.(message);
             parts.push(message);
@@ -854,7 +856,7 @@ export function createDiaristRoleRuntime(
       soulTag: "diarist",
       beforeAccept: async ({ parameters, ctx }) => {
         const submitted =
-          parameters !== null && typeof parameters === "object" && !Array.isArray(parameters)
+          isRecord(parameters)
             ? (parameters as Record<string, unknown>)
             : undefined;
         // Routing belongs to the public seam after this tool call has returned.
@@ -1073,7 +1075,7 @@ export function createRoleRuntimeExtension(
     ): void => {
       if (attendance === undefined) return;
       const recordDisposeFailure = (error: unknown): void => {
-        const diagnostic = error instanceof Error ? error.message : String(error);
+        const diagnostic = errorText(error);
         try {
           sitianReport({
             level: "event",
@@ -1087,7 +1089,7 @@ export function createRoleRuntimeExtension(
           try {
             envelopeHost.appendEntry?.("ak-navigator-dispose-failure", {
               diagnostic,
-              recordFailure: recordError instanceof Error ? recordError.message : String(recordError),
+              recordFailure: errorText(recordError),
             });
           } catch {
             // Failure already diagnosed; recording must not create unhandled rejection (#959).
@@ -1655,15 +1657,7 @@ export function createRoleRuntimeExtension(
       try {
         await recordTypedProviderHttpStatus(runDir, { httpStatus: status, provider });
       } catch (error) {
-        if (
-          status >= 200 &&
-          status < 300 &&
-          error instanceof Error &&
-          "code" in error &&
-          (error as { code?: unknown }).code === "ENOENT"
-        ) {
-          return;
-        }
+        if (status >= 200 && status < 300 && isEnoent(error)) return;
         failInfrastructure(error, ctx);
       }
     };

package/src/run-terminal-artifacts.ts

@@ -11,6 +11,8 @@ import { basename, dirname, join } from "node:path";
 
 import { roleRunArtifactsDirectory } from "./role-run-placement.ts";
 
+import { isRecord, errorText, isMissingPathError } from "./unknown-value.ts";
+
 export const RUN_TERMINAL_ARTIFACT_FILES = [
   "report.json",
   "error.json",
@@ -49,22 +51,6 @@ export type RunTerminalArtifactRead =
       readonly reason: string;
     };
 
-function isMissingPathError(error: unknown): boolean {
-  return (
-    error instanceof Error
-    && "code" in error
-    && (error.code === "ENOENT" || error.code === "ENOTDIR")
-  );
-}
-
-function errorText(error: unknown): string {
-  return error instanceof Error ? error.message : String(error);
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
 /**
  * Minimum producer-owned face shared by settlement terminal artifacts
  * (report / error / audit-incomplete). Consumer-driven: enough to identify a