cubeChanges

Learn how to track and manage changes in SRE.ai

Overview

A Change is SRE.ai's core unit of work.

It tracks everything associated with a feature or fix, from the initial description through code commits, pull requests, and deployment across environments.

Changes support every metadata type supported by the Metadata API.

Usually, developing a new feature in Salesforce involves updating a range of metadata types and data.

Tasks, Apex scripts, and manual steps may also be involved.

circle-info

You can import changes directly if your source environment is enabled for Source Tracking.

Core capabilities

Change lifecycle

A Change moves through your deployment pipeline as work progresses.

SRE.ai tracks the current stage automatically based on deployment history.

If new commits have been added since the last successful deployment, the change is flagged as needing re-deployment.

Each change has a status:

  • Active: The change is in progress

  • Archived: The change has been completed or closed

What a Change tracks

Commits

Every git commit associated with a change is linked and visible in the change view.

Commits are scoped to a specific branch, which SRE.ai creates automatically if one is not provided.

Pull requests

Pull requests created from a change branch are automatically associated with the change. For each PR, SRE.ai tracks:

  • Review status: Pending, Approved, Changes Requested, or Commented

  • Merge state: Open, Merged, or Closed

  • Who last reviewed it and when

  • Who merged it and when

Data queries

Changes can include SOQL queries that define data to retrieve alongside the metadata.

When present, these queries are saved as reusable templates and appear as selectable options in the commit tool, so the same query can be applied across multiple commits without re-entering it.

How it works

Deployments

Each deployment of a change to a Salesforce environment is recorded, including which commit was deployed, which stage it targeted, and whether it succeeded.

Code quality

SRE.ai runs code analysis on the files modified by a change and surfaces findings directly in the change view.

Finding types:

Type
Description

Static code analysis

Rule-based violations (e.g., PMD, ESLint) with severity and rule name

AI analysis

AI-generated observations about code quality, patterns, and risks

Dependency reference check

Checks for broken or missing references across metadata components

Finding severity: Critical, High, Medium, Low, Info

Finding statuses:

  • Open: New or unresolved

  • In progress: Being worked on

  • Resolved: Fixed and closed

  • Dismissed: Marked as not applicable

Users can provide feedback on findings (positive or negative) and leave comments. Findings can also be marked as implemented once a fix has been deployed.

PR and MR comments

When a pull request or merge request is linked to a change, SRE.ai automatically posts code findings as inline comments so reviewers see them without leaving the code review.

  • GitHub: Findings are submitted as a single pull request review with one inline comment per finding, anchored to the specific file and line number.

  • GitLab: Findings are posted as MR discussions. Each comment includes the file path and line number in the body.

Which findings are posted:

  • Severity: Critical, High, and Medium only. Low and Info are not posted

  • Status: Open and In Progress only. Resolved and Dismissed findings are excluded

  • Cap: Up to 50 comments per PR/MR

  • Deduplication: Findings that were already commented on are not reposted when a PR is updated

circle-info

Findings are only posted for files that appear in the pull request diff. If a finding references a file not changed in the PR, that comment is skipped.

Test coverage

For Apex code, SRE.ai tracks test coverage at the class level. Each change shows:

  • Overall coverage percentage vs. the required threshold

  • Which lines are covered and which are not

  • A per-class breakdown with test method detail

Activity timeline

The timeline logs every significant event in a change's lifecycle:

  • Change created or updated

  • Commit added

  • Deployment completed

  • Pull request created, reviewed, or merged

Each entry includes a timestamp and the user who performed the action.

External issues

Changes can be linked to Jira or Linear issues.

When a change is updated, SRE.ai automatically syncs the relevant fields back to the linked issue, keeping your issue tracker up to date without manual updates.

Links to external issues are visible in the change header and can be added or removed at any time.

Setup

The Changes page lists all changes in your workspace.

Each change row displays a component count badge (e.g., "3 components") so you can gauge the scope of a change at a glance without opening it.

The view can be filtered and adjusted:

  • Status filter: Active or Archived

  • Visible columns: Status, Source Org, Stage, Created, Last Updated

  • Rows per page: 10, 20, 30, 50, or 100

Click on any change to expand its details and adjust the Change.

Last updated