release: v1.6.4

Author: Jacobinwwey

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "noteconnection",
-  "version": "1.6.3",
+  "version": "1.6.4",
   "description": "Hierarchical Knowledge Graph Visualization System",
   "main": "dist/src/server.js",
   "bin": {

package.json

@@ -4,6 +4,13 @@ import * as os from 'os';
 
 export class CrashLogger {
     private static logFilePath = path.join(process.cwd(), 'crash.log');
+    private static globalHandlersInstalled = false;
+
+    static isIgnorableProcessWriteError(error: unknown): boolean {
+        const code = typeof error === 'object' && error ? String((error as { code?: unknown }).code || '') : '';
+        const syscall = typeof error === 'object' && error ? String((error as { syscall?: unknown }).syscall || '') : '';
+        return code === 'EPIPE' || code === 'ERR_STREAM_DESTROYED' || (code === 'EOF' && syscall === 'write');
+    }
 
     static log(error: any, context: string = 'General') {
         const timestamp = new Date().toISOString();
@@ -23,13 +30,24 @@ export class CrashLogger {
     }
 
     static initGlobalHandlers() {
+        if (this.globalHandlersInstalled) {
+            return;
+        }
+        this.globalHandlersInstalled = true;
+
         process.on('uncaughtException', (error) => {
+            if (CrashLogger.isIgnorableProcessWriteError(error)) {
+                return;
+            }
             console.error('Uncaught Exception:', error);
             CrashLogger.log(error, 'UncaughtException');
             process.exit(1); // Exit is mandatory for uncaught exceptions to avoid undefined state
         });
 
         process.on('unhandledRejection', (reason, promise) => {
+            if (CrashLogger.isIgnorableProcessWriteError(reason)) {
+                return;
+            }
             console.error('Unhandled Rejection at:', promise, 'reason:', reason);
             CrashLogger.log(reason, 'UnhandledRejection');
         });

src/backend/utils/CrashLogger.ts

@@ -0,0 +1,25 @@
+import { CrashLogger } from './backend/utils/CrashLogger';
+
+describe('CrashLogger broken pipe policy', () => {
+  test('treats write-side EPIPE and destroyed stream errors as ignorable process shutdown noise', () => {
+    expect(
+      CrashLogger.isIgnorableProcessWriteError(
+        Object.assign(new Error('write EPIPE'), { code: 'EPIPE', syscall: 'write' })
+      )
+    ).toBe(true);
+    expect(
+      CrashLogger.isIgnorableProcessWriteError(
+        Object.assign(new Error('stream destroyed'), { code: 'ERR_STREAM_DESTROYED' })
+      )
+    ).toBe(true);
+  });
+
+  test('does not suppress unrelated runtime exceptions', () => {
+    expect(
+      CrashLogger.isIgnorableProcessWriteError(
+        Object.assign(new Error('permission denied'), { code: 'EACCES', syscall: 'open' })
+      )
+    ).toBe(false);
+    expect(CrashLogger.isIgnorableProcessWriteError(new Error('boom'))).toBe(false);
+  });
+});

src/crashlogger.contract.test.ts

@@ -26,10 +26,11 @@ describe('NoteMD API contract wiring', () => {
     });
   });
 
-  test('server persists NoteMD settings in runtime data directory', () => {
-    expect(serverSource).toContain('NOTEMD_CONFIG_FILE_NAME');
+  test('server persists NoteMD settings through app_config.toml helpers', () => {
+    expect(serverSource).toContain("from './notemd/AppConfigToml'");
+    expect(serverSource).toContain('loadAppConfigToml');
+    expect(serverSource).toContain('saveAppConfigToml');
     expect(serverSource).toContain('persistNotemdSettings');
     expect(serverSource).toContain('loadNotemdSettings');
   });
 });
-

src/notemd.api.contract.test.ts

@@ -18,12 +18,14 @@ describe('pkg snapshot safety contract', () => {
     });
   });
 
-  test('reader and source manager keep static import fallback paths for packaging', () => {
+  test('reader and source manager keep packaging-safe Mermaid/runtime fallback paths', () => {
     const readerRenderer = fs.readFileSync(runtimeEntryFiles[0], 'utf8');
     const sourceManager = fs.readFileSync(runtimeEntryFiles[2], 'utf8');
 
     expect(readerRenderer).toContain('loadMermaidModule');
-    expect(readerRenderer).toContain("import('mermaid')");
+    expect(readerRenderer).toContain('MERMAID_BROWSER_BUNDLE_BASE64');
+    expect(readerRenderer).toContain("createElement('script')");
+    expect(readerRenderer).not.toContain("require('mermaid')");
     expect(sourceManager).toContain('parseGraphDataPayload');
     expect(sourceManager).toContain('Fallback for assignment-based payloads without using runtime eval.');
   });

src/pkg.snapshot.safety.contract.test.ts

@@ -1,3 +1,4 @@
+import fs from 'node:fs';
 import { execFileSync } from 'node:child_process';
 import path from 'node:path';
 import { JSDOM } from 'jsdom';
@@ -96,6 +97,14 @@ describe('reader_renderer', () => {
         });
     }, 120000);
 
+    it('keeps the compiled Mermaid loader on the embedded browser runtime path instead of requiring the ESM package directly', () => {
+        const compiledRenderer = fs.readFileSync(distRendererPath, 'utf8');
+
+        expect(compiledRenderer).not.toContain("require('mermaid')");
+        expect(compiledRenderer).toContain('MERMAID_BROWSER_BUNDLE_BASE64');
+        expect(compiledRenderer).toContain("createElement('script')");
+    });
+
     it('renders display math to svg', () => {
         const svg = runRenderer('renderMathSvg', 'E = mc^2', { displayMode: true });
 

src/reader_renderer.test.ts

@@ -12,7 +12,6 @@ const { HandlerList } = require('mathjax-full/js/core/HandlerList.js');
 const { HTMLHandler } = require('mathjax-full/js/handlers/html/HTMLHandler.js');
 const { initWasm, Resvg } = require('@resvg/resvg-wasm');
 
-const importMermaidModule = (): Promise<any> => import('mermaid');
 const MATH_TEXT_COLOR = '#eef4ff';
 const MERMAID_BACKGROUND = 'transparent';
 const MERMAID_PADDING = 28;
@@ -104,7 +103,6 @@ const mathDocument = mathHandlers.document('', {
 });
 
 let mermaidEnvironmentPromise: Promise<MermaidEnvironment> | null = null;
-let mermaidModulePromise: Promise<any> | null = null;
 let mermaidRenderQueue: Promise<unknown> = Promise.resolve();
 let mermaidRenderCounter = 0;
 let resvgInitPromise: Promise<void> | null = null;
@@ -468,14 +466,9 @@ async function createMermaidEnvironment(theme: 'dark' | 'default'): Promise<Merm
 }
 
 async function loadMermaidModule(window: JSDOM['window']): Promise<any> {
-    if (!(process as any).pkg) {
-        if (!mermaidModulePromise) {
-            mermaidModulePromise = (async () => {
-                const mermaidModule = await importMermaidModule();
-                return mermaidModule.default ?? mermaidModule;
-            })();
-        }
-        return mermaidModulePromise;
+    const existingMermaid = (window as any).mermaid;
+    if (existingMermaid) {
+        return existingMermaid;
     }
 
     const script = window.document.createElement('script');
@@ -1604,5 +1597,3 @@ function isFiniteBounds(bounds: Bounds): boolean {
 
 
 
-
-

src/reader_renderer.ts

@@ -119,6 +119,14 @@ describe('server ephemeral port fallback policy contract', () => {
   let envRestorers: Array<() => void> = [];
   let originalArgv: string[] = [];
 
+  test('server installs stdio broken-pipe guards before emitting fallback logs', () => {
+    const serverSource = fs.readFileSync(path.join(__dirname, 'server.ts'), 'utf8');
+
+    expect(serverSource).toContain('installBrokenPipeGuard(process.stdout');
+    expect(serverSource).toContain('installBrokenPipeGuard(process.stderr');
+    expect(serverSource).toContain("error?.code === 'EPIPE'");
+  });
+
   beforeEach(() => {
     tempProject = makeTempProject('noteconnection-port-policy');
     const projectRoot = path.join(tempProject.root, 'project');