From 6f37c98f2d440082e0bb526821c418e39ae81b47 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 26 Jul 2026 10:28:44 +0000 Subject: [PATCH 1/3] Add Cursor Cloud agent setup notes to AGENTS.md Document cloud-specific restore/build gotchas, model-cache expectations, and CLI entrypoint guidance for future agents. Co-authored-by: Anthony Thompson --- AGENTS.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 2bde291..39385eb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -115,3 +115,17 @@ Imperative title: `Add ...`, `Remove ...`, `Fix ...`, `Revise ...` ## Repository Policy See [docs/repository-policy.md](docs/repository-policy.md) for organization and governance details. + +## Cursor Cloud specific instructions + +No long-running services. The product entrypoint is the headless CLI (`src/Trackdub.Cli`). Standard build/test/run commands are in [AGENTS.md Commands](#commands) and README. + +### Cloud agent gotchas + +- Always pass `-m:1` to `dotnet restore`, `dotnet build`, and `dotnet test` (matches CI and avoids restore/build races). +- NuGet restore needs network access to both `nuget.org` and the Azure Artifacts `dotnet-libraries` feed (see `NuGet.config`) for `Microsoft.ML.Tokenizers` 3.x. +- `dotnet format Trackdub.slnx --verify-no-changes` is the lint/format gate (CI `format` job). +- FFmpeg/ffprobe are required for media stages; playback natives (libmpv/LibVLC) are optional for CLI pipeline runs. `trackdub doctor` reports readiness. +- Full `dub` / ASR / TTS / translation need ONNX models downloaded into the model cache (`trackdub models bundle-needed`, then `trackdub models download `). Tests that need models skip cleanly when missing. +- Prefer `dotnet run --project src/Trackdub.Cli -- ` over a global tool install. Use `--no-build` after a fresh Debug build. +- Default data/cache roots land under `~/.local/share/Trackdub` (override with `TRACKDUB_DATA_ROOT` / `TRACKDUB_CACHE_ROOT` if needed). From 8292660febff9db316660eb5184d06c0e3dae455 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 26 Jul 2026 11:18:21 +0000 Subject: [PATCH 2/3] Revise AGENTS.md commands to include -m:1 consistently Align single-test and CI restore/test examples with the cloud-agent guidance that restore/build/test use -m:1. Co-authored-by: Anthony Thompson --- AGENTS.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 39385eb..f80c256 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -50,12 +50,12 @@ dotnet test Trackdub.slnx -m:1 dotnet test tests/Trackdub..Tests --no-restore -m:1 # Single test -dotnet test tests/Trackdub.Application.Tests --filter "FullyQualifiedName~" +dotnet test tests/Trackdub.Application.Tests --filter "FullyQualifiedName~" -m:1 # CI build (Release, warnings as errors) -dotnet restore Trackdub.slnx +dotnet restore Trackdub.slnx -m:1 dotnet build Trackdub.slnx --configuration Release --no-restore -m:1 -warnaserror -dotnet test Trackdub.slnx --configuration Release --no-build +dotnet test Trackdub.slnx --configuration Release --no-build -m:1 # Run headless CLI dotnet run --project src/Trackdub.Cli -- --help From 414fa775913f345cf54e55d2d660326e00a36071 Mon Sep 17 00:00:00 2001 From: tonythethompson Date: Tue, 28 Jul 2026 19:53:14 -0700 Subject: [PATCH 3/3] Fix Cursor Cloud AGENTS.md review findings. Use checkout-friendly CLI invocations and restore the documentation index link. Co-authored-by: Cursor --- AGENTS.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index a68d4d3..45dc0e2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -139,7 +139,11 @@ No long-running services. The product entrypoint is the headless CLI (`src/Track - Always pass `-m:1` to `dotnet restore`, `dotnet build`, and `dotnet test` (matches CI and avoids restore/build races). - NuGet restore needs network access to both `nuget.org` and the Azure Artifacts `dotnet-libraries` feed (see `NuGet.config`) for `Microsoft.ML.Tokenizers` 3.x. - `dotnet format Trackdub.slnx --verify-no-changes` is the lint/format gate (CI `format` job). -- FFmpeg/ffprobe are required for media stages; playback natives (libmpv/LibVLC) are optional for CLI pipeline runs. `trackdub doctor` reports readiness. -- Full `dub` / ASR / TTS / translation need ONNX models downloaded into the model cache (`trackdub models bundle-needed`, then `trackdub models download `). Tests that need models skip cleanly when missing. +- FFmpeg/ffprobe are required for media stages; playback natives (libmpv/LibVLC) are optional for CLI pipeline runs. Readiness: `dotnet run --project src/Trackdub.Cli -- doctor`. +- Full `dub` / ASR / TTS / translation need ONNX models downloaded into the model cache (`dotnet run --project src/Trackdub.Cli -- models bundle-needed`, then `dotnet run --project src/Trackdub.Cli -- models download `). Tests that need models skip cleanly when missing. - Prefer `dotnet run --project src/Trackdub.Cli -- ` over a global tool install. Use `--no-build` after a fresh Debug build. - Default data/cache roots land under `~/.local/share/Trackdub` (override with `TRACKDUB_DATA_ROOT` / `TRACKDUB_CACHE_ROOT` if needed). + +## Documentation + +See [docs/index.md](docs/index.md) for the categorized documentation index (ADRs, architecture, specs, audits, operations, and more).