feat(examples): add Mars Genesis types, leader constants, gitignore superpowers

Author: jddunn

.gitignore

@@ -16,4 +16,4 @@ src/generated/
 docs/api/
 
 # Test coverage reports
-coverage/
+coverage/docs/superpowers/

examples/mars-genesis/shared/constants.ts

@@ -0,0 +1,67 @@
+import type { ColonySnapshot, LeaderConfig } from './types.js';
+
+export const INITIAL_SNAPSHOT: ColonySnapshot = {
+  population: 100,
+  waterLitersPerDay: 800,
+  foodMonthsReserve: 18,
+  powerKw: 400,
+  morale: 0.85,
+  infrastructureModules: 3,
+  scienceOutput: 0,
+  unplannedDeaths: 0,
+  toolsForgedTotal: 0,
+};
+
+export const VISIONARY: LeaderConfig = {
+  name: 'Aria Chen',
+  archetype: 'The Visionary',
+  colony: 'Ares Horizon',
+  hexaco: {
+    openness: 0.95,
+    conscientiousness: 0.35,
+    extraversion: 0.85,
+    agreeableness: 0.55,
+    emotionality: 0.3,
+    honestyHumility: 0.65,
+  },
+  instructions: `You are Commander Aria Chen, founding leader of the Ares Horizon colony on Mars. Year one is 2035.
+
+You believe humanity's future depends on bold expansion. You prioritize discovery, exploration, and growth over caution. You accept calculated risks and inspire colonists through vision and charisma. When setbacks occur, you frame them as learning opportunities and push forward.
+
+RESEARCH REQUIREMENT: Before every decision, use web_search to find real scientific research about the crisis topic. Cite specific papers, NASA missions, or peer-reviewed studies with DOIs or URLs. Ground every decision in real Mars science. Include citations as inline markdown links in your response.
+
+TOOL FORGING: When you need to model growth, expansion, terraforming, population dynamics, or any quantitative projection and no existing tool fits, forge a new tool using forge_tool. Prefer compose mode (chaining existing tools) when possible. Use sandbox mode for novel computations.
+
+RESPONSE FORMAT: Structure your response as:
+1. RESEARCH: What you found (with citations)
+2. DECISION: What you choose and why
+3. COLONY UPDATE: How this affects population, resources, morale, infrastructure, science output
+4. TOOLS: Any tools you forged this turn (name, mode, purpose)`,
+};
+
+export const ENGINEER: LeaderConfig = {
+  name: 'Dietrich Voss',
+  archetype: 'The Engineer',
+  colony: 'Meridian Base',
+  hexaco: {
+    openness: 0.25,
+    conscientiousness: 0.97,
+    extraversion: 0.3,
+    agreeableness: 0.45,
+    emotionality: 0.7,
+    honestyHumility: 0.9,
+  },
+  instructions: `You are Commander Dietrich Voss, founding leader of the Meridian Base colony on Mars. Year one is 2035.
+
+You believe survival depends on engineering discipline. You prioritize redundancy, safety margins, and proven methods. You track every resource precisely and demand compliance with protocols. You share bad news immediately and make decisions based on data, not optimism.
+
+RESEARCH REQUIREMENT: Before every decision, use web_search to find real scientific research about the crisis topic. Cite specific papers, NASA missions, or peer-reviewed studies with DOIs or URLs. Ground every decision in real Mars science. Include citations as inline markdown links in your response.
+
+TOOL FORGING: When you need to calculate risk, measure capacity, predict failure modes, or model resource depletion and no existing tool fits, forge a new tool using forge_tool. Prefer sandbox mode for precise calculations. Use compose mode for multi-step analysis pipelines.
+
+RESPONSE FORMAT: Structure your response as:
+1. RESEARCH: What you found (with citations)
+2. DECISION: What you choose and why
+3. COLONY UPDATE: How this affects population, resources, morale, infrastructure, science output
+4. TOOLS: Any tools you forged this turn (name, mode, purpose)`,
+};

examples/mars-genesis/shared/types.ts

@@ -0,0 +1,82 @@
+export interface HexacoProfile {
+  openness: number;
+  conscientiousness: number;
+  extraversion: number;
+  agreeableness: number;
+  emotionality: number;
+  honestyHumility: number;
+}
+
+export interface LeaderConfig {
+  name: string;
+  archetype: string;
+  colony: string;
+  hexaco: HexacoProfile;
+  instructions: string;
+}
+
+export interface Citation {
+  text: string;
+  url: string;
+  doi?: string;
+  context: string;
+}
+
+export interface ForgedToolRecord {
+  name: string;
+  mode: 'compose' | 'sandbox';
+  description: string;
+  confidence: number;
+  judgeVerdict: 'approved' | 'rejected';
+}
+
+export interface ColonySnapshot {
+  population: number;
+  waterLitersPerDay: number;
+  foodMonthsReserve: number;
+  powerKw: number;
+  morale: number;
+  infrastructureModules: number;
+  scienceOutput: number;
+  unplannedDeaths: number;
+  toolsForgedTotal: number;
+}
+
+export interface TurnResult {
+  turn: number;
+  year: number;
+  title: string;
+  crisis: string;
+  decision: string;
+  reasoning: string;
+  citations: Citation[];
+  toolsForged: ForgedToolRecord[];
+  snapshot: ColonySnapshot;
+  rawResponse: string;
+}
+
+export interface SimulationLog {
+  simulation: 'mars-genesis';
+  version: '1.0.0';
+  startedAt: string;
+  completedAt: string;
+  leader: Omit<LeaderConfig, 'instructions'>;
+  turns: TurnResult[];
+  finalAssessment: {
+    population: number;
+    toolsForged: number;
+    unplannedDeaths: number;
+    scienceOutput: number;
+    infrastructureModules: number;
+    morale: number;
+  };
+}
+
+export interface Scenario {
+  turn: number;
+  year: number;
+  title: string;
+  crisis: string;
+  researchKeywords: string[];
+  snapshotHints: Partial<ColonySnapshot>;
+}