Skip to content

Add Cursor Cloud Agent development environment - #219

Merged
btr-rmconsole-2[bot] merged 2 commits into
masterfrom
cursor/setup-dart-environment-7440
Sep 10, 2026
Merged

btr-rmconsole-2[bot] merged 2 commits into
masterfrom
cursor/setup-dart-environment-7440

Conversation

@edwardweymouth-wk

@edwardweymouth-wk edwardweymouth-wk commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Motivation

This repository had no Cursor Cloud Agent environment configuration, so a fresh agent started with no Dart toolchain and no dependencies installed. This PR adds a repository-managed environment so future agents can build, analyze, format, and test both packages out of the box.

Changes

  • Add .cursor/environment.json with a self-contained install step that:
    • installs the CI-pinned Dart SDK 2.19.6 (matches .github/workflows/dart_ci.yml) to /usr/lib/dart-sdk and symlinks it onto the default PATH at /usr/local/bin/dart (no shell-profile mutation), and
    • runs dart pub get for both w_common and w_common_tools.

The install command is inlined directly in environment.json (single source of truth), which also allows a promotable default-branch environment build to be produced for the dashboard Save flow.

No custom Dockerfile is used: the default base image already ships Chrome (required for the chrome-platform browser tests) plus git/curl/unzip. All dependencies resolve from public pub.dev, so no wk/Artifactory authentication is required. No start step is needed because the SDK, PATH symlink, and pub cache persist in the environment build snapshot.

Release Notes

Add Cursor Cloud Agent development environment configuration.

Review

See CONTRIBUTING.md for more details on review types (+1 / QA +1 / +10) and code review process.

Please review:

QA Checklist

  • Tests were updated and provide good coverage of the changeset and other affected code
  • Manual testing was performed if needed
    • Steps from PR author: validated the install from a clean VM (idempotent on re-run) and inside a from-scratch Cloud Agent build; ran dart pub get, dart run dependency_validator, dart analyze, dart format --output=none --set-exit-if-changed ., and dart test for both packages (271 + 25 tests pass), plus the compile_sass CLI against SCSS fixtures. Also verified via a fresh Cloud Agent booted from the built environment.

Merge Checklist

While we perform many automated checks before auto-merging, some manual checks are needed:

  • A Frontend Architecture member has reviewed these changes
  • There are no unaddressed comments - this check can be automated if reviewers use the "Request Changes" feature
  • For release PRs - Version metadata in Rosie comment is correct
Open in Web Open in Cursor 

Install the CI-pinned Dart SDK (2.19.6) and fetch pub dependencies for the
w_common and w_common_tools packages. Chrome (needed for browser tests) is
already present in the base image, and all dependencies are public pub.dev
packages, so no wk/Artifactory auth is required.

Co-authored-by: Edward Weymouth <edwardweymouth-wk@users.noreply.github.com>
@edwardweymouth-wk
edwardweymouth-wk marked this pull request as ready for review September 9, 2026 21:19
Move the self-contained Dart SDK install + pub get into the environment.json
install field and remove the separate .cursor/install.sh. This makes the
config a single source of truth and lets a promotable default-branch
environment build be produced (a build is required for the dashboard Save
flow to attach a valid environment).

Co-authored-by: Edward Weymouth <edwardweymouth-wk@users.noreply.github.com>
@sorenthompson-wk

Copy link
Copy Markdown

QA +1

  • CI is passing

@Workiva/release-management-p

@andrewmumm-wk andrewmumm-wk left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

QA+1
@Workiva/release-management-p

@rmconsole-wf rmconsole-wf left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1 from RM

@btr-rmconsole-2
btr-rmconsole-2 Bot merged commit bb3af37 into master Sep 10, 2026
7 checks passed
@btr-rmconsole-2
btr-rmconsole-2 Bot deleted the cursor/setup-dart-environment-7440 branch September 10, 2026 14:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants