Validate Test Coverage Report

Overview

You send a coverage report from JaCoCo, Cobertura, Clover, LCOV, or Istanbul, inline or as a file you uploaded, and we work out the format, read the covered and total counters out of it, and recompute every percentage ourselves rather than trusting the numbers printed in the file. Then we hold it to your rules — an overall bar, a bar every file has to clear, or a stricter bar for the files a change touched — and hand back one entry per rule that was missed. Tests are never run and nothing is fetched.

Every coverage tool writes a different file and rounds its percentages its own way, so a bar that means one thing in one project quietly means another elsewhere.

When to use it

Scope

Non-goals

• Does not run your tests or produce the report
• Does not fetch a report from a URL or a build server
• Does not render coverage as HTML or any other view
• Does not tell you which lines are uncovered — only the counts per file

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

File limits

Constraints this skill applies to your input and generated files. The “Limited by” column shows the static source of each cap; none of these can be raised by upgrading your plan.

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"quality.validate_test_coverage_report","input":{"source":{"type":"inline","content":"TN:\nSF:a.js\nLF:10\nLH:5\nend_of_record\n"},"format":"lcov","thresholds":{"global":{"lines":80}}}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("quality.validate_test_coverage_report", {"format":"lcov","source":{"type":"inline","content":"TN:\nSF:src/a.js\nLF:10\nLH:5\nBRF:4\nBRH:2\nFNF:2\nFNH:2\nend_of_record\n"},"thresholds":{"global":{"lines":80}}});

Errors

Other limits

Limitations

• Does not run your tests or produce the report
• Does not fetch a report from a URL or a build server
• Does not render coverage as HTML or any other view
• Does not tell you which lines are uncovered — only the counts per file
• Running tests or generating the report
• Producing a browsable coverage view

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "quality.validate_test_coverage_report",
  "input": {
    "format": "lcov",
    "source": {
      "type": "inline",
      "content": "TN:\nSF:src/a.js\nLF:10\nLH:5\nBRF:4\nBRH:2\nFNF:2\nFNH:2\nend_of_record\n"
    },
    "thresholds": {
      "global": {
        "lines": 80
      }
    }
  }
}

Examples

{
  "format": "lcov",
  "source": {
    "type": "inline",
    "content": "TN:\nSF:src/a.js\nLF:10\nLH:5\nBRF:4\nBRH:2\nFNF:2\nFNH:2\nend_of_record\n"
  },
  "thresholds": {
    "global": {
      "lines": 80
    }
  }
}

{
  "metrics": {
    "functions": {
      "covered": 2,
      "percentage": 100,
      "total": 2
    },
    "lines": {
      "covered": 5,
      "percentage": 50,
      "total": 10
    },
    "branches": {
      "covered": 2,
      "percentage": 50,
      "total": 4
    }
  },
  "_meta": {
    "entriesRead": 1,
    "excludedEntries": 0
  },
  "violations": [
    {
      "code": "GLOBAL_THRESHOLD_NOT_MET",
      "metric": "lines",
      "actual": 50,
      "required": 80,
      "path": null
    }
  ],
  "valid": false,
  "format": "lcov",
  "warnings": []
}

{
  "format": "lcov",
  "source": {
    "type": "inline",
    "content": "TN:\nSF:src/a.js\nLF:10\nLH:10\nend_of_record\n"
  },
  "thresholds": {
    "global": {
      "lines": 80
    }
  }
}

{
  "metrics": {
    "functions": {
      "covered": 0,
      "total": 0,
      "percentage": null
    },
    "lines": {
      "covered": 10,
      "percentage": 100,
      "total": 10
    },
    "branches": {
      "covered": 0,
      "total": 0,
      "percentage": null
    }
  },
  "_meta": {
    "entriesRead": 1,
    "excludedEntries": 0
  },
  "violations": [],
  "valid": true,
  "format": "lcov",
  "warnings": []
}

Recommended use cases

• Stop a merge when coverage drops below the bar you agreed on
• Compare coverage across projects that use different report formats
• Hold the files a change touched to a higher bar than the rest

Avoid for

• Running tests or generating the report
• Producing a browsable coverage view

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags