feat: AI explain mode, cache system, expanded coverage, server & MCP

[utkarsh232005]

This PR implements Phase 6 (AI Explain Mode), Phase 7 (Cache System & 17 new analyzers), and Phase 8 (HTTP/MCP server integration). Includes full test coverage and guidelines compliance.

Summary by CodeRabbit

• Documentation
  • Expanded and restructured feature documentation with detailed descriptions of AI-powered diagnostics, backend provider management, explanation caching, and custom analyzer configuration.
  • Added new sections covering server and MCP daemon modes, AI integration, and cache layers.
  • Updated feature status and future enhancements roadmap.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

Warning

.coderabbit.yaml has a parsing error

The CodeRabbit configuration file in this repository has a parsing error and default settings were used instead. Please fix the error(s) in the configuration file. You can initialize chat with CodeRabbit to get help with the configuration file.

💥 Parsing errors (2)

Validation error: Invalid input: expected string, received undefined at "reviews.path_instructions[3].path"; Invalid input: expected string, received undefined at "reviews.path_instructions[3].instructions"

⚙️ Configuration instructions

• Please see the configuration documentation for more information.
• You can also validate your configuration using the online YAML validator.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

📝 Walkthrough

Walkthrough

This PR expands the KDM documentation to detail AI diagnostics, backend provider management, explanation caching, custom analyzers, and server/MCP modes. New sections with example commands document each feature, and architecture layers describe configuration, AI integration, caching, and daemon modes. The future direction section is reframed to reflect implemented capabilities.

Changes

KDM Documentation Overhaul

Layer / File(s)	Summary
Feature capabilities summary docs/what-is-kdm.md	Updated the "What KDM Can Do" feature list to explicitly describe AI diagnostics, backend provider management, explanation caching, custom analyzer configuration, and kdm serve REST/MCP modes.
Detailed command and feature documentation docs/what-is-kdm.md	Added comprehensive sections documenting kdm analyze diagnostics with explain/anonymize/backends examples, kdm auth for provider configuration, kdm cache for explanation caching, kdm filters for analyzer filtering, kdm custom-analyzer for CRD registration, and kdm serve for HTTP/MCP server operation.
Configuration and architecture layers docs/what-is-kdm.md	Clarified that KDM stores local configuration via the conf package, and documented the AI integration client layer, SHA-256 keyed filesystem cache layer for diagnostic explanations, and server/MCP daemon layer exposing capabilities over HTTP or stdio.
Future direction and roadmap status docs/what-is-kdm.md	Reframed "Future Direction" from forward-looking roadmap to status update of implemented features (Kubernetes diagnostic analyzer engine, multi-backend AI explanations, caching, custom resource analyzers, MCP integrations), and updated future enhancement bullets.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

A rabbit documents with care,
KDM's features bright and fair! 🐰
From AI diagnostics to caching divine,
And MCP daemons that softly align,
The docs now tell the full design.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately reflects the main changes: AI explain mode, caching system, expanded analyzer coverage, and server/MCP integration modes.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[codescene-delta-analysis]

Our agent can fix these. Install it.

No application code in the PR — skipped Code Health checks.

Quality Gate Profile: The Bare Minimum
Install CodeScene MCP: safeguard and uplift AI-generated code. Catch issues early with our IDE extension and CLI tool.