> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuro-tech.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Test and debug a package

> Find build, installation, and startup failures

## Test before installation

```powershell theme={null}
dotnet build --configuration Release
dotnet test --configuration Release
```

Keep parsing, validation, policy, and state-transition logic independent of the Neuron where possible.

## Smoke-test the package

1. Install it in a disposable Neuron.
2. Restart when it contains assemblies.
3. Confirm each module starts.
4. Call one public endpoint or open one content page.
5. Stop the Neuron and confirm the module releases timers, ports, and files.

## If the module is not loaded

* Confirm the DLL is listed in the manifest.
* Confirm the installed DLL is in the Neuron application folder.
* Check that its target framework and dependency versions match the Neuron.
* Search startup exceptions for missing assemblies or type-load errors.
* Confirm the module is concrete and implements IModule.

## If an endpoint is missing

* Check that registration happens from Start.
* Check for duplicate paths.
* Confirm Start completed without an exception.
* Inspect the Neuron route list or discovery output before debugging request logic.

## If an upgrade fails

Restore the previous tested package or backup before making additional changes. Keep the first exception and exact package version; repeated restart attempts often hide the original failure.