vault-go 0.24.0 → 0.25.0

package/dist/crystal-memory-mirror.d.ts

@@ -0,0 +1,18 @@
+import type { VaultMemoryApi } from './cloud.js';
+import type { ContextResult } from './context-engines.js';
+type MirrorJob = {
+    id: string;
+    projectId: string;
+    kind: string;
+    generate?: boolean;
+};
+export declare function shouldMirrorCrystalMemory(job: MirrorJob): boolean;
+export declare function crystalProjectFolder(project: unknown): string | null;
+export declare function resolveCrystalProjectFolder(cloud: Pick<VaultMemoryApi, 'projects'>, projectId: string): Promise<string | null>;
+export declare function mirrorCrystalMemory(input: {
+    home: string;
+    cloud: Pick<VaultMemoryApi, 'projects'>;
+    job: MirrorJob;
+    result: Pick<ContextResult, 'title' | 'content' | 'concepts'>;
+}): Promise<void>;
+export {};

package/dist/crystal-memory-mirror.js

@@ -0,0 +1,47 @@
+import { basename } from 'node:path';
+export function shouldMirrorCrystalMemory(job) {
+    if (job.kind === 'summary')
+        return true;
+    if (job.generate === false)
+        return true;
+    return false;
+}
+export function crystalProjectFolder(project) {
+    if (!project || typeof project !== 'object')
+        return null;
+    const rec = project;
+    if (typeof rec.name === 'string' && rec.name.trim())
+        return rec.name.trim();
+    if (typeof rec.rootPath === 'string' && rec.rootPath.trim()) {
+        const base = basename(rec.rootPath.replace(/\\/g, '/'));
+        return base || null;
+    }
+    return null;
+}
+export async function resolveCrystalProjectFolder(cloud, projectId) {
+    const projects = await cloud.projects().catch(() => null);
+    if (!Array.isArray(projects))
+        return null;
+    const found = projects.find((item) => item && typeof item === 'object' && item.id === projectId);
+    return crystalProjectFolder(found);
+}
+export async function mirrorCrystalMemory(input) {
+    if (!shouldMirrorCrystalMemory(input.job))
+        return;
+    const project = await resolveCrystalProjectFolder(input.cloud, input.job.projectId);
+    if (!project)
+        return;
+    try {
+        const { callCrystalTool } = await import('./crystal-tools.js');
+        await callCrystalTool(input.home, 'crystal_memory_write', {
+            project,
+            title: input.result.title,
+            content: input.result.content,
+            tags: input.result.concepts,
+            sourceId: `vault-go:event:${input.job.id}`,
+        });
+    }
+    catch {
+        // Crystal MCP is optional; account memory already persisted.
+    }
+}

package/dist/crystal-tools.js

@@ -103,4 +103,19 @@ export function registerCrystalTools(server, home) {
     add('delete', 'Exclui uma nota do Crystal.', { path: notePath }, false, true);
     add('sync', 'Sincroniza o Crystal com o Vault Cloud.', {}, false);
     add('status', 'Mostra o estado do Crystal e da sincronização.', {});
+    add('memory_list', 'Lista notas duráveis em {projeto}/Memory no Crystal.', { project: z.string().trim().min(1).max(200).optional() });
+    add('memory_write', 'Grava uma nota durável em {projeto}/Memory no Crystal.', {
+        project: z.string().trim().min(1).max(200),
+        content: z.string().max(10 * 1024 * 1024),
+        title: z.string().max(1000).optional(),
+        tags: z.array(z.string().max(200)).max(100).optional(),
+        sourceId: z.string().max(500).optional(),
+    }, false);
+    add('memory_append', 'Acrescenta texto a uma nota em {projeto}/Memory no Crystal.', {
+        project: z.string().trim().min(1).max(200),
+        content: z.string().max(10 * 1024 * 1024),
+        title: z.string().max(1000).optional(),
+        tags: z.array(z.string().max(200)).max(100).optional(),
+        sourceId: z.string().max(500).optional(),
+    }, false);
 }

package/dist/hook-queue.js

@@ -6,6 +6,7 @@ import { loadConfig, loadTokens, vaultHome } from './config.js';
 import { generateContext, selectedContextEngine } from './context-engines.js';
 import { notifyTelegramObservation } from './telegram.js';
 import { pushAwareness } from './grok-awareness.js';
+import { mirrorCrystalMemory } from './crystal-memory-mirror.js';
 const queuePath = (home) => join(home, 'generation-queue.json');
 function ownerKey(home) {
     const config = loadConfig(home);
@@ -161,6 +162,7 @@ export async function processGenerationQueue(home = vaultHome(), cloud = new Vau
             const awareness = await pushAwareness(home, { ...(job.agentId ? { agentId: job.agentId } : {}), observations: [{ type: memoryType, title: result.title || job.title || 'Memória', facts: result.facts, concepts: result.concepts }] });
             if (awareness.error)
                 throw new Error('Awareness delivery failed; retry with cached generation.');
+            await mirrorCrystalMemory({ home, cloud, job, result });
             await mutate(home, jobs => jobs.filter(item => item.id !== job.id));
             if (job.kind === 'observation' && owner === ownerKey(home)) {
                 try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vault-go",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "MCP server and installer for Vault Memory: search, capture, and use account memory across AI clients.",
   "type": "module",
   "bin": {
@@ -42,6 +42,8 @@
     "dist/config.d.ts",
     "dist/context-engines.js",
     "dist/context-engines.d.ts",
+    "dist/crystal-memory-mirror.js",
+    "dist/crystal-memory-mirror.d.ts",
     "dist/crystal-tools.js",
     "dist/crystal-tools.d.ts",
     "dist/hook-install.js",