Document missing exported APIs across package specs (stringutil, typeutil, constants, console, linters)

[Copilot]

The spec audit found API drift: 5 pkg/* READMEs were missing documentation for currently exported symbols. This PR updates package specifications to align documented public APIs with actual exports.

• pkg/stringutil

  • Added missing API docs for:
    • NormalizeLeadingWhitespace
    • FormatList
    • SanitizeOptions
    • SanitizeName
  • Extended sanitization and general utilities sections with concise behavior descriptions.

• pkg/typeutil

  • Added missing lookup helper docs for:
    • LookupMap
    • LookupString
    • LookupStringPath
  • Updated function-selection guidance to include typed nested map/string lookup patterns.

• pkg/constants

  • Added missing minimum-version constraint entries for:
    • AWFDockerHostPathPrefixMinVersion
    • AWFTokenSteeringMinVersion

• pkg/console

  • Added missing exported API coverage for:
    • BannerStyle (exported style var)
    • SpinnerWrapper (exported spinner type + method surface)

• pkg/linters

  • Added osexitinlibrary subpackage to the documented analyzer set.
  • Included osexitinlibrary.Analyzer in usage/docs to match the exported linter API.

Example of the newly documented API surface in specs:

// pkg/typeutil
m2, ok := typeutil.LookupMap(cfg, "tools")
name, ok := typeutil.LookupStringPath(cfg, "tools", "github", "mode")

[Copilot]

Pull request overview

Updates multiple pkg/* package specifications (READMEs) to eliminate spec drift by documenting currently-exported public APIs that were previously missing from the package docs.

Changes:

• Added documentation for missing exported helpers in pkg/typeutil (LookupMap, LookupString, LookupStringPath) and pkg/stringutil (FormatList, NormalizeLeadingWhitespace, SanitizeOptions, SanitizeName).
• Expanded specs for pkg/linters, pkg/constants, and pkg/console to include newly identified exported symbols/subpackages (e.g., osexitinlibrary, new min-version constants, BannerStyle, SpinnerWrapper).

Show a summary per file

File	Description
pkg/typeutil/README.md	Documents exported nested-map/string lookup helpers and adds selection guidance.
pkg/stringutil/README.md	Documents additional exported string helpers and sanitization types/functions.
pkg/linters/README.md	Adds osexitinlibrary to the documented analyzer set and usage example.
pkg/constants/README.md	Adds missing minimum-version constraint constants to the spec list.
pkg/console/README.md	Expands the documented public API surface to include BannerStyle and SpinnerWrapper.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comments suppressed due to low confidence (1)

pkg/console/README.md:813

• This section documents BannerStyle without mentioning that it’s not part of the js/wasm build (see pkg/console/banner.go vs pkg/console/banner_wasm.go). Please clarify the build target(s) where BannerStyle is available so the spec matches the conditional API surface.

### `BannerStyle`

`BannerStyle` is the exported Lip Gloss style used by `FormatBanner` for consistent banner rendering.

• Files reviewed: 5/5 changed files
• Comments generated: 1

[pelikhan]

@copilot review all comments