/audit

description: Log and label agent interactions (append-only JSONL)
argument-hint: "record|label"

Append-only audit logging for agent interactions (prompts, responses, tool calls) in `.beads/interactions.jsonl`.

Each line is one event. Labeling is done by appending a new `"label"` event referencing a previous entry.

Usage

• **Record an interaction**:
• `bd audit record --kind llm_call --model "claude-3-5-haiku" --prompt "..." --response "..."`
• `bd audit record --kind tool_call --tool-name "go test" --exit-code 1 --error "..." --issue-id bd-42`

• **Pipe JSON via stdin**:
• `cat event.json | bd audit record`

• **Label an entry**:
• `bd audit label int-a1b2 --label good --reason "Worked perfectly"`
• `bd audit label int-a1b2 --label bad --reason "Hallucinated a file path"`

Notes

• Audit entries are **append-only** (no in-place edits).
• `bd dolt push` includes `.beads/interactions.jsonl` in the commit allowlist.