Skip to content

Add new property types for 0.20 spec#116

Open
kinlane wants to merge 4 commits intodevelopfrom
spec-0.20-property-types
Open

Add new property types for 0.20 spec#116
kinlane wants to merge 4 commits intodevelopfrom
spec-0.20-property-types

Conversation

@kinlane
Copy link
Copy Markdown
Contributor

@kinlane kinlane commented May 2, 2026

Summary

  • Adds 22 new reserved type values to the 0.20 schema based on real-world provider usage analysis (100+ and 20–100 occurrence categories)
  • Adds GitHubOrganization and GitHubRepository as canonical aliases for existing GitHubOrg/GitHubRepo shorthand forms
  • Fixes JsonStructureJSONStructure (casing inconsistency)
  • Removes duplicate ApiExamples entry in the type pattern
  • Updates specificationVersion description from "0.19" to "0.20"

New types added:

Category Types
Technical Contracts JSONStructure, JSONLD, Vocabulary, SpectralRules
Web & Portal Website, Portal, DeveloperPortal, YouTube, LinkedIn
Reference Examples, FAQ, Summary
Onboarding CLI, Console, Sandbox, Training
Community Community, StackOverflow, Slack, Discord
Lifecycle ReleaseNotes
Legal Compliance, License
Social X (Twitter/X rebrand alias), GitHubOrganization, GitHubRepository

Test plan

  • Validate an APIs.json file using each new type against schema_0.20.yml
  • Confirm JsonStructure (old) is no longer accepted and JSONStructure (new) is
  • Confirm ApiExamples appears exactly once in the pattern (no duplicate match)
  • Verify X-custom-name extensions still validate

🤖 Generated with Claude Code

kinlane and others added 4 commits May 1, 2026 20:06
- Add 22 new reserved types from provider usage analysis (Website, Portal,
  DeveloperPortal, Examples, Vocabulary, SpectralRules, JSONLD, Console,
  YouTube, StackOverflow, Community, FAQ, LinkedIn, X, ReleaseNotes, CLI,
  Compliance, Training, License, Sandbox, Slack, Discord)
- Add GitHubOrganization and GitHubRepository as canonical aliases for
  GitHubOrg and GitHubRepo
- Fix JsonStructure → JSONStructure (correct casing per naming convention)
- Remove duplicate ApiExamples entry in pattern
- Update specificationVersion description from 0.19 to 0.20

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds FocusBillingExport, FocusConformanceReport, FocusContractCommitments,
OpenCostSpecification, OpenCostAllocationAPI, UnitEconomics, ChargebackPolicy,
TaggingPolicy, InvoiceReconciliation, FinOpsFramework, SoftwareCarbonIntensity,
SCIReport, and GHGProtocolReport to the reserved type pattern.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds 11 types documented in apisjson_0.20.txt but missing from the schema:
ALPS, Arazzo, JSONForms, DataContract, ServerlessWorkflow, Plans, UseCases,
InsomniaCollection, BrunoCollection, Compare, Evolution.

schema_0.21 inherits the same fix plus retains its 13 FinOps/sustainability types.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant