Establish native validation baseline

Author: FJiangArthur

AGENTS.md

@@ -2,7 +2,7 @@
 
 ## Identity
 
-- **Project**: Helix-iOS (v2.2.93+202607011603)
+- **Project**: Helix-iOS (v2.2.94+202607011615)
 - **Type**: Native iOS Swift app with headless Swift framework
 - **Purpose**: Companion app for Even Realities G1 smart glasses — real-time conversation intelligence with AI
 

CLAUDE.md

@@ -2,7 +2,7 @@
 
 Native headless framework for Even Realities G1 smart glasses conversation intelligence.
 
-**Version**: 2.2.93+202607011603
+**Version**: 2.2.94+202607011615
 
 ## Validation (MANDATORY)
 

VALIDATION.md

@@ -68,7 +68,7 @@ must not be committed.
 Local hooks are stored in `.githooks` and this checkout uses:
 
 ```bash
-git config core.hooksPath .githooks
+bash scripts/install_git_hooks.sh
 ```
 
 On branches other than `main`, the pre-commit hook runs the staged security

VERSION

@@ -1 +1 @@
-2.2.93+202607011603
+2.2.94+202607011615

docs/BASELINE_VALIDATION.md

@@ -0,0 +1,52 @@
+# Baseline Validation
+
+Baseline version: **2.2.94+202607011615**
+
+This baseline is the Swift-native Helix app shell plus `NativeHelix` headless
+package. Legacy cross-platform tooling, method/event channels, and Flutter/Dart
+UI are outside the supported baseline.
+
+## Required Local Setup
+
+Install the repository hooks after cloning or after resetting Git config:
+
+```bash
+bash scripts/install_git_hooks.sh
+```
+
+The installer marks the hook and gate scripts executable, then sets:
+
+```bash
+git config core.hooksPath .githooks
+```
+
+## Manual Gate
+
+Run the mandatory gate before completing any code change:
+
+```bash
+bash scripts/run_gate.sh
+```
+
+The gate checks repository secrets, the headless package boundary, the native
+Swift package build/tests, and the retired eval boundary.
+
+## Commit And Push Gate
+
+Commits on `main` run:
+
+```bash
+bash scripts/run_commit_gate.sh
+```
+
+That script requires local `.env` to contain `OPENAI_API_KEY`, then runs staged
+security checks, native package tests, the native Swift gate, the mandatory gate,
+and the live OpenAI provider smoke test.
+
+Pushes to `main` run the same extensive gate through `.githooks/pre-push`.
+
+## Simulator Policy
+
+Use only a dedicated `Helix-QA-*` simulator for foreground validation. Do not
+reuse `0D7C3AB2` or `6D249AFF`. Delete or shut down dedicated Helix simulators
+after validation to avoid memory pressure.

docs/PROGRESS.md

@@ -1,12 +1,12 @@
 # Development Progress
 
-Current version: **2.2.93+202607011603**
+Current version: **2.2.94+202607011615**
 
 ## Current Architecture
 
 - **NativeHelix**: headless Swift package for conversation, AI, speech, G1 HUD, runtime state, and persistence.
 - **iOS app shell**: SwiftUI surfaces under `ios/Runner`.
-- **Validation**: `bash scripts/run_gate.sh` runs security, boundary, package build, and package tests.
+- **Validation**: `bash scripts/run_gate.sh` runs security, boundary, package build, and package tests. `bash scripts/install_git_hooks.sh` installs the pre-commit and pre-push gates.
 - **Simulator policy**: use a dedicated `Helix-QA-*` simulator; do not reuse shared project simulators.
 
 

ios/Even Companion.xcodeproj/project.pbxproj

@@ -651,7 +651,7 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
-				CURRENT_PROJECT_VERSION = 202607011603;
+				CURRENT_PROJECT_VERSION = 202607011615;
 				DEVELOPMENT_TEAM = 4SA9UFLZMT;
 				ENABLE_BITCODE = NO;
 				HEADER_SEARCH_PATHS = (
@@ -664,7 +664,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 2.2.93;
+				MARKETING_VERSION = 2.2.94;
 				OTHER_LDFLAGS = (
 					"$(inherited)",
 					"-lc++",
@@ -730,7 +730,7 @@
 				APPLICATION_EXTENSION_API_ONLY = YES;
 				CLANG_ENABLE_OBJC_WEAK = NO;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 202607011603;
+				CURRENT_PROJECT_VERSION = 202607011615;
 				DEVELOPMENT_TEAM = 4SA9UFLZMT;
 				GENERATE_INFOPLIST_FILE = NO;
 				INFOPLIST_FILE = HelixLiveActivity/Info.plist;
@@ -740,7 +740,7 @@
 					"@executable_path/Frameworks",
 					"@executable_path/../../Frameworks",
 				);
-				MARKETING_VERSION = 2.2.93;
+				MARKETING_VERSION = 2.2.94;
 				PRODUCT_BUNDLE_IDENTIFIER = com.artjiang.helix.liveactivity;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = iphoneos;
@@ -871,7 +871,7 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
-				CURRENT_PROJECT_VERSION = 202607011603;
+				CURRENT_PROJECT_VERSION = 202607011615;
 				DEVELOPMENT_TEAM = 4SA9UFLZMT;
 				ENABLE_BITCODE = NO;
 				HEADER_SEARCH_PATHS = (
@@ -884,7 +884,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 2.2.93;
+				MARKETING_VERSION = 2.2.94;
 				OTHER_LDFLAGS = (
 					"$(inherited)",
 					"-lc++",
@@ -903,7 +903,7 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
-				CURRENT_PROJECT_VERSION = 202607011603;
+				CURRENT_PROJECT_VERSION = 202607011615;
 				DEVELOPMENT_TEAM = 4SA9UFLZMT;
 				ENABLE_BITCODE = NO;
 				HEADER_SEARCH_PATHS = (
@@ -916,7 +916,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 2.2.93;
+				MARKETING_VERSION = 2.2.94;
 				OTHER_LDFLAGS = (
 					"$(inherited)",
 					"-lc++",
@@ -935,7 +935,7 @@
 				APPLICATION_EXTENSION_API_ONLY = YES;
 				CLANG_ENABLE_OBJC_WEAK = NO;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 202607011603;
+				CURRENT_PROJECT_VERSION = 202607011615;
 				DEVELOPMENT_TEAM = 4SA9UFLZMT;
 				GENERATE_INFOPLIST_FILE = NO;
 				INFOPLIST_FILE = HelixLiveActivity/Info.plist;
@@ -945,7 +945,7 @@
 					"@executable_path/Frameworks",
 					"@executable_path/../../Frameworks",
 				);
-				MARKETING_VERSION = 2.2.93;
+				MARKETING_VERSION = 2.2.94;
 				PRODUCT_BUNDLE_IDENTIFIER = com.artjiang.helix.liveactivity;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = iphoneos;
@@ -963,7 +963,7 @@
 				APPLICATION_EXTENSION_API_ONLY = YES;
 				CLANG_ENABLE_OBJC_WEAK = NO;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 202607011603;
+				CURRENT_PROJECT_VERSION = 202607011615;
 				DEVELOPMENT_TEAM = 4SA9UFLZMT;
 				GENERATE_INFOPLIST_FILE = NO;
 				INFOPLIST_FILE = HelixLiveActivity/Info.plist;
@@ -973,7 +973,7 @@
 					"@executable_path/Frameworks",
 					"@executable_path/../../Frameworks",
 				);
-				MARKETING_VERSION = 2.2.93;
+				MARKETING_VERSION = 2.2.94;
 				PRODUCT_BUNDLE_IDENTIFIER = com.artjiang.helix.liveactivity;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = iphoneos;

scripts/install_git_hooks.sh

@@ -5,7 +5,13 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 cd "$PROJECT_ROOT"
 
-chmod +x .githooks/pre-commit .githooks/pre-push scripts/security_gate.sh
+chmod +x \
+  .githooks/pre-commit \
+  .githooks/pre-push \
+  scripts/run_commit_gate.sh \
+  scripts/run_gate.sh \
+  scripts/run_native_swift_gate.sh \
+  scripts/security_gate.sh
 git config core.hooksPath .githooks
 
 echo "Installed git hooks from .githooks"