Skip to content

[spec-librarian] Specification Audit — 2026-06-12 — 20 issues found #38847

Closed as not planned
Closed as not planned
[spec-librarian] Specification Audit — 2026-06-12 — 20 issues found#38847
Assignees
pelikhancopilot-swe-agent
Labels
automationpkg-specificationsreview
@github-actions

Description

@github-actions
github-actions
bot
opened on Jun 12, 2026

📚 Package Specification Audit Report

Date: 2026-06-12
Run: §27421147905
Total Packages: 28
Packages with Specs: 27
Coverage: 96.4%

Coverage Summary

Status Package Last Spec Update Last Source Update Days Behind
❌ github — 2026-06-10 ∞ (missing)
⚠️ fileutil 2026-05-09 2026-06-09 31
⚠️ agentdrain 2026-05-09 2026-06-08 30
⚠️ semverutil 2026-05-09 2026-05-29 20
⚠️ logger 2026-05-15 2026-06-03 19
⚠️ console 2026-05-23 2026-06-09 17
⚠️ repoutil 2026-05-09 2026-05-23 14
⚠️ envutil 2026-05-09 2026-05-22 13
⚠️ sliceutil 2026-05-31 2026-06-06 6
⚠️ actionpins 2026-06-07 2026-06-11 4
⚠️ parser 2026-06-08 2026-06-11 3
⚠️ styles 2026-06-09 2026-06-12 3
⚠️ syncutil 2026-05-31 2026-06-03 3
⚠️ gitutil 2026-06-07 2026-06-09 2
⚠️ constants 2026-06-10 2026-06-11 1
⚠️ importinpututil 2026-06-07 2026-06-08 1
✅ cli 2026-06-11 2026-06-11 0
✅ errorutil 2026-05-31 2026-05-31 0
✅ jsonutil 2026-05-23 2026-05-23 0
✅ linters 2026-06-12 2026-06-12 0
✅ stats 2026-05-31 2026-05-31 0
✅ stringutil 2026-06-09 2026-06-09 0
✅ testutil 2026-06-09 2026-06-09 0
✅ timeutil 2026-06-09 2026-06-09 0
✅ tty 2026-05-07 2026-05-07 0
✅ types 2026-06-11 2026-06-11 0
✅ typeutil 2026-06-07 2026-06-07 0
✅ workflow 2026-06-12 2026-06-12 0

🚨 Missing Specifications

The following package has no README.md:

Package Source Files Exported Symbols Priority
github 2 1+ types + funcs High

The github package defines ObjectiveMapping, ComputeObjectiveValue, DefaultObjectiveMapping, LoadObjectiveMappingFromConfig, and related helpers used for issue prioritization scoring. No specification exists.

Recommendation: Run the spec-extractor workflow to generate a README.md for pkg/github/.

⚠️ Stale Specifications

15 packages have source changes not reflected in their specification.

View stale specifications (15 packages)

fileutil — Stale by 31 days

  • Spec last updated: 2026-05-09 · Source last updated: 2026-06-09
  • Undocumented exported function: EnsureParentDir(path string, perm os.FileMode) error — present in fileutil.go:93 but absent from README
  • Recommendation: Re-run spec-extractor; add EnsureParentDir to the functions table

agentdrain — Stale by 30 days

  • Spec last updated: 2026-05-09 · Source last updated: 2026-06-08
  • Package has grown to 10 source files; spec was written when the package was smaller
  • Recommendation: Re-run spec-extractor to capture any new types or functions

semverutil — Stale by 20 days

  • Spec last updated: 2026-05-09 · Source last updated: 2026-05-29
  • Recommendation: Re-run spec-extractor

logger — Stale by 19 days

  • Spec last updated: 2026-05-15 · Source last updated: 2026-06-03
  • Recommendation: Re-run spec-extractor

console — Stale by 17 days

  • Spec last updated: 2026-05-23 · Source last updated: 2026-06-09
  • Recommendation: Re-run spec-extractor

repoutil — Stale by 14 days

  • Spec last updated: 2026-05-09 · Source last updated: 2026-05-23
  • Recommendation: Re-run spec-extractor

envutil — Stale by 13 days

  • Spec last updated: 2026-05-09 · Source last updated: 2026-05-22
  • Recommendation: Re-run spec-extractor

sliceutil — Stale by 6 days

  • Spec last updated: 2026-05-31 · Source last updated: 2026-06-06
  • Recommendation: Re-run spec-extractor

actionpins — Stale by 4 days

  • Spec last updated: 2026-06-07 · Source last updated: 2026-06-11
  • Recommendation: Re-run spec-extractor

parser — Stale by 3 days

  • Spec last updated: 2026-06-08 · Source last updated: 2026-06-11
  • Recommendation: Re-run spec-extractor

styles — Stale by 3 days

  • Spec last updated: 2026-06-09 · Source last updated: 2026-06-12
  • Recommendation: Re-run spec-extractor

syncutil — Stale by 3 days

  • Spec last updated: 2026-05-31 · Source last updated: 2026-06-03
  • Recommendation: Re-run spec-extractor

gitutil — Stale by 2 days

  • Spec last updated: 2026-06-07 · Source last updated: 2026-06-09
  • Recommendation: Re-run spec-extractor

constants — Stale by 1 day

  • Spec last updated: 2026-06-10 · Source last updated: 2026-06-11
  • Recommendation: Re-run spec-extractor

importinpututil — Stale by 1 day

  • Spec last updated: 2026-06-07 · Source last updated: 2026-06-08
  • Recommendation: Re-run spec-extractor

🔄 Structural Inconsistencies

View structural issues (4 issues)

Missing EnsureParentDir in fileutil spec

  • File: pkg/fileutil/fileutil.go:93
  • Issue: EnsureParentDir(path string, perm os.FileMode) error is exported but not listed in pkg/fileutil/README.md
  • Recommendation: Add a row for EnsureParentDir to the functions table in the spec

Missing ## Dependencies section — constants

  • pkg/constants/README.md (495 lines) does not contain a ## Dependencies section, deviating from the standard README format used by all other packages
  • Recommendation: Add a Dependencies section; constants has no internal package imports

Missing ## Dependencies section — timeutil

  • pkg/timeutil/README.md does not contain a ## Dependencies section
  • Recommendation: Add a Dependencies section

Missing ## Dependencies section — tty

  • pkg/tty/README.md does not contain a ## Dependencies section
  • Recommendation: Add a Dependencies section

📊 Quality Scores

Package Completeness Accuracy Consistency Freshness Overall Rating
github 0% 0% 0% 0% 0% ❌
fileutil 85% 70% 90% 0% 61% ⚠️
console 85% 85% 80% 0% 62% ⚠️
logger 85% 85% 90% 0% 64% ⚠️
agentdrain 90% 85% 90% 0% 66% ⚠️
envutil 90% 90% 90% 0% 68% ⚠️
semverutil 90% 90% 90% 0% 68% ⚠️
repoutil 95% 95% 90% 0% 70% ⚠️
actionpins 95% 90% 90% 30% 76% ⚠️
constants 85% 85% 70% 80% 80% ✅
sliceutil 90% 90% 90% 60% 83% ✅
gitutil 90% 90% 90% 60% 83% ✅
syncutil 90% 90% 90% 70% 85% ✅
styles 85% 85% 90% 70% 82% ✅
parser 85% 85% 90% 70% 82% ✅
importinpututil 90% 90% 90% 80% 88% ✅
cli 90% 90% 90% 100% 91% ✅
errorutil 90% 90% 90% 100% 91% ✅
jsonutil 90% 90% 90% 100% 91% ✅
linters 85% 85% 90% 100% 89% ✅
stats 90% 90% 90% 100% 91% ✅
stringutil 90% 90% 90% 100% 91% ✅
testutil 90% 90% 90% 100% 91% ✅
timeutil 90% 90% 75% 100% 89% ✅
tty 90% 90% 75% 100% 89% ✅
types 85% 85% 90% 100% 89% ✅
typeutil 90% 90% 90% 100% 91% ✅
workflow 80% 80% 90% 100% 86% ✅

Scoring: Completeness 30% + Accuracy 30% + Consistency 20% + Freshness 20%

Action Items

  • Generate specification for pkg/github/ package (no README exists)
  • Re-run spec-extractor for 15 stale packages: fileutil, agentdrain, semverutil, logger, console, repoutil, envutil, sliceutil, actionpins, parser, styles, syncutil, gitutil, constants, importinpututil
  • Add EnsureParentDir to pkg/fileutil/README.md functions table
  • Add ## Dependencies sections to pkg/constants/README.md, pkg/timeutil/README.md, and pkg/tty/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.

References: §27421147905

📚 Specification review by Package Specification Librarian · 764.8 AIC · ⌖ 15 AIC · ⊞ 22.2K · ◷

  • expires on Jun 15, 2026, 6:25 AM UTC-08:00

Metadata

Metadata

Assignees

Labels

automationpkg-specificationsreview

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions