Troubleshooting Guide Coverage Auditor

Analyze troubleshooting guides for step coverage, prerequisites, error-code coverage, escalation paths, screenshots/media references, and missing diagnostic branches.

What It Does

This actor analyzes authorized public troubleshooting guide URLs or supplied HTML snapshots. It extracts guide title, problem intent, prerequisite coverage, step count, error-code coverage, escalation path, missing branch, gap type, evidence, risk level, and recommendation.

What It Does Not Do

• It does not bypass logins, paywalls, CAPTCHAs, access controls, or private APIs.
• It does not infer private ticket volume, incident impact, or product reliability.
• It does not change source sites, private systems, or publication settings.

Example Input

{
  "startUrls": [
    "https://docs.github.com/en/actions/how-tos/troubleshoot-workflows",
    "https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/troubleshooting-two-factor-authentication-issues",
    "https://docs.github.com/en/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors"
  ],
  "maxPages": 1,
  "maxDepth": 0,
  "includePatterns": [
    "/en/"
  ],
  "excludePatterns": [
    "/login",
    "/admin"
  ],
  "requestDelayMs": 250,
  "timeoutMs": 20000,
  "maxRecords": 10,
  "respectRobotsTxt": true,
  "redactQueryStrings": true,
  "maxChargeUsd": 20,
  "debug": false
}

Output Fields

• actorSlug
• runId
• crawlTimestamp
• sourceUrl
• pageUrl
• status
• statusCode
• evidence
• issueCode
• riskLevel
• recommendation
• guideUrl
• guideTitle
• problemIntent
• hasPrerequisites
• stepsCount
• hasErrorCodes
• hasEscalationPath
• missingBranch
• gapType

Pricing And Cost Controls

• Pricing model: Pay per event.
• Platform usage pass-through: OFF.
• Default max charge: $20.00.
• Events: actor-start, troubleshooting-guide-processed, coverage-check-record-extracted, coverage-gap-emitted, and executive-report-generated.