1 line
5.2 KiB
JSON
1 line
5.2 KiB
JSON
{"path":"NexusReader.Application/Commands/AI/VerifyGroundednessCommand.cs","purpose":"Defines a MediatR command and its handler that delegates verification of an answer's groundedness to the application's IKnowledgeService.","classification":{"role":"handler","layer":"application","confidence":0.86,"evidence":["Command pattern","Namespace NexusReader.Application.Commands.AI","Implements IRequestHandler<VerifyGroundednessCommand, Result<GroundednessResult>> (MediatR handler pattern)","Delegates work to IKnowledgeService.VerifyGroundednessAsync"]},"className":"VerifyGroundednessCommandHandler","methods":[{"name":"VerifyGroundednessCommandHandler","line":13,"endLine":16,"signature":"(knowledgeService: IKnowledgeService) -> VerifyGroundednessCommandHandler","purpose":"Constructor that receives and stores the IKnowledgeService dependency via DI.","calls":[],"actions":[{"id":"assign_15","kind":"mapping","label":"Store injected dependency","line":15,"detail":"_knowledgeService = knowledgeService","visibility":"detail-only","confidence":0.7}]},{"name":"Handle","line":18,"endLine":21,"signature":"(request: VerifyGroundednessCommand, cancellationToken: CancellationToken) -> Task<Result<GroundednessResult>>","purpose":"Handles the VerifyGroundednessCommand by calling the knowledge service to verify groundedness and returning the service result.","calls":[{"targetFile":"unknown","targetMethod":"VerifyGroundednessAsync","callLine":20,"paramSummary":"request.Answer, request.Context, request.TenantId, cancellationToken"}],"actions":[{"id":"external-call_20","kind":"external-call","label":"Delegate groundedness verification to knowledge service","line":20,"detail":"await _knowledgeService.VerifyGroundednessAsync(...) and return its Result<GroundednessResult>","visibility":"detail-only","confidence":0.7},{"id":"async-return_20","kind":"mapping","label":"Return result from external service","line":20,"detail":"returns Task<Result<GroundednessResult>>","visibility":"detail-only","confidence":0.7},{"id":"handle_return_20_1","kind":"return","label":"Returns result","line":20,"detail":"return await _knowledgeService.VerifyGroundednessAsync(request.Answer, request.Context, request.TenantId, cancellationToken);","visibility":"detail-only","confidence":0.7},{"id":"handle_await_20_0","kind":"await","label":"Waits for async work","line":20,"detail":"return await _knowledgeService.VerifyGroundednessAsync(request.Answer, request.Context, request.TenantId, cancellationToken);","visibility":"secondary-visible","confidence":0.81}]}],"types":[{"name":"VerifyGroundednessCommand","kind":"command","line":7,"purpose":"Command DTO carrying an answer, context, and tenant id to be verified for groundedness.","fields":[{"name":"Answer","type":"string","required":true,"line":7,"description":"The answer text to verify"},{"name":"Context","type":"string","required":true,"line":7,"description":"Contextual information used for verification"},{"name":"TenantId","type":"string","required":true,"line":7,"description":"Tenant identifier for multi-tenant scoping"}]}],"serviceRegistrations":[],"startupActions":[],"dependencies":["NexusReader.Application.Abstractions.Services (IKnowledgeService)","FluentResults (Result<>)","MediatR (IRequestHandler/IRequest)"],"patterns":["CQRS Handler","MediatR"],"domainConcepts":["Groundedness","KnowledgeService","Tenant"],"keyDetails":"This file is a thin MediatR command handler that forwards the request to IKnowledgeService.VerifyGroundednessAsync without additional logic or validation. GroundednessResult is returned inside a FluentResults.Result wrapper.","orchestrationMethods":[{"name":"Handle","line":18,"confidence":0.65,"reason":"Contains 1 architectural actions relevant to business execution.","actionKinds":["external-call","mapping","return","await"],"evidencePaths":["NexusReader.Application/Commands/AI/VerifyGroundednessCommand.cs","unknown"]}],"typedContracts":[{"name":"VerifyGroundednessCommand","kind":"command","line":7,"fieldCount":3,"evidencePaths":["NexusReader.Application/Commands/AI/VerifyGroundednessCommand.cs"]}],"persistenceInteractions":[],"externalInteractions":[{"methodName":"Handle","line":20,"kind":"external-call","detail":"await _knowledgeService.VerifyGroundednessAsync(...) and return its Result<GroundednessResult>","evidencePaths":["NexusReader.Application/Commands/AI/VerifyGroundednessCommand.cs"]}],"evidenceAnchors":[{"kind":"orchestration-method","label":"Handle","line":18,"summary":"Contains 1 architectural actions relevant to business execution.","confidence":0.65,"evidencePaths":["NexusReader.Application/Commands/AI/VerifyGroundednessCommand.cs","unknown"]},{"kind":"typed-contract","label":"VerifyGroundednessCommand","line":7,"summary":"command with 3 fields.","confidence":0.8,"evidencePaths":["NexusReader.Application/Commands/AI/VerifyGroundednessCommand.cs"]},{"kind":"external-call","label":"Handle","line":20,"summary":"await _knowledgeService.VerifyGroundednessAsync(...) and return its Result<GroundednessResult>","confidence":0.8,"evidencePaths":["NexusReader.Application/Commands/AI/VerifyGroundednessCommand.cs"]}],"cacheMetadata":{"schemaVersion":2,"analysisVersion":"2026-05-23.cache-v1","contentChecksum":"dac5a5e693f356b5ca82d50d5693e8c4d40d4de02b1078628ee85381c3ee68ea","sourceByteSize":885,"analyzedAt":"2026-05-23T16:16:37.913Z","technology":"dotnet"}} |