v1.1.25 — AI Code Review, Project Health Reports, Refactoring Suggestions & Autonomous Worker Agents

What's New Since v1.1.6

This is a major feature release spanning several development cycles. LUNA has evolved from a codebase summarization tool into a full AI-powered code intelligence platform.

🔥 Headline Features

AI Code Review (LUNA: Review Changes in This File)

• Right-click any file or use Command Palette to review git changes
• Detects issues across 5 focus areas: bugs, performance, security, style, side effects
• Auto-computes git diff (unstaged → staged → HEAD~1)
• Uses your configured LUNA model (gpt-4o FREE by default) — zero premium requests
• Also available as #review_file_changes MCP tool for agent-to-agent workflows
• Results open in a temporary markdown tab — nothing saved to disk

Project Health Report (LUNA: Project Health Report)

• One-command comprehensive project assessment
• Reads all existing analysis data (complexity heatmap, dead code, dependency graph, component map, QA report)
• AI generates: health score (1-10), critical issues, technical debt summary, architecture assessment, and prioritized recommendations
• Auto-detects circular dependencies from the dependency graph
• Uses FREE model — no premium requests

Suggest Refactorings (LUNA: Suggest Refactorings)

• Right-click a file or use Command Palette
• With no file selected: auto-finds your highest-complexity files (7+/10) and lets you pick
• AI reads the actual source code and provides concrete refactoring plans
• Includes: specific functions to change, quick wins vs structural changes, estimated complexity reduction
• Uses FREE model

🤖 Autonomous Worker Agent System (Production-Ready)

• Fully autonomous background AI agents with complete VS Code tool access
• Multi-turn tool loop — workers make 20+ sequential decisions and adapt
• Smart file creation with JSON-based output and auto escape handling
• Parallel task delegation — spawn multiple workers simultaneously
• 3 new MCP tools: #spawn_worker_agent, #check_worker_status, #wait_for_workers
• Extension HTTP bridge for secure localhost communication between MCP server and extension
• All workers use FREE models (gpt-4o default)

🔧 Infrastructure & Bug Fixes

• Include/Exclude Pattern Fixes — Fixed critical bugs where .lunasummarize exclude patterns were completely ignored
• Component Map Intelligence — Detects C# project boundaries (.csproj files) for accurate architectural grouping
• API Routes Metadata — Fixed bug where API route directories were excluded from summaries instead of being flagged for extraction
• YAML Parser Improvements — More robust .lunasummarize configuration handling
• Better Architecture Detection — Recognizes dotted namespace patterns and project boundaries
• MCP Server — 16 tools total (up from ~12), LRU caching for instant queries

📊 Stats

• 16 MCP tools for Copilot Agent Mode
• 3 new user commands (Review, Health Report, Refactorings)
• All AI analysis uses FREE models — configurable in Settings > LUNA > Copilot Model
• Zero files created for analysis results — untitled tabs that close clean

Full Changelog

v1.1.6...v1.1.25

v1.1.6 - MCP Server Stability Fix

v1.1.6 - MCP Server Stability Fix

🐛 Bug Fixes

Critical: Fixed MCP Server Tools Not Working

• Restored working Server implementation pattern from @modelcontextprotocol/sdk
• Fixed API incompatibility caused by migration to McpServer/registerTool which broke all MCP tools
• All 12 MCP tools now function correctly

✅ Verified Working Tools

Tool	Function
list_summaries	List all cached summaries
get_file_summary	Get summary for specific file
search_summaries	Search across summaries
analyze_file	Generate/update file summary
get_dependency_graph	View file relationships
get_complexity_heatmap	Refactoring priority scores
get_dead_code	Unused exports detection
get_component_map	Architecture grouping
get_qa_report	Quality validation results
get_api_reference	API endpoints documentation
search_endpoints	Search API endpoints
list_stale_summaries	Git-aware freshness check

🔧 Technical Details

• Reverted MCP server entry point to use Server class with setRequestHandler(CallToolRequestSchema, ...) pattern
• Updated meta-analysis handlers to use summaryManager methods instead of inline require('fs')
• No breaking changes to tool schemas or output formats

📦 Installation

Update via VS Code Extensions panel or download VSIX from releases.

v1.1.3 - Removed Redundant Git Hook (Auto-Detection Works for All Commits)

[1.1.3] - 2025-12-30

Removed

• Git Post-Commit Hook Command: Removed LUNA: Install Git Post-Commit Hook command
  • Universal Git Commit Watcher now covers all commit sources (terminal, GitHub extension, VS Code UI, etc.)
  • Hook installation is no longer necessary
  • Cleaner, simpler user experience

Changed

• Documentation updated to reflect universal watcher as the primary commit detection method
• Removed GitHookManager dependency from extension core

[1.1.2] - 2025-12-30

Added

• Universal Git Commit Watcher: Detects commits from ANY source
  • Terminal commits
  • GitHub VSCode extension
  • VS Code Source Control UI
  • Git GUI clients
  • Any other git tool
• Auto-detects stale summaries after any commit type

v1.1.2 - Universal Git Commit Watcher 🔔

LUNA v1.1.2 - Universal Git Commit Watcher 🔔

Now detects commits from ANY source - terminal, GitHub extension, VS Code UI, or any git tool!

🆕 What's New

Universal Git Commit Watcher

LUNA now watches for git commits from any source and automatically prompts you to update stale summaries.

How it works:

• Watches .git/refs/ directory for changes
• Detects commits from terminal, GitHub extension, VS Code UI, git GUI, etc.
• Shows notification: "📝 X summaries may be outdated"
• Click to update or dismiss

Benefits:

• ✅ No more missed reminders about stale summaries
• ✅ Works with any git workflow
• ✅ Automatic detection (no manual git hooks needed)
• ✅ Smart detection (only notifies when truly stale)

🐛 Bug Fixes

MCP Server Auto-Update

• Extension now automatically updates MCP server path when upgrading versions
• Fixes issue where MCP server pointed to old version after extension update
• Silent updates on version changes (no notification spam)

📊 Technical Details

New Files:

• src/gitCommitWatcher.ts - Universal git change detector

Modified Files:

• src/extension.ts - Integrated commit watcher into activation/deactivation

How it detects commits:

.git/HEAD changes → Watcher fires → Checks for stale summaries → Notifies user

No manual git hook configuration needed! It just works.

🎯 What Users Experience

Before:

User commits via GitHub extension
(LUNA doesn't notice - no reminder)

After:

User commits via GitHub extension
→ Watcher detects commit
→ LUNA shows: "📝 Summaries may be outdated"
→ Click to update

📥 Installation

Download luna-codebase-encyclopedia-1.1.2.vsix and install via:

Extensions → ⋯ (More Actions) → Install from VSIX

Or update from VS Code Marketplace if already installed.

🔄 Version History

• 1.1.2 - Universal git commit watcher (this release)
• 1.1.1 - MCP server auto-update fix
• 1.1.0 - Code Breakdown Generator + Quality Assurance
• 1.0.8 - Initial MCP integration

---

Enjoy LUNA v1.1.2! 🌙

Now your summaries stay up-to-date regardless of how you commit.

v1.1.0 - Code Breakdown Generator + Quality Assurance 🎉

LUNA v1.1.0 - Code Breakdown Generator + Quality Assurance 🎉

We're excited to announce LUNA v1.1.0, featuring two revolutionary capabilities that transform how you interact with your codebase!

🆕 Major New Features

📚 Code Breakdown Generator

Learn your code like never before! Generate educational, line-by-line explanations of any file.

How to use:

• Right-click any file → "LUNA: Explain This Code"
• Choose your expertise level:
  • Beginner 📚: Full explanations with analogies, examples, and common mistakes
  • Intermediate 📖: Balanced detail with patterns and gotchas (default)
  • Expert ⚡: Quick architecture overview and tricky bits only

What you get:

• Complete breakdown saved as filename.breakdown.md
• Table of contents for easy navigation
• Code snippets with detailed annotations
• Real-world analogies and examples
• Common pitfalls and best practices

Perfect for:

• Onboarding new team members
• Learning unfamiliar codebases
• Understanding complex legacy code
• Teaching programming concepts

✅ Quality Assurance Validator

AI-powered accuracy verification! After fast deterministic analysis, Copilot reviews the results to catch errors.

What gets verified:

• ✅ Dead code detection (significantly reduces false positives)
• ✅ Complexity scores (validates against actual code patterns)
• ✅ Component categorization (ensures logical groupings)
• ✅ Framework-aware analysis (ComfyUI, Django, FastAPI, etc.)

Results: See .codebase/QA_REPORT.json for detailed validation

Configure: Settings → Extensions → LUNA → "Enable Copilot QA" (enabled by default)

🔧 Improvements & Fixes

Python Support

• Fixed relative import resolution (from .module now works correctly)
• Better handling of Python-specific patterns
• Framework-aware dead code detection (no more false flags on decorators!)

Accuracy & Reliability

• Conservative line numbers (only reported when highly confident)
• Enhanced function call tracking
• Type-safe dependency handling
• Smart component grouping based on actual project structure

Documentation

• Complete README overhaul with new features
• Updated quick start guide
• Added comprehensive changelog
• Better AI agent instructions

📦 Installation

From VS Code Marketplace:

1. Search for "LUNA Codebase Encyclopedia"
2. Click Install
3. Reload VS Code

Manual Installation:
Download luna-codebase-encyclopedia-1.1.0.vsix and install via:

Extensions → ⋯ (More Actions) → Install from VSIX

🚀 Getting Started

For AI-Powered Navigation:

Command Palette → "LUNA: Generate Codebase Summaries"
Then use Copilot Agent Mode to query your code instantly!

For Learning & Onboarding:

Right-click any file → "LUNA: Explain This Code"
Adjust verbosity in Settings to match your experience level

📊 What's Changed

Full Changelog: See CHANGELOG.md

Breaking Changes: None! All new features are backward-compatible.

Settings Added:

• breakdownVerbosity - Control detail level of code explanations
• enableCopilotQA - Toggle AI quality assurance reviews (default: on)
• maxFileSize - Skip files larger than specified KB

💡 Pro Tips

1. Set your verbosity level in Settings based on your experience:

   • New to the language? → Beginner
   • New to the project? → Intermediate
   • Quick onboarding? → Expert

2. Trust the QA reports - They catch framework-specific patterns that static analysis misses

3. Use breakdowns for code reviews - Great way to understand what teammates wrote!

4. Combine features - Use summaries for navigation, breakdowns for deep understanding

🙏 Feedback & Support

• 🐛 Report issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• ⭐ Star the repo if you find LUNA useful!

📝 Credits

Special thanks to the community for feedback and feature requests that shaped this release!

---

Enjoy LUNA v1.1.0! 🌙

Generated with ❤️ by the LUNA development team