Troubleshooting

ONTOLY0001 Unknown command

Run:

ontoly --help

Then run command-specific help:

ontoly build --help

ONTOLY1001 trace requires a node id or node name

Find a node first:

ontoly inspect AuthService
ontoly query find AuthService

Then trace the exact id or unique name.

ONTOLY1003 Ambiguous node

Use the stable id printed in the suggestion. Ambiguity is expected when multiple classes, methods, or functions share a name across files.

No graph artifacts found

Run:

ontoly build .

Then inspect:

ontoly doctor .
ontoly coverage .

Validation fails locally

Run:

ontoly evaluate --ci
ontoly validate all --ci

Open:

validation/semantic/reports/summary.md
validation/release-gates/report.md

These reports distinguish regressions from missing local repositories.