📚 Package Specification Audit Report
Date: 2026-07-12
Total Packages: 32
Packages with Specs: 32
Coverage: 100%
Coverage Summary
All 32 packages under pkg/ have a README.md specification. Coverage is complete.
| Status |
Package |
Notes |
| ✅ |
All 32 packages |
README.md present |
✅ No Missing Specifications
All packages have README.md files. No gaps in coverage.
⚠️ Cross-Package Dependency Inconsistencies
Two package specifications list incomplete dependency sections. The following internal packages are imported in source code but not listed in the corresponding README dependency tables.
View dependency mismatches (2 packages)
workflow — 3 missing dependencies
The following packages are imported in production source files but absent from the pkg/workflow/README.md Dependencies section:
| Missing Dependency |
Source File |
Usage |
github.com/github/gh-aw/pkg/importinpututil |
expression_extraction.go |
importinpututil.FormatResolvedValue, importinpututil.ResolvePathValue |
github.com/github/gh-aw/pkg/repoutil |
dispatch_workflow_validation.go |
repoutil.SplitRepoSlug |
github.com/github/gh-aw/pkg/setutil |
imports.go |
setutil.Contains |
Recommendation: Add these three packages to the ## Dependencies section of pkg/workflow/README.md.
cli — 4 missing dependencies
The following packages are imported in production source files but absent from the pkg/cli/README.md Dependencies section:
| Missing Dependency |
Evidence |
github.com/github/gh-aw/pkg/github |
Present in cli source imports |
github.com/github/gh-aw/pkg/intent |
Present in cli source imports |
github.com/github/gh-aw/pkg/modelsdev |
Present in cli source imports |
github.com/github/gh-aw/pkg/setutil |
Present in cli source imports |
Recommendation: Add these four packages to the ## Dependencies section of pkg/cli/README.md.
📊 Quality Scores
| Package |
Completeness |
Accuracy |
Consistency |
Freshness |
Overall |
workflow |
55% |
85% |
85% |
n/a |
⚠️ 75% |
cli |
60% |
85% |
85% |
n/a |
⚠️ 77% |
linters |
95% |
95% |
90% |
n/a |
✅ 93% |
parser |
80% |
90% |
90% |
n/a |
✅ 87% |
console |
90% |
90% |
90% |
n/a |
✅ 90% |
| All others |
85%+ |
85%+ |
85%+ |
n/a |
✅ 85%+ |
Note: Freshness cannot be computed — repository is a shallow clone with a single commit available.
Low completeness for workflow and cli: These packages have very high exported symbol counts (workflow: 5,253 exported functions across ~320 source files; cli: 2,985 exported functions). Their README files (735 and 574 lines respectively) document only the major API surface and not every individual exported symbol. This is by design for large packages, but the dependency tables are incomplete.
Action Items
📚 Next review scheduled for tomorrow. Close this issue once all items are resolved.
📚 Specification review by Package Specification Librarian · 89.7 AIC · ⌖ 7.14 AIC · ⊞ 6K · ◷
📚 Package Specification Audit Report
Date: 2026-07-12
Total Packages: 32
Packages with Specs: 32
Coverage: 100%
Coverage Summary
All 32 packages under
pkg/have aREADME.mdspecification. Coverage is complete.✅ No Missing Specifications
All packages have
README.mdfiles. No gaps in coverage.Two package specifications list incomplete dependency sections. The following internal packages are imported in source code but not listed in the corresponding README dependency tables.
View dependency mismatches (2 packages)
workflow— 3 missing dependenciesThe following packages are imported in production source files but absent from the
pkg/workflow/README.mdDependencies section:github.com/github/gh-aw/pkg/importinpututilexpression_extraction.goimportinpututil.FormatResolvedValue,importinpututil.ResolvePathValuegithub.com/github/gh-aw/pkg/repoutildispatch_workflow_validation.gorepoutil.SplitRepoSluggithub.com/github/gh-aw/pkg/setutilimports.gosetutil.ContainsRecommendation: Add these three packages to the
## Dependenciessection ofpkg/workflow/README.md.cli— 4 missing dependenciesThe following packages are imported in production source files but absent from the
pkg/cli/README.mdDependencies section:github.com/github/gh-aw/pkg/githubclisource importsgithub.com/github/gh-aw/pkg/intentclisource importsgithub.com/github/gh-aw/pkg/modelsdevclisource importsgithub.com/github/gh-aw/pkg/setutilclisource importsRecommendation: Add these four packages to the
## Dependenciessection ofpkg/cli/README.md.📊 Quality Scores
workflowclilintersparserconsoleAction Items
importinpututil,repoutil, andsetutilto the## Dependenciessection ofpkg/workflow/README.mdgithub,intent,modelsdev, andsetutilto the## Dependenciessection ofpkg/cli/README.mdCloses #<this issue number>(orFixes/Resolves) in the PR description.