TypeSpec Assessment

Semantic intents

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

2 intents · 0 added · 2 modified · 0 removed

Refine Python client locations for traffic-filter operationsAdds Python-specific client-location labels for listing associated traffic filters and creating or associating an IP filter, while excluding Python from the prior shared labels. No REST operation mapping changed.

modify

Changed TypeSpec source (1)

specification/elastic/Elastic.Management/back-compatible.tsp

 @@clientLocation(
   ElasticMonitorResources.listAssociatedTrafficFiltersList,
   "listAssociatedTrafficFilters",
-  "!csharp"
+  "!csharp,!python"
+);
+@@clientLocation(
+  ElasticMonitorResources.listAssociatedTrafficFiltersList,
+  "ListAssociatedTrafficFilters",
+  "python"
 );
 @@clientName(ElasticMonitorResources.listAssociatedTrafficFiltersList, "list");
 @@clientLocation(
   ElasticMonitorResources.createAndAssociateIPFilterCreate,
   "createAndAssociateIPFilter",
-  "!csharp,!java"
+  "!csharp,!java,!python"
+);
+@@clientLocation(
+  ElasticMonitorResources.createAndAssociateIPFilterCreate,
+  "CreateAndAssociateIPFilter",
+  "python"
 );
 @@clientName(
   ElasticMonitorResources.createAndAssociateIPFilterCreate,

specification/elastic/Elastic.Management/back-compatible.tsp

Affected operations (0)

No directly affected REST operation.

Refine Python client location for PL filter creationAdds a Python-specific client-location label for creating and associating a PL filter while excluding Python from the prior shared label. No REST operation mapping changed.

modify

Changed TypeSpec source (1)

specification/elastic/Elastic.Management/back-compatible.tsp

 @@clientLocation(
   ElasticMonitorResources.createAndAssociatePLFilterCreate,
   "createAndAssociatePLFilter",
-  "!csharp"
+  "!csharp,!python"
+);
+@@clientLocation(
+  ElasticMonitorResources.createAndAssociatePLFilterCreate,
+  "CreateAndAssociatePLFilter",
+  "python"
 );
 @@clientName(
   ElasticMonitorResources.createAndAssociatePLFilterCreate,

specification/elastic/Elastic.Management/back-compatible.tsp

Affected operations (0)

No directly affected REST operation.

Azure Guidelines

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

passed0 findings

2 of 2 semantic intents assessed · 4 documents selected

No Azure Guidelines findings.

No applicable guideline was found for: Refine Python client locations for traffic-filter operations Refine Python client location for PL filter creation.

REST breaking changes

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

passed0 operations · 0 findings

No confirmed REST breaking changes.

Downstream breaking changes

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

passed0 mapped methods · 0 changed types

No downstream breaking changes detected.

Documentation Completeness

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

passed

0 findings · 0 declarations checked

Appendix

Potential limits

None

Projects and compiler status

Project	Mode	Baseline commit@version	Target commit@version	Baseline AutoRest / TCGC	Target AutoRest / TCGC
`specification/elastic/Elastic.Management`	existing-api-version	`e8420e45fdaf12e2c72417d379c454f1fc8ce1e6@2025-06-01` base · affected-existing-version	`b63b8bfc79e274c916a91c5a2ff8b403cb00c3f2@2025-06-01` current · affected-existing-version	succeeded / succeeded	succeeded / succeeded

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

Guidance fetched

Guidance coverage and retrieval evidence

{
  "status": "passed",
  "coverage": {
    "semanticIntentCount": 2,
    "assessedIntentCount": 2,
    "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": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 6
        },
        "selectionRationale": "Existing-version modification makes API evolution guidance relevant; it also explicitly covers data-plane APIs."
      },
      {
        "rank": 2,
        "catalogOrder": 24,
        "title": "Decorators",
        "canonicalUrl": "https://typespec.io/docs/language-basics/decorators/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 6
        },
        "selectionRationale": "The change uses augment client-location decorators, matching generic decorator and augment syntax for data-plane TypeSpec."
      },
      {
        "rank": 3,
        "catalogOrder": 25,
        "title": "Built-in decorators",
        "canonicalUrl": "https://typespec.io/docs/standard-library/built-in-decorators/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 5
        },
        "selectionRationale": "The catalog's Decorators section and data-plane applicability match, but the document does not name @clientLocation."
      },
      {
        "rank": 4,
        "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 catalog's Decorators section and data-plane applicability match, but the document does not name @clientLocation."
      },
      {
        "rank": 5,
        "catalogOrder": 29,
        "title": "Content negotiation",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/azure-core/content-negotiation/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 5
        },
        "selectionRationale": "The catalog's Decorators section and data-plane applicability match, but the document does not name @clientLocation."
      },
      {
        "rank": 6,
        "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 catalog's Decorators section matches generally, but this ARM-specific document does not match the data-plane profile."
      },
      {
        "rank": 7,
        "catalogOrder": 28,
        "title": "Azure Portal default experiences",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/azure-portal/default-experiences/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 3
        },
        "selectionRationale": "The catalog's Decorators section matches generally, but this ARM-specific document does not match the data-plane profile."
      },
      {
        "rank": 8,
        "catalogOrder": 2,
        "title": "Versioning overview",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/versioning/01-about-versioning/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 9,
        "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": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 10,
        "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": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 11,
        "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": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 12,
        "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": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 13,
        "catalogOrder": 14,
        "title": "TypeSpec.Rest decorators",
        "canonicalUrl": "https://typespec.io/docs/libraries/rest/reference/decorators/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 14,
        "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 can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 15,
        "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 can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 16,
        "catalogOrder": 21,
        "title": "Models",
        "canonicalUrl": "https://typespec.io/docs/language-basics/models/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 17,
        "catalogOrder": 22,
        "title": "Enums",
        "canonicalUrl": "https://typespec.io/docs/language-basics/enums/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 18,
        "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 can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 19,
        "catalogOrder": 30,
        "title": "Directives",
        "canonicalUrl": "https://typespec.io/docs/language-basics/directives/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 20,
        "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": 0,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 2
        },
        "selectionRationale": "The document can apply to data-plane TypeSpec, but its pattern does not match client-location customization."
      },
      {
        "rank": 21,
        "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 exact symbol, matching change category, service plane, or modification context was identified."
      },
      {
        "rank": 22,
        "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 exact symbol, matching change category, service plane, or modification context was identified."
      },
      {
        "rank": 23,
        "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 exact symbol, matching change category, service plane, or modification context was identified."
      },
      {
        "rank": 24,
        "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 exact symbol, matching change category, service plane, or modification context was identified."
      },
      {
        "rank": 25,
        "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 exact symbol, matching change category, service plane, or modification context was identified."
      },
      {
        "rank": 26,
        "catalogOrder": 12,
        "title": "ARM resource operations",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/arm/resource-operations/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No exact symbol, matching change category, service plane, or modification context was identified."
      },
      {
        "rank": 27,
        "catalogOrder": 13,
        "title": "Azure.ResourceManager interface reference",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/reference/interfaces/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No exact symbol, matching change category, service plane, or modification context was identified."
      },
      {
        "rank": 28,
        "catalogOrder": 15,
        "title": "Azure.ResourceManager decorators",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/reference/decorators/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No exact symbol, matching change category, service plane, or modification context was identified."
      },
      {
        "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 exact symbol, matching change category, service plane, or modification context was identified."
      },
      {
        "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 exact symbol, matching change category, service plane, or modification context was identified."
      },
      {
        "rank": 31,
        "catalogOrder": 20,
        "title": "ARM common types",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/arm/add-common-types/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 0,
          "servicePlane": 0,
          "changeContext": 0,
          "total": 0
        },
        "selectionRationale": "No exact symbol, matching change category, service plane, or modification context was identified."
      }
    ],
    "documents": [
      {
        "rank": 1,
        "catalogOrder": 1,
        "title": "Evolving APIs",
        "canonicalUrl": "https://azure.github.io/typespec-azure/docs/howtos/versioning/06-evolving-apis/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 6
        },
        "selectionRationale": "Existing-version modification makes API evolution guidance relevant; it also explicitly covers data-plane APIs.",
        "guidance": [],
        "noRelevantGuidance": true,
        "retrievedAt": "2026-09-17T19:36:00.900+08:00",
        "contentHash": "sha256:b5e46a8f283abf35e3dba37ef98a6d78aea40c7c000fc2f205e46faa156b355d"
      },
      {
        "rank": 2,
        "catalogOrder": 24,
        "title": "Decorators",
        "canonicalUrl": "https://typespec.io/docs/language-basics/decorators/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 1,
          "total": 6
        },
        "selectionRationale": "The change uses augment client-location decorators, matching generic decorator and augment syntax for data-plane TypeSpec.",
        "guidance": [],
        "noRelevantGuidance": true,
        "retrievedAt": "2026-09-17T19:36:00.900+08:00",
        "contentHash": "sha256:974881e0d95bc51cda027915f021fdeb26ecef3d6796b129855fe1146f82a29f"
      },
      {
        "rank": 3,
        "catalogOrder": 25,
        "title": "Built-in decorators",
        "canonicalUrl": "https://typespec.io/docs/standard-library/built-in-decorators/",
        "score": {
          "exactSymbol": 0,
          "patternCategory": 3,
          "servicePlane": 2,
          "changeContext": 0,
          "total": 5
        },
        "selectionRationale": "The catalog's Decorators section and data-plane applicability match, but the document does not name @clientLocation.",
        "guidance": [],
        "noRelevantGuidance": true,
        "retrievedAt": "2026-09-17T19:36:00.900+08:00",
        "contentHash": "sha256:a1153cd2d3c9039840913abdab268669bdb75890d5d5d7aef3f509f5639e7082"
      },
      {
        "rank": 4,
        "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 catalog's Decorators section and data-plane applicability match, but the document does not name @clientLocation.",
        "guidance": [],
        "noRelevantGuidance": true,
        "retrievedAt": "2026-09-17T19:36:00.900+08:00",
        "contentHash": "sha256:9cc9553649474b3cc836472da956cd97dcedd380d99710ff852ad472fc53cd51"
      }
    ]
  },
  "intentAssessments": [
    {
      "semanticIntentId": "semantic-5badcff9f55bf48f",
      "decision": "no-applicable-guidance",
      "blockers": []
    },
    {
      "semanticIntentId": "semantic-9eb71f2afa096132",
      "decision": "no-applicable-guidance",
      "blockers": []
    }
  ],
  "retrievalFailures": [],
  "blockers": []
}

Changed files

specification/elastic/Elastic.Management/back-compatible.tsp (committed)

Timing and model input

{
  "timings": {
    "metadataMs": 1016,
    "fetchMs": 133,
    "scopeDiscoveryMs": 66,
    "setupExcludingFetchMs": 5750,
    "comparisonMs": 117,
    "changeDiscoveryMs": 65,
    "workspacePreparationMs": 4294,
    "projectDiscoveryMs": 13,
    "totalMs": 78498,
    "semanticAnalysisMs": 34,
    "restAnalysisMs": 28,
    "downstreamAnalysisMs": 1462,
    "documentQualityAnalysisMs": 1
  },
  "inputAccounting": {
    "budgetTier": "small",
    "budgetBytes": 131072,
    "bytes": 8406,
    "estimatedTokens": 2102,
    "retained": {
      "evidenceSets": 2,
      "facts": 0,
      "semanticReviewUnits": 2,
      "restCandidates": 0,
      "downstreamCandidates": 0,
      "downstreamRootCauses": 0,
      "complianceSearchRequests": 2,
      "inferenceRequests": 2
    },
    "omittedRedundant": {
      "rawEmitterArtifacts": true,
      "compilerLogs": true,
      "unchangedInventories": true,
      "unreferencedFacts": true,
      "unreferencedDeterministicFacts": true,
      "sourceChanges": true,
      "repeatedDeclarationIds": true,
      "repeatedReviewUnitEvidence": true
    },
    "inference": {
      "requestCount": 2,
      "inferredCandidateCount": 0,
      "noImpactCount": 2,
      "blockedCount": 0
    },
    "compliance": {
      "catalogEntriesScored": 31,
      "documentsFetched": 4,
      "documentBytesFetched": 792,
      "guidanceExcerptsRetained": 0,
      "guidanceExcerptBytesRetained": 0
    }
  }
}

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