@andespindola/brainlink 0.1.0-beta.41 → 0.1.0-beta.43

package/dist/infrastructure/search-packs.js

@@ -221,6 +221,7 @@ const sortedPackFiles = async (vaultPath) => {
     }
 };
 const writeRowsAsPrivatePacks = async (vaultPath, rows, clearExisting) => {
+    const startedAt = process.hrtime.bigint();
     const directory = toPackDirectory(vaultPath);
     await mkdir(directory, { recursive: true });
     if (clearExisting) {
@@ -231,6 +232,8 @@ const writeRowsAsPrivatePacks = async (vaultPath, rows, clearExisting) => {
     }
     const chunks = chunkRows(rows, rowChunkSize);
     const packIndex = [];
+    let inputBytes = 0;
+    let outputBytes = 0;
     for (let index = 0; index < chunks.length; index += 1) {
         const chunk = chunks[index];
         const fileName = `pack-${String(index + 1).padStart(4, '0')}.blpk`;
@@ -238,6 +241,8 @@ const writeRowsAsPrivatePacks = async (vaultPath, rows, clearExisting) => {
         const compressed = await encodePrivatePack(vaultPath, Buffer.from(serialized, 'utf8'));
         const tokenBloomB64 = bloomToBase64(bloomFromRows(chunk));
         await writeFile(join(directory, fileName), compressed);
+        inputBytes += Buffer.byteLength(serialized, 'utf8');
+        outputBytes += compressed.byteLength;
         packIndex.push({
             fileName,
             recordCount: chunk.length,
@@ -253,9 +258,19 @@ const writeRowsAsPrivatePacks = async (vaultPath, rows, clearExisting) => {
         format: 'private-v2',
         packIndex
     });
+    const durationMs = Number(process.hrtime.bigint() - startedAt) / 1_000_000;
+    const safeInput = Math.max(inputBytes, 1);
+    const savedBytes = Math.max(inputBytes - outputBytes, 0);
     return {
         packCount: chunks.length,
-        recordCount: rows.length
+        recordCount: rows.length,
+        compression: {
+            inputBytes,
+            outputBytes,
+            ratio: outputBytes / safeInput,
+            savedBytes
+        },
+        durationMs
     };
 };
 const selectCandidatePackFiles = async (vaultPath, tokens, agentId) => {

package/docs/AGENT_USAGE.md

@@ -477,6 +477,24 @@ This scans Markdown files and rebuilds:
 - links
 - full-text search records
 
+### Benchmark Indexing Realtime
+
+```bash
+blink bench --vault ./vault
+blink bench --vault ./vault --watch
+blink bench --vault ./vault --watch --debounce 500
+blink bench --vault ./vault --json
+```
+
+`bench` runs indexing with realtime phase events and prints a run summary with:
+
+- indexed totals (documents, chunks, links)
+- elapsed time and changed document count
+- pack rebuild status and reason
+- pack compression metrics (`inputBytes`, `outputBytes`, ratio/saved percentage)
+
+Use `--watch` for continuous benchmark runs while editing notes. Watch mode is supported only for local filesystem vaults.
+
 ### Search Knowledge
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andespindola/brainlink",
-  "version": "0.1.0-beta.41",
+  "version": "0.1.0-beta.43",
   "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
   "type": "module",
   "license": "MIT",