Release v0.23.1

Release Notes v0.23.1

Release Date: 2026-02-19
Type: Patch Release (Update Preservation + Verify Noise Fix)

Overview

Version 0.23.1 improves update safety for user-managed secret/certificate files
and removes residual verify noise for runtime-managed extension template cache
artifacts.

🛠️ Fixed

Runtime Template Cache Verify Noise

• oradba_version.sh --verify now excludes runtime-managed extension template
  cache files from additional-file reporting:
  • templates/oradba_extension/.version
  • templates/oradba_extension/extension-template.tar.gz
• Prevents false changed/additional reports after fresh installs where cache
  files are generated or refreshed at runtime.

Sensitive File Preservation During Updates

• Core installer update flows (oradba_install.sh --update / --force) now
  preserve user-managed sensitive files in:
  • etc/*.b64, etc/*.pem, etc/*.key, etc/*.crt
  • extensions/*/etc/*.b64|*.pem|*.key|*.crt (bundled extension tree)
• Extension updates (oradba_extension.sh add ... --update) now preserve
  user-added files of the same sensitive types:
  • *.b64, *.pem, *.key, *.crt

🔄 Changed

Documentation Updates

• Updated installation guide to document sensitive file preservation behavior
  during core updates.
• Updated extension system guide to document preserved user-added sensitive file
  types during extension updates.

🚀 Upgrade Notes

No breaking changes.

Recommended: after update, run integrity check and verify preserved files:

oradba_version.sh --verify
ls -l "$ORADBA_BASE/etc"/*.b64 "$ORADBA_BASE/etc"/*.pem 2>/dev/null

Release v0.23.0

Release Notes v0.23.0

Release Date: 2026-02-18
Type: Minor Release (Startup Performance + Cross-Platform Compatibility)

Overview

Version 0.23.0 improves oraenv.sh startup behavior for login/profile usage,
adds a startup-optimized --fast-silent mode, and strengthens cross-platform
compatibility for macOS default Bash environments. It also prevents runtime
configuration files from being overwritten during installer/update workflows.

✨ Added

Startup Profiling and Fast Silent Mode

• Added optional startup profiling with ORADBA_PROFILE_STARTUP=true in oraenv.sh
• Added per-phase timing output and effective startup flag reporting
• Added --fast-silent mode for startup-optimized silent initialization
• --fast-silent skips alias generation and SQLPATH setup during startup

🛠️ Fixed

macOS Bash 3.2 Compatibility

• Replaced Bash 4+ case conversion expansions in startup-critical paths with
  portable tr-based conversion
• Updated startup helpers to avoid Bash 4-only patterns in interactive and
  silent flows
• Fixed SQLPATH assembly to use BSD-compatible paste invocation on macOS
• Added macOS Instant Client .dylib detection support

Startup Performance and Discovery Safety

• Reduced startup overhead for non-database homes in oraenv.sh
• Added opt-in discovery/sync behavior for oratab → oradba_homes.conf
• Gated fallback sync paths to avoid writes when discovery is disabled
• Made alias generation honor ORADBA_LOAD_ALIASES in startup-optimized modes

Installer Runtime File Protection

• Preserve/restore runtime-managed files during install/update copy:
  • etc/oradba_homes.conf
  • etc/oratab
  • etc/sid.dummy.conf
• Excluded runtime-generated files from installer build payload staging

🔄 Changed

Startup Troubleshooting and User Guidance

• Updated user docs with startup troubleshooting and profiling workflow
• Added --fast-silent usage guidance in user documentation
• Documented trade-offs when skipping aliases and SQLPATH during fast startup

🚀 Upgrade Notes

No breaking changes.

Recommended profile startup patterns

Use one of the following in login/profile scripts:

# Fastest startup
source oraenv.sh <NAME> --fast-silent

# Tuned silent mode
export ORADBA_LOAD_ALIASES_IN_SILENT=false
export ORADBA_CONFIGURE_SQLPATH_IN_SILENT=false
source oraenv.sh <NAME> --silent

If interactive aliases or SQLPATH-based SQL script lookup are required in a
session, source oraenv.sh again in normal mode.

Release v0.22.1

Release Notes v0.22.1

Release Date: 2026-02-17
Type: Patch Release (Integrity Verification)

Overview

Version 0.22.1 fixes false-positive core integrity check results for
runtime-managed extension template cache files.

🛠️ Fixed

Installer Integrity Verification Noise Reduction

• Core integrity verification now excludes runtime-managed files:
  • templates/oradba_extension/.version
  • templates/oradba_extension/extension-template.tar.gz
  • .install_info
• These files remain included in .oradba.checksum for installation metadata
  and distribution consistency.
• Prevents false MODIFIED reports after refreshing bundled extension template
  cache files.
• Added regression coverage in tests/test_oradba_version.bats.

🚀 Upgrade Notes

No breaking changes.

This is a verification behavior fix only; installation layout and extension
create workflow are unchanged.

Release v0.22.0

Release Notes v0.22.0

Release Date: 2026-02-17
Type: Minor Release (Extensions + Documentation)

Overview

Version 0.22.0 introduces optional extension etc/ hook sourcing for
environment and alias customization, with a safe opt-in design. It also
simplifies the Oracle homes template header while aligning it with the actual
parser format.

✨ Added

Opt-In Extension etc Hooks

• Added optional extension hook loading for:
  • etc/env.sh
  • etc/aliases.sh
• Hook loading is disabled by default and controlled globally with:
  • ORADBA_EXTENSIONS_SOURCE_ETC=true
• Per-extension opt-in via .extension metadata:
  • load_env: true
  • load_aliases: true
• Added corresponding config docs in:
  • src/etc/oradba_standard.conf
  • src/templates/etc/oradba_customer.conf.example

🔄 Changed

Oracle Homes Template Header Simplification

• Shortened src/templates/etc/oradba_homes.conf.template header
• Reduced examples to a concise set
• Kept only essential format/field guidance
• Corrected template documentation to match actual colon-delimited parser order

🚀 Upgrade Notes

No breaking changes.

Existing extensions continue to load as before. Extension etc hooks are only
sourced when explicitly enabled via the global switch and per-extension metadata.

Release v0.21.5

Release Notes v0.21.5

Release Date: 2026-02-16
Type: Patch Release (Bug Fixes)

Overview

Version 0.21.5 fixes GitHub extension install and update behavior in
oradba_extension.sh add to use extension release packages instead of source
repository archives when releases provide package assets.

🐛 Fixes

GitHub Extension Install Uses Release Assets

• Prefer release asset archives (.tar.gz / .tgz) from GitHub releases
  (browser_download_url) for add <owner/repo> and add <owner/repo> --update
• Avoid installing repository-only content from source tarballs (for example:
  .github/ and tests/)
• Keep fallback to source tarball_url only when no release asset archive exists
• Ensure extension package metadata files such as .extension.checksum are
  installed when provided by the extension release

📝 Documentation Updates

• Updated extension update behavior details in
  doc/extension-system.md (backup naming and preservation behavior)
• Updated release docs examples in doc/releases/README.md

📊 Test Coverage

• Total Tests: 1516 tests (100% passing)
• Functions Documented: 437 functions (100% documented)
• Plugin Interface: v1.0.0

🚀 Upgrade Notes

No breaking changes. Existing extension update workflows remain compatible.

Release v0.21.4

Release Notes v0.21.4

Release Date: 2026-02-16
Type: Patch Release (Documentation)

Overview

Version 0.21.4 delivers documentation maintenance updates. It removes stale
version references, fixes outdated links, and improves release note
maintainability by reducing hardcoded version values.

📝 Documentation Updates

Release and Developer Docs Cleanup

• Refresh doc/releases/README.md to avoid hardcoded "latest" version references
• Remove broken references from doc/README.md and point to maintained locations
• Update doc/extension-system.md links to existing documentation paths
• Simplify root README.md by removing unnecessary inline version qualifiers

📊 Test Coverage

• Total Tests: 1516 tests (100% passing)
• Functions Documented: 437 functions (100% documented)
• Plugin Interface: v1.0.0

🚀 Upgrade Notes

No functional changes. Documentation only.

Release v0.21.3

Release Notes v0.21.3

Release Date: 2026-02-16
Type: Patch Release (Bug Fixes)

Overview

Version 0.21.3 refines extension update behavior by reducing unnecessary .save
backup files. The update process now avoids creating duplicate backups for files
that are already part of the new extension content, while still preserving
user-added files.

🐛 Fixes

Extension Update .save Noise Reduction

• Skip creating .save backups for files that are present in the new extension content
• Reduce unnecessary .save files generated after extension updates
• Keep preservation behavior for user-added files unchanged

📊 Test Coverage

• Total Tests: 1516 tests (100% passing)
• Functions Documented: 437 functions (100% documented)
• Plugin Interface: v1.0.0

🚀 Upgrade Notes

No breaking changes. Update and run your usual installation or sync process.

Release v0.21.2

Release Notes v0.21.2

Release Date: 2026-02-12
Type: Patch Release (Bug Fixes)

Overview

Version 0.21.2 focuses on extension update reliability. It improves configuration
preservation during extension updates so user changes are retained consistently.

🐛 Fixes

Extension Update Configuration Preservation

• Fix oradba_extension.sh add --update not restoring preserved configuration files
• Preserve all modified files listed in .extension.checksum, not just etc/
• Detect and keep user-added files (for example: .conf, .sh, .sql, .rcv, .rman, .env, .properties)
• Ensure preserved files are restored after new extension content is installed
• Handle nested configuration paths correctly

📊 Test Coverage

• Total Tests: 1516 tests (100% passing)
• Functions Documented: 437 functions (100% documented)
• Plugin Interface: v1.0.0

🚀 Upgrade Notes

No breaking changes. Update and run your usual installation or sync process.

Release v0.21.1

Release Notes v0.21.1

Release Date: 2026-02-11
Type: Patch Release (Bug Fixes)

Overview

Version 0.21.1 delivers focused fixes for Data Safe metadata output and extension updates.
It ensures version details are reliably exposed in environment displays and prevents
extension updates from producing incomplete installs or losing config preservation.

🐛 Fixes

Data Safe Metadata Output

• Use cman_version metadata when version is missing to populate ORACLE_VERSION
• Accept plain version strings from setup.py version to emit connector_version
• Keeps env display output reliable for Data Safe connectors

Extension Update Reliability

• Fix oradba_extension.sh --update creating incomplete extensions
• Prevents config preservation from breaking during extension updates (issue #202)

📊 Test Coverage

• Total Tests: 1516 tests (100% passing)
• Functions Documented: 437 functions (100% documented)
• Plugin Interface: v1.0.0

🚀 Upgrade Notes

No breaking changes. Update and run your usual installation or sync process.

Release v0.21.0

Release Notes v0.21.0

Release Date: 2026-02-11
Type: Minor Release (Code Quality and Header Standardization)

Overview

Version 0.21.0 consolidates all code quality and standardization improvements,
ensuring consistent formatting across all shell scripts and library functions.
This release includes extension loading fixes for Oracle Home environments and
comprehensive header standardization across the codebase.

✨ Improvements

Code Quality & Standardization

• Header Standardization
  • Standardized all env library headers to match the official template format
  • Updated 3 files: oradba_env_output.sh, oradba_env_status.sh, oradba_env_changes.sh
  • Ensures consistent documentation across the project
  • All headers now include: Author, Date, Revision, Purpose, Notes, Reference, License fields

Data Safe Enhancements

• Dual Version Display

  • Added plugin_get_connector_version() to retrieve connector software version
  • Metadata now includes cman_version and connector_version (backward compatible version maps to CMAN)
  • oraup.sh now shows both CMAN VERSION and CONNECTOR VER columns

• Connection Manager Status Display

  • Added plugin_get_cman_status() to parse start date, uptime, and gateway count
  • Status output now shows START DATE, UPTIME, and GATEWAYS for running connectors

• Connection Count Display

  • Added plugin_get_connection_count() to report active tunnels/connections
  • Status output now shows CONNECTIONS when a connector is running

Bug Fixes & Enhancements

• Oracle Home Extension Paths (from v0.20.6)

  • Ensure extensions are loaded for Oracle Home environments (non-database homes)
  • Keeps extension bin directories in PATH for Data Safe, Java, and similar homes
  • Fixed _oraenv_handle_oracle_home() to call _oraenv_load_configurations() for proper extension loading

• Repository Hygiene (from v0.20.6)

  • Runtime config artifacts now properly ignored: src/etc/oradba_homes.conf, src/etc/oratab, src/etc/sid.dummy.conf
  • Treats generated files as local artifacts

• Documentation Build Compatibility (from v0.20.6)

  • Replaced Python YAML tags in mkdocs.yml with plain string references
  • Prevents unresolved tag errors during MkDocs builds

📊 Test Coverage

• Total Tests: 1516 tests (100% passing)
• Functions Documented: 437 functions (100% documented)
• Plugin Interface: v1.0.0 (universal core functions + category-specific listener handling)

🚀 Upgrade Notes

No breaking changes. Update and run your usual installation or sync process.

Recommended for All Users

• Update to v0.21.0 for consistent code quality improvements
• No configuration changes required
• All existing scripts and configurations remain fully compatible

📝 Additional Changes

• Updated CHANGELOG.md with consolidated v0.21.0 entries
• All env libraries now follow standard header documentation format
• Improved code consistency across the project