diff --git a/AGENTS.md b/AGENTS.md index 43fed37..45dc0e2 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 @@ -130,7 +130,20 @@ Full procedure: [docs/operations/linear-workflow.md](docs/operations/linear-work 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. 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). \ No newline at end of file +See [docs/index.md](docs/index.md) for the categorized documentation index (ADRs, architecture, specs, audits, operations, and more).