stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
cf5b72974f923126944f4dcd47e85864ebb31a3b
git.stella-ops.org/docs/features/unchecked/concelier/concelier-advisory-chunks-api.md

1.7 KiB
Raw Blame History

Concelier Advisory Chunks API (Paragraph-Anchored)

Module

Concelier

Status

IMPLEMENTED

Description

REST API endpoint serving paragraph-anchored advisory chunks with tenant enforcement, AdvisoryRead scopes, and filters for sections/formats/limits/minLength. Designed for Advisory AI to pull deterministic paragraph anchors plus source metadata.

Implementation Details

  • Modules: src/Concelier/StellaOps.Concelier.WebService/
  • Key Classes:
    • AdvisoryChunkBuilder (src/Concelier/StellaOps.Concelier.WebService/Services/AdvisoryChunkBuilder.cs) - builds paragraph-anchored chunks from advisory content
    • AdvisoryChunkCache (src/Concelier/StellaOps.Concelier.WebService/Services/AdvisoryChunkCache.cs) - in-memory cache for advisory chunks
    • MessagingAdvisoryChunkCache (src/Concelier/StellaOps.Concelier.WebService/Services/MessagingAdvisoryChunkCache.cs) - messaging-backed cache implementation
    • AdvisoryChunkOptions (src/Concelier/StellaOps.Concelier.WebService/Options/ConcelierOptions.cs) - configuration for chunk sizes, limits, and formats
  • Interfaces: IAdvisoryChunkCache
  • Source: 2025-11-07-concelier-advisory-chunks.md

E2E Test Plan

  • Call the advisory chunks endpoint with a valid advisory ID and verify paragraph-anchored chunks are returned
  • Verify tenant enforcement: request chunks without AdvisoryRead scope and confirm 403 response
  • Verify section filter: request only specific sections and confirm only matching chunks are returned
  • Verify minLength filter: set minLength and confirm short paragraphs are excluded
  • Verify caching: request same advisory chunks twice and confirm second response is served from cache