Knowerage

What is Knowerage?

Knowerage is an MCP server that manages AI analysis coverage of a codebase. It tracks which files and line ranges have been analysed by an AI assistant, storing results as markdown documents and a registry. It is intended for developers using AI coding assistants who want to measure and manage what parts of their project have been covered.

How to use Knowerage?

Register the server in your MCP host configuration using npx @mtimma/knowerage and set the KNOWERAGE_WORKSPACE_ROOT environment variable to your project root. Once configured, you talk to your AI assistant in normal sentences—for example, “analyse the logical algorithm workflow in main.java” or “what part of this codebase is not yet analysed?”. The assistant creates or updates analysis documents under knowerage/analysis/ and records coverage in knowerage/registry.json.

Key features of Knowerage

• Create or update analysis documents with YAML frontmatter
• Reconcile analysis records for freshness (SHA‑256 hash based)
• Query file status: analysed vs. missing line ranges
• List stale or problematic registry records
• Export a coverage snapshot (JSON, YAML, TXT, or HTML)
• Generate a bundled export of selected analyses

Use cases of Knowerage

• Analyse a specific file, class, or algorithm and record the result
• Get an overall coverage percentage for a project
• Identify which parts of a codebase are not yet analysed
• Export a coverage report for auditing or sharing
• Detect stale analysis documents after source code changes

FAQ from Knowerage

What are the runtime requirements for Knowerage?

Node.js 18 or newer is required, and npx must be on your PATH.

How do I enable automatic file watching?

Set the environment variable KNOWERAGE_AUTO_FULL_RECONCILE to a truthy value (1, true, yes, or on). The server then watches the knowerage/ directory and runs a short debounced full reconciliation on filesystem changes.

How does Knowerage avoid infinite loops from registry writes?

The file watcher ignores writes to registry.json, so saving the registry does not trigger another reconciliation.

Where does Knowerage store analysis data?

All analysis markdown files live under knowerage/analysis/, and the coverage registry is stored at knowerage/registry.json in the project root.

What security measures does Knowerage implement?

All file paths are validated against the workspace root; path traversal (..) is rejected. Registry writes use atomic file operations for crash safety. No secrets are stored in analysis files or reports.