# Parity Report Format

All parity check agents return results in this JSON structure.

## Schema

```json
{
  "check_type": "<one of: business-flow-story-parity, actor-flow-parity, story-screen-parity, story-resolver-parity, orphan-detection>",
  "app": "<app-name>",
  "gaps": [
    {
      "source": "<source doc path>",
      "target": "<target doc path or 'missing'>",
      "check": "<check_id from the agent's parity checks table>",
      "status": "pass | fail | skip",
      "detail": "<human-readable description of the finding>"
    }
  ],
  "inconsistencies": [
    {
      "type": "<inconsistency type, e.g. link_mismatch>",
      "location": "<source vs target description>",
      "detail": "<human-readable description>"
    }
  ],
  "summary": {
    "total_checks": 0,
    "passed": 0,
    "failed": 0,
    "skipped": 0
  }
}
```

## Field Reference

### gaps[]

One entry per parity check performed. `status` is:

- `pass`: source and target are consistent
- `fail`: gap or mismatch found
- `skip`: target docs missing or empty, check could not run

### inconsistencies[]

Cross-cutting issues found during the check that don't fit a single gap entry (e.g., link format violations, naming mismatches across multiple docs).

### summary

Aggregate counts. `total_checks = passed + failed + skipped`.