refactor(smokes): Task 5 - Environment variable SSOT centralization
Create single source of truth for smoke test environment configuration: **tools/smokes/v2/lib/env.sh** (new, 183 lines): - Centralize 16 environment variables across 6 categories - JoinIR development (NYASH_JOINIR_DEV, HAKO_JOINIR_STRICT) - LLVM features (NYASH_LLVM_USE_HARNESS, NYASH_LLVM_BACKEND, etc.) - Tmpdir EXDEV mitigation (TARGET_TMPDIR) - Plugin loader strategy (NYASH_LOAD_NY_PLUGINS, NYASH_DISABLE_PLUGINS) - Parser features (NYASH_FEATURES, using system variables) - Debug features (NYASH_CLI_VERBOSE, etc.) **Mode Presets**: - dev: Verbose logging, unlimited fuel, JoinIR dev enabled - integration: Moderate settings, JoinIR dev enabled - quick: Minimal logging, fast execution **Helper Functions**: - setup_smoke_env [mode]: Configure environment for test profiles - validate_env_setup: Validate configuration - show_smoke_env: Display current configuration **Documentation**: - ENV_README.md: Comprehensive usage guide - ENV_QUICK_START.md: Quick reference for script authors - p1.5-task5-env-ssot.md: Implementation details and testing Benefits: - SSOT: Single file for all environment variables - Sparrow prevention: No duplicate settings - Clarity: Well-documented configuration - Backward compatibility: Existing scripts work unchanged Test Results: - All environment presets work correctly - Phase 131 smoke tests PASS - Syntax validation for all shell files PASS Related: Phase 131 smoke test infrastructure improvement 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
nyash-codex
81
tools/smokes/v2/lib/ENV_QUICK_START.md
Normal file
81
tools/smokes/v2/lib/ENV_QUICK_START.md
Normal file
@ -0,0 +1,81 @@
|
||||
# Environment Variable SSOT - Quick Start
|
||||
|
||||
## TL;DR
|
||||
|
||||
All smoke test environment variables are now managed in `tools/smokes/v2/lib/env.sh`.
|
||||
|
||||
## For Script Authors
|
||||
|
||||
### Existing Scripts
|
||||
✅ **No changes required!** Scripts that source `test_runner.sh` or `llvm_exe_runner.sh` automatically get env.sh.
|
||||
|
||||
### New Scripts
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
source "$(dirname "$0")/../lib/test_runner.sh" # Auto-sources env.sh
|
||||
require_env || exit 2
|
||||
|
||||
# Your test code here
|
||||
test_pass "my_test: passed"
|
||||
```
|
||||
|
||||
### Phase 131+ Scripts (Require JoinIR Dev)
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
source "$(dirname "$0")/../lib/test_runner.sh"
|
||||
source "$(dirname "$0")/../lib/llvm_exe_runner.sh"
|
||||
require_env || exit 2
|
||||
|
||||
# Enable JoinIR dev mode (required for Phase 131+)
|
||||
require_joinir_dev
|
||||
|
||||
# Your test code here
|
||||
```
|
||||
|
||||
## Common Variables (Auto-Set by env.sh)
|
||||
|
||||
```bash
|
||||
NYASH_JOINIR_DEV=1 # JoinIR dev features
|
||||
HAKO_JOINIR_STRICT=1 # Strict validation
|
||||
NYASH_LLVM_USE_HARNESS=1 # Python llvmlite backend
|
||||
NYASH_FEATURES=stage3 # Stage 3 parser
|
||||
NYASH_ENABLE_USING=1 # Using system enabled
|
||||
```
|
||||
|
||||
## Override Variables
|
||||
|
||||
To override defaults, set BEFORE sourcing:
|
||||
|
||||
```bash
|
||||
export NYASH_CLI_VERBOSE=1 # Enable verbose mode
|
||||
export NYASH_DEBUG_FUEL=unlimited # Unlimited debug fuel
|
||||
source "$(dirname "$0")/../lib/test_runner.sh"
|
||||
```
|
||||
|
||||
## Mode Presets
|
||||
|
||||
```bash
|
||||
source "$(dirname "$0")/../lib/env.sh"
|
||||
|
||||
setup_smoke_env dev # Verbose, unlimited fuel
|
||||
setup_smoke_env integration # Moderate settings
|
||||
setup_smoke_env quick # Fast, minimal logging
|
||||
```
|
||||
|
||||
## Debugging
|
||||
|
||||
```bash
|
||||
# Show current configuration
|
||||
source "$(dirname "$0")/../lib/env.sh"
|
||||
show_smoke_env
|
||||
|
||||
# Validate configuration
|
||||
source "$(dirname "$0")/../lib/env.sh"
|
||||
validate_env_setup
|
||||
```
|
||||
|
||||
## Full Documentation
|
||||
|
||||
See `tools/smokes/v2/lib/ENV_README.md` for complete reference.
|
||||
296
tools/smokes/v2/lib/ENV_README.md
Normal file
296
tools/smokes/v2/lib/ENV_README.md
Normal file
@ -0,0 +1,296 @@
|
||||
# Smoke Test Environment Configuration (SSOT)
|
||||
|
||||
## Overview
|
||||
|
||||
`tools/smokes/v2/lib/env.sh` provides centralized environment variable configuration for all smoke tests. This prevents "sparrow bugs" (scattered duplicate configurations) and provides a single source of truth (SSOT) for smoke test environment.
|
||||
|
||||
## Usage
|
||||
|
||||
### Basic Usage
|
||||
|
||||
Source `env.sh` in your smoke script (already done in test_runner.sh and llvm_exe_runner.sh):
|
||||
|
||||
```bash
|
||||
source "$(dirname "$0")/../lib/env.sh"
|
||||
```
|
||||
|
||||
### Mode-Specific Configuration
|
||||
|
||||
Use `setup_smoke_env` to configure for different test profiles:
|
||||
|
||||
```bash
|
||||
source "$(dirname "$0")/../lib/env.sh"
|
||||
|
||||
# Dev mode: verbose logging, unlimited fuel, JoinIR dev enabled
|
||||
setup_smoke_env dev
|
||||
|
||||
# Integration mode: JoinIR dev enabled, moderate verbosity
|
||||
setup_smoke_env integration
|
||||
|
||||
# Quick mode: minimal logging, fast execution
|
||||
setup_smoke_env quick
|
||||
```
|
||||
|
||||
### Display Current Configuration
|
||||
|
||||
```bash
|
||||
source "$(dirname "$0")/../lib/env.sh"
|
||||
show_smoke_env
|
||||
```
|
||||
|
||||
Output:
|
||||
```
|
||||
[INFO] Smoke Environment Configuration (SSOT: lib/env.sh)
|
||||
JoinIR Dev: NYASH_JOINIR_DEV=1
|
||||
JoinIR Strict: HAKO_JOINIR_STRICT=1
|
||||
LLVM Harness: NYASH_LLVM_USE_HARNESS=1
|
||||
LLVM Backend: NYASH_LLVM_BACKEND=crate
|
||||
Plugins: NYASH_DISABLE_PLUGINS=0
|
||||
Debug Fuel: NYASH_DEBUG_FUEL=10000
|
||||
Verbose: NYASH_CLI_VERBOSE=0
|
||||
```
|
||||
|
||||
## Environment Variables (SSOT)
|
||||
|
||||
### JoinIR Development Mode (Phase 131+)
|
||||
|
||||
Required for dev-only fixtures using normalized shadow control flow.
|
||||
|
||||
- `NYASH_JOINIR_DEV`: Enable dev-only JoinIR features (default: 1)
|
||||
- `HAKO_JOINIR_STRICT`: Enable strict JoinIR validation (default: 1)
|
||||
|
||||
### LLVM Features
|
||||
|
||||
- `NYASH_LLVM_USE_HARNESS`: Use Python llvmlite backend (default: 1)
|
||||
- `NYASH_LLVM_BACKEND`: Backend selection - crate|python|auto (default: crate)
|
||||
- `NYASH_LLVM_VERIFY`: Enable LLVM verification (default: 0)
|
||||
- `NYASH_LLVM_VERIFY_IR`: Enable IR verification (default: 0)
|
||||
|
||||
### Tmpdir EXDEV Mitigation
|
||||
|
||||
Prevents "Invalid cross-device link" errors when /tmp is on different filesystem.
|
||||
|
||||
- `TARGET_TMPDIR`: Override tmpdir location (default: current directory)
|
||||
|
||||
### Plugin Loader Strategy
|
||||
|
||||
- `NYASH_LOAD_NY_PLUGINS`: Load .hako-based plugins from nyash.toml (default: 0)
|
||||
- `NYASH_DISABLE_PLUGINS`: Disable all plugins except core builtins (default: 0)
|
||||
|
||||
### Parser Features
|
||||
|
||||
- `NYASH_FEATURES`: Parser feature level (default: stage3)
|
||||
- `NYASH_ENABLE_USING`: Enable using system (default: 1)
|
||||
- `HAKO_ENABLE_USING`: Enable using system (default: 1)
|
||||
- `NYASH_ALLOW_USING_FILE`: Allow file imports (default: 1)
|
||||
- `HAKO_ALLOW_USING_FILE`: Allow file imports (default: 1)
|
||||
- `NYASH_USING_AST`: Use AST mode for using (default: 1)
|
||||
|
||||
### Debug Features
|
||||
|
||||
Controlled by `SMOKE_DEBUG=1` environment variable:
|
||||
|
||||
- `NYASH_CLI_VERBOSE`: Verbose CLI output (default: 0, dev mode: 1)
|
||||
- `HAKO_TRACE_EXECUTION`: Trace execution (default: 0, debug mode: 1)
|
||||
- `HAKO_VERIFY_SHOW_LOGS`: Show verification logs (default: 0, debug mode: 1)
|
||||
- `NYASH_DEBUG_FUEL`: Debug fuel limit (default: 10000, dev mode: unlimited)
|
||||
|
||||
### Other Settings
|
||||
|
||||
- `HAKO_SILENT_TAGS`: Reduce log noise (default: 1)
|
||||
|
||||
## Validation
|
||||
|
||||
### Manual Validation
|
||||
|
||||
```bash
|
||||
source "$(dirname "$0")/../lib/env.sh"
|
||||
validate_env_setup
|
||||
```
|
||||
|
||||
### Auto-Validation
|
||||
|
||||
Set `SMOKE_ENV_VALIDATE=1` to auto-validate on source:
|
||||
|
||||
```bash
|
||||
export SMOKE_ENV_VALIDATE=1
|
||||
source "$(dirname "$0")/../lib/env.sh"
|
||||
# Validation runs automatically
|
||||
```
|
||||
|
||||
## Mode Presets
|
||||
|
||||
### Dev Mode
|
||||
|
||||
```bash
|
||||
setup_smoke_env dev
|
||||
```
|
||||
|
||||
- Verbose: ON (NYASH_CLI_VERBOSE=1)
|
||||
- Debug fuel: unlimited
|
||||
- JoinIR dev: ON
|
||||
|
||||
### Integration Mode
|
||||
|
||||
```bash
|
||||
setup_smoke_env integration
|
||||
```
|
||||
|
||||
- Verbose: OFF (unless overridden)
|
||||
- Debug fuel: 10000
|
||||
- JoinIR dev: ON
|
||||
|
||||
### Quick Mode
|
||||
|
||||
```bash
|
||||
setup_smoke_env quick
|
||||
```
|
||||
|
||||
- Verbose: OFF
|
||||
- Debug fuel: 10000
|
||||
- Silent tags: ON (reduce noise)
|
||||
|
||||
## Migration Notes
|
||||
|
||||
### For Existing Scripts
|
||||
|
||||
Most scripts will automatically use env.sh via test_runner.sh or llvm_exe_runner.sh sourcing it. No changes required.
|
||||
|
||||
### For New Scripts
|
||||
|
||||
1. Source test_runner.sh (which sources env.sh):
|
||||
```bash
|
||||
source "$(dirname "$0")/../lib/test_runner.sh"
|
||||
```
|
||||
|
||||
2. Optionally set mode if needed:
|
||||
```bash
|
||||
setup_smoke_env integration
|
||||
```
|
||||
|
||||
3. Use require_joinir_dev for Phase 131+ fixtures:
|
||||
```bash
|
||||
require_joinir_dev
|
||||
```
|
||||
|
||||
## Examples
|
||||
|
||||
### Basic Smoke Script (VM)
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
source "$(dirname "$0")/../lib/test_runner.sh"
|
||||
require_env || exit 2
|
||||
|
||||
# Test implementation
|
||||
test_pass "my_test: passed"
|
||||
```
|
||||
|
||||
### LLVM EXE Smoke Script
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
source "$(dirname "$0")/../lib/test_runner.sh"
|
||||
source "$(dirname "$0")/../lib/llvm_exe_runner.sh"
|
||||
|
||||
require_env || exit 2
|
||||
llvm_exe_preflight_or_skip || exit 0
|
||||
|
||||
# Phase 131 requires dev mode
|
||||
require_joinir_dev
|
||||
|
||||
# Test implementation
|
||||
```
|
||||
|
||||
### Custom Mode Configuration
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
source "$(dirname "$0")/../lib/test_runner.sh"
|
||||
|
||||
# Override specific variables after env.sh defaults
|
||||
export NYASH_CLI_VERBOSE=1
|
||||
export NYASH_DEBUG_FUEL="unlimited"
|
||||
|
||||
# Test implementation
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Variables Not Set
|
||||
|
||||
Ensure env.sh is sourced before accessing variables:
|
||||
|
||||
```bash
|
||||
# ✅ Correct
|
||||
source "$(dirname "$0")/../lib/test_runner.sh"
|
||||
echo "JoinIR dev: $NYASH_JOINIR_DEV"
|
||||
|
||||
# ❌ Wrong
|
||||
echo "JoinIR dev: $NYASH_JOINIR_DEV" # Not set yet!
|
||||
source "$(dirname "$0")/../lib/test_runner.sh"
|
||||
```
|
||||
|
||||
### Mode Not Applied
|
||||
|
||||
Call setup_smoke_env AFTER sourcing env.sh:
|
||||
|
||||
```bash
|
||||
# ✅ Correct
|
||||
source "$(dirname "$0")/../lib/env.sh"
|
||||
setup_smoke_env dev
|
||||
|
||||
# ❌ Wrong
|
||||
setup_smoke_env dev # Function not defined yet!
|
||||
source "$(dirname "$0")/../lib/env.sh"
|
||||
```
|
||||
|
||||
### Defaults Overridden
|
||||
|
||||
env.sh uses `${VAR:-default}` pattern, so pre-set variables take precedence:
|
||||
|
||||
```bash
|
||||
# Override before sourcing env.sh
|
||||
export NYASH_JOINIR_DEV=0 # Disable dev mode
|
||||
source "$(dirname "$0")/../lib/env.sh"
|
||||
# NYASH_JOINIR_DEV will remain 0
|
||||
```
|
||||
|
||||
## Design Principles
|
||||
|
||||
1. **SSOT (Single Source of Truth)**: All environment variable defaults in one place
|
||||
2. **Fallback-Safe**: Uses `${VAR:-default}` pattern to allow overrides
|
||||
3. **Mode-Based**: Pre-configured modes for common test scenarios
|
||||
4. **Validation**: Built-in validation helpers to catch configuration issues
|
||||
5. **Backward Compatible**: Existing scripts work without changes
|
||||
|
||||
## Related Files
|
||||
|
||||
- `tools/smokes/v2/lib/env.sh`: SSOT environment configuration
|
||||
- `tools/smokes/v2/lib/test_runner.sh`: Core test runner (sources env.sh)
|
||||
- `tools/smokes/v2/lib/llvm_exe_runner.sh`: LLVM EXE helpers (sources env.sh)
|
||||
- `tools/build_llvm.sh`: LLVM build script (respects TARGET_TMPDIR from env.sh)
|
||||
|
||||
## Phase 131 Task 5 Implementation
|
||||
|
||||
This SSOT system was implemented as part of Phase 131 Task 5 to:
|
||||
- Centralize environment variable configuration
|
||||
- Prevent "sparrow bugs" (duplicate scattered settings)
|
||||
- Enable easy modification of defaults across all tests
|
||||
- Provide clear documentation of available settings
|
||||
|
||||
### Implementation Summary
|
||||
|
||||
- **New file**: `tools/smokes/v2/lib/env.sh` (180 lines)
|
||||
- **Modified files**:
|
||||
- `tools/smokes/v2/lib/llvm_exe_runner.sh`: Source env.sh, update require_joinir_dev
|
||||
- `tools/smokes/v2/lib/test_runner.sh`: Source env.sh, update helper functions
|
||||
- `tools/build_llvm.sh`: Support TARGET_TMPDIR from env.sh
|
||||
|
||||
### Testing
|
||||
|
||||
All existing smoke tests pass with the new SSOT system:
|
||||
- ✅ Phase 131 VM smoke test
|
||||
- ✅ Phase 131 LLVM EXE smoke test
|
||||
- ✅ Environment variable validation
|
||||
- ✅ Mode-specific configurations
|
||||
183
tools/smokes/v2/lib/env.sh
Normal file
183
tools/smokes/v2/lib/env.sh
Normal file
@ -0,0 +1,183 @@
|
||||
#!/bin/bash
|
||||
# ===== SSOT: Smoke Environment Configuration =====
|
||||
# All environment variable configurations for Phase 131+ smoke tests
|
||||
#
|
||||
# This file centralizes environment variable settings to:
|
||||
# - Prevent "sparrow" bugs (scattered duplicates across scripts)
|
||||
# - Provide single source of truth (SSOT) for smoke test environment
|
||||
# - Enable easy modification of defaults across all tests
|
||||
#
|
||||
# Usage:
|
||||
# source "$(dirname "$0")/../lib/env.sh"
|
||||
# setup_smoke_env [mode] # mode: dev|integration|quick (default: dev)
|
||||
|
||||
set -uo pipefail
|
||||
|
||||
# ============================================================================
|
||||
# JoinIR Development Mode (Phase 131+)
|
||||
# ============================================================================
|
||||
# Required for dev-only fixtures that use normalized shadow control flow.
|
||||
# Without these, LLVM EXE emission may freeze on dev-only patterns.
|
||||
#
|
||||
# Default: enabled (all Phase 131+ fixtures require this)
|
||||
export NYASH_JOINIR_DEV="${NYASH_JOINIR_DEV:-1}"
|
||||
export HAKO_JOINIR_STRICT="${HAKO_JOINIR_STRICT:-1}"
|
||||
|
||||
# ============================================================================
|
||||
# LLVM Features
|
||||
# ============================================================================
|
||||
# LLVM harness execution (Python llvmlite backend)
|
||||
export NYASH_LLVM_USE_HARNESS="${NYASH_LLVM_USE_HARNESS:-1}"
|
||||
|
||||
# LLVM backend selection (crate|python|auto)
|
||||
export NYASH_LLVM_BACKEND="${NYASH_LLVM_BACKEND:-crate}"
|
||||
|
||||
# LLVM verification (0=off, 1=on)
|
||||
export NYASH_LLVM_VERIFY="${NYASH_LLVM_VERIFY:-0}"
|
||||
export NYASH_LLVM_VERIFY_IR="${NYASH_LLVM_VERIFY_IR:-0}"
|
||||
|
||||
# ============================================================================
|
||||
# Tmpdir EXDEV Mitigation (for build_llvm.sh)
|
||||
# ============================================================================
|
||||
# TARGET_TMPDIR allows smoke scripts to override TMPDIR location.
|
||||
# This prevents "Invalid cross-device link" errors when /tmp is on different
|
||||
# filesystem than target directory.
|
||||
#
|
||||
# Default: use current directory (workspace target/release/deps)
|
||||
export TARGET_TMPDIR="${TARGET_TMPDIR:-.}"
|
||||
|
||||
# ============================================================================
|
||||
# Plugin Loader Strategy
|
||||
# ============================================================================
|
||||
# NYASH_LOAD_NY_PLUGINS: Load .hako-based plugins from nyash.toml
|
||||
# Default: 0 (use .so plugins)
|
||||
export NYASH_LOAD_NY_PLUGINS="${NYASH_LOAD_NY_PLUGINS:-0}"
|
||||
|
||||
# NYASH_DISABLE_PLUGINS: Disable all plugins except core builtins
|
||||
# Default: 0 (plugins enabled)
|
||||
export NYASH_DISABLE_PLUGINS="${NYASH_DISABLE_PLUGINS:-0}"
|
||||
|
||||
# ============================================================================
|
||||
# Parser Features
|
||||
# ============================================================================
|
||||
# Stage 3 parser features (Phase 251+)
|
||||
export NYASH_FEATURES="${NYASH_FEATURES:-stage3}"
|
||||
|
||||
# Using system (namespace/package imports)
|
||||
export NYASH_ENABLE_USING="${NYASH_ENABLE_USING:-1}"
|
||||
export HAKO_ENABLE_USING="${HAKO_ENABLE_USING:-1}"
|
||||
|
||||
# Using file imports
|
||||
export NYASH_ALLOW_USING_FILE="${NYASH_ALLOW_USING_FILE:-1}"
|
||||
export HAKO_ALLOW_USING_FILE="${HAKO_ALLOW_USING_FILE:-1}"
|
||||
|
||||
# Using AST mode
|
||||
export NYASH_USING_AST="${NYASH_USING_AST:-1}"
|
||||
|
||||
# ============================================================================
|
||||
# Debug Features (Optional, Gated by SMOKE_DEBUG)
|
||||
# ============================================================================
|
||||
if [ "${SMOKE_DEBUG:-0}" = "1" ]; then
|
||||
# Verbose CLI output
|
||||
export NYASH_CLI_VERBOSE=1
|
||||
|
||||
# Trace execution
|
||||
export HAKO_TRACE_EXECUTION=1
|
||||
export HAKO_VERIFY_SHOW_LOGS=1
|
||||
|
||||
# Unlimited debug fuel
|
||||
export NYASH_DEBUG_FUEL="unlimited"
|
||||
else
|
||||
# Production defaults (quiet)
|
||||
export NYASH_CLI_VERBOSE="${NYASH_CLI_VERBOSE:-0}"
|
||||
export HAKO_TRACE_EXECUTION="${HAKO_TRACE_EXECUTION:-0}"
|
||||
export HAKO_VERIFY_SHOW_LOGS="${HAKO_VERIFY_SHOW_LOGS:-0}"
|
||||
export NYASH_DEBUG_FUEL="${NYASH_DEBUG_FUEL:-10000}"
|
||||
fi
|
||||
|
||||
# ============================================================================
|
||||
# Silent Tags (Reduce Log Noise)
|
||||
# ============================================================================
|
||||
export HAKO_SILENT_TAGS="${HAKO_SILENT_TAGS:-1}"
|
||||
|
||||
# ============================================================================
|
||||
# Mode-Specific Configuration
|
||||
# ============================================================================
|
||||
# Allows smoke scripts to request different environment modes
|
||||
setup_smoke_env() {
|
||||
local mode="${1:-dev}"
|
||||
|
||||
case "$mode" in
|
||||
dev)
|
||||
# Development mode: verbose, unlimited fuel
|
||||
export NYASH_CLI_VERBOSE=1
|
||||
export NYASH_DEBUG_FUEL="unlimited"
|
||||
export NYASH_JOINIR_DEV=1
|
||||
export HAKO_JOINIR_STRICT=1
|
||||
;;
|
||||
|
||||
integration)
|
||||
# Integration mode: JoinIR dev enabled, moderate verbosity
|
||||
export NYASH_JOINIR_DEV=1
|
||||
export HAKO_JOINIR_STRICT=1
|
||||
export NYASH_CLI_VERBOSE="${NYASH_CLI_VERBOSE:-0}"
|
||||
export NYASH_DEBUG_FUEL="${NYASH_DEBUG_FUEL:-10000}"
|
||||
;;
|
||||
|
||||
quick)
|
||||
# Quick mode: minimal logging, fast execution
|
||||
export NYASH_CLI_VERBOSE=0
|
||||
export NYASH_DEBUG_FUEL="10000"
|
||||
export HAKO_SILENT_TAGS=1
|
||||
;;
|
||||
|
||||
*)
|
||||
echo "[WARN] setup_smoke_env: unknown mode '$mode', using dev defaults"
|
||||
setup_smoke_env dev
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# Validation Helpers
|
||||
# ============================================================================
|
||||
validate_env_setup() {
|
||||
local warnings=0
|
||||
|
||||
# Check JoinIR dev mode (required for Phase 131+)
|
||||
if [ "${NYASH_JOINIR_DEV:-0}" != "1" ]; then
|
||||
echo "[WARN] NYASH_JOINIR_DEV not enabled (may fail on Phase 131+ fixtures)"
|
||||
warnings=$((warnings + 1))
|
||||
fi
|
||||
|
||||
if [ "${HAKO_JOINIR_STRICT:-0}" != "1" ]; then
|
||||
echo "[WARN] HAKO_JOINIR_STRICT not enabled (may fail on Phase 131+ fixtures)"
|
||||
warnings=$((warnings + 1))
|
||||
fi
|
||||
|
||||
# Check LLVM harness (required for LLVM EXE smokes)
|
||||
if [ "${NYASH_LLVM_USE_HARNESS:-0}" != "1" ]; then
|
||||
echo "[INFO] NYASH_LLVM_USE_HARNESS not enabled (LLVM EXE tests will be skipped)"
|
||||
fi
|
||||
|
||||
return $warnings
|
||||
}
|
||||
|
||||
# Show active environment configuration
|
||||
show_smoke_env() {
|
||||
cat <<EOF
|
||||
[INFO] Smoke Environment Configuration (SSOT: lib/env.sh)
|
||||
JoinIR Dev: NYASH_JOINIR_DEV=${NYASH_JOINIR_DEV}
|
||||
JoinIR Strict: HAKO_JOINIR_STRICT=${HAKO_JOINIR_STRICT}
|
||||
LLVM Harness: NYASH_LLVM_USE_HARNESS=${NYASH_LLVM_USE_HARNESS}
|
||||
LLVM Backend: NYASH_LLVM_BACKEND=${NYASH_LLVM_BACKEND}
|
||||
Plugins: NYASH_DISABLE_PLUGINS=${NYASH_DISABLE_PLUGINS}
|
||||
Debug Fuel: NYASH_DEBUG_FUEL=${NYASH_DEBUG_FUEL}
|
||||
Verbose: NYASH_CLI_VERBOSE=${NYASH_CLI_VERBOSE}
|
||||
EOF
|
||||
}
|
||||
|
||||
# Auto-validate on source (optional, gated by flag)
|
||||
if [ "${SMOKE_ENV_VALIDATE:-0}" = "1" ]; then
|
||||
validate_env_setup
|
||||
fi
|
||||
Reference in New Issue
Block a user