Good First Issues

Hi team, I recently started exploring Hive after learning about the project and found the concept of self-evolving AI agents very interesting. While reading through the repository, I felt that adding a simple beginner-friendly explanation of how Hive agents work in real-world scenarios could help new contributors understand the platform faster. For example, it might help to include: 1.A simple workflow example 2.One practical business use case 3.A small diagram showing how agents interact This could make onboarding easier for people who are new to AI agent platforms. Thank you for building this project!

Created: 2/6/2026 • 1 comments

The README explains Hive’s vision and architecture very well, but as a first-time contributor it’s still difficult to understand what actually happens after running `/hive`. Suggestion: - Add a simple end-to-end example under "Build Your First Agent" that shows: 1. Defining a goal via `/hive` 2. How the agent graph is generated 3. How worker agents execute tasks 4. How failures feed back into the adaptation loop The existing architecture diagrams are helpful conceptually, but a concrete execution walkthrough would significantly improve developer onboarding.

Created: 2/6/2026 • 2 comments

capitalize its name, a minor migration is required

Created: 2/6/2026

## Objective Reduce API surface complexity. ## Files - `packages/core/src/discovery/ephemeral-subnet.ts` ## Acceptance Criteria - [ ] Consolidate similar methods - [ ] Update callers - [ ] Tests pass ## Complexity **small** (30-60 min)

Created: 2/6/2026

## Objective Move validation logic out of Router. ## Files - `packages/core/src/routing/router.ts` ## Acceptance Criteria - [ ] Create `message-validator.ts` - [ ] Move validation functions - [ ] Update imports - [ ] All tests pass ## Complexity **medium** (1-2 hours)

Created: 2/6/2026

## Objective Add `pnpm audit` to CI. ## Files - `.github/workflows/ci.yml` ## Acceptance Criteria - [ ] `pnpm audit` runs in CI - [ ] Failures are warnings (not blocking) ## Complexity **micro** (< 30 min)

Created: 2/6/2026

## Objective Track bundle size in CI. ## Files - `.github/workflows/ci.yml` ## Acceptance Criteria - [ ] Report bundle sizes - [ ] Compare with previous build - [ ] Warn on significant increase ## Complexity **small** (30-60 min)

Created: 2/6/2026

## Objective Add coverage report to CI pipeline. ## Files - `.github/workflows/ci.yml` - `vitest.config.ts` ## Acceptance Criteria - [ ] Coverage report generated - [ ] Report uploaded as artifact - [ ] Threshold enforcement (optional) ## Complexity **small** (30-60 min)

Created: 2/6/2026

## Objective Identify untested code paths. ## Files - Run coverage report ## Acceptance Criteria - [ ] Generate coverage report - [ ] List uncovered lines - [ ] Create follow-up issues ## Complexity **small** (30-60 min) ## How to run ```bash pnpm test -- --coverage ```

Created: 2/6/2026

## Objective Ensure all public APIs are exported. ## Files - `packages/core/src/index.ts` - `packages/sdk/src/index.ts` ## Acceptance Criteria - [ ] All public classes exported - [ ] All public types exported - [ ] No internal-only exports ## Complexity **micro** (< 30 min)

Created: 2/6/2026

## Objective Security audit of signaling server. ## Files - `tools/signaling-server/src/` ## Acceptance Criteria - [ ] No sensitive data logging - [ ] Rate limiting present - [ ] Input validation complete ## Complexity **small** (30-60 min)

Created: 2/6/2026

## Objective Verify crypto follows ADR-004. ## Files - `packages/core/src/crypto/` - `_bmad-output/planning-artifacts/architecture.md` (ADR-004) ## Acceptance Criteria - [ ] Uses TweetNaCl.js - [ ] X25519 for key exchange - [ ] XSalsa20-Poly1305 for encryption ## Complexity **small** (30-60 min)

Created: 2/6/2026

## Summary Improve documentation to make SWARM more accessible to new users and researchers. ## Tasks ### Tutorials - [ ] "Your First Governance Experiment" - step-by-step walkthrough - [ ] "Understanding Soft Labels" - intuition and math - [ ] "Analyzing Results" - interpreting metrics and dashboards ### Examples - [ ] Add more example scripts in `examples/` - [ ] Jupyter notebook demonstrations - [ ] Common research questions with code ### API Documentation - [ ] Improve docstrings for public APIs - [ ] Add usage examples in docstrings - [ ] Document common patterns ### Guides - [ ] "Designing Scenarios" - best practices - [ ] "Custom Governance Levers" - advanced guide - [ ] "Transferability Considerations" - when results generalize ## How to Contribute 1. Pick a task above 2. Write content in `docs/` using Markdown 3. Preview locally: `mkdocs serve` 4. Submit a PR ## Style Guide - Use clear, concise language - Include code examples - Add diagrams where helpful (Mermaid supported) - Link to related concepts ## Resources - [MkDocs Material](https://squidfunk.github.io/mkdocs-material/) - Current docs: https://www.swarm-ai.org

Created: 2/6/2026

## Objective Ensure all errors use TomError. ## Files - All `packages/core/src/**/*.ts` ## Acceptance Criteria - [ ] No raw `throw new Error()` - [ ] Consistent error codes - [ ] Report findings in PR ## Complexity **small** (30-60 min) ## Context Search for `throw new Error` and verify all should be `throw new TomError`.

Created: 2/6/2026

Add colorized output and better formatting to the CLI. Tasks: - Add colored output for different message types (errors in red, success in green) - Improve table formatting for SELECT results - Add progress indicators for long operations - Add --json output format option - Improve help messages and examples Files to modify: nexum_cli/src/main.rs Good First Issue - Learn Rust CLI development! Estimated Time: 2-3 hours

Created: 2/6/2026

## Objective Show network stats in demo UI. ## Files - `apps/demo/src/main.ts` ## Acceptance Criteria - [ ] Active connections count - [ ] Messages sent/received - [ ] Current relay ## Complexity **small** (30-60 min)

Created: 2/6/2026

## Objective Show read receipts in chat UI. ## Files - `apps/demo/src/main.ts` - `apps/demo/index.html` ## Acceptance Criteria - [ ] Double-check icon for read messages - [ ] Single-check for delivered ## Complexity **small** (30-60 min) ## Context Read receipts are already supported in the SDK. This is about displaying them in the demo UI.

Created: 2/6/2026

## Objective Add typing indicator to chat. ## Files - `packages/sdk/src/tom-client.ts` - `apps/demo/src/main.ts` ## Acceptance Criteria - [ ] `sendTypingIndicator(peerId)` method - [ ] `onTypingIndicator` callback - [ ] Demo UI shows typing state ## Complexity **medium** (1-2 hours)

Created: 2/6/2026

## Objective Implement retry logic for failed messages. ## Files - `packages/core/src/routing/router.ts` ## Acceptance Criteria - [ ] Max 3 retries - [ ] Exponential backoff (1s, 2s, 4s) - [ ] Tests for retry scenarios ## Complexity **small** (30-60 min)

Created: 2/6/2026

## Objective Expose connection quality to SDK users. ## Files - `packages/sdk/src/tom-client.ts` ## Acceptance Criteria - [ ] `onConnectionQualityChange` callback - [ ] Quality levels: good, degraded, poor - [ ] Test coverage ## Complexity **medium** (1-2 hours)

Created: 2/6/2026