🗿 Vestige - Temporal Code Intelligence

Uncover the traces of your codebase through time. Certified Master Release.

Vestige brings temporal awareness directly into your code editor. See which code is ancient, which is churning, and which just changed—all without leaving your file.

Vestige 2.0 (Centurion Vision) introduces a world-class temporal intelligence engine and Zenith Elite aesthetics. Experience a premium, innovative engineering platform that reveals code age, churn, and evolution through the lens of AI.

🏛️ Core Features (The Foundation)

Essential temporal utility for every developer.

🗺️ Heatmap Explorer

Files in the Explorer are automatically color-coded based on their git history:

• 🔥 High Churn - Files that change frequently (Red indicator)
• 🗿 Fossils - Ancient, untouched code (Grey indicator)
• ✨ Recent - Fresh changes (Green indicator)

✍️ Inline Temporal Annotations

Tactile editor decorations that reveal history as you code:

• Visual Cues: Instantly see if a block of code is a "fossil" or "active churn".
• Dynamic Updates: Decorations update automatically as you commit and edit.

🕰️ Time Travel (Timeline Panel)

View the complete commit history of your file in a beautiful, lazy-loaded timeline:

• Chronological commit list with full author metadata.
• 👁️ View File at Commit: Click to see exactly what the file looked like at any point in history.
• Trend Analysis: Statistical view of commit frequency over years/months.

🔍 Smart Refactoring & Coupling

Discover hidden architectural patterns:

• Coupled Files: Identify files that frequently change together with your current file.
• Dependency Insights: Uncover hidden connections between distant modules (e.g., "🔗 Coupled with: utils.js (80% correlation)").

🛡️ Rich Status Bar & Hover

• Status Bar Metrics: Live Stability Score (0-100%) and Top Contributor ownership.
• Deep Hover: Hover over any line to see last change date, author, commit hash, and file-level churn statistics.

🌌 Zenith Elite Aesthetics (New!)

The Holographic Frontier of Engineering Tools.

• Organic Depth: Micro-noise textures and radial mesh gradients for a tactile feel.
• Kinetic Typography: Variable font weight shifts that react to editor hover.
• Glassmorphism 2.0: Premium backdrop blur with luminous, reactive borders.
• Liquid Status Bars: Fluid-dynamic animations for stability and health indicators.
• Bioluminescent UI: Pulsing organic light indicators for technical debt.

🧠 Centurion Intelligence (AI) (New!)

Powered by Historical Intent.

• AI Code Archaeologist: Hypothesizes why legacy code persists (Load-Bearing Wall, Sunken Treasure, or Zombie).
• Historical Persona: Understand the "soul" of the original author through AI-synthesized intent.
• Ghost Chat: Pair program with the "Ghost" of a developer using their historical intent.
• Predictive ROI: AI-driven stability impact analysis for proposed refactorings.
• Automatic Summaries: Single-sentence technical summaries for complex historical diffs.
• Narrative Biography: AI-generated story of a file's evolution and purpose.

📜 Lore System (New!)

Capture and preserve architectural decisions directly in your codebase.

• Lore Decisions: Document "why" decisions were made with structured metadata (author, date, context).
• Implicit Lore Extraction: Automatically extracts architectural decisions from commit messages.
• Shadow Lore Detection: Identifies undocumented tribal knowledge from code patterns.
• Lore Panel: Browse, search, and manage all architectural decisions in one place.
• Promote to Lore: Convert commit messages into permanent architectural records.
• Webhook Integration: Share Lore insights with team via Slack/Discord.

⏪ Time Machine & Rewind (New!)

Travel through your codebase's history with precision.

• Workspace Rewind: Restore your entire workspace to any previous commit.
• File Time Travel: View and compare any file at different points in history.
• Temporal Wormholes: Jump between related historical commits instantly.
• Ghost Cursor Replay: Watch code evolution with animated playback.
• Commit Snapshots: One-click access to any historical state.

💀 Code Graveyard (New!)

Honor deleted code and learn from the past.

• Deleted Files Tracker: Browse all files that have been removed from the codebase.
• Obituary Generator: AI-generated tributes for deleted code with historical context.
• Resurrection: Restore deleted files with full history intact.
• Deletion Analytics: Understand patterns in code removal over time.

🤝 Onboarding Assistant (New!)

Accelerate developer onboarding with AI-powered file history tours.

• AI Narratives: Friendly 2-3 sentence summaries of file history, perfect for new team members.
• 8 Milestone Types: Automatically detects Birth, Refactors, Bug Clusters, Ownership Transitions, Architecture Decisions, Epochs, Dependencies, and Security Fixes.
• Expert Recommendations: Shows top 3 contributors with ownership percentages and roles (Primary Maintainer, Core Contributor).
• Related Files: Displays coupled files that frequently change together with coupling scores.
• Interactive Tour: Step-by-step modal walkthrough of key milestones with progress tracking and importance badges.
• Quick Facts: Visual cards showing file age, total changes, contributors, and lines of code.
• Zero Configuration: Automatically generates for every file analysis, with fallback narratives when AI is unavailable.

📊 Immersive Visualizations

• Gravity Well (3D): A physics-based simulation of file complexity and "gravitational" debt.
• Pulse Panel: Animated architectural pulse showing repository activity as a heartbeat.
• Evolution Replay: Watch your code evolve over time with animated playback.
• Sankey Flow: Visualize the movement of code between modules over time.
• Blast Radius Analyzer: Calculate the "impact tremor" of a file's complexity.
• Sunburst Ownership: Hierarchical treemap revealing the "Kings" of the codebase.
• Archaeology Skill Trees: Progress through discovery to unlock advanced features.
• Performance Timeline: Track build times and performance metrics over history.
• Code Flow Visualization: See how code moves through your architecture.

🎮 Gamification & Achievements (New!)

Make code archaeology fun and rewarding.

• Achievement System: Unlock badges like "Fossil Hunter", "Time Traveler", "Debt Destroyer".
• XP & Credits: Earn Code Archaeology Credits for exploring and improving code.
• Leaderboards: Compete with teammates on code quality metrics.
• Skill Tree: Unlock advanced features by completing challenges.
• Temporal Unlocking: Advanced features unlock as you explore more history.

🛡️ Enterprise Strategy

• Handoff Assistant: Identifies modules at risk of knowledge loss.
• Mentorship Matcher: Recommends historical experts for any file.
• Debt Horizon Forecasting: Predicts technical debt growth over 180 days.
• Multi-Repo Dashboard: Aggregate metrics across all workspace folders.
• Bus Factor Analysis: Identify single points of failure in code ownership.
• Documentation Drift Detection: Alerts when docs fall out of sync with code.
• Hot Potato Detection: Find files with excessive author turnover.
• Zombie Code Finder: Identify stagnant code that hasn't changed in 365+ days.
• Webhook Integration: JIRA ticket creation and Slack/Discord Lore sharing.

🚀 Installation & Setup

VS Code

1. Search "Vestige" in the Marketplace.
2. Click Install.
3. (Optional) Set vestige.openaiApiKey for AI features.

IntelliJ

1. Open Settings > Plugins.
2. Install Vestige from Disk or Marketplace.
3. Access the Vestige Sidebar for full temporal dashboards.

⚙️ Configuration

{
  "vestige.enabled": true,
  "vestige.churnThreshold": 10,
  "vestige.fossilThreshold": 365,
  "vestige.openaiApiKey": "sk-...",
  "vestige.collabWebhookUrl": "https://hooks.slack.com/..."
}

📝 License

MIT License - see LICENSE.md

Built with ❤️ for developers who care about code history 🗿 Vestige - Because every line has a story