Fix: Add resource-specific XML examples for each endpoint

[dfcoffin]

Summary

Fixes the issue where all endpoints displayed the same generic XML examples (UsagePoint/IntervalBlock) regardless of the actual resource type being accessed.

Changes

New Resource-Specific Response Files (18 files)

Created dedicated response files for each resource type:

New Examples (previously had none):

• ✅ ApplicationInformation - OAuth client registration with clientId, clientSecret, redirectUri, scope, grant types
• ✅ Authorization - OAuth authorization records with active/revoked tokens, authorizedPeriod, publishedPeriod, scope
• ✅ ElectricPowerQualitySummary - Power quality data with flicker, harmonics, voltage events, interruption counts
• ✅ UsageSummary - Billing summaries with costs, consumption, tariff profiles, billing periods

Extracted to Standalone Files:

• ✅ UsagePoint
• ✅ MeterReading
• ✅ ReadingType
• ✅ IntervalBlock
• ✅ LocalTimeParameters

Inline Examples:

• ✅ ServiceStatus - Online/offline status indicators

Path Files Updated (24 files)

Every non-Batch path file now references its resource-specific response file:

• ApplicationInformation endpoints → AtomFeed_ApplicationInformation.yaml
• Authorization endpoints → AtomFeed_Authorization.yaml
• ElectricPowerQualitySummary endpoints → AtomFeed_ElectricPowerQualitySummary.yaml
• UsageSummary endpoints → AtomFeed_UsageSummary.yaml
• And so on...

Preserved Generic Responses

• AtomFeed.yaml and AtomEntry.yaml remain intact
• Still used by the 4 Batch endpoints (correct behavior for multi-resource subscription feeds)

Example Conventions

All new examples follow Green Button standards:

• Host: data.greenbuttonconnect.org
• Type 5 UUIDs for all feed/entry IDs
• Proper Atom namespace: http://www.w3.org/2005/Atom
• Proper ESPI namespace: http://naesb.org/espi
• Link attribute order: rel= href= type=
• Realistic values based on XSD schema definitions

Validation

✅ npm test - Passes with zero errors
✅ npm run build - Successfully generates documentation (1007 KiB)

Files Changed

• 18 new response files
• 24 path files updated
• 1 openapi.yaml updated (added response references)
• 1 CLAUDE.md added (branch management instructions)

Total: 44 files changed, 875 insertions, 24 deletions

Testing

After merge, verify at https://greenbuttonalliance.github.io/openapi-starter/ that:

• ApplicationInformation shows OAuth client data
• Authorization shows token data
• ElectricPowerQualitySummary shows power quality metrics
• UsageSummary shows billing data
• Each resource type displays appropriate examples

---

Co-Authored-By: Claude Sonnet 4.5 noreply@anthropic.com