feat(advisor): Clarity-Gate orchestration in route.ts (consumes /retrieve)
Completes the advisor stack (FE + orchestration; /retrieve is SDK/RAG-owned). The route
now returns the FE contract instead of a text stream:
- retrieveFull() calls /retrieve with {query, context}; consumes clarity/evidence/
visual_evidence/footnotes (exact shape per board 2026-07-01 12:25).
- mode-routing (resolveMode): clarify unless a context was chosen and /retrieve's
clarity.mode says so. clarify -> L1 general answer (completeAdvisorAnswer, ungrounded,
no sources). answer -> L2 answer over numbered evidence with [n] markers.
- citations generated here ([n] -> nth evidence unit); footnotes remapped; evidence /
visual_evidence passed through.
- advisor-llm: non-streaming completeAdvisorAnswer(). Pure mappings in retrieve-mapping.ts
(+ tests). Removed the dead v2 evidence.ts/evidence-adapter (RegulationRef moved to
regulation-display). controls-augmentation kept (tested; re-integrable later).
NOT deployed: joint deploy with the SDK /retrieve endpoint (deploy-coupling). tsc clean,
25 vitest (mapping/clarify/answer/markdown/registry/rag), check-loc 0.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -23,11 +23,14 @@ export interface EvidenceUnit {
|
||||
paragraph?: string
|
||||
snippet?: string
|
||||
url?: string
|
||||
regulation_code?: string // preferred key for family grouping (from /retrieve)
|
||||
context?: string // knowledge space / domain
|
||||
}
|
||||
|
||||
/** Numbered [n] <-> evidence coupling, produced by the SDK (not parsed from the answer). */
|
||||
export interface Citation {
|
||||
citation_id: string
|
||||
number?: number // 1-based marker number ([n])
|
||||
evidence_id: string
|
||||
document: string
|
||||
section?: string | null
|
||||
|
||||
Reference in New Issue
Block a user