@remnic/core 9.69.23 → 9.69.25

package/src/abstraction-nodes.ts

@@ -2,6 +2,7 @@ import { mkdir, unlink, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { listJsonFilesStrict, readJsonFile, withJsonStoreMutationLock, writeJsonFileAtomic } from "./json-store.js";
 import { compareDeterministicStrings, mergeSortedUniqueStrings } from "./deterministic-order.js";
+import { isNotFoundError } from "./utils/errno.js";
 import {
   assertIsoRecordedAt,
   assertSafePathSegment,
@@ -12,10 +13,6 @@ import {
   validateStringRecord,
 } from "./store-contract.js";
 
-function isNotFoundError(error: unknown): boolean {
-  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
-}
-
 export type AbstractionNodeKind = "episode" | "topic" | "project" | "workflow" | "constraint";
 export type AbstractionLevel = "micro" | "meso" | "macro";
 

package/src/binary-lifecycle/backend.ts

@@ -10,6 +10,7 @@ import type { Stats } from "node:fs";
 import fsp from "node:fs/promises";
 import path from "node:path";
 import type { BinaryStorageBackendConfig } from "./types.js";
+import { isErrnoCode } from "../utils/errno.js";
 
 // ---------------------------------------------------------------------------
 // Interface
@@ -154,7 +155,7 @@ export class FilesystemBackend implements BinaryStorageBackend {
     }
 
     const realParent = await fsp.realpath(destDir).catch((err: NodeJS.ErrnoException) => {
-      if (err.code === "ENOENT") return null;
+      if (isErrnoCode(err, "ENOENT")) return null;
       throw err;
     });
     if (realParent === null) {

package/src/connectors/live/github.ts

@@ -63,6 +63,7 @@ import type {
   SyncIncrementalArgs,
   SyncIncrementalResult,
 } from "./framework.js";
+import { throwIfAborted } from "../../abort-error.js";
 
 // ---------------------------------------------------------------------------
 // Public constants
@@ -425,14 +426,6 @@ function pickNumericGitHubStatus(e: {
 
 const GITHUB_API_BASE = "https://api.github.com";
 
-function throwIfAborted(signal: AbortSignal | undefined): void {
-  if (signal?.aborted) {
-    const err = new Error("github: sync aborted");
-    err.name = "AbortError";
-    throw err;
-  }
-}
-
 function makeGitHubApiError(status: number, message: string): Error & { githubStatus: number } {
   const err = new Error(`github: HTTP ${status}: ${message}`) as Error & {
     githubStatus: number;
@@ -526,7 +519,7 @@ export function createGitHubConnector(
 
     async syncIncremental(args: SyncIncrementalArgs): Promise<SyncIncrementalResult> {
       const config = validateGitHubConfig(args.config);
-      throwIfAborted(args.abortSignal);
+      throwIfAborted(args.abortSignal, "github: sync aborted");
 
       // Short-circuit: nothing to do if no repos are configured.
       if (config.repos.length === 0) {
@@ -582,7 +575,7 @@ async function seedWatermarks(
   // seenIds starts empty for first-sync; nothing has been processed yet.
 
   for (const repo of config.repos) {
-    throwIfAborted(signal);
+    throwIfAborted(signal, "github: sync aborted");
 
     // Issue comments
     try {
@@ -599,7 +592,7 @@ async function seedWatermarks(
       // 404/403 → repo inaccessible, skip silently.
     }
 
-    throwIfAborted(signal);
+    throwIfAborted(signal, "github: sync aborted");
 
     // PR review comments
     try {
@@ -617,7 +610,7 @@ async function seedWatermarks(
 
     // Discussions (GraphQL not used; we use the REST search endpoint for simplicity)
     if (config.includeDiscussions) {
-      throwIfAborted(signal);
+      throwIfAborted(signal, "github: sync aborted");
       try {
         const latest = await fetchLatestTimestamp(
           fetchFn,
@@ -683,7 +676,7 @@ async function incrementalSync(
 
   for (const repo of config.repos) {
     if (totalConsumed >= MAX_ITEMS_PER_PASS) break;
-    throwIfAborted(signal);
+    throwIfAborted(signal, "github: sync aborted");
 
     // --- Issue comments ---
     {
@@ -730,7 +723,7 @@ async function incrementalSync(
     }
 
     if (totalConsumed >= MAX_ITEMS_PER_PASS) break;
-    throwIfAborted(signal);
+    throwIfAborted(signal, "github: sync aborted");
 
     // --- PR review comments ---
     {
@@ -775,7 +768,7 @@ async function incrementalSync(
 
     // --- Discussion comments (optional) ---
     if (config.includeDiscussions && totalConsumed < MAX_ITEMS_PER_PASS) {
-      throwIfAborted(signal);
+      throwIfAborted(signal, "github: sync aborted");
       const wmKey = watermarkKey(repo, "discussion");
       const since = payload.watermarks[wmKey];
       try {
@@ -922,14 +915,14 @@ async function fetchAndFilterComments(
   let nextUrl: string | undefined = firstPageUrl;
 
   while (nextUrl && consumed < remainingBudget) {
-    throwIfAborted(signal);
+    throwIfAborted(signal, "github: sync aborted");
 
     const data = await githubGet(fetchFn, token, nextUrl, signal);
     if (!Array.isArray(data)) break;
 
     for (const item of data) {
       if (consumed >= remainingBudget) break;
-      throwIfAborted(signal);
+      throwIfAborted(signal, "github: sync aborted");
 
       const comment = normalizeGitHubComment(item, kind);
       if (!comment) {

package/src/connectors/live/gmail.ts

@@ -72,6 +72,7 @@ import type {
   SyncIncrementalResult,
 } from "./framework.js";
 import { isTransientHttpError } from "./transient-errors.js";
+import { throwIfAborted } from "../../abort-error.js";
 
 // ---------------------------------------------------------------------------
 // Public constants
@@ -585,18 +586,6 @@ export function pruneSkippedIds(
   return pruned;
 }
 
-// ---------------------------------------------------------------------------
-// Cooperative cancellation
-// ---------------------------------------------------------------------------
-
-function throwIfAborted(signal: AbortSignal | undefined): void {
-  if (signal?.aborted) {
-    const err = new Error("gmail: sync aborted");
-    err.name = "AbortError";
-    throw err;
-  }
-}
-
 // ---------------------------------------------------------------------------
 // Gmail API client helpers
 // ---------------------------------------------------------------------------
@@ -671,7 +660,7 @@ async function exchangeRefreshToken(
   config: GmailConnectorConfig,
   signal: AbortSignal | undefined,
 ): Promise<string> {
-  throwIfAborted(signal);
+  throwIfAborted(signal, "gmail: sync aborted");
   const body = new URLSearchParams({
     client_id: config.clientId,
     client_secret: config[CLIENT_SECRET_FIELD],
@@ -860,11 +849,11 @@ export function createGmailConnector(
 
     async syncIncremental(args: SyncIncrementalArgs): Promise<SyncIncrementalResult> {
       const config = validateGmailConfig(args.config);
-      throwIfAborted(args.abortSignal);
+      throwIfAborted(args.abortSignal, "gmail: sync aborted");
 
       // Exchange credentials for a short-lived access token.
       const accessToken = await exchangeRefreshToken(fetchFn, config, args.abortSignal);
-      throwIfAborted(args.abortSignal);
+      throwIfAborted(args.abortSignal, "gmail: sync aborted");
 
       // First-sync bootstrap: record "now" as the watermark and return
       // without importing anything. Mirrors Drive's getStartPageToken pattern.
@@ -981,7 +970,7 @@ async function incrementalSync(
 
   // Page through messages.list until exhausted, aborted, or per-pass cap hit.
   while (true) {
-    throwIfAborted(signal);
+    throwIfAborted(signal, "gmail: sync aborted");
 
     // Build the list URL.
     let listPath = `/users/${encodeURIComponent(config.userId)}/messages?maxResults=${LIST_PAGE_SIZE}&q=${encodeURIComponent(listQuery)}`;
@@ -1013,7 +1002,7 @@ async function incrementalSync(
         throw listErr;
       }
     }
-    throwIfAborted(signal);
+    throwIfAborted(signal, "gmail: sync aborted");
 
     const listPage = listData as {
       messages?: GmailMessageRef[];
@@ -1026,7 +1015,7 @@ async function incrementalSync(
     let capHitMidPage = false;
 
     for (const ref of messages) {
-      throwIfAborted(signal);
+      throwIfAborted(signal, "gmail: sync aborted");
 
       // Thread 2: if this id was permanently skipped in a prior pass, skip
       // it again without consuming the per-pass cap. The message is immutable
@@ -1232,7 +1221,7 @@ async function fetchMessageDocument(
   fetchedAt: string,
   signal: AbortSignal | undefined,
 ): Promise<ConnectorDocument | SkippedWithDate | "inaccessible" | null> {
-  throwIfAborted(signal);
+  throwIfAborted(signal, "gmail: sync aborted");
 
   let message: GmailMessage;
   try {

package/src/connectors/live/google-drive.ts

@@ -64,6 +64,7 @@ import type {
   SyncIncrementalResult,
 } from "./framework.js";
 import { isTransientHttpError } from "./transient-errors.js";
+import { throwIfAborted } from "../../abort-error.js";
 
 /**
  * Stable connector id. Lives in the registry under this exact string.
@@ -414,10 +415,10 @@ export function createGoogleDriveConnector(
     async syncIncremental(args: SyncIncrementalArgs): Promise<SyncIncrementalResult> {
       // Re-validate on every pass: a JS caller could mutate it between passes.
       const config = validateGoogleDriveConfig(args.config);
-      throwIfAborted(args.abortSignal);
+      throwIfAborted(args.abortSignal, "googleDrive: sync aborted");
 
       const client = await clientFactory(config);
-      throwIfAborted(args.abortSignal);
+      throwIfAborted(args.abortSignal, "googleDrive: sync aborted");
 
       // Cursor bootstrap. On the very first pass (cursor=null) we ask Drive
       // for a page token but DO NOT consume any changes — this aligns with
@@ -455,7 +456,7 @@ export function createGoogleDriveConnector(
       // Page through `changes.list` until we run out, hit the per-pass cap,
       // or get aborted.
       while (true) {
-        throwIfAborted(args.abortSignal);
+        throwIfAborted(args.abortSignal, "googleDrive: sync aborted");
         const remaining = MAX_CHANGES_PER_PASS - consumed;
         if (remaining <= 0) {
           // Hit the cap — persist whatever we have. The next pass resumes
@@ -467,7 +468,7 @@ export function createGoogleDriveConnector(
         const page = await client.listChanges({ pageToken, pageSize });
 
         for (const change of page.changes) {
-          throwIfAborted(args.abortSignal);
+          throwIfAborted(args.abortSignal, "googleDrive: sync aborted");
           consumed++;
           const decision = decideChange(change, folderScope);
           switch (decision.kind) {
@@ -538,7 +539,7 @@ async function fetchDocument(
   fetchedAt: string,
   abortSignal: AbortSignal | undefined,
 ): Promise<ConnectorDocument | null> {
-  throwIfAborted(abortSignal);
+  throwIfAborted(abortSignal, "googleDrive: sync aborted");
   const file = decision.file;
   let body: string;
   try {
@@ -581,14 +582,6 @@ async function fetchDocument(
   };
 }
 
-function throwIfAborted(signal: AbortSignal | undefined): void {
-  if (signal?.aborted) {
-    const err = new Error("googleDrive: sync aborted");
-    err.name = "AbortError";
-    throw err;
-  }
-}
-
 /**
  * Classify a per-file fetch error as "transient" (re-throw to caller so
  * the sync stops without advancing the cursor and the next poll retries)

package/src/connectors/live/notion.ts

@@ -60,6 +60,7 @@ import type {
   SyncIncrementalResult,
 } from "./framework.js";
 import { isTransientHttpError } from "./transient-errors.js";
+import { throwIfAborted } from "../../abort-error.js";
 
 // ---------------------------------------------------------------------------
 // Public constants
@@ -362,17 +363,6 @@ export function isTransientNotionError(err: unknown): boolean {
 const NOTION_BASE_URL = "https://api.notion.com/v1";
 const NOTION_API_VERSION = "2022-06-28";
 
-/**
- * Throw if aborted (cooperative cancellation).
- */
-function throwIfAborted(signal: AbortSignal | undefined): void {
-  if (signal?.aborted) {
-    const err = new Error("notion: sync aborted");
-    err.name = "AbortError";
-    throw err;
-  }
-}
-
 /**
  * Build a Notion API error with the HTTP status attached for classification.
  */
@@ -531,14 +521,14 @@ async function fetchPageText(
   signal: AbortSignal | undefined,
 ): Promise<string> {
   if (depth > MAX_BLOCK_DEPTH) return "";
-  throwIfAborted(signal);
+  throwIfAborted(signal, "notion: sync aborted");
 
   const lines: string[] = [];
   let cursor: string | undefined = undefined;
 
   // Page through block children.
   while (true) {
-    throwIfAborted(signal);
+    throwIfAborted(signal, "notion: sync aborted");
     const pathQuery = cursor
       ? `/blocks/${blockId}/children?page_size=100&start_cursor=${encodeURIComponent(cursor)}`
       : `/blocks/${blockId}/children?page_size=100`;
@@ -552,7 +542,7 @@ async function fetchPageText(
     };
 
     for (const block of page.results ?? []) {
-      throwIfAborted(signal);
+      throwIfAborted(signal, "notion: sync aborted");
       const text = extractBlockText(block);
       if (text.length > 0) lines.push(text);
 
@@ -653,7 +643,7 @@ export function createNotionConnector(
 
     async syncIncremental(args: SyncIncrementalArgs): Promise<SyncIncrementalResult> {
       const config = validateNotionConfig(args.config);
-      throwIfAborted(args.abortSignal);
+      throwIfAborted(args.abortSignal, "notion: sync aborted");
 
       // Short-circuit: if no databases are configured, there is nothing to do.
       // We still return a valid cursor so the framework has something to
@@ -719,12 +709,12 @@ async function seedWatermark(
   const databases = { ...payload.databases };
 
   for (const dbId of config.databaseIds) {
-    throwIfAborted(signal);
+    throwIfAborted(signal, "notion: sync aborted");
     let notionCursor: string | undefined = undefined;
     let latestInDb = "";
 
     while (true) {
-      throwIfAborted(signal);
+      throwIfAborted(signal, "notion: sync aborted");
       const body: Record<string, unknown> = { page_size: 100, sorts: [] };
       if (notionCursor) body.start_cursor = notionCursor;
 
@@ -784,7 +774,7 @@ async function incrementalSync(
   let totalConsumed = 0;
 
   for (const dbId of config.databaseIds) {
-    throwIfAborted(signal);
+    throwIfAborted(signal, "notion: sync aborted");
     if (totalConsumed >= MAX_PAGES_PER_PASS) break;
 
     const dbWatermark = payload.databases[dbId];
@@ -807,7 +797,7 @@ async function incrementalSync(
     let databaseFullyDrained = false;
 
     while (true) {
-      throwIfAborted(signal);
+      throwIfAborted(signal, "notion: sync aborted");
       if (totalConsumed >= MAX_PAGES_PER_PASS) break;
 
       const body: Record<string, unknown> = {
@@ -845,7 +835,7 @@ async function incrementalSync(
 
       let cutoffMidPage = false;
       for (const notionPage of pageResp.results ?? []) {
-        throwIfAborted(signal);
+        throwIfAborted(signal, "notion: sync aborted");
 
         const pageId = notionPage.id;
         const lastEdited = notionPage.last_edited_time;
@@ -970,7 +960,7 @@ async function fetchPageDocument(
   fetchedAt: string,
   signal: AbortSignal | undefined,
 ): Promise<ConnectorDocument | "too-large" | "empty" | null> {
-  throwIfAborted(signal);
+  throwIfAborted(signal, "notion: sync aborted");
 
   let text: string;
   try {

package/src/cue-anchors.ts

@@ -3,6 +3,7 @@ import path from "node:path";
 import { resolveAbstractionNodeStoreDir, validateAbstractionNode, type AbstractionNode } from "./abstraction-nodes.js";
 import { listJsonFilesStrict, readJsonFile, withJsonStoreMutationLock, writeJsonFileAtomic } from "./json-store.js";
 import { compareDeterministicStrings, mergeSortedUniqueStrings } from "./deterministic-order.js";
+import { isNotFoundError } from "./utils/errno.js";
 import {
   assertIsoRecordedAt,
   assertSafePathSegment,
@@ -170,12 +171,6 @@ function mergeSortedValues(existing: string[] | undefined, incoming: string[] |
   return mergeSortedUniqueStrings(existing, incoming);
 }
 
-function isNotFoundError(error: unknown): boolean {
-  return (
-    typeof error === "object" && error !== null && "code" in error && (error as { code?: unknown }).code === "ENOENT"
-  );
-}
-
 function boundNodeRefs(nodeRefs: string[], liveNodes?: Map<string, AbstractionNode>): string[] {
   const uniqueRefs = mergeSortedUniqueStrings(nodeRefs);
   if (!liveNodes) return uniqueRefs.slice(0, 50);

package/src/graph.ts

@@ -30,6 +30,7 @@ import {
   withGraphWriteLock,
   yieldForLockHeartbeat,
 } from "./graph-write-lock.js";
+import { isErrnoCode } from "./utils/errno.js";
 
 export type GraphType = "entity" | "time" | "causal";
 
@@ -143,9 +144,6 @@ export async function appendEdge(memoryDir: string, edge: GraphEdge): Promise<vo
     confidence: typeof edge.confidence === "number" ? edge.confidence : 1.0,
   });
 }
-function isNodeError(err: unknown): err is NodeJS.ErrnoException {
-  return typeof err === "object" && err !== null && "code" in err;
-}
 
 function parseEdgesJsonl(raw: string, expectedType: GraphType): GraphEdge[] {
   const edges: GraphEdge[] = [];
@@ -213,7 +211,7 @@ export async function readEdgesStrict(memoryDir: string, type: GraphType): Promi
     const raw = await readFile(filePath, "utf8");
     return await parseEdgesJsonlYielding(raw, type);
   } catch (err) {
-    if (isNodeError(err) && err.code === "ENOENT") {
+    if (isErrnoCode(err, "ENOENT")) {
       return [];
     }
     throw err;

package/src/json-store.ts

@@ -13,17 +13,14 @@ import {
   type FileHandle,
 } from "node:fs/promises";
 import path from "node:path";
-
-function hasErrorCode(error: unknown, code: string): boolean {
-  return typeof error === "object" && error !== null && "code" in error && (error as { code?: unknown }).code === code;
-}
+import { isErrnoCode } from "./utils/errno.js";
 
 async function listJsonFilesStrictInner(dir: string, allowMissingDirectory: boolean): Promise<string[]> {
   let entries: Dirent[];
   try {
     entries = await readdir(dir, { withFileTypes: true });
   } catch (error) {
-    if (allowMissingDirectory && hasErrorCode(error, "ENOENT")) return [];
+    if (allowMissingDirectory && isErrnoCode(error, "ENOENT")) return [];
     throw error;
   }
   const out: string[] = [];
@@ -107,7 +104,7 @@ function jsonStoreLockTimeoutMs(): number {
 async function closeAndRemoveJsonStoreReclaimGuard(reclaimPath: string, reclaimHandle: FileHandle): Promise<void> {
   await reclaimHandle.close().catch(() => undefined);
   await unlink(reclaimPath).catch((error) => {
-    if (!hasErrorCode(error, "ENOENT")) throw error;
+    if (!isErrnoCode(error, "ENOENT")) throw error;
   });
 }
 
@@ -116,7 +113,7 @@ async function removeStaleJsonStoreReclaimGuard(reclaimPath: string): Promise<vo
   try {
     initial = await readJsonStoreLockState(reclaimPath);
   } catch (error) {
-    if (hasErrorCode(error, "ENOENT")) return;
+    if (isErrnoCode(error, "ENOENT")) return;
     throw error;
   }
   if (Date.now() - initial.mtimeMs <= jsonStoreLockStaleMs()) return;
@@ -134,12 +131,12 @@ async function removeStaleJsonStoreReclaimGuard(reclaimPath: string): Promise<vo
   try {
     confirmed = await readJsonStoreLockState(reclaimPath);
   } catch (error) {
-    if (hasErrorCode(error, "ENOENT")) return;
+    if (isErrnoCode(error, "ENOENT")) return;
     throw error;
   }
   if (!sameJsonStoreLockState(initial, confirmed)) return;
   await unlink(reclaimPath).catch((error) => {
-    if (!hasErrorCode(error, "ENOENT")) throw error;
+    if (!isErrnoCode(error, "ENOENT")) throw error;
   });
 }
 
@@ -147,12 +144,12 @@ async function acquireJsonStoreReclaimGuard(reclaimPath: string): Promise<FileHa
   try {
     return await open(reclaimPath, "wx", 0o600);
   } catch (error) {
-    if (!hasErrorCode(error, "EEXIST")) throw error;
+    if (!isErrnoCode(error, "EEXIST")) throw error;
     await removeStaleJsonStoreReclaimGuard(reclaimPath);
     try {
       return await open(reclaimPath, "wx", 0o600);
     } catch (retryError) {
-      if (hasErrorCode(retryError, "EEXIST")) return undefined;
+      if (isErrnoCode(retryError, "EEXIST")) return undefined;
       throw retryError;
     }
   }
@@ -169,7 +166,7 @@ function processIsRunning(pid: number): boolean {
     process.kill(pid, 0);
     return true;
   } catch (error) {
-    return !hasErrorCode(error, "ESRCH");
+    return !isErrnoCode(error, "ESRCH");
   }
 }
 
@@ -208,7 +205,7 @@ async function removeJsonStoreMutationLockIfOwned(lockPath: string, token: strin
     const metadata = JSON.parse(state.content) as { token?: unknown };
     if (metadata.token === token) await unlink(lockPath);
   } catch (error) {
-    if (!hasErrorCode(error, "ENOENT") && !(error instanceof SyntaxError)) throw error;
+    if (!isErrnoCode(error, "ENOENT") && !(error instanceof SyntaxError)) throw error;
   }
 }
 
@@ -224,7 +221,7 @@ async function removeStaleJsonStoreLock(lockPath: string): Promise<void> {
     try {
       initial = await readJsonStoreLockState(lockPath);
     } catch (error) {
-      if (hasErrorCode(error, "ENOENT")) return;
+      if (isErrnoCode(error, "ENOENT")) return;
       throw error;
     }
     if (Date.now() - initial.mtimeMs <= jsonStoreLockStaleMs()) return;
@@ -241,12 +238,12 @@ async function removeStaleJsonStoreLock(lockPath: string): Promise<void> {
     try {
       confirmed = await readJsonStoreLockState(lockPath);
     } catch (error) {
-      if (hasErrorCode(error, "ENOENT")) return;
+      if (isErrnoCode(error, "ENOENT")) return;
       throw error;
     }
     if (!sameJsonStoreLockState(initial, confirmed)) return;
     await unlink(lockPath).catch((error) => {
-      if (!hasErrorCode(error, "ENOENT")) throw error;
+      if (!isErrnoCode(error, "ENOENT")) throw error;
     });
   } finally {
     await closeAndRemoveJsonStoreReclaimGuard(reclaimPath, reclaimHandle);
@@ -272,7 +269,7 @@ async function confirmJsonStoreMutationLockOwnership(
         const metadata = JSON.parse(state.content) as { token?: unknown };
         return metadata.token === token;
       } catch (error) {
-        if (hasErrorCode(error, "ENOENT") || error instanceof SyntaxError) return false;
+        if (isErrnoCode(error, "ENOENT") || error instanceof SyntaxError) return false;
         throw error;
       }
     } finally {
@@ -291,9 +288,9 @@ async function acquireJsonStoreMutationFileLock(key: string): Promise<() => Prom
     try {
       handle = await open(lockPath, "wx", 0o600);
     } catch (error) {
-      if (!hasErrorCode(error, "EEXIST")) throw error;
+      if (!isErrnoCode(error, "EEXIST")) throw error;
       await removeStaleJsonStoreLock(lockPath).catch((staleError) => {
-        if (!hasErrorCode(staleError, "ENOENT")) throw staleError;
+        if (!isErrnoCode(staleError, "ENOENT")) throw staleError;
       });
       if (Date.now() >= deadline) {
         throw new Error(`Timed out acquiring JSON store mutation lock: ${lockPath}`);
@@ -338,7 +335,7 @@ async function acquireJsonStoreMutationFileLock(key: string): Promise<() => Prom
         const metadata = JSON.parse(await readFile(lockPath, "utf8")) as { token?: unknown };
         if (metadata.token === token) await unlink(lockPath);
       } catch (error) {
-        if (!hasErrorCode(error, "ENOENT")) throw error;
+        if (!isErrnoCode(error, "ENOENT")) throw error;
       }
     };
   }

package/src/live-connectors-runner.ts

@@ -29,6 +29,7 @@ import {
   type ConnectorState,
   type LiveConnector,
 } from "./connectors/live/index.js";
+import { abortError } from "./abort-error.js";
 import type { LiveConnectorsConfig } from "./types.js";
 
 export type LiveConnectorSkipReason =
@@ -428,7 +429,7 @@ function throwIfAborted(signal: AbortSignal | undefined): void {
   if (reason instanceof Error) {
     throw reason;
   }
-  throw new Error(reason === undefined ? "operation aborted" : String(reason));
+  throw abortError(reason === undefined ? "operation aborted" : String(reason));
 }
 
 async function writeConnectorErrorState(options: {

package/src/location/store.ts

@@ -21,6 +21,7 @@ import path from "node:path";
 
 import { writeFileAtomically } from "../maintenance/atomic-file.js";
 import { pathIsInside } from "../utils/path-containment.js";
+import { isErrnoCode } from "../utils/errno.js";
 import { isValidLocationDate, placeDurations } from "./intervals.js";
 import type { LocationSegment } from "./types.js";
 
@@ -376,10 +377,6 @@ export function parseLocationDaySummary(raw: string): LocationDaySummary | null
 
 // ── Containment-checked day-file IO ─────────────────────────────────────────
 
-function isErrnoCode(err: unknown, code: string): boolean {
-  return err instanceof Error && (err as NodeJS.ErrnoException).code === code;
-}
-
 async function assertNotSymlink(target: string, kind: "directory" | "day file"): Promise<void> {
   let stat: { isSymbolicLink(): boolean };
   try {

package/src/maintenance/purge.ts

@@ -25,6 +25,7 @@ import type { StorageManager } from "../storage.js";
 import type { MemoryFile } from "../types.js";
 import { markProjectedMemoryPathInvalid } from "../memory-projection-store.js";
 import type { SearchBackend } from "../search/port.js";
+import { isErrnoCode } from "../utils/errno.js";
 
 export type PurgeTierFilter = "cold" | "all";
 
@@ -87,10 +88,6 @@ export interface PurgeMemoriesResult {
   errors: Array<{ id: string; path: string; error: string }>;
 }
 
-function hasErrorCode(err: unknown, code: string): boolean {
-  return typeof err === "object" && err !== null && "code" in err && (err as { code?: unknown }).code === code;
-}
-
 function resolveTimestamp(memory: MemoryFile): string {
   const fm = memory.frontmatter as unknown as Record<string, unknown>;
   const updated = typeof fm.updated === "string" ? (fm.updated as string) : "";
@@ -247,7 +244,7 @@ export async function purgeMemories(
       }
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
-      if (hasErrorCode(err, "ENOENT")) {
+      if (isErrnoCode(err, "ENOENT")) {
         alreadyAbsent.push(candidate);
         addCollectionForCandidate(candidate);
         markProjectedMemoryPathInvalid(storage.dir, candidate.id);