Interject/nightshift
1
0
Fork 0
mirror of https://github.com/khodges42/nightShift.git synced 2026-06-14 10:08:37 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
fa97abf0c3
nightshift/docs/config-reference.md
K. Hodges fa97abf0c3 Implemented deterministic diff generation via a new file_writer stage. 
What changed:

  - Added file_writer stage support in nightshift/config.py:93, nightshift/agents.py:446, and nightshift/pipeline.py:374.
  - Added file-block parsing and deterministic patch generation in nightshift/patches.py:65.
  - file_writer agents now return complete file blocks:

    ```file:relative/path.py
    <complete file content>
    ```
    NightShift reads current files and generates the unified diff itself.

  - Existing patch_validator, patch_normalizer, and patch_apply still run after that.
  - Switched tiny-lisp-nightshift/nightshift.yaml:51 to type: file_writer.
  - Updated tiny-lisp-nightshift/agents/implementer.md:1 to request file blocks instead of diffs.
  - Updated README, tutorial, config reference, and design doc.

  Also added tests for parsing file blocks, generating multi-file diffs, validating those diffs, and running a full file_writer -> normalize -> validate pipeline.

  Verification: python -m unittest discover -v passes, 101 tests.
2026-05-17 15:24:10 -07:00

2.3 KiB
Raw Blame History

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: calls the local Ollama HTTP API at http://localhost:11434/api/generate by default.
  • openai_compatible: calls a Chat Completions-compatible HTTP API.

Command agent:

planner:
  backend: command
  command: echo
  system_prompt: agents/planner.md

Ollama agent:

planner:
  backend: ollama
  model: qwen2.5-coder:14b
  base_url: http://localhost:11434
  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.

Patch validator stage options:

  • max_files: max files changed.
  • max_lines: max changed lines.
  • forbidden_paths: paths the patch must not touch.
  • Unified diff hunk line prefixes and hunk line counts are validated before patch apply.

Writer stages:

  • code_writer: agent returns a unified diff directly.
  • file_writer: agent returns complete file content blocks; NightShift generates the unified diff deterministically.

file_writer blocks use this form:

```file:relative/path.py
<complete file content>
```