Research Timeline Rendering
7 requirements
·
15 scenarios
Research Result Section Order
JR-research-timeline-rendering-001
The system SHALL render research results in channel-specific section order:
PDF Report: Title → Summary → References → Cited Paragraphs → Research Timeline
Email Body: Title → Summary → References → Cited Paragraphs → Workflow Signature
Chat UI: Summary → References → Cited Paragraphs → [Collapsible Timeline]
The system SHALL NOT render the Research Timeline or Cited Paragraphs section between the Summary and References sections.
PDF Report: Title → Summary → References → Cited Paragraphs → Research Timeline
Email Body: Title → Summary → References → Cited Paragraphs → Workflow Signature
Chat UI: Summary → References → Cited Paragraphs → [Collapsible Timeline]
The system SHALL NOT render the Research Timeline or Cited Paragraphs section between the Summary and References sections.
3 test scenarios
- PDF report section order JR-research-timeline-rendering-001.1
- Email body section order JR-research-timeline-rendering-001.2
- Chat UI section order JR-research-timeline-rendering-001.3
AI-Generated Title for PDF
JR-research-timeline-rendering-002
The system SHALL generate a contextual title for PDF research reports using AI, rather than relying on the email subject line or first sentence of the query.
The generated title SHALL be:
- 3-8 words in length
- Descriptive of the research question or topic
- Used as the PDF report heading
- Used as the PDF filename (with appropriate sanitization)
Chat sidebar titles SHALL remain unchanged (derived from first words of message).
The generated title SHALL be:
- 3-8 words in length
- Descriptive of the research question or topic
- Used as the PDF report heading
- Used as the PDF filename (with appropriate sanitization)
Chat sidebar titles SHALL remain unchanged (derived from first words of message).
2 test scenarios
- Title generation for research query JR-research-timeline-rendering-002.1
- Chat sidebar unchanged JR-research-timeline-rendering-002.2
Workflow Signature for Email Body
JR-research-timeline-rendering-003
The system SHALL render a compact workflow signature in email body instead of the full Research Timeline.
The workflow signature SHALL include:
- Completion indicator:
- Processing metadata: processing time, tokens used
- Completed todos list with summary stats (e.g., "3 web searches", "read 1 Drive file")
- Pointer to attachment:
The workflow signature SHALL include:
- Completion indicator:
✅ Completed workflow: research_pipeline- Processing metadata: processing time, tokens used
- Completed todos list with summary stats (e.g., "3 web searches", "read 1 Drive file")
- Pointer to attachment:
📎 Full research timeline available in attached PDF report
2 test scenarios
- Workflow signature in email body JR-research-timeline-rendering-003.1
- Workflow signature format JR-research-timeline-rendering-003.2
References Section Format
JR-research-timeline-rendering-004
The system SHALL render a References section as a numbered bibliography containing:
- Sequential numbering
- Source title/name only (short form)
The References section SHALL appear before the Cited Paragraphs section.
- Sequential numbering
[1], [2], etc. matching inline citations- Source title/name only (short form)
The References section SHALL appear before the Cited Paragraphs section.
1 test scenario
- References section content JR-research-timeline-rendering-004.1
Cited Paragraphs Section Format
JR-research-timeline-rendering-005
The system SHALL render a Cited Paragraphs section (🔍) containing full source details:
- Reference number
- Source title
- Source type indicator (Web Result #N, Google Drive File, SharePoint File, etc.)
- Text snippet/excerpt from the source
- URL or file identifier
The Cited Paragraphs section SHALL appear after the References section.
- Reference number
[N] matching References section- Source title
- Source type indicator (Web Result #N, Google Drive File, SharePoint File, etc.)
- Text snippet/excerpt from the source
- URL or file identifier
The Cited Paragraphs section SHALL appear after the References section.
2 test scenarios
- Web source in Cited Paragraphs JR-research-timeline-rendering-005.1
- Drive file in Cited Paragraphs JR-research-timeline-rendering-005.2
Cited Insight Display Format
JR-research-timeline-rendering-006
The system SHALL display each cited insight in the following format:
1. Insight text (paraphrased finding) followed by citation number(s) in brackets
2. Supporting quote(s) displayed in *italics* to differentiate from paraphrased text
The system SHALL NOT display confidence scores to end users.
1. Insight text (paraphrased finding) followed by citation number(s) in brackets
[N]2. Supporting quote(s) displayed in *italics* to differentiate from paraphrased text
The system SHALL NOT display confidence scores to end users.
3 test scenarios
- Insight with single quote JR-research-timeline-rendering-006.1
- Insight with multiple quotes JR-research-timeline-rendering-006.2
- Confidence not exposed to users JR-research-timeline-rendering-006.3
Full CitedInsight Data in Frontend
JR-research-timeline-rendering-007
The system SHALL serialize complete
-
-
-
The system SHALL NOT include
CitedInsight data when sending research results to the frontend, including:-
insight (string): The paraphrased finding-
source (string): Citation ID (e.g., "source-001") or source reference-
quotes (list of strings): Supporting quotes from the sourceThe system SHALL NOT include
confidence in the frontend serialization.
2 test scenarios
- to_todo_list_dict includes CitedInsight details JR-research-timeline-rendering-007.1
- Frontend receives complete insight data JR-research-timeline-rendering-007.2