add simple hooks and ext binaries test

1. fix test external binaries
2. add plans for install hooks
3. fix tests_simple_hooks and test_external_binaries
4. update comments

Signed-off-by: dikshagupta1 <dikshag@progress.com>

Author: dikshagupta1

.expeditor/end_to_end.pipeline.yml

@@ -1296,6 +1296,38 @@ steps:
     env:
       BUILD_PKG_TARGET: aarch64-darwin
 
+  - label: "[:mac: test_simple_hooks_darwin]"
+    command:
+      - bash .expeditor/scripts/end_to_end/run_e2e_test_darwin.sh dev test_simple_hooks_darwin
+    artifact_paths:
+      - "*.log"
+    agents:
+      queue: 'default-macos-arm64-privileged'
+    plugins:
+      - chef/anka#v0.7.2:
+          vm-name: buildkite-core-14-arm64
+          always-pull: true
+          wait-network: true
+          inherit-environment-vars: true
+    env:
+      BUILD_PKG_TARGET: aarch64-darwin
+
+  - label: "[:mac: test_external_binaries_darwin]"
+    command:
+      - bash .expeditor/scripts/end_to_end/run_e2e_test_darwin.sh dev test_external_binaries_darwin
+    artifact_paths:
+      - "*.log"
+    agents:
+      queue: 'default-macos-arm64-privileged'
+    plugins:
+      - chef/anka#v0.7.2:
+          vm-name: buildkite-core-14-arm64
+          always-pull: true
+          wait-network: true
+          inherit-environment-vars: true
+    env:
+      BUILD_PKG_TARGET: aarch64-darwin
+
   - wait
 
   - label: "[:habicat: Promote to Acceptance]"

.expeditor/scripts/end_to_end/run_e2e_test_core_darwin.ps1

@@ -94,11 +94,11 @@ function Wait-StopSupervisor($Timeout = 10, $port = 9631) {
 
 # Generate a new unique log file name, given a base name.
 #
-# The base name should be something descriptive that allows you to
+# The base name should be something descriptive that allows us to
 # trace a given log file back to the test case that generated it.
 #
 # This is used instead of the standard `New-TemporaryFile`, since that
-# does not seem to allow you to specify any non-random components,
+# does not seem to allow us to specify any non-random components,
 # which we will need for both correlating outputs to tests, as well as
 # easily collecting log outputs in Buildkite.
 #
@@ -288,7 +288,7 @@ Function Invoke-BuildAndInstall($PackageName, $RefreshChannel) {
     Invoke-Build @PSBoundParameters
     . ./results/last_build.ps1
     # Use --ignore-install-hook because the install hook interpreter
-    # (core/busybox-static) is not available for aarch64-darwin.
+    # (core/busybox-static) is not available for aarch64-darwin.    
     hab pkg install --ignore-install-hook ./results/$pkg_artifact
     # On Linux, the original function runs `hab studio run "rm hooks"` to
     # clean up inside the chroot studio (separate from the host filesystem).

.expeditor/scripts/end_to_end/setup_environment_darwin.sh

@@ -78,6 +78,11 @@ export HAB_STUDIO_BACKLINE_PKG
 HAB_STUDIO_BACKLINE_PKG="$(cat "$(hab pkg path chef/hab-backline)/IDENT")"
 echo "--- HAB_STUDIO_BACKLINE_PKG=${HAB_STUDIO_BACKLINE_PKG}"
 
+# Override the interpreter identity to core/coreutils (installed via
+# hab-backline) because core/busybox-static is not available for
+# aarch64-darwin. This is needed for install hook execution.
+export HAB_INTERPRETER_IDENT="core/coreutils"
+
 echo "--- Installing latest core/powershell from ${HAB_BLDR_URL}, stable channel"
 # Try the hab package first, fall back to Homebrew
 if sudo -E hab pkg install core/powershell \

test/end-to-end/test_external_binaries_darwin.ps1

@@ -0,0 +1,50 @@
+# macOS-specific external binaries tests.
+# Tests that hab can find and execute binaries from installed packages.
+# Container and Tar exporters are not compiled for macOS, so we test
+# hab pkg exec instead, which is the underlying mechanism for running
+# external package binaries.
+
+$channel = "aarch64-darwin"
+
+Describe "`hab` correctly executes external binaries" {
+    BeforeAll {
+        hab pkg install core/gzip --channel $channel
+    }
+
+    It "`hab pkg exec` runs gzip from the package" {
+        # Cannot use --version/--help/-V because clap intercepts those flags
+        # before they reach the actual binary via execvp().
+        # Instead, compress a file and verify the output exists.
+        "hello habitat" | Set-Content -Path /tmp/hab_test_gzip_input.txt
+        hab pkg exec core/gzip gzip /tmp/hab_test_gzip_input.txt
+        $LASTEXITCODE | Should -Be 0
+        "/tmp/hab_test_gzip_input.txt.gz" | Should -Exist
+        Remove-Item -Force /tmp/hab_test_gzip_input.txt.gz
+    }
+
+    It "`hab pkg exec` can decompress data" {
+        # Verify gzip decompression works via pipe (gzip -d reads stdin)
+        "test data" | Set-Content -Path /tmp/hab_test_gzip2.txt
+        hab pkg exec core/gzip gzip /tmp/hab_test_gzip2.txt
+        hab pkg exec core/gzip gzip -d /tmp/hab_test_gzip2.txt.gz
+        $LASTEXITCODE | Should -Be 0
+        "/tmp/hab_test_gzip2.txt" | Should -Exist
+        Get-Content /tmp/hab_test_gzip2.txt | Should -Be "test data"
+        Remove-Item -Force /tmp/hab_test_gzip2.txt
+    }
+
+    It "`hab pkg exec` with nonexistent package fails" {
+        hab pkg exec core/nonexistent-pkg-12345 some-binary 2>&1
+        $LASTEXITCODE | Should -Not -Be 0
+    }
+
+    It "`hab pkg exec` with nonexistent binary fails" {
+        hab pkg exec core/gzip nonexistent-binary-12345 2>&1
+        $LASTEXITCODE | Should -Not -Be 0
+    }
+
+    It "`hab pkg export` with bad exporter fails gracefully" {
+        hab pkg export a_bad_exporter --help 2>&1
+        $LASTEXITCODE | Should -Not -Be 0
+    }
+}

test/end-to-end/test_pkg_download.ps1

@@ -20,7 +20,7 @@
 # HAB_TEST_CMD=./target/debug/hab test/end-to-end/test_pkg_download.sh
 #
 $cacheDir = "test-cache"
-# core/gzip is not yet available for aarch64-darwin in LTS-2024; use aarch64-darwin channel on macOS
+# use aarch64-darwin channel on macOS
 $downloadChannel = if ($IsMacOS) { "aarch64-darwin" } else { "LTS-2024" }
 
 function Test-IdentDownloaded($FilePrefix) {

test/end-to-end/test_pkg_uninstall_darwin.ps1

@@ -1,7 +1,4 @@
 # macOS-specific pkg uninstall tests.
-# Unlike test_pkg_uninstall.ps1, this does NOT require the supervisor or
-# hab studio (Invoke-BuildAndInstall). It only uses packages available
-# from Builder on the aarch64-darwin channel.
 
 $pkg = "core/sqlite"
 $nginxPkg = "core/nginx"

test/end-to-end/test_simple_hooks_darwin.ps1

@@ -0,0 +1,44 @@
+# macOS-specific hooks tests.
+# Tests hook extension stripping, hook execution during package install,
+# and bad hook extension detection.
+# HAB_INTERPRETER_IDENT is set to core/coreutils in setup_environment_darwin.sh
+# since core/busybox-static is not available for aarch64-darwin.
+
+Describe "Hook extension stripping and execution" {
+    BeforeAll {
+        hab origin key generate $env:HAB_ORIGIN
+        Invoke-Build hook-extension-plan
+        . ./results/last_build.ps1
+        $script:pkgIdent = $pkg_ident
+        $script:pkgName = ($pkg_ident -split "/")[1]
+        $script:pkgPrefix = "/hab/pkgs/$pkg_ident"
+    }
+
+    It "strips .sh extension from hook files" {
+        "$script:pkgPrefix/hooks/install" | Should -Exist
+    }
+
+    It "does not keep the original .sh file" {
+        Test-Path "$script:pkgPrefix/hooks/install.sh" | Should -Be $false
+    }
+
+    It "runs the install hook successfully on package install" {
+        # Install the built package without --ignore-install-hook so the hook runs
+        hab pkg install ./results/$pkg_artifact
+        "$script:pkgPrefix/INSTALL_HOOK_STATUS" | Should -Exist
+        Get-Content "$script:pkgPrefix/INSTALL_HOOK_STATUS" | Should -Be "0"
+    }
+
+    It "install hook renders templates and produces stdout" {
+        $logPath = "/hab/svc/$($script:pkgName)/logs/install.stdout.log"
+        $logPath | Should -Exist
+        Get-Content $logPath | Should -Contain "install hook $($script:pkgName)"
+    }
+}
+
+Describe "Bad hook extension plan" {
+    It "fails when there are multiple extensions for the same hook" {
+        hab pkg build test/fixtures/bad-hook-extension-plan
+        $LASTEXITCODE | Should -Not -Be 0
+    }
+}

test/fixtures/plans/simple-hooks/aarch64-darwin/hooks/install

@@ -0,0 +1,3 @@
+#!/bin/bash
+
+echo "install hook {{pkg.name}}"

test/fixtures/plans/simple-hooks/aarch64-darwin/plan.sh

@@ -0,0 +1,12 @@
+pkg_name="simple-hooks"
+pkg_origin="habitat-testing"
+pkg_version="0.0.0"
+pkg_maintainer="The Habitat Maintainers <humans@habitat.sh>"
+
+do_build() {
+    return 0
+}
+
+do_install() {
+    return 0
+}