Import - Deprecated not imported for operations

[baywet]

Clear and concise description of the problem

In #4453 we've implemented importing deprecated for models and properties.
However, we forgot the operations themselves, importing

openapi: 3.0.0
info:
  title: Widget Service
  version: 0.0.0
tags:
  - name: Widgets
paths:
  /widgets:
    get:
      operationId: Widgets_list
      description: List widgets
      parameters: []
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Widget'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
        - Widgets
      deprecated: true
components:
  schemas:
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
    Widget:
      type: object
      required:
        - id
        - weight
        - color
      properties:
        id:
          type: string
          readOnly: true
        weight:
          type: integer
          format: int32
        color:
          type: string
          enum:
            - red
            - blue

Is going to result in

import "@typespec/http";

using Http;
@service(#{ title: "Widget Service" })
namespace DemoService;

model Widget {
  @visibility(Lifecycle.Read)
  id: string;

  weight: int32;
  color: "red" | "blue";
}

@error
model Error {
  code: int32;
  message: string;
}

@route("/widgets")
@tag("Widgets")
interface Widgets {
  /** List widgets */
  @get list(): Widget[] | Error;
}

Note that the list operation is missing `#deprecated "deprecated".

Checklist

• Follow our Code of Conduct
• Read the docs.
• Check that there isn't already an issue that request the same feature to avoid creating a duplicate.

[github-actions]

🎯 Issue Triage

The OpenAPI-to-TypeSpec converter does not emit #deprecated "deprecated" when importing operations that have deprecated: true in the OpenAPI spec. Support for deprecated was added for models and properties in #4453 but operations were not handled.

Category: Feature Request

Area: openapi3:converter

📋 Reproduction (OpenAPI input)

openapi: 3.0.0
info:
  title: Widget Service
  version: 0.0.0
paths:
  /widgets:
    get:
      operationId: Widgets_list
      description: List widgets
      parameters: []
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Widget'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
        - Widgets
      deprecated: true
components:
  schemas:
    Widget:
      type: object
      required: [id, weight, color]
      properties:
        id: { type: string, readOnly: true }
        weight: { type: integer, format: int32 }
        color: { type: string, enum: [red, blue] }
    Error:
      type: object
      required: [code, message]
      properties:
        code: { type: integer, format: int32 }
        message: { type: string }

Expected output (operation should include #deprecated):

`@route`("/widgets")
`@tag`("Widgets")
interface Widgets {
  /** List widgets */
  #deprecated "deprecated"
  `@get` list(): Widget[] | Error;
}

🔍 Analysis

• Affected component: @typespec/openapi3 converter (OpenAPI → TypeSpec import path)
• Root cause: The converter handles deprecated on schema objects (models/properties) but the operation conversion code path does not check or emit #deprecated for operations with deprecated: true
• Related: [Bug]: tsp-openapi3: "deprecated" decorators not imported #4453 — original implementation for deprecated models/properties; this is the follow-up for operations
• Related: [Bug]: OpenAPI 3.2 import incorrectly applies #deprecated #10043 — separate issue about malformed #deprecated output for properties with $ref sibling keywords (different root cause)

📝 Suggested next steps

• In the converter, locate where individual operations are processed
• Check if the OpenAPI operation has deprecated: true and, if so, emit #deprecated "deprecated" before the operation declaration
• Add a test case covering a deprecated operation import

Generated by Agentic Triage