Changelog - 2026-01-28 (#1)

Enhanced Memo Rendering Pipeline with Citations and Image Proxy

Overview

Upgraded the investment memo rendering system to use the same full-featured markdown pipeline as changelog entries. Added support for citations from frontmatter, syntax highlighting, Mermaid diagrams, and a server-side image proxy for serving assets from the private GitHub repository.

Changes

1. Full Markdown Pipeline

Memos now use the complete unified pipeline with all features:

const processor = unified()
  .use(remarkParse)
  .use(remarkGfm)
  .use(remarkRehype, { allowDangerousHtml: true })
  .use(rehypeMermaidPre)      // Extract mermaid blocks
  .use(rehypeMemoImages, slug) // Rewrite image URLs
  .use(rehypeShiki, {          // Syntax highlighting
    themes: { light: 'github-light', dark: 'tokyo-night' },
    addLanguageClass: true,
  })
  .use(rehypeStringify, { allowDangerousHtml: true });

Features enabled:

• GitHub Flavored Markdown (tables, strikethrough, task lists)

• Shiki syntax highlighting with dual themes

• Mermaid diagram rendering

• ContentEnhancer wrapper (code block headers, copy buttons)

2. Citation System Integration

Memos can now include citations in YAML frontmatter:

---
title: Investment Memo
citations:
  mkt001:
    title: "Market Analysis Report 2024"
    url: "https://example.com/report"
    source: "Gartner"
    publishedDate: "2024-06-15"
  tech002:
    title: "Technology Trends"
    url: "https://example.com/tech"
    source: "MIT Technology Review"
---

Citations are rendered as a Sources section at the bottom of the memo with sequential indices.

3. Image Proxy API

Created /api/memo-image/[...path].ts to serve images from the private GitHub repository:

Features:

• Fetches images using GITHUB_CONTENT_PAT

• Returns proper content types (PNG, JPEG, SVG, WebP)

• 1-hour cache for performance

• Falls back to local filesystem when PAT not configured

• Requires portfolio access cookie for authentication

URL Mapping:

4. Image URL Rewriting Plugin

Created rehypeMemoImages rehype plugin to transform relative image paths in memo markdown:

5. Local Fallback for Development

Updated fetchMemoBySlug to fall back to src/content/markdown-memos/ when:

• GitHub fetch fails (for simple slugs like sample-memo)

• PAT not configured

This enables local testing without GitHub API access.

6. Workspace Configuration Fix

Added sites/dark-matter to pnpm-workspace.yaml to fix dependency resolution issues where packages were not being properly symlinked.

Environment Variables

The memo system uses these environment variables (configured in Vercel):

Architecture

flowchart TD
    A[/memos/slug] --> B{Auth Cookie?}
    B -->|No| C[Redirect to Gate]
    B -->|Yes| D[fetchMemoBySlug]
    D --> E{GitHub PAT?}
    E -->|Yes| F[Fetch from GitHub]
    E -->|No| G[Read Local Files]
    F --> H[Parse Frontmatter]
    G --> H
    H --> I[Process Markdown]
    I --> J[rehypeMemoImages]
    J --> K[rehypeShiki]
    K --> L[Render HTML]
    L --> M[ContentEnhancer]
    M --> N[Display Memo]

    O[Image Request] --> P[/api/memo-image/...]
    P --> Q{Auth Cookie?}
    Q -->|No| R[401 Unauthorized]
    Q -->|Yes| S[Fetch from GitHub]
    S --> T[Return Image]

Updated README

Added comprehensive documentation for the memo system including:

• Configuration environment variables

• Markdown rendering pipeline

• Citation support

• Slug-to-path derivation table

• Latest version discovery algorithm

• Local development mode

• File structure overview