@objectstack/core 17.0.0 → 17.2.0

package/dist/index.cjs

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ADMIN_STANDING_SURFACE: () => ADMIN_STANDING_SURFACE,
   ANONYMOUS_DENY_BODY: () => ANONYMOUS_DENY_BODY,
   ANONYMOUS_DENY_CODE: () => ANONYMOUS_DENY_CODE,
   ANONYMOUS_DENY_MESSAGE: () => ANONYMOUS_DENY_MESSAGE,
@@ -65,8 +66,11 @@ __export(index_exports, {
   SecurePluginContext: () => SecurePluginContext,
   SemanticVersionManager: () => SemanticVersionManager,
   ServiceLifecycle: () => ServiceLifecycle,
+  UNMATCHED_ROUTE_PATTERN: () => import_contracts.UNMATCHED_ROUTE_PATTERN,
   UnknownFilterTokenError: () => UnknownFilterTokenError,
   UnresolvedFilterTokenError: () => UnresolvedFilterTokenError,
+  adminStandingColumns: () => adminStandingColumns,
+  adminStandingTables: () => adminStandingTables,
   assembleExecutionContext: () => assembleExecutionContext,
   assembleExecutionContextOrGuest: () => assembleExecutionContextOrGuest,
   assertInitServiceRequirements: () => assertInitServiceRequirements,
@@ -91,6 +95,7 @@ __export(index_exports, {
   defaultIsTransientError: () => defaultIsTransientError,
   derivePosture: () => derivePosture,
   describeInitOrderFault: () => describeInitOrderFault,
+  effectiveTenancyPosture: () => effectiveTenancyPosture,
   engineCanRollBack: () => engineCanRollBack,
   evaluateAuthGate: () => evaluateAuthGate,
   extractApiKey: () => extractApiKey,
@@ -108,6 +113,8 @@ __export(index_exports, {
   isGrantActive: () => isGrantActive,
   isGrantExpired: () => isGrantExpired,
   isNode: () => isNode,
+  isRowActive: () => isRowActive,
+  isUninterpretableTemporalComparand: () => isUninterpretableTemporalComparand,
   nextUtcCalendarDay: () => import_data.nextUtcCalendarDay,
   normalizeAuthGate: () => normalizeAuthGate,
   omitInternalFieldsFromWriteResponse: () => omitInternalFieldsFromWriteResponse,
@@ -118,6 +125,7 @@ __export(index_exports, {
   readAuthoredTranslationLayer: () => readAuthoredTranslationLayer,
   readRunJournal: () => readRunJournal,
   recordNotFoundError: () => recordNotFoundError,
+  resolveApiKeyAdmission: () => resolveApiKeyAdmission,
   resolveApiKeyPrincipal: () => resolveApiKeyPrincipal,
   resolveAuthzContext: () => resolveAuthzContext,
   resolveFilterToken: () => resolveFilterToken,
@@ -131,6 +139,7 @@ __export(index_exports, {
   safeExit: () => safeExit,
   shouldDenyAnonymous: () => shouldDenyAnonymous,
   signPayload: () => signPayload,
+  temporalComparandKind: () => temporalComparandKind,
   unknownAudienceBindingSuggestionStatusMessage: () => unknownAudienceBindingSuggestionStatusMessage,
   utcInstantMs: () => import_data.utcInstantMs,
   validateInitServiceContract: () => validateInitServiceContract,
@@ -141,7 +150,8 @@ __export(index_exports, {
   wireAuthoredTranslationSync: () => wireAuthoredTranslationSync,
   withTransientRetry: () => withTransientRetry,
   withoutOperationPrivateKeys: () => withoutOperationPrivateKeys,
-  zonedDateStartToUtcMs: () => zonedDateStartToUtcMs
+  zonedDateStartToUtcMs: () => zonedDateStartToUtcMs,
+  zonedWallClockToUtcMs: () => zonedWallClockToUtcMs
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1484,35 +1494,6 @@ function createMemoryQueue() {
   };
 }
 
-// src/fallbacks/memory-job.ts
-function createMemoryJob() {
-  const jobs = /* @__PURE__ */ new Map();
-  return {
-    __serviceInfo: {
-      status: "degraded",
-      handlerReady: false,
-      message: "In-process job registry \u2014 trigger() runs handlers, but scheduled jobs never fire on their own (no timer). Register a job plugin (e.g. Agenda) for real scheduling."
-    },
-    _serviceName: "job",
-    async schedule(name, schedule, handler) {
-      jobs.set(name, { schedule, handler });
-    },
-    async cancel(name) {
-      jobs.delete(name);
-    },
-    async trigger(name, data) {
-      const job = jobs.get(name);
-      if (job?.handler) await job.handler({ jobId: name, data });
-    },
-    async getExecutions() {
-      return [];
-    },
-    async listJobs() {
-      return [...jobs.keys()];
-    }
-  };
-}
-
 // src/fallbacks/memory-i18n.ts
 var import_system = require("@objectstack/spec/system");
 function deepMerge(target, source) {
@@ -1740,6 +1721,35 @@ function createMemoryMetadata() {
   };
 }
 
+// src/fallbacks/memory-job.ts
+function createMemoryJob() {
+  const jobs = /* @__PURE__ */ new Map();
+  return {
+    __serviceInfo: {
+      status: "degraded",
+      handlerReady: false,
+      message: "In-process job registry \u2014 trigger() runs handlers, but scheduled jobs never fire on their own (no timer). Register a job plugin (e.g. Agenda) for real scheduling."
+    },
+    _serviceName: "job",
+    async schedule(name, schedule, handler) {
+      jobs.set(name, { schedule, handler });
+    },
+    async cancel(name) {
+      jobs.delete(name);
+    },
+    async trigger(name, data) {
+      const job = jobs.get(name);
+      if (job?.handler) await job.handler({ jobId: name, data });
+    },
+    async getExecutions() {
+      return [];
+    },
+    async listJobs() {
+      return [...jobs.keys()];
+    }
+  };
+}
+
 // src/fallbacks/authored-translation-sync.ts
 var import_system2 = require("@objectstack/spec/system");
 var OWNER_PROP = "__authoredTranslationSyncOwner";
@@ -1872,10 +1882,71 @@ var CORE_FALLBACK_FACTORIES = {
   metadata: createMemoryMetadata,
   cache: createMemoryCache,
   queue: createMemoryQueue,
-  job: createMemoryJob,
   i18n: createMemoryI18n
 };
 
+// src/plugin-registration.ts
+function versionLabel(plugin) {
+  return plugin.version ? `v${plugin.version}` : "unversioned";
+}
+function describeSupersededRegistration(previous, next) {
+  return `Plugin superseded: '${next.name}' \u2014 the later registration (${versionLabel(next)}) REPLACED the earlier one (${versionLabel(previous)}). Only the later instance is initialized and started; the earlier one is discarded without ever running init(). Duplicate registration by name is last-one-wins on both kernels by declared contract (#9864) \u2014 register the plugin once if that is not what you meant.`;
+}
+function registerPluginByName(registry, plugin, logger) {
+  const previous = registry.get(plugin.name);
+  if (previous !== void 0) {
+    logger.warn(describeSupersededRegistration(previous, plugin), {
+      plugin: plugin.name,
+      supersededVersion: previous.version,
+      supersedingVersion: plugin.version
+    });
+  }
+  registry.set(plugin.name, plugin);
+  return previous;
+}
+
+// src/timeout-guard.ts
+var TimeoutGuard = class {
+  constructor(timeoutMs, createTimeoutError) {
+    /**
+     * Settles `expiry` without a value. `Promise<never>` has no resolvable
+     * value in the type system, but settling it is the entire point: it is
+     * only ever called from `reclaim()`, i.e. after the race it guarded has
+     * already been decided, so the resolution is discarded by construction and
+     * can never become a race winner. The cast localises that argument here
+     * rather than pushing a lie into every caller's return type.
+     */
+    this.settleExpiry = () => {
+    };
+    this.expiry = new Promise((resolve, reject) => {
+      this.settleExpiry = resolve;
+      this.timer = setTimeout(() => reject(createTimeoutError()), timeoutMs);
+    });
+  }
+  /**
+   * Reclaim the guard once the race it protects has been decided. Both
+   * halves, always: the timer is cleared so it cannot fire against a
+   * lifecycle phase that is already over, and `expiry` is settled so neither
+   * it nor the race's reaction on it is retained.
+   *
+   * Idempotent — `clearTimeout` on a cleared handle and a second resolve on
+   * a settled promise are both no-ops.
+   */
+  reclaim() {
+    clearTimeout(this.timer);
+    this.timer = void 0;
+    this.settleExpiry();
+  }
+};
+async function raceWithTimeout(operation, timeoutMs, createTimeoutError) {
+  const guard = new TimeoutGuard(timeoutMs, createTimeoutError);
+  try {
+    return await Promise.race([operation, guard.expiry]);
+  } finally {
+    guard.reclaim();
+  }
+}
+
 // src/kernel.ts
 var ObjectKernel = class {
   constructor(config = {}) {
@@ -1960,6 +2031,14 @@ var ObjectKernel = class {
   }
   /**
    * Register a plugin with enhanced validation
+   *
+   * Duplicate names OVERWRITE, with one `warn` naming both versions — the
+   * declared contract in `plugin-registration.ts`, applied identically by
+   * `LiteKernel.use()` (#9864, maintainer ruling 2026-08-19). The overwrite
+   * itself is unchanged: it is what lets an app config's `plugins` entry
+   * supersede a plugin the CLI auto-registered earlier in the same boot
+   * (#9863). What changes is that it is no longer silent, and no longer
+   * disagrees with the other kernel.
    */
   async use(plugin) {
     if (this.state !== "idle") {
@@ -1970,11 +2049,13 @@ var ObjectKernel = class {
       throw new Error(`Failed to load plugin: ${plugin.name} - ${result.error?.message}`);
     }
     const pluginMeta = result.plugin;
-    this.plugins.set(pluginMeta.name, pluginMeta);
-    this.logger.info(`Plugin registered: ${pluginMeta.name}@${pluginMeta.version}`, {
-      plugin: pluginMeta.name,
-      version: pluginMeta.version
-    });
+    const superseded = registerPluginByName(this.plugins, pluginMeta, this.logger);
+    if (superseded === void 0) {
+      this.logger.info(`Plugin registered: ${pluginMeta.name}@${pluginMeta.version}`, {
+        plugin: pluginMeta.name,
+        version: pluginMeta.version
+      });
+    }
     return this;
   }
   /**
@@ -2136,14 +2217,11 @@ var ObjectKernel = class {
     this.logger.info("Graceful shutdown started");
     const shutdownTimeoutError = new Error("Shutdown timeout exceeded");
     try {
-      const shutdownPromise = this.performShutdown();
-      const timeoutPromise = new Promise((_, reject) => {
-        const t = setTimeout(() => {
-          reject(shutdownTimeoutError);
-        }, this.config.shutdownTimeout);
-        if (t.unref) t.unref();
-      });
-      await Promise.race([shutdownPromise, timeoutPromise]);
+      await raceWithTimeout(
+        this.performShutdown(),
+        this.config.shutdownTimeout,
+        () => shutdownTimeoutError
+      );
       this.state = "stopped";
       this.logger.info("\u2705 Graceful shutdown complete");
     } catch (error) {
@@ -2261,25 +2339,17 @@ var ObjectKernel = class {
    * as well: if the hook never settles and nothing else keeps the loop alive,
    * Node exits before the timer can fire and the timeout is never reported.
    * The guard has to stay ref'd exactly as long as the race is undecided,
-   * which is what `clearTimeout` in a `finally` expresses.
+   * which is what clearing on settle expresses.
    *
-   * `operation` is widened to `T | PromiseLike<T>` because the Plugin
-   * contract permits a synchronous hook (`init`/`start` return
-   * `void | Promise<void>`); such a hook wins the race immediately and the
-   * guard is reclaimed on the same turn.
+   * Clearing the timer was only half of it, though (#10604): the promise the
+   * race still holds a reaction on has to SETTLE, or it and that reaction are
+   * retained past the end of the run — two leaking promises per boot, which
+   * is what `vitest --detectAsyncLeaks` names here. Both halves now live in
+   * `TimeoutGuard.reclaim()`, shared with `shutdown()`, so the two sites
+   * cannot drift into doing one half each again.
    */
   async raceStartupTimeout(operation, timeout, message) {
-    let guard;
-    const timeoutPromise = new Promise((_, reject) => {
-      guard = setTimeout(() => {
-        reject(new Error(message));
-      }, timeout);
-    });
-    try {
-      return await Promise.race([operation, timeoutPromise]);
-    } finally {
-      clearTimeout(guard);
-    }
+    return raceWithTimeout(operation, timeout, () => new Error(message));
   }
   /**
    * Whether a service is resolvable on this kernel right now — direct
@@ -2452,14 +2522,21 @@ var LiteKernel = class extends ObjectKernelBase {
   /**
    * Register a plugin
    * @param plugin - Plugin instance
+   *
+   * Duplicate names OVERWRITE, with one `warn` naming both versions — the
+   * declared contract in `plugin-registration.ts`, applied identically by
+   * `ObjectKernel.use()` (#9864, maintainer ruling 2026-08-19).
+   *
+   * This method used to `throw` `[Kernel] Plugin '<name>' already
+   * registered` here while `ObjectKernel` overwrote silently, so one input
+   * had two meanings depending on which kernel was running — and the kernel
+   * that runs in production was the silent one. The ruling converged them on
+   * the behaviour that already works (an app config superseding a plugin the
+   * CLI auto-registered, #9863) and made it audible rather than removing it.
    */
   use(plugin) {
     this.validateIdle();
-    const pluginName = plugin.name;
-    if (this.plugins.has(pluginName)) {
-      throw new Error(`[Kernel] Plugin '${pluginName}' already registered`);
-    }
-    this.plugins.set(pluginName, plugin);
+    registerPluginByName(this.plugins, plugin, this.logger);
     return this;
   }
   /**
@@ -2709,27 +2786,117 @@ var TestRunner = class {
 
 // src/qa/http-adapter.ts
 var import_api = require("@objectstack/spec/api");
-var dataPathCache;
-function defaultDataPath() {
-  if (dataPathCache === void 0) {
+var conventionCache;
+function conventionMounts() {
+  if (conventionCache === void 0) {
     const api = import_api.RestApiConfigSchema.parse({});
     const crud = import_api.CrudEndpointsConfigSchema.parse({});
-    dataPathCache = `${api.apiPath ?? `${api.basePath}/${api.version}`}${crud.dataPrefix}`;
+    const apiBase = api.apiPath ?? `${api.basePath}/${api.version}`;
+    conventionCache = { apiBase, dataPath: `${apiBase}${crud.dataPrefix}` };
   }
-  return dataPathCache;
+  return conventionCache;
 }
 var HttpTestAdapter = class {
   constructor(baseUrl, authToken) {
     this.baseUrl = baseUrl;
     this.authToken = authToken;
   }
-  /** `{baseUrl}{apiBasePath}{dataPrefix}/{object}` — the collection URL. */
-  collectionUrl(objectName) {
-    return `${this.baseUrl}${defaultDataPath()}/${encodeURIComponent(objectName)}`;
+  /** The resolved data mount; probes at most once per adapter. */
+  dataMount() {
+    if (this.mountPromise === void 0) {
+      this.mountPromise = this.resolveDataMount();
+    }
+    return this.mountPromise;
+  }
+  /**
+   * Ask the server where it serves the Data Protocol, and fall back to the
+   * convention — loudly — when it cannot say.
+   *
+   * ## [#7983] What the probe recovers, measured rather than assumed
+   *
+   * `@objectstack/client` answers the same question through discovery
+   * (`getRoute`, `packages/client/src/index.ts`), and this follows it: prefer
+   * the server's own `routes.data`, fall back to the convention. Measured on a
+   * booted stack (REST generator + dispatcher bridge, three configs):
+   *
+   *   | deployment                     | `{apiBase}/discovery` | serves        |
+   *   |--------------------------------|-----------------------|---------------|
+   *   | stock                          | 200 `/api/v1/data`    | `/api/v1/data`|
+   *   | `crud.dataPrefix: '/objects'`  | 200 `/api/v1/objects` | `/api/v1/objects` |
+   *   | `api.apiPath: '/api/2026-01'`  | **404**               | `/api/2026-01/data` |
+   *
+   * So the probe closes the `dataPrefix` row exactly: `RestServer`'s discovery
+   * handler substitutes the configured prefix into `routes.data`, and reading
+   * it is strictly better than recomputing it here. The `apiPath` row it cannot
+   * close, and the reason is structural rather than an oversight — `apiPath`
+   * moves the base that discovery itself is mounted under, so the document that
+   * would name the new mount is behind the very prefix we are missing.
+   *
+   * ⛔ And the one discovery document at a FIXED path does not rescue it:
+   * `/.well-known/objectstack` is mounted at the site root by the dispatcher
+   * bridge, but its `routes.data` is the DISPATCHER's own `${prefix}/data` —
+   * measured as `/api/v1/data` under all three configs above, including the two
+   * where the server serves elsewhere. Falling back to it would turn "we could
+   * not resolve the mount" into "discovery told us `/api/v1/data`": the same
+   * 404, now with a false provenance attached. Not probed, deliberately.
+   *
+   * Hence: one probe, then a diagnostic that NAMES the mount, the evidence and
+   * the remedy. `api_call` takes the path it is given and is unaffected either
+   * way — it stays the escape hatch for a host this cannot reach.
+   */
+  async resolveDataMount() {
+    const { apiBase, dataPath } = conventionMounts();
+    const probeUrl = `${this.baseUrl}${apiBase}/discovery`;
+    let why;
+    try {
+      const headers = {};
+      if (this.authToken) {
+        headers["Authorization"] = `Bearer ${this.authToken}`;
+      }
+      const response = await fetch(probeUrl, { method: "GET", headers });
+      if (response.ok) {
+        const body = await response.json();
+        const doc = body && typeof body === "object" && "routes" in body ? body : body?.data;
+        const advertised = doc?.routes?.data;
+        if (typeof advertised === "string" && advertised.length > 0) {
+          return {
+            path: advertised,
+            source: "discovery",
+            why: `GET ${probeUrl} advertised routes.data`
+          };
+        }
+        why = `GET ${probeUrl} answered ${response.status} but carried no routes.data`;
+      } else {
+        why = `GET ${probeUrl} answered ${response.status}`;
+      }
+    } catch (error) {
+      why = `GET ${probeUrl} could not be reached (${error.message})`;
+    }
+    const mount = { path: dataPath, source: "convention", why };
+    console.warn(
+      `[HttpTestAdapter] Data Protocol mount NOT resolved from discovery. Record actions (create_record, read_record, update_record, delete_record, query_records) will address ${this.baseUrl}${dataPath}, the convention declared by RestApiConfigSchema (apiPath ?? basePath/version) + CrudEndpointsConfigSchema.dataPrefix. Evidence: ${why}. A deployment that sets crud.dataPrefix is normally recovered by this probe; one that sets api.apiPath moves discovery itself out from under it, and no fixed-path document reports the REST mount \u2014 write those steps as api_call, which takes the path you give it.`
+    );
+    return mount;
+  }
+  /** `{baseUrl}{dataMount}/{object}` — the collection URL. */
+  collectionUrl(mount, objectName) {
+    return `${this.baseUrl}${mount.path}/${encodeURIComponent(objectName)}`;
   }
   /** `{collection}/{id}` — the single-record URL. */
-  recordUrl(objectName, id) {
-    return `${this.collectionUrl(objectName)}/${encodeURIComponent(String(id))}`;
+  recordUrl(mount, objectName, id) {
+    return `${this.collectionUrl(mount, objectName)}/${encodeURIComponent(String(id))}`;
+  }
+  /**
+   * The provenance clause appended to a failed record action's error.
+   *
+   * The card this closes is about a 404 that reads like the author's own URL
+   * mistake; the mount is the one fact that distinguishes the two, so it rides
+   * on the failure itself rather than only on a warning printed earlier in the
+   * transcript.
+   */
+  mountNote(mount) {
+    const how = mount.source === "discovery" ? "resolved from discovery" : "assumed by convention \u2014 the server was not able to state it";
+    return `record actions addressed ${this.baseUrl}${mount.path} (data mount ${how}: ${mount.why})`;
   }
   async execute(action, _context) {
     const headers = {
@@ -2762,48 +2929,53 @@ var HttpTestAdapter = class {
     }
   }
   async createRecord(objectName, data, headers) {
-    const response = await fetch(this.collectionUrl(objectName), {
+    const mount = await this.dataMount();
+    const response = await fetch(this.collectionUrl(mount, objectName), {
       method: "POST",
       headers,
       body: JSON.stringify(data)
     });
-    return this.handleResponse(response);
+    return this.handleResponse(response, this.mountNote(mount));
   }
   async updateRecord(objectName, data, headers) {
     const { id, ...fields } = data;
     if (!id) throw new Error("Update record requires id in payload");
-    const response = await fetch(this.recordUrl(objectName, id), {
+    const mount = await this.dataMount();
+    const response = await fetch(this.recordUrl(mount, objectName, id), {
       method: "PATCH",
       headers,
       body: JSON.stringify(fields)
     });
-    return this.handleResponse(response);
+    return this.handleResponse(response, this.mountNote(mount));
   }
   async deleteRecord(objectName, data, headers) {
     const id = data.id;
     if (!id) throw new Error("Delete record requires id in payload");
-    const response = await fetch(this.recordUrl(objectName, id), {
+    const mount = await this.dataMount();
+    const response = await fetch(this.recordUrl(mount, objectName, id), {
       method: "DELETE",
       headers
     });
-    return this.handleResponse(response);
+    return this.handleResponse(response, this.mountNote(mount));
   }
   async readRecord(objectName, data, headers) {
     const id = data.id;
     if (!id) throw new Error("Read record requires id in payload");
-    const response = await fetch(this.recordUrl(objectName, id), {
+    const mount = await this.dataMount();
+    const response = await fetch(this.recordUrl(mount, objectName, id), {
       method: "GET",
       headers
     });
-    return this.handleResponse(response);
+    return this.handleResponse(response, this.mountNote(mount));
   }
   async queryRecords(objectName, data, headers) {
-    const response = await fetch(`${this.collectionUrl(objectName)}/query`, {
+    const mount = await this.dataMount();
+    const response = await fetch(`${this.collectionUrl(mount, objectName)}/query`, {
       method: "POST",
       headers,
       body: JSON.stringify(data)
     });
-    return this.handleResponse(response);
+    return this.handleResponse(response, this.mountNote(mount));
   }
   async rawApiCall(endpoint, data, headers) {
     const method = data.method || "GET";
@@ -2816,10 +2988,13 @@ var HttpTestAdapter = class {
     });
     return this.handleResponse(response);
   }
-  async handleResponse(response) {
+  async handleResponse(response, mountNote) {
     if (!response.ok) {
       const text = await response.text();
-      throw new Error(`HTTP Error ${response.status}: ${text}`);
+      const wrongUrlShaped = response.status === 404 || response.status === 405;
+      throw new Error(
+        `HTTP Error ${response.status}: ${text}${wrongUrlShaped && mountNote ? ` \u2014 ${mountNote}` : ""}`
+      );
     }
     const contentType = response.headers.get("content-type");
     if (contentType && contentType.includes("application/json")) {
@@ -4161,6 +4336,7 @@ var PluginSecurityScanner = class {
 
 // src/security/api-key.ts
 var import_node_crypto2 = require("crypto");
+var import_security = require("@objectstack/spec/security");
 var API_KEY_PREFIX = "osk_";
 var API_KEY_ENTROPY_BYTES = 32;
 var VISIBLE_PREFIX_LEN = 12;
@@ -4214,10 +4390,18 @@ function isExpired(value, nowMs) {
   if (Number.isNaN(ms)) return false;
   return ms <= nowMs;
 }
-async function resolveApiKeyPrincipal(ql, headers, nowMs = Date.now()) {
+function effectiveTenancyPosture(tenancy) {
+  if (!tenancy) return void 0;
+  return (0, import_security.normalizeTenancyPosture)(tenancy.posture) ?? (tenancy.isolationActive ? "isolated" : "single");
+}
+async function resolveApiKeyPrincipal(ql, headers, nowMs = Date.now(), tenancyPosture) {
+  const admission = await resolveApiKeyAdmission(ql, headers, nowMs, tenancyPosture);
+  return admission.outcome === "admitted" ? admission.principal : void 0;
+}
+async function resolveApiKeyAdmission(ql, headers, nowMs = Date.now(), tenancyPosture) {
   const apiKey = extractApiKey(headers);
-  if (!apiKey) return void 0;
-  if (!ql || typeof ql.find !== "function") return void 0;
+  if (!apiKey) return { outcome: "none" };
+  if (!ql || typeof ql.find !== "function") return { outcome: "none" };
   let rows;
   try {
     rows = await ql.find("sys_api_key", {
@@ -4226,19 +4410,29 @@ async function resolveApiKeyPrincipal(ql, headers, nowMs = Date.now()) {
       context: { isSystem: true }
     });
   } catch {
-    return void 0;
+    return { outcome: "none" };
   }
   if (rows && rows.value) rows = rows.value;
   const row = Array.isArray(rows) ? rows[0] : void 0;
-  if (!row || row.revoked === true) return void 0;
+  if (!row || row.revoked === true) return { outcome: "none" };
   const expiresAt = row.expires_at ?? row.expiresAt;
-  if (isExpired(expiresAt, nowMs)) return void 0;
+  if (isExpired(expiresAt, nowMs)) return { outcome: "none" };
   const userId = row.user_id ?? row.userId;
-  if (!userId || typeof userId !== "string") return void 0;
+  if (!userId || typeof userId !== "string") return { outcome: "none" };
+  const tenantId = typeof row.active_organization_id === "string" && row.active_organization_id ? row.active_organization_id : void 0;
+  if (!tenantId && tenancyPosture) {
+    const posture = tenancyPosture;
+    if ((0, import_security.postureEnforcesWall)(posture) && !(0, import_security.postureUsesUnionScope)(posture)) {
+      return {
+        outcome: "refused",
+        reason: "organization_required",
+        message: "This API key carries no organization and cannot be used under the `isolated` tenancy posture, where every organization-scoped read is walled to an active organization. Mint a replacement key \u2014 new keys inherit the minter\u2019s active organization."
+      };
+    }
+  }
   return {
-    userId,
-    tenantId: row.organization_id ?? row.organizationId ?? void 0,
-    scopes: parseScopes(row.scopes)
+    outcome: "admitted",
+    principal: { userId, tenantId, scopes: parseScopes(row.scopes) }
   };
 }
 function readHeader(headers, name) {
@@ -4266,6 +4460,7 @@ function safeJsonParse(s, fallback) {
 
 // src/security/resolve-authz-context.ts
 var import_spec = require("@objectstack/spec");
+var import_security2 = require("@objectstack/spec/security");
 
 // src/security/grant-validity.ts
 function toEpochMs(value) {
@@ -4348,6 +4543,15 @@ function postureVisibleRows(posture, rows, principal) {
   }
 }
 
+// src/security/row-active.ts
+var DEACTIVATED_VALUES = [false, 0, "0", "false"];
+function isRowActive(row) {
+  if (!row) return false;
+  const value = row.active;
+  if (value === void 0 || value === null) return true;
+  return !DEACTIVATED_VALUES.includes(value);
+}
+
 // src/security/resolve-authz-context.ts
 function safeJsonParse2(s, fallback) {
   try {
@@ -4356,10 +4560,11 @@ function safeJsonParse2(s, fallback) {
     return fallback;
   }
 }
-async function tryFind(ql, object, where, limit = 100) {
+async function tryFind(ql, object, where, limit = 100, organizationId) {
   if (!ql || typeof ql.find !== "function") return [];
   try {
-    let rows = await ql.find(object, { where, limit, context: { isSystem: true } });
+    const context = organizationId ? { isSystem: true, tenantId: organizationId } : { isSystem: true };
+    let rows = await ql.find(object, { where, limit, context });
     if (rows && rows.value) rows = rows.value;
     return Array.isArray(rows) ? rows : [];
   } catch {
@@ -4377,7 +4582,12 @@ async function resolveAuthzContext(input) {
   };
   let userId;
   let tenantId;
-  const keyPrincipal = await resolveApiKeyPrincipal(ql, headers, input.nowMs);
+  const admission = await resolveApiKeyAdmission(ql, headers, input.nowMs, input.tenancyPosture);
+  if (admission.outcome === "refused") {
+    ctx.authRefusal = { reason: admission.reason, message: admission.message };
+    return ctx;
+  }
+  const keyPrincipal = admission.outcome === "admitted" ? admission.principal : void 0;
   if (keyPrincipal) {
     userId = keyPrincipal.userId;
     tenantId = keyPrincipal.tenantId;
@@ -4405,6 +4615,22 @@ async function resolveAuthzContext(input) {
     seedPermissions: ctx.permissions,
     seedEmail: ctx.email
   });
+  if (keyPrincipal?.tenantId && input.tenancyPosture) {
+    const posture = input.tenancyPosture;
+    if ((0, import_security2.postureEnforcesWall)(posture) && !grants.accessible_org_ids.includes(keyPrincipal.tenantId)) {
+      return {
+        positions: [],
+        permissions: [],
+        systemPermissions: [],
+        org_user_ids: [],
+        accessible_org_ids: [],
+        authRefusal: {
+          reason: "organization_membership_ended",
+          message: "This API key authenticates into an organization its owner is no longer a member of. The key was not revoked \u2014 the membership that backed it ended."
+        }
+      };
+    }
+  }
   ctx.positions = grants.positions;
   ctx.permissions = grants.permissions;
   ctx.systemPermissions = grants.systemPermissions;
@@ -4436,12 +4662,19 @@ async function resolveUserAuthzGrants(ql, userId, opts = {}) {
     }
     return userRow;
   };
+  const needsUserRow = !grants.email || !grants.permissions.includes("ai_seat");
+  const [, members, userPositionRows, orgMembersLeg, upsRowsAll] = await Promise.all([
+    needsUserRow ? getUserRow() : Promise.resolve(void 0),
+    tryFind(ql, "sys_member", { user_id: userId }, 200),
+    tryFind(ql, "sys_user_position", { user_id: userId }, 200),
+    tenantId ? tryFind(ql, "sys_member", { organization_id: tenantId }, 1e3) : Promise.resolve([]),
+    tryFind(ql, "sys_user_permission_set", { user_id: userId }, 100)
+  ]);
   if (!grants.email) {
     const u = await getUserRow();
     if (u?.email) grants.email = String(u.email);
   }
   const nowMs = opts.nowMs ?? Date.now();
-  const members = await tryFind(ql, "sys_member", { user_id: userId }, 200);
   const accessibleOrgIds = /* @__PURE__ */ new Set();
   for (const m of members) {
     if (!isGrantActive(m, nowMs)) continue;
@@ -4449,7 +4682,9 @@ async function resolveUserAuthzGrants(ql, userId, opts = {}) {
     if (typeof org === "string" && org) accessibleOrgIds.add(org);
   }
   grants.accessible_org_ids = Array.from(accessibleOrgIds);
-  const activeMembers = tenantId ? members.filter((m) => (m.organization_id ?? m.organizationId) === tenantId) : members;
+  const activeMembers = members.filter(
+    (m) => isGrantActive(m, nowMs) && (!tenantId || (m.organization_id ?? m.organizationId) === tenantId)
+  );
   for (const m of activeMembers) {
     if (m.role && typeof m.role === "string") {
       for (const raw of m.role.split(",").map((s) => s.trim()).filter(Boolean)) {
@@ -4458,7 +4693,6 @@ async function resolveUserAuthzGrants(ql, userId, opts = {}) {
       }
     }
   }
-  const userPositionRows = await tryFind(ql, "sys_user_position", { user_id: userId }, 200);
   for (const ur of userPositionRows) {
     const org = ur.organization_id ?? null;
     if (org && tenantId && org !== tenantId) continue;
@@ -4467,14 +4701,13 @@ async function resolveUserAuthzGrants(ql, userId, opts = {}) {
     if (typeof r === "string" && r && !grants.positions.includes(r)) grants.positions.push(r);
   }
   if (tenantId) {
-    const orgMembers = await tryFind(ql, "sys_member", { organization_id: tenantId }, 1e3);
+    const orgMembers = orgMembersLeg;
     const ids = new Set(
       orgMembers.map((m) => m.user_id ?? m.userId).filter((v) => typeof v === "string" && v.length > 0)
     );
     ids.add(userId);
     grants.org_user_ids = Array.from(ids);
   }
-  const upsRowsAll = await tryFind(ql, "sys_user_permission_set", { user_id: userId }, 100);
   const upsRows = upsRowsAll.filter((r) => isGrantActive(r, nowMs));
   const psIds = new Set(
     upsRows.filter((r) => {
@@ -4488,8 +4721,14 @@ async function resolveUserAuthzGrants(ql, userId, opts = {}) {
   let hasPlatformAdminGrant = false;
   if (!grants.positions.includes("everyone")) grants.positions.push("everyone");
   if (grants.positions.length > 0) {
-    const positionRows = await tryFind(ql, "sys_position", { name: { $in: grants.positions } }, 100);
-    const positionIds = positionRows.map((r) => r.id).filter(Boolean);
+    const positionRows = await tryFind(ql, "sys_position", { name: { $in: grants.positions } }, 200, tenantId);
+    const deactivatedNames = new Set(
+      positionRows.filter((r) => !isRowActive(r)).map((r) => r.name).filter(Boolean)
+    );
+    if (deactivatedNames.size > 0) {
+      grants.positions = grants.positions.filter((n) => !deactivatedNames.has(n));
+    }
+    const positionIds = positionRows.filter((r) => isRowActive(r)).map((r) => r.id).filter(Boolean);
     if (positionIds.length > 0) {
       const rpsRows = await tryFind(ql, "sys_position_permission_set", { position_id: { $in: positionIds } }, 500);
       for (const r of rpsRows) {
@@ -4499,7 +4738,8 @@ async function resolveUserAuthzGrants(ql, userId, opts = {}) {
     }
   }
   if (psIds.size > 0) {
-    const psRows = await tryFind(ql, "sys_permission_set", { id: { $in: Array.from(psIds) } }, 500);
+    const psRowsAll = await tryFind(ql, "sys_permission_set", { id: { $in: Array.from(psIds) } }, 500);
+    const psRows = psRowsAll.filter((r) => isRowActive(r));
     const tabRank = { hidden: 0, default_off: 1, default_on: 2, visible: 3 };
     const mergedTabs = {};
     for (const ps of psRows) {
@@ -4559,34 +4799,89 @@ function coerceCurrency(value) {
   const s = typeof value === "string" ? value.trim().toUpperCase() : "";
   return /^[A-Z]{3}$/.test(s) ? s : void 0;
 }
+var LOCALIZATION_FAILURE_CACHE_TTL_MS = 3e4;
+var localizationFailureCache = /* @__PURE__ */ new WeakMap();
 async function resolveLocalizationContext(input) {
+  const { ql, tenantId, userId } = input;
+  const cacheKey = `${tenantId ?? ""}|${userId ?? ""}`;
+  if (ql && typeof ql === "object") {
+    const hit = localizationFailureCache.get(ql)?.get(cacheKey);
+    if (hit && hit.expiresAt > Date.now()) return hit.value;
+  }
+  const { value, failed } = await resolveLocalizationContextUncached(input);
+  if (failed && ql && typeof ql === "object") {
+    const bucket = localizationFailureCache.get(ql) ?? /* @__PURE__ */ new Map();
+    bucket.set(cacheKey, { value, expiresAt: Date.now() + LOCALIZATION_FAILURE_CACHE_TTL_MS });
+    localizationFailureCache.set(ql, bucket);
+  }
+  return value;
+}
+async function resolveLocalizationContextUncached(input) {
   const { ql, settings, tenantId, userId } = input;
+  let failed = false;
   try {
     if (settings && typeof settings.get === "function") {
       const sctx = { tenantId, userId };
-      const [tzRes, localeRes, currencyRes] = await Promise.all([
-        settings.get("localization", "timezone", sctx).catch(() => void 0),
-        settings.get("localization", "locale", sctx).catch(() => void 0),
-        settings.get("localization", "currency", sctx).catch(() => void 0)
-      ]);
+      let tzRes;
+      let localeRes;
+      let currencyRes;
+      if (typeof settings.getMany === "function") {
+        try {
+          const many = await settings.getMany("localization", ["timezone", "locale", "currency"], sctx);
+          tzRes = many.timezone;
+          localeRes = many.locale;
+          currencyRes = many.currency;
+        } catch {
+          failed = true;
+        }
+      } else {
+        [tzRes, localeRes, currencyRes] = await Promise.all([
+          settings.get("localization", "timezone", sctx).catch(() => {
+            failed = true;
+            return void 0;
+          }),
+          settings.get("localization", "locale", sctx).catch(() => {
+            failed = true;
+            return void 0;
+          }),
+          settings.get("localization", "currency", sctx).catch(() => {
+            failed = true;
+            return void 0;
+          })
+        ]);
+      }
       const tz = coerceTimeZone(tzRes?.value);
       const locale = coerceLocale(localeRes?.value);
       const currency = coerceCurrency(currencyRes?.value);
-      if (tz || locale || currency) return { timezone: tz ?? "UTC", locale: locale ?? "en-US", currency };
+      if (tz || locale || currency) {
+        return { value: { timezone: tz ?? "UTC", locale: locale ?? "en-US", currency }, failed: false };
+      }
     }
   } catch {
+    failed = true;
+  }
+  let rows = [];
+  if (ql && typeof ql.find === "function") {
+    try {
+      let result = await ql.find("sys_setting", {
+        where: { namespace: "localization", key: { $in: ["timezone", "locale", "currency"] }, scope: "tenant" },
+        limit: 10,
+        context: { isSystem: true }
+      });
+      if (result && result.value) result = result.value;
+      rows = Array.isArray(result) ? result : [];
+    } catch {
+      failed = true;
+    }
   }
-  const rows = await tryFind(
-    ql,
-    "sys_setting",
-    { namespace: "localization", key: { $in: ["timezone", "locale", "currency"] }, scope: "tenant" },
-    10
-  );
   const valueOf = (k) => rows.find((r) => r.key === k)?.value;
   return {
-    timezone: coerceTimeZone(valueOf("timezone")) ?? "UTC",
-    locale: coerceLocale(valueOf("locale")) ?? "en-US",
-    currency: coerceCurrency(valueOf("currency"))
+    value: {
+      timezone: coerceTimeZone(valueOf("timezone")) ?? "UTC",
+      locale: coerceLocale(valueOf("locale")) ?? "en-US",
+      currency: coerceCurrency(valueOf("currency"))
+    },
+    failed
   };
 }
 
@@ -4730,6 +5025,7 @@ var ANONYMOUS_DENY_CODE = "UNAUTHENTICATED";
 var ANONYMOUS_DENY_MESSAGE = "Authentication is required to access this endpoint.";
 var ANONYMOUS_DENY_BODY = {
   error: ANONYMOUS_DENY_CODE,
+  code: ANONYMOUS_DENY_CODE,
   message: ANONYMOUS_DENY_MESSAGE
 };
 function shouldDenyAnonymous(input) {
@@ -4743,6 +5039,76 @@ function shouldDenyAnonymous(input) {
   return true;
 }
 
+// src/security/admin-standing-surface.ts
+var ADMIN_STANDING_SURFACE = {
+  sys_permission_set: {
+    role: "derives",
+    reason: "The row `platform_admin` is resolved BY NAME from (\xA76b). Renaming it, deleting it or switching it off (ADR-0049 `active`, read here since #8613) un-makes every platform admin at once, with no identity table touched.",
+    columns: [
+      "id",
+      "name",
+      "active",
+      "system_permissions",
+      "systemPermissions",
+      "tab_permissions",
+      "tabPermissions"
+    ]
+  },
+  sys_user_permission_set: {
+    role: "derives",
+    reason: "The grant that makes a user a platform admin: an UNSCOPED, in-window (ADR-0091) grant of `admin_full_access` (\xA76). Re-pointing it, scoping it to an organization or moving it out of its window revokes the standing while leaving the row in place.",
+    columns: [
+      "user_id",
+      "permission_set_id",
+      "permissionSetId",
+      "organization_id",
+      "organizationId",
+      "valid_from",
+      "validFrom",
+      "valid_until",
+      "validUntil"
+    ]
+  },
+  sys_member: {
+    role: "derives",
+    reason: "Organization owner/admin standing (\xA73). The graded `role` is projected into `positions` here and separately drives the `organization_admin` capability grant, which is what the posture ladder reads; the break-glass guard counts the same rows one step earlier, by grade (ADR-0108). Either way a downgrade of the last graded membership is a write that can empty the administrator population.",
+    columns: [
+      "user_id",
+      "userId",
+      "organization_id",
+      "organizationId",
+      "role",
+      "valid_from",
+      "validFrom",
+      "valid_until",
+      "validUntil"
+    ]
+  },
+  sys_user: {
+    role: "reads-only",
+    reason: "Read for the `current_user.email` RLS fallback and the ADR-0024 `ai_seat` synthesis (\xA77). Neither confers administrator standing. The guard does watch this table, but for the ban/delete WRITE SHAPES \u2014 `banned` is never read here, so it is not a derivation column and carries no standing-key list."
+  },
+  sys_user_position: {
+    role: "reads-only",
+    reason: "ADR-0057 D4 platform-RBAC position assignments (\xA74). A position can carry permission sets (see `sys_position_permission_set`) but never platform-admin standing \u2014 \xA76b requires the set to be reached through an unscoped USER grant (`unscopedUserPsIds`), so a position-bound `admin_full_access` resolves the set name into `permissions` and leaves `hasPlatformAdminGrant` false."
+  },
+  sys_position: {
+    role: "reads-only",
+    reason: "Read to drop DEACTIVATED positions (ADR-0049, \xA76a). Same reason as `sys_user_position`: the position path cannot reach `hasPlatformAdminGrant`."
+  },
+  sys_position_permission_set: {
+    role: "reads-only",
+    reason: "Position-bound permission sets (\xA76a). Contributes ids to `psIds` \u2014 and therefore names to `permissions` \u2014 but not to `unscopedUserPsIds`, which is the set \xA76b tests for platform-admin standing."
+  }
+};
+function adminStandingTables() {
+  return Object.entries(ADMIN_STANDING_SURFACE).filter(([, t]) => t.role === "derives").map(([name]) => name).sort();
+}
+function adminStandingColumns(table) {
+  const entry = ADMIN_STANDING_SURFACE[table];
+  return entry?.role === "derives" ? entry.columns : void 0;
+}
+
 // src/security/audience-binding-suggestion-status.ts
 var AUDIENCE_BINDING_SUGGESTION_STATUSES = {
   pending: true,
@@ -4793,10 +5159,26 @@ function calendarPartsInTzOrUtc(d, tz) {
 }
 function zonedDateStartToUtcMs(ymd2, tz) {
   const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(ymd2);
-  const wallAsUtc = m ? Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3])) : NaN;
+  if (!m) return NaN;
+  return zonedWallClockToUtcMs(
+    { year: Number(m[1]), month: Number(m[2]), day: Number(m[3]) },
+    tz
+  );
+}
+function zonedWallClockToUtcMs(parts, tz) {
+  const wallAsUtc = Date.UTC(
+    parts.year,
+    parts.month - 1,
+    parts.day,
+    parts.hour ?? 0,
+    parts.minute ?? 0,
+    parts.second ?? 0,
+    parts.millisecond ?? 0
+  );
   if (!tz || tz === "UTC" || Number.isNaN(wallAsUtc)) return wallAsUtc;
   try {
     const offsetAt = (t) => {
+      const whole = Math.floor(t / 1e3) * 1e3;
       const p = new Intl.DateTimeFormat("en-US", {
         timeZone: tz,
         hourCycle: "h23",
@@ -4806,9 +5188,9 @@ function zonedDateStartToUtcMs(ymd2, tz) {
         hour: "2-digit",
         minute: "2-digit",
         second: "2-digit"
-      }).formatToParts(new Date(t));
+      }).formatToParts(new Date(whole));
       const g = (k) => Number(p.find((x) => x.type === k)?.value);
-      return Date.UTC(g("year"), g("month") - 1, g("day"), g("hour"), g("minute"), g("second")) - t;
+      return Date.UTC(g("year"), g("month") - 1, g("day"), g("hour"), g("minute"), g("second")) - whole;
     };
     const off1 = offsetAt(wallAsUtc - offsetAt(wallAsUtc));
     return wallAsUtc - off1;
@@ -5619,6 +6001,37 @@ function filterTokenContextFrom(execCtx, now) {
   };
 }
 
+// src/utils/temporal-comparand.ts
+var import_data3 = require("@objectstack/spec/data");
+function temporalComparandKind(fieldType) {
+  if (fieldType === "datetime") return "datetime";
+  if (fieldType === "date") return "date";
+  if (fieldType === "time") return "time";
+  return null;
+}
+function readsAsInstant(s) {
+  if (/^-?\d+$/.test(s)) return Number.isFinite(new Date(Number(s)).getTime());
+  const iso = /^\d{4}-\d{2}-\d{2}$/.test(s) ? `${s}T00:00:00.000Z` : /^\d{4}-\d{2}-\d{2}[ T]\d{2}:\d{2}(:\d{2}(\.\d+)?)?$/.test(s) ? `${s.replace(" ", "T")}Z` : s;
+  return Number.isFinite(Date.parse(iso));
+}
+function readsAsCalendarDay(s) {
+  return /^\d{4}-\d{2}-\d{2}/.test(s);
+}
+function readsAsWallClock(s) {
+  const m = /^(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d+))?)?$/.exec(s);
+  if (!m) return false;
+  return Number(m[1]) <= 23 && Number(m[2]) <= 59 && Number(m[3] ?? "0") <= 59;
+}
+function isUninterpretableTemporalComparand(kind, value) {
+  if (typeof value !== "string") return false;
+  const s = value.trim();
+  if (s === "") return false;
+  if ((0, import_data3.classifyFilterToken)(value) !== null) return false;
+  if (kind === "datetime") return !readsAsInstant(s);
+  if (kind === "date") return !readsAsCalendarDay(s);
+  return !(readsAsWallClock(s) || readsAsInstant(s));
+}
+
 // src/utils/record-not-found.ts
 function recordNotFoundError(object, id) {
   const err = new Error(`Record ${id} not found in ${object}`);
@@ -6604,8 +7017,12 @@ var NamespaceResolver = class {
     return `${shortName}_${ns}`;
   }
 };
+
+// src/index.ts
+var import_contracts = require("@objectstack/spec/contracts");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ADMIN_STANDING_SURFACE,
   ANONYMOUS_DENY_BODY,
   ANONYMOUS_DENY_CODE,
   ANONYMOUS_DENY_MESSAGE,
@@ -6641,8 +7058,11 @@ var NamespaceResolver = class {
   SecurePluginContext,
   SemanticVersionManager,
   ServiceLifecycle,
+  UNMATCHED_ROUTE_PATTERN,
   UnknownFilterTokenError,
   UnresolvedFilterTokenError,
+  adminStandingColumns,
+  adminStandingTables,
   assembleExecutionContext,
   assembleExecutionContextOrGuest,
   assertInitServiceRequirements,
@@ -6667,6 +7087,7 @@ var NamespaceResolver = class {
   defaultIsTransientError,
   derivePosture,
   describeInitOrderFault,
+  effectiveTenancyPosture,
   engineCanRollBack,
   evaluateAuthGate,
   extractApiKey,
@@ -6684,6 +7105,8 @@ var NamespaceResolver = class {
   isGrantActive,
   isGrantExpired,
   isNode,
+  isRowActive,
+  isUninterpretableTemporalComparand,
   nextUtcCalendarDay,
   normalizeAuthGate,
   omitInternalFieldsFromWriteResponse,
@@ -6694,6 +7117,7 @@ var NamespaceResolver = class {
   readAuthoredTranslationLayer,
   readRunJournal,
   recordNotFoundError,
+  resolveApiKeyAdmission,
   resolveApiKeyPrincipal,
   resolveAuthzContext,
   resolveFilterToken,
@@ -6707,6 +7131,7 @@ var NamespaceResolver = class {
   safeExit,
   shouldDenyAnonymous,
   signPayload,
+  temporalComparandKind,
   unknownAudienceBindingSuggestionStatusMessage,
   utcInstantMs,
   validateInitServiceContract,
@@ -6717,6 +7142,7 @@ var NamespaceResolver = class {
   wireAuthoredTranslationSync,
   withTransientRetry,
   withoutOperationPrivateKeys,
-  zonedDateStartToUtcMs
+  zonedDateStartToUtcMs,
+  zonedWallClockToUtcMs
 });
 //# sourceMappingURL=index.cjs.map