File Content Processor

File: src/processors/file_content.py | Priority: 51 | Name: file_content

Content-aware compression for file viewing commands. Instead of blind head/tail truncation, detects content type and applies a specialized strategy.

Supported Commands

cat, head, tail, bat, less, more.

Content Type Detection

Content Type	Detection	Strategy
Code	Extension: .py, .js, .ts, .tsx, .jsx, .go, .rs, .java, .kt, .c, .cpp, .h, .hpp, .rb, .php, .swift, .scala, .tf, .hcl, .sh, .bash, .zsh, .ps1, .lua, .r, .m, .cs, .vb, .pl, .pm, .ex, .exs, .hs, .ml, .vue, .svelte, .dart, .zig, .nim, .v, .groovy, .sql, .md, .rst	Keeps imports/headers (first 20 lines), function/class/method signatures + 3 body lines, TODO/FIXME/HACK/BUG/XXX markers. Summary: (N total lines, M definitions found, K lines omitted)
Config	Extension: .json, .yaml, .yml, .toml, .ini, .cfg, .xml, .env, .properties, .plist, .conf	JSON: parsed structure with top-level keys, truncated arrays/strings. YAML: keeps indent <= 2 lines. XML: keeps indent <= 4 lines. INI/TOML/CFG: keeps section headers and key=value lines
Logs	Extension or heuristic (> 30% lines match timestamp/log-level patterns)	Keeps first 5 + last 5 lines (temporal context), ERROR/WARN/FATAL with +/- 2 context lines, counts INFO/DEBUG lines
CSV/TSV	Extension (.csv, .tsv) or heuristic (consistent separators)	Header + 5 first data rows + 3 last rows + (N data rows, M columns)
Unknown	Fallback	Head/tail truncation: first 150 + last 50 lines

Configuration

Parameter	Default	Description
max_file_lines	300	Threshold before compression kicks in
file_keep_head	150	Lines from start (fallback strategy)
file_keep_tail	50	Lines from end (fallback strategy)
file_code_head_lines	20	Import/header lines for code files
file_code_body_lines	3	Body lines per definition
file_log_context_lines	2	Context lines around errors in logs
file_csv_head_rows	5	Data rows from start of CSV
file_csv_tail_rows	3	Data rows from end of CSV

Definition Detection

Recognizes function/class/method/interface/enum/trait/impl/struct signatures in: Python, JavaScript/TypeScript, Go, Rust, Java/Kotlin/C#, C/C++, Ruby, PHP, Shell.

The C/C++ pattern requires a return type keyword (void, int, char, float, double, bool, auto, size_t, std::*, struct/enum/class names, *_t types) to avoid false positives on any line containing parentheses.