mirror of
https://github.com/khodges42/nightShift.git
synced 2026-06-14 18:18:36 +00:00
62 lines
1.6 KiB
Markdown
62 lines
1.6 KiB
Markdown
# NightShift Config Reference
|
|
|
|
NightShift config is YAML.
|
|
|
|
## `project`
|
|
|
|
- `name`: project display name.
|
|
- `root`: project root, resolved relative to the config file.
|
|
- `task_file`: markdown task file inside the project root.
|
|
- `artifact_dir`: artifact directory inside the project root.
|
|
|
|
## `safety`
|
|
|
|
- `require_clean_worktree`: when true, block runs if `git status --short` is dirty or unavailable.
|
|
- `scoped_paths`: paths that must resolve inside the project root.
|
|
- `allowed_commands`: exact command-stage allowlist entries after whitespace normalization.
|
|
- `forbidden_commands`: dangerous fragments blocked before allowlist acceptance.
|
|
- `allowed_env`: optional environment variable names to pass to command stages.
|
|
|
|
## `experiment`
|
|
|
|
- `label`: optional run experiment label.
|
|
- `prompt_variant`: optional prompt variant label.
|
|
|
|
## `agents`
|
|
|
|
Supported backends:
|
|
|
|
- `command`: runs a local command with the prompt on stdin.
|
|
- `ollama`: runs `ollama run <model>` with the prompt on stdin.
|
|
|
|
Command agent:
|
|
|
|
```yaml
|
|
planner:
|
|
backend: command
|
|
command: echo
|
|
system_prompt: agents/planner.md
|
|
```
|
|
|
|
Ollama agent:
|
|
|
|
```yaml
|
|
planner:
|
|
backend: ollama
|
|
model: qwen2.5-coder:14b
|
|
system_prompt: agents/planner.md
|
|
```
|
|
|
|
## `pipeline`
|
|
|
|
- `max_task_retries`: task retry limit.
|
|
- `continue_on_task_failure`: for `run --all`, continue after failed/blocked tasks.
|
|
- `stages`: ordered state-machine stages.
|
|
|
|
Command stage options:
|
|
|
|
- `commands`: command strings.
|
|
- `shell`: defaults to true. Set false for argv-style execution.
|
|
- `timeout_seconds`: per-stage timeout override.
|
|
- `working_dir`: command working directory inside project root.
|