🔍 Upkeep Report

[github-actions]

🔍 Upkeep Report

Generated 2026-08-21T21:29:05.289Z

The repository is in strong health: of six enabled reviewers, four (docs_staleness, duplicate_orphan, spec_flow, visual_icon) returned zero findings, and the two that did (code_hygiene, convention) surface the same single, low-severity documentation drift rather than distinct problems. The one issue to address is a stale file reference in CLAUDE.md line 45, which attributes the finalize/degradation helpers to src/report.ts when they actually live in src/finalize.ts; because CLAUDE.md instructs developers to 'follow that pattern for new parsers,' correcting the pointer to src/finalize.ts is the top (and effectively only) priority. No spec/code mismatches, orphaned assets, or convention violations of substance were detected.

Summary

Severity	Count
🔴 High	0
🟠 Medium	0
🟡 Low	1
Total	1

Themes

LOW — CLAUDE.md mislocates the finalize/degradation helpers (points to src/report.ts instead of src/finalize.ts)

Two reviewers independently flagged the same drift: CLAUDE.md line 45 documents the malformed-input degradation pattern (returning {status: 'failed', findings: []}) as living 'via the finalize helpers in src/report.ts', but finalizeReviewerOutput() and finalizeSynthesis() are actually defined in src/finalize.ts (lines 7-17). src/report.ts merely imports and calls them. The code_hygiene reviewer filed it against src/finalize.ts (the true home of the helpers) and the convention reviewer filed it against CLAUDE.md (the stale documentation), but both point at one root cause: the convention doc names the wrong source file for a pattern developers are explicitly told to 'follow for new parsers,' sending them to the wrong location. The fix is a single doc edit — reference src/finalize.ts (consumed by src/report.ts).
Files: CLAUDE.md, src/finalize.ts, src/report.ts

Findings

Severity	Conf	File	Category	Reviewers	Problem
low	high	src/finalize.ts	inconsistency	code_hygiene, convention	The convention doc mislocates the degradation/finalize helpers. CLAUDE.md states the malformed-input degradation pattern is implemented 'via the finalize helpers in src/report.ts', but finalizeReviewerOutput() and finalizeSynthesis() (which return {status: 'failed', findings: []}) are actually defined in src/finalize.ts; src/report.ts only imports and calls them.

Full interactive HTML report: open this run → download the report-html artifact (expires 2026-11-19, ~90d).