Cognotik | ReportGenerationTask

⚙️ ExecutionConfig.json


{
  "report_topic": "Q3 Cloud Infrastructure Costs",
  "report_type": "performance_analysis",
  "target_audience": "executives",
  "time_period": "Q3 2024",
  "input_files": ["logs/cloud-usage.json", "docs/budget-plan.md"],
  "key_metrics": [
    "Total Spend",
    "Idle Instance Ratio",
    "Reserved Instance Coverage"
  ],
  "data_points": {
    "total_spend": "$450,000",
    "prev_period": "$380,000",
    "idle_ratio": "22%"
  },
  "include_risk_assessment": true,
  "target_word_count": 1500
}

→

👁️ Session UI Output

Overview

Data Analysis

Outline

Recommendations

# Report Generation

Topic: Q3 Cloud Infrastructure Costs

PHASE 1: DATA ANALYSIS

✅ Complete: 3 metrics analyzed

PHASE 2: REPORT STRUCTURE

✅ Complete: Outline created (5 sections)

PHASE 3: CONTENT GENERATION

⏳ Writing Section 3: Cost Optimization Patterns...

Generating: 850 / 1500 words

Live Results Showcase

Explore actual artifacts and reports generated by this task in the test workspace.

Configuration Parameters

Field	Type	Description
`report_topic`*	String	The subject or topic of the report.
`report_type`	String	Type of report (e.g., `status_update`, `quarterly_review`, `incident_report`).
`target_audience`	String	Target audience (e.g., `executives`, `stakeholders`).
`time_period`	String	Time period covered (e.g., `Q1 2024`, `Last 30 days`).
`key_metrics`	List<String>	Specific KPIs to include in the analysis.
`data_points`	Map<String, Any>	Raw statistics or data points to analyze.
`include_trend_analysis`	Boolean	Compare to previous periods. Default: `true`.
`include_visualizations`	Boolean	Include chart/table descriptions. Default: `true`.
`include_executive_summary`	Boolean	Include high-level dashboard. Default: `true`.
`include_recommendations`	Boolean	Include actionable steps. Default: `true`.
`include_comparative_analysis`	Boolean	Include benchmarks/competitors. Default: `true`.
`include_risk_assessment`	Boolean	Whether to include a dedicated risk and mitigation section. Default: `true`.
`tone`	String	Tone (e.g., `formal`, `analytical`). Default: `professional`.
`target_word_count`	Int	Target length for the complete report. Default: `2000`.
`revision_passes`	Int	Number of LLM editing passes (0-5). Default: `1`.
`related_files`	List<String>	Context files to incorporate.
`input_files`	List<String>	Glob patterns for source data (e.g. `*/.json`).

Direct Instantiation


val reportTask = ReportGenerationTask(
    orchestrationConfig = config,
    planTask = ReportGenerationTask.ReportGenerationTaskExecutionConfigData(
        report_topic = "Annual Security Audit",
        report_type = "incident_report",
        target_audience = "board_of_directors",
        include_risk_assessment = true,
        revision_passes = 2,
        input_files = listOf("docs/security/*.md", "logs/audit_summary.json")
    )
)

Embedded Execution (Headless)

Use the UnifiedHarness to run this task as part of an automated pipeline.


import com.simiacryptus.cognotik.plan.tools.writing.ReportGenerationTask
import com.simiacryptus.cognotik.plan.tools.writing.ReportGenerationTask.ReportGenerationTaskExecutionConfigData
harness.runTask(
    taskType = ReportGenerationTask.ReportGeneration,
    typeConfig = TaskTypeConfig(),
    executionConfig = ReportGenerationTaskExecutionConfigData(
        report_topic = "System Architecture Review",
        report_type = "performance_analysis",
        input_files = listOf("src/**/*.kt", "docs/arch/*.md"),
        target_audience = "stakeholders"
    ),
    workspace = File("./project-dir"),
    autoFix = true
)

Test Case Example: Automated Security Audit

A common scenario for CI/CD integration.


// Input Configuration
{
  "report_topic": "Weekly Security Vulnerability Scan",
  "report_type": "incident_report",
  "input_files": ["build/reports/dependency-check-report.json"],
  "key_metrics": ["Critical Vulnerabilities", "High Risk Dependencies"],
  "include_risk_assessment": true,
  "tone": "technical"
}
// Expected Output
// 1. Analysis of JSON scan results
// 2. Categorized risk assessment of found CVEs
// 3. Actionable patching recommendations
// 4. Final report saved to: webui/workspaces/ReportGenerationTask/reports/report_*.md

Prompt Segment

The following logic is injected into the LLM context when this task is active:


ReportGeneration - Generate comprehensive business reports with data analysis and recommendations
  ** Specify the report topic and type (status update, quarterly review, incident report, etc.)
  ** Define target audience and time period
  ** Provide key metrics, KPIs, and data points to analyze
  ** Enable trend analysis, visualizations, and comparative analysis
  ** Include executive summary/dashboard for quick insights
  ** Generate actionable recommendations based on findings
  ** Assess risks and challenges
  ** Produces complete, professional report with clear structure

ReportGenerationTask

# Report Generation

Live Results Showcase

Configuration Parameters

The Industrial Generation Lifecycle

1. Data Analysis

2. Outline Creation

3. Content Generation

4. Strategic Recommendations

5. Risk Assessment

6. Revision & Polish

7. Final Assembly

Direct Instantiation

Embedded Execution (Headless)

Test Case Example: Automated Security Audit

Prompt Segment