Mendelevium (Atomic #101)

Mendelevium is an interactive, standalone dependency mapping and codebase visualizer. Named after Dmitri Mendeleev, it acts as the "Periodic Table" for your projects, analyzing file relationships, relative sizes, and dependency patterns in real-time.

Features

• Terminal TUI Interface: A full-screen interactive Text User Interface (TUI) styled like the Antigravity CLI (agy). Navigate your source files, inspect their size, check their atomic number (size rank), and trace imports directly in the terminal.
• Interactive HTML Visualization: Compiles a physics-enabled, draggable node network graph (mendelevium-report.html) using Vis.js.
• Slash Commands: Interact dynamically using terminal-based slash commands (/scan, /filter, /open, /exit).
• Zero Dependencies: Implemented in pure, modern Node.js using native standard libraries.

Installation

Ensure you are in the package folder, then install/link it:

npm link

TUI Keyboard Shortcuts

When running in interactive TUI mode:

• Up / Down Arrow Keys: Navigate the list of elements (files).
• Enter: Compile and open the interactive HTML visualization in your default browser.
• /: Enter Command Mode (to type slash commands).
• ESC: Cancel command input, clear active filters, or go back.
• q or Ctrl+C: Exit the TUI session.

TUI Slash Commands

Type / in the TUI to enter commands:

• /scan [directory] — Rescans the target codebase directory (defaults to current directory).
• /filter [query] — Filters the element list to files matching query.
• /open — Compiles and opens the HTML visualization.
• /exit — Exits Mendelevium.

CLI Options (Static Output)

You can also bypass the TUI to output static data directly to your stdout:

# Print a clean, formatted ASCII dependency tree
mendelevium . --text

# Output raw JSON representation of the graph
mendelevium . --json

Thematic Classifications (Element Groups)

Mendelevium classifies your project files into specific groups on the periodic table:

• 🔴 Halogens (Group 17) [F, Cl, Br...]: Layout and style files (.css). Highly reactive.
• 🟢 Noble Gases (Group 18) [He, Ne, Ar...]: Layout structures (.html). Highly stable.
• 🟣 Lanthanides [La, Ce, Pr...]: Test specs and verification files.
• 🟡 Alkali Metals (Group 1) [Li, Na, K...]: Configs, build files, and CLI entry points.
• 🔵 Transition Metals [Fe, Co, Ni...]: Standard JavaScript/TypeScript modules containing logic.