@skillsmith/core 0.11.4 → 0.11.6

package/dist/src/config/owned-lock.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Unit tests for the two-level owned-lock primitive (SMI-5883 §8a).
+ * @module @skillsmith/core/config/owned-lock.test
+ *
+ * Single-process tests of `acquireOwnedLock` itself. Cross-process tests
+ * (the reclaim-race proof, the orphaned-reclaim-lock residual, and the
+ * end-to-end lost-update stress test) live in
+ * `packages/core/tests/integration/owned-lock-reclaim-race.test.ts` (§8b/8c)
+ * and `packages/core/tests/integration/owned-lock-lost-update.test.ts` (§8f).
+ */
+export {};
+//# sourceMappingURL=owned-lock.test.d.ts.map

package/dist/src/config/owned-lock.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-lock.test.d.ts","sourceRoot":"","sources":["../../../src/config/owned-lock.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/src/config/owned-lock.test.js

@@ -0,0 +1,412 @@
+/**
+ * Unit tests for the two-level owned-lock primitive (SMI-5883 §8a).
+ * @module @skillsmith/core/config/owned-lock.test
+ *
+ * Single-process tests of `acquireOwnedLock` itself. Cross-process tests
+ * (the reclaim-race proof, the orphaned-reclaim-lock residual, and the
+ * end-to-end lost-update stress test) live in
+ * `packages/core/tests/integration/owned-lock-reclaim-race.test.ts` (§8b/8c)
+ * and `packages/core/tests/integration/owned-lock-lost-update.test.ts` (§8f).
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { hostname } from 'node:os';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { acquireOwnedLock, StuckLockError } from './owned-lock.js';
+import { createLockExclusive } from './owned-lock.claim.js';
+import { mintDeadPid } from '../../tests/helpers/deterministic-dead-pid.js';
+let dir;
+let target;
+let lockPath;
+let reclaimPath;
+beforeEach(() => {
+    dir =
+        os.tmpdir() + path.sep + `owned-lock-test-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    mkdirSync(dir, { recursive: true });
+    target = path.join(dir, 'store.json');
+    lockPath = `${target}.lock`;
+    reclaimPath = `${lockPath}.reclaim`;
+});
+afterEach(() => {
+    rmSync(dir, { recursive: true, force: true });
+});
+function seed(content, at = lockPath) {
+    writeFileSync(at, content);
+}
+function v1(pid, opts = {}) {
+    return (JSON.stringify({
+        v: 1,
+        pid,
+        token: opts.token ?? 'a'.repeat(16),
+        host: opts.host ?? hostname(),
+        acquiredAt: opts.acquiredAt ?? Date.now(),
+    }) + '\n');
+}
+describe('acquireOwnedLock', () => {
+    it('1. acquire on a free path succeeds; the lock file is 0600, v1, this pid/host, 16-hex token', () => {
+        const release = acquireOwnedLock(target, { timeoutMs: 1_000 });
+        const raw = readFileSync(lockPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        expect(parsed.v).toBe(1);
+        expect(parsed.pid).toBe(process.pid);
+        expect(parsed.host).toBe(hostname());
+        expect(/^[0-9a-f]{16}$/.test(parsed.token)).toBe(true);
+        release();
+    });
+    it('2. a second acquire while held times out with reason held; the lock file is byte-identical afterwards', () => {
+        const release = acquireOwnedLock(target, { timeoutMs: 5_000 });
+        const before = readFileSync(lockPath);
+        try {
+            let caught;
+            try {
+                acquireOwnedLock(target, { timeoutMs: 200 });
+            }
+            catch (err) {
+                caught = err;
+            }
+            expect(caught).toBeInstanceOf(StuckLockError);
+            expect(caught?.reason).toBe('held');
+            expect(readFileSync(lockPath).equals(before)).toBe(true);
+        }
+        finally {
+            release();
+        }
+    });
+    it('3. release removes the lock; a subsequent acquire succeeds immediately', () => {
+        const release = acquireOwnedLock(target, { timeoutMs: 1_000 });
+        release();
+        expect(existsSync(lockPath)).toBe(false);
+        const release2 = acquireOwnedLock(target, { timeoutMs: 200 });
+        release2();
+    });
+    it('4. release is idempotent — a second call neither throws nor unlinks', () => {
+        const release = acquireOwnedLock(target, { timeoutMs: 1_000 });
+        release();
+        expect(() => release()).not.toThrow();
+    });
+    it('5. ownership-verified release: a foreign token in the lock file is never unlinked', () => {
+        const release = acquireOwnedLock(target, { timeoutMs: 1_000 });
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+        // Overwrite the lock file out-of-band with a DIFFERENT v1 token.
+        seed(v1(process.pid, { token: 'f'.repeat(16) }));
+        release();
+        expect(existsSync(lockPath)).toBe(true);
+        expect(JSON.parse(readFileSync(lockPath, 'utf-8')).token).toBe('f'.repeat(16));
+        expect(warnSpy.mock.calls.some((c) => String(c[0]).includes('lock_release_not_owner'))).toBe(true);
+        warnSpy.mockRestore();
+        rmSync(lockPath);
+    });
+    it('6. v1 dead-PID reclaim: acquire succeeds well inside a tight budget; the reclaim lock is gone afterwards', () => {
+        const deadPid = mintDeadPid();
+        seed(v1(deadPid));
+        const start = Date.now();
+        const release = acquireOwnedLock(target, { timeoutMs: 5_000, reclaimProbeAfterMs: 0 });
+        expect(Date.now() - start).toBeLessThan(2_000);
+        expect(existsSync(reclaimPath)).toBe(false);
+        release();
+    });
+    it('7. v1 live-PID refusal: times out, reason held, file byte-identical', () => {
+        seed(v1(process.pid));
+        const before = readFileSync(lockPath);
+        let caught;
+        try {
+            acquireOwnedLock(target, { timeoutMs: 200, reclaimProbeAfterMs: 0 });
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught?.reason).toBe('held');
+        expect(readFileSync(lockPath).equals(before)).toBe(true);
+    });
+    it('H-11: a live-PID lock with a 10-minute-old acquiredAt still times out (age is irrelevant, D-2 regression test)', () => {
+        seed(v1(process.pid, { acquiredAt: Date.now() - 10 * 60 * 1000 }));
+        const before = readFileSync(lockPath);
+        let caught;
+        try {
+            acquireOwnedLock(target, { timeoutMs: 200, reclaimProbeAfterMs: 0 });
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(StuckLockError);
+        expect(caught?.message).toContain(String(process.pid));
+        expect(caught?.message).toContain(hostname());
+        expect(readFileSync(lockPath).equals(before)).toBe(true);
+    });
+    it('8. EPERM from the liveness probe counts as alive — no reclaim, timeout', () => {
+        const deadPid = mintDeadPid(); // would otherwise be reclaimed
+        seed(v1(deadPid));
+        const killProbe = () => {
+            const err = new Error('EPERM');
+            err.code = 'EPERM';
+            throw err;
+        };
+        let caught;
+        try {
+            // The kill-probe override is threaded via the internal claim module in
+            // production; here we assert behaviourally via the public surface by
+            // making `process.kill` itself throw EPERM for this one PID.
+            const spy = vi.spyOn(process, 'kill').mockImplementation((pid) => {
+                if (pid === deadPid)
+                    return killProbe();
+                return true;
+            });
+            try {
+                acquireOwnedLock(target, { timeoutMs: 200, reclaimProbeAfterMs: 0 });
+            }
+            catch (err) {
+                caught = err;
+            }
+            finally {
+                spy.mockRestore();
+            }
+        }
+        finally {
+            /* no-op */
+        }
+        expect(caught?.reason).toBe('held');
+    });
+    it('9. pid <= 0 rejected without probing (kill(0,0) would signal the process group)', () => {
+        for (const pid of [0, -1]) {
+            rmSync(lockPath, { force: true });
+            seed(v1(pid));
+            const spy = vi.spyOn(process, 'kill').mockImplementation(() => true);
+            let caught;
+            try {
+                acquireOwnedLock(target, { timeoutMs: 150, reclaimProbeAfterMs: 0 });
+            }
+            catch (err) {
+                caught = err;
+            }
+            expect(caught?.reason).toBe('held');
+            expect(spy).not.toHaveBeenCalled();
+            spy.mockRestore();
+        }
+    });
+    it('10. host mismatch: a dead PID on another host is never reclaimed', () => {
+        const deadPid = mintDeadPid();
+        seed(v1(deadPid, { host: 'some-other-host' }));
+        const before = readFileSync(lockPath);
+        let caught;
+        try {
+            acquireOwnedLock(target, { timeoutMs: 200, reclaimProbeAfterMs: 0 });
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught?.reason).toBe('held');
+        expect(readFileSync(lockPath).equals(before)).toBe(true);
+    });
+    it('11. unparseable claims (empty / truncated / garbage / wrong version) refuse with a byte-identical file (H-13 a-d)', () => {
+        const deadPid = mintDeadPid();
+        const cases = [
+            '', // (c) empty
+            '{"v":1,"pid":', // (c) truncated
+            'not json at all {{{', // (b) garbage bytes
+            JSON.stringify({
+                v: 2,
+                pid: deadPid,
+                token: 'a'.repeat(16),
+                host: hostname(),
+                acquiredAt: Date.now(),
+            }), // (d) valid JSON, wrong version -- never auto-reclaimed even with a genuinely dead PID
+        ];
+        for (const content of cases) {
+            rmSync(lockPath, { force: true });
+            seed(content);
+            const before = readFileSync(lockPath);
+            let caught;
+            try {
+                acquireOwnedLock(target, { timeoutMs: 150, reclaimProbeAfterMs: 0 });
+            }
+            catch (err) {
+                caught = err;
+            }
+            expect(caught?.reason, `content: ${JSON.stringify(content)}`).toBe('unreclaimable_unparseable');
+            expect(readFileSync(lockPath).equals(before)).toBe(true);
+        }
+    });
+    it('12. legacy refusal, dead PID (D-5): a bare minted-dead PID is never reclaimed', () => {
+        const deadPid = mintDeadPid();
+        seed(String(deadPid));
+        const before = readFileSync(lockPath);
+        let caught;
+        try {
+            acquireOwnedLock(target, { timeoutMs: 150, reclaimProbeAfterMs: 0 });
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught?.reason).toBe('unreclaimable_legacy');
+        expect(readFileSync(lockPath).equals(before)).toBe(true);
+    });
+    it('13. SKILLSMITH_LOCK_NO_AUTO_RECLAIM=1: a v1 dead-PID lock is not reclaimed; reason reclaim_disabled', () => {
+        const deadPid = mintDeadPid();
+        seed(v1(deadPid));
+        process.env['SKILLSMITH_LOCK_NO_AUTO_RECLAIM'] = '1';
+        let caught;
+        try {
+            acquireOwnedLock(target, { timeoutMs: 150, reclaimProbeAfterMs: 0 });
+        }
+        catch (err) {
+            caught = err;
+        }
+        finally {
+            delete process.env['SKILLSMITH_LOCK_NO_AUTO_RECLAIM'];
+        }
+        expect(caught?.reason).toBe('reclaim_disabled');
+    });
+    it('14. hardlink-unavailable (R2 branch): a linkSync throwing ENOSYS fails CLOSED, no lock file left behind', () => {
+        // SMI-5883 code-review round 1 finding 1: the original fallback
+        // (openSync('wx') + a separate writeFileSync) was NOT content-complete --
+        // a crash or observer between those two steps would see an empty/
+        // truncated lock file, which is then PERMANENTLY unreclaimable (an
+        // `unparseable` claim is never auto-reclaimed by design). Fixed by
+        // failing closed instead: a filesystem without hardlink support cannot
+        // provide the atomic-and-content-complete creation this primitive
+        // requires, so `createLockExclusive` now throws rather than falling back.
+        const enosys = () => {
+            const err = new Error('ENOSYS');
+            err.code = 'ENOSYS';
+            throw err;
+        };
+        // Exercised directly against createLockExclusive (owned-lock.claim.ts) --
+        // the internal primitive this test targets -- rather than through the
+        // public acquireOwnedLock(), which no longer accepts a linkSyncOverride.
+        expect(() => createLockExclusive(lockPath, '{"v":1}\n', enosys)).toThrow(/does not support hardlinks/);
+        expect(existsSync(lockPath)).toBe(false);
+        // No stray temp file left behind either.
+        expect(readdirSync(dir).some((f) => f.endsWith('.tmp'))).toBe(false);
+    });
+    it('15. no litter: after acquire/release cycles above, the directory holds no *.tmp and no *.reclaim', () => {
+        const release = acquireOwnedLock(target, { timeoutMs: 1_000 });
+        release();
+        const entries = readdirSync(dir);
+        expect(entries.some((f) => f.endsWith('.tmp'))).toBe(false);
+        expect(entries.some((f) => f.endsWith('.reclaim'))).toBe(false);
+    });
+    it('16. public acquireOwnedLock() strips injected unsafe properties before reaching the core loop (SMI-5883 code-review round 2)', async () => {
+        // Round 2 finding: TypeScript's excess-property check only fires on an
+        // object LITERAL passed directly at the call site -- a caller passing a
+        // variable (or a plain-JavaScript caller with no type checking at all)
+        // is NOT constrained by AcquireOwnedLockOptions omitting the two unsafe
+        // fields, and the core loop reads them by property name at runtime.
+        // owned-lock.ts's public acquireOwnedLock() must therefore reconstruct a
+        // FRESH, allowlisted object rather than forward `opts` as-is. Verified
+        // here by spying on the core loop itself and asserting neither unsafe
+        // key ever reaches it, regardless of what the caller injects.
+        const acquireModule = await import('./owned-lock.acquire.js');
+        const spy = vi.spyOn(acquireModule, 'acquireOwnedLockCore');
+        const maliciousOpts = {
+            timeoutMs: 1_000,
+            unsafeSkipReclaimRevalidation: true,
+            linkSyncOverride: () => {
+                throw new Error('should never be called -- injected via a non-literal cast');
+            },
+        };
+        const release = acquireOwnedLock(target, maliciousOpts);
+        release();
+        expect(spy).toHaveBeenCalledTimes(1);
+        const forwarded = spy.mock.calls[0]?.[1];
+        // Round 3: the reconstructed object sets both unsafe fields to an
+        // explicit OWN `undefined` (to shadow a polluted Object.prototype --
+        // see item 17), so the property now exists but must never be truthy /
+        // never be the injected function.
+        expect(forwarded?.unsafeSkipReclaimRevalidation).toBeUndefined();
+        expect(forwarded?.linkSyncOverride).toBeUndefined();
+        spy.mockRestore();
+    });
+    it('17. public acquireOwnedLock() is immune to a globally-polluted Object.prototype (SMI-5883 code-review round 3)', async () => {
+        // Round 3 finding: a plain `{ ...safeFields }` reconstruction still
+        // inherits from Object.prototype -- if that prototype were ever globally
+        // polluted (a distinct, severe vulnerability class in its own right,
+        // reachable only by an attacker who already has arbitrary code execution
+        // in this process), ordinary property access on an object with no OWN
+        // `unsafeSkipReclaimRevalidation`/`linkSyncOverride` would still resolve
+        // them via the prototype chain. Fixed by explicitly setting both to
+        // `undefined` as OWN properties, which shadows any inherited value.
+        // Always restored in `finally` -- this is global, shared mutable state.
+        // Round 4 (test-hygiene finding): restore the ORIGINAL descriptors
+        // (undefined if the key was absent beforehand) rather than unconditionally
+        // deleting -- unconditional delete would be wrong if either key somehow
+        // already had a legitimate descriptor on Object.prototype before this test.
+        const acquireModule = await import('./owned-lock.acquire.js');
+        const spy = vi.spyOn(acquireModule, 'acquireOwnedLockCore');
+        const pollutedLinkSync = () => {
+            throw new Error('should never be called -- reached via Object.prototype pollution');
+        };
+        const origUnsafeSkip = Object.getOwnPropertyDescriptor(Object.prototype, 'unsafeSkipReclaimRevalidation');
+        const origLinkSync = Object.getOwnPropertyDescriptor(Object.prototype, 'linkSyncOverride');
+        try {
+            ;
+            Object.prototype['unsafeSkipReclaimRevalidation'] = true;
+            Object.prototype['linkSyncOverride'] = pollutedLinkSync;
+            const release = acquireOwnedLock(target, { timeoutMs: 1_000 });
+            release();
+            expect(spy).toHaveBeenCalledTimes(1);
+            const forwarded = spy.mock.calls[0]?.[1];
+            expect(forwarded?.unsafeSkipReclaimRevalidation).toBeUndefined();
+            expect(forwarded?.linkSyncOverride).toBeUndefined();
+        }
+        finally {
+            if (origUnsafeSkip) {
+                Object.defineProperty(Object.prototype, 'unsafeSkipReclaimRevalidation', origUnsafeSkip);
+            }
+            else {
+                delete Object.prototype['unsafeSkipReclaimRevalidation'];
+            }
+            if (origLinkSync) {
+                Object.defineProperty(Object.prototype, 'linkSyncOverride', origLinkSync);
+            }
+            else {
+                delete Object.prototype['linkSyncOverride'];
+            }
+            spy.mockRestore();
+        }
+    });
+});
+// ---------------------------------------------------------------------------
+// §8c — orphaned reclaim lock (residual R1). Single-process: the "orphan" is
+// simulated by hand-planting a live-owner reclaim-lock file, not by a real
+// crash — the assertions are about R1's documented BLAST RADIUS (auto-reclaim
+// disabled, locking itself unaffected), not about producing a real orphan.
+// ---------------------------------------------------------------------------
+describe('orphaned reclaim lock (residual R1, §8c)', () => {
+    it('1. a pre-existing (live-owner) reclaim lock blocks reclaim of a genuinely dead-PID main lock', () => {
+        const deadPid = mintDeadPid();
+        seed(v1(deadPid), lockPath);
+        seed(v1(process.pid), reclaimPath); // "orphan" stand-in: live-owner reclaim lock
+        const beforeLock = readFileSync(lockPath);
+        const beforeReclaim = readFileSync(reclaimPath);
+        let caught;
+        try {
+            acquireOwnedLock(target, { timeoutMs: 800, reclaimProbeAfterMs: 0 });
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(StuckLockError);
+        expect(caught?.reason).toBe('reclaim_unavailable');
+        expect(caught?.message).toContain(lockPath);
+        expect(caught?.message).toContain(reclaimPath);
+        expect(caught?.message.toLowerCase()).toContain('manual unstick');
+        expect(readFileSync(lockPath).equals(beforeLock)).toBe(true);
+        expect(readFileSync(reclaimPath).equals(beforeReclaim)).toBe(true);
+    });
+    it('2. with no main lock present, acquisition succeeds despite an orphaned reclaim lock (locking unaffected)', () => {
+        seed(v1(process.pid), reclaimPath); // orphan stand-in; no `.lock` file exists
+        const release = acquireOwnedLock(target, { timeoutMs: 1_000 });
+        release();
+    });
+    it('3. removing the orphan restores service — the dead-PID lock reclaims normally afterward', () => {
+        const deadPid = mintDeadPid();
+        seed(v1(deadPid), lockPath);
+        seed(v1(process.pid), reclaimPath);
+        rmSync(reclaimPath); // the documented manual unstick
+        const release = acquireOwnedLock(target, { timeoutMs: 2_000, reclaimProbeAfterMs: 0 });
+        expect(existsSync(reclaimPath)).toBe(false);
+        release();
+    });
+});
+//# sourceMappingURL=owned-lock.test.js.map

package/dist/src/config/owned-lock.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-lock.test.js","sourceRoot":"","sources":["../../../src/config/owned-lock.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACxE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAClC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAE7B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAA;AAE3E,IAAI,GAAW,CAAA;AACf,IAAI,MAAc,CAAA;AAClB,IAAI,QAAgB,CAAA;AACpB,IAAI,WAAmB,CAAA;AAEvB,UAAU,CAAC,GAAG,EAAE;IACd,GAAG;QACD,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,mBAAmB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IACjG,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;IACrC,QAAQ,GAAG,GAAG,MAAM,OAAO,CAAA;IAC3B,WAAW,GAAG,GAAG,QAAQ,UAAU,CAAA;AACrC,CAAC,CAAC,CAAA;AACF,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AAC/C,CAAC,CAAC,CAAA;AAEF,SAAS,IAAI,CAAC,OAAe,EAAE,KAAa,QAAQ;IAClD,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;AAC5B,CAAC;AAED,SAAS,EAAE,CACT,GAAW,EACX,OAAqE,EAAE;IAEvE,OAAO,CACL,IAAI,CAAC,SAAS,CAAC;QACb,CAAC,EAAE,CAAC;QACJ,GAAG;QACH,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ,EAAE;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE;KAC1C,CAAC,GAAG,IAAI,CACV,CAAA;AACH,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,4FAA4F,EAAE,GAAG,EAAE;QACpG,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9D,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4D,CAAA;QACzF,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACpC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;QACpC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACtD,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uGAAuG,EAAE,GAAG,EAAE;QAC/G,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9D,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;QACrC,IAAI,CAAC;YACH,IAAI,MAAkC,CAAA;YACtC,IAAI,CAAC;gBACH,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAA;YAC9C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAqB,CAAA;YAChC,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAA;YAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACnC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1D,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9D,OAAO,EAAE,CAAA;QACT,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAA;QAC7D,QAAQ,EAAE,CAAA;IACZ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9D,OAAO,EAAE,CAAA;QACT,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QAC3F,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9D,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAC7E,iEAAiE;QACjE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QAChD,OAAO,EAAE,CAAA;QACT,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;QAC9E,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,IAAI,CAC1F,IAAI,CACL,CAAA;QACD,OAAO,CAAC,WAAW,EAAE,CAAA;QACrB,MAAM,CAAC,QAAQ,CAAC,CAAA;IAClB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0GAA0G,EAAE,GAAG,EAAE;QAClH,MAAM,OAAO,GAAG,WAAW,EAAE,CAAA;QAC7B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACxB,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAA;QACtF,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;QAC9C,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3C,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;QACrB,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;QACrC,IAAI,MAAkC,CAAA;QACtC,IAAI,CAAC;YACH,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAA;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAqB,CAAA;QAChC,CAAC;QACD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACnC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gHAAgH,EAAE,GAAG,EAAE;QACxH,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAA;QAClE,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;QACrC,IAAI,MAAkC,CAAA;QACtC,IAAI,CAAC;YACH,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAA;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAqB,CAAA;QAChC,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;QACtD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC7C,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,OAAO,GAAG,WAAW,EAAE,CAAA,CAAC,+BAA+B;QAC7D,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;QACjB,MAAM,SAAS,GAAG,GAAU,EAAE;YAC5B,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,OAAO,CAA0B,CAAA;YACvD,GAAG,CAAC,IAAI,GAAG,OAAO,CAAA;YAClB,MAAM,GAAG,CAAA;QACX,CAAC,CAAA;QACD,IAAI,MAAkC,CAAA;QACtC,IAAI,CAAC;YACH,uEAAuE;YACvE,qEAAqE;YACrE,6DAA6D;YAC7D,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC/D,IAAI,GAAG,KAAK,OAAO;oBAAE,OAAO,SAAS,EAAE,CAAA;gBACvC,OAAO,IAAI,CAAA;YACb,CAAC,CAAC,CAAA;YACF,IAAI,CAAC;gBACH,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAA;YACtE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAqB,CAAA;YAChC,CAAC;oBAAS,CAAC;gBACT,GAAG,CAAC,WAAW,EAAE,CAAA;YACnB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,WAAW;QACb,CAAC;QACD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YACjC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YACb,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;YACpE,IAAI,MAAkC,CAAA;YACtC,IAAI,CAAC;gBACH,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAA;YACtE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAqB,CAAA;YAChC,CAAC;YACD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACnC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;YAClC,GAAG,CAAC,WAAW,EAAE,CAAA;QACnB,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,OAAO,GAAG,WAAW,EAAE,CAAA;QAC7B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAA;QAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;QACrC,IAAI,MAAkC,CAAA;QACtC,IAAI,CAAC;YACH,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAA;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAqB,CAAA;QAChC,CAAC;QACD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACnC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mHAAmH,EAAE,GAAG,EAAE;QAC3H,MAAM,OAAO,GAAG,WAAW,EAAE,CAAA;QAC7B,MAAM,KAAK,GAAG;YACZ,EAAE,EAAE,YAAY;YAChB,eAAe,EAAE,gBAAgB;YACjC,qBAAqB,EAAE,oBAAoB;YAC3C,IAAI,CAAC,SAAS,CAAC;gBACb,CAAC,EAAE,CAAC;gBACJ,GAAG,EAAE,OAAO;gBACZ,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrB,IAAI,EAAE,QAAQ,EAAE;gBAChB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;aACvB,CAAC,EAAE,uFAAuF;SAC5F,CAAA;QACD,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YACjC,IAAI,CAAC,OAAO,CAAC,CAAA;YACb,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,IAAI,MAAkC,CAAA;YACtC,IAAI,CAAC;gBACH,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAA;YACtE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAqB,CAAA;YAChC,CAAC;YACD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAChE,2BAA2B,CAC5B,CAAA;YACD,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,MAAM,OAAO,GAAG,WAAW,EAAE,CAAA;QAC7B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;QACrB,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;QACrC,IAAI,MAAkC,CAAA;QACtC,IAAI,CAAC;YACH,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAA;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAqB,CAAA;QAChC,CAAC;QACD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QACnD,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qGAAqG,EAAE,GAAG,EAAE;QAC7G,MAAM,OAAO,GAAG,WAAW,EAAE,CAAA;QAC7B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;QACjB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,GAAG,GAAG,CAAA;QACpD,IAAI,MAAkC,CAAA;QACtC,IAAI,CAAC;YACH,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAA;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAqB,CAAA;QAChC,CAAC;gBAAS,CAAC;YACT,OAAO,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAA;QACvD,CAAC;QACD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yGAAyG,EAAE,GAAG,EAAE;QACjH,gEAAgE;QAChE,0EAA0E;QAC1E,kEAAkE;QAClE,mEAAmE;QACnE,mEAAmE;QACnE,uEAAuE;QACvE,kEAAkE;QAClE,0EAA0E;QAC1E,MAAM,MAAM,GAAG,GAAU,EAAE;YACzB,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,QAAQ,CAA0B,CAAA;YACxD,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAA;YACnB,MAAM,GAAG,CAAA;QACX,CAAC,CAAA;QACD,0EAA0E;QAC1E,sEAAsE;QACtE,yEAAyE;QACzE,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CACtE,4BAA4B,CAC7B,CAAA;QACD,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxC,yCAAyC;QACzC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kGAAkG,EAAE,GAAG,EAAE;QAC1G,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9D,OAAO,EAAE,CAAA;QACT,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;QAChC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8HAA8H,EAAE,KAAK,IAAI,EAAE;QAC5I,uEAAuE;QACvE,wEAAwE;QACxE,uEAAuE;QACvE,wEAAwE;QACxE,oEAAoE;QACpE,yEAAyE;QACzE,uEAAuE;QACvE,sEAAsE;QACtE,8DAA8D;QAC9D,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAA;QAC7D,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAA;QAC3D,MAAM,aAAa,GAAG;YACpB,SAAS,EAAE,KAAK;YAChB,6BAA6B,EAAE,IAAI;YACnC,gBAAgB,EAAE,GAAG,EAAE;gBACrB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;YAC9E,CAAC;SACmD,CAAA;QAEtD,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;QACvD,OAAO,EAAE,CAAA;QAET,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACpC,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACxC,kEAAkE;QAClE,qEAAqE;QACrE,sEAAsE;QACtE,kCAAkC;QAClC,MAAM,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC,aAAa,EAAE,CAAA;QAChE,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,aAAa,EAAE,CAAA;QACnD,GAAG,CAAC,WAAW,EAAE,CAAA;IACnB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gHAAgH,EAAE,KAAK,IAAI,EAAE;QAC9H,oEAAoE;QACpE,yEAAyE;QACzE,qEAAqE;QACrE,yEAAyE;QACzE,sEAAsE;QACtE,yEAAyE;QACzE,oEAAoE;QACpE,oEAAoE;QACpE,wEAAwE;QACxE,mEAAmE;QACnE,2EAA2E;QAC3E,wEAAwE;QACxE,4EAA4E;QAC5E,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAA;QAC7D,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAA;QAC3D,MAAM,gBAAgB,GAAG,GAAU,EAAE;YACnC,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;QACrF,CAAC,CAAA;QACD,MAAM,cAAc,GAAG,MAAM,CAAC,wBAAwB,CACpD,MAAM,CAAC,SAAS,EAChB,+BAA+B,CAChC,CAAA;QACD,MAAM,YAAY,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAA;QAC1F,IAAI,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,SAAqC,CAAC,+BAA+B,CAAC,GAAG,IAAI,CACrF;YAAC,MAAM,CAAC,SAAqC,CAAC,kBAAkB,CAAC,GAAG,gBAAgB,CAAA;YAErF,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;YAC9D,OAAO,EAAE,CAAA;YAET,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;YACpC,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YACxC,MAAM,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC,aAAa,EAAE,CAAA;YAChE,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,aAAa,EAAE,CAAA;QACrD,CAAC;gBAAS,CAAC;YACT,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,+BAA+B,EAAE,cAAc,CAAC,CAAA;YAC1F,CAAC;iBAAM,CAAC;gBACN,OAAQ,MAAM,CAAC,SAAqC,CAAC,+BAA+B,CAAC,CAAA;YACvF,CAAC;YACD,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAA;YAC3E,CAAC;iBAAM,CAAC;gBACN,OAAQ,MAAM,CAAC,SAAqC,CAAC,kBAAkB,CAAC,CAAA;YAC1E,CAAC;YACD,GAAG,CAAC,WAAW,EAAE,CAAA;QACnB,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAE9E,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,EAAE,CAAC,8FAA8F,EAAE,GAAG,EAAE;QACtG,MAAM,OAAO,GAAG,WAAW,EAAE,CAAA;QAC7B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAA;QAC3B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,CAAA,CAAC,6CAA6C;QAChF,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;QACzC,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC,CAAA;QAE/C,IAAI,MAAkC,CAAA;QACtC,IAAI,CAAC;YACH,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAA;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAqB,CAAA;QAChC,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QAC3C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;QACjE,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5D,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0GAA0G,EAAE,GAAG,EAAE;QAClH,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,CAAA,CAAC,0CAA0C;QAC7E,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9D,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yFAAyF,EAAE,GAAG,EAAE;QACjG,MAAM,OAAO,GAAG,WAAW,EAAE,CAAA;QAC7B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAA;QAC3B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,CAAA;QAElC,MAAM,CAAC,WAAW,CAAC,CAAA,CAAC,gCAAgC;QAEpD,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAA;QACtF,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3C,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/src/config/owned-lock.types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Shared types + tuning constants for the two-level owned-lock primitive.
+ * @module @skillsmith/core/config/owned-lock.types
+ * @see owned-lock.ts for the full soundness argument and public API.
+ */
+/** Max time to wait for the MAIN lock before giving up (ms). Unchanged from today's `acquireConfigLock` default. */
+export declare const LOCK_ACQUIRE_TIMEOUT_MS = 5000;
+/** Backoff between lock-acquisition retries (ms). */
+export declare const LOCK_RETRY_DELAY_MS = 20;
+/** Delay before the FIRST reclaim probe -- keeps the reclaim lock off the hot path when the holder is alive. */
+export declare const RECLAIM_PROBE_AFTER_MS = 250;
+/** Backoff between reclaim probe attempts once contention is established. */
+export declare const RECLAIM_PROBE_INTERVAL_MS = 250;
+/** Max time to wait for the RECLAIM lock. Its critical section is 3 syscalls with no caller code -- a longer wait would itself indicate an orphan (R1). */
+export declare const RECLAIM_LOCK_TIMEOUT_MS = 500;
+/** Bounded read cap for a lock claim file -- refuses (never crashes on) an oversized/garbage lock file. */
+export declare const MAX_LOCK_BYTES = 4096;
+export declare const HARDLINK_UNAVAILABLE_CODES: Set<string>;
+/** A live, current-format claim: `{"v":1,"pid":...,"token":"<16 hex>","host":"...","acquiredAt":...}`. */
+export interface V1Claim {
+    kind: 'v1';
+    pid: number;
+    token: string;
+    host: string;
+    acquiredAt: number;
+}
+/** A bare-decimal-PID claim (today's `acquireConfigLock` format). Carries no `host` -- NEVER auto-reclaimed (D-5). */
+export interface LegacyClaim {
+    kind: 'legacy';
+    pid: number;
+}
+/** Empty, garbage, truncated, or valid-JSON-but-wrong-shape/version. NEVER auto-reclaimed. */
+export interface UnparseableClaim {
+    kind: 'unparseable';
+}
+/** No lock file present at the path read. */
+export interface AbsentClaim {
+    kind: 'absent';
+}
+export type Claim = V1Claim | LegacyClaim | UnparseableClaim | AbsentClaim;
+/** Outcome of a single reclaim attempt (`tryReclaimUnderLock`). */
+export type ReclaimOutcome = 'reclaimed' | 'not-stale' | 'gone' | 'unavailable';
+/** Why the pre-filter (outside the reclaim critical section) declined to even attempt a reclaim. */
+export type RefusalCategory = 'held' | 'legacy' | 'unparseable' | 'reclaim-disabled';
+export type StuckLockReason = 'held' | 'unreclaimable_legacy' | 'unreclaimable_unparseable' | 'reclaim_unavailable' | 'reclaim_disabled';
+/**
+ * Public, SAFE option set for `acquireOwnedLock` (owned-lock.ts). Does NOT
+ * include the two destructive test-only seams (`unsafeSkipReclaimRevalidation`,
+ * `linkSyncOverride`) -- those live only on the internal
+ * `AcquireOwnedLockCoreOptions` (owned-lock.acquire.ts, no public subpath
+ * export), so a package consumer can never pass them through the public
+ * `acquireOwnedLock()` entry point. See owned-lock.acquire.ts's module comment
+ * for the full rationale.
+ */
+export interface AcquireOwnedLockOptions {
+    /** Override the acquire timeout. Production callers should omit this and use the default. */
+    timeoutMs?: number;
+    /** Human label used in the timeout message, e.g. `'config lock'` -> "Timed out waiting for config lock at ...". Defaults to `'lock'`. */
+    label?: string;
+    /** Delay before the first reclaim probe (ms). Production callers should omit this; test-only override. */
+    reclaimProbeAfterMs?: number;
+    /**
+     * @internal Test seam (owned-lock-reclaim-race.test.ts §8b). Fires AFTER
+     * the pre-filter has validated a dead claim and BEFORE any reclaim-lock
+     * acquisition or removal is attempted. Never set in production code.
+     * (Read-only observability -- unlike the two omitted options above, this
+     * cannot affect the locking safety properties, so it's safe to leave on
+     * the public type.)
+     */
+    onReclaimBoundary?: () => void;
+    /**
+     * @internal Test seam (owned-lock-reclaim-race.test.ts §8b). Fires
+     * immediately after `tryReclaimUnderLock` returns, with its outcome.
+     * Never set in production code. Read-only, same rationale as above.
+     */
+    onReclaimOutcome?: (outcome: ReclaimOutcome) => void;
+}
+//# sourceMappingURL=owned-lock.types.d.ts.map

package/dist/src/config/owned-lock.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-lock.types.d.ts","sourceRoot":"","sources":["../../../src/config/owned-lock.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,oHAAoH;AACpH,eAAO,MAAM,uBAAuB,OAAQ,CAAA;AAC5C,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,KAAK,CAAA;AACrC,gHAAgH;AAChH,eAAO,MAAM,sBAAsB,MAAM,CAAA;AACzC,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAC5C,2JAA2J;AAC3J,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAC1C,2GAA2G;AAC3G,eAAO,MAAM,cAAc,OAAQ,CAAA;AAEnC,eAAO,MAAM,0BAA0B,aAQrC,CAAA;AAMF,0GAA0G;AAC1G,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,IAAI,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB;AACD,sHAAsH;AACtH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ;AACD,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAA;CACpB;AACD,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAA;CACf;AACD,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,WAAW,GAAG,gBAAgB,GAAG,WAAW,CAAA;AAE1E,mEAAmE;AACnE,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,aAAa,CAAA;AAE/E,oGAAoG;AACpG,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,kBAAkB,CAAA;AAMpF,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,sBAAsB,GACtB,2BAA2B,GAC3B,qBAAqB,GACrB,kBAAkB,CAAA;AAEtB;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yIAAyI;IACzI,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0GAA0G;IAC1G,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;CACrD"}

package/dist/src/config/owned-lock.types.js

@@ -0,0 +1,30 @@
+/**
+ * Shared types + tuning constants for the two-level owned-lock primitive.
+ * @module @skillsmith/core/config/owned-lock.types
+ * @see owned-lock.ts for the full soundness argument and public API.
+ */
+// ---------------------------------------------------------------------------
+// Tuning constants
+// ---------------------------------------------------------------------------
+/** Max time to wait for the MAIN lock before giving up (ms). Unchanged from today's `acquireConfigLock` default. */
+export const LOCK_ACQUIRE_TIMEOUT_MS = 5_000;
+/** Backoff between lock-acquisition retries (ms). */
+export const LOCK_RETRY_DELAY_MS = 20;
+/** Delay before the FIRST reclaim probe -- keeps the reclaim lock off the hot path when the holder is alive. */
+export const RECLAIM_PROBE_AFTER_MS = 250;
+/** Backoff between reclaim probe attempts once contention is established. */
+export const RECLAIM_PROBE_INTERVAL_MS = 250;
+/** Max time to wait for the RECLAIM lock. Its critical section is 3 syscalls with no caller code -- a longer wait would itself indicate an orphan (R1). */
+export const RECLAIM_LOCK_TIMEOUT_MS = 500;
+/** Bounded read cap for a lock claim file -- refuses (never crashes on) an oversized/garbage lock file. */
+export const MAX_LOCK_BYTES = 4_096;
+export const HARDLINK_UNAVAILABLE_CODES = new Set([
+    'EPERM',
+    'EACCES',
+    'ENOSYS',
+    'EXDEV',
+    'EMLINK',
+    'EOPNOTSUPP',
+    'ENOTSUP',
+]);
+//# sourceMappingURL=owned-lock.types.js.map

package/dist/src/config/owned-lock.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-lock.types.js","sourceRoot":"","sources":["../../../src/config/owned-lock.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,oHAAoH;AACpH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAA;AAC5C,qDAAqD;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAA;AACrC,gHAAgH;AAChH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAA;AACzC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAA;AAC5C,2JAA2J;AAC3J,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAA;AAC1C,2GAA2G;AAC3G,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAA;AAEnC,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IAChD,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,SAAS;CACV,CAAC,CAAA"}

package/dist/src/db/createDatabase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createDatabase.d.ts","sourceRoot":"","sources":["../../../src/db/createDatabase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAcxE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,QAAQ,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,UAAU,EAAE,CA0BrD;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAiBjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAmB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAgBjG;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,GAAE,MAAmB,EACzB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,QAAQ,CAAC,CA2CnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,2BAAqB,CAAA"}
+{"version":3,"file":"createDatabase.d.ts","sourceRoot":"","sources":["../../../src/db/createDatabase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAmBxE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,QAAQ,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,UAAU,EAAE,CA0BrD;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAiBjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAmB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAgBjG;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,GAAE,MAAmB,EACzB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,QAAQ,CAAC,CAkDnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,2BAAqB,CAAA"}

package/dist/src/db/createDatabase.js

@@ -18,6 +18,11 @@
  */
 import { createBetterSqlite3Database, isBetterSqlite3Available, getBetterSqlite3FailureReason, } from './drivers/betterSqlite3Driver.js';
 import { createSqlJsDatabase, isSqlJsAvailable } from './drivers/sqljsDriver.js';
+// SMI-5897 (C-18/C-19, Wave 4 fix): shared SKILLSMITH_QUIET guard — this was
+// the second, unguarded fallback-warning path C-18/C-19 didn't originally
+// cover; the WASM-driver notice below always printed at least once per
+// process regardless of SKILLSMITH_QUIET.
+import { isQuietModeEnabled } from '../utils/quiet-mode.js';
 /**
  * SMI-4807: guard so the WASM-fallback notice is emitted at most once per
  * process, no matter how many database connections are opened.
@@ -135,15 +140,22 @@ export async function createDatabaseAsync(path = ':memory:', options) {
     if (isSqlJsAvailable()) {
         if (!wasmFallbackNoticeEmitted) {
             wasmFallbackNoticeEmitted = true;
-            let message = '[Skillsmith] Using WASM SQLite driver ' +
-                '(native better-sqlite3 not loaded — expected on direct macOS/npx installs).';
-            if (process.env.SKILLSMITH_DEBUG) {
-                const reason = getBetterSqlite3FailureReason();
-                if (reason) {
-                    message += ` Reason: ${reason}`;
+            // SMI-5897 (Wave 4 fix): honor SKILLSMITH_QUIET, same as the
+            // embeddings-layer fallback warnings — the notice still guards
+            // print-once-per-process via wasmFallbackNoticeEmitted above (set
+            // regardless of quiet mode, so a later non-quiet caller doesn't get a
+            // stale re-print of a decision already made this process).
+            if (!isQuietModeEnabled()) {
+                let message = '[Skillsmith] Using WASM SQLite driver ' +
+                    '(native better-sqlite3 not loaded — expected on direct macOS/npx installs).';
+                if (process.env.SKILLSMITH_DEBUG) {
+                    const reason = getBetterSqlite3FailureReason();
+                    if (reason) {
+                        message += ` Reason: ${reason}`;
+                    }
                 }
+                console.warn(message);
             }
-            console.warn(message);
         }
         return await createSqlJsDatabase(path, options);
     }

package/dist/src/db/createDatabase.js.map

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