📚 Package Specification Audit Report
Date : 2026-07-17Total Packages : 32Packages with Specs : 32Coverage : 100%
Coverage Summary
All 32 packages under pkg/ have a README.md specification. However, 8 packages have source changes that post-date their most recent spec update.
Status
Package
Last Spec Update
Last Source Update
Days Behind
✅
agentdrain2026-07-11
2026-07-11
0
✅
colorwriter2026-07-15
2026-07-15
0
✅
console2026-07-15
2026-07-15
0
✅
envutil2026-07-08
2026-07-08
0
✅
errorutil2026-05-31
2026-05-31
0
✅
fileutil2026-06-14
2026-06-14
0
✅
github2026-07-10
2026-07-10
0
✅
gitutil2026-06-27
2026-06-27
0
✅
importinpututil2026-07-10
2026-07-10
0
✅
intent2026-07-06
2026-07-06
0
✅
jsonutil2026-05-23
2026-05-23
0
✅
logger2026-07-15
2026-07-15
0
✅
repoutil2026-07-10
2026-07-10
0
✅
setutil2026-07-06
2026-07-06
0
✅
sliceutil2026-06-25
2026-06-25
0
✅
stats2026-07-15
2026-07-15
0
✅
stringutil2026-07-15
2026-07-15
0
✅
styles2026-07-15
2026-07-15
0
✅
syncutil2026-07-10
2026-07-10
0
✅
testutil2026-07-07
2026-07-07
0
✅
timeutil2026-06-12
2026-06-12
0
✅
tty2026-06-25
2026-06-25
0
✅
types2026-07-11
2026-07-11
0
✅
typeutil2026-06-25
2026-06-25
0
⚠️ actionpins2026-07-15
2026-07-17
2
⚠️ cli2026-07-16
2026-07-17
1
⚠️ constants2026-07-15
2026-07-16
1
⚠️ linters2026-07-15
2026-07-17
2
⚠️ modelsdev2026-07-07
2026-07-15
8
⚠️ parser2026-07-15
2026-07-17
2
⚠️ semverutil2026-07-10
2026-07-16
6
⚠️ workflow2026-07-15
2026-07-17
2
⚠️ Stale Specifications
View stale specifications (8 packages) actionpins — Stale by 2 days
Spec last updated : 2026-07-15Source last updated : 2026-07-17Key change : PR fix: SHA-pinned actions lose version comment when SkipHardcodedFallback is set #46122 fix: SHA-pinned actions lose version comment when SkipHardcodedFallback is setSpec gap : PinContext.SkipHardcodedFallback field is present in source but not documented in README.md. The field controls whether version→SHA hardcoded fallback is skipped (relevant for non-github.com GH_HOST configurations).Recommendation : Add SkipHardcodedFallback bool to the PinContext fields table in the spec.
cli — Stale by 1 dayconstants — Stale by 1 daylinters — Stale by 2 days (with known gap)modelsdev — Stale by 8 daysparser — Stale by 2 dayssemverutil — Stale by 6 daysworkflow — Stale by 2 days
🔄 Cross-Package Inconsistencies
View inconsistencies (1 issue) Analyzer Registry Drift: linters doc.go vs README.md
📊 Quality Scores
Package
Completeness
Accuracy
Consistency
Freshness
Overall
Rating
actionpins85%
90%
90%
75%
85%
✅ Good
agentdrain90%
95%
90%
100%
93%
✅ Good
cli75%
85%
85%
85%
82%
✅ Good
colorwriter95%
95%
90%
100%
95%
✅ Good
console95%
95%
90%
100%
95%
✅ Good
constants85%
90%
90%
85%
88%
✅ Good
envutil90%
95%
90%
100%
93%
✅ Good
errorutil90%
95%
90%
100%
93%
✅ Good
fileutil90%
95%
90%
100%
93%
✅ Good
github85%
90%
85%
100%
90%
✅ Good
gitutil90%
90%
90%
100%
92%
✅ Good
importinpututil90%
90%
90%
100%
92%
✅ Good
intent90%
90%
90%
100%
92%
✅ Good
jsonutil90%
95%
90%
100%
93%
✅ Good
linters96%
90%
90%
75%
88%
✅ Good (1 missing analyzer)
logger90%
95%
90%
100%
93%
✅ Good
modelsdev80%
80%
85%
65%
77%
⚠️ Needs Attention
parser70%
80%
85%
75%
77%
⚠️ Needs Attention
repoutil90%
95%
90%
100%
93%
✅ Good
semverutil85%
85%
90%
70%
82%
✅ Good
setutil90%
95%
90%
100%
93%
✅ Good
sliceutil90%
95%
90%
100%
93%
✅ Good
stats90%
95%
90%
100%
93%
✅ Good
stringutil90%
95%
90%
100%
93%
✅ Good
styles90%
95%
90%
100%
93%
✅ Good
syncutil90%
95%
90%
100%
93%
✅ Good
testutil90%
95%
90%
100%
93%
✅ Good
timeutil90%
95%
90%
100%
93%
✅ Good
tty90%
95%
90%
100%
93%
✅ Good
types90%
95%
90%
100%
93%
✅ Good
typeutil90%
95%
90%
100%
93%
✅ Good
workflow65%
75%
85%
75%
75%
⚠️ Needs Attention
Action Items
📚 Next review scheduled for tomorrow. Close this issue once all items are resolved.
📚 Specification review by Package Specification Librarian · 115.3 AIC · ⌖ 8.22 AIC · ⊞ 6K · ◷
📚 Package Specification Audit Report
Date: 2026-07-17
Total Packages: 32
Packages with Specs: 32
Coverage: 100%
Coverage Summary
All 32 packages under
pkg/have aREADME.mdspecification. However, 8 packages have source changes that post-date their most recent spec update.agentdraincolorwriterconsoleenvutilerrorutilfileutilgithubgitutilimportinpututilintentjsonutilloggerrepoutilsetutilsliceutilstatsstringutilstylessyncutiltestutiltimeutilttytypestypeutilactionpinscliconstantslintersmodelsdevparsersemverutilworkflowView stale specifications (8 packages)
actionpins— Stale by 2 daysfix: SHA-pinned actions lose version comment when SkipHardcodedFallback is setPinContext.SkipHardcodedFallbackfield is present in source but not documented inREADME.md. The field controls whether version→SHA hardcoded fallback is skipped (relevant for non-github.comGH_HOSTconfigurations).SkipHardcodedFallback boolto thePinContextfields table in the spec.cli— Stale by 1 daypkg/clilargefunc backlog #46125 (refactor logs download orchestration), PR [WIP] Fix failing GitHub Actions job Integration: CLI Add & List Commands #46160 (fix failing integration tests), PR Enhance GitHub host detection for PAT creation and setup commands #46128 (enhance GitHub host detection)clito capture refactored log-download helpers and host detection improvements.constants— Stale by 1 dayfields_paramby default); PR feat: default to strict security mode, stop injecting sudo and --enable-host-access #45360 (default to strict security mode, stop injecting sudo and--enable-host-access)linters— Stale by 2 days (with known gap)doc.goto 51 analyzers, drift guard test), PR refactor: consolidate duplicate byte/string AST predicates into linters astutil #46108 (consolidate AST predicates), PR [linter-miner] feat(linters): add mapclearloop linter — replace range-delete loops with clear(m) #46060 (addmapclearlooplinter)mapclearloopanalyzer is present inpkg/linters/mapclearloop/and indoc.gobut is missing fromREADME.md. The README documents 50 of 51 active analyzers.mapclearloopentry to the linters README. Description: "reports range-over-map loops that delete every entry and can be replaced withclear(m)."modelsdev— Stale by 8 daysrawloginlibdetection #45637 (unshadow package logger identifiers to restorerawloginlibdetection)parser— Stale by 2 daysconfigbootstrap flow by default ingh aw add#46041 (runconfigbootstrap by default ingh aw add), PR Require issue-intent metadata for close/assignment tools by default, with per-tool opt-out #46014 (require issue-intent metadata for close/assignment tools)parserto capture credential env var filtering and bootstrap changes.semverutil— Stale by 6 daysfix: add normalization for git describe compiler versionsgit describeversion normalization behavior.workflow— Stale by 2 daysWorkflowDatasetup into helper), PR fix: exclude job-output credential env vars from agent sandbox (--exclude-env) #46076 (exclude job-output credential env vars from agent sandbox), PR [yamllint-fixer] Trim trailing whitespace and cap blank runs in inlined prompt content #46123 (trim trailing whitespace in inlined prompt content), PR [log] Add debug logging to workflow and CLI helpers #46124 (add debug logging to workflow and CLI helpers)workflowis reflected.🔄 Cross-Package Inconsistencies
View inconsistencies (1 issue)
Analyzer Registry Drift:
lintersdoc.go vs README.mdpkg/linters/doc.golists 51 active analyzers (includingmapclearloop)pkg/linters/README.mddocuments only 50 analyzers —mapclearloopis absentmapclearloop) without a corresponding README update; the follow-up PR fix: sync pkg/linters/doc.go to 51 analyzers and add drift guard test #46138 synceddoc.gobut did not updateREADME.mdREADME.mdanddoc.goas co-maintained registry files; the spec-extractor or drift guard should cover both.📊 Quality Scores
actionpinsagentdrainclicolorwriterconsoleconstantsenvutilerrorutilfileutilgithubgitutilimportinpututilintentjsonutillintersloggermodelsdevparserrepoutilsemverutilsetutilsliceutilstatsstringutilstylessyncutiltestutiltimeutilttytypestypeutilworkflowAction Items
SkipHardcodedFallbackfield topkg/actionpins/README.mdPinContextfields tablemapclearloopentry topkg/linters/README.md(present in source anddoc.gobut absent from README)cli,constants,modelsdev,parser,semverutil,workflowto capture recent changesREADME.mdanddoc.goare updated together when new analyzers are added (consider adding to the drift guard test)Closes #<this issue number>(orFixes/Resolves) in the PR description.