@harperfast/harper 5.3.0-beta.3 → 5.3.0-beta.4

package/dist/server/threads/windowsProcessTree.js

@@ -0,0 +1,361 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WINDOWS_TREE_POLL_MS = exports.ROOT_SPAWN_ALLOWANCE_MS = void 0;
+exports.queryWindowsProcessTable = queryWindowsProcessTable;
+exports.parseProcessTable = parseProcessTable;
+exports.findWindowsTreeRoot = findWindowsTreeRoot;
+exports.selectWindowsProcessTree = selectWindowsProcessTree;
+exports.taskkillInvocation = taskkillInvocation;
+exports.runTaskkill = runTaskkill;
+exports.confirmWindowsProcessTreeGone = confirmWindowsProcessTreeGone;
+const node_child_process_1 = require("node:child_process");
+const promises_1 = require("node:timers/promises");
+const harperLogger = __importStar(require("../../utility/logging/harper_logger.js"));
+// Date.now() and Win32_Process.CreationDate read the same system clock; this covers its resolution.
+const CLOCK_SKEW_MS = 50;
+// The root is created inside the `spawn` call, so the interval measured around that call is the
+// exact bound on how much earlier than `rootKnownAt` it may have started. This is the fallback for a
+// registration that carried no such interval: a stall between the two — an event loop pause, never
+// a network hop.
+exports.ROOT_SPAWN_ALLOWANCE_MS = 1_000;
+exports.WINDOWS_TREE_POLL_MS = 25;
+const WINDOWS_TREE_POLL_MAX_MS = 5_000;
+const WINDOWS_TREE_WARNING_MS = 5_000;
+const WINDOWS_TREE_WARNING_INTERVAL_MS = 60_000;
+// Neither helper below is allowed to suspend the confirmation loop indefinitely. The loop itself is
+// deliberately deadline-free (harper#2076: the preparation lock is never released on an unconfirmed
+// tree), but that policy is about the DECISION, not about a single syscall: a `Get-CimInstance` or
+// `taskkill` that never returns parks the loop before it can warn, so an operator sees a silent
+// wedge instead of the 60 s "could not be queried" message the unknown state already produces.
+// Bounding each invocation converts a hung helper into that same unknown, which keeps waiting.
+const WINDOWS_TREE_HELPER_TIMEOUT_MS = 30_000;
+// Exit 0 means the query ran and produced a table (possibly empty — an empty table is still a
+// positive result, not "unknown"); exit 2 means the query itself failed (e.g. Get-CimInstance
+// denied or WMI unavailable), which ErrorActionPreference=Stop plus the wrapping try/catch turns
+// into that distinct code instead of a false-empty result, and `queryWindowsProcessTable` reads
+// anything but 0 as "could not read the table" (null), never as "positively found nothing".
+const PROCESS_TABLE_SCRIPT = "$ErrorActionPreference = 'Stop'; try { " +
+    '$rows = @(Get-CimInstance Win32_Process | ForEach-Object { [pscustomobject]@{ ' +
+    'pid = [int]$_.ProcessId; ppid = [int]$_.ParentProcessId; name = [string]$_.Name; ' +
+    'created = if ($_.CreationDate) { [DateTimeOffset]::new($_.CreationDate).ToUnixTimeMilliseconds() } else { $null } } }); ' +
+    '[Console]::Out.Write((ConvertTo-Json -Compress -InputObject $rows)); exit 0 ' +
+    '} catch { exit 2 }';
+function queryWindowsProcessTable(timeoutMs = WINDOWS_TREE_HELPER_TIMEOUT_MS) {
+    return new Promise((resolve) => {
+        const query = (0, node_child_process_1.spawn)('powershell.exe', ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command', PROCESS_TABLE_SCRIPT], {
+            stdio: ['ignore', 'pipe', 'ignore'],
+            windowsHide: true,
+        });
+        let output = '';
+        // utf8 so the decoder buffers a multi-byte character split across a chunk boundary — a
+        // process name has arbitrary Unicode — instead of coercing each half's raw bytes separately
+        query.stdout.setEncoding('utf8');
+        query.stdout.on('data', (chunk) => {
+            output += chunk;
+        });
+        const abandon = setTimeout(() => {
+            query.kill();
+            resolve(null); // unknown, exactly as an unreadable table: the caller keeps waiting
+        }, timeoutMs);
+        abandon.unref?.();
+        const settle = (value) => {
+            clearTimeout(abandon);
+            resolve(value);
+        };
+        query.once('close', (code) => settle(code === 0 ? parseProcessTable(output) : null));
+        query.once('error', () => settle(null));
+    });
+}
+function parseProcessTable(json) {
+    let rows;
+    try {
+        rows = JSON.parse(json.replace(/^\uFEFF/, ''));
+    }
+    catch {
+        return null;
+    }
+    if (rows === null || typeof rows !== 'object')
+        return null;
+    const table = [];
+    for (const row of Array.isArray(rows) ? rows : [rows]) {
+        const { pid, ppid, created, name } = (row ?? {});
+        if (!Number.isInteger(pid) || !Number.isInteger(ppid))
+            return null;
+        table.push({
+            pid: pid,
+            ppid: ppid,
+            created: Number.isFinite(created) ? created : null,
+            name: typeof name === 'string' ? name : undefined,
+        });
+    }
+    return table;
+}
+function findWindowsTreeRoot(table, identity) {
+    if (identity.rootExitedAt !== undefined)
+        return undefined;
+    const root = table.find((process) => process.pid === identity.rootPid);
+    if (!root || root.created === null)
+        return undefined;
+    // Once a scan has pinned the root's exact creation time, a later row at the same PID is ours only
+    // if it matches exactly — same as a remembered descendant (line ~223). Without that pin, a
+    // replacement created within the clock-skew window of `rootKnownAt` would otherwise pass the loose
+    // upper-bound check below, which only rules out a replacement created too late to be ours, not one
+    // created too early (the original having already exited and been recycled inside that window).
+    if (identity.rootCreatedAt !== undefined)
+        return root.created === identity.rootCreatedAt ? root : undefined;
+    if (root.created <= identity.rootKnownAt + CLOCK_SKEW_MS)
+        return root;
+    return undefined;
+}
+/**
+ * The processes in `table` that belong to the tree rooted at `identity.rootPid`. The root counts
+ * only while it still runs and is the process we spawned (created no later than we first knew
+ * it); a child counts only if it was created while its parent lived — after the root's own
+ * creation where that was observed, and before its exit — so nothing that merely inherited a
+ * recycled PID or ParentProcessId is included.
+ */
+function selectWindowsProcessTree(table, identity, now = Date.now()) {
+    const members = [];
+    const seen = new Set();
+    const root = findWindowsTreeRoot(table, identity);
+    // Only reserve the root's PID once it is verified as ours — once the root has exited, a live
+    // descendant that Windows hands that freed PID is a legitimate child of some other frontier
+    // member, and must still be reachable through the frontier walk below.
+    if (root) {
+        seen.add(identity.rootPid);
+        members.push(root);
+    }
+    const rootCreatedAt = root?.created ?? identity.rootCreatedAt;
+    // A row now holding `pid` that could not possibly be the member we are bounding — created after
+    // the latest moment a genuine one could have been — proves the PID was already recycled by then,
+    // tighter than a "gone" conclusion that only arrives once a scan stops observing the member at
+    // all (for a remembered descendant that can be a whole backed-off poll late; for the root, the
+    // scan that first fails to find it still uses this frontier before its exit is stamped —
+    // `confirmWindowsProcessTreeGone` below only latches `rootExitedAt` after this call returns).
+    // `oursNoLaterThan` for a descendant is its exact known creation time; for the root it is the
+    // latest creation `findWindowsTreeRoot` would still have accepted as ours, so a row this cannot
+    // exonerate is never treated as a false impostor of a root we simply haven't re-confirmed yet.
+    const impostorCreatedAt = (pid, oursNoLaterThan) => {
+        const impostor = table.find((process) => process.pid === pid && process.created !== null && process.created > oursNoLaterThan);
+        return impostor?.created;
+    };
+    let frontier = [
+        {
+            pid: identity.rootPid,
+            notBefore: rootCreatedAt === undefined || rootCreatedAt === null
+                ? // our own clock against WMI's, so it carries the skew allowance
+                    identity.rootKnownAt - (identity.rootStartedWithinMs ?? exports.ROOT_SPAWN_ALLOWANCE_MS) - CLOCK_SKEW_MS
+                : // WMI's clock against itself: a process created before the one whose PID it names as its
+                    // parent was created by an earlier holder of that PID, so it is never ours
+                    rootCreatedAt,
+            notAfter: Math.min(
+            // this bound is our own clock against WMI's, so it carries the skew allowance
+            (identity.rootExitedAt ?? now) + CLOCK_SKEW_MS, 
+            // this one is WMI's clock against itself: the replacement's creation time is exactly when
+            // the PID stopped being ours, so anything it went on to create is a stranger's, not ours
+            (impostorCreatedAt(identity.rootPid, rootCreatedAt ?? identity.rootKnownAt + CLOCK_SKEW_MS) ?? Infinity) - 1),
+        },
+    ];
+    // A member an earlier scan found is still one — by PID and creation time — after the parent
+    // that linked it to the root has exited and left no row to walk through; its children are
+    // bounded by its lifetime like any other member's, latched from the scan that first lost it.
+    for (const [pid, known] of identity.descendants ?? []) {
+        if (seen.has(pid))
+            continue;
+        const live = table.find((process) => process.pid === pid && process.created === known.created);
+        if (live) {
+            seen.add(pid);
+            members.push(live);
+            frontier.push({ pid, notBefore: known.created, notAfter: Infinity });
+        }
+        else {
+            frontier.push({
+                pid,
+                notBefore: known.created,
+                notAfter: Math.min((known.exitedAt ?? now) + CLOCK_SKEW_MS, (impostorCreatedAt(pid, known.created) ?? Infinity) - 1),
+            });
+        }
+    }
+    while (frontier.length > 0) {
+        const next = [];
+        for (const parent of frontier) {
+            for (const process of table) {
+                if (process.ppid !== parent.pid || seen.has(process.pid) || process.created === null)
+                    continue;
+                if (process.created < parent.notBefore || process.created > parent.notAfter)
+                    continue;
+                seen.add(process.pid);
+                members.push(process);
+                next.push({ pid: process.pid, notBefore: process.created, notAfter: Infinity });
+            }
+        }
+        frontier = next;
+    }
+    return members;
+}
+// `CreateProcess` rejects a command line over 8191 characters, and the rejection surfaces as a
+// spawn error this module deliberately absorbs — so a tree with enough orphans would be "killed"
+// by a command that never ran, and the wait would never end. At ~11 characters per `/pid NNNNN`
+// this is an order of magnitude inside the limit.
+const TASKKILL_PIDS_PER_INVOCATION = 200;
+/**
+ * The taskkill argument lists that terminate `members`: the whole tree through the root while the
+ * root itself is still ours — never also by descendant PID in the same round, since `/T` frees
+ * those PIDs before a second invocation could run — and otherwise every member by its own PID,
+ * which is safe only because the root's PID is then no longer ours to `/T`. Per-PID kills are
+ * batched, since one command line cannot name an unbounded number of them.
+ */
+function taskkillInvocation(members, rootPid) {
+    if (members.length === 0)
+        return null;
+    if (members.some((member) => member.pid === rootPid))
+        return [['/pid', String(rootPid), '/T', '/F']];
+    const invocations = [];
+    for (let i = 0; i < members.length; i += TASKKILL_PIDS_PER_INVOCATION) {
+        const batch = members.slice(i, i + TASKKILL_PIDS_PER_INVOCATION);
+        invocations.push(['/F', ...batch.flatMap((member) => ['/pid', String(member.pid)])]);
+    }
+    return invocations;
+}
+function runTaskkill(args, timeoutMs = WINDOWS_TREE_HELPER_TIMEOUT_MS) {
+    return new Promise((resolve) => {
+        const taskkill = (0, node_child_process_1.spawn)('taskkill', args, { stdio: 'ignore', windowsHide: true });
+        const abandon = setTimeout(() => {
+            taskkill.kill();
+            resolve(); // the next round reissues it; nothing here reads a kill as proof of anything
+        }, timeoutMs);
+        abandon.unref?.();
+        const settle = () => {
+            clearTimeout(abandon);
+            resolve();
+        };
+        taskkill.once('close', settle);
+        taskkill.once('error', settle);
+    });
+}
+async function killWindowsProcesses(members, rootPid) {
+    for (const args of taskkillInvocation(members, rootPid) ?? [])
+        await runTaskkill(args);
+}
+function rememberDescendants(identity, members, scannedAt, root) {
+    const descendants = (identity.descendants ??= new Map());
+    for (const member of members) {
+        // Skip only the verified root row itself (its lifetime is tracked separately via
+        // rootCreatedAt/rootExitedAt) — not every member sharing its PID number. Once the root has
+        // exited, a live descendant that Windows hands that freed PID is a distinct incarnation,
+        // identified by its own (pid, created) pair, and must be remembered like any other descendant
+        // so a later scan can still find it and its own children.
+        if (member === root || member.created === null)
+            continue;
+        if (descendants.get(member.pid)?.created !== member.created)
+            descendants.set(member.pid, { created: member.created });
+    }
+    for (const [pid, known] of descendants) {
+        if (known.exitedAt !== undefined)
+            continue;
+        if (!members.some((member) => member.pid === pid && member.created === known.created))
+            known.exitedAt = scannedAt;
+    }
+}
+function describeMembers(members) {
+    return members
+        .map((member) => `${member.pid}${member.name ? ` (${member.name})` : ''} created ${member.created === null ? 'unknown' : new Date(member.created).toISOString()}`)
+        .join(', ');
+}
+/**
+ * Terminate every remaining member of the tree and resolve once a scan positively finds none.
+ * There is deliberately no deadline: releasing a component's preparation lock while a descendant
+ * can still mutate its directory is less safe than keeping that deployment wedged for operator
+ * intervention — but the wait is logged, so a wedge names the process holding it, and the poll
+ * backs off so a wedge does not spin the process table query. A scan that cannot read the table
+ * (null) is unknown, not gone, and keeps the wait going.
+ */
+async function confirmWindowsProcessTreeGone(identity, options = {}) {
+    const scan = options.scan ?? queryWindowsProcessTable;
+    const kill = options.kill ?? killWindowsProcesses;
+    const now = options.now ?? Date.now;
+    const warn = options.warn ?? ((message) => harperLogger.warn(message));
+    const maxPollMs = options.maxPollMs ?? WINDOWS_TREE_POLL_MAX_MS;
+    let pollMs = options.pollMs ?? exports.WINDOWS_TREE_POLL_MS;
+    const label = options.label ?? `pid ${identity.rootPid}`;
+    const startedAt = now();
+    let nextWarningAt = startedAt + WINDOWS_TREE_WARNING_MS;
+    for (;;) {
+        const table = await scan();
+        let members = null;
+        let rootIdentityUnknown;
+        if (table !== null) {
+            const scannedAt = now();
+            const root = findWindowsTreeRoot(table, identity);
+            rootIdentityUnknown =
+                identity.rootExitedAt === undefined
+                    ? table.find((process) => process.pid === identity.rootPid && process.created === null)
+                    : undefined;
+            if (rootIdentityUnknown) {
+                members = selectWindowsProcessTree(table, identity, scannedAt).filter((member) => identity.descendants?.get(member.pid)?.created === member.created);
+            }
+            else {
+                if (root && identity.rootCreatedAt === undefined)
+                    identity.rootCreatedAt = root.created;
+                members = selectWindowsProcessTree(table, identity, scannedAt);
+                // The root's PID is reusable the moment it exits, so from the first scan that no longer finds
+                // it running as ours, nothing created later can be its child. Stamped after the scan: the
+                // snapshot may predate the stamp, and a bound that is late keeps waiting, which is the safe
+                // direction. The same goes for every other member.
+                if (!root && identity.rootExitedAt === undefined)
+                    identity.rootExitedAt = scannedAt;
+                rememberDescendants(identity, members, scannedAt, root);
+            }
+        }
+        if (!rootIdentityUnknown && members?.length === 0)
+            return;
+        if (members?.length)
+            await kill(members, identity.rootPid);
+        const time = now();
+        if (time >= nextWarningAt) {
+            warn(`Termination of the process tree of ${label} remains unconfirmed after ${Math.round(time - startedAt)}ms: ` +
+                (rootIdentityUnknown
+                    ? `root pid ${identity.rootPid} is held by ${rootIdentityUnknown.name ?? 'an unnamed process'} without a creation time`
+                    : members
+                        ? `live members ${describeMembers(members)}`
+                        : 'the Windows process table could not be queried'));
+            nextWarningAt = time + WINDOWS_TREE_WARNING_INTERVAL_MS;
+        }
+        await (0, promises_1.setTimeout)(pollMs);
+        pollMs = Math.min(pollMs * 2, maxPollMs);
+    }
+}
+//# sourceMappingURL=windowsProcessTree.js.map

package/dist/server/threads/windowsProcessTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowsProcessTree.js","sourceRoot":"","sources":["../../../server/threads/windowsProcessTree.ts"],"names":[],"mappings":"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"}

package/dist/server/throttle.d.ts

@@ -4,4 +4,4 @@
  * @param onLimitExceeded
  * @param maxQueueTimeLimit
  */
-export declare function throttle(fn: (...args: any) => any, onLimitExceeded?: (...args: any) => any, maxQueueTimeLimit?: number): (...args: any[]) => any;
+export declare function throttle(fn: (...args: any) => any, onLimitExceeded?: (...args: any) => any, maxQueueTimeLimit?: number, name?: string): (...args: any[]) => any;

package/dist/server/throttle.js

@@ -8,6 +8,7 @@ const DEFAULT_MAX_QUEUE_TIME = 20_000; // 20 seconds
 let lastWarning = 0;
 const WARNING_INTERVAL = 30000;
 const EVENT_QUEUE_MONITORING_INTERVAL = 3000;
+const LIMIT_EXCEEDED_LOG_INTERVAL = 5000;
 let lastEventQueueCheck = performance.now() + EVENT_QUEUE_MONITORING_INTERVAL;
 let averageEventCycleTime = 0;
 /**
@@ -16,12 +17,18 @@ let averageEventCycleTime = 0;
  * @param onLimitExceeded
  * @param maxQueueTimeLimit
  */
-function throttle(fn, onLimitExceeded, maxQueueTimeLimit = DEFAULT_MAX_QUEUE_TIME) {
+function throttle(fn, onLimitExceeded, maxQueueTimeLimit = DEFAULT_MAX_QUEUE_TIME, name) {
     let queuedCalls;
+    let lastLimitExceededLog = -Infinity;
     return function (...args) {
         if (queuedCalls) {
             // this is an estimate of the time an event will take to process, based on the average event cycle time and the queue depth
             if (queuedCalls.length * averageEventCycleTime > maxQueueTimeLimit) {
+                const now = performance.now();
+                if (now - lastLimitExceededLog > LIMIT_EXCEEDED_LOG_INTERVAL) {
+                    lastLimitExceededLog = now;
+                    logger_ts_1.logger.warn?.(`Rejecting queued calls${name ? ` (${name})` : ''}: ${queuedCalls.length} already queued at ~${Math.round(averageEventCycleTime)}ms per event cycle, an estimated wait past the ${maxQueueTimeLimit}ms limit`);
+                }
                 return onLimitExceeded(...args);
             }
             return new Promise((resolve, reject) => {

package/dist/server/throttle.js.map

@@ -1 +1 @@
-{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../server/throttle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../server/throttle.ts"],"names":[],"mappings":"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"}

package/dist/upgrade/directives/5-3-0.js

@@ -37,9 +37,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 // 5.3.0 — introduces system.hdb_oidc_trust and system.hdb_oidc_token_use for OIDC trusted
-// publishing (#2171).
+// publishing (#2171), and system.hdb_model_decisions and system.hdb_model_outcomes for durable
+// decisions and their recorded outcomes (#2840).
 //
-// Fresh installs get the table from json/systemSchema.json; this covers existing installs. The
+// Fresh installs get these tables from json/systemSchema.json; this covers existing installs, and the
+// replay table's full shape is also declared on every boot (security/authn/oidc/tokenUseTable.ts). The
 // version must match the release that ships the dependent operations — see 5-1-0.ts for what
 // happens when it does not, and DESIGN.md "System table bootstrap" for the three touchpoints.
 const databases_ts_1 = require("../../resources/databases.js");
@@ -48,50 +50,22 @@ const terms = __importStar(require("../../utility/hdbTerms.js"));
 const initPaths = __importStar(require("../../dataLayer/harperBridge/lmdbBridge/lmdbUtility/initializePaths.js"));
 const harperBridge_ts_1 = __importDefault(require("../../dataLayer/harperBridge/harperBridge.js"));
 const harper_logger_ts_1 = __importDefault(require("../../utility/logging/harper_logger.js"));
+const tokenUseTable_ts_1 = require("../../security/authn/oidc/tokenUseTable.js");
 const OIDC_TRUST_TABLE = terms.SYSTEM_TABLE_NAMES.OIDC_TRUST_TABLE_NAME;
 const OIDC_TOKEN_USE_TABLE = terms.SYSTEM_TABLE_NAMES.OIDC_TOKEN_USE_TABLE_NAME;
+const MODEL_DECISIONS_TABLE = terms.SYSTEM_TABLE_NAMES.MODEL_DECISIONS_TABLE_NAME;
+const MODEL_OUTCOMES_TABLE = terms.SYSTEM_TABLE_NAMES.MODEL_OUTCOMES_TABLE_NAME;
 /**
- * The replay table gets the same bootstrap as the trust table, for a reason specific to it: replay
- * records must replicate, and a node that has never completed an exchange would otherwise not have
- * the table at all when a peer's record arrives. Provisioning it at install/upgrade time removes
- * that question entirely rather than depending on how replication treats a row for an unknown table.
- *
- * Only the primary key is declared here. The `expiresAt` TTL attribute is not expressible through
- * CreateTableObject, so tokenExchange.ts layers it on with an unconditional `table()` call — the
- * same two-step hdb_certificate_cache uses.
- *
- * KNOWN LIMITATION, shared with hdb_certificate_cache rather than specific to this table: that
- * second step runs on the exchange path, so a node that never performs an exchange — the passive
- * members of a cluster, which is most of them when CI always targets one endpoint — has the table
- * from this directive but never registers `expiresAt` locally. Replicated replay rows still land
- * there (that is what `audit: true` buys) but get no eviction, so the table grows on exactly the
- * nodes doing no work. Rows are small and bounded by exchange volume, so this is slow rather than
- * dangerous. Fixing it properly means installing the TTL at system-table setup instead of on first
- * use, which is a change to how every lazily-extended system table is provisioned — worth doing
- * once, for both tables, rather than special-casing this one.
+ * Not skipped when the table exists: the node that upgrades second can already hold a copy its
+ * pre-upgrade replication handshake created from a peer, which carries attribute names but not the
+ * table's expiration.
  */
-async function createHdbOidcTokenUseIfMissing() {
-    if (databases_ts_1.databases.system?.[OIDC_TOKEN_USE_TABLE]) {
-        harper_logger_ts_1.default.info(`system.${OIDC_TOKEN_USE_TABLE} already exists; skipping create.`);
-        await patchIsHashAttribute(OIDC_TOKEN_USE_TABLE);
-        return;
-    }
-    harper_logger_ts_1.default.info(`Creating system.${OIDC_TOKEN_USE_TABLE} table for OIDC replay protection.`);
-    const CreateTableObject = require('../../dataLayer/CreateTableObject').default || require('../../dataLayer/CreateTableObject');
-    const schema = systemSchema_json_1.default[OIDC_TOKEN_USE_TABLE];
-    if (!schema) {
-        throw new Error(`systemSchema.${OIDC_TOKEN_USE_TABLE} is missing; cannot run 5.3.0 directive.`);
+async function declareHdbOidcTokenUse() {
+    if (!databases_ts_1.databases.system?.[OIDC_TOKEN_USE_TABLE]) {
+        harper_logger_ts_1.default.info(`Creating system.${OIDC_TOKEN_USE_TABLE} table for OIDC replay protection.`);
+        initPaths.initSystemSchemaPaths(terms.SYSTEM_SCHEMA_NAME, OIDC_TOKEN_USE_TABLE);
     }
-    initPaths.initSystemSchemaPaths(terms.SYSTEM_SCHEMA_NAME, OIDC_TOKEN_USE_TABLE);
-    const createTable = new CreateTableObject(terms.SYSTEM_SCHEMA_NAME, OIDC_TOKEN_USE_TABLE, schema.hash_attribute);
-    createTable.attributes = schema.attributes;
-    const primaryKeyAttribute = createTable.attributes.find(({ attribute }) => attribute === schema.hash_attribute);
-    if (primaryKeyAttribute)
-        primaryKeyAttribute.isPrimaryKey = true;
-    // Must match `"audit": true` in systemSchema.json — and here auditing is not cosmetic: it is the
-    // replication change feed, without which replay protection would be node-local.
-    createTable.audit = true;
-    await harperBridge_ts_1.default.createTable(OIDC_TOKEN_USE_TABLE, createTable);
+    (0, tokenUseTable_ts_1.declareTokenUseTable)();
     await patchIsHashAttribute(OIDC_TOKEN_USE_TABLE);
 }
 async function createHdbOidcTrustIfMissing() {
@@ -122,9 +96,8 @@ async function createHdbOidcTrustIfMissing() {
  *
  * harperdb@4.x reads is_hash_attribute from __dbis__ to derive the LMDB DBI open flags; without it
  * the DBI is opened with the opposite flags (DUPSORT set) and LMDB throws MDB_INCOMPATIBLE, breaking
- * downgrade — the same guard 5-1-0.ts and 5-2-0.ts apply to their tables. Both tables created here
- * go through the identical CreateTableObject + bridge.createTable path, so both need it; exempting
- * one would be a silent asymmetry rather than a decision. Idempotent: no-op when already set.
+ * downgrade — the same guard 5-1-0.ts and 5-2-0.ts apply to their tables, so every table here gets it.
+ * Idempotent: no-op when already set.
  */
 async function patchIsHashAttribute(tableName) {
     const systemTable = databases_ts_1.databases.system?.[tableName];
@@ -138,11 +111,45 @@ async function patchIsHashAttribute(tableName) {
     await systemTable.dbisDB.put(dbiName, primaryAttr);
     harper_logger_ts_1.default.info(`Patched system.${tableName} __dbis__ entry with is_hash_attribute=true for harperdb@4.x downgrade compatibility.`);
 }
+/** `audit: true` must match systemSchema.json: both decision tables replicate. */
+async function createSystemTableIfMissing(tableName, purpose) {
+    if (databases_ts_1.databases.system?.[tableName]) {
+        harper_logger_ts_1.default.info(`system.${tableName} already exists; skipping create.`);
+        await patchIsHashAttribute(tableName);
+        return;
+    }
+    harper_logger_ts_1.default.info(`Creating system.${tableName} table for ${purpose}.`);
+    const CreateTableObject = require('../../dataLayer/CreateTableObject').default || require('../../dataLayer/CreateTableObject');
+    const schema = systemSchema_json_1.default[tableName];
+    if (!schema) {
+        throw new Error(`systemSchema.${tableName} is missing; cannot run 5.3.0 directive.`);
+    }
+    initPaths.initSystemSchemaPaths(terms.SYSTEM_SCHEMA_NAME, tableName);
+    const createTable = new CreateTableObject(terms.SYSTEM_SCHEMA_NAME, tableName, schema.hash_attribute);
+    createTable.attributes = schema.attributes;
+    const primaryKeyAttribute = createTable.attributes.find(({ attribute }) => attribute === schema.hash_attribute);
+    if (primaryKeyAttribute)
+        primaryKeyAttribute.isPrimaryKey = true;
+    createTable.audit = true;
+    await harperBridge_ts_1.default.createTable(tableName, createTable);
+    await patchIsHashAttribute(tableName);
+}
+async function createHdbModelDecisionsIfMissing() {
+    await createSystemTableIfMissing(MODEL_DECISIONS_TABLE, 'durable model decisions');
+}
+async function createHdbModelOutcomesIfMissing() {
+    await createSystemTableIfMissing(MODEL_OUTCOMES_TABLE, 'recorded decision outcomes');
+}
 const directive530 = {
     version: '5.3.0',
-    description: 'create system.hdb_oidc_trust and system.hdb_oidc_token_use tables for OIDC trusted publishing',
+    description: 'create system.hdb_oidc_trust and system.hdb_oidc_token_use tables for OIDC trusted publishing, and system.hdb_model_decisions and system.hdb_model_outcomes for durable decisions',
     sync_functions: [],
-    async_functions: [createHdbOidcTrustIfMissing, createHdbOidcTokenUseIfMissing],
+    async_functions: [
+        createHdbOidcTrustIfMissing,
+        declareHdbOidcTokenUse,
+        createHdbModelDecisionsIfMissing,
+        createHdbModelOutcomesIfMissing,
+    ],
 };
 exports.default = [directive530];
 //# sourceMappingURL=5-3-0.js.map

package/dist/upgrade/directives/5-3-0.js.map

@@ -1 +1 @@
-{"version":3,"file":"5-3-0.js","sourceRoot":"","sources":["../../../upgrade/directives/5-3-0.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"5-3-0.js","sourceRoot":"","sources":["../../../upgrade/directives/5-3-0.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEb,0FAA0F;AAC1F,+FAA+F;AAC/F,iDAAiD;AACjD,EAAE;AACF,sGAAsG;AACtG,uGAAuG;AACvG,6FAA6F;AAC7F,8FAA8F;AAE9F,+DAAyD;AACzD,qFAAwD;AACxD,iEAAmD;AACnD,kHAAoG;AACpG,mGAAkE;AAClE,8FAA+D;AAC/D,iFAAkF;AAElF,MAAM,gBAAgB,GAAG,KAAK,CAAC,kBAAkB,CAAC,qBAAqB,CAAC;AACxE,MAAM,oBAAoB,GAAG,KAAK,CAAC,kBAAkB,CAAC,yBAAyB,CAAC;AAChF,MAAM,qBAAqB,GAAG,KAAK,CAAC,kBAAkB,CAAC,0BAA0B,CAAC;AAClF,MAAM,oBAAoB,GAAG,KAAK,CAAC,kBAAkB,CAAC,yBAAyB,CAAC;AAEhF;;;;GAIG;AACH,KAAK,UAAU,sBAAsB;IACpC,IAAI,CAAC,wBAAS,CAAC,MAAM,EAAE,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC/C,0BAAS,CAAC,IAAI,CAAC,mBAAmB,oBAAoB,oCAAoC,CAAC,CAAC;QAC5F,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;IACjF,CAAC;IACD,IAAA,uCAAoB,GAAE,CAAC;IACvB,MAAM,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;AAClD,CAAC;AAED,KAAK,UAAU,2BAA2B;IACzC,IAAI,wBAAS,CAAC,MAAM,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC1C,0BAAS,CAAC,IAAI,CAAC,UAAU,gBAAgB,mCAAmC,CAAC,CAAC;QAC9E,MAAM,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;QAC7C,OAAO;IACR,CAAC;IAED,0BAAS,CAAC,IAAI,CAAC,mBAAmB,gBAAgB,qCAAqC,CAAC,CAAC;IAEzF,MAAM,iBAAiB,GACtB,OAAO,CAAC,mCAAmC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,mCAAmC,CAAC,CAAC;IACtG,MAAM,MAAM,GAAI,2BAAoB,CAAC,gBAAgB,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gBAAgB,gBAAgB,0CAA0C,CAAC,CAAC;IAC7F,CAAC;IAED,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,IAAK,iBAAyB,CAAC,KAAK,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IACtH,WAAW,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAC3C,MAAM,mBAAmB,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,KAAK,MAAM,CAAC,cAAc,CAAC,CAAC;IAChH,IAAI,mBAAmB;QAAE,mBAAmB,CAAC,YAAY,GAAG,IAAI,CAAC;IACjE,mGAAmG;IACnG,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC;IAEzB,MAAM,yBAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,WAAW,GAAI,wBAAiB,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3D,IAAI,CAAC,WAAW,EAAE,MAAM;QAAE,OAAO;IAEjC,MAAM,OAAO,GAAG,GAAG,SAAS,GAAG,CAAC;IAChC,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,iBAAiB;QAAE,OAAO,CAAC,kBAAkB;IAE7E,WAAW,CAAC,iBAAiB,GAAG,IAAI,CAAC;IACrC,MAAM,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACnD,0BAAS,CAAC,IAAI,CACb,kBAAkB,SAAS,uFAAuF,CAClH,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,KAAK,UAAU,0BAA0B,CAAC,SAAiB,EAAE,OAAe;IAC3E,IAAI,wBAAS,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,0BAAS,CAAC,IAAI,CAAC,UAAU,SAAS,mCAAmC,CAAC,CAAC;QACvE,MAAM,oBAAoB,CAAC,SAAS,CAAC,CAAC;QACtC,OAAO;IACR,CAAC;IAED,0BAAS,CAAC,IAAI,CAAC,mBAAmB,SAAS,cAAc,OAAO,GAAG,CAAC,CAAC;IAErE,MAAM,iBAAiB,GACtB,OAAO,CAAC,mCAAmC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,mCAAmC,CAAC,CAAC;IACtG,MAAM,MAAM,GAAI,2BAAoB,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gBAAgB,SAAS,0CAA0C,CAAC,CAAC;IACtF,CAAC;IAED,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;IACrE,MAAM,WAAW,GAAG,IAAK,iBAAyB,CAAC,KAAK,CAAC,kBAAkB,EAAE,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAC/G,WAAW,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAC3C,MAAM,mBAAmB,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,KAAK,MAAM,CAAC,cAAc,CAAC,CAAC;IAChH,IAAI,mBAAmB;QAAE,mBAAmB,CAAC,YAAY,GAAG,IAAI,CAAC;IACjE,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC;IAEzB,MAAM,yBAAM,CAAC,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACjD,MAAM,oBAAoB,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,gCAAgC;IAC9C,MAAM,0BAA0B,CAAC,qBAAqB,EAAE,yBAAyB,CAAC,CAAC;AACpF,CAAC;AAED,KAAK,UAAU,+BAA+B;IAC7C,MAAM,0BAA0B,CAAC,oBAAoB,EAAE,4BAA4B,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,YAAY,GAAG;IACpB,OAAO,EAAE,OAAO;IAChB,WAAW,EACV,mLAAmL;IACpL,cAAc,EAAE,EAA0B;IAC1C,eAAe,EAAE;QAChB,2BAA2B;QAC3B,sBAAsB;QACtB,gCAAgC;QAChC,+BAA+B;KACE;CAClC,CAAC;AAEF,kBAAe,CAAC,YAAY,CAAC,CAAC"}

package/dist/utility/errors/hdbError.d.ts

@@ -11,7 +11,7 @@ export declare class HdbError extends Error {
     logLevel: string;
     /**
      * @param {Error} errOrig -  Error to be translated into HdbError. If manually throwing an error, pass `new Error()` to ensure stack trace is maintained
-     * @param {String} [httpMsg] - optional -  response message that will be returned via the API
+     * @param {String|Object} [httpMsg] - optional -  response message that will be returned via the API
      * @param {Number} [httpCode] - optional -  response status code that will be returned via the API
      * @param {String} [logLevel] - optional -  log level that will be used for logging of this error
      * @param {String} [logMsg] - optional - log message that, if provided, will be logged at the `logLevel` above
@@ -32,6 +32,15 @@ export declare class DerivedIndexLagError extends ServerError {
     retryable: boolean;
     constructor(message: string);
 }
+/** Retryable admission failure while a database is draining writes for close, restore, or drop. */
+export declare class DatabaseClosingError extends ServerError {
+    code: string;
+    retryable: boolean;
+    constructor(databaseName: string, retryable?: boolean);
+}
+export declare class DatabaseDrainTimeoutError extends DatabaseClosingError {
+    constructor(databaseName: string, timeoutMilliseconds: number);
+}
 /**
  * Thrown when a query targets an attribute whose secondary index is still being (re)built. It is a
  * distinct, retryable 503 so callers can tell a transient "index rebuilding" condition apart from a