/plugadvpl:cobertura-doc

Compute Protheus.doc header coverage percentages per module or source_type.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/JoniPraia/plugadvpl --skill plugadvpl-cobertura-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: /plugadvpl:cobertura-doc
Source: https://github.com/JoniPraia/plugadvpl/tree/main/skills/cobertura-doc
Command: npx skills add https://github.com/JoniPraia/plugadvpl --skill plugadvpl-cobertura-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill finds which Protheus modules or source types have the lowest coverage of Protheus.doc headers, so you can prioritize refactoring where documentation is missing.

Core Features & Use Cases

  • Coverage by module: shows the percentage of functions that include a Protheus.doc header for each inferred Protheus module (e.g., SIGAFAT, SIGACOM).
  • Coverage by source type: groups coverage by source category (mvc, rest, cadastro, etc.) when module inference is incomplete.
  • Refactor priority ordering: sorts results by lowest coverage first (pct ASC) to drive action on the biggest documentation gaps.
  • Missing-module visibility: reports entries that cannot be mapped to a module under _sem_grupo.

Quick Start

Run /plugadvpl:cobertura-doc to get a coverage table sorted by worst pct first, highlighting which modules have the highest documentation gaps.

Frequently Asked Questions about /plugadvpl:cobertura-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check Protheus documentation coverage for ADVPL source files?

You can check Protheus documentation coverage by computing the percentage of functions that include Protheus.doc headers per module or source_type. This requires SQLite-backed indexed metadata to query and group the coverage data.

What is the best way to prioritize ADVPL refactoring when documentation is missing?

To prioritize ADVPL refactoring, you should sort documentation coverage results by lowest percentage first. This highlights modules or source types with the biggest documentation gaps, directing action to where Protheus.doc headers are most absent.

Does the documentation coverage analysis work with TLPP codebases?

Yes, the documentation coverage analysis applies to large ADVPL and TLPP codebases. It identifies functions lacking Protheus.doc headers and calculates coverage percentages across both source code types.

How do I find Protheus functions without Protheus.doc headers grouped by source type?

You can find functions lacking Protheus.doc headers by grouping coverage by source category, such as mvc, rest, or cadastro. This is useful when module inference is incomplete, showing totals and documentation percentages.

Do I need SQLite to analyze Protheus documentation gaps?

Yes, you need SQLite-backed indexed metadata to analyze Protheus documentation gaps. The Skill relies on this database to compute coverage percentages and output actionable prioritization lists.

What happens to Protheus functions that cannot be mapped to a specific module?

Protheus functions that cannot be mapped to a specific module are reported under a designated _sem_grupo entry. This ensures missing-module visibility is maintained during the documentation gap analysis.