aifastdb 3.10.5 → 3.10.7

package/dist/remember-spawn-benchmark.js

@@ -0,0 +1,230 @@
+#!/usr/bin/env node
+"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 });
+/**
+ * phase-383/T383.2 (E383.B): rememberSpawn concurrent benchmark
+ *
+ * Measures the e2e write throughput unlocked by phase-383/T383.1's
+ * `rememberSpawn` NAPI async wrapper, which spawns the sync remember()
+ * body onto AiFastDb's owned multi-thread tokio runtime so that
+ * `Promise.all([db.rememberSpawn(input), ...])` actually parallelises
+ * through the K-shard `ConcurrentHNSWIndex`.
+ *
+ * Baselines (post phase-382 / a989070):
+ *   - sync .remember() seq:           5,097 ops/s   (T382.2c e2e default)
+ *   - K=8  8-thread direct Rust:     40,397 ops/s   (T382.2c bench-mt)
+ *   - K=16 8-thread direct Rust:     59,521 ops/s   (T382.2c bench-mt)
+ *
+ * Decision gate (T383.3): keep rememberSpawn iff
+ *   max_concurrent_throughput >= 2x sync seq throughput.
+ *
+ * Usage:
+ *   npx tsx packages/node/ts/remember-spawn-benchmark.ts
+ *   npx tsx packages/node/ts/remember-spawn-benchmark.ts --dim 128 --total 5000 --concurrencies 1,4,8,16
+ */
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const fs = __importStar(require("fs"));
+const args = new Map();
+process.argv.slice(2).forEach((arg, i, arr) => {
+    if (arg.startsWith('--')) {
+        const key = arg.slice(2);
+        if (i + 1 < arr.length && !arr[i + 1].startsWith('--')) {
+            args.set(key, arr[i + 1]);
+        }
+        else {
+            args.set(key, 'true');
+        }
+    }
+});
+const DIM = parseInt(args.get('dim') ?? '128', 10);
+const TOTAL = parseInt(args.get('total') ?? '5000', 10);
+const CONCURRENCIES = (args.get('concurrencies') ?? '1,4,8,16,32')
+    .split(',')
+    .map((s) => parseInt(s, 10));
+// phase-384/T384.2: ef_construction sweep at the NAPI layer.
+// phase-388/T388.0: harness default REVERTED to 200, mirroring the
+// project default after the phase-386 default change was rolled
+// back pending a multi-seed reproducibility audit. Pass `--ef 100`
+// to test the phase-386 candidate, or `--ef 50` to reproduce the
+// phase-384 M3-direct-Rust ceiling probe.
+const EF_CONSTRUCTION = parseInt(args.get('ef') ?? '200', 10);
+const EF_SEARCH = parseInt(args.get('ef-search') ?? '50', 10);
+const M = parseInt(args.get('m') ?? '16', 10);
+const MAX_ELEMENTS = parseInt(args.get('max-elements') ?? '1000000', 10);
+const ROOT = path.resolve(__dirname, '..', '..', '..');
+const tmpRoot = path.join(os.tmpdir(), `aidb-remember-spawn-bench-${process.pid}`);
+fs.mkdirSync(tmpRoot, { recursive: true });
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { AiFastDb } = require(path.join(ROOT, 'packages', 'node'));
+function vectorOf(seed, dim) {
+    const v = new Array(dim);
+    for (let i = 0; i < dim; i++) {
+        v[i] = Math.sin(seed * 2654435761 + i * 374761393);
+    }
+    return v;
+}
+function makeInput(id, dim) {
+    return {
+        content: `bench doc ${id}`,
+        embedding: vectorOf(id, dim),
+        tags: ['bench'],
+        metadata: { id_num: id },
+        importance: 0.5,
+    };
+}
+function makeDb(dbPath, dim) {
+    fs.mkdirSync(dbPath, { recursive: true });
+    return new AiFastDb({
+        path: dbPath,
+        dimension: dim,
+        hnsw: {
+            m: M,
+            efConstruction: EF_CONSTRUCTION,
+            efSearch: EF_SEARCH,
+            dimension: dim,
+            maxElements: MAX_ELEMENTS,
+        },
+    });
+}
+async function runConcurrentRememberSpawn(concurrency, total, dim) {
+    const dbPath = path.join(tmpRoot, `c${concurrency}-${Date.now()}`);
+    const db = makeDb(dbPath, dim);
+    // Pre-build inputs so per-call work is just NAPI + HNSW.
+    const inputs = Array.from({ length: total }, (_, i) => makeInput(i, dim));
+    const start = process.hrtime.bigint();
+    if (concurrency === 1) {
+        // Sequential: still calls .rememberSpawn (NOT .remember) so the
+        // overhead of dispatcher+spawn is included in the baseline.
+        for (let i = 0; i < total; i++) {
+            await db.rememberSpawn(inputs[i]);
+        }
+    }
+    else {
+        // Concurrency = N: maintain a sliding window of N in-flight Promises.
+        // We do this with a simple "worker per slot" pattern so Node doesn't
+        // build up `total` Promises in memory; each slot pulls the next index
+        // when its current call resolves.
+        let next = 0;
+        const workers = [];
+        for (let w = 0; w < concurrency; w++) {
+            workers.push((async () => {
+                while (true) {
+                    const idx = next++;
+                    if (idx >= total)
+                        return;
+                    await db.rememberSpawn(inputs[idx]);
+                }
+            })());
+        }
+        await Promise.all(workers);
+    }
+    const elapsed = Number(process.hrtime.bigint() - start) / 1e9;
+    const opsPerSec = total / elapsed;
+    return {
+        concurrency,
+        total,
+        elapsedSec: elapsed,
+        opsPerSec,
+        liftVsSeq: 0, // filled in later
+    };
+}
+async function runSyncRememberSeq(total, dim) {
+    const dbPath = path.join(tmpRoot, `sync-${Date.now()}`);
+    const db = makeDb(dbPath, dim);
+    const inputs = Array.from({ length: total }, (_, i) => makeInput(i, dim));
+    const start = process.hrtime.bigint();
+    for (let i = 0; i < total; i++) {
+        db.remember(inputs[i]);
+    }
+    const elapsed = Number(process.hrtime.bigint() - start) / 1e9;
+    return {
+        concurrency: 0, // sentinel for sync
+        total,
+        elapsedSec: elapsed,
+        opsPerSec: total / elapsed,
+        liftVsSeq: 1.0,
+    };
+}
+async function main() {
+    console.log(`[bench] phase-383/T383.2 + phase-384/T384.2 rememberSpawn concurrent benchmark`);
+    console.log(`[bench] dim=${DIM} total=${TOTAL} concurrencies=${CONCURRENCIES.join(',')} ef_construction=${EF_CONSTRUCTION} ef_search=${EF_SEARCH} M=${M}`);
+    console.log(`[bench] node=${process.version} cpus=${os.cpus().length}`);
+    console.log('');
+    // 1. sync .remember() baseline (sequential)
+    console.log(`[bench] Phase 0: sync .remember() seq baseline ...`);
+    const syncResult = await runSyncRememberSeq(TOTAL, DIM);
+    console.log(`  sync .remember() seq:        elapsed=${syncResult.elapsedSec.toFixed(3)}s  ops/s=${syncResult.opsPerSec.toFixed(1)}`);
+    // 2. .rememberSpawn() at varying concurrencies
+    const results = [syncResult];
+    for (const c of CONCURRENCIES) {
+        console.log(`[bench] Phase ${c === 1 ? '1' : 'C=' + c}: rememberSpawn (concurrency=${c}) ...`);
+        const r = await runConcurrentRememberSpawn(c, TOTAL, DIM);
+        r.liftVsSeq = r.opsPerSec / syncResult.opsPerSec;
+        results.push(r);
+        console.log(`  rememberSpawn (c=${String(c).padStart(3)}): elapsed=${r.elapsedSec.toFixed(3)}s  ops/s=${r.opsPerSec.toFixed(1).padStart(10)}  lift=${r.liftVsSeq.toFixed(2)}x`);
+    }
+    console.log('');
+    console.log('---');
+    for (const r of results) {
+        if (r.concurrency === 0) {
+            console.log(`sync_remember_seq_ops:        ${r.opsPerSec.toFixed(1)}`);
+        }
+        else {
+            console.log(`remember_spawn_c${String(r.concurrency).padStart(2, '0')}_ops:       ${r.opsPerSec.toFixed(1).padStart(10)}  (lift=${r.liftVsSeq.toFixed(2)}x)`);
+        }
+    }
+    console.log(`dim:                          ${DIM}`);
+    console.log(`total_per_phase:              ${TOTAL}`);
+    console.log(`ef_construction:              ${EF_CONSTRUCTION}`);
+    console.log(`ef_search:                    ${EF_SEARCH}`);
+    console.log(`m:                            ${M}`);
+    console.log(`platform:                     ${process.platform}-${process.arch}`);
+    console.log(`cpus:                         ${os.cpus().length}`);
+    console.log('---');
+    // Cleanup
+    try {
+        fs.rmSync(tmpRoot, { recursive: true, force: true });
+    }
+    catch {
+        // best-effort
+    }
+}
+main().catch((err) => {
+    console.error('[bench] error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=remember-spawn-benchmark.js.map

package/dist/remember-spawn-benchmark.js.map

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

package/dist/remember-spawn-receipt-benchmark.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=remember-spawn-receipt-benchmark.d.ts.map

package/dist/remember-spawn-receipt-benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember-spawn-receipt-benchmark.d.ts","sourceRoot":"","sources":["../ts/remember-spawn-receipt-benchmark.ts"],"names":[],"mappings":""}

package/dist/remember-spawn-receipt-benchmark.js

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+"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 });
+/**
+ * phase-387/T387.4: rememberSpawnReceipt vs rememberSpawn benchmark.
+ *
+ * Targets the residual phase-385 NAPI ceiling. `rememberSpawn` returns a
+ * 13-field `MemoryNode` (including `metadata: serde_json::Value`); the
+ * `rememberSpawnReceipt` API introduced in phase-387/T387.2 returns a
+ * 6-field `WriteReceiptJS` (id + sequence + shard_id + timestamp + success
+ * + error) on the same write path. Hypothesis: with the JS-bound payload
+ * collapsed, the per-call NAPI marshalling cost falls and concurrent
+ * throughput moves from the phase-385 81K ceiling toward the phase-384
+ * direct-Rust 100K M3 ceiling.
+ *
+ * Bench shape:
+ *   - phase 1: sync .remember()                         (baseline anchor)
+ *   - phase 2: rememberSpawn (full MemoryNode)          x concurrency sweep
+ *   - phase 3: rememberSpawnReceipt (light receipt)     x concurrency sweep
+ *   - phase 4: rememberManySpawnReceipts (batched)      x batch size sweep
+ *
+ * Decision gate (T387.5): keep iff
+ *   (a) rememberSpawnReceipt c=16 lift over rememberSpawn c=16 >= 1.20x AND
+ *   (b) absolute >= 50K ops/s
+ *
+ * Usage:
+ *   npx tsx packages/node/ts/remember-spawn-receipt-benchmark.ts
+ *   npx tsx packages/node/ts/remember-spawn-receipt-benchmark.ts --total 10000 --concurrencies 1,4,8,16,32 --batches 32,128,512
+ */
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const fs = __importStar(require("fs"));
+const args = new Map();
+process.argv.slice(2).forEach((arg, i, arr) => {
+    if (arg.startsWith('--')) {
+        const key = arg.slice(2);
+        if (i + 1 < arr.length && !arr[i + 1].startsWith('--')) {
+            args.set(key, arr[i + 1]);
+        }
+        else {
+            args.set(key, 'true');
+        }
+    }
+});
+const DIM = parseInt(args.get('dim') ?? '128', 10);
+const TOTAL = parseInt(args.get('total') ?? '10000', 10);
+const CONCURRENCIES = (args.get('concurrencies') ?? '1,4,8,16,32')
+    .split(',')
+    .map((s) => parseInt(s, 10));
+const BATCHES = (args.get('batches') ?? '32,128,512')
+    .split(',')
+    .map((s) => parseInt(s, 10));
+const EF_CONSTRUCTION = parseInt(args.get('ef') ?? '100', 10);
+const EF_SEARCH = parseInt(args.get('ef-search') ?? '50', 10);
+const M = parseInt(args.get('m') ?? '16', 10);
+const MAX_ELEMENTS = parseInt(args.get('max-elements') ?? '1000000', 10);
+const ROOT = path.resolve(__dirname, '..', '..', '..');
+const tmpRoot = path.join(os.tmpdir(), `aidb-receipt-bench-${process.pid}`);
+fs.mkdirSync(tmpRoot, { recursive: true });
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { AiFastDb } = require(path.join(ROOT, 'packages', 'node'));
+function vectorOf(seed, dim) {
+    const v = new Array(dim);
+    for (let i = 0; i < dim; i++) {
+        v[i] = Math.sin(seed * 2654435761 + i * 374761393);
+    }
+    return v;
+}
+function makeInput(id, dim) {
+    return {
+        content: `bench doc ${id}`,
+        embedding: vectorOf(id, dim),
+        tags: ['bench'],
+        metadata: { id_num: id },
+        importance: 0.5,
+    };
+}
+function makeDb(dbPath, dim) {
+    fs.mkdirSync(dbPath, { recursive: true });
+    return new AiFastDb({
+        path: dbPath,
+        dimension: dim,
+        hnsw: {
+            m: M,
+            efConstruction: EF_CONSTRUCTION,
+            efSearch: EF_SEARCH,
+            dimension: dim,
+            maxElements: MAX_ELEMENTS,
+        },
+    });
+}
+async function runSyncRememberSeq(total, dim) {
+    const dbPath = path.join(tmpRoot, `sync-${Date.now()}`);
+    const db = makeDb(dbPath, dim);
+    const inputs = Array.from({ length: total }, (_, i) => makeInput(i, dim));
+    const start = process.hrtime.bigint();
+    for (let i = 0; i < total; i++)
+        db.remember(inputs[i]);
+    const elapsed = Number(process.hrtime.bigint() - start) / 1e9;
+    return total / elapsed;
+}
+async function runConcurrent(call, concurrency, total, dim) {
+    const dbPath = path.join(tmpRoot, `${call}-c${concurrency}-${Date.now()}`);
+    const db = makeDb(dbPath, dim);
+    const inputs = Array.from({ length: total }, (_, i) => makeInput(i, dim));
+    const fn = call === 'spawn'
+        ? (i) => db.rememberSpawn(inputs[i])
+        : (i) => db.rememberSpawnReceipt(inputs[i]);
+    const start = process.hrtime.bigint();
+    if (concurrency === 1) {
+        for (let i = 0; i < total; i++)
+            await fn(i);
+    }
+    else {
+        let next = 0;
+        const workers = [];
+        for (let w = 0; w < concurrency; w++) {
+            workers.push((async () => {
+                while (true) {
+                    const idx = next++;
+                    if (idx >= total)
+                        return;
+                    await fn(idx);
+                }
+            })());
+        }
+        await Promise.all(workers);
+    }
+    const elapsed = Number(process.hrtime.bigint() - start) / 1e9;
+    return total / elapsed;
+}
+async function runManyReceipts(batchSize, total, dim) {
+    const dbPath = path.join(tmpRoot, `many-receipt-b${batchSize}-${Date.now()}`);
+    const db = makeDb(dbPath, dim);
+    const inputs = Array.from({ length: total }, (_, i) => makeInput(i, dim));
+    const start = process.hrtime.bigint();
+    for (let off = 0; off < total; off += batchSize) {
+        const slice = inputs.slice(off, Math.min(off + batchSize, total));
+        await db.rememberManySpawnReceipts(slice);
+    }
+    const elapsed = Number(process.hrtime.bigint() - start) / 1e9;
+    return total / elapsed;
+}
+async function main() {
+    console.log(`[bench] phase-387/T387.4 rememberSpawnReceipt benchmark`);
+    console.log(`[bench] dim=${DIM} total=${TOTAL} concurrencies=${CONCURRENCIES.join(',')} batches=${BATCHES.join(',')} ef=${EF_CONSTRUCTION}`);
+    const results = [];
+    console.log(`[bench] phase 1: sync .remember()`);
+    const seqOps = await runSyncRememberSeq(Math.min(TOTAL, 5000), DIM);
+    results.push({
+        label: 'sync_remember_seq',
+        concurrency: 0,
+        total: TOTAL,
+        elapsedSec: 0,
+        opsPerSec: seqOps,
+        liftVsSeq: 1.0,
+        liftVsSpawn: 0,
+    });
+    console.log(`  sync_remember_seq               =  ${seqOps.toFixed(0).padStart(7)} ops/s`);
+    console.log(`[bench] phase 2: rememberSpawn (full MemoryNode)`);
+    const spawnByC = {};
+    for (const c of CONCURRENCIES) {
+        const ops = await runConcurrent('spawn', c, TOTAL, DIM);
+        spawnByC[c] = ops;
+        results.push({
+            label: `spawn_c${String(c).padStart(2, '0')}`,
+            concurrency: c,
+            total: TOTAL,
+            elapsedSec: 0,
+            opsPerSec: ops,
+            liftVsSeq: ops / seqOps,
+            liftVsSpawn: 1.0,
+        });
+        console.log(`  spawn_c${String(c).padStart(2, '0')}                       =  ${ops.toFixed(0).padStart(7)} ops/s   (lift_vs_sync=${(ops / seqOps).toFixed(2)}x)`);
+    }
+    console.log(`[bench] phase 3: rememberSpawnReceipt (light receipt)`);
+    for (const c of CONCURRENCIES) {
+        const ops = await runConcurrent('receipt', c, TOTAL, DIM);
+        const liftSpawn = ops / spawnByC[c];
+        results.push({
+            label: `receipt_c${String(c).padStart(2, '0')}`,
+            concurrency: c,
+            total: TOTAL,
+            elapsedSec: 0,
+            opsPerSec: ops,
+            liftVsSeq: ops / seqOps,
+            liftVsSpawn: liftSpawn,
+        });
+        console.log(`  receipt_c${String(c).padStart(2, '0')}                     =  ${ops.toFixed(0).padStart(7)} ops/s   (lift_vs_spawn=${liftSpawn.toFixed(2)}x  lift_vs_sync=${(ops / seqOps).toFixed(2)}x)`);
+    }
+    console.log(`[bench] phase 4: rememberManySpawnReceipts (batched)`);
+    for (const b of BATCHES) {
+        const ops = await runManyReceipts(b, TOTAL, DIM);
+        results.push({
+            label: `many_receipts_b${String(b).padStart(3, '0')}`,
+            concurrency: 1,
+            total: TOTAL,
+            elapsedSec: 0,
+            opsPerSec: ops,
+            liftVsSeq: ops / seqOps,
+            liftVsSpawn: ops / spawnByC[16],
+        });
+        console.log(`  many_receipts_b${String(b).padStart(3, '0')}              =  ${ops.toFixed(0).padStart(7)} ops/s   (lift_vs_sync=${(ops / seqOps).toFixed(2)}x  lift_vs_spawn_c16=${(ops / spawnByC[16]).toFixed(2)}x)`);
+    }
+    console.log(`[bench] ---- summary ----`);
+    console.log(`dim:                          ${DIM}`);
+    console.log(`total_per_phase:              ${TOTAL}`);
+    console.log(`ef_construction:              ${EF_CONSTRUCTION}`);
+    console.log(`platform:                     ${process.platform}-${process.arch}`);
+    console.log(`cpus:                         ${os.cpus().length}`);
+    // Decision gate
+    const spawn16 = results.find((r) => r.label === 'spawn_c16')?.opsPerSec ?? 0;
+    const receipt16 = results.find((r) => r.label === 'receipt_c16')?.opsPerSec ?? 0;
+    const lift = receipt16 / spawn16;
+    const gateA = lift >= 1.2;
+    const gateB = receipt16 >= 50000;
+    console.log(`---- decision gate (T387.5) ----`);
+    console.log(`receipt_c16 / spawn_c16:      ${lift.toFixed(2)}x  (gate: >=1.20x  -> ${gateA ? 'PASS' : 'FAIL'})`);
+    console.log(`receipt_c16 absolute:         ${receipt16.toFixed(0)} ops/s  (gate: >=50000 -> ${gateB ? 'PASS' : 'FAIL'})`);
+    console.log(`overall:                      ${gateA && gateB ? 'PASS — KEEP rememberSpawnReceipt' : 'FAIL — investigate'}`);
+    // Cleanup tmpRoot
+    try {
+        fs.rmSync(tmpRoot, { recursive: true, force: true });
+    }
+    catch (_) {
+        // best-effort
+    }
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=remember-spawn-receipt-benchmark.js.map

package/dist/remember-spawn-receipt-benchmark.js.map

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

package/dist/sgv2-async-verify.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * phase-380/T380.3 (E380.B) — semantic regression guard for the new
+ * `getTagMembersAsync` / `listTagsAsync` / `getPersonsByAttributeAsync`
+ * NAPI async wrappers on `SocialGraphV2`.
+ *
+ * Same contract as `find-async-verify.ts`:
+ *   1. async length == sync length
+ *   2. when limit >= total_hits, sorted-id projection equality
+ * (per-node predicate is implicit because the sync side itself was
+ *  validated in phase-377; we just check sync vs async.)
+ *
+ * Run after `npx tsc`:
+ *   node packages/node/dist/sgv2-async-verify.js
+ */
+export {};
+//# sourceMappingURL=sgv2-async-verify.d.ts.map

package/dist/sgv2-async-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sgv2-async-verify.d.ts","sourceRoot":"","sources":["../ts/sgv2-async-verify.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}