For students education reasons

7 Open Issues Need Help Last updated: Sep 21, 2025

Open Issues Need Help

View All on GitHub

AI Summary: This issue proposes refactoring the `get_status` methods within `HiveComponent` subclasses, such as `Aggregate` and `Transformation`, to eliminate code duplication. The recommendation is to introduce a `_base_status()` method in the `HiveComponent` abstract base class to provide common status fields. Subclasses would then call this base method and merge their specific status information, thereby centralizing status reporting and adhering to the DRY principle.

Complexity: 3/5
enhancement good first issue refactor

For students education reasons

Python

AI Summary: This GitHub issue identifies a purity problem in the `PollenEvent` validation, where the current simplistic check for past-tense event types allows non-compliant events. This ambiguity decreases quality and could lead to confusion. The recommendation is to replace the current validation with a more robust solution, such as integrating a linguistic library or maintaining a comprehensive dictionary of allowed past-tense verbs, to strictly enforce the protocol.

Complexity: 3/5
bug enhancement good first issue

For students education reasons

Python

AI Summary: This GitHub issue proposes formally declaring all optional dependencies, such as `GPUtil` and `google.generativeai`, within `pyproject.toml` using `[project.optional-dependencies]`. Currently, these are undeclared, which increases developer onboarding complexity, decreases system legibility, and hinders collaboration due to environment setup issues. Implementing this change would make project requirements transparent and enable explicit, reproducible installation of optional features.

Complexity: 2/5
documentation enhancement good first issue

For students education reasons

Python

AI Summary: The `triggerEmotionalWave` function in `frontend/src/utils/emotionalContagion.ts` has mixed responsibilities, handling both the creation of `EmotionalInfluence` objects and direct modification of the engine's internal state. This violates the Separation of Concerns principle by tightly coupling high-level actions with low-level implementation details. The recommendation is to refactor the function to solely create the influence objects, delegating the state update and event emission to a new, separate internal method.

Complexity: 2/5
enhancement good first issue refactor

For students education reasons

Python

AI Summary: The issue highlights a brittle environment detection logic in `frontend/src/config/env.ts`, where `isDevelopment` relies on a hardcoded list of hostnames. The recommendation is to transition to an explicit build-time variable (e.g., `VITE_ENVIRONMENT`) as the primary detection method, with the current hostname check serving as a documented fallback.

Complexity: 2/5
enhancement good first issue config

For students education reasons

Python

AI Summary: The `physicsCocoon.ts` file in the frontend currently mixes core engine logic with numerous distinct validation functions, violating modularity and making it hard to maintain. The proposed solution is to refactor these validation functions into individual files within a new `validationRules` directory, allowing the main engine to import and compose them for a cleaner, more extensible system.

Complexity: 1/5
enhancement good first issue refactor

For students education reasons

Python

AI Summary: This GitHub issue requests adding comments to numerical constants like `EMOTIONAL_HISTORY_LENGTH` and `RECENT_HISTORY_SAMPLE` in `frontend/src/utils/emotionalContagion.ts`. The current lack of explanation violates legibility, making it difficult for future developers to understand the rationale behind these specific values. The proposed solution is to add inline comments detailing their purpose and any trade-offs.

Complexity: 1/5
documentation enhancement good first issue

For students education reasons

Python