refactor: rename ls-api to ls-mock

Distinguishes the LocalStack endpoint mock (cmd/ls-mock, bin/ls-mock)
from the internal/lsapi package introduced in the previous commit.
Updates all references: Makefile, smoke-test.sh, CI workflow, README,
.gitignore, and test comments.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: joe4dev

.github/workflows/ls-smoke-tests.yml

@@ -11,7 +11,7 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  smoke-ls-api:
+  smoke-ls-mock:
     name: RIE ↔ LocalStack API Smoke Test
     runs-on: ubuntu-latest
     steps:
@@ -23,4 +23,4 @@ jobs:
           go-version-file: go.mod
 
       - name: Run smoke test
-        run: make -C cmd/ls-api smoke-test
+        run: make -C cmd/ls-mock smoke-test

.gitignore

@@ -2,7 +2,7 @@
 /build
 /bin
 aws-lambda-rie
-ls-api
+ls-mock
 *.swp
 *.iml
 tags

README-LOCALSTACK.md

@@ -18,8 +18,8 @@ Refer to [debugging/README.md](./debugging/README.md) for instructions on how to
 | `cmd/localstack`                         | LocalStack customizations                                                                                                                                                                                                                                        |
 | ├── `main.go`                            | Main entrypoint                                                                                                                                                                                                                                                  |
 | ├── `custom_interop.go`                  | Custom server interface between the Lambda runtime API and this Go init. Implements the `Server` interface from `lambda/interop/model.go:Server` but forwards most calls to the original implementation in `lambda/rapidcore/server.go` available as `delegate`. |
-| `cmd/ls-api`                             | Mock LocalStack component for smoke testing                                                                                                                                                                                                                      |
-| ├── [`README.md`](./cmd/ls-api/README.md) | Instructions for LS API<->RIE smoke testing                                                                                                                                                                                                                     |
+| `cmd/ls-mock`                             | Mock LocalStack component for smoke testing                                                                                                                                                                                                                      |
+| ├── [`README.md`](./cmd/ls-mock/README.md) | Instructions for LS API<->RIE smoke testing                                                                                                                                                                                                                     |
 | `debugging/`                             | Debug and test this Go init with LocalStack                                                                                                                                                                                                                      |
 | ├── [`README.md`](./debugging/README.md) | Instructions for building and debugging with LocalStack                                                                                                                                                                                                          |
 | `lambda`                                 | Original AWS implementation of the runtime emulator ideally kept untouched                                                                                                                                                                                       |
@@ -43,6 +43,6 @@ Example PR that integrates upstream changes: https://github.com/localstack/lambd
 
 Document all custom changes with the following comment prefix `# LOCALSTACK CHANGES yyyy-mm-dd:`
 
-* Everything in `cmd/localstack`, `cmd/ls-api`, and `.github`
+* Everything in `cmd/localstack`, `cmd/ls-mock`, and `.github`
 * `Makefile` for debugging and building with Docker
 * 2023-10-17: `lambda/rapidcore/server.go` pass request metadata into .Reserve(invoke.ID, invoke.TraceID, invoke.LambdaSegmentID)

cmd/ls-api/Makefile cmd/ls-mock/Makefilecmd/ls-api/Makefile renamed to cmd/ls-mock/Makefile

@@ -5,7 +5,7 @@ ARCH         ?= x86_64
 MOCK_PORT    := 48490
 INTEROP_PORT := 9563
 RIE_BINARY   := $(REPO_ROOT)/bin/aws-lambda-rie-$(ARCH)
-LS_API_BIN   := $(REPO_ROOT)/bin/ls-api
+LS_MOCK_BIN  := $(REPO_ROOT)/bin/ls-mock
 
 # Common docker flags for start-rie and start-rie-detached.
 # Uses deferred assignment (=) so $$LATEST is not expanded until recipe time,
@@ -25,15 +25,15 @@ RIE_DOCKER_OPTS = \
 	-e _HANDLER=handler.handler \
 	--entrypoint /var/rapid/init
 
-.PHONY: build-rie build-ls-api start-mock start-rie start-rie-detached success fail smoke-test
+.PHONY: build-rie build-ls-mock start-mock start-rie start-rie-detached success fail smoke-test
 
 build-rie:  ## Build the RIE Linux binary via Go cross-compilation (works on macOS)
 	$(MAKE) -C $(REPO_ROOT) ARCH=$(ARCH) compile-lambda-linux
 
-build-ls-api:  ## Build the ls-api mock binary
-	go build -o $(LS_API_BIN) $(THIS_MAKEFILE_DIR)
+build-ls-mock:  ## Build the ls-mock binary
+	go build -o $(LS_MOCK_BIN) $(THIS_MAKEFILE_DIR)
 
-start-mock:  ## Run the ls-api LocalStack endpoint mock natively (no Docker needed)
+start-mock:  ## Run the ls-mock LocalStack endpoint mock natively (no Docker needed)
 	go run $(THIS_MAKEFILE_DIR)
 
 start-rie: build-rie  ## Build and run the RIE inside a Docker Python Lambda container
@@ -48,5 +48,5 @@ success:  ## Trigger a successful invocation via the mock's /success endpoint
 fail:  ## Trigger an error invocation via the mock's /fail endpoint
 	curl -sf http://localhost:$(MOCK_PORT)/fail
 
-smoke-test: build-rie build-ls-api  ## Full e2e smoke test: start mock + RIE, verify success + error invocations, cleanup
+smoke-test: build-rie build-ls-mock  ## Full e2e smoke test: start mock + RIE, verify success + error invocations, cleanup
 	$(THIS_MAKEFILE_DIR)/smoke-test.sh

cmd/ls-api/README.md cmd/ls-mock/README.mdcmd/ls-api/README.md renamed to cmd/ls-mock/README.md

@@ -1,4 +1,4 @@
-# ls-api — LocalStack endpoint mock
+# ls-mock — LocalStack endpoint mock
 
 A lightweight HTTP server that stands in for the LocalStack endpoint when testing the RIE in isolation, without a running LocalStack instance.
 
@@ -60,4 +60,4 @@ To run the full e2e smoke test non-interactively (used in CI):
 make smoke-test
 ```
 
-This builds both the RIE binary and the ls-api mock, starts them, verifies a successful and a failing invocation, then cleans up.
+This builds both the RIE binary and the ls-mock mock, starts them, verifies a successful and a failing invocation, then cleans up.

cmd/ls-api/handler.py cmd/ls-mock/handler.pycmd/ls-api/handler.py renamed to cmd/ls-mock/handler.py

@@ -14,7 +14,7 @@ import (
 	"github.com/stretchr/testify/require"
 )
 
-// These tests verify the ls-api mock server (cmd/ls-api) — a manual testing tool that
+// These tests verify the ls-mock mock server (cmd/ls-mock) — a manual testing tool that
 // emulates the LocalStack endpoint locally. They do NOT test the production RIE code.
 // For regression tests of the actual LS↔RIE API contract, see cmd/localstack/custom_interop_test.go.
 

cmd/ls-api/main.go cmd/ls-mock/main.gocmd/ls-api/main.go renamed to cmd/ls-mock/main.go

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# e2e smoke test: starts the ls-api mock and the RIE in Docker, then verifies that
+# e2e smoke test: starts the ls-mock mock and the RIE in Docker, then verifies that
 # both a successful and a failing Lambda invocation complete correctly.
 # Exits 0 on success, non-zero on failure. Cleans up on exit.
 set -euo pipefail
@@ -8,9 +8,9 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
 
 MOCK_PORT=48490
-LS_API_BIN="$REPO_ROOT/bin/ls-api"
+LS_API_BIN="$REPO_ROOT/bin/ls-mock"
 
-LOG_FILE=$(mktemp -t ls-api-smoke.XXXXXX)
+LOG_FILE=$(mktemp -t ls-mock-smoke.XXXXXX)
 CID_FILE=$(mktemp -t rie-smoke.XXXXXX)
 
 cleanup() {
@@ -41,13 +41,13 @@ wait_for_log() {
         echo "--- RIE container logs ---" >&2
         docker logs "$cid" 2>&1 >&2 || true
     fi
-    echo "--- ls-api log ---" >&2
+    echo "--- ls-mock log ---" >&2
     cat "$LOG_FILE" >&2
     return 1
 }
 
 # ---- start mock ----
-echo ">>> Starting ls-api mock (port $MOCK_PORT)"
+echo ">>> Starting ls-mock mock (port $MOCK_PORT)"
 "$LS_API_BIN" > "$LOG_FILE" 2>&1 &
 MOCK_PID=$!
 for i in $(seq 1 10); do nc -z localhost $MOCK_PORT 2>/dev/null && break || sleep 1; done
@@ -74,5 +74,5 @@ echo ">>> Error invocation received"
 echo ""
 echo "=== Smoke test passed: success + error invocations verified ==="
 echo ""
-echo "--- ls-api log ---"
+echo "--- ls-mock log ---"
 cat "$LOG_FILE"