LLM LCD log summary

Scope: this document describes an optional feature pair (llm-summary-suite + llm-summary node assignment), not suite-wide architecture.

The summary domain ships a local in-process workflow that produces extremely sparse LCD summaries for recent system logs. Runtime execution is gated by the LLM Summary Suite feature (llm-summary-suite) and connected to the LLM Summary node feature (llm-summary), which is only assigned by default to Control nodes.

How it works

  • A periodic Celery task (summary.tasks.generate_lcd_log_summary) runs every five minutes when the node feature is enabled.
  • The task reads log files under the configured log directory and only ingests content that has changed since the prior run.
  • Logs are compacted deterministically (timestamps, UUIDs, IPs, and long hex sequences are normalized) before being passed to the summarizer.
  • The built-in deterministic backend emits 8–10 short subject/body pairs sized for a 16x2 LCD, favoring shorthand and symbols.
  • Each subject/body pair is written to the low LCD lock file every 30 seconds.
Loading remaining sections…