You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This issue collects advisory findings from Hive agents.
At lower ACMM levels, some agents work in advisory mode β they analyze code and post findings here but do not create issues or PRs. At higher levels, designated agents (e.g. quality) can open issues and PRs directly, while other agents remain advisory-only.
The governor posts periodic digest comments summarizing what advisory agents found.
Automated code review findings from Hive agents. Each finding includes a file reference and suggested fix. This comment is updated periodically.
Advice
Frozen for governor mode QUIET until 2026-11-19 (next review in 1 day(s)). The list of recommendations is frozen; their numbers, items and links are recomputed on every digest.
Counts quoted: governor actionable queue 2 PRs / 6 issues (what mode and cadence key on; excludes held, draft, in-review and human-gated items) β Overview chart 6 open PRs / 35 open issues (every open or held item across repo cards; the queue-health advice counts these).
Reduce the blocked PR queue β No longer applies: the signal that triggered this advice has cleared since the epoch began.
Clear the human gate on PRs β 4 of 6 open PRs (66%) wait on a human: 4 held, 0 labelled needs-human, 0 needs-decision β release, review, or close them. (signals: overview_open_prs=6, needs_human=4, held=4, needs_human_label=0, needs_decision=0)
Bands named above (same rules as the Overview chart):
Needs human (PRs): held, or labelled needs-human, stage/085-needs-decision, needs-decision, 2-discussing, blocked, stage/045-needs-decision, epic, needs-triage β a human must review, decide, or release the hold before automation continues
Findings: 10
π‘ Showing top 10 findings (by severity). 79 more exist. Set governor.advisory.show_all: true to see all.
Severity
Count
π high
10
π HIGH (10)
[coverage-gap] docusaurus.config.ts isProd-dependent url/editUrl branches had no unit coverage docusaurus.config.tsquality
docusaurus.config.ts is excluded from the c8 coverage gate. Its three isProd-dependent fields (top-level url, docs preset editUrl, analyses plugin editUrl) had no unit assertion, and no end-to-end check asserts their values (Netlify deploy-preview only exercises the non-prod branch incidentally, without assertion; the prod branch never runs on PRs at all). Added lib/docusaurusConfigBuildContext.test.mts + test-only harness in PR test: cover isProd-dependent url/editUrl branches in docusaurus.config.tsΒ #413 (cncf/techdocs), tracked under issue [quality] npm run typecheck fails on main β merge race between #404 and #405Β #407's component cluster.
[coverage-gap] docusaurus.config.ts markdown.preprocessor: reference-style link (]:) branch untested docusaurus.config.tsquality
markdown.preprocessor regex has two alternatives (inline '](' links and reference-style ']:' link definitions); only the inline branch was unit-tested. Manual mutation (deleting the ']:\s*' alternative at rev 418adeb) passed all existing tests, confirming the gap. No e2e/integration suite exists in this repo to provide alternate coverage, so Priority 1. Fixed in PR techdocs#410 (closes issue techdocs#409).
[coverage-gap] cncf/techdocs docusaurus.config.ts markdown.preprocessor regex-rewrite has zero test coverage (file path not found at analyzed commit β finding may be outdated)(reported 2Γ)quality
markdown.preprocessor (docusaurus.config.ts:44-50) runs a regex rewrite (strips .md from site-absolute /docs|analyses links) against the imported root README.md. Unit evidence: lib/**/*.test.mts (node --experimental-strip-types --test) has no test file for docusaurus.config.ts; function is untested. E2E evidence: no e2e/integration suite exists in this repo (checked for playwright/cypress dirs, none found; only format-check/link-check/spell-check CI). Covered by neither unit nor end-to-end tests -> Priority 1 ceiling, set to 2 (medium) given narrow impact (single README.md import path). Provenance: cncf/techdocs main@4b1f800, checked 2026-11-12. Root cause: logic is inlined in docusaurus.config.ts, which imports ./lib/getBuildContext and ./lib/remarkRewriteLinks without file extensions -- fine for docusaurus webpack bundler but unresolvable under this repo's own node --experimental-strip-types test runner (reproduced: ERR_MODULE_NOT_FOUND). Testing it directly therefore requires extracting the regex into its own lib/ module first, which is a production-code change outside quality agent scope (no production code / no refactors). Filed as issue-only; no PR possible without that extraction.
[coverage-gap] lib/remarkRewriteLinks/index.ts: 4 branches uncovered by unit tests (89.74% branch coverage) lib/remarkRewriteLinks/index.tsquality
rewriteHref() in lib/remarkRewriteLinks/index.ts had 4 uncovered branches (c8 --reporter=text on node --experimental-strip-types --test 'lib/**/*.test.mts', local run against HEAD, 2026-11-11): (1) line 87, empty-path-after-split short-circuit (href consisting only of a query/fragment, e.g. '?x'); (2) line 99, the cross-plugin capture group 2 being undefined (a bare '../docs' with no sub-path); (3) line 112, the .mdx branch of the site-absolute strip-extension ternary; (4) line 140, file.path being undefined in the remark plugin wrapper. Repo has no end-to-end/integration suite (CI only runs format-check.yml, link-check.yml, spell-check.yml per [quality] npm run test:unit never runs in CI β unit tests have no CI signalΒ #390), so these branches were covered by neither unit nor end-to-end tests -> Priority 1.
[missing-workflow] cncf/techdocs: unit tests and c8 coverage gate (test:coverage) are never invoked by any CI workflow cncf/techdocs#415quality
format-check.yml/link-check.yml/spell-check.yml only run check:format, check:markdown, check:links, check:spelling. package.json 'check' aggregates only check:* scripts. No workflow calls npm run test:unit or npm run test:coverage, so the 52 existing unit tests and the 99/99/97/100 c8 coverage gate enforce nothing on PRs. Fix requires a .github/workflows/ change, which this agent's contributor-tier token cannot push; filed as issue only.
[missing-workflow] No CI workflow runs the unit test suite, typecheck, or coverage gate .github/workflows/(reported 2Γ)quality
package.json defines test:unit (52 node:test specs under lib//*.test.mts and scripts//*.test.mjs, including scripts/typecheck.test.mjs which shells out to tsc), test:coverage (c8 wrapping test:unit with a 97-100% coverage gate), and typecheck, but .github/workflows only contains format-check.yml, link-check.yml, spell-check.yml, trigger-contribute-site-netlify.yml, and copilot-setup-steps.yml. None of them run npm run test:unit, npm run test:coverage, or npm run typecheck on pull_request. A regression in any of the 52 unit tests, a drop below the coverage thresholds, or a typecheck break (as happened with the TS5102/TS2339 regression PR test: fix typecheck regression from #404/#405 merge raceΒ #408 fixes) can merge to main without CI ever catching it.
[test-gap]techdocs#415: npm test:coverage (99/99/97/100 gate) never invoked by any GitHub Actions workflow #415scanner
Confirmed independently: .github/workflows/format-check.yml, link-check.yml, and spell-check.yml run check:format/check:markdown/check:links/check:spelling respectively, but no workflow runs 'npm run test:unit' or 'npm run test:coverage' (c8 gate: --lines 99 --statements 99 --branches 97 --functions 100). package.json's aggregate 'check' script only picks up scripts matching check:*, excluding test:unit/test:coverage, so npm test (check && test:unit) is also never invoked in CI. A PR can merge a broken unit test or a coverage regression with all required checks green.
βοΈ Recently Closed β Fix Not Verified (3)
Closed on an agent's word or a hive heuristic (a merged PR's title matching the finding, or the issues/PRs it cites closing). The hive did not re-check the condition, so it may still hold.
PR Update analysis criteria questionsΒ #423 failing Format/Markdown/Spelling checks on docs/analysis/criteria.md and templates/analysis.md PR#423 format-check.yml,spell-check.ymlci-maintainer β closed Nov 18 (no evidence recorded), fix not verified
techdocs#390: confirmed β package.json test:unit script exists but no workflow invokes npm test/test:unit, only format/link/spell checks run in CI, so lib/*.test.mts regressions get green checks #390scanner β closed Nov 16 (the issues/PRs it cites closed), fix not verified
Analyzed at cncf/techdocs@ff6cca7f6c5a (branch main) β the latest commit when this digest was generated. File references that no longer exist at this commit are flagged as outdated. Findings marked β οΈ were computed at an older commit and have NOT been re-verified here.
Activity
hivecommons-hive commentedon Nov 10, 2026
π Advisory Digest β 2026-11-18 16:28 EST
Advice
Reduce the blocked PR queueβ No longer applies: the signal that triggered this advice has cleared since the epoch began.Bands named above (same rules as the Overview chart):
Findings: 10
π HIGH (10)
docusaurus.config.tsqualitydocusaurus.config.tsqualitylib/remarkRewriteLinks/index.tsquality.github/workflows/(reported 2Γ) qualitypackage.jsonqualityβοΈ Recently Closed β Fix Not Verified (3)
PR#423 format-check.yml,spell-check.ymlci-maintainer β closed Nov 18 (no evidence recorded), fix not verifiede2e/linkRewrite.test.mjsquality β closed Nov 17 (the issues/PRs it cites closed), fix not verifiedAnalyzed atβ οΈ were computed at an older commit and have NOT been re-verified here.
cncf/techdocs@ff6cca7f6c5a(branchmain) β the latest commit when this digest was generated. File references that no longer exist at this commit are flagged as outdated. Findings markedUpdated 111 times Β· last 2026-11-18T21:28:30Z