⚡ Quartz & OMP Speed Optimization & Session Report

Session Core: Visual, compilation, and runtime performance optimization for Quartz SSOT, Showcase, and OMP (Persistent Intelligence) systems.

🚀 Performance Metrics & Impact Dashboard

Target / Metric	Before	After	Improvement	Primary Optimization Mechanism
Quartz Clean Build	`37,663ms`	`6,000ms`	~6.3x faster	Shallow HAST mapping, Promise parallelization, cache fixes
Typecheck + Lint	`21,000ms`	`6,750ms`	~3.1x faster	TS path de-duplication, Prettier path exclusion
Prettier formatting	`10,500ms`	`1,900ms`	~5.5x faster	Excluding `local-plugins/` nested node_modules scanning
Repeated Startup Latency	`1,000ms`	`~50ms`	~20.0x faster	Fixed invalid cache paths and single-thread checks
OMP Telemetry Overhead	N/A	`<5ms`	High Performance	AsyncLocalStorage context caching & static imports

Symbol Resolution De-duplication: Configured "paths" in tsconfig.json to map duplicate preact and @quartz-community/types directly to root node_modules, reducing file parse count from 629 to 609.
Esbuild Path Overriding: Configured tsconfigRaw in esbuild.context options inside quartz/cli/handlers.js to clear path mappings for esbuild, preventing CommonJS wrap errors.
Cache Validity Correction: Aligned cache check directories to look inside quartz/.quartz-cache/ and bypassed worker checks during single-threaded builds.

Concurrent Processors: Wrapped Markdown parser (createFileParser) and HTML renderer (createMarkdownParser) in Promise.all maps.
Parallel Emitters: Converted dispatcher, assets, static, and component resource emitters to execute file writes and Preact page rendering concurrently.
O(N) HAST Traversal: Replaced the heavy $O (N \times D)$ structuredClone inside canvas-page plugin’s normalizeHastElement with a custom shallow-cloning recursive tree mapper.

SDK Instrumentation: Added Langfuse tracing, spans, and generations using AsyncLocalStorage to isolate long-term memory operations.
Static Module Imports: Replaced all dynamic imports with static imports in local OMP modules for strict compiler rule compliance.

Frictionless Chat: Enabled guest autologin header forwarding (X-User-Email, X-User-Name) and removed branding/iframe blocking from chat servers.
Layout Graph Re-anchoring: Repositioned the Quartz global network graph view below the sidebar navigation.
SSOT Bible & Canvas Schema: Updated content/bible.md to dictate that .canvas files must live as children in the navigation layout.

Esbuild tsconfig Override: When using paths mapping in tsconfig.json, always pass tsconfigRaw with empty paths to esbuild.context to prevent bundle inclusion of external dependencies.
Prettier Exclusions: Ensure quartz/!(local-plugins)/** is used in format commands to skip nested node_modules folders.
Local Plugin Rebuilds: If changes are made to local plugins in quartz/local-plugins/, compile them by running npm run build within their directory before executing the main Quartz build.