Create sub-issue documentation for EventCategory TypeScript migration

[Copilot]

This PR creates comprehensive documentation for a sub-issue derived from Issue #60 (Add weather agent to the simulation). The sub-issue focuses on migrating the EventCategory component to TypeScript as part of the weather agent implementation.

What was created

Sub-Issue Documentation (docs/sub-issues/event-category-typescript-migration.md)

• Complete technical specification for migrating EventCategory to TypeScript
• 5-phase implementation plan with detailed timelines and deliverables
• Risk assessment and mitigation strategies
• Integration requirements with the existing BDI (Belief-Desire-Intention) architecture
• Success criteria and acceptance testing guidelines

TypeScript Prototype (docs/prototypes/EventCategory.ts)

• Functional EventCategory class implementation demonstrating the target architecture
• Comprehensive TypeScript interfaces for weather effects, transitions, and conditions
• Factory methods for common weather types (Light Rain, Heavy Storm)
• Type-safe weather event probability calculations
• Integration patterns with existing simulation components

Technical Design

The EventCategory component is designed to categorize weather events within the simulation's environment:

const lightRain = EventCategory.createLightRain();
const probability = lightRain.calculateProbability({
  temperature: 15,
  humidity: 85,
  pressure: 1008,
  windSpeed: 12,
  timeOfDay: 'evening',
  season: 'autumn'
});

Key features include:

• Weather event classification with severity levels (0-100)
• Environmental effects modeling (temperature, humidity, visibility, wind, pressure)
• Probabilistic weather state transitions based on current conditions
• Type-safe interfaces ensuring correct weather data handling
• Integration with the existing BDI agent architecture

Implementation Strategy

The migration follows a structured 5.5-day timeline:

1. TypeScript Infrastructure - Set up build tooling and configuration
2. Core Implementation - Develop EventCategory with supporting interfaces
3. BDI Integration - Connect with existing belief/desire/intention systems
4. Testing & Validation - Comprehensive testing including type checking
5. Documentation - Migration guidelines for future TypeScript adoption

This represents the first step toward TypeScript adoption in the emeritus-agent project, establishing patterns and infrastructure for future component migrations while maintaining full backward compatibility with the existing JavaScript codebase.

Repository Organization

Added structured documentation directories:

• docs/sub-issues/ - Detailed sub-issue specifications
• docs/prototypes/ - Prototype implementations and design explorations
• Updated .gitignore to exclude test coverage artifacts

The documentation provides a clear roadmap for implementing EventCategory as a foundational component of the weather agent system, with detailed consideration of integration challenges and migration best practices.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.