TypeSpec Assessment

Publish 2026-06-01 and preserve delete parameter ordering

TypeSpec source diff: 9eb0993333857ef0ffb2863ccc76f8b123cae90b → 22bc88578fb1f253688e8a5bf127ef3a4502745a

Preview NoticeThe TypeSpec Assessment Assistant is in preview; official validation and review remain the source of truth.

The TypeSpec Assessment Assistant is currently in preview. Its goal is to help service developers build confidence earlier in the TypeSpec authoring workflow by providing contextual analysis, risk identification, and guidance on potential downstream impacts.

This report is intended as a review reference and learning aid only. It does not replace official ARM API, Azure API Stewardship, Azure Breaking Change reviews, and should not be treated as authoritative review feedback or approval for specification changes. Official validation tools, generated artifacts, and reviewer feedback remain the source of truth for merge and release decisions.

Semantic intents

Impact links are visible at a glance; expand for changed TypeSpec source, followed by affected operations.

Publish 2026-06-01 and preserve delete parameter orderingAdds the stable 2026-06-01 API version and a customized New Relic monitor delete declaration that preserves Go SDK parameter ordering; the version propagates across 35 affected operations without detected REST or downstream contract changes.
modify
Changed TypeSpec source (2)
specification/newrelic/NewRelicObservability.Management/client.tsp
 using Azure.ClientGenerator.Core;
 using Azure.ClientGenerator.Core.Legacy;
 using Azure.Core;
+using Azure.ResourceManager;
 using Azure.ResourceManager.Foundations;
+using TypeSpec.Http;
 using NewRelic.Observability;
 
 @@clientName(
specification/newrelic/NewRelicObservability.Management/client.tsp
 @@usage(AccountProperties, Usage.input | Usage.output, "csharp");
 @@usage(OrganizationProperties, Usage.input | Usage.output, "csharp");
 @@usage(PlanDataProperties, Usage.input | Usage.output, "csharp");
+
+// ===== Go delete parameter reorder =====
+// Reorder the delete method parameters for the Go SDK to keep backward compatibility.
+/**
+ * Deletes an existing New Relic monitor resource from your Azure subscription, removing the integration and stopping the observability of your Azure resources through New Relic
+ */
+#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-operation" "Override to reorder parameters for the Go SDK"
+op newRelicMonitorResourceDelete(
+  ...ApiVersionParameter,
+  ...SubscriptionIdParameter,
+  ...ResourceGroupParameter,
+  ...Azure.ResourceManager.Legacy.Provider,
+
+  /**
+   * User Email.
+   */
+  @query("userEmail")
+  userEmail: string,
+
+  /**
+   * Name of the Monitors resource.
+   */
+  @path
+  monitorName: string,
+): void;
+
+@@override(
+  NewRelicMonitorResources.delete,
+  newRelicMonitorResourceDelete,
+  "go"
+);
specification/newrelic/NewRelicObservability.Management/main.tsp
    * The 2025-05-01-preview API version.
    */
   v2025_05_01_preview: "2025-05-01-preview",
+
+  /**
+   * The 2026-06-01 API version.
+   */
+  v2026_06_01: "2026-06-01",
 }
 
 interface Operations extends Azure.ResourceManager.Operations {}

specification/newrelic/NewRelicObservability.Management/client.tsp:327, specification/newrelic/NewRelicObservability.Management/main.tsp:35

Affected operations (35)

Showing 10 operation cards; the remaining 25 are listed below.

Accounts_ListGET/subscriptions/{subscriptionId}/providers/NewRelic.Observability/accounts2026-06-01

HTTP signature and represented payload contract unchanged.

BillingInfo_GetPOST/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/getBillingInfo2026-06-01

HTTP signature and represented payload contract unchanged.

ConnectedPartnerResources_ListPOST/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/listConnectedPartnerResources2026-06-01

HTTP signature and represented payload contract unchanged.

MonitoredSubscriptions_CreateOrUpdatePUT/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/monitoredSubscriptions/{configurationName}2026-06-01

HTTP signature and represented payload contract unchanged.

MonitoredSubscriptions_DeleteDELETE/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/monitoredSubscriptions/{configurationName}2026-06-01

HTTP signature and represented payload contract unchanged.

MonitoredSubscriptions_GetGET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/monitoredSubscriptions/{configurationName}2026-06-01

HTTP signature and represented payload contract unchanged.

MonitoredSubscriptions_ListGET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/monitoredSubscriptions2026-06-01

HTTP signature and represented payload contract unchanged.

MonitoredSubscriptions_UpdatePATCH/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/monitoredSubscriptions/{configurationName}2026-06-01

HTTP signature and represented payload contract unchanged.

Monitors_CreateOrUpdatePUT/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}2026-06-01

HTTP signature and represented payload contract unchanged.

Monitors_DeleteDELETE/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}2026-06-01

HTTP signature and represented payload contract unchanged.

Other affected operations (25)

Monitors_Get (GET, 2026-06-01); Monitors_GetMetricRules (POST, 2026-06-01); Monitors_GetMetricStatus (POST, 2026-06-01); Monitors_LatestLinkedSaaS (POST, 2026-06-01); Monitors_LinkSaaS (POST, 2026-06-01); Monitors_ListAppServices (POST, 2026-06-01); Monitors_ListByResourceGroup (GET, 2026-06-01); Monitors_ListBySubscription (GET, 2026-06-01); Monitors_ListHosts (POST, 2026-06-01); Monitors_ListLinkedResources (POST, 2026-06-01); Monitors_ListMonitoredResources (POST, 2026-06-01); Monitors_RefreshIngestionKey (POST, 2026-06-01); Monitors_Resubscribe (POST, 2026-06-01); Monitors_SwitchBilling (POST, 2026-06-01); Monitors_Update (PATCH, 2026-06-01); Monitors_VmHostPayload (POST, 2026-06-01); Operations_List (GET, 2026-06-01); Organizations_List (GET, 2026-06-01); Plans_List (GET, 2026-06-01); SaaS_ActivateResource (POST, 2026-06-01); TagRules_CreateOrUpdate (PUT, 2026-06-01); TagRules_Delete (DELETE, 2026-06-01); TagRules_Get (GET, 2026-06-01); TagRules_ListByNewRelicMonitorResource (GET, 2026-06-01); TagRules_Update (PATCH, 2026-06-01).

Azure Guidelines

Findings and affected intents at a glance; expand for expected guidance and actual changes.

1 of 1 semantic intents assessed · 4 documents selected

No Azure Guidelines findings.

REST breaking changes

Operation impact and affected intents at a glance; expand for before/after evidence.

No confirmed REST breaking changes.

Downstream breaking changes

Method impact and affected intents at a glance; expand for before/after evidence.

No downstream breaking changes detected.

Documentation Completeness

Checks only whether newly added operation, model, enum, and interface declarations have a nonempty effective TypeSpec description.

0 findings · 1 declaration checked

Appendix

Potential limits

None

Projects and compiler status

ProjectModeBaseline commit@versionTarget commit@versionBaseline AutoRest / TCGCTarget AutoRest / TCGC
specification/newrelic/NewRelicObservability.Managementnew-api-version22bc88578fb1f253688e8a5bf127ef3a4502745a@2025-05-01-preview
current · previous-latest-preview
22bc88578fb1f253688e8a5bf127ef3a4502745a@2026-06-01
current · newest-added-version
succeeded / succeededsucceeded / succeeded

Pull request: Not available for this local pre-PR assessment.

Guidance fetched

Guidance coverage and retrieval evidence
{
  "status": "passed",
  "coverage": {
    "semanticIntentCount": 1,
    "assessedIntentCount": 1,
    "selectedDocumentCount": 4,
    "unassessedIntentIds": []
  },
  "sharedSearch": {
    "catalogRanking": [
      {
        "rank": 1,
        "catalogOrder": 1,
        "title": "Evolving APIs",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/versioning/06-evolving-apis/",
        "score": {
          "exactSymbol": 4,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 10
        },
        "selectionRationale": "Directly covers evolving versioned operations and properties without breaking clients."
      },
      {
        "rank": 2,
        "catalogOrder": 2,
        "title": "Versioning overview",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/versioning/01-about-versioning/",
        "score": {
          "exactSymbol": 4,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 10
        },
        "selectionRationale": "Directly covers API-version enum ordering and preview-to-stable version context."
      },
      {
        "rank": 3,
        "catalogOrder": 30,
        "title": "Directives",
        "canonicalUrl": "https://typespec.io/docs/language-basics/directives/",
        "score": {
          "exactSymbol": 4,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 10
        },
        "selectionRationale": "Directly covers the added #suppress directive, warning category, and justification."
      },
      {
        "rank": 4,
        "catalogOrder": 22,
        "title": "Enums",
        "canonicalUrl": "https://typespec.io/docs/language-basics/enums/",
        "score": {
          "exactSymbol": 4,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 9
        },
        "selectionRationale": "Directly covers the changed Versions enum and its string-valued member."
      },
      {
        "rank": 5,
        "catalogOrder": 13,
        "title": "Azure.ResourceManager interface reference",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/reference/interfaces/",
        "score": {
          "exactSymbol": 4,
          "patternCategory": 3,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 7
        },
        "selectionRationale": "Names the imported Azure.ResourceManager construct and operation-interface category, but not the declared service plane."
      },
      {
        "rank": 6,
        "catalogOrder": 4,
        "title": "Add stable after preview",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/versioning/03-stable-after-preview/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 6
        },
        "selectionRationale": "Matches the stable-after-preview transition, without naming a changed symbol."
      },
      {
        "rank": 7,
        "catalogOrder": 14,
        "title": "TypeSpec.Rest decorators",
        "canonicalUrl": "https://typespec.io/docs/libraries/rest/reference/decorators/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 6
        },
        "selectionRationale": "Decorator guidance can apply to a modified data-plane operation, without naming an exact changed decorator."
      },
      {
        "rank": 8,
        "catalogOrder": 21,
        "title": "Models",
        "canonicalUrl": "https://typespec.io/docs/language-basics/models/",
        "score": {
          "exactSymbol": 4,
          "patternCategory": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 6
        },
        "selectionRationale": "Names model properties, including changed properties, and applies to data-plane services."
      },
      {
        "rank": 9,
        "catalogOrder": 24,
        "title": "Decorators",
        "canonicalUrl": "https://typespec.io/docs/language-basics/decorators/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 6
        },
        "selectionRationale": "Covers the decorator category used by the modified data-plane operation."
      },
      {
        "rank": 10,
        "catalogOrder": 25,
        "title": "Built-in decorators",
        "canonicalUrl": "https://typespec.io/docs/standard-library/built-in-decorators/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 6
        },
        "selectionRationale": "Covers the decorator category used in a modified data-plane declaration, without an exact listed decorator match."
      },
      {
        "rank": 11,
        "catalogOrder": 3,
        "title": "Add preview after preview",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/versioning/02-preview-after-preview/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 5
        },
        "selectionRationale": "Versioning guidance applies, but the change adds stable after preview rather than preview after preview."
      },
      {
        "rank": 12,
        "catalogOrder": 5,
        "title": "Add preview after stable",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/versioning/04-preview-after-stable/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 5
        },
        "selectionRationale": "Versioning guidance applies, but its transition does not match this stable-after-preview change."
      },
      {
        "rank": 13,
        "catalogOrder": 6,
        "title": "Add stable after stable",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/versioning/05-stable-after-stable/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 5
        },
        "selectionRationale": "Versioning guidance applies, but its transition does not match this stable-after-preview change."
      },
      {
        "rank": 14,
        "catalogOrder": 26,
        "title": "OpenAPI decorators",
        "canonicalUrl": "https://typespec.io/docs/libraries/openapi/reference/decorators/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 5
        },
        "selectionRationale": "The decorator category and service plane match, but no OpenAPI decorator is changed."
      },
      {
        "rank": 15,
        "catalogOrder": 31,
        "title": "Azure Core `no-openapi` rule",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-openapi/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 5
        },
        "selectionRationale": "Warning guidance and service plane match, but the changed suppression targets a different diagnostic."
      },
      {
        "rank": 16,
        "catalogOrder": 12,
        "title": "ARM resource operations",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/arm/resource-operations/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 0,
          "changeContext": 1,
          "total": 4
        },
        "selectionRationale": "The operation category and modified delete operation match, but the request is classified data-plane."
      },
      {
        "rank": 17,
        "catalogOrder": 15,
        "title": "Azure.ResourceManager decorators",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/reference/decorators/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 0,
          "changeContext": 1,
          "total": 4
        },
        "selectionRationale": "Decorator guidance matches the operation change, but not the declared data-plane service kind."
      },
      {
        "rank": 18,
        "catalogOrder": 20,
        "title": "ARM common types",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/arm/add-common-types/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 0,
          "changeContext": 1,
          "total": 4
        },
        "selectionRationale": "The enum/version context partially matches, but this ARM common-type guidance does not match the declared service plane."
      },
      {
        "rank": 19,
        "catalogOrder": 27,
        "title": "Change provider namespace",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/arm/change-provider-namespace/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 3
        },
        "selectionRationale": "The decorator category matches, but no provider-namespace change is present and the request is data-plane."
      },
      {
        "rank": 20,
        "catalogOrder": 17,
        "title": "Azure.Core long-running operations",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/azure-core/long-running-operations/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document applies to data-plane services, but no LRO construct is changed."
      },
      {
        "rank": 21,
        "catalogOrder": 19,
        "title": "TypeSpec pagination",
        "canonicalUrl": "https://typespec.io/docs/standard-library/pagination/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document applies to data-plane services, but no paging construct is changed."
      },
      {
        "rank": 22,
        "catalogOrder": 23,
        "title": "Scalars",
        "canonicalUrl": "https://typespec.io/docs/language-basics/scalars/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document applies to data-plane services, but no scalar declaration is changed."
      },
      {
        "rank": 23,
        "catalogOrder": 29,
        "title": "Content negotiation",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/azure-core/content-negotiation/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document applies to data-plane services, but no content-negotiation construct is changed."
      },
      {
        "rank": 24,
        "catalogOrder": 7,
        "title": "ARM resource types and modeling",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/arm/resource-type/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No resource-type addition is present in the bounded intent and the request is classified data-plane."
      },
      {
        "rank": 25,
        "catalogOrder": 8,
        "title": "Specific extension resource sample",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/samples/resource-manager/resource-types/specific-extension/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No extension-resource construct is present in the bounded intent."
      },
      {
        "rank": 26,
        "catalogOrder": 9,
        "title": "Private endpoints",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/arm/private-endpoints/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No private-endpoint construct is present in the bounded intent."
      },
      {
        "rank": 27,
        "catalogOrder": 10,
        "title": "Private links",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/arm/private-links/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No private-link construct is present in the bounded intent."
      },
      {
        "rank": 28,
        "catalogOrder": 11,
        "title": "Network security perimeter",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/arm/network-security-perimeter/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No network-security-perimeter construct is present in the bounded intent."
      },
      {
        "rank": 29,
        "catalogOrder": 16,
        "title": "ARM long-running operations",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/arm/long-running-operations/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No LRO construct is changed and this ARM document does not match the declared service plane."
      },
      {
        "rank": 30,
        "catalogOrder": 18,
        "title": "Azure.ResourceManager data types",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/reference/data-types/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No ARM paging parameter is changed and the request is classified data-plane."
      },
      {
        "rank": 31,
        "catalogOrder": 28,
        "title": "Azure Portal default experiences",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/azure-portal/default-experiences/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No Azure Portal experience customization is present."
      }
    ],
    "documents": [
      {
        "rank": 1,
        "catalogOrder": 1,
        "title": "Evolving APIs",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/versioning/06-evolving-apis/",
        "score": {
          "exactSymbol": 4,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 10
        },
        "selectionRationale": "Directly covers evolving versioned operations and properties without breaking clients.",
        "guidance": [
          {
            "section": "Evolving APIs",
            "excerpt": "Versioning allows you to evolve your API without breaking existing clients. By using versioning decorators, you can specify when resources, operations, or properties are added, removed, or changed.",
            "queryTerms": [
              "Versions",
              "operation",
              "property",
              "apiVersion"
            ],
            "examples": [],
            "applicableDeclarationIds": [
              "declaration-16aa53d84a772d98",
              "declaration-920bf5e773d8b500",
              "declaration-c8cb740c4b547ab5",
              "declaration-eae2f0259e77398d"
            ]
          },
          {
            "section": "Adding new types or members",
            "excerpt": "You can add new models, properties, or operations in a specific version and all subsequent versions using the @added decorator.",
            "queryTerms": [
              "Versions",
              "@added",
              "operation",
              "property"
            ],
            "examples": [
              "The version argument is the version where the element is introduced; the element is present in that version and all later versions."
            ],
            "applicableDeclarationIds": [
              "declaration-16aa53d84a772d98",
              "declaration-920bf5e773d8b500",
              "declaration-c8cb740c4b547ab5",
              "declaration-eae2f0259e77398d"
            ]
          }
        ],
        "noRelevantGuidance": false,
        "retrievedAt": "2026-09-17T11:48:28.170Z",
        "contentHash": "sha256:0f8a73dbe3bc6432b73f5408468b9a2e2001610b0f5bb73c7f0089e554dcb255"
      },
      {
        "rank": 2,
        "catalogOrder": 2,
        "title": "Versioning overview",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/versioning/01-about-versioning/",
        "score": {
          "exactSymbol": 4,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 10
        },
        "selectionRationale": "Directly covers API-version enum ordering and preview-to-stable version context.",
        "guidance": [
          {
            "section": "API versioning overview",
            "excerpt": "Specs should only have a single active preview in TypeSpec at any point during the spec development process.",
            "queryTerms": [
              "Versions",
              "preview",
              "api-version"
            ],
            "examples": [],
            "applicableDeclarationIds": [
              "declaration-16aa53d84a772d98",
              "declaration-920bf5e773d8b500",
              "declaration-c8cb740c4b547ab5",
              "declaration-eae2f0259e77398d"
            ]
          },
          {
            "section": "Version progression",
            "excerpt": "Every api-version uses a unique YYYY-MM-DD date and versions are declared in strictly increasing chronological order from top to bottom of the Versions enum.",
            "queryTerms": [
              "Versions",
              "apiVersion",
              "2026-06-01"
            ],
            "examples": [],
            "applicableDeclarationIds": [
              "declaration-16aa53d84a772d98",
              "declaration-920bf5e773d8b500",
              "declaration-c8cb740c4b547ab5",
              "declaration-eae2f0259e77398d"
            ]
          }
        ],
        "noRelevantGuidance": false,
        "retrievedAt": "2026-09-17T11:48:28.170Z",
        "contentHash": "sha256:68d83892fb24b2c26d9890a6d770a77d8947810a1c6441fad4abeafd1ff73e69"
      },
      {
        "rank": 3,
        "catalogOrder": 30,
        "title": "Directives",
        "canonicalUrl": "https://typespec.io/docs/language-basics/directives/",
        "score": {
          "exactSymbol": 4,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 10
        },
        "selectionRationale": "Directly covers the added #suppress directive, warning category, and justification.",
        "guidance": [
          {
            "section": "Suppress directive",
            "excerpt": "Suppress directive allows suppressing a specific warning diagnostic. It takes 2 arguments: the diagnostic code to suppress and a message to justify the suppression.",
            "queryTerms": [
              "#suppress",
              "arm-resource-operation",
              "justification"
            ],
            "examples": [
              "#suppress \"deprecated\" \"We are not ready to migrate yet\""
            ],
            "applicableDeclarationIds": [
              "declaration-16aa53d84a772d98",
              "declaration-920bf5e773d8b500",
              "declaration-c8cb740c4b547ab5",
              "declaration-eae2f0259e77398d"
            ]
          }
        ],
        "noRelevantGuidance": false,
        "retrievedAt": "2026-09-17T11:48:28.170Z",
        "contentHash": "sha256:011e159471cf61d6654ab60f04b91084d2051e7878bb49b98b9c628884165688"
      },
      {
        "rank": 4,
        "catalogOrder": 22,
        "title": "Enums",
        "canonicalUrl": "https://typespec.io/docs/language-basics/enums/",
        "score": {
          "exactSymbol": 4,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 9
        },
        "selectionRationale": "Directly covers the changed Versions enum and its string-valued member.",
        "guidance": [
          {
            "section": "Enums",
            "excerpt": "You can assign custom values to enum members using the : operator.",
            "queryTerms": [
              "Versions",
              "enum",
              "2026-06-01"
            ],
            "examples": [
              "Enum members can be identifier TypeSpecs or string literals."
            ],
            "applicableDeclarationIds": [
              "declaration-16aa53d84a772d98",
              "declaration-920bf5e773d8b500",
              "declaration-c8cb740c4b547ab5",
              "declaration-eae2f0259e77398d"
            ]
          }
        ],
        "noRelevantGuidance": false,
        "retrievedAt": "2026-09-17T11:48:28.170Z",
        "contentHash": "sha256:15fe2284dc51ef27104d65be365edbe7142d468ae40f6038bbf045844e784ad5"
      }
    ]
  },
  "intentAssessments": [
    {
      "semanticIntentId": "semantic-950754ba51573246",
      "decision": "applicable-pass",
      "blockers": []
    }
  ],
  "retrievalFailures": [],
  "blockers": []
}

Changed files

  • specification/newrelic/NewRelicObservability.Management/client.tsp (committed)
  • specification/newrelic/NewRelicObservability.Management/main.tsp (committed)

Timing and model input

{
  "timings": {
    "metadataMs": 1125,
    "fetchMs": 172,
    "scopeDiscoveryMs": 70,
    "setupExcludingFetchMs": 6762,
    "comparisonMs": 117,
    "changeDiscoveryMs": 77,
    "workspacePreparationMs": 4845,
    "projectDiscoveryMs": 12,
    "totalMs": 89586,
    "semanticAnalysisMs": 1058,
    "restAnalysisMs": 37,
    "downstreamAnalysisMs": 7,
    "documentQualityAnalysisMs": 1
  },
  "inputAccounting": {
    "budgetTier": "small",
    "budgetBytes": 131072,
    "bytes": 7427,
    "estimatedTokens": 1857,
    "retained": {
      "evidenceSets": 2,
      "facts": 0,
      "semanticReviewUnits": 1,
      "restCandidates": 0,
      "downstreamCandidates": 0,
      "downstreamRootCauses": 0,
      "complianceSearchRequests": 1,
      "inferenceRequests": 0
    },
    "omittedRedundant": {
      "rawEmitterArtifacts": true,
      "compilerLogs": true,
      "unchangedInventories": true,
      "unreferencedFacts": true,
      "unreferencedDeterministicFacts": true,
      "sourceChanges": true,
      "repeatedDeclarationIds": true,
      "repeatedReviewUnitEvidence": true
    },
    "compliance": {
      "catalogEntriesScored": 31,
      "documentsFetched": 4,
      "documentBytesFetched": 16828,
      "guidanceExcerptsRetained": 6,
      "guidanceExcerptBytesRetained": 1066
    }
  }
}

Provenance: model-input.json, dimensions/document-quality-input.json, compliance-search-evidence.json, assessment-judgment.json, preparation-manifest.json