[spec-librarian] Specification Audit — 2026-07-12 — 2 dependency issues found

[github-actions]

📚 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

• Add importinpututil, repoutil, and setutil to the ## Dependencies section of pkg/workflow/README.md
• Add github, intent, modelsdev, and setutil to the ## Dependencies section of pkg/cli/README.md
• 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 · 89.7 AIC · ⌖ 7.14 AIC · ⊞ 6K · ◷

• expires on Jul 15, 2026, 5:51 AM UTC-08:00