Revert info.version to 2025-10-13 and document version-bump rule

[shreyav]

Summary

• Revert the Grid API OpenAPI info.version from 2026-06-29 back to 2025-10-13, the value it held on the initial schema commit. Edited the source openapi/openapi.yaml and rebundled (make build), so the generated openapi.yaml and mintlify/openapi.yaml are updated in lockstep.
• Add a Critical Rules bullet to CLAUDE.md establishing the versioning convention: bump info.version only when a breaking change ships, at which point it should match a new servers.url path.

Why

The two prior bumps (#617: 2025-10-13 → 2026-06-25, and #633: 2026-06-25 → 2026-06-29) were both purely additive, non-breaking schema changes. Under the new convention the version should not have moved for those, so it's reset to 2025-10-13 — which matches the current servers.url path https://api.lightspark.com/grid/2025-10-13.

Test plan

• make lint passes (0 errors).
• Verified info.version reads 2025-10-13 in all three files (openapi/openapi.yaml, openapi.yaml, mintlify/openapi.yaml).

Requested by @shreyav

Slack thread: https://lightsparkgroup.slack.com/archives/D0AH5T8FMGE/p1783708971530589

---

🤖 custodial-circuit(#1) | Feedback

Original PR: #678

[akanter]

• Revert info.version to 2025-10-13 and document version-bump rule #679 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

✱ Stainless preview builds for grid

This PR will update the grid SDKs with the following commit messages.

cli

chore(internal): regenerate SDK with no functional changes

go

chore(internal): regenerate SDK with no functional changes

kotlin

chore(internal): regenerate SDK with no functional changes

openapi

chore(internal): regenerate SDK with no functional changes

php

chore(internal): regenerate SDK with no functional changes

python

chore(internal): regenerate SDK with no functional changes

ruby

chore(internal): regenerate SDK with no functional changes

typescript

chore(internal): regenerate SDK with no functional changes

⚠️ grid-openapi studio · code

Your SDK build had at least one "warning" diagnostic.
generate ⚠️

✅ grid-ruby studio · code

Your SDK build had at least one "note" diagnostic.
generate ✅ → build ⏭️ → lint ✅ → test ✅

⚠️ grid-go studio · code

Your SDK build had a failure in the lint CI job, which is a regression from the base state.
generate ✅ → build ⏭️ → lint ❗ → test ❗

go get github.com/stainless-sdks/grid-go@7762bb2f24adb199eee02fdced60c8bd392c1bdd

⚠️ grid-kotlin studio · code

Your SDK build had a failure in the test CI job, which is a regression from the base state.
generate ⚠️ → build ⏭️ → lint ⏭️ → test ❗

✅ grid-typescript studio · code

Your SDK build had at least one "note" diagnostic.
generate ✅ → build ⏭️ → lint ⏭️ → test ✅

⚠️ grid-python studio · code

Your SDK build had a failure in the test CI job, which is a regression from the base state.
generate ✅ → build ⏭️ → lint ⏭️ → test ❗

✅ grid-php studio · code

Your SDK build had at least one "note" diagnostic.
generate ✅ → lint ✅ → test ✅

⚠️ grid-cli studio · code

Your SDK build had a failure in the test CI job, which is a regression from the base state.
generate ⚠️ → build ⏭️ → lint ⏭️ → test ❗

---

This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-07-10 19:18:35 UTC

[greptile-apps]

Greptile Summary

This PR resets the OpenAPI version metadata and documents when it should change.

• Reverts info.version to 2025-10-13 in the source OpenAPI spec.
• Rebundles the root and Mintlify OpenAPI files with the same version.
• Adds a CLAUDE.md rule to bump info.version only for breaking API path changes.

Confidence Score: 5/5

This looks safe to merge.

• No blocking issues found in the changed code.

Important Files Changed

Filename	Overview
CLAUDE.md	Adds the version-bump convention to the repository rules.
openapi/openapi.yaml	Reverts the source OpenAPI info.version to match the existing API path.
openapi.yaml	Updates the generated root OpenAPI bundle with the reverted version.
mintlify/openapi.yaml	Updates the Mintlify OpenAPI bundle with the reverted version.

_{Reviews (1): Last reviewed commit: "Revert info.version to 2025-10-13 and do..." | Re-trigger Greptile}