NewDocV1

src/.documentation/cache/summaries/NexusReader.Application__DTOs__AI__GroundedResponseDto.cs.json

@@ -1 +1 @@
-{"path":"NexusReader.Application/DTOs/AI/GroundedResponseDto.cs","purpose":"Defines simple DTOs used to return a grounded AI response (answer plus provenance/citations) from application services.","classification":{"role":"dto","layer":"application","confidence":0.9,"evidence":["DTO/view-model naming pattern","Namespace NexusReader.Application.DTOs.AI","File only contains plain data-holder classes (GroundedResponseDto, CitationDto) with auto-properties"]},"className":"GroundedResponseDto","methods":[],"types":[{"name":"GroundedResponseDto","kind":"dto","line":5,"purpose":"Carries an AI-generated answer and a list of provenance citations back to callers.","fields":[{"name":"Answer","type":"string","required":true,"line":7,"description":"The generated answer text"},{"name":"Citations","type":"List<CitationDto>","required":true,"line":8,"description":"List of contextual citations supporting the answer"}]},{"name":"CitationDto","kind":"dto","line":11,"purpose":"Represents a single provenance item (chunk id, snippet, and source) used to justify the answer.","fields":[{"name":"CitationId","type":"string","required":true,"line":13,"description":"Identifier for the cited chunk (e.g., chunk hash/ID)"},{"name":"Snippet","type":"string","required":true,"line":14,"description":"Verified text snippet extracted from context"},{"name":"SourceBook","type":"string","required":true,"line":15,"description":"Book title or human-readable source description"}]}],"serviceRegistrations":[],"startupActions":[],"dependencies":[],"patterns":["DTO"],"domainConcepts":["GroundedResponse","Citation","AI/Knowledge","Answering","Provenance"],"keyDetails":"Small, self-contained DTOs with default non-null initializers (string.Empty, new List) intended for safe transport over app/service boundaries.","orchestrationMethods":[],"typedContracts":[{"name":"GroundedResponseDto","kind":"dto","line":5,"fieldCount":2,"evidencePaths":["NexusReader.Application/DTOs/AI/GroundedResponseDto.cs"]},{"name":"CitationDto","kind":"dto","line":11,"fieldCount":3,"evidencePaths":["NexusReader.Application/DTOs/AI/GroundedResponseDto.cs"]}],"persistenceInteractions":[],"externalInteractions":[],"evidenceAnchors":[{"kind":"typed-contract","label":"GroundedResponseDto","line":5,"summary":"dto with 2 fields.","confidence":0.8,"evidencePaths":["NexusReader.Application/DTOs/AI/GroundedResponseDto.cs"]},{"kind":"typed-contract","label":"CitationDto","line":11,"summary":"dto with 3 fields.","confidence":0.8,"evidencePaths":["NexusReader.Application/DTOs/AI/GroundedResponseDto.cs"]}]}
+{"path":"NexusReader.Application/DTOs/AI/GroundedResponseDto.cs","purpose":"Defines simple DTOs for AI grounded responses and their citations used across the application boundary.","classification":{"role":"dto","layer":"application","confidence":0.8,"evidence":["DTO/view-model naming pattern","Namespace NexusReader.Application.DTOs.AI indicates application-layer DTOs","File contains plain POCO classes with public properties and default initializers"]},"className":"","methods":[],"types":[{"name":"GroundedResponseDto","kind":"dto","line":5,"purpose":"Represents a grounded AI answer plus associated citations.","fields":[{"name":"Answer","type":"string","required":true,"line":7,"description":"Primary textual answer from the AI"},{"name":"Citations","type":"List<CitationDto>","required":true,"line":8,"description":"List of citation entries that support the answer"}]},{"name":"CitationDto","kind":"dto","line":11,"purpose":"Represents a single citation/snippet referencing source material supporting an AI response.","fields":[{"name":"CitationId","type":"string","required":true,"line":13,"description":"Identifier for the cited chunk (e.g., chunk hash/ID)"},{"name":"Snippet","type":"string","required":true,"line":14,"description":"Verified text snippet extracted from the source context"},{"name":"SourceBook","type":"string","required":true,"line":15,"description":"Book title or human-readable source description"}]}],"serviceRegistrations":[],"startupActions":[],"dependencies":[],"patterns":["DTO","POCO"],"domainConcepts":["Grounded AI Response","Citation"],"keyDetails":"Simple, immutable-seeming DTOs (with default initializers) meant for transporting AI answers and their provenance; no runtime behavior, external calls, or persistence in this file.","orchestrationMethods":[],"typedContracts":[{"name":"GroundedResponseDto","kind":"dto","line":5,"fieldCount":2,"evidencePaths":["NexusReader.Application/DTOs/AI/GroundedResponseDto.cs"]},{"name":"CitationDto","kind":"dto","line":11,"fieldCount":3,"evidencePaths":["NexusReader.Application/DTOs/AI/GroundedResponseDto.cs"]}],"persistenceInteractions":[],"externalInteractions":[],"evidenceAnchors":[{"kind":"typed-contract","label":"GroundedResponseDto","line":5,"summary":"dto with 2 fields.","confidence":0.8,"evidencePaths":["NexusReader.Application/DTOs/AI/GroundedResponseDto.cs"]},{"kind":"typed-contract","label":"CitationDto","line":11,"summary":"dto with 3 fields.","confidence":0.8,"evidencePaths":["NexusReader.Application/DTOs/AI/GroundedResponseDto.cs"]}],"cacheMetadata":{"schemaVersion":2,"analysisVersion":"2026-05-23.cache-v1","contentChecksum":"717b4a7e0b2e1e969aef25735b5861388e6278777c1e5664d997fb572d9351f8","sourceByteSize":546,"analyzedAt":"2026-05-23T16:17:01.422Z","technology":"dotnet"}}