Gen2ReportAnalysis

Gen2ReportAnalysis

Gen2 analysis skill for producing markdown reports from mined domain logs.

Execution

python gen2_report_analysis.py --timeframe <YYYY|YYYY/MM|YYYY/MM/DD> --prompt "" --max-files --max-chars-per-file --max-total-chars --llm-timeout

Arguments

• domain required alphabetic string only A-Z or a-z
• --timeframe required supports YYYY or YYYY/MM or YYYY/MM/DD (also accepts '-')
• --prompt required LLM report instruction
• --max-files optional default 200
• --max-chars-per-file optional default 6000
• --max-total-chars optional default 180000
• --llm-timeout optional default 90

Report structure enforced

• Output is markdown (.md)
• Includes ## Table of Contents near the top
• TOC uses paragraph numbers (e.g., 1. Introduction .... paragraph 1)
• First section title is always Introduction
• Last section title is always Summary
• Middle sections are generated from prompt + corpus

LLM configuration

Uses OpenAI-compatible Chat Completions API with environment variables:

• OPENAI_API_KEY required
• OPENAI_MODEL optional default gpt-4o-mini
• OPENAI_BASE_URL optional default https://api.openai.com/v1

Behavior

1. Resolves input folders from 01-Mine/<domain> using FolderNavigator.
2. Loads .txt files matching timeframe.
3. Builds bounded corpus.
4. Sends corpus + prompt to LLM with a structured section contract.
5. Normalizes sections and writes markdown report to 02-Analysis/<domain>/<matching timeframe>/.

Output

On success returns JSON with:

• domain
• timeframe
• files_analyzed
• output_path
• sections
• status

On error returns JSON with:

• domain
• timeframe
• error
• status