feat(ci): add staging sync workflow with issue automation

[fahmidareem3]

Overview

This PR introduces a new GitHub Actions workflow to sync changes from the staging environment to the SDK repository via automated issue creation.

The workflow listens to repository_dispatch events (backend-staging-pushed) and ensures that any API-level changes are surfaced for SDK updates.

---

What’s Included

• New workflow: backend-sync.yml
• Triggered via repository_dispatch from backend staging
• Automatically:
  • Parses and validates incoming payload
  • Extracts commit details and changed files
  • Creates a new issue or appends to an existing one (deduplicated within 24h window)
• Adds labels: api-sync, backend

---

Key Features

• Robust payload validation

  • Sanitizes filenames
  • Validates URLs and commit metadata
  • Handles missing or malformed payloads safely

• Smart deduplication

  • Prevents issue spam by appending updates to recent open issues
  • Uses a 24-hour window for grouping related changes

• Readable issue formatting

  • Displays commit SHA, message, and changed files
  • Handles large diffs with truncation + summary
  • Includes direct links to compare view and workflow run

• Edge case handling

  • Gracefully skips empty payloads
  • Handles truncated file lists and incorrect counts
  • Escapes markdown to prevent formatting issues

---

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: aeb1812775

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 48fed196bd

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".