@akagilnc/pi-workflow-roles 0.1.5365 → 0.1.5375

package/src/activation-ledger-topology.ts

@@ -7,6 +7,10 @@ import {
 import { userInfo } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 
+import { errnoCode, errorText } from "./unknown-value.ts";
+
+export { errnoCode, errorText };
+
 /**
  * Typed activation-ledger path/fs failure. Callers discriminate with instanceof/code;
  * never by parsing message prose. Original filesystem causes are retained.
@@ -128,18 +132,6 @@ export function physicallyContainedIn(root: string, candidate: string): boolean
   return pathContainedIn(physicalPathIdentity(root), physicalPathIdentity(candidate));
 }
 
-export function errnoCode(error: unknown): string | undefined {
-  return error !== null && typeof error === "object" && "code" in error
-    && typeof (error as { code: unknown }).code === "string"
-    ? (error as { code: string }).code
-    : undefined;
-}
-
-export function errorText(error: unknown): string {
-  if (!(error instanceof Error)) return String(error);
-  return error.message;
-}
-
 /**
  * Ensure the configured ledger root is a physical directory identity.
  * lstat before create/realpath: a root symlink is never admitted, even when its

package/src/analyst-entry.ts

@@ -46,6 +46,8 @@ import {
   type AnalystUnreadableRun,
 } from "./analyst-page.ts";
 
+import { isMissingPathError } from "./unknown-value.ts";
+
 /** #338 compute-if-missing failure — issue identity + real cause (CLI → ControlledFailure). */
 export class AnalystIssueComputeError extends Error {
   readonly code = "analyst-issue-compute-failed" as const;
@@ -80,14 +82,6 @@ export class AnalystIssueComputeError extends Error {
   }
 }
 
-function isMissingPathError(error: unknown): boolean {
-  return (
-    error instanceof Error
-    && "code" in error
-    && (error.code === "ENOENT" || error.code === "ENOTDIR")
-  );
-}
-
 /** Issue-mode typed input — book × ticket scope (#399). */
 export type AnalystIssueModeInput = {
   readonly mode: "issue";
@@ -123,7 +117,7 @@ export type AnalystIssueModeInput = {
  * Sole sweep-mode input contract (#298/#329/#337).
  * Schema is the single definition; TS types are derived (no parallel hand shape).
  * projectRoot = string (not nonempty); changedLines optional finite non-negative;
- * 0 remains typed 空缺; no extra keys.
+ * 0 remains typed 空缺. Extra keys are not a reject reason.
  */
 export const analystSweepModeInputSchema = Type.Object(
   {
@@ -137,11 +131,9 @@ export const analystSweepModeInputSchema = Type.Object(
             Type.Number({ minimum: 0, maximum: Number.MAX_VALUE }),
           ),
         },
-        { additionalProperties: false },
       ),
     ),
   },
-  { additionalProperties: false },
 );
 
 /** Sweep-mode typed input — 已并 PR 清单 + LOC → 补算缺页 + 维护全库索引. */

package/src/analyst-gate-cycles-read.ts

@@ -38,6 +38,7 @@ import {
   type LedgerSessionRow,
 } from "./ledger-session-read.ts";
 
+import { isRecord, errorText, isEnoent } from "./unknown-value.ts";
 
 /** One completed gate round: direct officer receipt or historical province/officer pair. */
 /** Honest origin discriminant: direct summons vs historical province dispatch. */
@@ -88,10 +89,6 @@ const OFFICER_ARG_ALIASES: Readonly<Record<string, "inspector" | "notary">> = {
   notary: "notary",
 };
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
 function isParentAttemptBindingRow(row: LedgerSessionRow): boolean {
   return row.type === "custom" && row.customType === AUDITOR_PARENT_ATTEMPT_BINDING_ENTRY_TYPE;
 }
@@ -104,15 +101,6 @@ function intervalRowsForGateCall(
   return intervalRowsAroundAnchor(rows, callRowIndex, isParentAttemptBindingRow).rows;
 }
 
-/** Only true absence (ENOENT). ENOTDIR is damaged topology — must stay loud. */
-function isMissingDirectoryError(error: unknown): boolean {
-  return (
-    error instanceof Error
-    && "code" in error
-    && error.code === "ENOENT"
-  );
-}
-
 function normalizeOfficerArg(raw: unknown): "inspector" | "notary" | undefined {
   if (typeof raw !== "string") return undefined;
   return OFFICER_ARG_ALIASES[raw.trim()];
@@ -438,7 +426,7 @@ async function resolveOfficerSessionFromPointerFile(
     raw = JSON.parse(await readFile(pointerPath, "utf8"));
   } catch (error) {
     throw new Error(
-      `direct officer run pointer unreadable in ${pointerPath}: ${error instanceof Error ? error.message : String(error)}`,
+      `direct officer run pointer unreadable in ${pointerPath}: ${errorText(error)}`,
       { cause: error },
     );
   }
@@ -490,7 +478,7 @@ export async function readAnalystGateCyclesFromAuditorRoles(
         .map((e) => e.name)
         .sort();
     } catch (error) {
-      if (isMissingDirectoryError(error)) continue;
+      if (isEnoent(error)) continue;
       throw error;
     }
     for (const name of names) {

package/src/analyst-index.ts

@@ -20,6 +20,7 @@
  */
 import { open, readFile, unlink } from "node:fs/promises";
 import { dirname, join } from "node:path";
+import { setTimeout as sleep } from "node:timers/promises";
 
 import { writeFileAtomically } from "./atomic-write.ts";
 import {
@@ -28,6 +29,7 @@ import {
   physicalPathIdentity,
 } from "./activation-ledger-topology.ts";
 import { resolveAnalystBookKey } from "./analyst-book-key.ts";
+import { isMissingPathError } from "./unknown-value.ts";
 import type {
   AnalystIssueMetricsPage,
   AnalystOptionalMetricNumber,
@@ -38,12 +40,6 @@ const LIBRARY_INDEX_LOCK_NAME = ".library-index.lock";
 const LIBRARY_INDEX_LOCK_TIMEOUT_MS = 30_000;
 const LIBRARY_INDEX_LOCK_RETRY_MS = 15;
 
-function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => {
-    setTimeout(resolve, ms);
-  });
-}
-
 /**
  * Exclusive create lock for the library-index read→upsert→write critical section.
  * Same-directory sibling of the index file; not a second index and not a daemon.
@@ -270,13 +266,7 @@ export async function readAnalystLibraryIndexPage(
   try {
     raw = await readFile(path, "utf8");
   } catch (error) {
-    if (
-      error instanceof Error
-      && "code" in error
-      && (error.code === "ENOENT" || error.code === "ENOTDIR")
-    ) {
-      return undefined;
-    }
+    if (isMissingPathError(error)) return undefined;
     throw error;
   }
   const parsed: unknown = JSON.parse(raw);

package/src/analyst-ledger.ts

@@ -49,23 +49,9 @@ import {
   type AnalystGateCycleRound,
 } from "./analyst-gate-cycles-read.ts";
 
-export type { AnalystGateCycleRound } from "./analyst-gate-cycles-read.ts";
-
-function isMissingPathError(error: unknown): boolean {
-  return (
-    error instanceof Error
-    && "code" in error
-    && (error.code === "ENOENT" || error.code === "ENOTDIR")
-  );
-}
+import { isRecord, errorText, isMissingPathError } from "./unknown-value.ts";
 
-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);
-}
+export type { AnalystGateCycleRound } from "./analyst-gate-cycles-read.ts";
 
 /** Existing public-cli run-state live phases — not a new state machine. */
 const LIVE_RUN_STATES = new Set(["admitted", "running", "resumable"]);

package/src/analyst-metric-families/acceptance-success-rework.ts

@@ -14,6 +14,8 @@ import { medianNumber } from "../analyst-median.ts";
 import type { AnalystMetricFamilyModule } from "../analyst-metric-family.ts";
 import { packagedAnalystTerminal } from "../packaged-role-registry.ts";
 
+import { isRecord } from "../unknown-value.ts";
+
 const WORKER_ROLES = new Set(["coder", "fixer"]);
 
 /** Lawful acceptance vocabulary by role (PRD 受理终态映射). */
@@ -95,10 +97,6 @@ export type AnalystAcceptanceSuccessReworkSection = {
   readonly rework: AnalystReworkLens;
 };
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
 /** Locate collector groups array: receipt.groups or top-level groups. */
 function findCollectorGroups(body: Record<string, unknown>): unknown {
   if (Array.isArray(body.groups)) return body.groups;

package/src/analyst-metric-families/round-timeline.ts

@@ -17,6 +17,8 @@ import type {
   AnalystUnreadableRun,
 } from "../analyst-page.ts";
 
+import { isRecord } from "../unknown-value.ts";
+
 export type AnalystRoundTimelineTerminal =
   | {
       readonly kind: "receipt";
@@ -66,10 +68,6 @@ export type AnalystRoundTimelineSection = {
   readonly lanes: readonly AnalystRoundTimelineLane[];
 };
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
 function readClassCount(body: Record<string, unknown>): number | undefined {
   if (!isRecord(body.outcome)) return undefined;
   if (!isRecord(body.outcome.decisiveFacts)) return undefined;

package/src/analyst-page.ts

@@ -6,9 +6,9 @@
  * top-level sections via directory discovery — B/C waves add family files
  * without forking the page writer or editing a shared registry list.
  */
-import { createHash } from "node:crypto";
 import { dirname, join } from "node:path";
 
+import { sha256Hex } from "./sha256.ts";
 import { writeFileAtomically } from "./atomic-write.ts";
 import {
   assertLedgerFileInsideHome,
@@ -161,7 +161,7 @@ export function analystIssuePageKey(address: AnalystIssuePageAddress): string {
   } else if (address.scopeRootIdentity !== undefined) {
     parts.push("root", physicalPathIdentity(address.scopeRootIdentity));
   }
-  return createHash("sha256").update(parts.join("\0")).digest("hex").slice(0, 32);
+  return sha256Hex(parts.join("\0")).slice(0, 32);
 }
 
 export function analystIssuePagePath(

package/src/archivist-record-topology.ts

@@ -7,9 +7,9 @@
  * books/<book>/navigator/<work-subject-digest>/. Callers must not re-hash
  * subject or re-join book/navigator/digest themselves.
  */
-import { createHash } from "node:crypto";
 import { join } from "node:path";
 
+import { sha256Hex } from "./sha256.ts";
 import { resolveBookKeyFromGit } from "./activation-ledger-git.ts";
 import {
   activationBookDirectory,
@@ -52,7 +52,7 @@ export function resolveNavigatorWorkSubjectPlacement(input: {
     }
   }
   ledgerHome ??= resolveActivationLedgerHome(input.home);
-  const digest = createHash("sha256").update(input.subject).digest("hex").slice(0, 32);
+  const digest = sha256Hex(input.subject).slice(0, 32);
   return {
     ledgerHome,
     sessionDir: join(

package/src/audit-escalation.ts

@@ -1,7 +1,8 @@
+import { isRecord } from "./unknown-value.ts";
 /** Historical audit-escalation discriminator retained for reading pre-#1057 run artifacts. */
 export const AUDIT_ESCALATION_KIND = "audit_escalation" as const;
 
 export function isAuditEscalationResult(value: unknown): value is { readonly kind: typeof AUDIT_ESCALATION_KIND } {
-  return typeof value === "object" && value !== null && !Array.isArray(value)
+  return isRecord(value)
     && (value as Record<string, unknown>).kind === AUDIT_ESCALATION_KIND;
 }

package/src/auditor-soul.ts

@@ -1,6 +1,8 @@
 import { readFile } from "node:fs/promises";
 import { basename, join } from "node:path";
 
+import { isRecord } from "./unknown-value.ts";
+
 import {
   joinPackageMaterials,
   readPackageMaterial,
@@ -126,7 +128,7 @@ export async function readAuditorResumeBinding(runDirectory: string): Promise<
     if ((error as NodeJS.ErrnoException).code === "ENOENT") return undefined;
     throw error;
   }
-  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return undefined;
+  if (!isRecord(raw)) return undefined;
   const record = raw as { sourceRunPath?: unknown; auditorSubject?: unknown };
   if (typeof record.sourceRunPath !== "string" || record.sourceRunPath.trim() === "") return undefined;
   const subject = isAuditorSoulRole(record.auditorSubject)

package/src/book-topology-migration-placement.ts

@@ -10,29 +10,20 @@ import { readdir, readFile } from "node:fs/promises";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 
 import { pathContainedIn } from "./activation-ledger-topology.ts";
-import { roleRunPlacement } from "./role-run-placement.ts";
+import { isUnboundRunDirectory, roleRunPlacement } from "./role-run-placement.ts";
+
+export { isUnboundRunDirectory };
 import {
   MIGRATION_TICKET_DERIVATION_PAGE,
   readBoardTicketNumber,
   readMigrationDerivedTicketNumber,
 } from "./run-ticket-number.ts";
 
+import { isRecord, isEnoent } from "./unknown-value.ts";
+
 const TICKET_NUMBER_RE = /^[1-9][0-9]*$/;
 const RUN_DIR_NAME_RE = /^([^@]+)@([^@]+)$/;
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-/** Sole migration ENOENT projection — non-ENOENT must propagate. */
-export function isMigrationEnoent(error: unknown): boolean {
-  return (
-    error instanceof Error &&
-    "code" in error &&
-    (error as NodeJS.ErrnoException).code === "ENOENT"
-  );
-}
-
 /** Book-key directories under a books root; missing root → []. */
 export async function listMigrationBookKeys(
   booksDirectory: string,
@@ -44,7 +35,7 @@ export async function listMigrationBookKeys(
       .map((entry) => entry.name)
       .sort((a, b) => a.localeCompare(b));
   } catch (error) {
-    if (isMigrationEnoent(error)) return [];
+    if (isEnoent(error)) return [];
     throw error;
   }
 }
@@ -57,7 +48,7 @@ export async function listMigrationDirents(
     const entries = await readdir(directory, { withFileTypes: true });
     return [...entries].sort((a, b) => a.name.localeCompare(b.name));
   } catch (error) {
-    if (isMigrationEnoent(error)) return [];
+    if (isEnoent(error)) return [];
     throw error;
   }
 }
@@ -107,7 +98,7 @@ async function readProjectRootFromRun(
         return { projectRoot, sourcePage: page };
       }
     } catch (error) {
-      if (isMigrationEnoent(error)) continue;
+      if (isEnoent(error)) continue;
       throw error;
     }
   }
@@ -167,10 +158,6 @@ export async function resolveMigratingRunTicket(runDirectory: string): Promise<{
   };
 }
 
-export function isUnboundRunDirectory(runDirectory: string): boolean {
-  return runDirectory.replaceAll("\\", "/").includes("/unbound/runs/");
-}
-
 export function bookHistoricalRoots(
   booksDirectory: string,
   backupBooksDirectory: string,

package/src/book-topology-migrators-t11.ts

@@ -25,7 +25,6 @@ import {
 import {
   findPlacedMigratingRun,
   isFlatRunsRelative,
-  isMigrationEnoent,
   isTicketNumberString,
   listBackupRunLeaves,
   listMigrationBookKeys,
@@ -37,6 +36,8 @@ import {
   type RunDirectoryPathRewrite,
 } from "./role-run-relocation.ts";
 
+import { isRecord, errorText, isEnoent } from "./unknown-value.ts";
+
 const AUDITOR_ROLES_PARTITION = "auditor-roles";
 const ISSUES_PARTITION = "issues";
 const DEPRECATED_KINDS_PARTITION = "deprecated-kinds";
@@ -101,7 +102,7 @@ async function directoryExists(path: string): Promise<boolean> {
     const info = await stat(path);
     return info.isDirectory();
   } catch (error) {
-    if (isMigrationEnoent(error)) return false;
+    if (isEnoent(error)) return false;
     throw error;
   }
 }
@@ -219,7 +220,7 @@ async function readJsonlParentSession(path: string): Promise<string | undefined>
   try {
     raw = await readFile(path, "utf8");
   } catch (error) {
-    if (isMigrationEnoent(error)) return undefined;
+    if (isEnoent(error)) return undefined;
     throw error;
   }
   const newline = raw.indexOf("\n");
@@ -227,7 +228,7 @@ async function readJsonlParentSession(path: string): Promise<string | undefined>
   if (line.length === 0) return undefined;
   try {
     const header: unknown = JSON.parse(line);
-    if (header === null || typeof header !== "object" || Array.isArray(header)) {
+    if (!isRecord(header)) {
       return undefined;
     }
     const parentSession = (header as { parentSession?: unknown }).parentSession;
@@ -268,13 +269,13 @@ async function findTrueVolumeParent(
   try {
     ledgerRaw = await readFile(join(volumeDirectory, CURRENT_SESSION_LEDGER), "utf8");
   } catch (error) {
-    if (isMigrationEnoent(error)) return undefined;
+    if (isEnoent(error)) return undefined;
     throw error;
   }
   let sessionFileField: string;
   try {
     const ledger: unknown = JSON.parse(ledgerRaw);
-    if (ledger === null || typeof ledger !== "object" || Array.isArray(ledger)) {
+    if (!isRecord(ledger)) {
       return undefined;
     }
     const sessionFile = (ledger as { sessionFile?: unknown }).sessionFile;
@@ -298,7 +299,7 @@ async function findTrueVolumeParent(
     const info = await lstat(liveSession);
     if (!info.isFile()) return undefined;
   } catch (error) {
-    if (isMigrationEnoent(error)) return undefined;
+    if (isEnoent(error)) return undefined;
     throw error;
   }
 
@@ -413,7 +414,7 @@ async function readSessionFileField(path: string): Promise<string | undefined> {
   try {
     raw = await readFile(path, "utf8");
   } catch (error) {
-    if (isMigrationEnoent(error)) return undefined;
+    if (isEnoent(error)) return undefined;
     throw error;
   }
   let parsed: unknown;
@@ -422,12 +423,12 @@ async function readSessionFileField(path: string): Promise<string | undefined> {
   } catch (error) {
     throw new Error(
       `book topology migration cannot read current-session pointer at ${path}: invalid JSON (${
-        error instanceof Error ? error.message : String(error)
+        errorText(error)
       })`,
       { cause: error },
     );
   }
-  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+  if (!isRecord(parsed)) {
     throw new Error(
       `book topology migration cannot read current-session pointer at ${path}: expected a JSON object`,
     );
@@ -480,7 +481,7 @@ async function mergeRewrittenCurrentSession(
     srcStat = await stat(srcPath);
     srcRaw = await readFile(srcPath, "utf8");
   } catch (error) {
-    if (isMigrationEnoent(error)) return;
+    if (isEnoent(error)) return;
     throw error;
   }
 
@@ -488,7 +489,7 @@ async function mergeRewrittenCurrentSession(
   let nextSessionFile: string | undefined;
   try {
     const parsed: unknown = JSON.parse(srcRaw);
-    if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+    if (isRecord(parsed)) {
       const record = parsed as Record<string, unknown>;
       if (typeof record.sessionFile === "string") {
         const rewritten = rewritePathIntoDestination(
@@ -510,7 +511,7 @@ async function mergeRewrittenCurrentSession(
   try {
     destStat = await stat(destPath);
   } catch (error) {
-    if (!isMigrationEnoent(error)) throw error;
+    if (!isEnoent(error)) throw error;
   }
   await writeWinningCurrentSession(
     destPath,
@@ -656,7 +657,7 @@ async function copyIssuesNonRunTree(source: string, destination: string): Promis
         `book topology migration refuses to overwrite ${to} with ${from}`,
       );
     } catch (error) {
-      if (!isMigrationEnoent(error)) throw error;
+      if (!isEnoent(error)) throw error;
     }
     await cp(from, to, { preserveTimestamps: true });
   }
@@ -719,7 +720,7 @@ async function unlinkIfPresent(path: string): Promise<void> {
   try {
     await unlink(path);
   } catch (error) {
-    if (!isMigrationEnoent(error)) throw error;
+    if (!isEnoent(error)) throw error;
   }
 }
 

package/src/book-topology-mixed-volume-migrators.ts

@@ -17,12 +17,13 @@ import {
 import {
   bookHistoricalRoots,
   findPlacedMigratingRun,
-  isMigrationEnoent,
   listMigrationBookKeys,
   listMigrationDirents,
   runRefFromBoundPath,
 } from "./book-topology-migration-placement.ts";
 
+import { isRecord, isEnoent } from "./unknown-value.ts";
+
 const SITIAN_MIXED_VOLUME_PARTITIONS = [
   "attendance",
   "auditor",
@@ -32,10 +33,6 @@ const SITIAN_MIXED_VOLUME_PARTITIONS = [
 
 const CURRENT_SESSION_LEDGER = "current-session.json";
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
 function posixRelative(from: string, to: string): string {
   return relative(from, to).split(sep).join("/");
 }
@@ -98,7 +95,7 @@ async function readRegularBackupFile(path: string): Promise<string | undefined>
   try {
     info = await lstat(path);
   } catch (error) {
-    if (isMigrationEnoent(error)) return undefined;
+    if (isEnoent(error)) return undefined;
     throw error;
   }
   if (!info.isFile()) {

package/src/book-topology-record-class-migrators.ts

@@ -9,7 +9,6 @@
  * - malformed → unbound with exact bytes + malformedRows entry
  * - misplaced: any foreign jsonl whose kind is one of the three classes
  */
-import { createHash } from "node:crypto";
 import { appendFile, mkdir, readFile, stat, writeFile } from "node:fs/promises";
 import { dirname, join, relative, sep } from "node:path";
 
@@ -18,7 +17,6 @@ import {
   findBookRunDirectory,
   findPlacedMigratingRun,
   findUniquePrincipalPlacedRun,
-  isMigrationEnoent,
   isTicketNumberString,
   listMigrationBookKeys,
   listMigrationDirents,
@@ -36,6 +34,9 @@ import {
 import { S4_SUBMISSION_LEDGER_KINDS } from "./sitian-appender.ts";
 import { projectTicketProvenanceHeader } from "./ticket-provenance-contracts.ts";
 
+import { sha256Hex } from "./sha256.ts";
+import { isRecord, isEnoent } from "./unknown-value.ts";
+
 const TICKET_PROVENANCE = "ticket-provenance";
 const SUBMISSION_LEDGER = "submission-ledger";
 const ATTEMPT_HISTORY = "attempt-history";
@@ -47,10 +48,6 @@ type JsonLine =
   | { readonly ok: true; readonly value: Record<string, unknown>; readonly raw: string }
   | { readonly ok: false; readonly raw: string };
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
 function parseJsonlLine(raw: string): JsonLine {
   try {
     const value: unknown = JSON.parse(raw);
@@ -70,7 +67,7 @@ function lineSource(backupBooksDirectory: string, filePath: string, index: numbe
 }
 
 function stableKey(material: string): string {
-  return createHash("sha256").update(material).digest("hex").slice(0, 32);
+  return sha256Hex(material).slice(0, 32);
 }
 
 async function readJsonlLines(filePath: string): Promise<readonly string[]> {
@@ -78,7 +75,7 @@ async function readJsonlLines(filePath: string): Promise<readonly string[]> {
   try {
     text = await readFile(filePath, "utf8");
   } catch (error) {
-    if (isMigrationEnoent(error)) return [];
+    if (isEnoent(error)) return [];
     throw error;
   }
   if (text.length === 0) return [];
@@ -629,7 +626,7 @@ async function mergeOfferedIdentities(
     await stat(from);
     lines = await readJsonlLines(from);
   } catch (error) {
-    if (isMigrationEnoent(error)) return;
+    if (isEnoent(error)) return;
     throw error;
   }
   const destFile = join(destDir, OFFERED_IDENTITIES);
@@ -704,7 +701,7 @@ async function migrateHomePartitionBook(
       try {
         await stat(recordsFile);
       } catch (error) {
-        if (isMigrationEnoent(error)) continue;
+        if (isEnoent(error)) continue;
         throw error;
       }
       await migrateJsonlFileByKind(context, bookKey, writes, recordsFile, TICKET_PROVENANCE, outcomes);

package/src/book-topology-runs-migrator.ts

@@ -10,7 +10,6 @@ import { basename, dirname, join, relative, sep } from "node:path";
 
 import {
   destinationRunDirectory,
-  isMigrationEnoent,
   isTicketNumberString,
   listBackupRunLeaves,
   listMigrationBookKeys,
@@ -32,6 +31,8 @@ import {
   readBoardTicketNumber,
 } from "./run-ticket-number.ts";
 
+import { isEnoent } from "./unknown-value.ts";
+
 const RUNS_PARTITION = "runs";
 
 const RUN_LEAF =
@@ -62,7 +63,7 @@ async function pathExists(path: string): Promise<boolean> {
     await stat(path);
     return true;
   } catch (error) {
-    if (isMigrationEnoent(error)) return false;
+    if (isEnoent(error)) return false;
     throw error;
   }
 }
@@ -307,7 +308,7 @@ export async function relocateBoardBoundUnboundRunsInBook(
   try {
     entries = await readdir(unboundRuns, { withFileTypes: true });
   } catch (error) {
-    if (isMigrationEnoent(error)) return [];
+    if (isEnoent(error)) return [];
     throw error;
   }