npm - @andespindola/brainlink - Versions diffs - 0.1.0-beta.6 → 0.1.0-beta.8 - Mend

@andespindola/brainlink 0.1.0-beta.6 → 0.1.0-beta.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md +2 -0
package/dist/application/frontend/client-css.js +81 -2
package/dist/application/frontend/client-html.js +13 -4
package/dist/application/frontend/client-js.js +26 -9
package/dist/application/migrate-vault.js +61 -0
package/dist/cli/commands/write-commands.js +18 -2
package/dist/infrastructure/file-system-vault.js +15 -0
package/docs/AGENT_USAGE.md +1 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -561,9 +561,11 @@ Every command works with either `brainlink` or `blink`.
 ```bash
 blink init
 blink init ./vault
+blink init ./team-vault --migrate-from ~/.brainlink/vault
 ```
 Initializes vault metadata. Without an argument, Brainlink initializes the default vault at `$HOME/.brainlink/vault`.
+When initializing an empty custom vault, existing Markdown content from the default vault is copied into it and reindexed so context is not left behind. Use `--no-migrate-existing` to start with an empty custom vault, or `--migrate-from <vault>` to copy from a specific source. Existing target files are never overwritten; conflicting source files are preserved with a `.conflict-<timestamp>` suffix.
 ### `add`

package/dist/application/frontend/client-css.js CHANGED Viewed

@@ -140,7 +140,7 @@ select {
 .inspector {
   display: grid;
-  grid-template-rows: auto auto auto auto auto 1fr 1fr;
+  grid-template-rows: auto auto auto minmax(0, 1fr) minmax(0, 1fr) minmax(0, 1fr);
   gap: 22px;
   min-width: 0;
   height: 100%;
@@ -253,7 +253,7 @@ li small {
 }
 .note-content {
-  max-height: 32svh;
+  max-height: min(68svh, 760px);
   margin: 0;
   padding: 12px;
   border: 1px solid var(--line);
@@ -267,6 +267,80 @@ li small {
   line-height: 1.5;
 }
+.content-dialog {
+  width: min(920px, calc(100vw - 32px));
+  max-height: calc(100svh - 32px);
+  padding: 0;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: var(--panel);
+  color: var(--text);
+  box-shadow: 0 24px 80px rgba(0, 0, 0, 0.48);
+}
+.content-dialog::backdrop {
+  background: rgba(4, 7, 10, 0.72);
+  backdrop-filter: blur(4px);
+}
+.content-dialog article {
+  display: grid;
+  grid-template-rows: auto minmax(0, 1fr);
+  max-height: calc(100svh - 34px);
+}
+.content-dialog header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 18px;
+  padding: 22px;
+  border-bottom: 1px solid var(--line);
+}
+.content-dialog h2,
+.content-dialog p {
+  margin: 0;
+}
+.content-dialog h2 {
+  margin-top: 6px;
+  font-size: 24px;
+  line-height: 1.15;
+  overflow-wrap: anywhere;
+}
+.content-dialog p {
+  margin-top: 8px;
+  color: var(--muted);
+  overflow-wrap: anywhere;
+}
+.content-dialog button {
+  flex: 0 0 auto;
+  height: 38px;
+  padding: 0 14px;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: var(--panel-strong);
+  color: var(--text);
+  cursor: pointer;
+}
+.content-dialog button:hover,
+.content-dialog button:focus {
+  border-color: var(--accent);
+  color: var(--accent);
+}
+.content-dialog .note-content {
+  max-height: none;
+  min-height: 0;
+  border: 0;
+  border-radius: 0;
+  padding: 22px;
+}
 @media (max-width: 860px) {
   .shell {
     grid-template-columns: 1fr;
@@ -291,4 +365,9 @@ li small {
   .agent-filter {
     width: 100%;
   }
+  .content-dialog header {
+    align-items: stretch;
+    flex-direction: column;
+  }
 }`;

package/dist/application/frontend/client-html.js CHANGED Viewed

@@ -47,10 +47,6 @@ export const createClientHtml = () => `<!doctype html>
           <h2>Notes</h2>
           <ul id="notes"></ul>
         </section>
-        <section>
-          <h2>Content</h2>
-          <pre id="content" class="note-content"></pre>
-        </section>
         <section>
           <h2>Outgoing</h2>
           <ul id="outgoing"></ul>
@@ -61,6 +57,19 @@ export const createClientHtml = () => `<!doctype html>
         </section>
       </aside>
     </main>
+    <dialog id="contentDialog" class="content-dialog" aria-labelledby="contentTitle">
+      <article>
+        <header>
+          <div>
+            <span class="eyebrow">Markdown content</span>
+            <h2 id="contentTitle">Selected note</h2>
+            <p id="contentPath"></p>
+          </div>
+          <button id="contentClose" type="button">Close</button>
+        </header>
+        <pre id="contentBody" class="note-content"></pre>
+      </article>
+    </dialog>
     <script src="/app.js"></script>
   </body>
 </html>`;

package/dist/application/frontend/client-js.js CHANGED Viewed

@@ -31,7 +31,6 @@ const elements = {
   path: byId('path'),
   tags: byId('tags'),
   notes: byId('notes'),
-  content: byId('content'),
   outgoing: byId('outgoing'),
   incoming: byId('incoming'),
   nodeCount: byId('nodeCount'),
@@ -39,7 +38,12 @@ const elements = {
   tagCount: byId('tagCount'),
   zoomIn: byId('zoomIn'),
   zoomOut: byId('zoomOut'),
-  reset: byId('reset')
+  reset: byId('reset'),
+  contentDialog: byId('contentDialog'),
+  contentTitle: byId('contentTitle'),
+  contentPath: byId('contentPath'),
+  contentBody: byId('contentBody'),
+  contentClose: byId('contentClose')
 }
 const agentQuery = () => state.agentId ? '?agent=' + encodeURIComponent(state.agentId) : ''
@@ -128,7 +132,7 @@ const encodeEntityTag = (value) => {
     binary += String.fromCharCode(utf8[index])
   }
-  return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/g, '')
+  return btoa(binary).replaceAll('+', '-').replaceAll('/', '_').replace(/=+$/g, '')
 }
 const graphSignature = graph => JSON.stringify({
@@ -278,14 +282,23 @@ const allNotesList = () => state.nodes.length
   ? state.nodes.map(node => '<li><button type="button" data-node-id="' + escapeHtml(node.id) + '">' + escapeHtml(node.title) + '</button><small>' + escapeHtml(node.path) + '</small></li>').join('')
   : '<li><small>No notes indexed.</small></li>'
-const selectNode = node => {
+const openContentDialog = node => {
+  if (!node) return
+  elements.contentTitle.textContent = node.title
+  elements.contentPath.textContent = node.path
+  elements.contentBody.textContent = node.content
+  if (!elements.contentDialog.open) {
+    elements.contentDialog.showModal()
+  }
+}
+const selectNode = (node, options = { openContent: false }) => {
   state.selected = node
   if (!node) {
     elements.title.textContent = 'Graph Overview'
     elements.path.textContent = state.nodes.length + ' notes and ' + state.graph.edges.length + ' links indexed.'
     elements.tags.innerHTML = ''
     elements.notes.innerHTML = allNotesList()
-    elements.content.textContent = 'Selecione uma nota no grafo ou na lista para ver o Markdown completo, backlinks e links de saida.'
     elements.outgoing.innerHTML = '<li><small>Select a note to inspect outgoing links.</small></li>'
     elements.incoming.innerHTML = '<li><small>Select a note to inspect backlinks.</small></li>'
     return
@@ -311,14 +324,14 @@ const selectNode = node => {
     ? node.tags.map(tag => '<span>#' + escapeHtml(tag) + '</span>').join('')
     : '<span>No tags</span>'
   elements.notes.innerHTML = allNotesList()
-  elements.content.textContent = node.content
   elements.outgoing.innerHTML = list(outgoing)
   elements.incoming.innerHTML = list(incoming)
+  if (options.openContent) openContentDialog(node)
 }
 const selectNodeById = id => {
   const node = state.nodes.find(item => item.id === id)
-  if (node) selectNode(node)
+  if (node) selectNode(node, { openContent: true })
 }
 const zoom = factor => {
@@ -344,6 +357,10 @@ const bindEvents = () => {
   elements.zoomIn.addEventListener('click', () => zoom(1.18))
   elements.zoomOut.addEventListener('click', () => zoom(0.84))
   elements.reset.addEventListener('click', resetView)
+  elements.contentClose.addEventListener('click', () => elements.contentDialog.close())
+  elements.contentDialog.addEventListener('click', event => {
+    if (event.target === elements.contentDialog) elements.contentDialog.close()
+  })
   ;[elements.notes, elements.outgoing, elements.incoming].forEach(element => {
     element.addEventListener('click', event => {
       const target = event.target
@@ -384,8 +401,8 @@ const bindEvents = () => {
     state.transform.y += dy
   })
   canvas.addEventListener('pointerup', event => {
-    if (state.pointer.dragNode && !state.pointer.moved) selectNode(state.pointer.dragNode)
-    if (!state.pointer.dragNode && !state.pointer.moved) selectNode(state.hovered)
+    if (state.pointer.dragNode && !state.pointer.moved) selectNode(state.pointer.dragNode, { openContent: true })
+    if (!state.pointer.dragNode && !state.pointer.moved) selectNode(state.hovered, { openContent: true })
     state.pointer = { x: 0, y: 0, down: false, dragNode: null, moved: false }
     canvas.releasePointerCapture(event.pointerId)
   })

package/dist/application/migrate-vault.js ADDED Viewed

@@ -0,0 +1,61 @@
+import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, extname, isAbsolute, join, relative } from 'node:path';
+import { ensureVault, listVaultFiles, resolveVaultPath } from '../infrastructure/file-system-vault.js';
+const directoryMode = 0o700;
+const fileMode = 0o600;
+const timestamp = () => new Date().toISOString().replace(/[-:]/g, '').replace(/\..+$/, 'Z');
+const isPathInside = (parent, child) => {
+    const path = relative(parent, child);
+    return path === '' || (!path.startsWith('..') && !isAbsolute(path));
+};
+const conflictPath = (targetPath) => {
+    const extension = extname(targetPath);
+    const base = extension ? targetPath.slice(0, -extension.length) : targetPath;
+    return `${base}.conflict-${timestamp()}${extension}`;
+};
+const writePreservedFile = async (absolutePath, content) => {
+    await mkdir(dirname(absolutePath), { recursive: true, mode: directoryMode });
+    await writeFile(absolutePath, content, { mode: fileMode });
+    await chmod(absolutePath, fileMode);
+};
+export const migrateVaultContent = async (sourceVault, targetVault) => {
+    const source = await ensureVault(sourceVault);
+    const target = await ensureVault(targetVault);
+    if (source === target) {
+        return { source, target, copied: 0, unchanged: 0, conflicted: 0 };
+    }
+    const sourceFiles = await listVaultFiles(source);
+    const migrated = await sourceFiles.reduce(async (statePromise, sourceFile) => {
+        const state = await statePromise;
+        const targetFile = join(target, relative(source, sourceFile));
+        if (!isPathInside(target, targetFile)) {
+            return state;
+        }
+        const sourceContent = await readFile(sourceFile);
+        try {
+            const targetContent = await readFile(targetFile);
+            if (sourceContent.equals(targetContent)) {
+                return { ...state, unchanged: state.unchanged + 1 };
+            }
+            await writePreservedFile(conflictPath(targetFile), sourceContent);
+            return { ...state, conflicted: state.conflicted + 1 };
+        }
+        catch (error) {
+            if (!(error instanceof Error) || !('code' in error) || error.code !== 'ENOENT') {
+                throw error;
+            }
+            await writePreservedFile(targetFile, sourceContent);
+            return { ...state, copied: state.copied + 1 };
+        }
+    }, Promise.resolve({ source, target, copied: 0, unchanged: 0, conflicted: 0 }));
+    return migrated;
+};
+export const shouldMigrateDefaultVault = async (sourceVault, targetVault) => {
+    const source = resolveVaultPath(sourceVault);
+    const target = resolveVaultPath(targetVault);
+    if (source === target) {
+        return false;
+    }
+    const [sourceFiles, targetFiles] = await Promise.all([listVaultFiles(source), listVaultFiles(target)]);
+    return sourceFiles.length > 0 && targetFiles.length === 0;
+};

package/dist/cli/commands/write-commands.js CHANGED Viewed

@@ -1,9 +1,11 @@
 import { readFileSync } from 'node:fs';
 import { addNote } from '../../application/add-note.js';
 import { indexVault } from '../../application/index-vault.js';
+import { migrateVaultContent, shouldMigrateDefaultVault } from '../../application/migrate-vault.js';
 import { startServer } from '../../application/start-server.js';
 import { startVaultWatcher } from '../../application/watch-vault.js';
 import { doctorVault } from '../../application/analyze-vault.js';
+import { defaultBrainlinkConfig } from '../../infrastructure/config.js';
 import { loadBrainlinkConfig } from '../../infrastructure/config.js';
 import { assertVaultAllowed, ensureVault } from '../../infrastructure/file-system-vault.js';
 import { parsePositiveInteger, print, resolveOptions } from '../runtime.js';
@@ -20,12 +22,26 @@ export const registerWriteCommands = (program) => {
     program
         .command('init')
         .argument('[vault]', 'vault directory')
+        .option('--migrate-from <vault>', 'copy existing vault content into the initialized vault')
+        .option('--no-migrate-existing', 'skip automatic migration from the default Brainlink vault into an empty custom vault')
         .option('--json', 'print machine-readable JSON')
         .description('initialize a Brainlink vault')
         .action(async (vault, options) => {
         const config = await loadBrainlinkConfig();
-        const path = await ensureVault(assertVaultAllowed(vault ?? config.vault, config.allowedVaults));
-        print(options.json, { path }, () => `Initialized Brainlink vault at ${path}`);
+        const targetVault = assertVaultAllowed(vault ?? config.vault, config.allowedVaults);
+        const path = await ensureVault(targetVault);
+        const explicitSource = options.migrateFrom ? assertVaultAllowed(options.migrateFrom, config.allowedVaults) : undefined;
+        const shouldAutoMigrate = explicitSource === undefined &&
+            options.migrateExisting !== false &&
+            (await shouldMigrateDefaultVault(defaultBrainlinkConfig.vault, targetVault));
+        const migration = explicitSource || shouldAutoMigrate ? await migrateVaultContent(explicitSource ?? defaultBrainlinkConfig.vault, targetVault) : undefined;
+        const index = migration && migration.copied + migration.conflicted > 0 ? await indexVault(targetVault) : undefined;
+        print(options.json, { path, ...(migration ? { migration } : {}), ...(index ? { index } : {}) }, () => {
+            const migrated = migration
+                ? ` Migrated ${migration.copied} files, preserved ${migration.conflicted} conflicts and kept ${migration.unchanged} unchanged files.`
+                : '';
+            return `Initialized Brainlink vault at ${path}.${migrated}`;
+        });
     });
     program
         .command('add')

package/dist/infrastructure/file-system-vault.js CHANGED Viewed

@@ -16,6 +16,17 @@ const walkMarkdownFiles = async (directory) => {
     }));
     return nested.flat();
 };
+const walkVaultFiles = async (directory) => {
+    const entries = await readdir(directory, { withFileTypes: true });
+    const nested = await Promise.all(entries.map(async (entry) => {
+        const absolutePath = join(directory, entry.name);
+        if (entry.isDirectory()) {
+            return excludedDirectories.has(entry.name) ? [] : walkVaultFiles(absolutePath);
+        }
+        return entry.isFile() ? [absolutePath] : [];
+    }));
+    return nested.flat();
+};
 export const resolveVaultPath = (vaultPath) => isBucketVaultUri(vaultPath) ? getBucketVaultCachePath(vaultPath) : resolvePath(vaultPath);
 export const isBucketVaultPath = (vaultPath) => isBucketVaultUri(vaultPath);
 const isPathInside = (parent, child) => {
@@ -65,6 +76,10 @@ export const readMarkdownFiles = async (vaultPath) => {
         };
     }));
 };
+export const listVaultFiles = async (vaultPath) => {
+    const absoluteVaultPath = await ensureVault(vaultPath);
+    return walkVaultFiles(absoluteVaultPath);
+};
 export const writeMarkdownFile = async (vaultPath, filename, content) => {
     if (isBucketVaultUri(vaultPath)) {
         return writeBucketMarkdownFile(vaultPath, filename, content);

package/docs/AGENT_USAGE.md CHANGED Viewed

@@ -341,7 +341,7 @@ $HOME/.brainlink/vault/
   .brainlink/
 ```
-`blink init ./vault` creates a custom vault instead.
+`blink init ./vault` creates a custom vault instead. If the custom vault is empty and the default `$HOME/.brainlink/vault` already has Markdown memory, Brainlink copies that content into the custom vault and reindexes it. Use `blink init ./vault --no-migrate-existing` to intentionally start empty, or `blink init ./vault --migrate-from <old-vault>` to migrate from a specific previous vault. Existing target files are not overwritten; conflicting source files are preserved with a `.conflict-<timestamp>` suffix.
 ### Add A Note

package/package.json CHANGED Viewed

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