Add canonical facts system and factor component library

[OAGr]

Summary

This PR introduces a comprehensive canonical facts system for the longterm-next application, along with a new library of reusable factor-related MDX components. The facts system reads from YAML files, parses numeric values, and evaluates computed expressions at build time. The new components enable rich, data-driven content in MDX pages.

Key Changes

Canonical Facts System (src/data/facts.ts)

• YAML-based fact store: Facts are now defined in src/data/facts/*.yaml files instead of being synced from the database
• Numeric parsing: Automatically parses human-readable values like "$13 billion", "40%", "$76,001/year" into numeric values
• Computed expressions: Supports safe expression evaluation with references to other facts (e.g., {anthropic.valuation} * {jaan-tallinn.anthropic-ownership})
• Topological sorting: Resolves computed facts in dependency order to handle complex calculations
• Build-time processing: All parsing and computation happens at build/server-component time using Node.js fs

Fact Data Files

• Added three initial entity fact files:
  • anthropic.yaml: Valuation, revenue, margins, team composition
  • openai.yaml: Investment, valuation, revenue, model performance metrics
  • sam-altman.yaml: Net worth, investments, company metrics
  • jaan-tallinn.yaml: Ownership stakes with computed values based on Anthropic valuation

New Factor Components

Six new MDX-compatible components for displaying structured factor data:

• FactorKeyDebates: Displays key debates/disagreements from YAML with topic and core questions
• FactorRatings: Shows 0-100 scores for changeability, x-risk impact, trajectory impact, and uncertainty with interpretations
• FactorScope: Renders scope definitions with includes/excludes sections
• FactorRelatedContent: Links to related risks, responses, models, and cruxes
• FactorRelationshipDiagram: Mermaid-based flowchart showing factor relationships (incoming/outgoing/both directions)
• FullModelDiagram: Complete model visualization showing all factors, scenarios, and outcomes
• FactorStatusBadge: Status indicator component (stub)

All components support both direct data props and dynamic lookup via nodeId + subItemLabel.

Integration Updates

• Updated mdxComponents.ts to register new components and remove stubs for FactorRelationshipDiagram and FullModelDiagram
• Modified src/data/index.ts to load facts from YAML files instead of database
• Updated facts page documentation to reflect new YAML-based system

Testing

• Added fact-consistency test rule that validates hardcoded fact values in content against canonical facts
• Suggests using <F> component for fact references
• Informational logging of potential fact consistency issues

Implementation Details

• Safe expression evaluation: Custom recursive descent parser (no eval()) supporting +, -, *, /, parentheses, and fact references
• Circular dependency detection: Topological sort validates computed fact DAG
• Caching: Facts are loaded once and cached in memory for the process lifetime
• Error handling: Graceful degradation with warnings for unparseable values or circular dependencies
• Currency detection: Automatically detects currency-denominated facts for proper formatting

Files Modified

• apps/longterm-next/src/app/internal/facts/page.tsx
• apps/longterm-next/src/components/mdx-components.tsx
• apps/longterm-next/src/data/index.ts
• apps/longterm-next/src/lib/__tests__/validate-content.test.ts

Files Added

• apps/longterm-next/src/data/facts.ts (445 lines)
• apps/longterm-next/src/components/wiki/FactorKeyDebates.tsx
• apps/longterm-next/src/components/wiki/FactorRatings.tsx

https://claude.ai/code/session_019sD1zo6gTDKeJCWc7Rz7u5

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
cairn	Ready	Preview	Feb 9, 2026 3:29pm
cairn-meta	Ready	Preview	Feb 9, 2026 3:29pm
longtermwiki	Ready	Preview	Feb 9, 2026 3:29pm