Run Zero-Write Polyglot AST Repository X-Ray
nomos_xrayAudit a local repository with zero-write polyglot AST analysis to measure AI Hangover Score, cyclomatic/cognitive debt, and top hotspot files for codebase health baselines.
Instructions
Run a zero-write polyglot static AST structural X-Ray across a local repository directory to measure AI Hangover Score, cyclomatic/cognitive debt, and top hotspot files. Use when auditing overall codebase health, complexity hotspots, or brownfield baseline posture. Do NOT use when computing only the diff-scoped blast radius of modified files (use nomos_verify_impact instead) or looking up a single gate definition (use nomos_capabilities instead).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "nomos_xray"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dir | No | Target repository root or subdirectory path (defaults to current working directory). | . |
| top | No | Number of highest-debt hotspot files to return. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grade | No | Structural health letter grade. | |
| hangover_score | No | Composite 0-100 structural debt score. |