Updating Specs
Step 1: Download fresh specs
Section titled “Step 1: Download fresh specs”cd forge-clientspnpm --filter @forge-clients/generator run update-specsThis downloads from:
https://developer.atlassian.com/cloud/jira/platform/swagger-v3.v3.jsonhttps://developer.atlassian.com/cloud/jira/platform/swagger.v2.jsonhttps://developer.atlassian.com/cloud/jira/software/swagger.v3.jsonhttps://developer.atlassian.com/cloud/jira/service-desk/swagger.v3.jsonhttps://developer.atlassian.com/cloud/confluence/swagger.v3.json
Raw specs are saved to packages/specs/src/raw/ (gitignored).
Cleaned specs are saved to packages/specs/src/cleaned/ (committed to git).
Step 2: Review the diff
Section titled “Step 2: Review the diff”# The pipeline generates a diff summarycat packages/specs/src/diff/jira-v3.diff.json | jq '.summary'Step 3: Regenerate clients
Section titled “Step 3: Regenerate clients”pnpm --filter @forge-clients/generator run generateStep 4: Typecheck and test
Section titled “Step 4: Typecheck and test”pnpm -r run typecheckpnpm run testStep 5: Commit
Section titled “Step 5: Commit”git add packages/specs/src/cleaned/ packages/jira/src/ packages/confluence/src/git commit -m "chore: regenerate clients from updated Atlassian specs"