feat(instances): document calendar event linking

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Ask on Discord
+    url: https://discord.gg/qjZE9C9fkB
+    about: Questions about using the API or one of the libraries.
+  - name: Report a bug in one library
+    url: https://github.com/orgs/vrchatapi/repositories
+    about: Every library is generated from this specification, so a response one of them can't parse belongs here. A bug in a library's own code belongs in its repository.

.github/ISSUE_TEMPLATE/missing-from-specification.yml

@@ -0,0 +1,31 @@
+name: Missing from the specification
+description: An endpoint, parameter or field VRChat supports that the specification doesn't describe.
+labels:
+  - "Type: Enhancement"
+body:
+  - type: input
+    id: request
+    attributes:
+      label: Request
+      description: The method and path.
+      placeholder: GET /instanceCategories
+    validations:
+      required: true
+  - type: textarea
+    id: missing
+    attributes:
+      label: What's missing
+      description: The endpoint, parameter or field, and what it does.
+    validations:
+      required: true
+  - type: textarea
+    id: capture
+    attributes:
+      label: Request and response
+      description: A request you sent and the response VRChat returned. Redact anything personal, but keep each value's type.
+      render: text
+  - type: textarea
+    id: source
+    attributes:
+      label: Where it comes from
+      description: Where you saw it, such as the VRChat client, the website or a Developer Update. Link it if you can.

.github/ISSUE_TEMPLATE/response-mismatch.yml

@@ -0,0 +1,35 @@
+name: Response doesn't match
+description: A library fails to parse a response, or VRChat returns a field, type or value the specification doesn't describe.
+labels:
+  - "Type: Bug"
+body:
+  - type: markdown
+    attributes:
+      value: A library's error names the field but not the value that broke it. The raw response is what lets us fix it.
+  - type: input
+    id: operation
+    attributes:
+      label: Operation
+      description: The operation id or the request.
+      placeholder: getModerationReports, or GET /moderationReports
+    validations:
+      required: true
+  - type: textarea
+    id: response
+    attributes:
+      label: Response body
+      description: The JSON VRChat returned, or the object within it that failed. Redact anything personal, but keep each value's type. Replace a string with another string, and leave `null` as `null`.
+      render: json
+    validations:
+      required: true
+  - type: textarea
+    id: error
+    attributes:
+      label: Error
+      description: The error your library raised, if any.
+      render: text
+  - type: input
+    id: library
+    attributes:
+      label: Library and version
+      placeholder: vrchatapi-csharp 1.21.0

.github/ISSUE_TEMPLATE/something-else.yml

@@ -0,0 +1,9 @@
+name: Something else
+description: A wrong description, a problem with the published bundles, or anything neither form above covers.
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: What's wrong
+    validations:
+      required: true

.github/pull_request_template.md

@@ -0,0 +1,9 @@
+Closes #
+
+## Evidence
+
+<!-- The workflow in test/arazzo.yaml that captures the change, or the issue carrying the response it comes from. -->
+
+- [ ] Every property, type and example comes from a captured response
+- [ ] `pnpm lint` passes
+- [ ] `pnpm test -w session -w <workflow>` passes

.github/workflows/ci.yaml

@@ -2,11 +2,17 @@ on:
   push:
     branches:
       - main
+      - stable
   pull_request:
   schedule:
     - cron: "17 7 * * *"
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.event_name == 'push' && format('{0}-{1}', github.workflow, github.ref) || github.run_id }}
+  cancel-in-progress: false
+  queue: max
+
 env:
   GH_TOKEN: ${{ github.token }}
 
@@ -24,9 +30,9 @@ jobs:
           runtime: bun@latest
           cache: true
 
-      - if: github.event_name == 'push'
+      - if: github.event_name == 'push' && github.event.before != '0000000000000000000000000000000000000000'
         run: |
-          changes=$(git diff --name-only --diff-filter=d "${{ github.event.commits[0].id }}~1" "${{ github.event.commits[0].id }}")
+          changes=$(git diff --name-only --diff-filter=d "${{ github.event.before }}" "${{ github.sha }}")
           {
             echo 'changes<<eof_${{ github.run_id }}'
             echo "$changes"
@@ -54,6 +60,9 @@ jobs:
         continue-on-error: true
         run: pnpm run lint-ci
 
+      - name: test and build redocly-plugin-downlevel
+        run: pnpm run test:downlevel
+
       - name: assert no unused paths
         if: env.changes != ''
         run: |
@@ -77,16 +86,52 @@ jobs:
   bundle:
     if: github.event_name != 'schedule'
     runs-on: ubuntu-latest
+    outputs:
+      release: ${{ steps.version.outputs.release }}
     steps:
       - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
 
       - uses: pnpm/setup@v2
         with:
           runtime: bun@latest
           cache: true
 
+      - name: version the build for the branch it releases from
+        id: version
+        run: |
+          declared=$(yq -r '.info.version' openapi/openapi.yaml)
+          latest=$(git tag --list 'v*' | sed 's/^v//' | xargs -r pnpm -s semver --range '*' | tail -n 1 || true)
+
+          release=true
+
+          if [ "$GITHUB_REF_NAME" = stable ]; then
+            version=$declared
+
+            if ! pnpm -s semver "$declared" > /dev/null; then
+              echo "::error::$declared is not a version"
+              exit 1
+            elif git rev-parse --quiet --verify "refs/tags/v$declared" > /dev/null; then
+              release=false
+            elif [ -n "$latest" ] && pnpm -s semver --range "<$latest" "$declared" > /dev/null; then
+              echo "::error::$declared is below the latest release, $latest"
+              exit 1
+            fi
+          else
+            base=$(pnpm -s semver --increment patch "${latest:-$declared}")
+            highest=$(git tag --list "v$base-nightly.*" | sed "s/^v$base-nightly\.//" | grep -xE '[0-9]+' | sort -n | tail -n 1 || true)
+            version="$base-nightly.$(( ${highest:-0} + 1 ))"
+          fi
+
+          echo "version=$version" >> "$GITHUB_ENV"
+          echo "release=$release" >> "$GITHUB_OUTPUT"
+
       - run: bun --bun run bundle
 
+      - name: lint the downleveled bundles as the version they declare
+        run: bun --bun run test:versions
+
       - uses: actions/github-script@v9
         with:
           script: |
@@ -132,19 +177,14 @@ jobs:
     needs:
       - lint
       - bundle
-    if: ${{ !failure() && !cancelled() && github.event_name != 'schedule' && github.ref == 'refs/heads/main' }}
+    if: ${{ !failure() && !cancelled() && github.event_name != 'schedule' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/stable') && needs.bundle.outputs.release == 'true' && !contains(github.event.head_commit.message, '[no release]') }}
+    concurrency:
+      group: release
     outputs:
       version: ${{ steps.metadata.outputs.version }}
 
     steps:
       - uses: actions/checkout@v7
-        with:
-          fetch-depth: 0
-
-      - uses: pnpm/setup@v2
-        with:
-          runtime: bun@latest
-          cache: true
 
       - uses: actions/download-artifact@v8
         with:
@@ -156,17 +196,10 @@ jobs:
         run: |
           version=$(jq -r '.info.version' dist/openapi.json)
 
-          version_sha=$(
-            git rev-list -n 1 "v$version" 2>/dev/null \
-            || git rev-list -n 1 "release/$version" 2>/dev/null \
-            || echo ""
-          )
-
-          if [ "$version_sha" == "" ]; then
-            echo "prerelease=false" >> $GITHUB_ENV
-          else
+          if [[ "$version" == *-nightly.* ]]; then
             echo "prerelease=true" >> $GITHUB_ENV
-            version=$(pnpm semver $version -i)-nightly.$(git rev-list --count "$version_sha"..HEAD)
+          else
+            echo "prerelease=false" >> $GITHUB_ENV
           fi
 
           echo "version=$version" >> $GITHUB_ENV
@@ -179,13 +212,16 @@ jobs:
       - name: create release (nightly)
         if: env.prerelease == 'true'
         run: |
-          jq --arg v "${{ env.version }}" '.info.version = $v' dist/openapi.json > dist/.openapi.json && mv dist/.openapi.json dist/openapi.json
-          yq eval ".info.version = \"${{ env.version }}\"" -i dist/openapi.yaml
-
           gh release create v${{ env.version }} dist/* \
             --generate-notes \
             --prerelease
 
+      - name: refresh the nightly release
+        if: github.ref == 'refs/heads/main'
+        run: |
+          gh release upload nightly dist/* --clobber
+          gh release edit nightly --notes "The latest build from main, currently v${{ env.version }}. Its files are replaced whenever a new build is published."
+
   release_dispatch:
     uses: ./.github/workflows/release_dispatch.yaml
     needs: release
@@ -194,7 +230,7 @@ jobs:
       version: ${{ needs.release.outputs.version }}
 
   test:
-    if: github.event_name != 'pull_request'
+    if: github.ref == 'refs/heads/main' && !contains(github.event.head_commit.message, '[no test]')
     runs-on: ubuntu-latest
     concurrency:
       group: test
@@ -215,6 +251,32 @@ jobs:
           VRCHAT_PASSWORD: ${{ secrets.VRCHAT_PASSWORD }}
           VRCHAT_TOTP_SECRET: ${{ secrets.VRCHAT_TOTP_SECRET }}
           VRCHAT_FRIEND_ID: ${{ secrets.VRCHAT_FRIEND_ID }}
+          VRCHAT_GROUP_ID: ${{ secrets.VRCHAT_GROUP_ID }}
+
+      - if: "!cancelled()"
+        uses: actions/upload-artifact@v7
+        with:
+          name: respect-report
+          path: test/.out/respect.json
+          retention-days: 1
 
       - if: "!cancelled()"
-        run: pnpm test:drift >> "$GITHUB_STEP_SUMMARY"
+        timeout-minutes: 2
+        run: sh test/report.sh --format github
+
+      - if: "!cancelled()"
+        timeout-minutes: 2
+        run: sh test/report.sh >> "$GITHUB_STEP_SUMMARY"
+
+      - if: "!cancelled()"
+        timeout-minutes: 5
+        run: |
+          status=0
+          pnpm -s test:drift --max-findings 1000 --output test/.out/drift.txt || status=$?
+          cat test/.out/drift.txt
+          {
+            printf '### Drift\n\n```\n'
+            cat test/.out/drift.txt
+            printf '```\n'
+          } >> "$GITHUB_STEP_SUMMARY"
+          exit $status