@unbrained/pm-cli 2026.8.12 → 2026.8.13

package/dist/core/extensions/registration-values.js

@@ -0,0 +1,210 @@
+/**
+ * @module core/extensions/registration-values
+ *
+ * Preserves executable extension registrations while producing deterministic,
+ * serializable public inventory snapshots and validates assurance providers.
+ */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7316b9ef-38e1-5ee0-9107-da15ec7804d4")}catch(e){}}();
+import { KNOWN_EXTENSION_SERVICE_NAMES, } from "./extension-types.js";
+import { asRegistrationRecord, assertOptionalBooleanField, assertOptionalStringField, } from "./registration-validation.js";
+import { normalizeCommandName } from "./extension-runtime-helpers.js";
+/** Narrow a string to a renderer format accepted by the extension host. */
+export function isOutputRendererFormat(value) {
+    return value === "toon" || value === "json";
+}
+/** Narrow a string to a service name accepted by the extension host. */
+export function isExtensionServiceName(value) {
+    return KNOWN_EXTENSION_SERVICE_NAMES.includes(value);
+}
+/** Require a callable lifecycle hook before registry mutation. */
+export function assertHookHandler(hookName, hook) {
+    if (typeof hook !== "function") {
+        throw new TypeError(`api.hooks.${hookName} requires a function handler`);
+    }
+}
+const EXTENSION_REGISTRATION_TRACE_SYMBOL = Symbol("extension_registration_trace");
+/** Create a validation error carrying a hidden structured activation trace. */
+export function createRegistrationValidationError(message, trace) {
+    const error = new TypeError(message);
+    Object.defineProperty(error, EXTENSION_REGISTRATION_TRACE_SYMBOL, {
+        value: trace,
+        enumerable: false,
+        configurable: false,
+        writable: false,
+    });
+    return error;
+}
+/** Recover a hidden structured activation trace from a validation error. */
+export function extractRegistrationValidationTrace(error) {
+    return error instanceof Error
+        ? error[EXTENSION_REGISTRATION_TRACE_SYMBOL]
+        : undefined;
+}
+/** Recursively project an arbitrary registration value into serializable data. */
+export function sanitizeRegistrationValue(value) {
+    if (value === null)
+        return null;
+    if (Array.isArray(value)) {
+        return value.map((entry) => sanitizeRegistrationValue(entry));
+    }
+    if (typeof value === "function")
+        return "[Function]";
+    if (typeof value === "bigint" || typeof value === "symbol") {
+        return value.toString();
+    }
+    if (typeof value === "object") {
+        const record = value;
+        const normalized = {};
+        for (const key of Object.keys(record).sort((left, right) => left.localeCompare(right))) {
+            normalized[key] = sanitizeRegistrationValue(record[key]);
+        }
+        return normalized;
+    }
+    return value;
+}
+/** Recursively clone registration containers while preserving function identities. */
+export function cloneRuntimeRegistrationValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => cloneRuntimeRegistrationValue(entry));
+    }
+    if (typeof value === "object" && value !== null) {
+        const record = value;
+        const cloned = {};
+        for (const key of Object.keys(record).sort((left, right) => left.localeCompare(right))) {
+            cloned[key] = cloneRuntimeRegistrationValue(record[key]);
+        }
+        return cloned;
+    }
+    return value;
+}
+/** Create a deterministic serializable registration snapshot with functions redacted. */
+export function normalizeRegistrationRecord(name, value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new TypeError(`${name} requires an object definition`);
+    }
+    return sanitizeRegistrationValue(value);
+}
+/** Clone a registration record without stripping executable function values. */
+export function normalizeRuntimeRegistrationRecord(name, value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new TypeError(`${name} requires an object definition`);
+    }
+    return cloneRuntimeRegistrationValue(value);
+}
+/** Implement the typed and untyped registration-array normalization overloads. */
+export function normalizeRegistrationRecordList(name, value) {
+    if (!Array.isArray(value)) {
+        throw new TypeError(`${name} requires an array of object definitions`);
+    }
+    return value.map((entry) => normalizeRegistrationRecord(name, entry));
+}
+/** Require a trimmed non-empty string at an extension authoring boundary. */
+export function assertNonEmptyRegistrationString(name, value) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new TypeError(`${name} requires a non-empty string`);
+    }
+    return value.trim();
+}
+/** Require an executable handler at an extension authoring boundary. */
+export function assertRegistrationFunction(name, value) {
+    if (typeof value !== "function") {
+        throw new TypeError(`${name} requires a function handler`);
+    }
+}
+/** Canonicalize a user-facing registration name for stable routing. */
+export function normalizeRegistrationName(name) {
+    return name
+        .trim()
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((part) => part.length > 0)
+        .join(" ");
+}
+/** Build the canonical command path synthesized for an importer or exporter. */
+export function toRegistrationCommandPath(name, action) {
+    return normalizeCommandName(`${name} ${action}`);
+}
+/** Attach an executable definition as hidden immutable runtime-only state. */
+export function attachRuntimeDefinition(entry, runtimeDefinition) {
+    Object.defineProperty(entry, "runtime_definition", {
+        value: runtimeDefinition,
+        enumerable: false,
+        writable: false,
+        configurable: false,
+    });
+    return entry;
+}
+const ASSURANCE_PROVIDER_COST_CLASSES = new Set(["low", "medium", "high"]);
+const ASSURANCE_PROVIDER_VALUE_TYPES = new Set(["number", "string_set"]);
+const ASSURANCE_PROVIDER_PARAMETER_TYPES = new Set([
+    "string",
+    "number",
+    "boolean",
+]);
+function nonEmptyString(label, value) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new TypeError(`${label} requires a non-empty string`);
+    }
+    return value.trim();
+}
+function validateAssuranceProviderKey(providerId, key, definition) {
+    const label = `registerAssuranceMeasurementProvider provider.keys.${key}`;
+    const record = asRegistrationRecord(label, definition);
+    if (!ASSURANCE_PROVIDER_VALUE_TYPES.has(String(record.value_type))) {
+        throw new TypeError(`${label}.value_type must be number or string_set`);
+    }
+    assertOptionalStringField(`${label}.description`, record.description);
+    if (record.parameters === undefined)
+        return;
+    const parameters = asRegistrationRecord(`${label}.parameters`, record.parameters);
+    for (const [parameter, rawDefinition] of Object.entries(parameters)) {
+        const parameterLabel = `${label}.parameters.${parameter}`;
+        nonEmptyString(`${parameterLabel}.name`, parameter);
+        const parameterDefinition = asRegistrationRecord(parameterLabel, rawDefinition);
+        if (!ASSURANCE_PROVIDER_PARAMETER_TYPES.has(String(parameterDefinition.type))) {
+            throw new TypeError(`${parameterLabel}.type must be string, number, or boolean`);
+        }
+        assertOptionalBooleanField(`${parameterLabel}.required`, parameterDefinition.required);
+        assertOptionalStringField(`${parameterLabel}.description`, parameterDefinition.description);
+    }
+    if (Object.keys(parameters).length > 50) {
+        throw new TypeError(`assurance provider ${providerId} key ${key} exceeds 50 parameters`);
+    }
+}
+/** Validate the closed provider schema before any activation registry mutation. */
+export function validateAssuranceMeasurementProviderDefinition(provider) {
+    const record = asRegistrationRecord("registerAssuranceMeasurementProvider provider", provider);
+    const id = nonEmptyString("registerAssuranceMeasurementProvider provider.id", record.id);
+    if (!/^[a-z0-9][a-z0-9-]*$/u.test(id)) {
+        throw new TypeError("registerAssuranceMeasurementProvider provider.id must be a stable lowercase id");
+    }
+    if (!ASSURANCE_PROVIDER_COST_CLASSES.has(String(record.cost_class))) {
+        throw new TypeError("registerAssuranceMeasurementProvider provider.cost_class must be low, medium, or high");
+    }
+    if (typeof record.network !== "boolean") {
+        throw new TypeError("registerAssuranceMeasurementProvider provider.network must be boolean");
+    }
+    const keys = asRegistrationRecord("registerAssuranceMeasurementProvider provider.keys", record.keys);
+    if (Object.keys(keys).length === 0) {
+        throw new TypeError("registerAssuranceMeasurementProvider provider.keys requires at least one key");
+    }
+    for (const [key, definition] of Object.entries(keys)) {
+        if (!/^[a-z0-9][a-z0-9-]*$/u.test(key)) {
+            throw new TypeError(`registerAssuranceMeasurementProvider provider key ${key} must be a stable lowercase id`);
+        }
+        validateAssuranceProviderKey(id, key, definition);
+    }
+    if (record.timeout_ms !== undefined &&
+        (typeof record.timeout_ms !== "number" ||
+            !Number.isInteger(record.timeout_ms) ||
+            record.timeout_ms < 1 ||
+            record.timeout_ms > 300_000)) {
+        throw new TypeError("registerAssuranceMeasurementProvider provider.timeout_ms must be an integer from 1 through 300000");
+    }
+    if (typeof record.resolve !== "function") {
+        throw new TypeError("registerAssuranceMeasurementProvider provider.resolve requires a function handler");
+    }
+}
+//# sourceMappingURL=registration-values.js.map
+//# debugId=7316b9ef-38e1-5ee0-9107-da15ec7804d4

package/dist/core/extensions/runtime-registrations.d.ts

@@ -3,7 +3,9 @@
  *
  * Implements extension runtime contracts and governance for Runtime Registrations.
  */
-import type { ExtensionRegistrationRegistry, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionVectorStoreAdapter, SchemaFieldDefinition } from "./loader.js";
+import type { ExtensionRegistrationRegistry, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionVectorStoreAdapter, RegisteredExtensionAssuranceMeasurementProvider, SchemaFieldDefinition } from "./loader.js";
+/** Resolve the last-activated assurance provider with the requested stable id. */
+export declare function resolveRegisteredAssuranceMeasurementProvider(registrations: ExtensionRegistrationRegistry | null, providerId: string | undefined): RegisteredExtensionAssuranceMeasurementProvider | null;
 /** Implements collect registered item fields for the public runtime surface of this module. */
 export declare function collectRegisteredItemFields(registrations: ExtensionRegistrationRegistry | null): SchemaFieldDefinition[];
 /** Implements resolve registered search provider for the public runtime surface of this module. */

package/dist/core/extensions/runtime-registrations.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4507a449-1c20-5684-9ed8-e72c9bc694c1")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ab276268-7a98-5f97-b3f5-300dfd1b5ed5")}catch(e){}}();
 function normalizeRegistrationName(value) {
     if (typeof value !== "string") {
         return null;
@@ -7,6 +7,16 @@ function normalizeRegistrationName(value) {
     const normalized = value.trim().toLowerCase();
     return normalized.length > 0 ? normalized : null;
 }
+/** Resolve the last-activated assurance provider with the requested stable id. */
+export function resolveRegisteredAssuranceMeasurementProvider(registrations, providerId) {
+    const normalizedId = normalizeRegistrationName(providerId);
+    if (!registrations || !normalizedId)
+        return null;
+    return ([...(registrations.assurance_providers ?? [])]
+        .reverse()
+        .find((registration) => normalizeRegistrationName(registration.definition.id) ===
+        normalizedId) ?? null);
+}
 /** Implements collect registered item fields for the public runtime surface of this module. */
 export function collectRegisteredItemFields(registrations) {
     if (!registrations) {
@@ -55,4 +65,4 @@ export function getMigrationRuntimeDefinition(migration) {
     return migration.runtime_definition ?? migration.definition;
 }
 //# sourceMappingURL=runtime-registrations.js.map
-//# debugId=4507a449-1c20-5684-9ed8-e72c9bc694c1
+//# debugId=ab276268-7a98-5f97-b3f5-300dfd1b5ed5

package/dist/core/fs/fs-utils.d.ts

@@ -12,6 +12,8 @@ export declare function pathExists(targetPath: string): Promise<boolean>;
  * runtime fault instead of reaching the caller's own root validation.
  */
 export declare function isFileAbsentError(error: unknown): boolean;
+/** Report an exact missing-entry race while preserving ENOTDIR as structural corruption. */
+export declare function isFileMissingError(error: unknown): boolean;
 /** Implements read file if exists for the public runtime surface of this module. */
 export declare function readFileIfExists(targetPath: string): Promise<string | null>;
 /** Implements write file atomic for the public runtime surface of this module. */

package/dist/core/fs/fs-utils.js

@@ -4,7 +4,7 @@
  * Provides filesystem helpers for Fs Utils.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5aef9dc6-948a-5c82-9e3c-2f85fef46beb")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="23fc5fcb-5c80-57ab-8d91-8d15ee35ab53")}catch(e){}}();
 import * as fs from "node:fs/promises";
 import path from "node:path";
 import crypto from "node:crypto";
@@ -33,7 +33,11 @@ export async function pathExists(targetPath) {
  * runtime fault instead of reaching the caller's own root validation.
  */
 export function isFileAbsentError(error) {
-    return isErrno(error, "ENOENT") || isErrno(error, "ENOTDIR");
+    return isFileMissingError(error) || isErrno(error, "ENOTDIR");
+}
+/** Report an exact missing-entry race while preserving ENOTDIR as structural corruption. */
+export function isFileMissingError(error) {
+    return isErrno(error, "ENOENT");
 }
 /** Implements read file if exists for the public runtime surface of this module. */
 export async function readFileIfExists(targetPath) {
@@ -152,4 +156,4 @@ function isErrno(error, code) {
         error.code === code);
 }
 //# sourceMappingURL=fs-utils.js.map
-//# debugId=5aef9dc6-948a-5c82-9e3c-2f85fef46beb
+//# debugId=23fc5fcb-5c80-57ab-8d91-8d15ee35ab53

package/dist/core/history/drift-cache.js

@@ -4,7 +4,8 @@
  * Invalidates derived history-chain verification state after committed writes.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4db09d54-90c6-548b-baa8-c7ce419f70a2")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5121b339-6594-58ec-b479-11cbf7dafd27")}catch(e){}}();
+import { isFileMissingError } from "../fs/fs-utils.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { writeStderr } from "../output/output.js";
@@ -49,7 +50,7 @@ export async function invalidateHistoryDriftCache(pmRoot) {
     }
     catch (error) {
         const errorCode = getFilesystemErrorCode(error);
-        if (errorCode === "ENOENT") {
+        if (isFileMissingError(error)) {
             return;
         }
         const code = errorCode === undefined
@@ -69,4 +70,4 @@ export async function invalidateHistoryDriftCacheForPath(historyPath) {
     await invalidateHistoryDriftCache(path.dirname(historyDirectory));
 }
 //# sourceMappingURL=drift-cache.js.map
-//# debugId=4db09d54-90c6-548b-baa8-c7ce419f70a2
+//# debugId=5121b339-6594-58ec-b479-11cbf7dafd27

package/dist/core/history/drift-scan.js

@@ -1,10 +1,10 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1bffe32d-543d-588a-a1e9-d72553cab06c")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a6714da6-6e2b-5647-bfde-607a54d7e4cd")}catch(e){}}();
 import fs from "node:fs/promises";
 import { createHash } from "node:crypto";
 import path from "node:path";
 import { getHistoryPath } from "../store/paths.js";
-import { writeFileAtomic } from "../fs/fs-utils.js";
+import { isFileMissingError, writeFileAtomic } from "../fs/fs-utils.js";
 import { CURRENT_HISTORY_ITEM_HASH_VERSION, hashDocumentForVersion, } from "./history.js";
 import { verifyHistoryChainWithVersion } from "./replay.js";
 import { getWorkspaceHistoryPath, WORKSPACE_HISTORY_ID, } from "./workspace-history.js";
@@ -28,12 +28,6 @@ async function loadDriftCache(pmRoot) {
         return null;
     }
 }
-function isErrno(error, code) {
-    return (typeof error === "object" &&
-        error !== null &&
-        "code" in error &&
-        error.code === code);
-}
 async function scanWorkspaceHistory(pmRoot, previousEntries, nextEntries, verifyCacheHitByContent, accumulator) {
     const historyPath = getWorkspaceHistoryPath(pmRoot);
     let stat;
@@ -41,7 +35,7 @@ async function scanWorkspaceHistory(pmRoot, previousEntries, nextEntries, verify
         stat = await fs.stat(historyPath);
     }
     catch (error) {
-        if (isErrno(error, "ENOENT"))
+        if (isFileMissingError(error))
             return false;
         accumulator.unreadableStreams.push(WORKSPACE_HISTORY_ID);
         return false;
@@ -210,7 +204,7 @@ export async function scanHistoryDrift(pmRoot, items, options = {}) {
             stat = await fs.stat(historyPath);
         }
         catch (error) {
-            if (isErrno(error, "ENOENT")) {
+            if (isFileMissingError(error)) {
                 accumulator.missingStreams.push(item.id);
             }
             else {
@@ -276,4 +270,4 @@ export async function scanHistoryDrift(pmRoot, items, options = {}) {
     return { ...accumulator, driftedItems };
 }
 //# sourceMappingURL=drift-scan.js.map
-//# debugId=1bffe32d-543d-588a-a1e9-d72553cab06c
+//# debugId=a6714da6-6e2b-5647-bfde-607a54d7e4cd

package/dist/core/lock/lock-gc.js

@@ -9,7 +9,8 @@
  * Zero ttl means any lock older than 0 ms is stale. Negative ttl means always stale.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a026943f-1a46-526b-bfaa-435025c65c2a")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="79f9ccbd-48d1-5eb3-82ae-3dd62427041c")}catch(e){}}();
+import { isFileMissingError } from "../fs/fs-utils.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 function parseLock(raw) {
@@ -34,12 +35,6 @@ function parseLock(raw) {
     }
     return { id, owner, created_at, ttl_seconds };
 }
-function isErrno(error, code) {
-    return (typeof error === "object" &&
-        error !== null &&
-        "code" in error &&
-        error.code === code);
-}
 /** Pure classification of one lock file's raw content against `nowMs`. This is the single staleness/parse policy shared by `pm gc --scope locks` (which acts on it) and the `pm health` locks check (which only reports it). */
 export function classifyLockContent(file, raw, nowMs) {
     const lock = parseLock(raw);
@@ -108,7 +103,7 @@ export async function scanLockHealth(pmRoot, now) {
         dirEntries = rawDir.filter((f) => f.endsWith(".lock")).sort();
     }
     catch (error) {
-        if (isErrno(error, "ENOENT")) {
+        if (isFileMissingError(error)) {
             return scan;
         }
         throw error;
@@ -119,7 +114,7 @@ export async function scanLockHealth(pmRoot, now) {
             raw = await fs.readFile(path.join(locksDir, file), "utf8");
         }
         catch (readError) {
-            if (isErrno(readError, "ENOENT")) {
+            if (isFileMissingError(readError)) {
                 // Disappeared between readdir and readFile — treat as a ghost; skip quietly.
                 continue;
             }
@@ -159,7 +154,7 @@ export async function runLockGc(pmRoot, options) {
         dirEntries = raw.filter((f) => f.endsWith(".lock")).sort();
     }
     catch (error) {
-        if (isErrno(error, "ENOENT")) {
+        if (isFileMissingError(error)) {
             return result;
         }
         throw error;
@@ -179,7 +174,7 @@ export async function runLockGc(pmRoot, options) {
             raw = await fs.readFile(absPath, "utf8");
         }
         catch (readError) {
-            if (isErrno(readError, "ENOENT")) {
+            if (isFileMissingError(readError)) {
                 // Disappeared between readdir and readFile — treat as a ghost; skip quietly.
                 result.scanned -= 1;
                 continue;
@@ -223,7 +218,7 @@ export async function runLockGc(pmRoot, options) {
                 await fs.unlink(absPath);
             }
             catch (unlinkError) {
-                if (!isErrno(unlinkError, "ENOENT")) {
+                if (!isFileMissingError(unlinkError)) {
                     result.warnings.push(`lock_remove_failed:${file}`);
                     result.retained.push(relPath);
                     result.entries.push(classified.entry);
@@ -243,4 +238,4 @@ export async function runLockGc(pmRoot, options) {
     return result;
 }
 //# sourceMappingURL=lock-gc.js.map
-//# debugId=a026943f-1a46-526b-bfaa-435025c65c2a
+//# debugId=79f9ccbd-48d1-5eb3-82ae-3dd62427041c

package/dist/core/lock/lock.js

@@ -4,7 +4,8 @@
  * Coordinates tracker lock ownership and cleanup for Lock.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c638b65d-148a-5b42-8f24-d6fa9d5ac7d3")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a9ad8a9f-de6e-5bce-8685-844f1129d5fb")}catch(e){}}();
+import { isFileMissingError } from "../fs/fs-utils.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
@@ -70,7 +71,7 @@ async function readLockInfo(lockPath) {
         return parseLockInfo(raw);
     }
     catch (error) {
-        if (isErrno(error, "ENOENT")) {
+        if (isFileMissingError(error)) {
             return {
                 info: null,
                 warnings: [],
@@ -294,7 +295,7 @@ async function removeExpiredStaleCleanupGate(gatePath) {
         }
     }
     catch (error) {
-        return isErrno(error, "ENOENT");
+        return isFileMissingError(error);
     }
     const owner = await readStaleCleanupGateOwner(gatePath);
     if (owner !== null &&
@@ -446,4 +447,4 @@ export async function acquireLock(pmRoot, id, ttlSeconds, owner, force = false,
     }
 }
 //# sourceMappingURL=lock.js.map
-//# debugId=c638b65d-148a-5b42-8f24-d6fa9d5ac7d3
+//# debugId=a9ad8a9f-de6e-5bce-8685-844f1129d5fb

package/dist/core/search/vector-stores.js

@@ -1,10 +1,10 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7bac9506-dcad-5e52-848b-3e2631d4936c")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="98c8d03c-bdde-5ac4-b80d-395d885f7442")}catch(e){}}();
 import { mkdir, readFile, stat, unlink } from "node:fs/promises";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 import { executeSearchJsonRequest, normalizeSearchHttpTimeoutMs, resolveSearchHttpFetcher, } from "./http-client.js";
 import { isFiniteNumberArray, toErrorMessage, toNonEmptyString, trimTrailingSlashes, } from "../shared/primitives.js";
-import { writeFileAtomic } from "../fs/fs-utils.js";
+import { isFileMissingError, writeFileAtomic } from "../fs/fs-utils.js";
 const DEFAULT_COLLECTION = "pm_items";
 const COLLECTION_SANITIZE_PATTERN = /[^a-zA-Z0-9_-]/g;
 const MAX_COLLECTION_NAME_LENGTH = 128;
@@ -200,11 +200,6 @@ function getLanceDbLocalTableKey(storePath, table) {
 function getLanceDbSnapshotPath(storePath, table) {
     return join(resolve(storePath), LANCE_DB_LOCAL_SNAPSHOT_DIR, `${table}.json`);
 }
-function isNodeErrorWithCode(error, code) {
-    return (typeof error === "object" &&
-        error !== null &&
-        error.code === code);
-}
 function normalizeSnapshotRecord(entry, index, snapshotPath) {
     const id = toNonEmptyString(entry.id);
     if (!id) {
@@ -261,7 +256,7 @@ async function readLanceDbSnapshotStats(snapshotPath) {
         return { mtimeMs: stats.mtimeMs, size: stats.size };
     }
     catch (error) {
-        if (!isNodeErrorWithCode(error, "ENOENT")) {
+        if (!isFileMissingError(error)) {
             throw error;
         }
         return null;
@@ -306,7 +301,7 @@ async function loadLanceDbLocalTable(storePath, table) {
         loaded = parseLanceDbSnapshot(snapshotPath, table, raw);
     }
     catch (error) {
-        if (!isNodeErrorWithCode(error, "ENOENT")) {
+        if (!isFileMissingError(error)) {
             throw error;
         }
     }
@@ -331,7 +326,7 @@ async function removeSnapshotFile(snapshotPath) {
         await unlink(snapshotPath);
     }
     catch (error) {
-        if (!isNodeErrorWithCode(error, "ENOENT")) {
+        if (!isFileMissingError(error)) {
             throw new Error(`LanceDB local snapshot delete failed at '${snapshotPath}': ${toErrorMessage(error)}`);
         }
     }
@@ -667,4 +662,4 @@ export async function executeVectorReset(store, knownIds = [], options = {}, vec
     return await executeVectorDelete(store, idsToDelete, options);
 }
 //# sourceMappingURL=vector-stores.js.map
-//# debugId=7bac9506-dcad-5e52-848b-3e2631d4936c
+//# debugId=98c8d03c-bdde-5ac4-b80d-395d885f7442

package/dist/core/store/item-metadata-cache.js

@@ -4,7 +4,7 @@
  * Reads and writes tracker storage with format-aware helpers for the item metadata cache.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="58d1ab81-16b6-5c93-ade4-ba189ea48c9b")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8b8c705a-8d80-576f-8642-f6f686cdbed9")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
@@ -12,7 +12,7 @@ import { getActiveExtensionRegistrations, hasActiveOnReadHooks, runActiveOnReadH
 import { collectRegisteredItemFieldNames } from "../extensions/item-fields.js";
 import { parseItemDocument } from "../item/item-format.js";
 import { evictOldestMemoEntries } from "../shared/memo.js";
-import { writeFileAtomic } from "../fs/fs-utils.js";
+import { isFileMissingError, writeFileAtomic } from "../fs/fs-utils.js";
 import { acquireLock } from "../lock/lock.js";
 import { ITEM_FILE_EXTENSIONS, getItemFormatFromPath } from "./paths.js";
 import { rebuildItemMetadataQueryIndex, removeItemMetadataQueryIndex, updateItemMetadataQueryIndex, } from "./item-metadata-query-index.js";
@@ -442,7 +442,7 @@ async function readItemDirectoryFiles(pmRoot, folder, warnings) {
         if (typeof error === "object" &&
             error !== null &&
             "code" in error &&
-            error.code !== "ENOENT") {
+            !isFileMissingError(error)) {
             appendWarning(warnings, `item_list_directory_read_failed:${folder}`);
         }
         return { folder, dirPath, files: [] };
@@ -1114,4 +1114,4 @@ export async function listAllDocumentsCachedLight(pmRoot, preferredFormat, typeT
     }));
 }
 //# sourceMappingURL=item-metadata-cache.js.map
-//# debugId=58d1ab81-16b6-5c93-ade4-ba189ea48c9b
+//# debugId=8b8c705a-8d80-576f-8642-f6f686cdbed9

package/dist/core/telemetry/runtime.d.ts

@@ -171,6 +171,10 @@ declare function sanitizeValue(value: unknown, keyHint?: string, captureLevel?:
 declare function sanitizeCommandArgs(args: string[], captureLevel?: Exclude<TelemetryCaptureLevel, "minimal">): string[];
 declare function normalizeCaptureLevel(value: string | undefined): TelemetryCaptureLevel;
 declare function parseBooleanTrueLike(value: string | undefined): boolean;
+/** Resolve the background event and OTLP request timeout within the flush-lock safety envelope. */
+declare function resolveTelemetryHttpTimeoutMs(): number;
+/** POST a JSON payload with one total timeout that covers DNS, connection, TLS, and response completion. */
+declare function postTelemetryJson(endpoint: string, headers: Record<string, string>, body: string): Promise<number>;
 declare function normalizePmVersion(value: string | undefined): string;
 declare function normalizeTelemetryErrorCode(value: string | undefined): string | undefined;
 declare function normalizeTelemetryExitCode(exitCode: number | undefined, ok: boolean): number;
@@ -335,11 +339,13 @@ export declare const _testOnly: {
     looksLikeEmailToken: typeof looksLikeEmailToken;
     otelSpansQueuePath: typeof otelSpansQueuePath;
     parseBooleanTrueLike: typeof parseBooleanTrueLike;
+    postTelemetryJson: typeof postTelemetryJson;
     parsePendingOtelSpanLines: typeof parsePendingOtelSpanLines;
     prunePendingOtelSpans: typeof prunePendingOtelSpans;
     reconcilePendingOtelSpansAfterFlush: typeof reconcilePendingOtelSpansAfterFlush;
     retentionCutoffMs: typeof retentionCutoffMs;
     resolveOtelTracesEndpoint: typeof resolveOtelTracesEndpoint;
+    resolveTelemetryHttpTimeoutMs: typeof resolveTelemetryHttpTimeoutMs;
     rewritePendingOtelSpans: typeof rewritePendingOtelSpans;
     normalizeForHash: typeof normalizeForHash;
     normalizeCaptureLevel: typeof normalizeCaptureLevel;