Radiology samples: contract update and Quickstart / Advance sample projects

[ashokginjala]

Updates the radiology extension samples to the latest contract and adds two runnable sample projects.

Contract Changes:
• ProcessRequest has extensibilityApiVersion (optional) and sessionData (required). ProcessResponse has no wire-level version.
• Payload schemas (Report, PatientInformation, QualityCheckResult) declare versions via the x-ms-schema-version OpenAPI annotation
• Manifest requires top-level radiologyExtensibilityApiVersion and per-input/output schemaVersion
• Spec, manifest schema, sample JSONs, C# models, and CLI all align with this contract

New sample projects:
• Web.Quickstart: minimal ASP.NET Core extension returning a canned mock response
• Web.Ai: AI-powered extension using Azure OpenAI with on-device Foundry Local fallback

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Updates the radiology extension contract and CLI scaffolding to use camelCase naming, introduce explicit API/payload schema versioning, and refresh samples accordingly.

Changes:

• Added radiologyExtensibilityApiVersion to manifests and required schemaVersion per tool input/output.
• Switched extension/tool naming rules from kebab-case to camelCase and updated radiology media type from patient-info to patient-information.
• Added new ASP.NET Core workflow sample projects (Quickstart + AI) and aligned radiology OpenAPI/models/samples to the updated contract.

Reviewed changes

Copilot reviewed 58 out of 58 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tools/dragon-copilot-cli/src/schemas/radiology/radiology-extension-manifest-schema.json	Enforces new manifest fields, name patterns, and per-payload schema versioning.
tools/dragon-copilot-cli/src/domains/radiology/types.ts	Updates TypeScript domain types to include new manifest/input/output fields.
tools/dragon-copilot-cli/src/domains/radiology/templates/index.ts	Updates radiology template defaults to camelCase, new media type, and schema versions.
tools/dragon-copilot-cli/src/domains/radiology/shared/prompts.ts	Updates prompts/choices for new naming and content-type + adds API version prompt.
tools/dragon-copilot-cli/src/domains/radiology/commands/init.ts	Includes new manifest field and emits schema versions on generated inputs.
tools/dragon-copilot-cli/src/domains/radiology/commands/generate.ts	Includes new manifest field and emits schema versions on generated inputs.
tools/dragon-copilot-cli/src/tests/manifest-validation.test.ts	Extends schema-validation tests for new required fields/patterns.
tools/dragon-copilot-cli/src/tests/cli-integration.test.ts	Updates integration manifest fixture to match new schema and naming.
radiology/src/samples/requests/sample-requests-responses.md	Updates sample docs to new input naming/content-type and schemaVersion usage.
radiology/src/samples/requests/ReportRequest-Example.json	Updates sample request envelope field from schemaVersion to extensibilityApiVersion.
radiology/src/samples/requests/QualityCheckResultResponse-Example.json	Removes schemaVersion from response sample to match updated response envelope.
radiology/src/samples/requests/PatientInfoRequest-Example.json	Updates sample request to patientInformation and new envelope version field.
radiology/src/samples/requests/FullRequest-Example.json	Updates combined request sample to patientInformation and new envelope version field.
radiology/src/samples/Workflow/SampleExtensions.Radiology.Web.slnx	Adds a solution wrapper for the new workflow sample projects.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/nuget.config	Defines NuGet sources for the Quickstart sample.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/appsettings.json	Adds sample configuration including auth toggles and mock data path.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/appsettings.Development.json	Development logging defaults for Quickstart.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Services/QualityCheckService.cs	Implements mock-response-based processing for Quickstart sample.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Services/IQualityCheckService.cs	Adds abstraction for request processing in Quickstart sample.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/SampleExtension.Radiology.Web.Quickstart.http	Adds HTTP file for local testing Quickstart endpoints.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/SampleExtension.Radiology.Web.Quickstart.csproj	Adds Quickstart ASP.NET Core sample project definition.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/README.md	Documents how to run/configure the Quickstart sample and its contract.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Properties/launchSettings.json	Adds launch profiles/ports for Quickstart sample.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Program.cs	Configures controllers, swagger, CORS, health, and auth pipeline for Quickstart.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/MockData/qualitycheck-response.json	Provides canned sample responses for Quickstart.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Extensions/WebApplicationExtensions.cs	Adds conditional auth middleware application based on request path.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Extensions/ServiceCollectionExtensions.cs	Adds auth setup and authorization policy wiring (Quickstart).
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Controllers/QualityCheckController.cs	Adds the /v1/process endpoint for Quickstart.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Configuration/AuthenticationOptions.cs	Adds settings model for JWT auth configuration (Quickstart).
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/nuget.config	Defines NuGet sources for AI sample.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/appsettings.json	Adds auth + Azure OpenAI/Foundry Local configuration knobs.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/appsettings.Development.json	Development logging defaults for AI sample.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Services/QualityCheckService.cs	Implements model-backed quality checking and response mapping.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Services/IQualityCheckService.cs	Adds abstraction for request processing (AI sample).
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Services/IFoundryLocalService.cs	Defines Foundry Local chat client provider abstraction.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Services/IAzureOpenAIService.cs	Defines Azure OpenAI chat client provider abstraction.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Services/FoundryLocalService.cs	Implements Foundry Local initialization, download/load, and lifecycle management.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Services/AzureOpenAIService.cs	Implements Azure OpenAI chat client creation based on config.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/SampleExtension.Radiology.Web.Ai.http	Adds HTTP file for local testing AI sample endpoints.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/SampleExtension.Radiology.Web.Ai.csproj	Adds AI ASP.NET Core sample project definition and dependencies.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/README.md	Documents how to run/configure AI providers and the contract.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Properties/launchSettings.json	Adds launch profiles/ports for AI sample.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Program.cs	Configures controllers, swagger, CORS, health, and auth pipeline for AI sample.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Extensions/WebApplicationExtensions.cs	Adds conditional auth middleware application based on request path (AI sample).
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Extensions/ServiceCollectionExtensions.cs	Adds auth setup and authorization policy wiring (AI sample).
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Controllers/QualityCheckController.cs	Adds the /v1/process endpoint for AI sample.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Configuration/OpenAiSettings.cs	Adds configuration model for Azure OpenAI settings.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Configuration/FoundryLocalSettings.cs	Adds configuration model for Foundry Local settings.
radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Ai/Configuration/AuthenticationOptions.cs	Adds settings model for JWT auth configuration (AI sample).
radiology/src/samples/Workflow/README.md	Adds overview for workflow sample projects, build, and run instructions.
radiology/src/models/Dragon.Copilot.Radiology.Models/SessionData.cs	Improves docs and clarifies snake_case JSON fields in the session contract.
radiology/src/models/Dragon.Copilot.Radiology.Models/Recommendation.cs	Updates wording and minor doc normalization.
radiology/src/models/Dragon.Copilot.Radiology.Models/ProcessResponse.cs	Removes wire schemaVersion and adjusts response properties for updated spec.
radiology/src/models/Dragon.Copilot.Radiology.Models/ProcessRequest.cs	Renames envelope fields, adds extension data, and aligns with updated spec.
radiology/src/models/Dragon.Copilot.Radiology.Models/PatientInfo.cs	Renames model type to PatientInformation to align with schema naming.
radiology/radiology-extensibility-api.yaml	Bumps API version, renames schemas, and updates request/response envelopes and schema version annotations.
radiology/README.md	Adds versioning explanation for manifest/API/payload schema axes.
radiology/Directory.Packages.props	Adds central package versions for radiology workflow samples.

Comments suppressed due to low confidence (7)

radiology/src/samples/requests/sample-requests-responses.md:1

• The markdown links to PatientInformationRequest-Example.json, but the changed sample file in this PR is still named PatientInfoRequest-Example.json. This will produce a broken link in the docs—either rename the JSON file to match the new link, or update the link to the actual file name.
  radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Controllers/QualityCheckController.cs:1
• The controller doc comment says the sample has "no authentication", but the controller itself is protected with [Authorize(Policy = \"RequiredClaims\")] (even if auth can be disabled via config). Update the comment to reflect that authentication/authorization is enforced when enabled.
  radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Controllers/QualityCheckController.cs:1
• The controller doc comment says the sample has "no authentication", but the controller itself is protected with [Authorize(Policy = \"RequiredClaims\")] (even if auth can be disabled via config). Update the comment to reflect that authentication/authorization is enforced when enabled.
  radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Extensions/WebApplicationExtensions.cs:1
• Using StartsWith on raw strings for public-route filtering can unintentionally mark unrelated endpoints as public (e.g., /healthcare starts with /health) and can be error-prone with path normalization. Prefer PathString.StartsWithSegments(...) (or equivalent) for route matching. Also, both samples serve Swagger UI (often at / and /swagger); if Swagger should be reachable when auth is enabled, add explicit public-route handling for those paths (or update the documentation if Swagger is intended to be protected).
  radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Extensions/WebApplicationExtensions.cs:1
• Using StartsWith on raw strings for public-route filtering can unintentionally mark unrelated endpoints as public (e.g., /healthcare starts with /health) and can be error-prone with path normalization. Prefer PathString.StartsWithSegments(...) (or equivalent) for route matching. Also, both samples serve Swagger UI (often at / and /swagger); if Swagger should be reachable when auth is enabled, add explicit public-route handling for those paths (or update the documentation if Swagger is intended to be protected).
  radiology/src/samples/Workflow/SampleExtension.Radiology.Web.Quickstart/Services/QualityCheckService.cs:1
• response.Payload?[QualityCheckPayloadKey] can throw KeyNotFoundException when Payload is non-null but does not contain qualityCheckResult (the null-conditional only guards Payload, not the indexer). Use TryGetValue (or a safe helper) when computing the log count to avoid failing startup/first use when the mock JSON shape changes.
  tools/dragon-copilot-cli/src/domains/radiology/shared/prompts.ts:1
• The CLI prompt captures schemaVersion but does not validate the required major.minor format (the schema enforces ^\\d+\\.\\d+$). Add a validator here so users get immediate feedback instead of generating a manifest that later fails schema validation.