@mindrian_os/cli 2.0.0-beta.29 → 2.0.0-beta.31

package/references/design/newsletter-email-template.html

@@ -0,0 +1,307 @@
+<!--
+  ============================================================================
+  MINDRIANOS NEWSLETTER EMAIL - CANONICAL TEMPLATE (M:OS Canonical Design System v1.1, cream)
+  ============================================================================
+  Canonizes the real shipped format (newsletter-04), redesigned 2026-07-23 (quick
+  task 260723-ooq) to break the monotone left-border-card repetition with full-bleed
+  Mondrian panels, add a real hero-image slot, and design the headline for the real
+  bold-Arial fallback (Impact is almost never installed). Re-skinned 2026-07-23
+  (quick task 260723-rln) from the retired DARK canon to the cream M:OS Canonical
+  Design System v1.1 that governs every other HTML surface in this repo (decks,
+  dashboards, wiki, exports, snapshots, hub/lobby) -- the terminal-island precedent
+  (challenge-seed box + command-chain box) is the one intentional exception that
+  stays dark, matching the website's own "dark is reserved for terminal islands
+  only" rule. This is the reusable template for every newsletter challenge email
+  to API-key holders.
+  Companion: references/design/email-template-standard.md (the component rules,
+  kept in sync with THIS file - this file is canonical, the .md is derived).
+
+  HOW TO USE
+    1. Copy this file. Replace every {{PLACEHOLDER}}.
+    2. Keep the structure + section order below. Do not invent new sections.
+    3. Run the 11-item check at the bottom before sending.
+    4. Recipients = active brain_api_keys (NOT cohort testers).
+
+  HARD RULES (cream M:OS canon)
+    - dir="ltr" on the outer table; text-align:left on EVERY content element.
+      Center ONLY: the top/bottom Mondrian bars and the gold READ-THE-STORY button text.
+    - 640px fixed width. Background #F4F2EC. Surface cards #FBFAF7. The two
+      terminal-island blocks (challenge-seed box, command-chain box) are the sole
+      exception and keep #0C0C0D dark backgrounds (D-01).
+    - Inline styles ONLY. NO <style> block (email clients strip it). NO web fonts
+      (Impact / Arial Black / Helvetica / Arial / Courier only). NO background images.
+    - NO border-radius (hard rectangles, De Stijl). NO emoji. NO em-dashes (use hyphens).
+    - Sender is always a PERSON (Jonathan / Larry), never "MindrianOS Team".
+    - Website link mindrian-os.com appears 3+ times (hero caption/READ button, docs link, sign-off).
+    - STEP 0 update callout is MANDATORY every issue (the version is the point).
+    - Feynman copy: plain words, "who cares / why" on every feature. No jargon dumps.
+    - Hero image src is a real public HTTPS URL (never local/scratchpad/data:).
+
+  DE STIJL PALETTE (cream M:OS Canonical Design System v1.1, hex verbatim from
+  skills/ui-system/design-system/mos-design-system.css)
+    Red #E11D22 | Yellow #FFC400 | Blue #1E52E0 | Gold/OS #C8A43C (restricted role - see below)
+    Paper #F4F2EC | Panel #FBFAF7 | Ink #0C0C0D | Muted #5B5B5B
+    Terminal-island token (D-01, theme-independent, matches pre.code): bg #0C0C0D, text #E8E8E2
+    Gold #C8A43C is now restricted to (a) background fills with dark ink text on top
+    (READ THE STORY button, CHALLENGE tab) and (b) text ONLY inside the two locked
+    terminal-island blocks (command-chain command names, seed-box border accent).
+    Every other TEXT usage of gold is blue #1E52E0 (fails WCAG AA as text on cream
+    at 2.13:1; blue passes at 5.62:1 and is M:OS's own semantic link color).
+
+  SECTION ORDER (fixed, 13 sections - hero image is new section 5)
+    1 Top Mondrian bar             8 STEP 0 update callout (full-bleed red panel)
+    2 Logo row                     9 What's-new cards (3, full-bleed/top-cap panels)
+    3 Headline (1 highlight)      10 The challenge + copy-paste seed (gold tab header)
+    4 Lede (the why, Feynman)     11 The command chain (gold cmd + terminal gloss + docs link)
+    5 Hero image (NEW)            12 Triple-feature related links (full-bleed ink panel)
+    6 READ THE STORY button       13 Reply CTA + sign-off (person + website)
+    7 (divider)                   14 Bottom Mondrian bar (mirror of top)
+  ============================================================================
+-->
+<!DOCTYPE html>
+<html lang="en" dir="ltr">
+<body style="margin:0;padding:0;background-color:#F4F2EC;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="background-color:#F4F2EC;">
+<tr><td style="padding:0;">
+<table role="presentation" width="640" cellpadding="0" cellspacing="0" border="0" style="margin:0;max-width:640px;">
+
+<!-- 1. TOP MONDRIAN BAR -->
+<tr><td style="padding:0;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td width="38%" height="10" style="background-color:#E11D22;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="8%" height="10" style="background-color:#0C0C0D;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="22%" height="10" style="background-color:#FFC400;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="6%" height="10" style="background-color:#0C0C0D;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="26%" height="10" style="background-color:#1E52E0;font-size:1px;line-height:1px;">&nbsp;</td>
+</tr></table>
+</td></tr>
+
+<!-- 2. LOGO ROW -->
+<tr><td style="padding:26px 32px 6px 32px;text-align:left;">
+<table role="presentation" cellpadding="0" cellspacing="0" border="0"><tr>
+<td style="background-color:#E11D22;width:14px;height:14px;font-size:1px;line-height:1px;">&nbsp;</td>
+<td style="width:6px;font-size:1px;">&nbsp;</td>
+<td style="background-color:#FFC400;width:14px;height:14px;font-size:1px;line-height:1px;">&nbsp;</td>
+<td style="width:6px;font-size:1px;">&nbsp;</td>
+<td style="background-color:#1E52E0;width:14px;height:14px;font-size:1px;line-height:1px;">&nbsp;</td>
+<td style="width:14px;font-size:1px;">&nbsp;</td>
+<td style="font-family:Impact,'Arial Black',Arial,sans-serif;font-size:24px;letter-spacing:2px;color:#0C0C0D;text-align:left;">MINDRIAN<span style="color:#1E52E0;">OS</span></td>
+</tr></table>
+</td></tr>
+
+<!-- 3. HEADLINE (exactly one yellow-highlighted phrase). Color-block treatment: thin
+     blue cap band directly above the headline row, plus full-bleed ink field extending
+     behind it, so the graphic punch comes from color-blocking, not from a typeface
+     most inboxes will only ever render as plain bold Arial (Impact is rarely installed).
+     The headline field is a De Stijl full-bleed dark panel and KEEPS its dark polarity
+     even on the cream page - text on it stays light. -->
+<tr><td style="padding:0;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td height="4" style="background-color:#1E52E0;font-size:1px;line-height:1px;">&nbsp;</td>
+</tr></table>
+</td></tr>
+<tr><td style="background-color:#0C0C0D;padding:20px 32px 18px 32px;text-align:left;">
+<div style="font-family:Impact,'Arial Black',Arial,sans-serif;font-size:38px;font-weight:900;letter-spacing:-0.01em;line-height:1.1;color:#F4F2EC;text-align:left;">{{HEADLINE_PRE}} <span style="color:#FFC400;">{{HEADLINE_HIGHLIGHT}}</span></div>
+</td></tr>
+
+<!-- 4. LEDE (the "why should we care", Feynman; 1-2 short paragraphs) -->
+<tr><td style="padding:20px 32px 0 32px;text-align:left;">
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:16px;line-height:1.6;color:#0C0C0D;text-align:left;">{{LEDE_1}}</div>
+</td></tr>
+<tr><td style="padding:14px 32px 0 32px;text-align:left;">
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:16px;line-height:1.6;color:#0C0C0D;text-align:left;">{{LEDE_2}}</div>
+</td></tr>
+
+<!-- 5. HERO IMAGE (NEW; hard-rectangle ink border, no border-radius; real public HTTPS src
+     required; D-02: border flips cream->ink against the cream page, image asset untouched) -->
+<tr><td style="padding:22px 32px 0 32px;text-align:left;">
+<img src="{{HERO_IMAGE_URL}}" alt="{{HERO_IMAGE_ALT}}" width="576" height="324" style="display:block;width:100%;max-width:576px;border:2px solid #0C0C0D;">
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:12px;line-height:1.5;color:#5B5B5B;text-align:left;padding-top:8px;">{{HERO_IMAGE_CAPTION}}</div>
+</td></tr>
+
+<!-- 6. READ THE STORY (gold button -> the blog editorial; website link #1; gold KEPT as a
+     background fill with dark ink text on top, 8.76:1, passes AA easily) -->
+<tr><td style="padding:22px 32px 6px 32px;text-align:left;">
+<table role="presentation" cellpadding="0" cellspacing="0" border="0"><tr>
+<td style="background-color:#C8A43C;padding:13px 26px;text-align:left;">
+<a href="https://mindrian-os.com/blog/{{STORY_SLUG}}" style="font-family:Impact,'Arial Black',Arial,sans-serif;font-size:16px;letter-spacing:1px;color:#0C0C0D;text-decoration:none;">READ THE STORY</a>
+</td>
+</tr></table>
+</td></tr>
+
+<!-- 7. divider -->
+<tr><td style="padding:24px 32px 0 32px;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td width="70%" height="4" style="background-color:#E11D22;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="30%" height="4" style="background-color:#1E52E0;font-size:1px;line-height:1px;">&nbsp;</td>
+</tr></table>
+</td></tr>
+
+<!-- 8. STEP 0 UPDATE CALLOUT (MANDATORY; genuine full-bleed #E11D22 red panel, paper
+     text sitting directly on the red field - a real alert block, not a rail-on-card;
+     full-bleed dark panel keeps its dark polarity, text stays light) -->
+<tr><td style="padding:24px 32px 0 32px;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td style="background-color:#E11D22;padding:18px 20px;text-align:left;">
+<div style="font-family:Impact,'Arial Black',Arial,sans-serif;font-size:18px;color:#F4F2EC;text-align:left;">STEP 0: UPDATE FIRST. THIS TIME IT IS THE POINT.</div>
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:14px;line-height:1.6;color:#F4F2EC;padding-top:8px;text-align:left;">Run <span style="font-family:Courier,Consolas,monospace;color:#F4F2EC;font-weight:bold;">/mos:update</span> in Claude Code, then restart your session. {{UPDATE_NOTE_NAMING_VERSION}} The challenge below leans on the newest routing, so update before you paste.</div>
+</td>
+</tr></table>
+</td></tr>
+
+<!-- 9. WHAT IS NEW, IN PLAIN WORDS (3 cards; differentiated panels, not 3 identical rails) -->
+<tr><td style="padding:26px 32px 0 32px;text-align:left;">
+<div style="font-family:Impact,'Arial Black',Arial,sans-serif;font-size:20px;color:#0C0C0D;text-align:left;">WHAT IS NEW IN MINDRIAN, IN PLAIN WORDS</div>
+</td></tr>
+
+<!-- card 1 (headline/most important): #FBFAF7 panel surface + full-width #FFC400 4px top-cap band -->
+<tr><td style="padding:14px 32px 0 32px;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td height="4" style="background-color:#FFC400;font-size:1px;line-height:1px;">&nbsp;</td>
+</tr></table>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td style="background-color:#FBFAF7;padding:16px 20px;text-align:left;">
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:14px;line-height:1.65;color:#0C0C0D;text-align:left;"><strong>{{WHATSNEW_1_HEAD}}</strong> {{WHATSNEW_1_BODY_with_who-cares_and_why}}</div>
+</td>
+</tr></table>
+</td></tr>
+
+<!-- card 2: genuine full-bleed #1E52E0 blue panel, paper text directly on the blue field
+     (full-bleed dark/saturated panel keeps its polarity, text stays light) -->
+<tr><td style="padding:10px 32px 0 32px;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td style="background-color:#1E52E0;padding:16px 20px;text-align:left;">
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:14px;line-height:1.65;color:#F4F2EC;text-align:left;"><strong>{{WHATSNEW_2_HEAD}}</strong> {{WHATSNEW_2_BODY}}</div>
+</td>
+</tr></table>
+</td></tr>
+
+<!-- card 3: #FBFAF7 panel surface + full-width #E11D22 4px top-cap band -->
+<tr><td style="padding:10px 32px 0 32px;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td height="4" style="background-color:#E11D22;font-size:1px;line-height:1px;">&nbsp;</td>
+</tr></table>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td style="background-color:#FBFAF7;padding:16px 20px;text-align:left;">
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:14px;line-height:1.65;color:#0C0C0D;text-align:left;"><strong>{{WHATSNEW_3_HEAD}}</strong> {{WHATSNEW_3_BODY}}</div>
+</td>
+</tr></table>
+</td></tr>
+
+<!-- 10. THE CHALLENGE + COPY-PASTE SEED (small full-bleed gold tab/flag on the section
+      header, echoing the logo row's colored squares, instead of plain text; the Courier
+      seed box below is a locked terminal-island block, D-01 -- keeps its dark
+      #0C0C0D background, gold left-border accent, and #E8E8E2 terminal text token) -->
+<tr><td style="padding:30px 32px 0 32px;text-align:left;">
+<table role="presentation" cellpadding="0" cellspacing="0" border="0"><tr>
+<td style="background-color:#C8A43C;padding:4px 10px;text-align:left;"><div style="font-family:Impact,'Arial Black',Arial,sans-serif;font-size:12px;letter-spacing:1px;color:#0C0C0D;text-align:left;">CHALLENGE</div></td>
+</tr></table>
+<div style="font-family:Impact,'Arial Black',Arial,sans-serif;font-size:20px;color:#0C0C0D;text-align:left;padding-top:10px;">{{CHALLENGE_TITLE}}</div>
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:14px;line-height:1.65;color:#0C0C0D;padding-top:8px;text-align:left;">{{CHALLENGE_INTRO}}</div>
+</td></tr>
+<tr><td style="padding:18px 32px 0 32px;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td style="background-color:#0C0C0D;border-left:4px solid #C8A43C;padding:18px 20px;text-align:left;">
+<div style="font-family:Courier,Consolas,monospace;font-size:12px;line-height:1.7;color:#E8E8E2;text-align:left;">{{SEED_PROMPT_with_[BRACKETED]_fill-ins_and_<br><br>_between_paragraphs}}</div>
+</td>
+</tr></table>
+</td></tr>
+
+<!-- 11. THE COMMAND CHAIN (gold cmd + terminal gloss text; docs link = website link #2.
+      Locked terminal-island block (D-01) -- keeps its dark #0C0C0D background, gold
+      command-name text, and #E8E8E2 gloss/caption text token. The docs link sits on
+      this same dark background, so it reuses the terminal-text token #E8E8E2
+      (~15.9:1 against #0C0C0D) rather than the cream-page link blue #1E52E0, which
+      only clears AA against #F4F2EC (~3.11:1 against #0C0C0D, fails AA). ) -->
+<tr><td style="padding:22px 32px 0 32px;text-align:left;">
+<div style="font-family:Impact,'Arial Black',Arial,sans-serif;font-size:16px;color:#0C0C0D;text-align:left;">THEN RUN THE CHAIN</div>
+</td></tr>
+<tr><td style="padding:10px 32px 0 32px;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr><td style="background-color:#0C0C0D;padding:14px 20px 4px 20px;font-family:Courier,Consolas,monospace;font-size:13px;line-height:2;color:#C8A43C;text-align:left;">
+{{MOS_CMD_1}}<span style="color:#E8E8E2;"> &nbsp;{{CMD_1_GLOSS}}</span><br>
+{{MOS_CMD_2}}<span style="color:#E8E8E2;"> &nbsp;{{CMD_2_GLOSS}}</span><br>
+{{MOS_CMD_3}}<span style="color:#E8E8E2;"> &nbsp;{{CMD_3_GLOSS}}</span><br>
+{{MOS_CMD_4}}<span style="color:#E8E8E2;"> &nbsp;{{CMD_4_GLOSS}}</span><br>
+{{MOS_CMD_5}}<span style="color:#E8E8E2;"> &nbsp;{{CMD_5_GLOSS}}</span><br>
+{{MOS_CMD_6}}<span style="color:#E8E8E2;"> &nbsp;{{CMD_6_GLOSS}}</span>
+</td></tr>
+<tr><td style="background-color:#0C0C0D;padding:0 20px 14px 20px;font-family:Helvetica,Arial,sans-serif;font-size:12px;color:#E8E8E2;text-align:left;">Every command is documented in the <a href="https://mindrian-os.com/docs" style="color:#E8E8E2;text-decoration:underline;">catalog at mindrian-os.com/docs</a>.</td></tr>
+</table>
+</td></tr>
+
+<!-- 12. TRIPLE-FEATURE related links: genuine full-bleed #0C0C0D ink panel, De Stijl
+      accent square (bordered top and bottom by thin 3px red/yellow/blue strips),
+      bookending the content body the same way the top/bottom Mondrian bars bookend
+      the whole email. Full-bleed dark panel keeps its dark polarity, text stays light.
+      Its blog links sit on this same dark background, so they use the terminal-text
+      token #E8E8E2 (~15.9:1 against #0C0C0D), NOT the cream-page link blue #1E52E0
+      (~3.11:1 against #0C0C0D, fails AA) that the retired gold-text rule pointed to
+      (drafted-instance content only; this template's own placeholder body reuses the
+      same token). -->
+<tr><td style="padding:26px 32px 0 32px;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td width="34%" height="3" style="background-color:#E11D22;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="33%" height="3" style="background-color:#FFC400;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="33%" height="3" style="background-color:#1E52E0;font-size:1px;line-height:1px;">&nbsp;</td>
+</tr></table>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td style="background-color:#0C0C0D;padding:16px 20px;text-align:left;">
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:14px;line-height:1.65;color:#F4F2EC;text-align:left;"><strong>{{TRIPLE_FEATURE_LEAD}}</strong> {{TRIPLE_FEATURE_BODY_with_3_blog_links_color_#E8E8E2}}</div>
+</td>
+</tr></table>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td width="34%" height="3" style="background-color:#1E52E0;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="33%" height="3" style="background-color:#FFC400;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="33%" height="3" style="background-color:#E11D22;font-size:1px;line-height:1px;">&nbsp;</td>
+</tr></table>
+</td></tr>
+
+<!-- 13. REPLY CTA + SIGN-OFF (person + website link #3) -->
+<tr><td style="padding:24px 32px 0 32px;text-align:left;">
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:14px;line-height:1.65;color:#0C0C0D;text-align:left;">{{REPLY_CTA}}</div>
+</td></tr>
+<tr><td style="padding:22px 32px 28px 32px;text-align:left;">
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:14px;line-height:1.6;color:#0C0C0D;text-align:left;">{{SENDER_NAME}}<br>
+<span style="color:#5B5B5B;">MindrianOS - <a href="https://mindrian-os.com" style="color:#1E52E0;text-decoration:underline;">mindrian-os.com</a></span></div>
+</td></tr>
+
+<!-- 14. BOTTOM MONDRIAN BAR (mirror of top) -->
+<tr><td style="padding:0;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td width="26%" height="10" style="background-color:#1E52E0;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="8%" height="10" style="background-color:#0C0C0D;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="22%" height="10" style="background-color:#FFC400;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="6%" height="10" style="background-color:#0C0C0D;font-size:1px;line-height:1px;">&nbsp;</td>
+<td width="38%" height="10" style="background-color:#E11D22;font-size:1px;line-height:1px;">&nbsp;</td>
+</tr></table>
+</td></tr>
+
+</table>
+</td></tr>
+</table>
+</body>
+</html>
+
+<!--
+  ============================================================================
+  11-ITEM SEND CHECK (run every issue before sending)
+  ============================================================================
+   1. dir="ltr" + text-align:left on every content element (center only the bars + button text).
+   2. 640px width, #F4F2EC bg (the two terminal-island blocks stay #0C0C0D), inline styles
+      only, NO <style> block, NO web fonts.
+   3. NO border-radius, NO emoji, NO em-dashes (hyphens only), NO background images.
+   4. Headline has exactly ONE yellow-highlighted phrase. Logo is MINDRIAN + blue OS.
+   5. STEP 0 update callout present AND names the real released version (e.g. v1.15.3-beta.44).
+   6. Each what's-new card is plain words with who-cares + why (Feynman). Panels differentiated
+      (full-bleed color panel or top-cap band), not 3 identical rails.
+   7. The challenge seed is in the gold-left-border Courier box (terminal island, stays dark),
+      with [BRACKETED] fill-ins.
+   8. The command chain uses real /mos: commands that resolve in the catalog; docs link present.
+   9. mindrian-os.com appears 3+ times (hero caption/READ button, docs link, sign-off). Sender is a person.
+  10. All blog links resolve to live /blog/<slug> pages. Triple-feature points at 3 real posts.
+  11. Hero image has a real public HTTPS src (never local/scratchpad/data:), alt text present,
+      caption present, height attribute present and matching the image's actual aspect ratio,
+      border flipped to #0C0C0D ink (D-02).
+  ============================================================================
+-->

package/references/document-generation.md

@@ -0,0 +1,179 @@
+# Document Generation Reference
+
+*Professional document structuring for MindrianOS — De Stijl formatted exports from the Data Room.*
+
+---
+
+## Architecture
+
+```
+Room Markdown Artifacts (YAML frontmatter)
+    ↓
+markdown2 (parse to HTML + extract metadata)
+    ↓
+Jinja2 (inject into document-type template)
+    ↓
+De Stijl CSS stylesheet (shared across all templates)
+    ↓
+WeasyPrint (render to PDF)
+    ↓
+PyMuPDF (optional: TOC bookmarks, merge sections, watermark)
+    ↓
+room/exports/{document-type}.pdf
+```
+
+**Zero additional dependencies.** All tools already installed:
+- WeasyPrint 67.0 (HTML+CSS → PDF, CSS3 paged media)
+- markdown2 2.5.4 (Markdown → HTML with frontmatter)
+- Jinja2 3.1.6 (template engine)
+- PyMuPDF 1.26.6 (PDF manipulation, TOC, merge)
+- PyYAML 6.0.3 (frontmatter parsing)
+
+---
+
+## Document Types
+
+| Document | Use Case | Template Style |
+|----------|----------|---------------|
+| **Investment Thesis** | Structured narrative for investors — problem, market, solution, financials | Multi-page portrait, section breaks, De Stijl accent bars |
+| **Executive Summary** | 1-2 page dense overview of entire Data Room | Two-column layout, tight margins, summary boxes |
+| **Due Diligence Report** | Comprehensive multi-section with TOC | Running headers, page numbers, section numbering |
+| **Research Paper** | Academic-style with citations and methodology | Two-column body, footnotes, bibliography |
+| **PWS Profile** | Professional profile/resume for cohort members | Single-page grid layout, accent bars, skill visualization |
+| **Pitch Deck** | Landscape slides for presentation | Landscape @page, large headings, one-concept-per-page |
+| **Venture Brief** | Quick 1-pager for stakeholder review | Constrained single page, key highlights only |
+
+---
+
+## De Stijl CSS for PDF
+
+```css
+@page {
+  size: A4;
+  margin: 24mm 20mm;
+  background: #0D0D0D;
+
+  @top-center {
+    content: string(doctitle);
+    font-family: 'Bebas Neue', sans-serif;
+    color: #A09A90;
+    font-size: 10px;
+  }
+
+  @bottom-right {
+    content: counter(page) ' / ' counter(pages);
+    font-family: 'Inter', sans-serif;
+    color: #A09A90;
+    font-size: 10px;
+  }
+}
+
+:root {
+  --ds-bg: #0D0D0D;
+  --ds-surface: #1A1A1A;
+  --ds-elevated: #2A2A2A;
+  --ds-cream: #F5F0E8;
+  --ds-muted: #A09A90;
+  --ds-red: #A63D2F;
+  --ds-blue: #1E3A6E;
+  --ds-yellow: #C8A43C;
+  --ds-green: #2D6B4A;
+  --ds-sienna: #B5602A;
+  --ds-gray: #5C5A56;
+  --ds-amethyst: #6B4E8B;
+  --ds-teal: #2A6B5E;
+}
+
+body {
+  font-family: 'Inter', sans-serif;
+  color: var(--ds-cream);
+  background: var(--ds-bg);
+  line-height: 1.6;
+}
+
+h1, h2, h3 {
+  font-family: 'Bebas Neue', sans-serif;
+  letter-spacing: 0.05em;
+}
+
+* { border-radius: 0; }
+```
+
+---
+
+## Room Section → Document Section Mapping
+
+| Room Section | Document Section | Accent Color |
+|-------------|-----------------|-------------|
+| problem-definition | Problem Statement / Opportunity | Red #A63D2F |
+| market-analysis | Market Analysis / TAM-SAM-SOM | Yellow #C8A43C |
+| solution-design | Solution Architecture / Technical Approach | Gray #5C5A56 |
+| business-model | Business Model / Revenue Strategy | Green #2D6B4A |
+| competitive-analysis | Competitive Landscape / Moat | Sienna #B5602A |
+| team-execution | Team / Execution Plan | Blue #1E3A6E |
+| legal-ip | Legal / IP Strategy | Amethyst #6B4E8B |
+| financial-model | Financial Projections / Investment Ask | Teal #2A6B5E |
+
+---
+
+## Implementation Plan
+
+### Plugin Files Needed
+
+```
+templates/
+  destijl-base.css          # Shared De Stijl stylesheet for PDF
+  investment-thesis.html    # Jinja2 template
+  executive-summary.html    # Jinja2 template
+  due-diligence.html        # Jinja2 template
+  research-paper.html       # Jinja2 template
+  profile.html              # Jinja2 template (PWS profiles)
+  pitch-deck.html           # Jinja2 template (landscape)
+  venture-brief.html        # Jinja2 template (1-page)
+assets/
+  fonts/BebasNeue-Regular.ttf  # Bundled font (~50KB)
+scripts/
+  render-pdf                # Orchestrator: reads room, selects template, renders PDF
+commands/
+  export.md                 # /mos:export thesis|summary|report|profile|deck|brief
+```
+
+### Command UX
+
+```
+/mos:export thesis      → Investment thesis PDF from full room
+/mos:export summary     → 1-2 page executive summary
+/mos:export report      → Due diligence report with TOC
+/mos:export profile     → PWS profile for a cohort member
+/mos:export deck        → Landscape pitch deck
+/mos:export brief       → 1-page venture brief
+```
+
+### Tri-Polar Surface Behavior
+
+| Surface | Behavior |
+|---------|----------|
+| **CLI** | `render-pdf` script generates PDF, opens with default viewer |
+| **Desktop** | Larry offers "Want me to export this as a PDF?" after key milestones |
+| **Cowork** | Export to shared `00_Context/exports/` directory, visible to all team members |
+
+---
+
+## LaTeX Skill Pattern Reference
+
+The "LaTeX Handouts" Claude Code skill (mcpmarket.com) demonstrates the pattern:
+- Skill reads source content (slides/markdown)
+- Expands bullets into research-backed prose
+- Generates structured professional document
+- Outputs as standalone file
+
+MindrianOS follows the same pattern but uses HTML→PDF (WeasyPrint) instead of LaTeX→PDF,
+keeping zero dependencies while achieving the same professional output quality.
+
+---
+
+## Font Bundling Note
+
+Bebas Neue is a free Google Font (SIL Open Font License). Bundle the .ttf in the plugin's
+assets/ directory (~50KB). WeasyPrint loads it via @font-face in the CSS template.
+No system font installation required.