resource-diff-report

name	resource-diff-report
description	Compare two versions of resourceDefinition.json (e.g., branch vs main) and produce a structured change summary. Triggers on: PR review, audit, before/after comparison.

Resource Diff Report

Procedure

1. Get the two versions

Branch vs main:

git show origin/main:resourceDefinition.json > /tmp/rd-main.json
cp resourceDefinition.json /tmp/rd-branch.json

Or two arbitrary commits:

git show <commit1>:resourceDefinition.json > /tmp/rd-before.json
git show <commit2>:resourceDefinition.json > /tmp/rd-after.json

2. Extract resource names

grep '"name":' /tmp/rd-main.json | sed 's/.*"name": "//;s/".*//' | sort > /tmp/rd-names-main.txt
grep '"name":' /tmp/rd-branch.json | sed 's/.*"name": "//;s/".*//' | sort > /tmp/rd-names-branch.txt

3. Identify changes

# New resources (in branch but not in main)
comm -13 /tmp/rd-names-main.txt /tmp/rd-names-branch.txt > /tmp/rd-added.txt

# Removed resources (in main but not in branch)
comm -23 /tmp/rd-names-main.txt /tmp/rd-names-branch.txt > /tmp/rd-removed.txt

# Common resources (check for field changes)
comm -12 /tmp/rd-names-main.txt /tmp/rd-names-branch.txt > /tmp/rd-common.txt

4. Report

## Resource Definition Changes

### Added (<count>)
| Resource | Slug | Length | Scope |
|----------|------|--------|-------|
| <name>   | <slug> | <min>-<max> | <scope> |

### Removed (<count>)
| Resource |
|----------|
| <name>   |

### Modified (<count>)
| Resource | Field | Before | After |
|----------|-------|--------|-------|
| <name>   | <field> | <old> | <new> |

### Summary
- Total resources: <before> → <after>
- Net change: +<added> / -<removed> / ~<modified>

5. Cleanup

rm -f /tmp/rd-*.json /tmp/rd-*.txt