[spec-librarian] Specification Audit — 2026-07-08 — 1 issue found

[github-actions]

📚 Package Specification Audit Report

Date: 2026-07-08
Total Packages: 32
Packages with Specs: 32
Coverage: 100%
Run: §28947411529

---

Coverage Summary

All 32 packages under pkg/ have README.md specifications. Coverage is at 100% — no missing specs.

Status	Package	Exported Symbols	README Lines	Notes
✅	actionpins	17	125	—
✅	agentdrain	20	295	—
✅	cli	469	510	—
✅	colorwriter	4	50	—
✅	console	98	940	—
✅	constants	244	550	—
✅	envutil	3	128	—
✅	errorutil	3	52	—
✅	fileutil	8	80	—
✅	github	3	120	—
✅	gitutil	9	99	—
✅	importinpututil	2	99	—
✅	intent	11	113	—
✅	jsonutil	1	47	—
⚠️	linters	293	234	README ratio thin for symbol count; see details
✅	logger	5	266	—
✅	modelsdev	3	54	—
⚠️	parser	123	318	3 undocumented internal dependencies
✅	repoutil	2	42	—
✅	semverutil	8	149	—
✅	setutil	1	39	—
✅	sliceutil	9	76	—
✅	stats	1	63	—
✅	stringutil	27	319	Updated with StripANSI unit test in PR #44277
✅	styles	36	146	—
✅	syncutil	1	70	—
✅	testutil	4	61	—
✅	timeutil	3	107	—
✅	tty	2	55	—
✅	types	5	179	—
✅	typeutil	11	167	—
✅	workflow	704	725	—

---

🚨 Missing Specifications

None. All 32 packages have README.md specification files. ✅

---

⚠️ Stale Specifications

All specifications share the same commit date (2026-07-08) as their source files. The repository has a single commit history for this branch. No staleness issues detected.

---

🔄 Cross-Package Inconsistencies

View inconsistencies (1 issue found)

Dependency Mismatch — pkg/parser README (Medium priority)

The pkg/parser/README.md Dependencies section lists 12 internal packages, but the actual Go source (non-test files) imports 3 additional packages that are not documented:

Missing Package	Description
pkg/envutil	Used in github_wasm.go and import_observability.go
pkg/importinpututil	Used in import_input_substitution.go
pkg/setutil	Used in import_cycle.go and import_topological.go

These packages appear in live imports but are absent from the ## Dependencies > Internal list in pkg/parser/README.md.

Recommendation: Add envutil, importinpututil, and setutil to the ## Dependencies section of pkg/parser/README.md.

---

📊 Quality Scores

Package	Completeness	Accuracy	Consistency	Freshness	Overall
console	95%	95%	90%	100%	✅ 95%
constants	90%	95%	90%	100%	✅ 94%
cli	90%	90%	90%	100%	✅ 93%
workflow	90%	90%	90%	100%	✅ 93%
stringutil	95%	95%	90%	100%	✅ 95%
styles	95%	95%	85%	100%	✅ 94%
linters	85%	95%	85%	100%	✅ 91%
parser	80%	80%	85%	100%	⚠️ 83%
github	90%	90%	85%	100%	✅ 91%
logger	90%	90%	85%	100%	✅ 91%
types	90%	90%	85%	100%	✅ 91%
agentdrain	90%	90%	85%	100%	✅ 91%
testutil	90%	90%	90%	100%	✅ 93%
(remaining 19)	90%+	90%+	85%+	100%	✅ 91%+

Note: linters has 293 exported symbols (spread across 41 subpackages) but only 234 lines in its top-level README. This is expected given the namespace-only pattern (each subpackage has its own analyzer); the overview table covers all subpackages adequately. Quality is ✅ Good.

---

Action Items

• Update pkg/parser/README.md to document the 3 undocumented internal dependencies (envutil, importinpututil, setutil) in the ## Dependencies section.
• When opening a fix PR for this issue, include Closes #<this issue number> (or Fixes/Resolves) in the PR description.

---

📚 Next review scheduled for tomorrow. Close this issue once all items are resolved.

📚 Specification review by Package Specification Librarian · 145.6 AIC · ⌖ 6.7 AIC · ⊞ 6K · ◷

• expires on Jul 11, 2026, 5:56 AM UTC-08:00