diff --git a/.agents/agents/sdk-consumer-setup.md b/.agents/agents/sdk-consumer-setup.md index b356a417..8e5066c3 100644 --- a/.agents/agents/sdk-consumer-setup.md +++ b/.agents/agents/sdk-consumer-setup.md @@ -2,12 +2,12 @@ ## Goal -Help a consuming repository adopt or troubleshoot `Purview.DotNetProjectSdk` correctly, without breaking existing build behaviour. +Help a consuming repository adopt or troubleshoot `Purview.BuildSdk` correctly, without breaking existing build behaviour. ## Workflow 1. Confirm the SDK is imported in `Directory.Build.props`/`Directory.Build.targets` via - `` and the matching `Sdk.targets` import. + `` and the matching `Sdk.targets` import. 2. Check pre-import bootstrap properties are set **before** the `Sdk.props` import when they must affect evaluation: `NamespacePrefix`, `UsePackageJsonVersion`, `RootPackageJson`. 3. If version resolution looks wrong, verify `package.json` discovery: explicit `RootPackageJson`, then CI diff --git a/.agents/prompts/sdk-diagnose-agent-folder-copy.md b/.agents/prompts/sdk-diagnose-agent-folder-copy.md index 49ad1c21..85ad4445 100644 --- a/.agents/prompts/sdk-diagnose-agent-folder-copy.md +++ b/.agents/prompts/sdk-diagnose-agent-folder-copy.md @@ -1,6 +1,6 @@ # sdk-diagnose-agent-folder-copy (generic prompt spec) -Diagnose why the bundled `.agents/**` folder from `Purview.DotNetProjectSdk` did not appear at the expected +Diagnose why the bundled `.agents/**` folder from `Purview.BuildSdk` did not appear at the expected destination in a consuming repository. ## Required behaviour diff --git a/.agents/skills/project-placement-defaults/SKILL.md b/.agents/skills/project-placement-defaults/SKILL.md index 46948659..b650da81 100644 --- a/.agents/skills/project-placement-defaults/SKILL.md +++ b/.agents/skills/project-placement-defaults/SKILL.md @@ -1,11 +1,11 @@ --- name: project-placement-defaults -description: "Use when creating, moving, or splitting projects in a repository that uses Purview.DotNetProjectSdk, especially for src/tests placement, test suffix naming, namespace alignment, and automatic project-reference behavior." +description: "Use when creating, moving, or splitting projects in a repository that uses Purview.BuildSdk, especially for src/tests placement, test suffix naming, namespace alignment, and automatic project-reference behavior." --- -# Project placement defaults for Purview.DotNetProjectSdk +# Project placement defaults for Purview.BuildSdk -Use this skill whenever a task asks to add, move, split, or create a project in a repository that uses `Purview.DotNetProjectSdk` and you need placement, naming, and reference decisions to remain consistent with the SDK's automatic conventions. +Use this skill whenever a task asks to add, move, split, or create a project in a repository that uses `Purview.BuildSdk` and you need placement, naming, and reference decisions to remain consistent with the SDK's automatic conventions. ## Core principle diff --git a/AGENTS.md b/AGENTS.md index 3442d4d2..58286647 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,7 +24,7 @@ code to generated telemetry interfaces) in a companion assembly. - .NET 10 SDK (projects target `net10.0`; the source generator is a Roslyn component targeting `netstandard2.0`) - [Bun](https://bun.sh) for the `package.json`/`.build/*.ts` scripts -- The `Purview.DotNetProjectSdk` MSBuild SDK (pinned in `global.json` under `msbuild-sdks`) +- The `Purview.BuildSdk` MSBuild SDK (pinned in `global.json` under `msbuild-sdks`) - `csharpier` dotnet tool (pinned in `.config/dotnet-tools.json`) for linting/formatting ## Commands @@ -62,7 +62,7 @@ conventional-commits check. | `just update-version` | Runs `.build/update-version.ts` to sync the version into docs/samples. | | `just pack` | Updates the version then packs the NuGet package into `artifacts/`. | -The version lives in `package.json`. **Current Version:** 5.0.0-prerelease.8 — applied to `Version` / +The version lives in `package.json`. **Current Version:** 5.0.0-prerelease.10 — applied to `Version` / `PackageVersion` via the SDK's package.json version detection. ### Pipelines (reusable `purview-build` tool) @@ -155,7 +155,7 @@ The sample projects enable `EmitCompilerGeneratedFiles`, so generated telemetry - **Source generator**: targets `netstandard2.0` for broad compiler-host compatibility and uses `Purview.SourceGeneratorFramework` (CodeWriter-based emission, incremental pipeline, value-equatable models). -- **SDK**: projects import `Purview.DotNetProjectSdk` via `Directory.Build.props`/`.targets`. The repo +- **SDK**: projects import `Purview.BuildSdk` via `Directory.Build.props`/`.targets`. The repo sets `ExcludePurviewTelemetry=true` (it does not consume the telemetry package it generates) and `NamespacePrefix=Purview.Telemetry` under `src/`. See `.agents/skills/sdk-*` for SDK behavior. @@ -171,7 +171,7 @@ Load the relevant skill before doing specialist work: modernising existing tests. - `.agents/skills/sdk-configuration-reference/SKILL.md`, `.agents/skills/sdk-project-behavior-and-detection/SKILL.md`, - `.agents/skills/project-placement-defaults/SKILL.md` — `Purview.DotNetProjectSdk` configuration, + `.agents/skills/project-placement-defaults/SKILL.md` — `Purview.BuildSdk` configuration, project-type detection, and placement rules. - `.agents/agents/sdk-consumer-setup.md` — generic agent spec for helping consuming repos adopt the SDK. diff --git a/README.md b/README.md index 6f5a4566..448f494c 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,7 @@ Generates [`ActivitySource`](https://learn.microsoft.com/en-us/dotnet/api/system Add to your `Directory.Build.props` or `.csproj` file: ```xml - + all analyzers @@ -145,7 +145,7 @@ public class EntityService(IEntityStoreTelemetry telemetry) ## Agent Skills -This repository ships with [Agent Skills](https://agentskills.io/specification) under `.agents/skills/` covering the source generator, its test framework, and the `Purview.DotNetProjectSdk` build SDK. See [`AGENTS.md`](AGENTS.md) — "Source-generator and testing skills" for the full list and when to load each one. +This repository ships with [Agent Skills](https://agentskills.io/specification) under `.agents/skills/` covering the source generator, its test framework, and the `Purview.BuildSdk` build SDK. See [`AGENTS.md`](AGENTS.md) — "Source-generator and testing skills" for the full list and when to load each one. ## Sample Project diff --git a/docs/release-process.md b/docs/release-process.md index 3752a1b0..271d5b00 100644 --- a/docs/release-process.md +++ b/docs/release-process.md @@ -70,8 +70,8 @@ Merging to `main` triggers `release.yml`, which runs the reusable `purview-relea ## Versioning -- The version lives in `package.json`. **Current Version:** 5.0.0-prerelease.8 -- It is applied to `Version` / `PackageVersion` by `Purview.DotNetProjectSdk` via package.json +- The version lives in `package.json`. **Current Version:** 5.0.0-prerelease.10 +- It is applied to `Version` / `PackageVersion` by `Purview.BuildSdk` via package.json version detection (`UsePackageJsonVersion`, default `true`). - `just version` prints the current version. - After bumping `package.json`, run `just update-version` to sync the version into docs/samples. diff --git a/docs/wiki/Contributing.md b/docs/wiki/Contributing.md index fd8df4b9..a357f5d9 100644 --- a/docs/wiki/Contributing.md +++ b/docs/wiki/Contributing.md @@ -6,7 +6,7 @@ Contributions are welcome! This page covers development setup, build commands, a - .NET 10 SDK (projects target `net10.0`; the source generator targets `netstandard2.0`) - [Bun](https://bun.sh) for the `package.json`/`.build/*.ts` scripts -- The `Purview.DotNetProjectSdk` MSBuild SDK (pinned in `global.json` under `msbuild-sdks`) +- The `Purview.BuildSdk` MSBuild SDK (pinned in `global.json` under `msbuild-sdks`) - `csharpier` dotnet tool (pinned in `.config/dotnet-tools.json`) for linting/formatting ## Clone and set up diff --git a/docs/wiki/Release-Flow.md b/docs/wiki/Release-Flow.md index 6efce155..11d968f3 100644 --- a/docs/wiki/Release-Flow.md +++ b/docs/wiki/Release-Flow.md @@ -28,7 +28,7 @@ Feature branch ## Versioning - The version lives in `package.json`. **Current Version:** 5.0.0-prerelease.8 -- It is applied to `Version`/`PackageVersion` by `Purview.DotNetProjectSdk` via package.json version detection. +- It is applied to `Version`/`PackageVersion` by `Purview.BuildSdk` via package.json version detection. - `just version` prints the current version. - After bumping `package.json`, run `just update-version` to sync the version into docs/samples. diff --git a/global.json b/global.json index ec26fcf9..5bb362b4 100644 --- a/global.json +++ b/global.json @@ -3,7 +3,7 @@ "allowPrerelease": false }, "msbuild-sdks": { - "Purview.DotNetProjectSdk": "1.0.0-prerelease.54" + "Purview.BuildSdk": "1.0.0-prerelease.56" }, "test": { "runner": "Microsoft.Testing.Platform" diff --git a/package.json b/package.json index d6baae5b..a9b0c579 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "purview-telemetry-sourcegenerator", - "version": "5.0.0-prerelease.9", + "version": "5.0.0-prerelease.10", "description": "Generates [`ActivitySource`](https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.activitysource), [`ILogger`](https://learn.microsoft.com/en-us/dotnet/api/microsoft.extensions.logging.ilogger), and [`Metrics`](https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.metrics) based on interface methods.", "readme": "README.md", "repository": { diff --git a/samples/Directory.Build.targets b/samples/Directory.Build.targets index a3bbd31a..ab681698 100644 --- a/samples/Directory.Build.targets +++ b/samples/Directory.Build.targets @@ -1,3 +1,3 @@ - + diff --git a/samples/SampleApp.Net48/Directory.Build.props b/samples/SampleApp.Net48/Directory.Build.props index f8fb6742..68c3353a 100644 --- a/samples/SampleApp.Net48/Directory.Build.props +++ b/samples/SampleApp.Net48/Directory.Build.props @@ -3,7 +3,7 @@ net48 SampleApp.Net48 @@ -25,5 +25,5 @@ $(NoWarn);CA1031;CA1303;CA1515;CA1812;CA2007;CA2201;CA5394;CS1574;CS8618;TSG3022; - + diff --git a/samples/SampleApp/Directory.Build.props b/samples/SampleApp/Directory.Build.props index 12d307a0..e681179d 100644 --- a/samples/SampleApp/Directory.Build.props +++ b/samples/SampleApp/Directory.Build.props @@ -2,7 +2,7 @@ SampleApp @@ -18,5 +18,5 @@ $(NoWarn);CA1031;CA1515;CA1724;CA2007;CA2201;TSG2008; - + diff --git a/src/Directory.Build.props b/src/Directory.Build.props index 67a1dbd9..7b0a595d 100644 --- a/src/Directory.Build.props +++ b/src/Directory.Build.props @@ -2,7 +2,7 @@ Purview.Telemetry true @@ -16,7 +16,7 @@ false - + preview diff --git a/src/Directory.Build.targets b/src/Directory.Build.targets index a3bbd31a..ab681698 100644 --- a/src/Directory.Build.targets +++ b/src/Directory.Build.targets @@ -1,3 +1,3 @@ - + diff --git a/src/src/SourceGenerator/SourceGenerator.csproj b/src/src/SourceGenerator/SourceGenerator.csproj index 512c50c8..fafe91d5 100644 --- a/src/src/SourceGenerator/SourceGenerator.csproj +++ b/src/src/SourceGenerator/SourceGenerator.csproj @@ -1,4 +1,4 @@ - + true true @@ -36,7 +36,7 @@