Report Enhancement

Improves existing reports through three optional phases: supervision (content deepening), editing (structural improvement), and fact-checking (claim verification).

The workflow combines three sub-workflows that can be run independently or together:

Supervision: Identifies theoretical gaps and expands coverage
Editing: Restructures and polishes the writing
Fact-Check: Verifies claims and validates citations

When to Use This

This workflow is intended for improving draft reports—filling gaps, strengthening arguments, and ensuring accuracy.

For creating new research, use Web Research or Literature Review. For turning reports into articles, use Evening Reads.

How It Works

flowchart TD
    subgraph supervision["1. Supervision (Content Deepening)"]
        A[Your Draft Report] --> B[Loop 1: Theoretical Gaps]
        B --> C[Focused Literature Search]
        C --> D[Integrate New Content]
        D --> E[Loop 2: Adjacent Literature]
        E --> F[Discover Related Bases]
        F --> G[Expand Perspectives]
    end

    subgraph editing["2. Editing (Structure & Polish)"]
        G --> H[Analyze Structure]
        H --> I[Rewrite Weak Sections]
        I --> J[Enhance with Evidence]
        J --> K[Polish Flow & Transitions]
    end

    subgraph factcheck["3. Fact-Check (Verification)"]
        K --> L[Screen for Verifiable Claims]
        L --> M[Verify Against Sources]
        M --> N[Check Citation Accuracy]
        N --> O[Apply Corrections]
    end

    O --> P[Enhanced Report]

    style supervision fill:#e8f4f8
    style editing fill:#f0f8e8
    style factcheck fill:#fff8e8

The Three Phases

Supervision (Content Deepening)

Two iterative loops that deepen the report’s theoretical foundations:

Loop 1 — Theoretical Gaps: Identifies concepts or claims that lack sufficient grounding. Runs focused literature searches to find supporting evidence, then integrates findings into the report.

Loop 2 — Adjacent Literature: Discovers related literature bases the report may have missed. Expands the report’s perspective by incorporating ideas from adjacent fields or overlooked sources.

Editing (Structure & Polish)

Three-stage editing process:

Structure Phase: Analyzes the document structure, identifies weak sections, and rewrites them for clarity and flow.

Enhancement Phase: For reports with citations, strengthens arguments by better integrating evidence from the paper corpus.

Polish Phase: Improves sentence-level flow, transitions between sections, and overall readability.

Fact-Check (Verification)

Four-stage verification:

Screening: Identifies sections containing verifiable claims.

Fact-Check: Verifies claims using the paper corpus and web sources.

Reference-Check: Validates that citations actually exist and support the claims made.

Apply Edits: Automatically applies high-confidence corrections.

Inputs

Input	Description	Example
Report	Markdown document to enhance	Your draft literature review
Topic	Research topic	”Machine learning interpretability”
Research questions	Questions the report addresses	[“How do explanation methods compare?“]
Loops	Which supervision loops to run	”all”, “one”, “two”, or “none”
Run editing	Whether to run editing phase	true/false
Run fact-check	Whether to run fact-check phase	true/false
Paper corpus (optional)	Existing papers to reference	From literature review

Outputs

Output	Description
Report	Enhanced markdown document
Status	Success, partial, or failed
Supervision result	Details from supervision phase
Editing result	Details from editing phase
Fact-check result	Details from fact-check phase

Thoroughness Settings

Setting	Supervision Depth	Editing Passes	Fact-Check Coverage
Quick	Lighter search	Single pass	Sample sections
Standard	Balanced	Full pass	All sections
Comprehensive	Deep search	Multiple passes	Thorough verification
High Quality	Exhaustive	Complete rewrite potential	Complete verification

Example

Input:

Report: 8,000-word draft on “Federated learning privacy”
Loops: “all”
Run editing: true
Run fact-check: true

Typical output:

Supervision adds 2-3 new subsections filling theoretical gaps
Editing restructures introduction and conclusion, improves transitions
Fact-check corrects 2 citation errors, flags 1 unverifiable claim
Final report: ~10,000 words, strengthened throughout

Developer Reference

Entry points:

workflows/enhance/supervision/api.py — run_supervision()
workflows/enhance/editing/graph/api.py — run_editing()
workflows/enhance/fact_check/graph/api.py — run_fact_check()

Supervision

Graph: workflows/enhance/supervision/builder.py — configurable loop selection

Nodes: workflows/enhance/supervision/nodes.py

run_loop1_node — theoretical depth loop
run_loop2_node — literature expansion loop
finalize_node — output packaging

Shared utilities: workflows/enhance/supervision/shared/

mini_review/ — focused literature search subgraph
nodes/ — analyze, expand, integrate operations
prompts/ — loop-specific prompts

Editing

Graph: workflows/enhance/editing/graph/construction.py

Nodes: workflows/enhance/editing/nodes/

v2_analyze.py — structure analysis
v2_rewrite_section.py — parallel section rewriting
v2_reassemble.py — document reassembly
enhance_section.py — evidence integration
polish.py — final polish pass
finalize.py — output packaging

Document model: workflows/enhance/editing/document_model.py — structured document representation

Fact-Check

Graph: workflows/enhance/fact_check/graph/construction.py

Nodes: workflows/enhance/fact_check/nodes/

screen_sections.py — identify verifiable claims
fact_check.py — parallel claim verification
reference_check.py — citation validation
apply_edits.py — automatic corrections
finalize.py — output packaging

Prompts: workflows/enhance/fact_check/prompts.py — verification prompts

about thala

Explorer