nightshift/docs/troubleshooting.md

34 lines
1.4 KiB
Markdown

# Troubleshooting
## `command is not allowlisted`
Add the exact command to `safety.allowed_commands`. NightShift normalizes whitespace but otherwise expects exact matches.
## Command works in PowerShell but fails in NightShift
Command stages use Python subprocess execution. By default `shell: true` uses the platform shell, which is usually `cmd.exe` on Windows. Prefer Python module commands or set explicit shell commands.
## No runnable tasks
Check `nightshift status`. A task may be blocked by dependencies listed under `Dependencies:`.
## Git clean worktree failure
If `require_clean_worktree: true`, NightShift blocks dirty repositories before creating artifacts. Commit/stash changes or set it to false.
## Ollama backend fails
The `ollama` backend uses Ollama's local HTTP API, normally at `http://localhost:11434/api/generate`. Confirm Ollama is running and the configured model is available with `ollama list` or `ollama pull <model>`. Tests do not require Ollama.
## Patch validation reports hunk count mismatch
Use `file_writer` for local model runs when possible. It asks the model for complete file blocks and lets NightShift generate the unified diff. For direct `code_writer` patches, the normalizer now recomputes hunk counts before validation, but malformed hunk bodies still fail validation.
## Flask dashboard fails
Install Flask:
```bash
pip install flask
```