ns-debug

What problem does it solve?

Helps developers and integrators quickly diagnose and resolve NeuroScript parse errors, semantic validation failures, shape mismatches, cycle detection, and compilation problems so .ns files can be validated and compiled reliably.

Core Features & Use Cases

• Error classification and remedies: Maps each validation error (MissingNeuron, PortMismatch, CycleDetected, ArityMismatch, UnknownNode, NonExhaustiveMatch, UnreachableMatchArm, DuplicateBinding, InvalidRecursion, Custom) to probable causes and concrete fixes.
• Step-by-step CLI workflow: Guides users through Parse → Validate → Compile with verbose CLI invocations, targeted compile of a specific neuron, and strategies for reproducing and isolating failures.
• Shape and recursion debugging: Explains shape inference, variadic matching, expression solving limits, and recommended fixes for recursive bindings and intentional recursion with @lazy.
• Use case: Diagnose why a transformer.ns fails validation due to a dimension mismatch, identify the offending connection, and produce the minimal parameter or structural change to fix it.

Quick Start

Validate the NeuroScript file at path/to/file.ns with verbose output and return a prioritized list of errors with suggested fixes and the exact neuroscript CLI commands to reproduce each issue.