Changelog

Version History

Mega Brain uses Semantic Versioning: MAJOR.MINOR.PATCH

MAJOR: Breaking changes
MINOR: New features (backward compatible)
PATCH: Bug fixes and improvements

[1.3.0] - Current Release

Latest Version

Status: StableRelease Date: March 2026Highlights: Production-ready release with enhanced stability, documentation, and developer experience.

Features

Core System:

AI-powered knowledge management system
Transform expert materials into structured playbooks and DNA schemas
5-layer DNA extraction (Philosophies, Mental Models, Heuristics, Frameworks, Methodologies)
Full source traceability for all extracted knowledge

Pipeline Processing:

5-phase pipeline (Chunking, Resolution, Extraction, Synthesis, Compilation)
Support for videos, PDFs, transcriptions, podcasts, training courses
Batch processing capabilities
Automated quality validation

AI Agents:

Mind clone framework for expert replication
Cargo agent system (29 functional role agents)
Conclave multi-agent deliberation
JARVIS orchestrator system

Developer Experience:

20+ hooks for automation and validation
Skill system with keyword-based auto-routing
Slash commands for common operations
Session persistence with auto-save and resume
Interactive setup wizard

CLI Tools:

npx mega-brain-ai setup - Environment setup wizard
Layer validation tools
Pre-publish security gates
Package validation utilities

Commands Available

Command	Description
`/jarvis-briefing`	System status and health score
`/jarvis-full`	Full pipeline (ingest + process + enrich)
`/process-jarvis`	Run 5-phase processing pipeline
`/conclave`	Multi-agent deliberation session
`/ingest`	Ingest new material
`/save`	Save current session
`/resume`	Resume previous session
`/setup`	Environment setup wizard

Architecture

Layer Distribution:

L1 (Community): Core engine, templates, hooks, skills, CLI
L2 (Pro): Populated knowledge base, mind clones, pipeline
L3 (Personal): User materials, sessions, environment config

Directory Structure:

mega-brain/
├── core/           -> Processing engine
├── agents/         -> AI agent definitions
├── .claude/        -> Claude Code integration
├── bin/            -> CLI tools
├── knowledge/      -> Knowledge base
├── artifacts/      -> Pipeline stages
├── inbox/          -> Raw materials
├── docs/           -> Documentation
└── logs/           -> Session logs

Prerequisites

Requirement	Version	Purpose
Claude Code	Max or Pro plan	Core runtime
Node.js	>= 18.0.0	CLI and tooling
Python	>= 3.10	Intelligence scripts

API Keys

Key	Purpose	Required
`OPENAI_API_KEY`	Whisper transcription	Yes
`VOYAGE_API_KEY`	Semantic embeddings	Recommended
`GOOGLE_CLIENT_ID`	Google Drive import	Optional

Package Contents

Included in npm package:

Core processing engine
Task system with HO-TP-001 anatomy
Workflow orchestration (YAML)
Intelligence scripts (Python)
Protocol definitions
JSON schemas
Agent templates
Hook system
Skill framework
CLI tools
Documentation

Dependencies:

{
  "chalk": "^5.3.0",
  "inquirer": "^9.2.0",
  "ora": "^7.0.0",
  "boxen": "^7.1.0",
  "gradient-string": "^2.0.2"
}

Known Issues

Windows Path Handling

Some scripts may have issues with Windows backslash paths. Use forward slashes or pathlib.Path for cross-platform compatibility.

Large File Processing

Files over 2GB may need to be split for optimal processing due to API limits.

[1.0.0] - Initial Release

Foundation Release

Release Date: February 2026Highlights: First production release with core architecture and task system.

Added

Task System:

Task template (HO-TP-001 anatomy)
TASK-REGISTRY.md with categories and dependency graph
Foundation tasks (detect-role, normalize-entities)
Intelligence tasks (analyze-themes, detect-business-model, score-viability)
Extraction tasks (extract-dna, extract-knowledge, generate-skill)
Pipeline tasks (process-batch, trigger-agent, trigger-dossier)
Validation tasks (validate-cascade, verify-completeness)

Structure:

core/tasks/
├── _templates/
│   └── task-tmpl.md
├── TASK-REGISTRY.md
├── CHANGELOG.md
├── detect-role.md
├── normalize-entities.md
├── analyze-themes.md
├── extract-dna.md
├── process-batch.md
└── validate-cascade.md

Conventions

Version Format:

MAJOR: Breaking changes in task anatomy
MINOR: New tasks added
PATCH: Fixes in existing tasks

Change Types:

Added: New task created
Changed: Task modified (inputs/outputs/logic)
Deprecated: Task marked for removal
Removed: Task removed
Fixed: Bug fix in task
Security: Vulnerability corrected

Upgrade Guide

Upgrading from 1.x to 1.3.0

Breaking Changes: NoneSteps:

Update package:
```
npm update mega-brain-ai
```
Review new features in this changelog
Restart Claude Code to load new hooks and skills
Run system check:
```
/jarvis-briefing
```

Data Migration: Not required - all personal data (L3) remains compatible

Upgrading from Community to Pro

No breaking changes:

All L3 (Personal) data preserved
.env configuration carries over
Custom hooks and skills remain functional

What you get:

Pre-built mind clones (5 experts)
Cargo agents (29 roles)
Populated knowledge base
Full pipeline capabilities
Enhanced Conclave

Steps:

Contact @thiagofinch for Pro access
Follow upgrade instructions provided
No data migration needed

Community customizations remain intact and work alongside Pro features.

Release Notes Format

Each release includes:

What's New

New features and capabilities
New commands or tools
Architecture improvements

Improvements

Performance enhancements
Developer experience updates
Documentation additions

Bug Fixes

Resolved issues
Stability improvements
Edge case handling

Breaking Changes

API changes
Migration requirements
Deprecated features

Roadmap

Upcoming Features

In Development:

Enhanced RAG capabilities
Additional pre-built mind clones
Real-time collaboration features
Advanced search and filtering
Performance optimizations

Under Consideration:

Web interface for non-CLI users
Mobile companion app
Team collaboration features
Cloud sync options
API for third-party integrations

Roadmap is subject to change based on community feedback and priorities.

How to Request Features

Feature Request Process:

Check existing GitHub issues for similar requests
Open new issue with:
- Clear use case description
- Problem you’re trying to solve
- Proposed solution (optional)
- Examples or mockups (if applicable)
Engage with community discussion
Maintainer will review and prioritize

Priority Factors:

User impact and demand
Alignment with project vision
Implementation complexity
Available resources

Security Updates

Security Policy:

Security issues are addressed with highest priority
Patches released as soon as possible
Users notified via GitHub security advisories
Severity levels: Critical, High, Medium, Low

Reporting Security Issues

If you discover a security vulnerability:

Do NOT open a public issue
Contact @thiagofinch directly
Provide:
- Description of vulnerability
- Steps to reproduce
- Potential impact
- Suggested fix (if any)
Allow time for patch development
Coordinate disclosure timing

Contributing to Releases

Release Process

Maintained by: @thiagofinch (exclusive)Process:

Feature development on branches
PR review and approval
Merge to main
Version bump (semantic versioning)
Update changelog

Run validation:

npm run validate:layers
node bin/pre-publish-gate.js

Publish to npm
Create GitHub release
Announce to community

Only the maintainer can publish official releases.

Version Support

Version	Status	Support	End of Life
1.3.x	Current	✅ Full support	-
1.0.x	Maintenance	⚠️ Security only	Q4 2026
< 1.0	Deprecated	❌ No support	Ended

Always use the latest stable version for best performance and security.

Changelog Policy

This changelog follows Keep a Changelog principles:

Changes are grouped by type (Added, Changed, Deprecated, Removed, Fixed, Security)
Versions use semantic versioning
Release dates are included
Breaking changes are clearly marked
Migration guides provided when needed

Stay Updated

Subscribe to updates:

Watch the GitHub repository
Star for notifications
Follow @thiagofinch
Check this changelog regularly

Resources

Version History

[1.3.0] - Current Release

Latest Version

Features

Commands Available

Architecture

Prerequisites

API Keys

Package Contents

Known Issues

[1.0.0] - Initial Release

Foundation Release

Added

Conventions

Upgrade Guide

Release Notes Format

What's New

Improvements

Bug Fixes

Breaking Changes

Roadmap

Security Updates

Reporting Security Issues

Contributing to Releases

Version Support

Changelog Policy

Stay Updated

Build docs developers (and LLMs) love

Resources

​Version History

​[1.3.0] - Current Release

Latest Version

​Features

​Commands Available

​Architecture

​Prerequisites

​API Keys

​Package Contents

​Known Issues

​[1.0.0] - Initial Release

Foundation Release

​Added

​Conventions

​Upgrade Guide

​Release Notes Format

What's New

Improvements

Bug Fixes

Breaking Changes

​Roadmap

​Security Updates

​Reporting Security Issues

​Contributing to Releases

​Version Support

​Changelog Policy

Stay Updated

Build docs developers (and LLMs) love

Version History

[1.3.0] - Current Release

Features

Commands Available

Architecture

Prerequisites

API Keys

Package Contents

Known Issues

[1.0.0] - Initial Release

Added

Conventions

Upgrade Guide

Release Notes Format

Roadmap

Security Updates

Reporting Security Issues

Contributing to Releases

Version Support

Changelog Policy