@elyracode/doctor

Project health analysis for Elyra -- security audit, dependency check, code quality, and more.

Install

elyra install npm:@elyracode/doctor

Commands

• /doctor -- Run all health checks and send the report to the agent for analysis
• /doctor --heal -- Run checks and auto-fix issues (the agent works through each finding step by step)

Tools

| Tool | Description | |------|-------------| | project_health_check | Run health checks. Can filter by category: security, dependencies, config, code-debt, code-quality, git, project |

Checks

| Check | What it does | |-------|-------------| | Security | Runs npm audit and composer audit for known vulnerabilities | | Dependencies | Checks for outdated npm packages | | Configuration | Compares .env with .env.example for missing keys | | Code Debt | Scans for TODO, FIXME, HACK, WORKAROUND comments | | Code Quality | Finds source files over 500 lines | | Git | Reports uncommitted changes and untracked files | | Project | Checks for essential files (.gitignore, README, configs) |

Usage

> Run a health check on this project
> Are there any security vulnerabilities?
> How many TODO comments are in the codebase?
> Check if my .env is missing any keys

The agent runs the checks automatically and suggests fixes based on findings.

Auto-Heal Mode

/doctor --heal

The agent works through each error and warning step by step:

• Security: runs npm audit fix / composer update
• Dependencies: updates outdated packages one by one
• Configuration: fills in missing .env keys
• Code debt: implements TODOs, resolves FIXMEs, cleans up HACKs
• Code quality: refactors large files into smaller modules
• Project: creates missing essential files

After each fix, the agent verifies the change didn't break anything.

Report Format

# Project Health Report

Errors: 1 | Warnings: 3 | Info: 5

## Errors
- [Security] 2 critical/high npm vulnerabilities found

## Warnings
- [Dependencies] 12 outdated npm packages
- [Code Debt] Found 8 debt markers: 5 TODO, 2 FIXME, 1 HACK
- [Code Quality] 3 files over 500 lines

## Info
- [Configuration] All .env.example keys present in .env
- [Git] Working tree clean
- [Project] All essential files present