# fabricators .NET foundation Changelog

## v0.15.0 (2026-11-17)

### Release 0.15.0

- Add explicit same-identity OIDC reauthentication with fresh signed auth_time,
  opt-in provider capability and live product admission/completion ports. Add
  primary StepUp proofs and policy-admitted TOTP/passkey freshness renewal from
  existing sessions, preserving session families and rejecting assurance downgrade.
- Recheck current maximum authentication age when redeeming proofs. Require an
  explicit existing-session policy for stale-primary passkey/TOTP step-up; reject
  Local-kind DateTime in the legacy stored-UTC presentation helper instead of
  silently re-tagging wall-clock time.
- Supply explicit invariant process/JSON defaults, UTC instant normalization,
  offset-qualified timestamp input and strict JSON numbers. Keep business dates
  and presentation cultures explicit and separate from technical contracts.
- Add scoped locale/timezone negotiation and explicit display formatting without
  changing technical culture. Supply runtime app catalog ports and immutable,
  namespace/revision-bound composition with optional tenant overrides.
- Add shared one-based page, half-open positional range and cursor pagination
  contracts, endpoint policies, strict optional HTTP query parsing and bounded
  look-ahead result builders with optional long totals. Keep legacy PagedResult
  wire compatibility and the pure Kernel free of EF/ASP.NET dependencies.
- Document existing confirmation wire contracts versus IC's product-owned
  challenge enforcement, and assess combinable typed-resource confirmation and
  recent authentication without claiming a generic implementation.

- Generate and verify the full documentation bundle only in the macOS CI job,
  retaining it as a commit-bound workflow artifact. Keep documentation unit tests
  and installed-tool startup checks on Windows/Linux without repeated full exports.

## v0.16.0 (2026-11-17)

### Release 0.16.0

- Check optional diagnostic disclosure quietly against current product permissions,
  without authorization-failure noise on ordinary responses. Keep real endpoint
  denial logging and preserve application caching by omitting private diagnostic
  headers on cacheable/revalidating responses.
- Retain EF command failures and ASP.NET hosting errors, including startup
  exceptions. Keep successful SQL and raw request events suppressed by default;
  expose an explicit raw-request logging opt-in.
- Resolve parent-language overrides consistently, add recorded non-strict fallback
  and opt-in system-resolvable timezones, including canonical case-insensitive
  zone lookup. Malformed overrides remain invalid in either mode.
- Separate bounded template source/model/output/loop budgets and support larger
  digest models by default. Add all-or-nothing digest composition that splits
  model/output budget failures into numbered parts without sending or truncation.
- Preserve safe SMTP TLS/socket/protocol diagnostics through submission and
  connection verification, without raw server replies or credential-bearing
  inner exceptions. Subject cleanup remains a consumer responsibility.

## v0.17.0 (2026-11-17)

### Release 0.17.0

- Make trusted template rendering budgets independently configurable without the
  former fixed upper ceilings. Replace the fixed text/HTML body ceiling with
  exact MIME byte budgets for SMTP and Graph, optionally tightened per connection.
- Enforce SMTP's advertised SIZE before the envelope and Graph's write-request
  ceiling including Base64 expansion. Report MessageTooLarge with safe size
  metadata; never split, truncate, queue, retry or pace submissions automatically.
- Clarify that campaigns, consent/unsubscribe content, mailing lists, durable
  queues and pacing belong to consuming applications.

## v0.18.0 (2026-11-17)

### Release 0.18.0

- Add an opt-in module-facing shared DbContext factory and ordered immutable model
  compositions with revision/variant fingerprints and design-time-aware EF keys.
- Add independent presentation response-header/Vary controls and a trusted error
  response callback with sanitized metadata, preserving current defaults and strict
  malformed-input rejection. Preserve application headers when emission is disabled.
- Preserve explicit DateTimeOffset response offsets while keeping strict UTC-normalized
  input. Add an explicit UTC-only JSON output policy and document the unchanged UTC-kind
  requirement for DateTime output, including EF-loaded Unspecified values.
- Keep IC pagination parsing, normalization, defaults and HTTP mapping consumer-owned;
  no pagination contract changes or automatic request-zone conversion are introduced.

## v0.19.0 (2026-11-17)

### Release 0.19.0

- Add opt-in native OIDC challenges/token exchange with explicit per-client
  audience/authorized-party lists and raw/SHA-256-hex nonce policies. Reuse durable
  one-use intents and current product login/link/reauthentication completion.
- Add authenticated BFF transport with a fixed public origin/prefix, public
  callbacks and cookie-free native completion; retain strict web code flow.
- G-01: add explicit request-zone DateTimeOffset JSON output and a reusable strict
  converter. Preserve existing offset/UTC-only policies when not opted in.
- G-03: document authentication-before-presentation ordering and add an optional
  runtime guard. Anonymous hosts retain their existing middleware default.
- G-04 (improvement): separate timestamp and number configuration. Date-only
  adoption can preserve the consumer's existing quoted-number handling.
- G-05: expose HTTP-request presence, opt-in missing-request rejection and an
  ITimeZoneContext adapter over the same presentation snapshot. HTTP-zone JSON
  rejects missing request/middleware; jobs must explicitly select preferences.
- G-06: document EF UTC-kind mapping and DateTimeOffset response contracts;
  DateTime output validation and UTC-only DateTime serialization are unchanged.
- G-07: document private caching for user-derived preferences and cache keys based
  on the effective locale/timezone, rather than assuming Vary isolates users.
- G-08: explicit non-strict overrides now fall back for malformed values too,
  with safe debug logging and fallback flags. Strict defaults remain unchanged.
- Start package publication only after exact-commit main CI succeeds. Tag-first
  runs defer to CI completion without polling or holding a publishing runner.

## v0.10.0 (2026-11-16)

### Release 0.10.0

- Add personal user API tokens and confidential machine client credentials, distinct
  from interactive sessions and legacy consumer API keys.
- Add a bounded client-credentials exchange, scoped bearer authentication and current
  owner/parent admission, expiry and revocation through product-owned durable stores.
- Add per-credential IPv4/IPv6/CIDR policies enforced on exchange and every protected
  request, with explicit direct-socket or authenticated-BFF address provenance.
- Add credential/network/HTTP conformance and packaged-consumer checks; include
  cross-platform TLS and lifecycle fixture corrections from the preceding increment.

## v0.11.0 (2026-11-16)

### Release 0.11.0

- Separate fresh-session admission (`LoginRequiredAssurance`) from ongoing session
  and refresh policy, so enabling MFA can require stronger new logins while preserving
  already established sessions.
- Add explicit degraded recovery-session admission (`AllowRecoverySessions`), with
  sensitive-operation restrictions remaining the product's responsibility.
- Add PostgreSQL and policy tests for stronger new-login requirements, established
  session/refresh retention and explicitly authorized recovery assurance.

## v0.12.0 (2026-11-16)

### Release 0.12.0

- Add per-SMTP-connection strict, revocation-only relaxation and explicit insecure
  certificate policies for development/internal hosts. Required TLS remains in
  force; connected mail preserves the trusted profile's selection.
- Keep the .NET/EF baseline on 10 by product decision: SDK 10.0.404 and Microsoft
  libraries 10.0.15. Refresh stable dependency pins and lockfiles, including
  MailKit/MimeKit 5, Swashbuckle 11, OpenTelemetry 1.21 and CSharpier 1.4.
- Cache bounded parsed Scriban templates privately per process, with configurable
  capacity/lifetime and local stampede protection; isolate every rendering context.
- Cache approved-assembly handler/endpoint metadata with weak assembly keys and
  module ordering per composed host. Reject ambiguous handlers and invalid module
  names; keep raw exception messages and objects out of handler logs.
- Add `AddFoundationHandlers` for command and query handlers from approved
  assemblies, with optional validation and logging decorators for all three
  handler shapes. Validation failures are `ValidationError` entries of
  `ErrorType.Validation`. Repeated calls never decorate a handler twice.
- Add `IEndpoint`, `AddEndpoints(approvedAssemblies)` and `MapEndpoints()` to
  `Fabricators.Kernel.AspNetCore`; endpoints map onto the app or a route group.
- Add `ModuleOrder.Sort`, `AddModules` and `MapModules`: modules run in
  dependency order; an unknown or cyclic dependency or a duplicate module name
  fails startup.
- Add `IModuleModel` and `ModelBuilder.ApplyModuleModels` to
  `Fabricators.Infrastructure` so modules contribute to a shared EF model.

## v0.13.0 (2026-11-16)

### Release 0.13.0

- Capture response-start timing totals and phases from one monotonic instant
  before asynchronous disclosure checks. Require a separate opt-in for passwords
  or OAuth credentials on every unencrypted SMTP connection, including loopback.
- Add explicit trusted-relay plaintext SMTP, while keeping mandatory TLS defaults,
  and classify standalone SMTP failures without exposing raw MailKit replies.
- Add template-owned HTML escaping as an explicit rendering mode, named timing
  phases with policy-gated JSON adaptation, configurable OpenAPI routes/filter
  registration, classic worker observability and a configurable console sink.
- Keep legacy encrypted-record and template migrations product-owned; Foundation
  does not add legacy cryptographic profiles or decryption fallback.
- Add provider-neutral scoped secret protection and optional Data Protection/EF
  key-ring adapters. Require explicit persistence and certificate-protected keys
  by default, with retained certificates for planned rotation.
- Add SMTP connection verification without submitting mail, including a separate
  verification capability, runtime settings resolution and shared TLS/auth logic.
  Recheck connection authority before credential resolution and before network I/O.
- Enable NuGet package caching in Foundation CI and Publish; independent package
  consumers keep their isolated package caches and local freshly packed feed.

## v0.14.0 (2026-11-16)

### Release 0.14.0

- Add provider-neutral permission definitions/catalog, trusted actor/resource
  binding and current authorization ports, with optional ASP.NET requirements.
  Missing adapters and unknown capabilities deny; roles and assignments remain
  product-owned. Start with the Foundation diagnostic disclosure capability.
- Require explicit environment enablement and current permission through
  `UseFoundationRequestDiagnostics`. Disable implicit Development timing in the
  low-level middleware and mark disclosed timing responses as non-cacheable.
- Require successful main CI for the exact tagged commit before publication.
  Publish now restores/builds/packs without repeating formatting, tests or
  independent consumer checks; manual runs also require a matching release tag.

## v0.9.0 (2026-11-16)

### Release 0.9.0

- Add an optional maintained OIDC code-flow bridge and Google, Apple and explicit
  Microsoft directory profiles, without product users, linking or automatic sessions.
- Require durable, browser-bound one-use intents and product-owned completion;
  discard provider tokens and keep OIDC identity separate from local MFA assurance.
- Add short-lived Apple ES256 client-secret signing from runtime-owned keys.
- Add controlled HTTPS discovery/token/signature and adversarial callback fixtures.

## v0.6.0 (2026-11-15)

### Release 0.6.0

- Add optional cache, observability, HTTP/EF timing, OpenAPI, realtime, cron,
  SMTP, templating and validation adapters with provider-neutral application ports.
- Preserve the Infrastructure cache facade and move its implementation into an
  EF-free adapter. Keep existing Kernel/Application dependency boundaries.
- Add progressive typed MCP discovery/calling, mandatory host authority contracts
  and authenticated stateless HTTP. Package a separate readonly developer-docs MCP.
- Add a selected StyleCop authoring profile, formatter templates and a reusable
  Roslyn layout-check tool for first-party and third-party app developers.
- Centralize the target framework, enable transitive version pinning, lock restores
  and verify actual NuGet consumers/tools in the shared CI/release gate.
- Pin the SMTP dependency's PKCS transitive package to patched 10.0.14.

## v0.7.0 (2026-11-15)

### Release 0.7.0

- Add optional strong-authentication orchestration, native ASP.NET Core WebAuthn,
  TOTP, recovery codes, assurance and separate EF persistence configurations.
- Keep authority, policy, admission limits, key management and migrations explicit
  host responsibilities. No method is enabled by default.
- Add opaque interactive sessions for browser/PWA and Capacitor iOS/Android,
  atomic proof exchange and refresh, bounded retry recovery, current policy/epoch
  validation, per-device/global revocation and idempotent security-event invalidation.
- Add protected cookie/CSRF and native bearer/binding transports, explicit CORS
  and app-association metadata with approved Android signing-certificate origins.
- Verify real SQLite/PostgreSQL concurrency, audit rollback and populated-schema
  upgrades; add a PostgreSQL CI service job and SDK-only test orchestration.
- Clean unused imports and enforce IDE0005 in source and installed authoring
  consumer checks without requiring XML documentation on every public symbol.
- Add headless documentation contracts and a .NET export tool. Prepare foundation's
  own authored guides, compiled public API reference, navigation/search, source
  examples, JSON authoring schema and agent discovery index before any frontend.
- Use Cloudflare, Stripe and rfw as content/experience references; defer the visual
  renderer, ERP app composition and OpenAPI imports to separate integrations.
- Extend verification with transactional authentication/replay tests, native
  software WebAuthn fixtures and independently installed documentation tooling.

## v0.7.1 (2026-11-15)

### Release 0.7.1

- Preserve established sessions during routine factor enrollment/removal and
  recovery-code regeneration. Fence pending challenges/completions with a separate
  credential revision; global factor-change revocation is an explicit host policy.
- Add authenticated other-session revocation, preserving the caller's family and
  refresh credentials while fencing pending proofs. Enforce host-selected
  assurance, freshness and individual/other/global revocation permissions.
- Add opt-in encrypted login information: observed user agent/server-resolved IP,
  client device/version labels and consent-declared, unverified GPS coordinates.
  No capture is enabled by default and none of these fields establish identity.
- Add an additive nullable metadata mapping with EF-generated populated 0.7.0
  upgrade/rollback tests. Existing live sessions remain usable after migration.

## v0.8.0 (2026-11-15)

### Release 0.8.0

- Add provider-neutral mail connections, runtime token leases and future mailbox
  reading contracts without a reader, synchronization worker or attachment fetch.
- Add shared MIME/dispatch and a separate scoped Microsoft Graph adapter; retain
  legacy SMTP APIs and add connected SMTP password/XOAUTH2 with current admission.
- Add optional Cc/Bcc/reply/thread data without changing existing constructors;
  redact mail/token state and classify uncertain sends without automatic retries.
- Add loopback HTTP/SMTP conformance and independent packaged-consumer coverage.

## v0.4.0 (2026-11-05)

### Release 0.4.0

- Require .NET 10; update the SDK, Microsoft libraries, FusionCache and test tooling to stable releases.
- Add an enforcing antiforgery gate for JSON writes, anonymous endpoint opt-in and reviewed opt-out.
  Cover inline/fallback authorization policies and identity-bound token re-minting in integration tests.
- Add authenticated BFF visitor-IP resolution with configurable protocol headers, startup validation,
  proof-header removal and no implicit trust in Cloudflare or X-Forwarded-For headers.
- Make API-key rate limiting use the same resolved address and IPv6 /64 partitioning.
  The legacy boolean overload remains source-compatible but no longer trusts raw Cloudflare headers.
- Cap `Email` input at 320 characters and match it with a non-backtracking generated regex,
  so pathological input can no longer stall validation.
- Document consumer middleware order, BFF obligations and incremental adoption in Platform/live-studio.

This is a breaking consumer upgrade from 0.3.x. Consumers must target .NET 10, recompile,
configure the BFF trust boundary and explicitly wire the new middleware. Package publication
and consumer deployment are separate steps; changing this source does not update Platform.

## v0.5.0 (2026-11-05)

### Release 0.5.0

- Add `FieldValidationError`, `RetryAfterError`, `LimitExceededError` and `ImpersonationRefusedError` as kernel
  error subtypes, declared on `Error` so they serialize without `ErrorPolymorphism.Register`.
  Their wire shape matches influencer.camp's (same members, codes and descriptions).
- Answer `RetryAfterError` with 429 and a `Retry-After` header from `ToApiResult`.
- Add `Slug` and `ItalianTaxIds` validators in `Fabricators.Kernel.Validation`: kebab-case slugs, codice fiscale
  shape and check character, partita IVA check digit. Length is checked before a non-backtracking generated regex.
