@mindrian_os/cli 2.0.0-beta.3 → 2.0.0-beta.33

package/references/capability-radar/changelog-cache.md

@@ -0,0 +1,95 @@
+# Changelog Cache
+
+This file is a rendered human-readable VIEW. `data/capability-ledger.json` is the source of record;
+`/mos:radar --fetch` writes the ledger first (Step 3b of `commands/radar.md`), then regenerates
+this view from it.
+
+Last fetched: 2026-05-05 (stale - see honesty record below; regenerated on next `/mos:radar --fetch`)
+Source: https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md
+
+**Honesty record (Canon Part 6 dog-fooding).** This file sat frozen at Claude Code 2.1.128
+from 2026-05-05 until Phase 265 corrected the write-back link in `commands/radar.md`.
+`138-CONTEXT.md` claimed on 2026-06-01 that "the cache already carries the 2.1.148-159
+findings" - that claim was false. Those findings only ever existed inside 138-CONTEXT.md's own
+markdown table, which is exactly the rot pattern this file's write-back step now exists to end.
+The stale entries below (2.1.110 through 2.1.128) are preserved as-is rather than silently
+backfilled; `data/capability-ledger.json` already covers 2.1.128 through 2.1.246 (see its
+`ledger_covers` block), and the next `/mos:radar --fetch` will regenerate this entire view from
+the ledger rather than hand-authoring the gap here.
+
+## Recent Changes Relevant to MindrianOS (stale, pending next --fetch regeneration)
+
+### 2.1.128
+- **Domain:** plugins_mcp
+- **Change:** Bare `/color` picks random session color; `/mcp` shows tool count for connected servers and flags servers with 0 tools; `--plugin-dir` accepts `.zip` archives; updated `/model` picker with collapsed Opus 4.7 entries; MCP reconnects summarize re-announced tools by server prefix; `/plugin update` fixed for npm-sourced plugins
+- **MindrianOS impact:** `.zip` distribution is a side-channel for beta testers (Lawrence + 4 new testers in `docs/testers/`) ahead of marketplace tag promotion. `/mcp` 0-tool flagging is direct diagnostic for Brain MCP failure modes - candidate for `/mos:doctor --brain` integration. `/plugin update` npm fix matters if MindrianOS ever ships an npm-sourced variant.
+
+### 2.1.126
+- **Domain:** code
+- **Change:** `claude project purge [path]` deletes Claude Code state with `--dry-run`, `-y`, `-i`, `--all` flags; `--dangerously-skip-permissions` bypasses prompts for protected paths; OAuth code can be pasted when browser callback unreachable; PowerShell improvements on Windows
+- **MindrianOS impact:** `claude project purge` is a clean-slate command for testers when a room install goes sideways. Could replace ad-hoc `~/.claude/plugins/mindrian-os.stale-*` cleanup. PowerShell parity matters if MindrianOS expands to Windows testers.
+
+### 2.1.122
+- **Domain:** plugins_mcp + models
+- **Change:** Added `ANTHROPIC_BEDROCK_SERVICE_TIER` env variable; `/resume` finds session from pasted PR URL; `/mcp` shows hidden claude.ai connectors with deduplication hints
+- **MindrianOS impact:** Bedrock tier selection is relevant for enterprise customers down the road. `/mcp` connector dedup helps when users have both claude.ai-managed MCPs and locally-configured Brain MCP.
+
+### 2.1.121
+- **Domain:** plugins_mcp + code
+- **Change:** Added `alwaysLoad` MCP server config option to skip tool-search deferral; `/skills` now has type-to-filter search box; PostToolUse hooks can replace tool output via `hookSpecificOutput.updatedToolOutput`; MCP servers auto-retry transient startup errors up to 3 times
+- **MindrianOS impact:** **alwaysLoad is the big one for Brain.** Today Brain tools are discovered at the 10% context threshold; `alwaysLoad: true` would surface them from turn 1 - eliminates the "Larry doesn't know about Brain yet" cold-start window. Direct candidate for `.mcp.json` update. PostToolUse `updatedToolOutput` lets hooks rewrite tool output - could enforce Part 8 boundary on Brain query responses (sanitize before they reach the model). MCP auto-retry reduces flake-driven Brain timeouts.
+
+### 2.1.120
+- **Domain:** code + plugins_mcp
+- **Change:** Git for Windows no longer required (PowerShell fallback); `claude ultrareview [target]` non-interactive subcommand; Skills can reference `${CLAUDE_EFFORT}`; `claude plugin validate` accepts more manifest fields
+- **MindrianOS impact:** `${CLAUDE_EFFORT}` in skills lets MindrianOS skills calibrate verbosity (Larry-extended vs quick-larry mode). Plugin validate expansion means `plugin.json` can declare more metadata that the marketplace honors.
+
+### 2.1.119
+- **Domain:** code
+- **Change:** `/config` settings persist to `~/.claude/settings.json`; added `prUrlTemplate` setting; `CLAUDE_CODE_HIDE_CWD` env variable; `--from-pr` accepts GitLab and Bitbucket PRs; `--print` mode honors agent `tools:` and `disallowedTools:` frontmatter
+- **MindrianOS impact:** `--print` mode honoring agent frontmatter means MindrianOS agents (larry-extended, mos-research, etc.) can be invoked non-interactively with their tool restrictions intact - opens scripting/automation paths.
+
+### 2.1.118
+- **Domain:** code + plugins_mcp
+- **Change:** Vim visual and visual-line modes; merged `/cost` and `/stats` into `/usage`; custom themes via `/theme` or `~/.claude/themes/` JSON files; Hooks can invoke MCP tools via `type: "mcp_tool"`; added `DISABLE_UPDATES` env var
+- **MindrianOS impact:** **Hooks → MCP tools is a major shift.** SessionStart, PostToolUse, etc. can now call Brain MCP directly without spawning a child Node process. Could collapse the `lib/core/brain-client.cjs` proxy layer. Custom themes opens De Stijl as a sanctioned theme distribution. `/usage` replacement means token-budget glyph in statusline should track the new command output schema.
+
+### 2.1.117
+- **Domain:** desktop_cowork + plugins_mcp
+- **Change:** Forked subagents enabled on external builds with `CLAUDE_CODE_FORK_SUBAGENT=1`; Agent frontmatter `mcpServers` now loaded for main-thread sessions via `--agent`; `/resume` offers summarization for stale large sessions; concurrent MCP server connections default for faster startup; plugin dependencies auto-resolved from configured marketplaces
+- **MindrianOS impact:** **Forked subagents on external builds** was the unlock for parallel methodology pipelines outside Anthropic infrastructure, at the time this was written. **This is now stale: as of Claude Code 2.1.232, fork mode is on by default in every interactive session, and `CLAUDE_CODE_FORK_SUBAGENT` inverted from an opt-in to an opt-out (`=0` turns it off; `=1` opts in for non-interactive/SDK use only).** See `references/capability-radar/capabilities-index.md`'s Fork Mode Defaults section and `data/capability-ledger.json` for the corrected, current description. Agent-level `mcpServers` declaration means individual agents (e.g. `mos-research`) can require Brain MCP without polluting global config. Plugin deps auto-resolution simplifies MindrianOS Brain MCP coupling.
+
+### 2.1.116
+- **Domain:** plugins_mcp
+- **Change:** `/resume` on large sessions 67% faster with improved fork handling; faster MCP startup; `resources/templates/list` deferred to first `@`-mention; smoother fullscreen scrolling; `/terminal-setup` configures editor scroll sensitivity; thinking spinner shows inline progress
+- **MindrianOS impact:** Faster MCP startup directly improves Brain connection time. The `resources/templates/list` deferral is something to validate against `.mcp.json` - Brain may need to opt into eager template loading if it relies on templates being available at startup.
+
+### 2.1.111
+- **Domain:** models + code
+- **Change:** Claude Opus 4.7 xhigh available via `/effort`; Auto mode for Max subscribers with Opus 4.7; `/effort` opens interactive slider without arguments; "Auto (match terminal)" theme; added `/less-permission-prompts` skill; added `/ultrareview` for parallel code review
+- **MindrianOS impact:** **Opus 4.7 was the current top-tier model at the time this entry was written; it is historical now** (see `capabilities-index.md`'s models section for the current generation). No config key naming a fixed executor model exists anywhere in this repo - the claim that once stood here was wrong; the real surfaces are alias-based (`lib/core/model-profiles.cjs`, `.planning/config.json`). The xhigh effort tier is overkill for most plans but worth knowing for the load-bearing migration phases (108, 109). `/ultrareview` is a built-in pattern that could displace any custom MindrianOS multi-reviewer flows.
+
+### 2.1.110
+- **Domain:** code + desktop_cowork
+- **Change:** Added `/tui fullscreen` command; added push notification tool for Remote Control; changed `Ctrl+O` to toggle normal/verbose transcript; `/focus` toggles focus view; added `autoScrollEnabled` config; `--resume`/`--continue` resurrects unexpired scheduled tasks
+- **MindrianOS impact:** Push notification tool opens async user signaling - Larry could ping the user when Brain finishes an enrichment cycle or when a proactive scan finds a contradiction. `/focus` view aligns with the canon's focus-node concept (Phase 109 D-01) - consider statusline coordination so the `🎯` glyph respects `/focus` state.
+
+## New capabilities NOT in capabilities-index.md (last updated 2026-03-22)
+
+The following are recent additions worth merging into the curated index:
+
+1. **`alwaysLoad` MCP config** (2.1.121) - eliminates Brain MCP cold-start window
+2. **Hooks → MCP tools** (2.1.118) - hook scripts can call Brain directly, no Node child process
+3. **Forked subagents on external builds** (2.1.117) - parallel methodology pipelines unlocked
+4. **Agent frontmatter `mcpServers`** (2.1.117) - per-agent Brain MCP scoping
+5. **PostToolUse `updatedToolOutput`** (2.1.121) - Part 8 sanitization layer for Brain responses
+6. **`--plugin-dir` accepts `.zip`** (2.1.128) - beta-tester distribution side-channel
+7. **`/mcp` 0-tool flagging** (2.1.128) - Brain MCP failure-mode diagnostic
+8. **Opus 4.7 + xhigh effort** (2.1.111) - top model at the time + max-effort tier (Opus 4.7 is historical now; see the models section of `capabilities-index.md`)
+9. **`/ultrareview` built-in** (2.1.111) - built-in parallel code review pattern
+10. **`/effort` slider** (2.1.111) - runtime effort calibration for skills (`${CLAUDE_EFFORT}`)
+11. **`/usage` (replaces `/cost` + `/stats`)** (2.1.118) - statusline token-budget glyph should track new schema
+12. **Custom themes via JSON** (2.1.118) - De Stijl as sanctioned theme distribution
+13. **`claude project purge`** (2.1.126) - clean-slate command for tester recovery
+14. **MCP auto-retry on transient errors** (2.1.121) - Brain reliability improvement
+15. **Concurrent MCP startup** (2.1.117) - faster session start

package/references/causal/causal-schema.md

@@ -0,0 +1,103 @@
+---
+title: Causal Layer Schema Reference
+description: >
+  KuzuDB node and edge schema for the causal reasoning layer.
+  Use this document as context when generating Cypher queries for causal analysis.
+version: 1.7.0
+---
+
+# Causal Layer Schema Reference
+
+> Extension to LazyGraph schema for causal reasoning.
+> CausalClaim nodes and causal edges store extracted causal intelligence.
+
+## Node Types
+
+### CausalClaim
+
+Represents a single cause-effect assertion extracted from a room artifact.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| id | STRING (PK) | -- | Unique claim ID, e.g. causal-0001 |
+| cause | STRING | -- | What produces the effect (max 200 chars) |
+| mechanism | STRING | -- | HOW the cause produces the effect (max 300 chars) |
+| effect | STRING | -- | What happens as a result (max 200 chars) |
+| confidence | DOUBLE | 0.5 | Dynamic: observed=0.7, asserted=0.5, inferred=0.3 initial |
+| evidence | STRING | '[]' | JSON array of supporting artifact IDs |
+| source_artifact | STRING | '' | Primary artifact ID this was extracted from |
+| domain | STRING | 'general' | materials, business, competitive, financial, team, legal, general |
+| falsifiable_prediction | STRING | '' | Testable prediction that would disprove this claim |
+| novelty_score | DOUBLE | 0.0 | Graph neighborhood uniqueness (0-1) |
+| extraction_method | STRING | 'inferred' | observed, asserted, inferred |
+| created | STRING | '' | Date extracted (YYYY-MM-DD) |
+
+## Edge Types
+
+### CAUSES (Artifact -> Artifact)
+Direct causal relationship between artifacts.
+
+| Property | Type | Default |
+|----------|------|---------|
+| mechanism | STRING | '' |
+| confidence | DOUBLE | 0.0 |
+| framework | STRING | '' |
+| direction | STRING | 'forward' |
+
+### ROOT_CAUSE_OF (Artifact -> Artifact)
+Multi-hop root cause chain.
+
+| Property | Type | Default |
+|----------|------|---------|
+| chain_length | INT64 | 1 |
+| intermediate_causes | STRING | '[]' |
+| confidence | DOUBLE | 0.0 |
+| discovery_source | STRING | 'manual' |
+
+### CASCADES_TO (CausalClaim -> CausalClaim)
+Assumption failure propagation between claims.
+
+| Property | Type | Default |
+|----------|------|---------|
+| cascade_type | STRING | 'invalidation' |
+| severity | STRING | 'medium' |
+| path_length | INT64 | 1 |
+
+### EXTRACTED_FROM (CausalClaim -> Artifact)
+Provenance link from claim to source artifact. Every CausalClaim MUST have at least one.
+
+No additional properties.
+
+## Query Patterns
+
+### Chain Traversal (bounded, no ACYCLIC)
+```cypher
+MATCH path = (start:CausalClaim)-[:CASCADES_TO*1..6]->(end:CausalClaim)
+WHERE start.id = $claim_id
+RETURN [n IN nodes(path) | n.id] AS chain,
+       [n IN nodes(path) | n.cause] AS causes,
+       length(path) AS depth
+```
+
+### Cross-Reference: Causal + HSI
+```cypher
+MATCH (c1:CausalClaim)-[:EXTRACTED_FROM]->(a1:Artifact)
+      -[h:HSI_CONNECTION]->(a2:Artifact)<-[:EXTRACTED_FROM]-(c2:CausalClaim)
+WHERE c1.id <> c2.id
+RETURN c1.id, c2.id, h.hsi_score, h.surprise_type
+```
+
+### Cross-Reference: Causal + Reverse Salient
+```cypher
+MATCH (c:CausalClaim)-[:EXTRACTED_FROM]->(a:Artifact)-[:BELONGS_TO]->(s1:Section)
+      -[rs:REVERSE_SALIENT]->(s2:Section)
+RETURN c.id, s1.name, s2.name, rs.innovation_thesis
+```
+
+### Cross-Reference: Causal + Analogy
+```cypher
+MATCH (c1:CausalClaim)-[:EXTRACTED_FROM]->(a1:Artifact)
+      -[an:ANALOGOUS_TO]->(a2:Artifact)<-[:EXTRACTED_FROM]-(c2:CausalClaim)
+WHERE c1.id <> c2.id
+RETURN c1.id, c2.id, an.analogy_distance, an.structural_fitness
+```

package/references/design/email-template-standard.md

@@ -0,0 +1,169 @@
+# MindrianOS Official Email Template Standard
+
+> **Canonical source:** `references/design/newsletter-email-template.html` is the
+> canonical, authoritative source for the cream M:OS Canonical Design System v1.1
+> tester-challenge email canon (re-skinned 2026-07-23, quick task 260723-rln, from
+> the retired DARK canon). This document is the derived component-pattern reference,
+> kept in sync with it. If this doc and the template ever disagree, the template
+> wins - update this doc to match, never the reverse.
+
+## Brand Name Rules (MANDATORY)
+
+- **Correct:** MindrianOS (capital M, lowercase indrian, capital OS, NO hyphen)
+- **Wrong:** MindianOS, Mindrian-OS, MINDRIANOS, mindrianos, Mindrian OS, MindRianOS
+- **In headers/banners:** MINDRIANOS (all caps) is acceptable ONLY in De Stijl header blocks
+- **In body text:** Always MindrianOS
+
+## Layout Rules (MANDATORY)
+
+### Direction and Alignment
+- `dir="ltr"` on the outer wrapper table
+- `text-align:left` on EVERY td, p, and content element
+- No centered body text. Only center: top/bottom Mondrian bars, the gold READ-THE-STORY button text
+- Fixed width: 640px outer table
+
+### Structure
+```
+1. Top Mondrian bar (full-width colored strips)
+2. Logo row (left-aligned, from a person)
+3. Headline (color-block treatment, one yellow highlight)
+4. Lede (Feynman, the why)
+5. Hero image (hard-rectangle cream border + caption)
+6. READ THE STORY button (gold block, centered text only)
+7. STEP 0 update callout (full-bleed red panel)
+8. What's-new cards (full-bleed panels / top-cap bands, differentiated)
+9. Challenge + copy-paste seed (gold tab header + Courier gold-left-border box)
+10. Command chain (gold cmd + cream gloss + docs link)
+11. Triple-feature related links (full-bleed black panel, red/yellow/blue top+bottom strips)
+12. Reply CTA + sign-off (person + website)
+13. Bottom Mondrian bar (mirror of top)
+```
+
+### De Stijl Color Palette
+| Color | Hex | Usage |
+|-------|-----|-------|
+| Paper | #F4F2EC | Body, outer wrapper (cream ground) |
+| Panel | #FBFAF7 | What's-new card 1/3 backgrounds (light surface) |
+| Ink | #0C0C0D | Primary text, headings, hero-image border, headline field/triple-feature panel bg (full-bleed dark panels keep their polarity) |
+| Muted | #5B5B5B | Secondary text, sign-off byline |
+| Red | #E11D22 | STEP 0 panel, top/bottom Mondrian bars, what's-new card 3 top-cap |
+| Blue | #1E52E0 | What's-new card 2 full-bleed panel, headline cap band, Mondrian bars, all non-terminal link text (logo OS mark, docs link, sign-off link) |
+| Yellow | #FFC400 | Headline highlight, what's-new card 1 top-cap, Mondrian bars |
+| Gold/OS | #C8A43C | RESTRICTED role: background fills only (READ THE STORY button, CHALLENGE tab, 8.76:1 AA-pass) plus text ONLY inside the two locked terminal-island blocks (command-chain command names, seed-box border accent) - no longer a general-purpose text color (fails AA at 2.13:1 on cream) |
+| Terminal text | #E8E8E2 | Body/gloss text inside the two terminal-island blocks only (matches `pre.code`'s own text token) |
+
+Terminal-island exception (D-01, locked): the challenge-seed Courier box and the
+command-chain table are the sole two blocks that keep the old dark `#0C0C0D`
+background - everywhere else re-skins to the cream ground above.
+
+### Typography (email-safe)
+| Element | Font | Size | Color | Style |
+|---------|------|------|-------|-------|
+| Logo/brand | Impact, 'Arial Black', Arial, sans-serif | 24px | #0C0C0D (OS in #1E52E0) | 2px letter-spacing |
+| Headline | Impact, 'Arial Black', Arial, sans-serif | 38px | #F4F2EC (highlight #FFC400) | font-weight:900, letter-spacing:-0.01em (bold-Arial-aware); sits on the still-dark #0C0C0D full-bleed headline field, light text unchanged |
+| Section heading | Impact, 'Arial Black', Arial, sans-serif | 16-20px | #0C0C0D | Left-aligned, no letter-spacing override needed |
+| Body text | Helvetica, Arial, sans-serif | 14-16px | #0C0C0D (on cream/panel surfaces) or #F4F2EC (on full-bleed dark panels) | Normal, 1.6-1.65 line-height |
+| Muted/byline text | Helvetica, Arial, sans-serif | 12px | #5B5B5B | Normal |
+| Code / seed prompt | Courier, Consolas, monospace | 12-13px | #E8E8E2 body text, #C8A43C command names | On #0C0C0D terminal-island background (D-01, locked dark exception) |
+
+### Component Patterns
+
+#### Top/Bottom Mondrian Bar
+```html
+<table width="100%"><tr>
+  <td width="38%" height="10" style="background-color:#E11D22;font-size:1px;">&nbsp;</td>
+  <td width="8%" height="10" style="background-color:#0C0C0D;font-size:1px;">&nbsp;</td>
+  <td width="22%" height="10" style="background-color:#FFC400;font-size:1px;">&nbsp;</td>
+  <td width="6%" height="10" style="background-color:#0C0C0D;font-size:1px;">&nbsp;</td>
+  <td width="26%" height="10" style="background-color:#1E52E0;font-size:1px;">&nbsp;</td>
+</tr></table>
+```
+
+#### Full-Bleed Alert Panel (STEP 0 callout)
+```html
+<table width="100%"><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;">TITLE</div>
+    <div style="font-family:Helvetica,Arial,sans-serif;font-size:14px;color:#F4F2EC;padding-top:8px;">Body copy directly on the red field.</div>
+  </td>
+</tr></table>
+```
+Paper text sits directly on the color field - this is a genuine full-bleed panel, not a rail on a dark card. It keeps its dark/saturated polarity even on the cream page (De Stijl full-bleed accent), so text stays light.
+
+#### Top-Cap Band Card (what's-new cards 1 and 3)
+```html
+<table width="100%"><tr><td height="4" style="background-color:#FFC400;font-size:1px;">&nbsp;</td></tr></table>
+<table width="100%"><tr>
+  <td style="background-color:#FBFAF7;padding:16px 20px;text-align:left;">CONTENT</td>
+</tr></table>
+```
+Rotate the top-cap color: #FFC400 (card 1), #E11D22 (card 3). Card surface is now the light panel #FBFAF7.
+
+#### Full-Bleed Color Panel (what's-new card 2, triple-feature rail)
+```html
+<table width="100%"><tr>
+  <td style="background-color:#1E52E0;padding:16px 20px;text-align:left;">CONTENT, paper text directly on the color field</td>
+</tr></table>
+```
+The triple-feature rail uses this same cell-level pattern with `#0C0C0D` in place of `#1E52E0`.
+
+#### Gold Tab / Flag (challenge section header)
+```html
+<table cellpadding="0" cellspacing="0"><tr>
+  <td style="background-color:#C8A43C;padding:4px 10px;">
+    <div style="font-family:Impact,'Arial Black',Arial,sans-serif;font-size:12px;letter-spacing:1px;color:#0C0C0D;">LABEL</div>
+  </td>
+</tr></table>
+```
+Gold stays as a background fill with dark ink text on top (8.76:1, passes AA easily) - the one restricted, still-sanctioned use of gold.
+
+#### Seed / Code Box (gold left-border, Courier) - locked terminal-island block (D-01)
+```html
+<table width="100%"><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;color:#E8E8E2;">CONTENT</div>
+  </td>
+</tr></table>
+```
+This block intentionally keeps its dark `#0C0C0D` background and `#E8E8E2` terminal text token - it does NOT re-skin to cream (D-01, matches the website's own terminal-island precedent). This snippet already used the cell-level pattern before this rule was written.
+
+#### Hero Image
+```html
+<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;color:#5B5B5B;padding-top:8px;">{{HERO_IMAGE_CAPTION}}</div>
+```
+Src MUST be a real public HTTPS URL - local paths and `data:` URIs are stripped or blocked
+by major email clients (Gmail, Outlook). Border is ink `#0C0C0D` against the cream page (D-02); the image asset itself is untouched by the re-skin.
+
+#### CTA Button (READ THE STORY)
+```html
+<table cellpadding="0" cellspacing="0"><tr>
+  <td style="background-color:#C8A43C;padding:13px 26px;text-align:left;">
+    <a href="URL" 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>
+```
+
+#### Footer / Sign-off
+```html
+<div style="font-family:Helvetica,Arial,sans-serif;font-size:14px;color:#0C0C0D;">
+  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>
+```
+
+## Rules
+
+1. **NO border-radius anywhere.** Hard rectangles only. De Stijl.
+2. **NO emoji.** Ever.
+3. **NO rounded buttons.** Square CTA blocks.
+4. **NO background images.** Solid colors only (hero photo is the one sanctioned `<img>` exception, always a real public HTTPS URL).
+5. **NO web fonts.** Email-safe only: Impact, 'Arial Black', Helvetica, Arial, Courier, Consolas.
+6. **ALL text left-aligned** except the top/bottom Mondrian bars and the READ THE STORY button text.
+7. **ALL tables use inline styles.** No external CSS, no `<style>` block (email clients strip it).
+8. **640px max width.** Fixed, not responsive (email clients handle poorly).
+9. **Padding: 32px sides.** Consistent throughout.
+10. **Sender is always a person** (Jonathan Sagir, Larry, etc.) - never "MindrianOS Team."
+11. **NO em-dashes.** Hyphens only.
+12. **Background-color lives on td cells, never on table tags.** Even full-bleed color panels (STEP 0 callout, what's-new cards, terminal-island blocks) put background-color on the cell(s) inside, not the wrapping table - the cell-level pattern is the more broadly compatible one across email clients (some, including Gmail's compose editor, strip or mishandle table-level background-color).

package/references/design/graph-visualization-standard.md

@@ -0,0 +1,178 @@
+# Graph Visualization Standard
+
+**Decision:** vis-network (vis.js) is the standard graph visualization library for ALL MindrianOS exports, snapshots, dashboards, and visual presentations.
+
+**Decided:** 2026-04-06
+**Supersedes:** Cytoscape.js for exports (Cytoscape.js retained for internal plugin dashboard only)
+
+## Why vis-network
+
+| Requirement | vis-network | Cytoscape.js |
+|-------------|-------------|--------------|
+| Physics simulation | Built-in ForceAtlas2, excellent | Available but less polished |
+| Drag & drop | Excellent out-of-box | Good |
+| Learning curve | Simple API | Steep |
+| Clustering | Built-in | Requires extensions |
+| Visual quality | Beautiful by default | Needs heavy styling |
+| Setup | `new Network(container, data, options)` | Verbose config |
+
+Cytoscape.js has superior graph algorithms (50+ built-in) but exports don't need algorithms -- they need beautiful interactive exploration.
+
+## When to Use What
+
+| Context | Library | Reason |
+|---------|---------|--------|
+| SnapshotHub exports | vis-network | Beauty + interaction for stakeholders |
+| /mos:present views | vis-network | Same as SnapshotHub |
+| /mos:dashboard live server | vis-network | Consistency with exports |
+| /mos:visualize command | vis-network | Standard graph output |
+| Plugin internal (Brain queries) | Cytoscape.js | Graph algorithms needed |
+
+## Standard Configuration
+
+```javascript
+var options = {
+  physics: {
+    enabled: true,
+    solver: 'forceAtlas2Based',
+    forceAtlas2Based: {
+      gravitationalConstant: -40,
+      centralGravity: 0.008,
+      springLength: 120,
+      springConstant: 0.04,
+      damping: 0.4
+    },
+    stabilization: { iterations: 200, fit: true }
+  },
+  interaction: {
+    hover: true,
+    tooltipDelay: 200,
+    zoomView: true,
+    dragView: true,
+    keyboard: { enabled: true }
+  },
+  nodes: {
+    font: {
+      color: '#ccc',
+      size: 11,
+      face: 'Inter, system-ui, sans-serif',
+      strokeWidth: 3,
+      strokeColor: '#0a0a0f'
+    },
+    borderWidth: 2,
+    shadow: { enabled: true, color: 'rgba(0,0,0,0.3)', size: 6 }
+  },
+  edges: {
+    smooth: { type: 'continuous', roundness: 0.3 },
+    hoverWidth: 2
+  },
+  layout: { improvedLayout: true }
+};
+```
+
+## Node Shapes
+
+| Node Type | Shape | Size | Description |
+|-----------|-------|------|-------------|
+| Section header | diamond | 20 | Room section nodes (problem-definition, market-analysis, etc.) |
+| Artifact | dot | 12 | Individual entries/documents |
+| Framework | triangle | 16 | Methodology framework nodes (for Brain views) |
+| Person | square | 14 | Team member or speaker nodes |
+
+## Edge Colors
+
+| Edge Type | Color | Opacity | Description |
+|-----------|-------|---------|-------------|
+| CONVERGES | #2ECC71 | 0.4 | Themes align across sections |
+| CONTRADICTS | #E74C3C | 0.4 | Tension detected between entries |
+| INFORMS | #3498DB | 0.4 | One entry informs another |
+| INVALIDATES | #E67E22 | 0.5 | One entry invalidates another |
+| FEEDS_INTO | #9B59B6 | 0.5 | Framework chains (Brain views) |
+
+## Section Colors
+
+| Section | Color | Hex |
+|---------|-------|-----|
+| problem-definition | Red | #E74C3C |
+| market-analysis | Yellow/Gold | #F39C12 |
+| solution-design | Blue | #3498DB |
+| business-model | Green | #2ECC71 |
+| competitive-analysis | Orange | #E67E22 |
+| team-execution | Purple | #9B59B6 |
+| legal-ip | Gold | #D4AC0D |
+| financial-model | Teal | #1ABC9C |
+| personas | Deep Purple | #8E44AD |
+| opportunity-bank | Forest Green | #27AE60 |
+| meetings | Gray | #7F8C8D |
+
+## CDN
+
+```html
+<script src="https://unpkg.com/vis-network@9.1.9/standalone/umd/vis-network.min.js"></script>
+```
+
+## Required UI Elements
+
+Every graph view MUST include:
+
+1. **Sidebar** with section filter toggles and edge type toggles
+2. **Detail panel** that appears on node click (shows connections)
+3. **Controls bar** at bottom: Fit, Zoom +/-, Physics toggle, Stabilize
+4. **Back to Hub** link in top bar
+5. **Mindrian branding** with Mondrian color bar
+6. **Legend** explaining edge types and node shapes
+7. **Stats** showing node/edge counts
+
+## Dark Theme (Standard)
+
+```css
+body { background: #0a0a0f; }
+sidebar { background: #0d0d14; border-right: 1px solid #1a1a2a; }
+top-bar { background: #0d0d12; }
+node-font-color: #ccc
+node-font-stroke: #0a0a0f (3px outline for readability)
+detail-panel: #12121a with backdrop-filter: blur(8px)
+```
+
+## Integration Points
+
+- `scripts/generate-hub.cjs` -- embeds vis-network graph in SnapshotHub
+- `scripts/generate-snapshot.cjs` -- constellation view uses vis-network
+- `scripts/generate-presentation.cjs` -- graph view uses vis-network
+- `lib/quickview/hub-server.cjs` -- live dashboard graph uses vis-network
+- `dashboard/index.html` -- localhost dashboard uses vis-network
+
+---
+
+## Pitch Deck Standard (v1.9.3)
+
+The SnapshotHub pitch deck uses the `/slides` skill structure:
+- 10-slide YC Seed Deck format
+- Chart.js for all data visualizations (minimum 3 charts)
+- 16:9 aspect ratio with keyboard navigation (arrows + click)
+- Progress bar at top
+- De Stijl dark palette (#0a0a0f background, Mondrian accents)
+- Bebas Neue headings, Inter body
+- MINDRIAN logo + Back to Hub link
+- Mobile responsive (breakpoints at 900px, 600px)
+- Mondrian color bar footer
+
+### Slide Structure
+1. Title/Hook (AIDA formula)
+2. Problem (PAS formula)
+3. Convergence/IKA (Chart.js horizontal bar)
+4. Solution (TRL progress bars)
+5. Market & Timing (Chart.js S-curve lines)
+6. Competitive Landscape (grid with check/miss)
+7. Business Model (Chart.js stacked bar)
+8. Team (credential grid)
+9. Traction & Timeline (milestone cards)
+10. The Ask/CTA (AIDA urgency)
+
+### Generator Integration
+`generate-hub.cjs` should produce this deck as `views/deck.html` by:
+1. Reading room sections for content
+2. Extracting metrics from STATE.md
+3. Building Chart.js datasets from market-analysis/ and financial-model/
+4. Generating persona card from team/ data
+5. Using the slide template from references/templates/deck-template.html