---
name: Bug report
about: Report a defect in eeco
title: ""
labels: bug
assignees: ""
---

### Environment

- `eeco version` output:
- OS and architecture:
- Workspace state (output of `eeco doctor`, fenced):

### What happened

A clear description of the observed behaviour.

### What was expected

A clear description of the expected behaviour.

### Reproduction

Numbered steps starting from a fresh state (for example a scratch
`git init`):

1.
2.
3.

### Exit code

The exit code returned by the failing command, plus the exit-code
contract value it should have been (`0` clean, `1` finding/failure,
`2` blocked, `3` AI pass deferred).

### Logs and output

Paste relevant terminal output in a fenced block. Redact tokens,
file paths, and any project-private content.

### Additional context

Anything else that helps localise the defect (recent change to
`config.local`, a workspace with a non-default `automation` level,
a non-standard hook setup, etc.).