Skip to content

Adopt component log categories and deprecate VERBOSE#190

Merged
codeforester merged 1 commit into
mainfrom
enhancement/188-20260724-component-log-categories
Jul 25, 2026
Merged

Adopt component log categories and deprecate VERBOSE#190
codeforester merged 1 commit into
mainfrom
enhancement/188-20260724-component-log-categories

Conversation

@codeforester

@codeforester codeforester commented Jul 24, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • tag every internal std, arg, file, Git, and GitHub record with its
    base_bash_libs.<module> category
  • default the parent base_bash_libs gate to INFO so application DEBUG does
    not implicitly enable reusable-library DEBUG
  • preserve explicit parent and child category opt-ins
  • make --debug-wrapper enable both terminal and library DEBUG
  • deprecate the Bash-only VERBOSE level, log_verbose* helpers, and
    --verbose-wrapper without changing their 1.x runtime behavior

Issue

Closes #188

Dependency

Validation

  • bats tests/launcher.bats lib/bash/std/tests/lib_std.bats lib/bash/git/tests/lib_git.bats
    — 204 tests passed locally, with one environment-specific process-listing
    skip
  • bats lib/bash/file/tests/lib_file.bats — 34 tests passed
  • ./tests/validate.sh — 314 tests passed
  • bash -n for the launcher and all changed library modules
  • audit found no uncategorized internal severity calls in the five logging
    modules
  • git diff --check

Notes

  • Deprecated symbols remain available, retain their exact thresholds, and do
    not emit runtime warnings.
  • DEBUG is the most detailed level for new code; deprecated compatibility
    surfaces can be removed no earlier than the next major release.
  • Deprecating basectl --verbose-wrapper remains a separate Base issue/PR
    after this library train is merged and available.
  • VERSION remains unchanged; this work is targeted to the v1.4.0
    milestone.

Checklist

  • Branch name follows <category>/<issue>-<YYYYMMDD>-<slug>.
  • Pull request is scoped to one issue, unless a documented multi-issue exception applies.
  • Pull request body explains what changed and how it was validated.
  • Relevant project checks pass.
  • Documentation is updated when behavior or user-facing commands change.
  • CHANGELOG is updated for notable user-visible or release-worthy changes.
  • Pull request includes Fixes #<issue> or Closes #<issue> when merge should close the issue.

@codeforester
codeforester marked this pull request as ready for review July 25, 2026 00:48
Base automatically changed from enhancement/187-20260724-log-category-gates to main July 25, 2026 00:50
@codeforester
codeforester force-pushed the enhancement/188-20260724-component-log-categories branch from a900b84 to f7b5f2a Compare July 25, 2026 00:51
@codeforester
codeforester merged commit b9407e0 into main Jul 25, 2026
2 checks passed
@codeforester
codeforester deleted the enhancement/188-20260724-component-log-categories branch July 25, 2026 00:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Adopt component log categories and deprecate VERBOSE

1 participant