memory-journal-mcp 9.0.0 → 9.1.0

package/dist/{chunk-NVXCRDCO.js → chunk-LE6ZWUPK.js}

@@ -1,7 +1,8 @@
-import { createServer, initializeDependencies, globalSubscriptionManager, VectorSearchManager } from './chunk-IYZWMAA4.js';
-import { VERSION, logAgentIssue, DatabaseAdapterFactory, DEFAULT_AUDIT_LOG_MAX_SIZE_BYTES, logger, callTool, runAutoPrune, AuditLogger, exportEntriesToMarkdown, importMarkdownEntries, convertFile, processImportBatch } from './chunk-2UIMA6JF.js';
+import { createServer, initializeDependencies, VectorSearchManager } from './chunk-Y6MMKR2Z.js';
+import { logAgentIssue, DatabaseAdapterFactory, DEFAULT_AUDIT_LOG_MAX_SIZE_BYTES, logger, callTool, globalSubscriptionManager, runAutoPrune, AuditLogger, exportEntriesToMarkdown, importMarkdownEntries, convertFile, processImportBatch } from './chunk-T7SROBBV.js';
+import { VERSION } from './chunk-SGJU2DHU.js';
 import { ConfigurationError } from './chunk-E6IQP6PE.js';
-import { resolveProjectNumberFromPath, resolveWorkspaceId } from './chunk-AIWHVEOW.js';
+import { resolveProjectNumberFromPath, resolveWorkspaceId } from './chunk-D2FY6XS5.js';
 import { Command } from 'commander';
 import { match, P } from 'ts-pattern';
 import { z, ZodError } from 'zod';
@@ -532,7 +533,7 @@ var ConfigResolver = class {
     if (isCliSource) {
       value = this.cliOptions[cliKey];
       source = "cli";
-    } else if (envKey && process.env[envKey] !== void 0) {
+    } else if (envKey && process.env[envKey] !== void 0 && process.env[envKey] !== "") {
       value = process.env[envKey];
       source = "env";
     } else if (this.configFileOptions[cliKey] !== void 0) {
@@ -579,7 +580,7 @@ var ConfigResolver = class {
    */
   resolveInt(cliKey, envKey, min, max) {
     const val = this.resolve(cliKey, envKey);
-    if (val === void 0 || val === null) {
+    if (val === void 0 || val === null || typeof val === "string" && val.trim() === "") {
       return void 0;
     }
     return this._parseNumeric(val, cliKey, min, max, false);
@@ -589,7 +590,7 @@ var ConfigResolver = class {
    */
   resolveNumber(cliKey, envKey, min, max) {
     const val = this.resolve(cliKey, envKey);
-    if (val === void 0 || val === null) {
+    if (val === void 0 || val === null || typeof val === "string" && val.trim() === "") {
       return void 0;
     }
     return this._parseNumeric(val, cliKey, min, max, true);
@@ -599,7 +600,7 @@ var ConfigResolver = class {
    */
   resolveBool(cliKey, envKey) {
     const val = this.resolve(cliKey, envKey);
-    if (val === void 0) return void 0;
+    if (val === void 0 || val === null || typeof val === "string" && val.trim() === "") return void 0;
     if (typeof val === "boolean") return val;
     if (typeof val === "string") return val.toLowerCase() === "true";
     return Boolean(val);
@@ -667,6 +668,10 @@ function buildServerOptions(resolver, _options, _command, configErrors) {
   if (metricsPort) {
     process.env["MJ_METRICS_PORT"] = metricsPort;
   }
+  const authScopes = catchConfig(() => resolver.resolve("authScopes", "MCP_AUTH_SCOPES"), void 0);
+  if (authScopes !== void 0 && authScopes.trim() !== "") {
+    process.env["MCP_AUTH_SCOPES"] = authScopes.trim();
+  }
   const auditLogPath = catchConfig(() => resolver.resolve("auditLog", "AUDIT_LOG_PATH"), void 0);
   const auditConfig = auditLogPath ? {
     enabled: true,
@@ -719,7 +724,7 @@ function buildServerOptions(resolver, _options, _command, configErrors) {
     allowPlaintextLoopbackOAuth: catchConfig(() => resolver.resolveBool("oauthAllowPlaintextLoopback", "OAUTH_ALLOW_PLAINTEXT_LOOPBACK") ?? false, false),
     trustProxy: catchConfig(() => resolver.resolveBool("trustProxy", "TRUST_PROXY") ?? false, false),
     publicOrigin: catchConfig(() => resolver.resolve("publicOrigin", "PUBLIC_ORIGIN"), void 0),
-    codemodeInternalFullAccess: catchConfig(() => resolver.resolveBool("codemodeInternalFullAccess", "CODEMODE_INTERNAL_FULL_ACCESS") ?? true, true),
+    codemodeInternalFullAccess: catchConfig(() => resolver.resolveBool("codemodeInternalFullAccess", "CODEMODE_INTERNAL_FULL_ACCESS") ?? false, false),
     projectRegistry: catchConfig(() => {
       const raw = resolver.resolve("projectRegistry", "PROJECT_REGISTRY");
       if (raw === void 0 || raw === null || raw === "") return void 0;
@@ -804,7 +809,7 @@ function buildServerOptions(resolver, _options, _command, configErrors) {
       summaryCount: catchConfig(() => resolver.resolveInt("briefingSummaries", "BRIEFING_SUMMARY_COUNT") ?? 1, 1),
       includeTeam: catchConfig(() => resolver.resolveBool("briefingIncludeTeam", "BRIEFING_INCLUDE_TEAM") ?? false, false),
       issueCount: catchConfig(() => resolver.resolveInt("briefingIssues", "BRIEFING_ISSUE_COUNT") ?? 0, 0),
-      prCount: catchConfig(() => resolver.resolveInt("briefingPrs", "BRIEFING_PR_COUNT") ?? 0, 0),
+      prCount: catchConfig(() => resolver.resolveInt("briefingPrCount") ?? resolver.resolveInt("briefingPrs", "BRIEFING_PR_COUNT") ?? 0, 0),
       prStatusBreakdown: catchConfig(() => resolver.resolveBool("briefingPrStatus", "BRIEFING_PR_STATUS") ?? false, false),
       milestoneCount: catchConfig(() => resolver.resolveInt("briefingMilestones", "BRIEFING_MILESTONE_COUNT") ?? 3, 3),
       rulesFilePath: catchConfig(() => {
@@ -832,8 +837,8 @@ function buildServerOptions(resolver, _options, _command, configErrors) {
     },
     auditConfig,
     autoPruneIntervalMinutes: catchConfig(() => resolver.resolveInt("autoPruneInterval", "AUTO_PRUNE_INTERVAL_MINUTES", 0) ?? 0, 0),
-    archiveOlderThanDays: catchConfig(() => resolver.resolveNumber("archiveOlderThanDays", "ARCHIVE_OLDER_THAN_DAYS", 0), 14),
-    pruneOlderThanDays: catchConfig(() => resolver.resolveNumber("pruneOlderThanDays", "PRUNE_OLDER_THAN_DAYS", 0), 30),
+    archiveOlderThanDays: catchConfig(() => resolver.resolveNumber("archiveOlderThanDays", "ARCHIVE_OLDER_THAN_DAYS", 0) ?? 0, 0),
+    pruneOlderThanDays: catchConfig(() => resolver.resolveNumber("pruneOlderThanDays", "PRUNE_OLDER_THAN_DAYS", 0) ?? 0, 0),
     hardDeleteOlderThanDays: catchConfig(() => resolver.resolveNumber("hardDeleteOlderThanDays", "HARD_DELETE_OLDER_THAN_DAYS", 0) ?? 0, 0),
     pruneImportanceThreshold: catchConfig(() => {
       const val = resolver.resolve("pruneImportanceThreshold", "PRUNE_IMPORTANCE_THRESHOLD");
@@ -1010,19 +1015,24 @@ var adminPruneOptionsSchema = pruningOptionsSchema.extend(coreOptionsSchema.shap
   pruneOlderThanDays: z.coerce.number().optional(),
   hardDeleteOlderThanDays: z.coerce.number().optional(),
   importanceThreshold: z.coerce.number().optional(),
+  pruneImportanceThreshold: z.coerce.number().optional(),
   dryRun: z.boolean().optional(),
   excludeTags: z.string().optional()
 });
 var baseEntryOptionsSchema = z.object({
   file: z.string().optional(),
+  contentFile: z.string().optional(),
   content: z.string().optional(),
+  body: z.string().optional(),
   description: z.string().optional(),
   title: z.string().optional(),
   summary: z.string().optional(),
   type: z.string().optional(),
   category: z.string().optional(),
   tags: z.string().optional(),
+  tag: z.string().optional(),
   project: safeCoerceNumber,
+  projectNumber: safeCoerceNumber,
   project_number: safeCoerceNumber,
   trustScore: safeCoerceNumber,
   trust_score: safeCoerceNumber,
@@ -1069,7 +1079,7 @@ var ioImportMarkdownOptionsSchema = z.object({
 }).extend(coreOptionsSchema.shape).extend(databaseOptionsSchema.shape).extend(outputOptionsSchema.shape);
 var ioImportExternalOptionsSchema = z.object({
   dir: z.string().optional(),
-  format: z.enum(["notion", "obsidian"]).optional()
+  format: z.enum(["notion", "obsidian", "logseq"]).optional()
 }).extend(coreOptionsSchema.shape).extend(databaseOptionsSchema.shape).extend(outputOptionsSchema.shape);
 var visualizeOptionsSchema = z.object({
   out: z.string().optional(),
@@ -1234,6 +1244,7 @@ async function execAction(scriptPath, options, command) {
     process.stderr.write("Execution failed: " + (error instanceof Error ? error.message : String(error)) + "\n");
     process.exit(1);
   } finally {
+    configManager.close();
     if (runtime.auditLogger) await runtime.auditLogger.close();
     if (context.activeMetricsPath) await runtime.metrics.saveToFile(context.activeMetricsPath);
     db.close();
@@ -1326,13 +1337,14 @@ async function vacuumAction(options, command) {
 async function pruneAction(options, command) {
   const { db } = await getDb(options, command);
   try {
+    const rawExcludeTags = options.excludeTags ?? options.pruneExcludeTags;
     const result = await runAutoPrune(db, {
       archiveOlderThanDays: options.archiveOlderThanDays ?? 0,
       pruneOlderThanDays: options.pruneOlderThanDays ?? 0,
       hardDeleteOlderThanDays: options.hardDeleteOlderThanDays ?? 0,
-      importanceThreshold: options.importanceThreshold ?? 0.15,
-      dryRun: options.dryRun === true,
-      excludeTags: options.excludeTags ? options.excludeTags.split(",") : []
+      importanceThreshold: options.importanceThreshold ?? options.pruneImportanceThreshold ?? 0.15,
+      dryRun: options.dryRun === true || options.pruneDryRun === true,
+      excludeTags: rawExcludeTags ? rawExcludeTags.split(",") : []
     });
     if (options.json === true) {
       process.stdout.write(JSON.stringify(result) + "\n");
@@ -1360,9 +1372,9 @@ async function pruneAction(options, command) {
 async function auditAction(options, command) {
   const { db } = await getDb(options, command);
   try {
-    const auditLogPath = options.auditLog ?? process.env["MEMORY_JOURNAL_AUDIT_LOG"];
+    const auditLogPath = options.auditLog ?? process.env["AUDIT_LOG_PATH"] ?? process.env["MEMORY_JOURNAL_AUDIT_LOG"];
     if (!auditLogPath) {
-      throw new Error("Audit log path not configured (--audit-log or MEMORY_JOURNAL_AUDIT_LOG)");
+      throw new Error("Audit log path not configured (--audit-log or AUDIT_LOG_PATH)");
     }
     const logger2 = new AuditLogger({
       logPath: auditLogPath,
@@ -1402,8 +1414,6 @@ async function rebuildIndexAction(options, command) {
     db.close();
   }
 }
-var createEntrySchema = createEntryOptionsSchema;
-var updateEntrySchema = updateEntryOptionsSchema;
 async function getDb2(options, command) {
   let resolver;
   const configPath2 = options.config ?? process.env["MEMORY_JOURNAL_CONFIG"];
@@ -1423,7 +1433,9 @@ async function getDb2(options, command) {
   }
   const useTeamDb = options.team === true;
   if (useTeamDb && typeof serverOptions.teamDbPath !== "string") {
-    process.stderr.write("Error: Cannot use --team flag because no team database is configured.\n");
+    process.stderr.write(
+      "Error: Cannot use --team flag because no team database is configured.\n"
+    );
     process.exit(1);
   }
   const dbPath = useTeamDb ? String(serverOptions.teamDbPath) : serverOptions.dbPath;
@@ -1444,7 +1456,9 @@ async function parseContent(options) {
     let stdinStr = "";
     const timeout = setTimeout(() => {
       if (stdinStr.length === 0) {
-        process.stderr.write("Error: Timed out waiting for stdin. You must provide --file or --content when running in a non-interactive shell.\n");
+        process.stderr.write(
+          "Error: Timed out waiting for stdin. You must provide --file or --content when running in a non-interactive shell.\n"
+        );
         process.exit(1);
       }
     }, 3e3);
@@ -1483,7 +1497,9 @@ async function parseContent(options) {
     p.outro("Proceeding with entry creation...");
     return contentPrompt;
   }
-  process.stderr.write("Error: Must provide either --file, --content, pipe data to stdin, or run interactively\n");
+  process.stderr.write(
+    "Error: Must provide either --file, --content, pipe data to stdin, or run interactively\n"
+  );
   process.exit(1);
 }
 function parseFrontmatter(rawContent) {
@@ -1522,8 +1538,10 @@ function parseRelationships(relationshipsStr, relFileStr) {
     try {
       str = readFileSync(relFileStr, "utf-8");
     } catch (e) {
-      process.stderr.write(`Warning: Failed to read --rel-file: ${e instanceof Error ? e.message : String(e)}
-`);
+      process.stderr.write(
+        `Warning: Failed to read --rel-file: ${e instanceof Error ? e.message : String(e)}
+`
+      );
     }
   }
   if (typeof str !== "string") return [];
@@ -1537,11 +1555,15 @@ function parseRelationships(relationshipsStr, relFileStr) {
           target_id: Number(rec["target_id"]),
           relation_type: String(rec["relation_type"])
         };
-      }).filter((r) => r !== null && !isNaN(r.target_id) && Boolean(r.relation_type));
+      }).filter(
+        (r) => r !== null && !isNaN(r.target_id) && Boolean(r.relation_type)
+      );
     }
   } catch (e) {
-    process.stderr.write(`Warning: Failed to parse relationships JSON: ${e instanceof Error ? e.message : String(e)}
-`);
+    process.stderr.write(
+      `Warning: Failed to parse relationships JSON: ${e instanceof Error ? e.message : String(e)}
+`
+    );
   }
   return [];
 }
@@ -1554,8 +1576,10 @@ function parseMetadata(metadataFile) {
       return z.record(z.string(), z.unknown()).parse(parsed);
     }
   } catch (e) {
-    process.stderr.write(`Warning: Failed to parse --metadata JSON: ${e instanceof Error ? e.message : String(e)}
-`);
+    process.stderr.write(
+      `Warning: Failed to parse --metadata JSON: ${e instanceof Error ? e.message : String(e)}
+`
+    );
   }
   return {};
 }
@@ -1569,19 +1593,18 @@ function buildEntryPayload(options, metadata, config) {
   } else if (metadata["tags"] !== void 0 && metadata["tags"] !== null) {
     tags = Array.isArray(metadata["tags"]) ? metadata["tags"].map(String) : void 0;
   }
-  const projectRaw = options.project ?? options.project_number ?? metadata["project"] ?? metadata["projectNumber"] ?? metadata["project_number"];
+  const projectRaw = options.project ?? options.projectNumber ?? options.project_number ?? metadata["project"] ?? metadata["projectNumber"] ?? metadata["project_number"];
   let projectNumber = projectRaw !== void 0 ? Number(projectRaw) : void 0;
   if (projectNumber === void 0 || isNaN(projectNumber)) {
-    const autoResolved = resolveProjectNumberFromPath(process.cwd());
-    if (autoResolved !== void 0) {
-      projectNumber = autoResolved;
-    } else {
-      projectNumber = void 0;
-    }
+    projectNumber = resolveProjectNumberFromPath(process.cwd());
   }
   const optsRec = z.record(z.string(), z.unknown()).parse(options);
   const explicitWorkspaceId = optsRec["workspaceId"] ?? optsRec["workspace_id"] ?? metadata["workspaceId"] ?? metadata["workspace_id"];
-  const workspaceId = resolveWorkspaceId(explicitWorkspaceId, projectNumber, config);
+  const workspaceId = resolveWorkspaceId(
+    explicitWorkspaceId,
+    projectNumber,
+    config
+  );
   const trustRaw = options.trustScore ?? options.trust_score ?? options.confidence ?? metadata["trust"] ?? metadata["trustScore"] ?? metadata["trust_score"] ?? metadata["confidence"];
   const trustScore = trustRaw !== void 0 ? Number(trustRaw) : void 0;
   const impactRaw = options.impactScore ?? options.impact_score ?? metadata["impact"] ?? metadata["impactScore"] ?? metadata["impact_score"];
@@ -1593,7 +1616,17 @@ function buildEntryPayload(options, metadata, config) {
       validationStatus = valStatusRaw ? "passed" : "failed";
     } else if (typeof valStatusRaw === "string") {
       const lower = valStatusRaw.trim().toLowerCase();
-      if (["passed", "pass", "success", "ok", "validated", "valid", "verified", "true", "1"].includes(lower)) {
+      if ([
+        "passed",
+        "pass",
+        "success",
+        "ok",
+        "validated",
+        "valid",
+        "verified",
+        "true",
+        "1"
+      ].includes(lower)) {
         validationStatus = "passed";
       } else if (["failed", "fail", "error", "failing", "false", "0"].includes(lower)) {
         validationStatus = "failed";
@@ -1612,8 +1645,10 @@ function buildEntryPayload(options, metadata, config) {
     try {
       autoContextStr = readFileSync(autoContextFile, "utf-8");
     } catch (e) {
-      process.stderr.write(`Warning: Failed to read --auto-context-file: ${e instanceof Error ? e.message : String(e)}
-`);
+      process.stderr.write(
+        `Warning: Failed to read --auto-context-file: ${e instanceof Error ? e.message : String(e)}
+`
+      );
     }
   } else if (autoContextStr === void 0 && metadata["auto_context"] !== void 0 && metadata["auto_context"] !== null) {
     autoContextStr = typeof metadata["auto_context"] === "string" ? metadata["auto_context"] : JSON.stringify(metadata["auto_context"]);
@@ -1628,7 +1663,9 @@ function buildEntryPayload(options, metadata, config) {
         target_id: Number(rec?.["target_id"]),
         relation_type: String(rec?.["relation_type"])
       };
-    }).filter((r) => !isNaN(r.target_id) && Boolean(r.relation_type) && r.relation_type !== "undefined");
+    }).filter(
+      (r) => !isNaN(r.target_id) && Boolean(r.relation_type) && r.relation_type !== "undefined"
+    );
   } else {
     relationships = parseRelationships(options.relationships, options.relFile);
   }
@@ -1650,27 +1687,66 @@ function buildEntryPayload(options, metadata, config) {
     relatedIds
   };
 }
-async function createEntryAction(...args2) {
-  const command = args2[args2.length - 1];
-  const options = args2.length > 1 ? args2[args2.length - 2] : {};
+
+// src/cli/commands/entry.ts
+var createEntrySchema = createEntryOptionsSchema;
+var updateEntrySchema = updateEntryOptionsSchema;
+function applyCliEntryFlagAliases(options, restArgs) {
   if (options.tag !== void 0 && options.tags === void 0) options.tags = options.tag;
-  if (options.contentFile !== void 0 && options.file === void 0) options.file = options.contentFile;
+  if (options.contentFile !== void 0 && options.file === void 0) {
+    options.file = options.contentFile;
+  }
   if (options.body !== void 0 && options.content === void 0) options.content = options.body;
-  if (options.validation !== void 0 && options.validationStatus === void 0) options.validationStatus = options.validation;
-  if (options.validation_status !== void 0 && options.validationStatus === void 0) options.validationStatus = options.validation_status;
-  if (options.workspace !== void 0 && options.workspaceId === void 0) options.workspaceId = options.workspace;
-  if (options.summary !== void 0 && options.title === void 0) options.title = options.summary;
-  const restArgs = args2.slice(0, args2.length - 2);
-  let contentArg = void 0;
-  if (restArgs.length > 0 && typeof restArgs[0] === "string") {
-    contentArg = restArgs.map(String).join(" ");
-  }
-  if (contentArg !== void 0 && options.content === void 0) {
-    options.content = contentArg;
+  if (options.validation !== void 0 && options.validationStatus === void 0) {
+    options.validationStatus = options.validation;
+  }
+  if (options.validation_status !== void 0 && options.validationStatus === void 0) {
+    options.validationStatus = options.validation_status;
+  }
+  if (options.workspace !== void 0 && options.workspaceId === void 0) {
+    options.workspaceId = options.workspace;
+  }
+  if (options.summary !== void 0 && options.title === void 0) {
+    options.title = options.summary;
+  }
+  if (restArgs.length > 0 && typeof restArgs[0] === "string" && options.content === void 0) {
+    options.content = restArgs.map(String).join(" ");
   }
   if (options.description !== void 0 && options.content === void 0) {
     options.content = options.description;
   }
+}
+function handleCliEntryError(e, actionLabel) {
+  if (e instanceof z.ZodError) {
+    const issues = e.issues;
+    if (issues.length > 0) {
+      process.stderr.write(
+        `Validation Error:
+${issues.map((err) => `- ${err.path.join(".")}: ${err.message}`).join("\n")}
+`
+      );
+    } else {
+      process.stderr.write(`Validation Error:
+${e.message}
+`);
+    }
+  } else if (e instanceof Error && e.message.includes("FOREIGN KEY constraint failed")) {
+    process.stderr.write(
+      `\u{1F6E0}\uFE0F AUTONOMOUS HEALING: A FOREIGN KEY constraint failed. This usually means a target_id specified in relationships (or relatedIds) does not exist, or the project ID is invalid. Ensure you are passing a valid Entry ID (not a project ID) for relationships, and a valid project ID.
+`
+    );
+  } else {
+    process.stderr.write(
+      `Failed to ${actionLabel} entry: ${e instanceof Error ? e.message : String(e)}
+`
+    );
+  }
+  process.exit(1);
+}
+async function createEntryAction(...args2) {
+  const command = args2[args2.length - 1];
+  const options = args2.length > 1 ? args2[args2.length - 2] : {};
+  applyCliEntryFlagAliases(options, args2.slice(0, args2.length - 2));
   const { db, config } = await getDb2(options, command);
   try {
     const rawContent = await parseContent(options);
@@ -1685,7 +1761,7 @@ ${content}`;
     const metadata = { ...frontmatter, ...parseMetadata(options.metadata) };
     const payload = buildEntryPayload(options, metadata, config);
     let resolvedWs = payload.workspaceId;
-    if (resolvedWs === "default" && config?.defaultWorkspaceId !== "default") {
+    if (resolvedWs === "default" && config.defaultWorkspaceId !== "default") {
       const optsRec = z.record(z.string(), z.unknown()).parse(options);
       const explicitWs = optsRec["workspaceId"] ?? optsRec["workspace_id"] ?? metadata["workspaceId"] ?? metadata["workspace_id"];
       if (explicitWs !== "default") {
@@ -1693,8 +1769,13 @@ ${content}`;
       }
     }
     z.object({
-      workspace_id: z.string().min(1, "workspace_id (repository name) is required. It could not be auto-resolved from project_number or current directory."),
-      project_number: z.number({ message: "project_number is required. Entries must be assigned to a valid project." })
+      workspace_id: z.string().min(
+        1,
+        "workspace_id (repository name) is required. It could not be auto-resolved from project_number or current directory."
+      ),
+      project_number: z.number({
+        message: "project_number is required. Entries must be assigned to a valid project."
+      })
     }).parse({ workspace_id: resolvedWs, project_number: payload.projectNumber });
     const entryInput = {
       content,
@@ -1717,30 +1798,15 @@ ${content}`;
     }
     db.flushSave();
     if (options.json === true) {
-      process.stdout.write(JSON.stringify({ status: "success", id: newEntry.id, version: newEntry.version }) + "\n");
+      process.stdout.write(
+        JSON.stringify({ status: "success", id: newEntry.id, version: newEntry.version }) + "\n"
+      );
     } else {
       process.stderr.write(`Successfully created entry #${newEntry.id}
 `);
     }
   } catch (e) {
-    if (e instanceof z.ZodError) {
-      const issues = e.issues;
-      if (issues.length > 0) {
-        process.stderr.write(`Validation Error:
-${issues.map((err) => `- ${err.path.join(".")}: ${err.message}`).join("\n")}
-`);
-      } else {
-        process.stderr.write(`Validation Error:
-${e.message}
-`);
-      }
-    } else if (e instanceof Error && e.message.includes("FOREIGN KEY constraint failed")) {
-      process.stderr.write(`\u{1F6E0}\uFE0F AUTONOMOUS HEALING: A FOREIGN KEY constraint failed. This usually means a target_id specified in relationships (or relatedIds) does not exist, or the project ID is invalid. Ensure you are passing a valid Entry ID (not a project ID) for relationships, and a valid project ID.
-`);
-    } else {
-      process.stderr.write("Failed to create entry: " + (e instanceof Error ? e.message : String(e)) + "\n");
-    }
-    process.exit(1);
+    handleCliEntryError(e, "create");
   } finally {
     db.close();
   }
@@ -1748,23 +1814,7 @@ ${e.message}
 async function updateEntryAction(...args2) {
   const command = args2[args2.length - 1];
   const options = args2.length > 1 ? args2[args2.length - 2] : {};
-  if (options.tag !== void 0 && options.tags === void 0) options.tags = options.tag;
-  if (options.contentFile !== void 0 && options.file === void 0) options.file = options.contentFile;
-  if (options.body !== void 0 && options.content === void 0) options.content = options.body;
-  if (options.validation !== void 0 && options.validationStatus === void 0) options.validationStatus = options.validation;
-  if (options.validation_status !== void 0 && options.validationStatus === void 0) options.validationStatus = options.validation_status;
-  if (options.workspace !== void 0 && options.workspaceId === void 0) options.workspaceId = options.workspace;
-  const restArgs = args2.slice(0, args2.length - 2);
-  let contentArg = void 0;
-  if (restArgs.length > 0 && typeof restArgs[0] === "string") {
-    contentArg = restArgs.map(String).join(" ");
-  }
-  if (contentArg !== void 0 && options.content === void 0) {
-    options.content = contentArg;
-  }
-  if (options.description !== void 0 && options.content === void 0) {
-    options.content = options.description;
-  }
+  applyCliEntryFlagAliases(options, args2.slice(0, args2.length - 2));
   const { db, config } = await getDb2(options, command);
   try {
     const entryId = options.id;
@@ -1774,7 +1824,9 @@ async function updateEntryAction(...args2) {
     }
     const version = options.expectedVersion;
     if (version === void 0 || isNaN(version)) {
-      process.stderr.write("Error: Must provide a valid --expected-version (expected version) to prevent concurrent overwrites\n");
+      process.stderr.write(
+        "Error: Must provide a valid --expected-version (expected version) to prevent concurrent overwrites\n"
+      );
       process.exit(1);
     }
     const rawContent = await parseContent(options);
@@ -1788,14 +1840,19 @@ ${content}`;
     }
     const metadata = { ...frontmatter, ...parseMetadata(options.metadata) };
     const payload = buildEntryPayload(options, metadata, config);
-    const updates = { content, expectedVersion: version };
+    const updates = {
+      content,
+      expectedVersion: version
+    };
     if (payload.entryType !== void 0) updates.entryType = payload.entryType;
     if (payload.tags !== void 0) updates.tags = payload.tags;
     if (payload.projectNumber !== void 0) updates.projectNumber = payload.projectNumber;
     if (payload.workspaceId !== void 0) updates.workspaceId = payload.workspaceId;
     if (payload.trustScore !== void 0) updates.trustScore = payload.trustScore;
     if (payload.impactScore !== void 0) updates.impactScore = payload.impactScore;
-    if (payload.validationStatus !== void 0) updates.validationStatus = payload.validationStatus;
+    if (payload.validationStatus !== void 0) {
+      updates.validationStatus = payload.validationStatus;
+    }
     if (payload.sessionId !== void 0) updates.sessionId = payload.sessionId;
     if (payload.autoContextStr !== void 0) updates.autoContext = payload.autoContextStr;
     const result = db.updateEntry(entryId, updates);
@@ -1812,30 +1869,17 @@ ${content}`;
     }
     db.flushSave();
     if (options.json === true) {
-      process.stdout.write(JSON.stringify({ status: "success", id: result.id, version: result.version }) + "\n");
+      process.stdout.write(
+        JSON.stringify({ status: "success", id: result.id, version: result.version }) + "\n"
+      );
     } else {
-      process.stderr.write(`Successfully updated entry #${result.id} to version ${result.version}
-`);
+      process.stderr.write(
+        `Successfully updated entry #${result.id} to version ${result.version}
+`
+      );
     }
   } catch (e) {
-    if (e instanceof z.ZodError) {
-      const issues = e.issues;
-      if (issues.length > 0) {
-        process.stderr.write(`Validation Error:
-${issues.map((err) => `- ${err.path.join(".")}: ${err.message}`).join("\n")}
-`);
-      } else {
-        process.stderr.write(`Validation Error:
-${e.message}
-`);
-      }
-    } else if (e instanceof Error && e.message.includes("FOREIGN KEY constraint failed")) {
-      process.stderr.write(`\u{1F6E0}\uFE0F AUTONOMOUS HEALING: A FOREIGN KEY constraint failed. This usually means a target_id specified in relationships (or relatedIds) does not exist, or the project ID is invalid. Ensure you are passing a valid Entry ID (not a project ID) for relationships, and a valid project ID.
-`);
-    } else {
-      process.stderr.write("Failed to update entry: " + (e instanceof Error ? e.message : String(e)) + "\n");
-    }
-    process.exit(1);
+    handleCliEntryError(e, "update");
   } finally {
     db.close();
   }
@@ -1927,21 +1971,55 @@ async function visualizeAction(options, command) {
       depth: 3,
       limit: 200
     });
+    const MERMAID_CONTENT_PREVIEW_LENGTH = 40;
     const mermaidLines = ["```mermaid", "graph TD"];
-    for (const node of graph.nodes) {
-      const safeLabel = node.label.replace(/"/g, "'").substring(0, 50);
-      mermaidLines.push(`    E${node.id}["#${node.id}: ${safeLabel}"]`);
-    }
-    mermaidLines.push("");
-    for (const edge of graph.edges) {
-      mermaidLines.push(`    E${edge.from} -->|${edge.label}| E${edge.to}`);
-    }
-    mermaidLines.push("");
-    for (const node of graph.nodes) {
-      if (node.group === "target") {
-        mermaidLines.push(`    style E${node.id} fill:#E3F2FD`);
-      } else {
-        mermaidLines.push(`    style E${node.id} fill:#FFF3E0`);
+    if (graph.nodes.length === 0) {
+      mermaidLines.push(
+        '    NoData["No entries found with relationships matching your criteria"]'
+      );
+    } else {
+      for (const node of graph.nodes) {
+        const rawContent = typeof node.metadata?.["content"] === "string" ? node.metadata["content"] : "";
+        if (rawContent !== "") {
+          let contentPreview = rawContent.slice(0, MERMAID_CONTENT_PREVIEW_LENGTH).replace(/\n/g, " ");
+          if (rawContent.length > MERMAID_CONTENT_PREVIEW_LENGTH) {
+            contentPreview += "...";
+          }
+          contentPreview = contentPreview.replace(/"/g, "'").replace(/\[/g, "(").replace(/\]/g, ")");
+          const entryTypeShort = node.group.slice(0, 20);
+          mermaidLines.push(
+            `    E${String(node.id)}["#${String(node.id)}: ${contentPreview}<br/>${entryTypeShort}"]`
+          );
+        } else {
+          const safeLabel = node.label.replace(/"/g, "'").substring(0, 50);
+          mermaidLines.push(`    E${String(node.id)}["#${String(node.id)}: ${safeLabel}"]`);
+        }
+      }
+      mermaidLines.push("");
+      const relSymbols = {
+        references: "-->",
+        implements: "==>",
+        clarifies: "-.->",
+        evolves_from: "-->",
+        response_to: "<-->",
+        blocked_by: "--x",
+        resolved: "==>",
+        caused: "-.->"
+      };
+      for (const edge of graph.edges) {
+        const arrow = relSymbols[edge.type] ?? "-->";
+        mermaidLines.push(
+          `    E${String(edge.from)} ${arrow}|${edge.type}| E${String(edge.to)}`
+        );
+      }
+      mermaidLines.push("");
+      for (const node of graph.nodes) {
+        const isPersonal = node.metadata !== void 0 && "is_personal" in node.metadata ? Boolean(node.metadata["is_personal"]) : node.group === "target";
+        if (isPersonal) {
+          mermaidLines.push(`    style E${String(node.id)} fill:#E3F2FD`);
+        } else {
+          mermaidLines.push(`    style E${String(node.id)} fill:#FFF3E0`);
+        }
       }
     }
     mermaidLines.push("```");
@@ -2330,7 +2408,7 @@ addAgentInstructions(
 \u{1F916} AI AGENT INSTRUCTIONS:
 - This is an agent-native CLI. 
 - ALWAYS use valid JSON strings for JSON arguments (e.g. \`--rel '[{"target_id":1,"relation_type":"relates_to"}]'\`).
-- If you forget project details, DO NOT hallucinate. Query \`memory://agent-context/{repo}\`.
+- If you forget project details, DO NOT hallucinate. Query \`memory://agent-context/{+repo}\`.
 - \u{1F6E0}\uFE0F AUTONOMOUS HEALING: DO NOT attempt to run \`node .../build/index.js\`. ALWAYS use the global \`memory-journal-mcp\` wrapper or \`bun src/cli/index.ts\`.`
 );
 var projectCmd = program.command("project").description("Manage projects in the memory-journal-mcp global registry");
@@ -2461,7 +2539,7 @@ addAgentInstructions(
 createEntryCmd.action(withValidation(createEntrySchema, createEntryAction));
 var updateEntryCmd = entryCmd.command("update [content]").description("Update an existing journal entry");
 withGroup(updateEntryCmd, "Command Options", (cmd) => {
-  cmd.option("--id <number>", "ID of the entry to update").option("--expected-version <number>", "Expected version of the entry (for concurrent modification safety)").option("-f, --file <path>", "Load new markdown content from a file").option("--content-file <file>", "Alias for --file (Auto-healing agent hallucination)").option("-c, --content <string>", "Raw new markdown content string").option("--body <string>", "Alias for --content (Auto-healing agent hallucination)").option("-d, --description <string>", "Alias for --content (Auto-healing agent hallucination)").option("--title <title>", "Optional title (will be prepended as an H1 to content if provided, for agent compatibility)").option("-t, --type <type>", "Entry type (e.g., retrospective, personal_reflection)").option("--category <type>", "Entry type (alias)").option("--tags <tags>", "Comma-separated tags (e.g., session-summary)").option("--tag <tags>", "Alias for --tags (Auto-healing agent hallucination)").option("--project, --project-number <number>", "Project number").option("--project_number <number>", "Project number (alias)").option("--trust, --trust-score <number>", "Trust score (0.0 to 1.0)").option("--trust_score <number>", "Trust score (0.0 to 1.0) (alias)").option("--impact, --impact-score <number>", "Impact score (0.0 to 1.0)").option("--impact_score <number>", "Impact score (0.0 to 1.0) (alias)").option("--validation-status <status>", "Validation status (passed|none|failed)").option("--validation_status <status>", "Validation status (passed|none|failed) (alias)").option("--validation <status>", "Validation status (passed|none|failed) (alias)").option("--session, --session-id <id>", "Session ID").option("--session_id <id>", "Session ID (alias)").option("--related-to <ids>", "Comma-separated entry IDs to relate to").option("--rel, --relationships <json>", "JSON string of relationships").option("--rel-file <path>", "Load relationships JSON from a file").option("--auto-context <json>", "JSON string for auto context").option("--auto-context-file <path>", "Load auto context JSON from a file").option("--metadata <path>", "Load unified metadata JSON from a file (overrides individual flags)").option("--team", "Route to team database");
+  cmd.option("--id <number>", "ID of the entry to update").option("--expected-version <number>", "Expected version of the entry (for concurrent modification safety)").option("-f, --file <path>", "Load new markdown content from a file").option("--content-file <file>", "Alias for --file (Auto-healing agent hallucination)").option("-c, --content <string>", "Raw new markdown content string").option("--body <string>", "Alias for --content (Auto-healing agent hallucination)").option("-d, --description <string>", "Alias for --content (Auto-healing agent hallucination)").option("--title <title>", "Optional title (will be prepended as an H1 to content if provided, for agent compatibility)").option("-t, --type <type>", "Entry type (e.g., retrospective, personal_reflection)").option("--category <type>", "Entry type (alias)").option("--tags <tags>", "Comma-separated tags (e.g., session-summary)").option("--tag <tags>", "Alias for --tags (Auto-healing agent hallucination)").option("-p, --project <number>", "Project number (alias)").option("--project-number <number>", "Project number").option("--project_number <number>", "Project number (alias)").option("--trust, --trust-score <number>", "Trust score (0.0 to 1.0)").option("--trust_score <number>", "Trust score (0.0 to 1.0) (alias)").option("--impact, --impact-score <number>", "Impact score (0.0 to 1.0)").option("--impact_score <number>", "Impact score (0.0 to 1.0) (alias)").option("--validation-status <status>", "Validation status (passed|none|failed)").option("--validation_status <status>", "Validation status (passed|none|failed) (alias)").option("--validation <status>", "Validation status (passed|none|failed) (alias)").option("--session, --session-id <id>", "Session ID").option("--session_id <id>", "Session ID (alias)").option("--related-to <ids>", "Comma-separated entry IDs to relate to").option("--rel, --relationships <json>", "JSON string of relationships").option("--rel-file <path>", "Load relationships JSON from a file").option("--auto-context <json>", "JSON string for auto context").option("--auto-context-file <path>", "Load auto context JSON from a file").option("--metadata <path>", "Load unified metadata JSON from a file (overrides individual flags)").option("--team", "Route to team database");
 });
 addOutputOptions(updateEntryCmd);
 addCoreOptions(updateEntryCmd);
@@ -2476,13 +2554,13 @@ addAgentInstructions(
 );
 updateEntryCmd.action(withValidation(updateEntrySchema, updateEntryAction));
 entryCmd.command("delete [args...]", { hidden: true }).allowUnknownOption().action(() => {
-  process.stderr.write(`\u{1F6E0}\uFE0F AUTONOMOUS HEALING: The 'entry delete' command does not exist in the CLI. Deleting entries is an admin-level operation. Please use the MCP tool 'mj_execute_code' with 'db.admin.batchDeleteEntries({ entry_ids: [...] })' instead.
+  process.stderr.write(`\u{1F6E0}\uFE0F AUTONOMOUS HEALING: The 'entry delete' command does not exist in the CLI. Deleting entries is an admin-level operation. Please use the MCP tool 'mj_execute_code' with 'mj.admin.batchDeleteEntries({ entry_ids: [...] })' instead.
 `);
   process.exit(1);
 });
 var searchCmd = program.command("search [query]").description("Search journal entries");
 withGroup(searchCmd, "Command Options", (cmd) => {
-  cmd.option("--query, -q <string>", "Search query (alias for positional argument)").option("--term <string>", "Search query (alias)").option("--keyword <string>", "Search query (alias)").option("--mode <mode>", "Search mode: auto, fts, semantic, hybrid", "auto").option("--limit <number>", "Maximum number of results to return", "50").option("--team", "Search team database");
+  cmd.option("-q, --query <string>", "Search query (alias for positional argument)").option("--term <string>", "Search query (alias)").option("--keyword <string>", "Search query (alias)").option("--mode <mode>", "Search mode: auto, fts, semantic, hybrid", "auto").option("--limit <number>", "Maximum number of results to return", "50").option("--team", "Search team database");
 });
 addOutputOptions(searchCmd);
 addCoreOptions(searchCmd);
@@ -2521,7 +2599,7 @@ addOutputOptions(importMarkdownCmd);
 importMarkdownCmd.action(withValidation(importMarkdownSchema, importMarkdownAction));
 var importExternalCmd = ioCmd.command("import-external").description("Import entries from external knowledge bases");
 withGroup(importExternalCmd, "Command Options", (cmd) => {
-  cmd.option("--dir <path>", "Source directory (required)").option("--format <format>", "External format: notion or obsidian (required)");
+  cmd.option("--dir <path>", "Source directory (required)").option("--format <format>", "External format: notion, obsidian, or logseq (required)");
 });
 addCoreOptions(importExternalCmd);
 addDatabaseOptions(importExternalCmd);