Skip to content

feat: Coverage with visual progress bars#4

Merged
binaryk merged 2 commits into
mainfrom
feature/coverage_report
Jan 26, 2026
Merged

feat: Coverage with visual progress bars#4
binaryk merged 2 commits into
mainfrom
feature/coverage_report

Conversation

@gabrielmpetrescu
Copy link
Copy Markdown
Collaborator

This pull request introduces a new documentation coverage analysis feature to the aidocs CLI, allowing users to assess how well their codebase is documented. The main changes include the addition of the aidocs coverage command, updates to documentation and architecture guides, and a version bump to reflect the new functionality.

New Documentation Coverage Feature:

  • Added a coverage command to the CLI that scans the codebase for routes, components, and models, and checks which items are mentioned in the documentation. The command supports summary, JSON, and CSV output formats, CI integration, custom thresholds, and various display options.
  • Updated CLI architecture documentation in CLAUDE.md to include the new coverage.py module and its responsibilities. [1] [2]
  • Added a detailed usage guide and options for aidocs coverage in the main README.md, including example output, supported frameworks, and CI/CD integration instructions.

Other Changes:

  • Bumped the package version to 0.18.0 in pyproject.toml to reflect the addition of the coverage feature.
  • Imported new coverage analysis functions into the CLI implementation.

Comment thread README.md
Comment on lines +597 to +605
**Supported frameworks:**
- **Next.js** - App Router routes and pages
- **React** - Function and class components
- **Vue/Svelte** - Single-file components
- **Express** - Route handlers
- **FastAPI/Flask** - Python API routes
- **Laravel** - PHP routes
- **Prisma** - Database models
- **TypeScript** - Interfaces and types
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no need here

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove only this part or all the changes in readme.md ?

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces a comprehensive documentation coverage analysis feature to the aidocs CLI, enabling developers to measure how well their codebase is documented. The feature scans for routes, components, and models across multiple frameworks and checks which items are mentioned in the documentation, providing coverage metrics with visual progress bars.

Changes:

  • Added a new coverage command that analyzes documentation coverage for routes, components, and models with support for Next.js, React, Vue, Svelte, Express, FastAPI, Flask, Laravel, and Prisma
  • Implemented multiple output formats (summary with progress bars, JSON, CSV) and CI integration with configurable coverage thresholds
  • Updated documentation (README.md and CLAUDE.md) with usage examples and architecture details

Reviewed changes

Copilot reviewed 5 out of 6 changed files in this pull request and generated 7 comments.

Show a summary per file
File Description
src/aidocs_cli/coverage.py New module implementing coverage analysis with framework detection, pattern-based code scanning, and documentation reference matching
src/aidocs_cli/cli.py Added coverage command with helper functions for progress bars, color coding, and three output format handlers (summary, JSON, CSV)
pyproject.toml Bumped version to 0.18.0 to reflect new feature
uv.lock Updated lock file with version 0.18.0 (dependencies python-dotenv and watchdog already used elsewhere)
README.md Added comprehensive documentation for the coverage command including options, examples, supported frameworks, and CI/CD integration
CLAUDE.md Updated architecture documentation to include the new coverage module and its responsibilities

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread src/aidocs_cli/cli.py Outdated
Comment thread src/aidocs_cli/coverage.py Outdated
Comment thread src/aidocs_cli/coverage.py Outdated
Comment thread src/aidocs_cli/coverage.py Outdated
Comment thread src/aidocs_cli/cli.py Outdated
Comment thread src/aidocs_cli/coverage.py
Comment thread src/aidocs_cli/coverage.py
@binaryk binaryk merged commit 49c57d7 into main Jan 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants