# summary

Add a setup-agents evidence record.

# description

Appends a JSON Lines evidence entry to `.setup-agents/state/evidence.jsonl`.

Evidence records capture validation artifacts such as commands, files, screenshots, traces, reports, or notes.

ID format: `setup-agents-evidence-<unix_ms>-<6_random_alnum>` (auto-generated).

# flags.summary.summary

Short evidence summary.

# flags.summary.description

Describe the evidence in one concise sentence.

# flags.task.summary

Task or issue id for this evidence.

# flags.task.description

Associate the evidence with a task id such as `SA-96` or `#96`.

# flags.role.summary

Owning role for this evidence.

# flags.role.description

Record the current role or agent owner responsible for the evidence.

# flags.profile.summary

Owning setup-agents profile.

# flags.profile.description

Record the setup-agents profile responsible for the evidence.

# flags.type.summary

Evidence type.

# flags.type.description

Classify the evidence as command, file, screenshot, trace, report, validation, lesson, or other.

# flags.kind.summary

Evidence kind.

# flags.kind.description

Alias for `--type`.

# flags.source.summary

Evidence source reference.

# flags.source.description

Reference a command, file path, URL, report path, trace id, or other source for the evidence.

# flags.command.summary

Command that produced this evidence.

# flags.command.description

Record the command string used to produce command evidence.

# flags.path.summary

Evidence path.

# flags.path.description

Record a file, report, screenshot, or trace path.

# flags.exit-code.summary

Command exit code.

# flags.exit-code.description

Record the exit code for command evidence.

# flags.details.summary

Additional evidence details.

# flags.details.description

Add optional supporting details that should be stored with the evidence record.

# examples

- Add command evidence for a task:

  <%= config.bin %> <%= command.id %> --task SA-96 --profile developer --type command --source "npm run build" --summary "Build passed"

# flags.minutes.summary

Measured human-effort minutes (for `manual` / `review` evidence).

# flags.minutes.description

Minutes a human spent on this work. Use with `--type manual` (hands-on platform execution: Setup config not possible via metadata/tooling API, MIAW, data fixes) or `--type review` (gate approvals, architecture corrections, direction). The effort insights sum these as real human effort (GH-445).

# info.created

Evidence recorded: %s (%s)