towerops/docs/plans
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
..
2026-01-31-hibp-password-breach-checking-design.md Add design document for HIBP password breach checking 2026-01-31 17:16:58 -06:00
2026-02-01-cloudflare-timezone-detection-design.md Add design for Cloudflare timezone detection on signup 2026-02-01 10:56:07 -06:00
2026-02-01-cloudflare-timezone-detection.md Move CaptureTimezone plug to browser pipeline 2026-02-01 11:15:51 -06:00
2026-02-01-sudo-mode-mfa-only-design.md Add design doc for sudo mode MFA-only verification 2026-02-01 13:50:34 -06:00
2026-02-01-sudo-mode-mfa-only.md feat: implement sudo mode MFA-only verification controller 2026-02-01 14:34:17 -06:00
2026-02-02-gettext-internationalization-design.md docs: add gettext internationalization design 2026-02-02 09:33:01 -06:00
2026-02-06-job-monitoring-dashboard.md docs: add detailed implementation plan for job monitoring dashboard 2026-02-06 16:07:44 -06:00
2026-02-12-automatic-topology-inference-design.md feat: add automatic network topology inference 2026-02-12 13:28:01 -06:00
2026-02-12-automatic-topology-inference.md feat: add automatic network topology inference 2026-02-12 13:28:01 -06:00
2026-02-12-browser-navigation-fix-design.md docs: add browser navigation best practices and design document 2026-02-12 09:20:14 -06:00
2026-02-12-preseem-integration-design.md add preseem integration design and stage 1 plan docs 2026-02-13 09:01:02 -06:00
2026-02-12-preseem-stage1-foundation.md add preseem integration design and stage 1 plan docs 2026-02-13 09:01:02 -06:00
2026-03-06-dynamic-global-pricing-design.md docs: design for dynamic global pricing configuration 2026-03-06 13:18:47 -06:00
2026-03-24-data-retention.md add doc (#145) 2026-03-24 15:36:29 -05:00
2026-04-17-agent-readiness.md fix: correct login URL path in markdown negotiation content 2026-04-17 15:50:31 -05:00
2026-04-28-on-call-pagerduty-style-redesign.md chore: rate_limit rewrite + on-call redesign plan + handoff_notifications_mode 2026-04-28 12:17:29 -05:00
2026-05-09-llm-recommendations-and-frequency-rule.md feat(insights): LLM-powered insight enrichment 2026-05-09 16:41:48 -05:00
make-sites-optional.md make sites optional 2026-02-04 13:05:32 -06:00