towerops/docs
Graham McIntire 03f364a956 feat(insights): LLM-powered insight enrichment
Adds an optional plain-language summary and recommended action to every
active insight. A new Oban cron worker runs every 5 minutes, picks up
unenriched insights, and asks the configured LLM to restate the finding
and suggest one specific action grounded in the structured metadata.

- Migration: adds llm_summary, recommended_action, llm_model,
  llm_enriched_at columns to preseem_insights
- Towerops.LLM context with swappable behaviour; real client uses Req
  with the standard Req.Test plug for test isolation
- MockClient + InsightPrompt module (builds chat messages, parses JSON
  with code-fence stripping and a raw-text fallback)
- Worker logs and skips on rate limits / missing key / parse errors so
  insights still render without an AI summary when the LLM is unavailable
- Optional towerops-llm k8s secret with example template; deployment.yaml
  references it as optional in both init and main containers
- UI renders summary + recommended action callout on /insights and on
  the org-level insights page
2026-05-09 16:41:48 -05:00
..
features docs: update nix guide for TimescaleDB, add org settings and device monitoring docs 2026-02-14 11:28:57 -06:00
librenms-audit docs: add comprehensive priority vendors analysis for LibreNMS parity 2026-02-12 08:49:32 -06:00
plans feat(insights): LLM-powered insight enrichment 2026-05-09 16:41:48 -05:00
references remove-gleam (#218) 2026-03-29 11:03:20 -05:00
templates fix: input validation, SSRF, API hardening, and cookie security 2026-03-14 14:48:59 -05:00
ARCHITECTURE.md docs: replace flux/fluxcd references with argocd 2026-04-29 11:15:53 -05:00
COMPETITIVE_ANALYSIS.md fix: input validation, SSRF, API hardening, and cookie security 2026-03-14 14:48:59 -05:00
CONVENTIONS.md fix: input validation, SSRF, API hardening, and cookie security 2026-03-14 14:48:59 -05:00
librenms-feature-parity.md docs: add comprehensive LibreNMS feature parity summary 2026-02-12 12:01:55 -06:00
librenms-parity-audit-complete.md docs: add comprehensive LibreNMS parity audit report 2026-02-12 11:56:12 -06:00
lldp-topology-discovery-analysis.md docs: add LLDP topology discovery analysis from lldp2map research 2026-03-05 10:39:09 -06:00
NIX-VERIFICATION.md feat: Add comprehensive Nix flakes integration 2026-02-07 12:26:54 -06:00
nix.md docs: update nix guide for TimescaleDB, add org settings and device monitoring docs 2026-02-14 11:28:57 -06:00
README-nix-section.md feat: Add comprehensive Nix flakes integration 2026-02-07 12:26:54 -06:00
SECURITY_AUDIT_2026_03_14.md fix: input validation, SSRF, API hardening, and cookie security 2026-03-14 14:48:59 -05:00
SECURITY_AUDIT_API.md fix: input validation, SSRF, API hardening, and cookie security 2026-03-14 14:48:59 -05:00
SECURITY_AUDIT_INPUT_VALIDATION.md fix: input validation, SSRF, API hardening, and cookie security 2026-03-14 14:48:59 -05:00
terraform-coverages.md test: lift coverage to 78.42% and link Ansible collection in docs 2026-05-07 16:48:53 -05:00
TEST_COVERAGE.md fix: input validation, SSRF, API hardening, and cookie security 2026-03-14 14:48:59 -05:00