f324648c10
Adds think, checkpoint, and flag tools for agent reasoning visibility: - think: records observation/hypothesis/next_action before investigation - checkpoint: summarizes learned/unknown/next_phase after file clusters - flag: marks notable findings to flags.jsonl with severity levels Additional changes: - Step numbering in investigation system prompt - Text blocks from agent now printed to stderr (step labels visible) - flag tool available in both investigation and synthesis passes - analyze_directory() returns (brief, detailed, flags) three-tuple - format_flags() in report.py renders flags sorted by severity - Per-directory max_turns increased from 10 to 14 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
137 lines
4 KiB
Python
137 lines
4 KiB
Python
"""Report formatting — human-readable terminal output."""
|
|
|
|
|
|
_SEVERITY_ORDER = {"critical": 0, "concern": 1, "info": 2}
|
|
|
|
|
|
def format_flags(flags):
|
|
"""Format a list of flag dicts as a human-readable string.
|
|
|
|
Returns empty string if flags is empty.
|
|
"""
|
|
if not flags:
|
|
return ""
|
|
|
|
sorted_flags = sorted(flags, key=lambda f: _SEVERITY_ORDER.get(
|
|
f.get("severity", "info"), 99))
|
|
|
|
lines = []
|
|
lines.append("")
|
|
lines.append(">> FLAGS")
|
|
lines.append("-" * 40)
|
|
for f in sorted_flags:
|
|
severity = f.get("severity", "info").upper()
|
|
path = f.get("path", "general")
|
|
finding = f.get("finding", "")
|
|
lines.append(f" [{severity:<8s}] {path}")
|
|
lines.append(f" {finding}")
|
|
|
|
return "\n".join(lines)
|
|
|
|
|
|
def format_report(report, target, flags=None):
|
|
"""Format the full report as a human-readable string."""
|
|
sep = "=" * 60
|
|
lines = []
|
|
|
|
lines.append(sep)
|
|
lines.append(f" LUMINOS — File System Intelligence Report")
|
|
lines.append(f" Target: {target}")
|
|
lines.append(sep)
|
|
|
|
# AI brief summary (top of report)
|
|
ai_brief = report.get("ai_brief", "")
|
|
if ai_brief:
|
|
lines.append("")
|
|
lines.append(">> SUMMARY (AI)")
|
|
lines.append("-" * 40)
|
|
for paragraph in ai_brief.split("\n"):
|
|
lines.append(f" {paragraph}")
|
|
|
|
# Directory tree
|
|
lines.append("")
|
|
lines.append(">> DIRECTORY TREE")
|
|
lines.append("-" * 40)
|
|
lines.append(report.get("tree_rendered", "(unavailable)"))
|
|
|
|
# File type summary
|
|
lines.append("")
|
|
lines.append(">> FILE TYPE INTELLIGENCE")
|
|
lines.append("-" * 40)
|
|
cats = report.get("file_categories", {})
|
|
if cats:
|
|
total = sum(cats.values())
|
|
for cat in sorted(cats, key=cats.get, reverse=True):
|
|
count = cats[cat]
|
|
bar = "#" * min(count, 40)
|
|
lines.append(f" {cat:<12} {count:>4} {bar}")
|
|
lines.append(f" {'TOTAL':<12} {total:>4}")
|
|
else:
|
|
lines.append(" No files found.")
|
|
|
|
# Languages & LOC
|
|
lines.append("")
|
|
lines.append(">> CODE DETECTION")
|
|
lines.append("-" * 40)
|
|
langs = report.get("languages", [])
|
|
loc = report.get("lines_of_code", {})
|
|
if langs:
|
|
lines.append(f" Languages detected: {', '.join(langs)}")
|
|
lines.append("")
|
|
lines.append(" Lines of code:")
|
|
for lang in sorted(loc, key=loc.get, reverse=True):
|
|
lines.append(f" {lang:<20} {loc[lang]:>8} lines")
|
|
lines.append(f" {'TOTAL':<20} {sum(loc.values()):>8} lines")
|
|
else:
|
|
lines.append(" No source code files detected.")
|
|
|
|
large = report.get("large_files", [])
|
|
if large:
|
|
lines.append("")
|
|
lines.append(" Unusually large files:")
|
|
for f in large:
|
|
lines.append(f" ! {f['name']} ({', '.join(f['reasons'])})")
|
|
|
|
# Recency
|
|
lines.append("")
|
|
lines.append(">> RECENTLY MODIFIED FILES")
|
|
lines.append("-" * 40)
|
|
recent = report.get("recent_files", [])
|
|
if recent:
|
|
for i, f in enumerate(recent, 1):
|
|
lines.append(f" {i:>2}. {f['modified_human']} {f['name']}")
|
|
lines.append(f" {f['path']}")
|
|
else:
|
|
lines.append(" No recent files found.")
|
|
|
|
# Disk usage
|
|
lines.append("")
|
|
lines.append(">> DISK USAGE — TOP DIRECTORIES")
|
|
lines.append("-" * 40)
|
|
top = report.get("top_directories", [])
|
|
if top:
|
|
for d in top:
|
|
lines.append(f" {d['size_human']:>10} {d['path']}")
|
|
else:
|
|
lines.append(" No usage data available.")
|
|
|
|
# AI detailed breakdown (end of report)
|
|
ai_detailed = report.get("ai_detailed", "")
|
|
if ai_detailed:
|
|
lines.append("")
|
|
lines.append(">> DETAILED AI ANALYSIS")
|
|
lines.append("-" * 40)
|
|
for paragraph in ai_detailed.split("\n"):
|
|
lines.append(f" {paragraph}")
|
|
|
|
# Flags
|
|
flags_text = format_flags(flags or [])
|
|
if flags_text:
|
|
lines.append(flags_text)
|
|
|
|
lines.append("")
|
|
lines.append(sep)
|
|
lines.append(" End of report.")
|
|
lines.append(sep)
|
|
|
|
return "\n".join(lines)
|