chore: prepare 1.0.0-rc.1

Author: rodri-oliveira-dev

CHANGELOG.md

@@ -2,10 +2,29 @@
 
 ## Unreleased
 
-- Stabilizes the public API contract for the 1.0 candidate without adding new
-  public APIs.
-- Resets scalar `SqlParameter` metadata that is not declared by the current
-  `TypedSqlParameter` when reusing an existing provider parameter.
+## 1.0.0-rc.1
+
+- Prepares the first release candidate for the frozen 1.0 public API contract.
+- Keeps the RC feature-complete without adding new public APIs after the freeze.
+- Supports explicit SQL Server scalar parameters for strings, numeric values,
+  binary values, identifiers, and temporal values.
+- Supports scalar output and input/output parameters through `AsOutput()`,
+  `AsInputOutput()`, `OutputValue`, and `GetValue<T>()`.
+- Supports table-valued parameters through `SqlParam.TableValued(...)` with
+  explicit `TypeName` and caller-provided `DataTable`.
+- Provides equivalent package assets and public API for `net8.0` and `net10.0`.
+- Keeps package identity `TypedParameters.Dapper.SqlServer` separate from
+  assembly and namespace identity `Dapper.TypedParameters.SqlServer`.
+- Maintains package quality checks for contents, symbols, SourceLink, public
+  API baselines, SDK package validation, local package consumption, public
+  preview consumption, and vulnerability auditing.
+- Uses `0.1.0-preview.1` as the SDK package validation baseline for binary and
+  public API compatibility.
+- Stabilizes scalar provider-parameter reuse before the RC by resetting
+  undeclared `Size`, `Precision`, and `Scale` metadata to provider defaults
+  when reusing an existing `SqlParameter`.
+
+This is a release candidate and is not the stable `1.0.0` release.
 
 ## 0.1.0-preview.1
 
@@ -17,13 +36,17 @@
 - Adiciona versoes em portugues brasileiro para os guias e exemplos linkados
   pelo README.
 - Adiciona parametros SQL Server numericos e booleanos explicitos para Dapper.
-- Inclui `bit`, `tinyint`, `smallint`, `int`, `bigint`, `real`, `float`, `decimal`, `money` e `smallmoney`.
+- Inclui `bit`, `tinyint`, `smallint`, `int`, `bigint`, `real`, `float`,
+  `decimal`, `money` e `smallmoney`.
 - Configura `Precision` e `Scale` declarados para `decimal`.
-- Adiciona parametros `uniqueidentifier`, `binary`, `varbinary` e `varbinary(max)`.
-- Preserva arrays binarios vazios e converte somente `null` para `DBNull.Value`.
+- Adiciona parametros `uniqueidentifier`, `binary`, `varbinary` e
+  `varbinary(max)`.
+- Preserva arrays binarios vazios e converte somente `null` para
+  `DBNull.Value`.
 - Adiciona parametros SQL Server temporais para `date`, `time`, `datetime`,
   `smalldatetime`, `datetime2` e `datetimeoffset`.
-- Adiciona suporte fluente a `Output` e `InputOutput` para parametros escalares.
+- Adiciona suporte fluente a `Output` e `InputOutput` para parametros
+  escalares.
 - Adiciona leitura de outputs por `OutputValue` e `GetValue<T>()`.
 - Normaliza output `DBNull.Value` para `null` e rejeita casts incompativeis sem
   conversao silenciosa.

README.md

@@ -7,6 +7,32 @@ parameters for Dapper using `Microsoft.Data.SqlClient`. It helps callers declare
 the SQL Server parameter metadata sent to the provider, such as type, size,
 precision, scale, direction, and table-valued parameter type name.
 
+## Release status
+
+Current stable:
+
+```text
+None yet
+```
+
+Current release candidate:
+
+```text
+None published yet
+```
+
+Upcoming release candidate:
+
+```text
+1.0.0-rc.1
+```
+
+Current public preview:
+
+```text
+0.1.0-preview.1
+```
+
 ## Why?
 
 Dapper makes parameter passing convenient:
@@ -107,17 +133,23 @@ explicit correspondence with the schema, not preference for a specific SQL type.
 
 ## Installation
 
-Install from NuGet.org after the package is published:
+Install the current public preview from NuGet.org:
 
 ```bash
 dotnet add package TypedParameters.Dapper.SqlServer --version 0.1.0-preview.1
 ```
 
+After the release workflow publishes the upcoming RC, install it with:
+
+```bash
+dotnet add package TypedParameters.Dapper.SqlServer --version 1.0.0-rc.1
+```
+
 To test an unreleased local build from this repository:
 
 ```bash
 dotnet pack src/Dapper.TypedParameters.SqlServer/Dapper.TypedParameters.SqlServer.csproj --configuration Release --output ./artifacts/packages
-dotnet add package TypedParameters.Dapper.SqlServer --version 0.1.0-preview.1 --source ./artifacts/packages
+dotnet add package TypedParameters.Dapper.SqlServer --version 1.0.0-rc.1 --source ./artifacts/packages
 ```
 
 NuGet package ID:

README.pt-BR.md

@@ -7,6 +7,32 @@ tipados para Dapper usando `Microsoft.Data.SqlClient`. A biblioteca ajuda o
 chamador a declarar os metadados do parâmetro enviados ao provider, como tipo,
 tamanho, precisão, escala, direção e nome de tipo para table-valued parameters.
 
+## Status de release
+
+Stable atual:
+
+```text
+Nenhum ainda
+```
+
+Release candidate atual:
+
+```text
+Nenhum publicado ainda
+```
+
+Proximo release candidate:
+
+```text
+1.0.0-rc.1
+```
+
+Preview publico atual:
+
+```text
+0.1.0-preview.1
+```
+
 ## Por quê?
 
 Dapper torna o envio de parâmetros conveniente:
@@ -108,17 +134,23 @@ específico.
 
 ## Instalação
 
-Instale pelo NuGet.org depois que o pacote for publicado:
+Instale o preview publico atual pelo NuGet.org:
 
 ```bash
 dotnet add package TypedParameters.Dapper.SqlServer --version 0.1.0-preview.1
 ```
 
+Depois que o workflow de release publicar o proximo RC, instale com:
+
+```bash
+dotnet add package TypedParameters.Dapper.SqlServer --version 1.0.0-rc.1
+```
+
 Para testar uma build local ainda não publicada a partir deste repositório:
 
 ```bash
 dotnet pack src/Dapper.TypedParameters.SqlServer/Dapper.TypedParameters.SqlServer.csproj --configuration Release --output ./artifacts/packages
-dotnet add package TypedParameters.Dapper.SqlServer --version 0.1.0-preview.1 --source ./artifacts/packages
+dotnet add package TypedParameters.Dapper.SqlServer --version 1.0.0-rc.1 --source ./artifacts/packages
 ```
 
 Package ID NuGet:

docs/sdd/stable-1.0/DECISIONS.md

@@ -23,10 +23,16 @@
     rules.
 12. Scalar provider-parameter reuse: declared scalar metadata is applied and
     undeclared scalar metadata is reset to provider default `0`.
+13. First release candidate version: `1.0.0-rc.1`.
+14. SDK package validation baseline: `0.1.0-preview.1` is used as the hard
+    binary and public API compatibility baseline for the RC. The behavioral
+    scalar metadata reset from Prompt 018 is documented as an intentional
+    pre-1.0 stabilization adjustment, not hidden by a suppression.
 
 ## Pending
 
-- RC release rehearsal for Prompt 019.
+- External RC release, including merge, tag, rehearsal, publication, and public
+  consumption validation.
 - Stable release readiness for Prompt 020.
 
 ## Public API Freeze

docs/sdd/stable-1.0/README.md

@@ -15,8 +15,8 @@ memoria de conversas anteriores:
 
 1. `017-public-nuget-consumption`
 2. `018-public-api-freeze`
-3. `019-rc-release-rehearsal`
-4. `020-stable-release-readiness`
+3. `019-rc1-preparation`
+4. `020-stable-preparation`
 
 Os Prompts 17, 18 e 19 usam a branch:
 

docs/sdd/stable-1.0/STATUS.md

@@ -1,4 +1,6 @@
-Last completed prompt: 018
+Last completed prompt: 019
+
+Current prompt: None
 
 Current status: Completed
 
@@ -11,11 +13,20 @@ APPROVED
 Feature freeze:
 Active
 
+RC readiness:
+READY FOR 1.0.0-RC.1
+
+RC version:
+1.0.0-rc.1
+
 Last expected commit:
-refactor: stabilize public API for 1.0
+chore: prepare 1.0.0-rc.1
+
+Next action:
+Human review, merge, tag, rehearsal and RC publication
 
 Next prompt:
-019-rc1-preparation
+020-stable-preparation
 
 Preview public consumption:
 Passed