V8.00.000.2025.06.17
All checks were successful
🛡️ Shell Script Linting / 🛡️ Shell Script Linting (push) Successful in 1m0s

Signed-off-by: Marc S. Weidner <msw@coresecret.dev>
This commit is contained in:
2025-07-31 23:04:30 +02:00
parent 930f47f827
commit 45ff672479
103 changed files with 1011 additions and 266 deletions

View File

@@ -23,7 +23,7 @@ structured logs with full environmental metadata and deterministic command evalu
## 2.2. Component Modules
### 2.2.1 [0050_debug_pre_scan.sh](../../lib/0050_debug_pre_scan.sh)
### 2.2.1 [0050_debug_pre_scan.sh](../../lib/cdi_0050_debug/0050_debug_pre_scan.sh)
**Purpose**: Parses the script's argument vector (`$@`) to detect and initialize debug mode before the main installer logic
executes.
@@ -36,7 +36,7 @@ executes.
- Explicitly sets the necessary global flags: `VAR_DEBUG_TRACE` and/or `VAR_DEBUG_TRAP`.
### 2.2.2. [0051_debug_var_dump.sh](../../lib/0051_debug_var_dump.sh)
### 2.2.2. [0051_debug_var_dump.sh](../../lib/cdi_0050_debug/0051_debug_var_dump.sh)
**Functions**:
- `dump_vars_initial()`: Captures the initial state of all non-internal variables.
@@ -52,7 +52,7 @@ executes.
- Operates with `set +x` to avoid leaking secrets to stdout.
- Temporary files are created with `mktemp` and removed after usage.
### 2.2.3. [0052_debug_trace.sh](../../lib/0052_debug_trace.sh)
### 2.2.3. [0052_debug_trace.sh](../../lib/cdi_0050_debug/0052_debug_trace.sh)
**Purpose**: Initializes Bash's `xtrace` (`set -x`) with rich metadata formatting and redirects output to `LOG_TRC`.
@@ -70,7 +70,7 @@ executes.
- Serves as a non-interfering, shell-native audit mechanism.
- Avoid collision with terminal output or stderr logging.
### 2.2.4. [0053_debug_trace_header.sh](../../lib/0053_debug_trace_header.sh)
### 2.2.4. [0053_debug_trace_header.sh](../../lib/cdi_0050_debug/0053_debug_trace_header.sh)
**Purpose**: Prints an extensive contextual header to `LOG_TRC`, including:
@@ -82,7 +82,7 @@ executes.
This header facilitates offline analysis and correlates script execution to external events or CI/CD timelines.
### 2.2.5. [0054_debug_trap.sh](../../lib/0054_debug_trap.sh)
### 2.2.5. [0054_debug_trap.sh](../../lib/cdi_0050_debug/0054_debug_trap.sh)
**Purpose**: Implements runtime-level command introspection using the `DEBUG` trap.
@@ -101,7 +101,7 @@ This header facilitates offline analysis and correlates script execution to exte
- Designed to be safely enabled in production with obfuscation of credentials and secrets.
- Provides a temporal correlation of command execution and exit codes.
### 2.2.6. [0055_debug_trap_header.sh](../../lib/0055_debug_trap_header.sh)
### 2.2.6. [0055_debug_trap_header.sh](../../lib/cdi_0050_debug/0055_debug_trap_header.sh)
**Purpose**: Similar to `debug_trace_header()`, this module prints an elaborate preamble into the `LOG_DBG` file.