diff options
Diffstat (limited to 'engine')
38 files changed, 1254 insertions, 0 deletions
diff --git a/engine/career/career.ts b/engine/career/career.ts new file mode 100644 index 0000000..b235f6e --- /dev/null +++ b/engine/career/career.ts @@ -0,0 +1,32 @@ +import type { GameTime } from 'time' +import type { InstitutionId } from '../entities/base' + +export type CareerTrajectory = 'rising' | 'steady' | 'declining' | 'stalled' + +export interface CareerPerformance { + readonly quality: number + readonly reputationAtEmployer: number + readonly yearsSinceLastRecognition: number +} + +export interface CareerHistoryEntry { + readonly careerId: string + readonly employerId: InstitutionId | null + readonly role: string + readonly startedAt: GameTime + readonly endedAt: GameTime | null + readonly reasonEnded: string | null + readonly notableEvents: readonly string[] +} + +export interface CareerState { + readonly currentCareerId: string | null + readonly currentRole: string + readonly currentEmployerId: InstitutionId | null + readonly yearsInCurrentRole: number + readonly yearsInCurrentCareer: number + readonly careerHistory: readonly CareerHistoryEntry[] + readonly performance: CareerPerformance + readonly trajectory: CareerTrajectory + readonly jobSatisfaction: number +} diff --git a/engine/career/index.ts b/engine/career/index.ts new file mode 100644 index 0000000..48daad7 --- /dev/null +++ b/engine/career/index.ts @@ -0,0 +1,6 @@ +export type { + CareerHistoryEntry, + CareerPerformance, + CareerState, + CareerTrajectory +} from './career' diff --git a/engine/economics/affordability.ts b/engine/economics/affordability.ts new file mode 100644 index 0000000..ef57d3f --- /dev/null +++ b/engine/economics/affordability.ts @@ -0,0 +1,22 @@ +/** + * The "What you could afford" surface on the Money screen. Hidden numbers + * resolve into qualitative feasibility labels so the player answers + * "can I afford this?" without ever seeing a number (docs/09-economy.md + * §"The 'What you could afford' design"). + */ +export type Feasibility = + | 'comfortable' + | 'with_some_sacrifice' + | 'only_by_stretching' + | 'not_without_changing_careers' + | 'not_realistically' + +export interface PossiblePurchase { + readonly description: string + readonly feasibility: Feasibility + readonly contextual: boolean +} + +export interface AffordabilityContext { + readonly possiblePurchases: readonly PossiblePurchase[] +} diff --git a/engine/economics/economic.ts b/engine/economics/economic.ts new file mode 100644 index 0000000..1197cde --- /dev/null +++ b/engine/economics/economic.ts @@ -0,0 +1,56 @@ +/** + * Economic state. All numbers in "marks" (the world's universal currency). + * The player never sees any of these — they surface as prose and qualitative + * affordability context (docs/09-economy.md, ARCHITECTURE.md §14). + */ + +export type EconomicClass = + | 'destitute' + | 'struggling' + | 'working' + | 'lower_middle' + | 'middle' + | 'upper_middle' + | 'wealthy' + | 'very_wealthy' + | 'old_money' + | 'generationally_wealthy' + +export type AccountKind = 'checking' | 'savings' | 'brokerage' | 'retirement' + +export interface Account { + readonly id: string + readonly kind: AccountKind + readonly balance: number +} + +export type AssetKind = 'home' | 'vehicle' | 'business' | 'collectible' | 'real_estate' + +export interface Asset { + readonly id: string + readonly kind: AssetKind + readonly description: string + readonly estimatedValue: number + readonly encumbered: boolean +} + +export type DebtKind = 'mortgage' | 'auto' | 'student' | 'credit_card' | 'personal' | 'medical' + +export interface Debt { + readonly id: string + readonly kind: DebtKind + readonly balance: number + readonly monthlyPayment: number + readonly apr: number +} + +export interface EconomicState { + readonly cashOnHand: number + readonly accounts: readonly Account[] + readonly assets: readonly Asset[] + readonly debts: readonly Debt[] + readonly monthlyIncome: number + readonly monthlyExpenses: number + readonly netWorth: number + readonly classification: EconomicClass +} diff --git a/engine/economics/index.ts b/engine/economics/index.ts new file mode 100644 index 0000000..511c42b --- /dev/null +++ b/engine/economics/index.ts @@ -0,0 +1,12 @@ +export type { + Account, + AccountKind, + Asset, + AssetKind, + Debt, + DebtKind, + EconomicClass, + EconomicState +} from './economic' + +export type { AffordabilityContext, Feasibility, PossiblePurchase } from './affordability' diff --git a/engine/entities/base.ts b/engine/entities/base.ts new file mode 100644 index 0000000..cc7c9ed --- /dev/null +++ b/engine/entities/base.ts @@ -0,0 +1,37 @@ +import type { GameTime } from 'time' +import type { Brand } from 'utils' + +/** + * Branded IDs — string at runtime, distinct at compile time so a PersonId + * can't silently flow into a slot that expects a RelationshipId. + * (utils/types/brand.ts) + */ +export type PersonId = Brand<string, 'PersonId'> +export type RelationshipId = Brand<string, 'RelationshipId'> +export type PlaceId = Brand<string, 'PlaceId'> +export type InstitutionId = Brand<string, 'InstitutionId'> +export type WorldEventId = Brand<string, 'WorldEventId'> +export type WorldId = Brand<string, 'WorldId'> +export type EventLogEntryId = Brand<string, 'EventLogEntryId'> +export type RoutineId = Brand<string, 'RoutineId'> +export type ScheduledEventId = Brand<string, 'ScheduledEventId'> +export type FlowEntryId = Brand<string, 'FlowEntryId'> +export type MemoirId = Brand<string, 'MemoirId'> + +/** Every simulation entity wears one of these kind tags. */ +export type EntityKind = 'person' | 'relationship' | 'institution' | 'place' | 'world_event' + +/** + * The common shape every entity carries. Concrete entities extend this with + * their specific id/kind pair — `Person extends BaseEntity<PersonId, 'person'>`. + * `deterministicSeed` powers lazy Tier 3 regeneration: given the seed, the + * entity's trajectory is fully reproducible without persisted state. + * (ARCHITECTURE.md §26) + */ +export interface BaseEntity<Id extends string = string, K extends EntityKind = EntityKind> { + readonly id: Id + readonly kind: K + readonly createdAt: GameTime + readonly destroyedAt: GameTime | null + readonly deterministicSeed: number +} diff --git a/engine/entities/event-log-entry.ts b/engine/entities/event-log-entry.ts new file mode 100644 index 0000000..ba0b6e2 --- /dev/null +++ b/engine/entities/event-log-entry.ts @@ -0,0 +1,33 @@ +import type { GameTime } from 'time' +import type { EventLogEntryId, PersonId } from './base' + +/** + * Consequences logged against a specific event resolution. The shape is + * kept deliberately open — events may mutate a wide range of state — and + * the consequence writer (events/consequence.ts, later) fills it in. + */ +export interface AppliedConsequence { + readonly targetPath: string + readonly operation: 'set' | 'add' | 'multiply' | 'append' + readonly value: unknown +} + +/** + * One event's entry in a character's event log. Entry IDs are stable so + * memoir generation and History views can reference specific moments. + * Passage text lives in the content registry, keyed by renderedPassageRef, + * so logs stay small. + */ +export interface EventLogEntry { + readonly id: EventLogEntryId + readonly personId: PersonId + readonly time: GameTime + readonly eventTypeId: string + readonly participants: readonly PersonId[] + readonly emotionalWeight: number + readonly themes: readonly string[] + readonly consequences: readonly AppliedConsequence[] + readonly renderedPassageRef: string + readonly playerChoice: string | null + readonly memorableMarker: boolean +} diff --git a/engine/entities/flow-entry.ts b/engine/entities/flow-entry.ts new file mode 100644 index 0000000..ff2e624 --- /dev/null +++ b/engine/entities/flow-entry.ts @@ -0,0 +1,25 @@ +import type { GameTime } from 'time' +import type { FlowEntryId, PersonId, PlaceId, WorldEventId } from './base' + +/** + * A compact snapshot of the context that produced a flow passage. Kept + * alongside the entry so passages can be regenerated deterministically + * if content or voice-modulation changes — no reliance on re-simulating + * the full world to reproduce a specific week's prose. + */ +export interface FlowContextSnapshot { + readonly season: string + readonly placeId: PlaceId + readonly activeWorldEventIds: readonly WorldEventId[] + readonly moodBucket: string + readonly dominantTraitMarkers: readonly string[] +} + +export interface FlowEntry { + readonly id: FlowEntryId + readonly personId: PersonId + readonly time: GameTime + readonly passageText: string + readonly passageRef: string + readonly contextSnapshot: FlowContextSnapshot +} diff --git a/engine/entities/index.ts b/engine/entities/index.ts new file mode 100644 index 0000000..9b520ac --- /dev/null +++ b/engine/entities/index.ts @@ -0,0 +1,67 @@ +export type { + BaseEntity, + EntityKind, + EventLogEntryId, + FlowEntryId, + InstitutionId, + MemoirId, + PersonId, + PlaceId, + RelationshipId, + RoutineId, + ScheduledEventId, + WorldEventId, + WorldId +} from './base' + +export type { AppliedConsequence, EventLogEntry } from './event-log-entry' +export type { FlowContextSnapshot, FlowEntry } from './flow-entry' +export type { Institution, InstitutionEvent, InstitutionType } from './institution' +export type { Memoir, MemoirChapter } from './memoir' +export type { + BirthRecord, + DeathMode, + DeathRecord, + Person, + SimulationTier +} from './person' +export type { PersonName } from './person-name' +export type { + ClimateDescriptor, + CultureDescriptor, + EconomicCharacter, + Place, + PlaceType, + PoliticalCharacter +} from './place' +export type { + ConflictEvent, + FamilyRelation, + InfidelityEvent, + IntimacyAxes, + LoveLanguageMatrix, + LoveLanguageProfile, + Relationship, + RelationshipPerception, + RelationshipState, + RelationType, + RomanticPhase, + SexualActivityState, + SharedExperience, + Tension, + TrustEvent, + WorkRelation +} from './relationship' +export type { ReputationProfile } from './reputation' +export type { ResidenceEntry } from './residence' +export type { Routine, RoutineCategory, RoutineEffect, RoutineItem } from './routine' +export type { ConditionalTrigger, ScheduledEvent } from './scheduled-event' +export type { SocioeconomicTier, StatusDescriptor } from './status' +export type { + CrisisState, + MacroEconomicState, + RegionPoliticalState, + World, + WorldSettings +} from './world' +export type { EventCategory, SeverityLevel, WorldEvent } from './world-event' diff --git a/engine/entities/institution.ts b/engine/entities/institution.ts new file mode 100644 index 0000000..2bb582d --- /dev/null +++ b/engine/entities/institution.ts @@ -0,0 +1,40 @@ +import type { GameTime } from 'time' +import type { BaseEntity, InstitutionId, PersonId, PlaceId } from './base' +import type { CultureDescriptor } from './place' + +export type InstitutionType = + | 'company' + | 'government' + | 'university' + | 'school' + | 'hospital' + | 'religious' + | 'nonprofit' + | 'news' + | 'cultural' + | 'criminal' + | 'military' + +export interface InstitutionEvent { + readonly at: GameTime + readonly kind: string + readonly summary: string +} + +export interface Institution extends BaseEntity<InstitutionId, 'institution'> { + readonly name: string + readonly type: InstitutionType + readonly placeId: PlaceId + readonly foundedAt: GameTime + + readonly culture: CultureDescriptor + + /** Role tag (e.g., "manager", "ceo", "teacher") → person IDs holding it. */ + readonly members: ReadonlyMap<string, readonly PersonId[]> + + readonly prosperity: number + readonly reputation: number + readonly stability: number + + readonly majorEvents: readonly InstitutionEvent[] +} diff --git a/engine/entities/memoir.ts b/engine/entities/memoir.ts new file mode 100644 index 0000000..c6dcf57 --- /dev/null +++ b/engine/entities/memoir.ts @@ -0,0 +1,28 @@ +import type { GameTime } from 'time' +import type { EventLogEntryId, MemoirId, PersonId } from './base' + +export interface MemoirChapter { + readonly order: number + readonly title: string + readonly prose: string + readonly startAge: number + readonly endAge: number + readonly keyEventIds: readonly EventLogEntryId[] + readonly themeEmphasis: readonly string[] +} + +/** + * Generated at character death. 15,000–30,000 words, 8–15 chapters. Persists + * forever in the world's archive; descendants may find it on the Memoirs + * shelf or referenced in flow (docs/14-memoirs.md, ARCHITECTURE.md §17). + */ +export interface Memoir { + readonly id: MemoirId + readonly personId: PersonId + readonly generatedAt: GameTime + readonly chapters: readonly MemoirChapter[] + readonly totalWordCount: number + readonly themes: readonly string[] + readonly publicVersion: boolean + readonly publishedAt: GameTime | null +} diff --git a/engine/entities/person-name.ts b/engine/entities/person-name.ts new file mode 100644 index 0000000..5f84b41 --- /dev/null +++ b/engine/entities/person-name.ts @@ -0,0 +1,14 @@ +/** + * A character's name as tracked by the simulation. Surnames follow + * inheritance rules per region/era (docs/19-names.md) — including keep- + * maiden, hyphenate, matrilineal, and ad-hoc changes — so the structure + * preserves both the current surname and the maiden form when relevant. + */ +export interface PersonName { + readonly given: string + readonly middle: string | null + readonly surname: string + readonly maidenSurname: string | null + readonly nicknames: readonly string[] + readonly preferredName: string | null +} diff --git a/engine/entities/person.ts b/engine/entities/person.ts new file mode 100644 index 0000000..db86c47 --- /dev/null +++ b/engine/entities/person.ts @@ -0,0 +1,138 @@ +import type { GameTime } from 'time' +import type { CareerState } from '../career' +import type { EconomicState } from '../economics' +import type { HealthState, MentalHealthState, Condition } from '../health' +import type { Dependency, MoodState, SatisfactionProfile, Scar } from '../state' +import type { + AttachmentDistribution, + BigFiveProfile, + CoreBeliefs, + DarkTriadProfile, + SexualOrientation, + ValuesOrientation +} from '../traits' +import type { BaseEntity, PersonId, PlaceId, RelationshipId } from './base' +import type { EventLogEntry } from './event-log-entry' +import type { PersonName } from './person-name' +import type { ReputationProfile } from './reputation' +import type { ResidenceEntry } from './residence' +import type { StatusDescriptor } from './status' + +/** Modes of death per docs/20-death-textures.md. */ +export type DeathMode = + | 'expected_old_age' + | 'sudden_accident' + | 'terminal_illness' + | 'suicide' + | 'violent_death' + | 'during_sleep' + | 'childbirth' + | 'war' + | 'child_or_infant' + +/** + * The defining demographic facts of a birth, captured in prose-ready form. + * The familyContext string is the one-paragraph summary the opening scene + * draws on (docs/17-first-hour.md §"Birth moment"). + */ +export interface BirthRecord { + readonly date: GameTime + readonly placeId: PlaceId + readonly familyContext: string +} + +export interface DeathRecord { + readonly date: GameTime + readonly mode: DeathMode + readonly placeId: PlaceId + readonly sceneSummary: string +} + +/** + * NPC simulation fidelity tier. 1 = full weekly simulation (~10-30 entities), + * 2 = quarterly compressed, 3 = generated on demand from seed. + * See docs/06-autonomy.md §"Tiered simulation fidelity". + */ +export type SimulationTier = 1 | 2 | 3 + +/** + * Person — the main simulated entity. Players and NPCs share this shape. + * Fields are grouped by trait layer (docs/04-traits.md): + * + * Layer 1 temperament (Big Five + Dark Triad) — mostly stable + * Layer 2 developmental (attachment, core beliefs, values, orientation) + * Layer 3 state (mood, stress, energy, trauma load, satisfaction) + * Layer 4 acquired (skills, knowledge, habits, dependencies, scars) + * Layer 5 social (reputation, status, network capital) + * + * Numeric fields stay hidden from the player; everything surfaces as prose. + */ +export interface Person extends BaseEntity<PersonId, 'person'> { + readonly name: PersonName + + readonly birth: BirthRecord + readonly death: DeathRecord | null + + // Layer 1 — temperament + readonly bigFive: BigFiveProfile + readonly darkTriad: DarkTriadProfile + + // Layer 2 — developmental + readonly attachment: AttachmentDistribution + readonly coreBeliefs: CoreBeliefs + readonly conscienceCapacity: number + readonly values: ValuesOrientation + readonly orientation: SexualOrientation + + // Layer 3 — fluctuating state + readonly mood: MoodState + readonly stress: number + readonly energy: number + readonly traumaLoad: number + readonly satisfaction: SatisfactionProfile + + // Layer 4 — acquired + readonly skills: ReadonlyMap<string, number> + readonly knowledge: ReadonlyMap<string, number> + readonly habits: readonly string[] + readonly dependencies: readonly Dependency[] + readonly scars: readonly Scar[] + + // Layer 5 — social + readonly reputation: ReputationProfile + readonly status: StatusDescriptor + readonly networkCapital: number + + // Health + readonly health: HealthState + readonly chronicConditions: readonly Condition[] + readonly mentalHealthState: MentalHealthState + + // Economic / career + readonly economic: EconomicState + readonly career: CareerState + + // Relationships + location + readonly relationshipIds: readonly RelationshipId[] + readonly currentPlaceId: PlaceId + readonly residenceHistory: readonly ResidenceEntry[] + + // Simulation metadata + readonly tier: SimulationTier + readonly lastSimulatedAt: GameTime + + // Event history + readonly eventLog: readonly EventLogEntry[] + readonly memorableMoments: readonly string[] + + // Player-character flags + readonly isPlayerCharacter: boolean + readonly playerCharacterStartedAt: GameTime | null + readonly playerCharacterEndedAt: GameTime | null + + // Family (denormalised for fast access; the authoritative source is the + // Relationship entities keyed family_parent / family_child / family_spouse) + readonly parentIds: readonly [PersonId | null, PersonId | null] + readonly childIds: readonly PersonId[] + readonly spouseIds: readonly PersonId[] +} diff --git a/engine/entities/place.ts b/engine/entities/place.ts new file mode 100644 index 0000000..2a38c41 --- /dev/null +++ b/engine/entities/place.ts @@ -0,0 +1,55 @@ +import type { BaseEntity, PersonId, PlaceId } from './base' + +export type PlaceType = 'region' | 'city' | 'neighborhood' | 'specific_location' + +/** + * Cultural character of a region or city — drives event textures, + * stereotypes, attitudes. Open-ended because cultures differ on many axes; + * specific named attributes live alongside this via content references. + */ +export interface CultureDescriptor { + readonly dominantFaithId: string | null + readonly cosmopolitanism: number + readonly conservatism: number + readonly hospitality: number + readonly tags: readonly string[] +} + +export interface ClimateDescriptor { + readonly latitudeBand: 'tropical' | 'temperate' | 'continental' | 'arid' | 'alpine' | 'tundra' + readonly summerSeverity: number + readonly winterSeverity: number + readonly rainfall: number + readonly notes: string +} + +export interface EconomicCharacter { + readonly primaryIndustries: readonly string[] + readonly inequality: number + readonly prosperity: number +} + +export interface PoliticalCharacter { + readonly form: 'democracy' | 'mixed' | 'authoritarian' | 'oligarchy' | 'other' + readonly stability: number + readonly currentTensions: readonly string[] +} + +export interface Place extends BaseEntity<PlaceId, 'place'> { + readonly name: string + readonly type: PlaceType + readonly parentPlaceId: PlaceId | null + + // Present for regions and cities; null for specific locations. + readonly culture: CultureDescriptor | null + readonly climate: ClimateDescriptor | null + readonly economy: EconomicCharacter | null + readonly politics: PoliticalCharacter | null + + readonly population: number + + // Present for specific locations (houses, workplaces); null for containers. + readonly ownerId: PersonId | null + readonly currentResidents: readonly PersonId[] + readonly propertyValue: number | null +} diff --git a/engine/entities/relationship.ts b/engine/entities/relationship.ts new file mode 100644 index 0000000..c6a771c --- /dev/null +++ b/engine/entities/relationship.ts @@ -0,0 +1,176 @@ +import type { GameTime } from 'time' +import type { BaseEntity, PersonId, RelationshipId } from './base' + +export type RelationType = + | 'family_parent' + | 'family_child' + | 'family_sibling' + | 'family_cousin' + | 'family_grandparent' + | 'family_grandchild' + | 'family_inlaw' + | 'romantic_dating' + | 'romantic_married' + | 'romantic_divorced' + | 'romantic_ex' + | 'romantic_affair' + | 'friend_close' + | 'friend_casual' + | 'friend_drifted' + | 'professional_colleague' + | 'professional_boss' + | 'professional_report' + | 'professional_client' + | 'professional_mentor' + | 'professional_mentee' + | 'acquaintance' + | 'stranger_known' + | 'enemy' + +export type RelationshipState = 'warm' | 'neutral' | 'strained' | 'ruptured' | 'dormant' + +/** + * The four axes of intimacy (docs/07-relationships.md §"Relationship state + * vector"). Each 0–1. Tracked separately because a marriage can be high + * on practical and low on emotional — that's a specific life texture, not + * a compatibility score. + */ +export interface IntimacyAxes { + readonly emotional: number + readonly intellectual: number + readonly physical: number + readonly practical: number +} + +export interface TrustEvent { + readonly at: GameTime + readonly delta: number + readonly eventRef: string +} + +export interface ConflictEvent { + readonly at: GameTime + readonly topic: string + readonly intensity: number + readonly resolved: boolean + readonly residue: number +} + +export interface SharedExperience { + readonly at: GameTime + readonly kind: string + readonly emotionalWeight: number + readonly summary: string +} + +export interface Tension { + readonly id: string + readonly topic: string + readonly since: GameTime + readonly intensity: number +} + +/** The five love languages, matched per side — what each person gives vs. + * what they need from the other. Misalignment is a real relationship shape. */ +export interface LoveLanguageProfile { + readonly wordsOfAffirmation: number + readonly actsOfService: number + readonly receivingGifts: number + readonly qualityTime: number + readonly physicalTouch: number +} + +export interface LoveLanguageMatrix { + readonly aGives: LoveLanguageProfile + readonly aNeeds: LoveLanguageProfile + readonly bGives: LoveLanguageProfile + readonly bNeeds: LoveLanguageProfile +} + +/** + * Asymmetric perception: A and B each have their own mental model of the + * relationship. Large asymmetries fire scenes (confession, rebuff, shocked + * realisation). See docs/07-relationships.md §"Asymmetric perception". + */ +export interface RelationshipPerception { + readonly perceivedType: RelationType + readonly perceivedIntimacy: IntimacyAxes + readonly perceivedTrust: number + readonly lastUpdated: GameTime +} + +export type RomanticPhase = + | 'attraction' + | 'infatuation' + | 'deepening' + | 'committed' + | 'power_struggle' + | 'stability' + | 'mature_love' + | 'decline' + | 'rupture' + +export interface SexualActivityState { + readonly frequencyPerMonth: number + readonly mutualSatisfaction: number + readonly openness: number +} + +export interface InfidelityEvent { + readonly at: GameTime + readonly withPersonId: PersonId | null + readonly kind: 'emotional' | 'physical' | 'both' + readonly discoveredAt: GameTime | null +} + +export type FamilyRelation = + | 'parent' + | 'child' + | 'sibling' + | 'cousin' + | 'grandparent' + | 'grandchild' + | 'inlaw' + +export type WorkRelation = 'colleague' | 'boss' | 'report' | 'client' | 'mentor' | 'mentee' + +export interface Relationship extends BaseEntity<RelationshipId, 'relationship'> { + readonly personAId: PersonId + readonly personBId: PersonId + + readonly type: RelationType + readonly typeHistory: readonly { readonly type: RelationType; readonly from: GameTime }[] + + readonly startedAt: GameTime + + readonly intimacy: IntimacyAxes + readonly trust: number + readonly trustHistory: readonly TrustEvent[] + readonly powerBalance: number + + readonly conflicts: readonly ConflictEvent[] + readonly sharedExperiences: readonly SharedExperience[] + readonly unresolvedTensions: readonly Tension[] + + readonly loveLanguages: LoveLanguageMatrix + + readonly currentState: RelationshipState + + readonly aPerception: RelationshipPerception + readonly bPerception: RelationshipPerception + + readonly lastInteractionAt: GameTime + readonly interactionFrequency: number + + // Romantic-only details; null when the relationship isn't romantic. + readonly romanticPhase: RomanticPhase | null + readonly sexualActivity: SexualActivityState | null + readonly infidelityHistory: readonly InfidelityEvent[] + readonly commitmentLevel: number + + // Family-only. + readonly familyRelationType: FamilyRelation | null + + // Professional-only. + readonly workRelationType: WorkRelation | null +} diff --git a/engine/entities/reputation.ts b/engine/entities/reputation.ts new file mode 100644 index 0000000..07b747b --- /dev/null +++ b/engine/entities/reputation.ts @@ -0,0 +1,11 @@ +/** + * Reputation at three scopes. Local = neighbourhood / small community. + * Professional = workplace and industry. Broader = public / civic; + * usually 0 for most characters and non-zero for notable figures. + * Each -1 (disrepute) to 1 (esteem). + */ +export interface ReputationProfile { + readonly local: number + readonly professional: number + readonly broader: number +} diff --git a/engine/entities/residence.ts b/engine/entities/residence.ts new file mode 100644 index 0000000..6a404f7 --- /dev/null +++ b/engine/entities/residence.ts @@ -0,0 +1,10 @@ +import type { GameTime } from 'time' +import type { PlaceId } from './base' + +/** A span of time a character lived at a specific place. Open-ended if the + * character still lives there. */ +export interface ResidenceEntry { + readonly placeId: PlaceId + readonly from: GameTime + readonly to: GameTime | null +} diff --git a/engine/entities/routine.ts b/engine/entities/routine.ts new file mode 100644 index 0000000..adb2b1d --- /dev/null +++ b/engine/entities/routine.ts @@ -0,0 +1,37 @@ +import type { GameTime } from 'time' +import type { PersonId, RoutineId } from './base' + +export type RoutineCategory = 'work' | 'relationships' | 'self' | 'home' | 'play' | 'service' + +/** + * How a routine item modifies state each week. `targetSkill` and + * `targetStatVariable` are mutually exclusive per effect — one effect + * either grows a skill or nudges a state variable, not both. + */ +export interface RoutineEffect { + readonly targetSkill: string | null + readonly targetStatVariable: string | null + readonly delta: number +} + +export interface RoutineItem { + readonly id: string + readonly category: RoutineCategory + readonly description: string + readonly effects: readonly RoutineEffect[] + readonly hoursPerWeek: number + readonly startedAt: GameTime + readonly endedAt: GameTime | null +} + +/** + * Persistent weekly commitments for a character. Routines run silently in + * the flow stream — the player sets them once, they keep running until + * changed (docs/05-time-system.md §"Routines and flow"). + */ +export interface Routine { + readonly id: RoutineId + readonly personId: PersonId + readonly items: readonly RoutineItem[] + readonly lastModifiedAt: GameTime +} diff --git a/engine/entities/scheduled-event.ts b/engine/entities/scheduled-event.ts new file mode 100644 index 0000000..5ea9609 --- /dev/null +++ b/engine/entities/scheduled-event.ts @@ -0,0 +1,24 @@ +import type { GameTime } from 'time' +import type { PersonId, ScheduledEventId } from './base' + +/** + * A future event trigger, either at a fixed time or when conditions hold. + * Taking a bribe at 30 might schedule a `bribery_audit` at +15 years with + * elevated weight (ARCHITECTURE.md §6 §"Scheduled events"). + */ +export interface ConditionalTrigger { + readonly kind: 'conditional' + readonly condition: string + readonly earliestTime: GameTime | null + readonly latestTime: GameTime | null +} + +export interface ScheduledEvent { + readonly id: ScheduledEventId + readonly eventTypeId: string + readonly scheduledFor: GameTime | ConditionalTrigger + readonly targetPersonId: PersonId + readonly context: Readonly<Record<string, unknown>> + readonly eligibilityRecheck: boolean + readonly priority: number +} diff --git a/engine/entities/status.ts b/engine/entities/status.ts new file mode 100644 index 0000000..5b1b823 --- /dev/null +++ b/engine/entities/status.ts @@ -0,0 +1,18 @@ +/** + * Status descriptor surfaces derived labels for display prose. Socioeconomic + * is drawn from the character's EconomicClass; professional and social come + * out of career + reputation. Never shown as numbers to the player. + */ +export type SocioeconomicTier = + | 'struggling' + | 'working' + | 'middle' + | 'upper_middle' + | 'wealthy' + | 'old_money' + +export interface StatusDescriptor { + readonly socioeconomic: SocioeconomicTier + readonly professional: string + readonly social: string +} diff --git a/engine/entities/world-event.ts b/engine/entities/world-event.ts new file mode 100644 index 0000000..e414bf4 --- /dev/null +++ b/engine/entities/world-event.ts @@ -0,0 +1,39 @@ +import type { GameTime } from 'time' +import type { BaseEntity, PersonId, PlaceId, WorldEventId } from './base' + +export type EventCategory = + | 'pandemic' + | 'war' + | 'economic' + | 'political' + | 'natural_disaster' + | 'cultural' + | 'scientific' + | 'religious' + | 'social_movement' + | 'crime' + | 'notable_individual' + +export type SeverityLevel = 'mild' | 'moderate' | 'severe' | 'catastrophic' + +/** + * A named macro event decorating the timeline. See docs/02-world-events.md. + * The character-level impact of each event is applied per-person via + * templates referenced by contentRef; this entity is the world-scale record. + */ +export interface WorldEvent extends BaseEntity<WorldEventId, 'world_event'> { + readonly contentRef: string + readonly nameFormal: string + readonly nameColloquial: string + readonly category: EventCategory + + readonly startedAt: GameTime + readonly endedAt: GameTime | null + + readonly affectedRegions: ReadonlyMap<PlaceId, SeverityLevel> + + readonly description: string + + /** IDs of people who have had this event's per-person impact applied. */ + readonly impactsApplied: readonly PersonId[] +} diff --git a/engine/entities/world.ts b/engine/entities/world.ts new file mode 100644 index 0000000..539a3a7 --- /dev/null +++ b/engine/entities/world.ts @@ -0,0 +1,62 @@ +import type { GameTime } from 'time' +import type { PersonId, PlaceId, WorldEventId, WorldId } from './base' +import type { ScheduledEvent } from './scheduled-event' + +/** + * Macro economic state tracked at the world scale. Individual characters' + * economics are derived against this background (docs/09-economy.md + * §"Macro economy"). + */ +export interface MacroEconomicState { + readonly inflationAnnual: number + readonly employmentRate: number + readonly marketIndex: number + readonly recessionDepth: number +} + +export interface RegionPoliticalState { + readonly stability: number + readonly currentRegime: string + readonly tensions: readonly string[] +} + +export interface WorldSettings { + readonly contentVersionAtCreation: string + readonly schemaVersion: number +} + +export interface CrisisState { + readonly active: boolean + readonly crisisEventId: string | null + readonly sceneIndex: number + readonly startedAt: GameTime | null +} + +/** + * The world container. One continuous world per player (ARCHITECTURE.md §16, + * docs/16-world-continuity.md). Time in this world never resets once + * created; successive player characters advance it forward. + */ +export interface World { + readonly id: WorldId + readonly seed: string + readonly createdAt: string // ISO timestamp, real-world clock — not a GameTime + + readonly currentGameTime: GameTime + + readonly currentPlayerCharacterId: PersonId | null + readonly playedCharacterIds: readonly PersonId[] + + readonly tierOneIds: readonly PersonId[] + readonly tierTwoIds: readonly PersonId[] + + readonly economy: MacroEconomicState + readonly politicsByRegion: ReadonlyMap<PlaceId, RegionPoliticalState> + + readonly activeEventIds: readonly WorldEventId[] + readonly scheduledEvents: readonly ScheduledEvent[] + + readonly crisisState: CrisisState + + readonly settings: WorldSettings +} diff --git a/engine/health/health.ts b/engine/health/health.ts new file mode 100644 index 0000000..b623710 --- /dev/null +++ b/engine/health/health.ts @@ -0,0 +1,77 @@ +import type { GameTime } from 'time' + +export type EatingPattern = 'poor' | 'irregular' | 'moderate' | 'good' | 'athletic' + +/** Alcohol, smoking, drugs, activity level — the background variables that + * compound into long-term health outcomes. */ +export interface LifestyleProfile { + readonly alcohol: number + readonly smoking: number + readonly drugs: number + readonly activity: number + readonly diet: number + readonly compositeRisk: number +} + +export interface SexualHealthState { + readonly activeInfections: readonly string[] + readonly pastInfections: readonly string[] + readonly contraceptionInUse: string | null + readonly fertility: number +} + +/** A symptom visible to the character (or to those around them). */ +export interface Symptom { + readonly id: string + readonly kind: string + readonly severity: number + readonly onsetAt: GameTime + readonly isChronic: boolean +} + +/** A condition the character knows about and has a name for. */ +export interface Condition { + readonly id: string + readonly kind: string + readonly diagnosedAt: GameTime | null + readonly severity: number + readonly isTerminal: boolean + readonly mortalityMultiplier: number + readonly managementInPlace: boolean +} + +/** + * A condition the simulation tracks but the character doesn't yet know about. + * Surface paths include worsening symptoms, doctor visits, routine screens, + * or incidental discovery (docs/08-mental-health.md §"Suicide risk" for the + * comparable mental-health pattern; this covers physical equivalents). + */ +export interface UndiagnosedCondition { + readonly id: string + readonly kind: string + readonly onsetAt: GameTime + readonly visibleSymptomIds: readonly string[] + readonly severity: number + readonly discoveryTriggers: readonly string[] +} + +/** A past medical event kept in the character's file. */ +export interface MedicalEvent { + readonly id: string + readonly kind: string + readonly occurredAt: GameTime + readonly summary: string +} + +export interface HealthState { + readonly overallQuality: number + readonly fitness: number + readonly sleepQuality: number + readonly eatingPattern: EatingPattern + readonly energyBaseline: number + readonly lifestyle: LifestyleProfile + readonly sexualHealth: SexualHealthState + readonly currentSymptoms: readonly Symptom[] + readonly undiagnosed: readonly UndiagnosedCondition[] + readonly medicalHistory: readonly MedicalEvent[] +} diff --git a/engine/health/index.ts b/engine/health/index.ts new file mode 100644 index 0000000..0577d7a --- /dev/null +++ b/engine/health/index.ts @@ -0,0 +1,20 @@ +export type { + Condition, + EatingPattern, + HealthState, + LifestyleProfile, + MedicalEvent, + SexualHealthState, + Symptom, + UndiagnosedCondition +} from './health' + +export type { + CopingStrategy, + HistoricalCondition, + Medication, + MentalCondition, + MentalHealthState, + SuicidalRisk, + TraumaPattern +} from './mental-health' diff --git a/engine/health/mental-health.ts b/engine/health/mental-health.ts new file mode 100644 index 0000000..2f86947 --- /dev/null +++ b/engine/health/mental-health.ts @@ -0,0 +1,67 @@ +import type { GameTime } from 'time' + +/** Currently-active mental-health condition. Specific disorder vocabulary + * lives in content; the runtime state is shape + kind tag. */ +export interface MentalCondition { + readonly id: string + readonly kind: string + readonly onsetAt: GameTime + readonly severity: number + readonly inTreatment: boolean +} + +/** A condition the character has had and no longer meets active criteria for, + * but which still informs relapse probability and event eligibility. */ +export interface HistoricalCondition { + readonly id: string + readonly kind: string + readonly startedAt: GameTime + readonly endedAt: GameTime + readonly peakSeverity: number + readonly inRemission: boolean +} + +export interface TraumaPattern { + readonly id: string + readonly source: string + readonly firstOnsetAt: GameTime + readonly hypervigilance: number + readonly avoidance: number + readonly intrusions: number +} + +export interface CopingStrategy { + readonly id: string + readonly kind: string + readonly adaptive: boolean + readonly reliance: number +} + +export interface Medication { + readonly id: string + readonly name: string + readonly startedAt: GameTime + readonly endedAt: GameTime | null + readonly dosage: number + readonly effectiveness: number +} + +/** + * Hidden even from the character until crisis. The simulation knows; the + * prose surfaces behaviour, not numbers (docs/08-mental-health.md §"Suicide"). + */ +export interface SuicidalRisk { + readonly current: number + readonly history: readonly { readonly at: GameTime; readonly value: number }[] + readonly lastAssessedAt: GameTime +} + +export interface MentalHealthState { + readonly activeConditions: readonly MentalCondition[] + readonly historyOfConditions: readonly HistoricalCondition[] + readonly traumaPatterns: readonly TraumaPattern[] + readonly copingStrategies: readonly CopingStrategy[] + readonly inTherapy: boolean + readonly medication: readonly Medication[] + readonly suicidalRisk: SuicidalRisk +} diff --git a/engine/index.ts b/engine/index.ts new file mode 100644 index 0000000..d3a11cb --- /dev/null +++ b/engine/index.ts @@ -0,0 +1,6 @@ +export * from './career' +export * from './economics' +export * from './entities' +export * from './health' +export * from './state' +export * from './traits' diff --git a/engine/state/dependency.ts b/engine/state/dependency.ts new file mode 100644 index 0000000..53ab4de --- /dev/null +++ b/engine/state/dependency.ts @@ -0,0 +1,25 @@ +import type { GameTime } from 'time' + +/** + * A substance or behavioural dependency at a given stage of progression. + * Stages mirror docs/08-mental-health.md §"Addiction modeled honestly": + * experimentation → regular use → problem use → dependence → crisis → + * recovery | chronic | death. + */ +export type DependencyStage = + | 'experimentation' + | 'regular_use' + | 'problem_use' + | 'dependence' + | 'crisis' + | 'in_recovery' + | 'chronic' + +export interface Dependency { + readonly id: string + readonly substance: string + readonly stage: DependencyStage + readonly severity: number + readonly startedAt: GameTime + readonly lastRelapseAt: GameTime | null +} diff --git a/engine/state/index.ts b/engine/state/index.ts new file mode 100644 index 0000000..1641d3b --- /dev/null +++ b/engine/state/index.ts @@ -0,0 +1,4 @@ +export type { Dependency, DependencyStage } from './dependency' +export type { MoodState } from './mood' +export type { SatisfactionProfile } from './satisfaction' +export type { Scar } from './scar' diff --git a/engine/state/mood.ts b/engine/state/mood.ts new file mode 100644 index 0000000..1686292 --- /dev/null +++ b/engine/state/mood.ts @@ -0,0 +1,13 @@ +import type { GameTime } from 'time' + +/** + * Current-week emotional state on the valence × arousal plane. + * valence -1 (negative) to +1 (positive) + * arousal -1 (calm) to +1 (activated) + * See docs/08-mental-health.md §"Separate variables". + */ +export interface MoodState { + readonly valence: number + readonly arousal: number + readonly lastUpdated: GameTime +} diff --git a/engine/state/satisfaction.ts b/engine/state/satisfaction.ts new file mode 100644 index 0000000..a10421b --- /dev/null +++ b/engine/state/satisfaction.ts @@ -0,0 +1,10 @@ +/** + * Life satisfaction split into hedonic (day-to-day pleasure) and eudaimonic + * (sense of meaning / purpose). They can diverge, and eudaimonic matters + * more for end-of-life peace (docs/13-spirituality.md §"Life satisfaction + * is distinct from happiness"). Each 0–1. + */ +export interface SatisfactionProfile { + readonly hedonic: number + readonly eudaimonic: number +} diff --git a/engine/state/scar.ts b/engine/state/scar.ts new file mode 100644 index 0000000..3cd682a --- /dev/null +++ b/engine/state/scar.ts @@ -0,0 +1,14 @@ +import type { GameTime } from 'time' + +/** + * A lasting mark left by a high-weight event. Scars don't decay the way + * mood or stress do — they persist and colour future trait drift, + * relationship patterns, and event eligibility. + */ +export interface Scar { + readonly id: string + readonly kind: string + readonly occurredAt: GameTime + readonly severity: number + readonly summary: string +} diff --git a/engine/traits/attachment.ts b/engine/traits/attachment.ts new file mode 100644 index 0000000..7af4c1b --- /dev/null +++ b/engine/traits/attachment.ts @@ -0,0 +1,11 @@ +/** + * Attachment is tracked as a distribution, not a single tag. Fractions sum + * to 1.0; a character is rarely purely one style. Set by age 3 based on + * caregiver behaviour, mostly fixed thereafter (docs/04-traits.md §"Layer 2"). + */ +export interface AttachmentDistribution { + readonly secure: number + readonly anxious: number + readonly avoidant: number + readonly disorganized: number +} diff --git a/engine/traits/big-five.ts b/engine/traits/big-five.ts new file mode 100644 index 0000000..425c91c --- /dev/null +++ b/engine/traits/big-five.ts @@ -0,0 +1,11 @@ +/** + * Big Five temperament profile, each 0–100. Mostly stable across a life + * with slow drift under sustained conditions. See docs/04-traits.md §"Layer 1". + */ +export interface BigFiveProfile { + readonly openness: number + readonly conscientiousness: number + readonly extraversion: number + readonly agreeableness: number + readonly neuroticism: number +} diff --git a/engine/traits/core-beliefs.ts b/engine/traits/core-beliefs.ts new file mode 100644 index 0000000..4e3b85a --- /dev/null +++ b/engine/traits/core-beliefs.ts @@ -0,0 +1,10 @@ +/** + * Core beliefs shape how adult events are interpreted (docs/04-traits.md + * §"Layer 2"). Each 0–100. Formed in early childhood, harder to shift after. + */ +export interface CoreBeliefs { + readonly selfWorth: number + readonly worldSafety: number + readonly othersTrustworthy: number + readonly agency: number +} diff --git a/engine/traits/dark-triad.ts b/engine/traits/dark-triad.ts new file mode 100644 index 0000000..e8e1450 --- /dev/null +++ b/engine/traits/dark-triad.ts @@ -0,0 +1,10 @@ +/** + * Dark Triad profile, each 0–100. Distribution is skewed low — most + * characters sit in the 20–40 range; a small minority above 60 drives + * specific life shapes (docs/04-traits.md §"Dark Triad characters in play"). + */ +export interface DarkTriadProfile { + readonly narcissism: number + readonly machiavellianism: number + readonly psychopathy: number +} diff --git a/engine/traits/index.ts b/engine/traits/index.ts new file mode 100644 index 0000000..c743af8 --- /dev/null +++ b/engine/traits/index.ts @@ -0,0 +1,6 @@ +export type { AttachmentDistribution } from './attachment' +export type { BigFiveProfile } from './big-five' +export type { CoreBeliefs } from './core-beliefs' +export type { DarkTriadProfile } from './dark-triad' +export type { Gender, SexualOrientation } from './orientation' +export type { ValuesOrientation } from './values' diff --git a/engine/traits/orientation.ts b/engine/traits/orientation.ts new file mode 100644 index 0000000..60decd9 --- /dev/null +++ b/engine/traits/orientation.ts @@ -0,0 +1,16 @@ +/** + * Gender identity and sexual orientation. Continuous axes plus a discrete + * gender tag. See docs/04-traits.md §"Layer 2" and docs/10-sexuality.md. + * + * sexualAttraction 0 = hetero-exclusive, 100 = homo-exclusive + * romanticAttraction independent continuous axis + * sexualityAwareness 0 = pre-discovery, 1 = fully integrated self-knowledge + */ +export type Gender = 'male' | 'female' | 'nonbinary' | 'trans-male' | 'trans-female' + +export interface SexualOrientation { + readonly sexualAttraction: number + readonly romanticAttraction: number + readonly gender: Gender + readonly sexualityAwareness: number +} diff --git a/engine/traits/values.ts b/engine/traits/values.ts new file mode 100644 index 0000000..0d67d16 --- /dev/null +++ b/engine/traits/values.ts @@ -0,0 +1,12 @@ +/** + * Values orientation. Each axis is 0–100 where 0 anchors the left-named + * pole and 100 the right (e.g., tradition_vs_novelty: 0 = deeply traditional, + * 100 = novelty-seeking). See docs/04-traits.md §"Layer 2". + */ +export interface ValuesOrientation { + readonly tradition_vs_novelty: number + readonly selfDirection_vs_conformity: number + readonly hedonism_vs_duty: number + readonly universalism_vs_ingroup: number + readonly power_vs_egalitarian: number +} |