Set up Cursor Cloud dev environment (AGENTS.md)

[GabDug]

What

Sets up the development environment for sync-pre-commit-lock in Cursor Cloud and documents durable, non-obvious notes for future agents.

This project is a pure Python PDM/Poetry plugin + sync-pre-commit-uv CLI — no services, servers, or databases. "Running the app" means invoking the CLI/plugin against a lockfile + .pre-commit-config.yaml.

Changes

• Add AGENTS.md with a ## Cursor Cloud specific instructions section covering lint/type-check/test/build commands and non-obvious gotchas.

Environment setup (not code)

• PDM installed to ~/.local/bin (added to PATH via ~/.bashrc).
• Startup update script: pdm install -G :all --dev (installs deps + editable plugin into .venv; idempotent).

Verification

Check	Command	Result
Lint	pdm run lint-ruff	All checks passed
Format	pdm run ruff format --check .	27 files already formatted
Type-check	pdm run lint-mypy	Success, no issues in 14 files
Tests	pdm run test	155 passed (see note)

Note: 3 tests in tests/test_shell_printer.py fail only because the Cloud VM sets NO_COLOR=1 / FORCE_COLOR=0 in the ambient environment; use_color() honors NO_COLOR. Running with them unset (env -u NO_COLOR -u FORCE_COLOR pdm run test) yields a clean 155 passed. This is an environment quirk, not a code bug, and is documented in AGENTS.md.

End-to-end demo

Ran the sync-pre-commit-uv CLI against a copy of tests/fixtures/uv_project/ (lock pins ruff 0.13.2, config had stale v0.1.0). It detected and rewrote the config rev v0.1.0 -> v0.13.2, then reported idempotent on re-run.

  

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.24%. Comparing base (f180378) to head (667566a).

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #77   +/-   ##
=======================================
  Coverage   97.24%   97.24%           
=======================================
  Files          12       12           
  Lines         727      727           
  Branches       66       66           
=======================================
  Hits          707      707           
  Misses         18       18           
  Partials        2        2           

Flag	Coverage Δ
unittests	97.24% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.