You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Date: 2026-07-14 Total Packages: 32 Packages with Specs: 32 Coverage: 100%
Coverage Summary
All 32 packages have a README.md specification. However, 12 packages have stale specs (source updated after spec), and 3 packages have significant symbol coverage gaps.
Status
Package
Last Spec Update
Last Source Update
Days Behind
❌
stats
2026-05-31
2026-07-13
43
⚠️
colorwriter
2026-07-05
2026-07-11
6
⚠️
actionpins
2026-07-10
2026-07-14
4
⚠️
parser
2026-07-10
2026-07-14
4
⚠️
console
2026-07-07
2026-07-10
3
⚠️
linters
2026-07-11
2026-07-14
3
⚠️
constants
2026-07-12
2026-07-14
2
⚠️
logger
2026-07-07
2026-07-09
2
⚠️
styles
2026-06-30
2026-07-02
2
⚠️
cli
2026-07-13
2026-07-14
1
⚠️
stringutil
2026-07-07
2026-07-08
1
⚠️
workflow
2026-07-13
2026-07-14
1
✅
agentdrain
2026-07-11
2026-07-11
0
✅
envutil
2026-07-08
2026-07-08
0
✅
errorutil
2026-05-31
2026-05-31
0
✅
fileutil
2026-06-14
2026-06-14
0
✅
github
2026-07-10
2026-07-10
0
✅
gitutil
2026-06-27
2026-06-27
0
✅
importinpututil
2026-07-10
2026-07-10
0
✅
intent
2026-07-06
2026-07-06
0
✅
jsonutil
2026-05-23
2026-05-23
0
✅
modelsdev
2026-07-07
2026-07-07
0
✅
repoutil
2026-07-10
2026-07-10
0
✅
semverutil
2026-07-10
2026-07-10
0
✅
setutil
2026-07-06
2026-07-06
0
✅
sliceutil
2026-06-25
2026-06-25
0
✅
syncutil
2026-07-10
2026-07-10
0
✅
testutil
2026-07-07
2026-07-07
0
✅
timeutil
2026-06-12
2026-06-12
0
✅
tty
2026-06-25
2026-06-25
0
✅
types
2026-07-11
2026-07-11
0
✅
typeutil
2026-06-25
2026-06-25
0
⚠️ Stale Specifications
View stale specifications (12 packages)
stats — Stale by 43 days ❌
Spec last updated: 2026-05-31
Source last updated: 2026-07-13
Recommendation: Re-run spec-extractor for pkg/stats — highest priority due to 43-day gap.
Recommendation: 365 exported symbols are missing from the spec — this is the largest gap in the repository.
🔄 Cross-Package Inconsistencies
View inconsistencies (2 issues)
Terminology: "structured output" vs "formatted output"
logger spec: "All log output goes to stderr to avoid interfering with stdout data (JSON, command output, etc.)"
agentdrain spec: "The audit command uses the new rendering system for structured output"
console and gitutil use "formatted output" for similar print operations
Recommendation: Standardize on a single term — suggest "structured output" for machine-readable data (JSON/hashes) and "formatted output" for human-readable terminal text, and apply consistently across all specs.
Import path format inconsistency in specs
linters README uses bare sub-package paths (e.g., "github.com/github/gh-aw/pkg/linters/ctxbackground") while most other specs reference only the top-level package path.
Recommendation: Ensure specs document the canonical import path at the top of each README consistently.
📚 Package Specification Audit Report
Date: 2026-07-14
Total Packages: 32
Packages with Specs: 32
Coverage: 100%
Coverage Summary
All 32 packages have a
README.mdspecification. However, 12 packages have stale specs (source updated after spec), and 3 packages have significant symbol coverage gaps.statscolorwriteractionpinsparserconsolelintersconstantsloggerstylesclistringutilworkflowagentdrainenvutilerrorutilfileutilgithubgitutilimportinpututilintentjsonutilmodelsdevrepoutilsemverutilsetutilsliceutilsyncutiltestutiltimeutilttytypestypeutilView stale specifications (12 packages)
stats— Stale by 43 days ❌pkg/stats— highest priority due to 43-day gap.colorwriter— Stale by 6 daysactionpins— Stale by 4 daysparser— Stale by 4 daysconsole— Stale by 3 daysFormatErrorTextStderr,FormatTableHeaderStderr,IsCancelled,NewConfirmForm,NewForm,NewInputForm,NewSelectFormlinters— Stale by 3 daysconstants— Stale by 2 daysAWFAuditDirExpr,AWFAuditDirShell,AWFConfigFilePath,AWFNoProxyHosts,AWFProxyLogsDirExpr,AgentStdioLogPath,AwPromptsFile,CopilotBinaryPath,DefaultDetectionMaxAICredits,DefaultHTTPClientTimeout,DefaultMaxAICredits,DefaultMaxDailyAICredits,DefaultMaxRuns,DefaultSafeOutputsMount, and 61 more.logger— Stale by 2 daysstyles— Stale by 2 dayscli— Stale by 1 dayAddSchemaDefault,AggregatedSummaryBase,AutoMergePullRequestsLegacy,BuildUnifiedTimeline,CompileValidationOptions,ComputeDomainBreakdowns,ConvertJSONWorkflowToMarkdown,ExitCodeError,FetchWorkflowFromSourceWithContext,FirewallLogSummary,MCPFailureSummary,NewCopilotCodingAgentDetector, and 70 more.stringutil— Stale by 1 dayworkflow— Stale by 1 dayAWFAPIProxyConfig,AWFConfigFile,AWFContainerConfig,AgentRuntime,ArtifactManager,BuildAWFConfigJSON,EngineCapabilities,ExperimentConfig,FirewallConfig,GenerateAutoUpdateWorkflow,GetAPITargetDomains,GetEngineSkillDir,NewJobManager,ParseExpression,RenderCondition, and 365 more.🔄 Cross-Package Inconsistencies
View inconsistencies (2 issues)
Terminology: "structured output" vs "formatted output"
loggerspec: "All log output goes to stderr to avoid interfering with stdout data (JSON, command output, etc.)"agentdrainspec: "The audit command uses the new rendering system for structured output"consoleandgitutiluse "formatted output" for similar print operationsImport path format inconsistency in specs
lintersREADME uses bare sub-package paths (e.g.,"github.com/github/gh-aw/pkg/linters/ctxbackground") while most other specs reference only the top-level package path.📊 Quality Scores
Scoring: Completeness (30%) · Accuracy (30%) · Consistency (20%) · Freshness (20%)
statsworkflowcliconstantsconsolecolorwriteractionpinsparserlintersloggerstringutilstylesAction Items
pkg/stats(43 days behind — highest priority)pkg/workflow(365 undocumented exported symbols — critical coverage gap)pkg/constants(75 undocumented exported symbols — critical coverage gap)pkg/cli(82 undocumented exported symbols)pkg/console(7 undocumented exported symbols:FormatErrorTextStderr,FormatTableHeaderStderr,IsCancelled,NewConfirmForm,NewForm,NewInputForm,NewSelectForm)colorwriter,actionpins,parser,linters,logger,stringutil,stylesCloses #<this issue number>(orFixes/Resolves) in the PR description.