docs: bump version to 42, update changelog and readme, and add AGENTS.md

justin8 · justin8 · commit a384fa574814 · 2026-07-19T13:06:22.000-07:00
diff --git a/AGENTS.md b/AGENTS.md
@@ -0,0 +1,43 @@
+# AI Agent Guidelines: Version Updates and Releases
+
+This document provides instructions for AI coding assistants on how to perform version bumps and manage releases in this repository.
+
+## Steps to Perform a Version Update
+
+When asked to update the version/bump the release tag (e.g., from `42` to `43`):
+
+### 1. Update Version References in Documentation
+* Search **[README.md](file:///Users/justindray/src/docker-http-https-echo/README.md)** for all instances of the old version tag (e.g. `:42`) and replace them with the new version tag (e.g. `:43`). 
+* Make sure all docker run examples and registry path snippets in the documentation match the new tag.
+
+### 2. Update Orchestration Files
+* Open **[docker-compose.yml](file:///Users/justindray/src/docker-http-https-echo/docker-compose.yml)** and update the image tag namespace to match the new version:
+  ```yaml
+  image: justin8/http-https-echo:<NEW_VERSION>
+  ```
+
+### 3. Update the Changelog
+* Open **[CHANGELOG.md](file:///Users/justindray/src/docker-http-https-echo/CHANGELOG.md)** and add a new version block at the very top of the file:
+  ```markdown
+  ## Version `<NEW_VERSION>` - YYYY-MM-DD
+  * Brief description of change 1
+  * Brief description of change 2
+  ```
+  *(Format the date as `YYYY-MM-DD` according to the system current local time).*
+
+### 4. Running the Test Suite
+* **CRITICAL**: Before committing any changes or creating releases, always verify that the codebase passes the local test suite using your container CLI:
+  ```bash
+  export DOCKER=container # Or docker
+  ./tests.sh
+  ```
+  *(Never skip this step, as changes to logging formats or startup behavior can break exact line-count assertions in the test suite).*
+
+---
+
+## CI/CD and Release Mechanisms
+
+Our GitHub workflow **[publish.yml](file:///Users/justindray/src/docker-http-https-echo/.github/workflows/publish.yml)** is configured as follows:
+
+* **Commit to `master`**: Automatically builds and publishes the `:latest` image tag to both Docker Hub and GitHub Container Registry.
+* **Semantic Tag Release**: Pushing any tag (e.g., `v42`) triggers the publication of versioned images (e.g. `:42` and `:v42`).
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,10 @@
+## Version `42` - 2026-07-19
+* Added a real-time web-based log streaming dashboard on port `8081` (configurable via `LOG_SERVER_PORT`).
+* Captures standard and Morgan logs in the container and displays them as colorized lines or interactive collapsible JSON request trees.
+* Optimized server shutdown processes with instant connection termination for keep-alive and SSE clients.
+* Updated CI/CD publish workflows to push the `latest` tag on every commit to `master` and tag releases on Git tags.
+* Refactored local testing environment to support standard `$DOCKER` environment variables (e.g., using macOS native `container` command) with direct container removal (`rm -f`).
+
 ## Version `41` - 2026-06-14
 * Added support for additional trusted proxies via `ADDITIONAL_TRUSTED_PROXIES` by [JackMyers001](https://github.com/justin8/docker-http-https-echo/pull/101)
 * Express update includes the new way of catching all paths
diff --git a/README.md b/README.md
@@ -8,8 +8,8 @@ It comes with various options that can manipulate the response output, see the t
 
 ![browser](./screenshots/screenshot.png)
 
-The image is available on [Docker Hub](https://hub.docker.com/r/justin8/http-https-echo): `justin8/http-https-echo:41`  
-The image is available on [Github Container Registry](https://github.com/justin8/docker-http-https-echo/pkgs/container/http-https-echo): `ghcr.io/justin8/http-https-echo:41`
+The image is available on [Docker Hub](https://hub.docker.com/r/justin8/http-https-echo): `justin8/http-https-echo:42`  
+The image is available on [Github Container Registry](https://github.com/justin8/docker-http-https-echo/pkgs/container/http-https-echo): `ghcr.io/justin8/http-https-echo:42`
 
 Please do not use the `:latest` tag as it will break without warning, use a specific version instead.
 
@@ -47,7 +47,7 @@ This image is executed as non root by default and is fully compliant with Kubern
 
 Run with Docker
 
-    docker run -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:41
+    docker run -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:42
 
 Or run with Docker Compose
 
@@ -64,13 +64,13 @@ You can choose a different internal port instead of 8080 and 8443 with the `HTTP
 
 In this example I'm setting http to listen on 8888, and https to listen on 9999.
 
-     docker run -e HTTP_PORT=8888 -e HTTPS_PORT=9999 -p 8080:8888 -p 8443:9999 --rm -t justin8/http-https-echo:41
+     docker run -e HTTP_PORT=8888 -e HTTPS_PORT=9999 -p 8080:8888 -p 8443:9999 --rm -t justin8/http-https-echo:42
 
 
 With docker compose, this would be:
 
     my-http-listener:
-        image: justin8/http-https-echo:41
+        image: justin8/http-https-echo:42
         environment:
             - HTTP_PORT=8888
             - HTTPS_PORT=9999
@@ -86,7 +86,7 @@ The certificates are at `/app/fullchain.pem` and `/app/testpk.pem`.
 You can use volume mounting to substitute the certificate and private key with your own.
 
     my-http-listener:
-        image: justin8/http-https-echo:41
+        image: justin8/http-https-echo:42
         ports:
             - "8080:8080"
             - "8443:8443"
@@ -101,14 +101,14 @@ You can use the environment variables `HTTPS_CERT_FILE` and `HTTPS_KEY_FILE` to
 
 By default, Express is configured to trust forwarded proxy headers from loopback, link-local, and private IP ranges. To also trust additional proxy IPs or subnets, set `ADDITIONAL_TRUSTED_PROXIES` to a single value or a comma-separated list.
 
-    docker run -e ADDITIONAL_TRUSTED_PROXIES="2001:db8::/32,203.0.113.10" -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:41
+    docker run -e ADDITIONAL_TRUSTED_PROXIES="2001:db8::/32,203.0.113.10" -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:42
 
 
 ## Decode JWT header
 
 If you specify the header that contains the JWT, the echo output will contain the decoded JWT.  Use the `JWT_HEADER` environment variable for this.
 
-    docker run -e JWT_HEADER=Authentication -p 8080:8080 -p 8443:8443 --rm -it justin8/http-https-echo:41
+    docker run -e JWT_HEADER=Authentication -p 8080:8080 -p 8443:8443 --rm -it justin8/http-https-echo:42
 
 
 Now make your request with `Authentication: eyJ...` header (it should also work with the `Authentication: Bearer eyJ...` schema too):
@@ -121,7 +121,7 @@ And in the output you should see a `jwt` section.
 
 In the log output set the environment variable `DISABLE_REQUEST_LOGS` to true, to disable the specific ExpressJS request log lines. The ones like `::ffff:172.17.0.1 - - [03/Jan/2022:21:31:51 +0000] "GET /xyz HTTP/1.1" 200 423 "-" "curl/7.68.0"`.  The JSON output will still appear.
 
-    docker run --rm -e DISABLE_REQUEST_LOGS=true --name http-echo-tests -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:41
+    docker run --rm -e DISABLE_REQUEST_LOGS=true --name http-echo-tests -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:42
 
 
 ## Do not log specific path
@@ -130,12 +130,12 @@ Set the environment variable `LOG_IGNORE_PATH` to a path or a regex you would li
 This can help reduce noise from healthchecks in orchestration/infrastructure like Swarm, Kubernetes, ALBs, etc.
 
     # Ignore a single path    
-    docker run -e LOG_IGNORE_PATH=/ping -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:41
+    docker run -e LOG_IGNORE_PATH=/ping -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:42
     # Ignore multiple paths
-    docker run -e LOG_IGNORE_PATH="^\/ping|^\/health|^\/metrics" -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:41
+    docker run -e LOG_IGNORE_PATH="^\/ping|^\/health|^\/metrics" -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:42
     # Ignore all paths
-    docker run -e LOG_IGNORE_PATH=".*" -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:41
-    docker run -e LOG_IGNORE_PATH="^" -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:41
+    docker run -e LOG_IGNORE_PATH=".*" -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:42
+    docker run -e LOG_IGNORE_PATH="^" -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:42
 
 
 
@@ -162,15 +162,15 @@ Will contain a `json` property in the response/output.
 You can disable new lines in the log output by setting the environment variable `LOG_WITHOUT_NEWLINE`. For example,
 
 ```bash
-docker run -e LOG_WITHOUT_NEWLINE=true -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:41
+docker run -e LOG_WITHOUT_NEWLINE=true -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:42
 ```
 
 ## Send an empty response
 
 You can disable the JSON output in the response by setting the environment variable `ECHO_BACK_TO_CLIENT`. For example,
 
 ```bash
-docker run -e ECHO_BACK_TO_CLIENT=false -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:41
+docker run -e ECHO_BACK_TO_CLIENT=false -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:42
 ```
 
 ## Custom status code
@@ -251,7 +251,7 @@ You can have environment variables (that are visible to the echo server's proces
 Pass the `ECHO_INCLUDE_ENV_VARS=1` environment variable in.
 
 ```bash
-docker run -d --rm -e ECHO_INCLUDE_ENV_VARS=1 --name http-echo-tests -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:41
+docker run -d --rm -e ECHO_INCLUDE_ENV_VARS=1 --name http-echo-tests -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:42
 ```
 
 Then do a normal request via curl or browser, and you will see the `env` property in the response body.
@@ -291,7 +291,7 @@ openssl pkcs12 -export -in cert.pem -inkey testpk.pem -out certpkcs12.pfx
 By default, the headers in the response body are lowercased. To attempt to preserve the case of headers in the response body, set the environment variable `PRESERVE_HEADER_CASE` to true.
 
 ```bash
-docker run -e PRESERVE_HEADER_CASE=true -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:41
+docker run -e PRESERVE_HEADER_CASE=true -p 8080:8080 -p 8443:8443 --rm -t justin8/http-https-echo:42
 ```
 
 ## Override the response body with a file
@@ -300,23 +300,23 @@ To override the response body with a file, set the environment variable `OVERRID
 The file path needs to be in the `/app` directory.  
 
 ```bash
-docker run -d --rm -v ${PWD}/test.html:/app/test.html -p 8080:8080 -e OVERRIDE_RESPONSE_BODY_FILE_PATH=/test.html -t justin8/http-https-echo:41
+docker run -d --rm -v ${PWD}/test.html:/app/test.html -p 8080:8080 -e OVERRIDE_RESPONSE_BODY_FILE_PATH=/test.html -t justin8/http-https-echo:42
 ```
 
 ## Set a maximum header size
 
 You can use the `MAX_HEADER_SIZE` environment variable to set a maximum header size in bytes. The default is 1MB. 
 
 ```bash
-docker run -d --rm -e MAX_HEADER_SIZE=1000  -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:41
+docker run -d --rm -e MAX_HEADER_SIZE=1000  -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:42
 ```
 
 ## Cookies and Signed Cookies
 
 Make a request with a `Cookie` header and the response will include the cookies:
 
 ```bash
-docker run -d --rm --name http-echo-tests -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:41
+docker run -d --rm --name http-echo-tests -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:42
 ```
 
 Then make a request with a cookie header:
@@ -328,7 +328,7 @@ curl -s http://localhost:8080/ -H "Cookie: foo=bar; baz=qux"
 To enable signed cookie support, set the `COOKIE_SECRET` environment variable. Signed cookies appear in the `signedCookies` section of the response:
 
 ```bash
-docker run -d --rm -e COOKIE_SECRET=mysecretkey123 --name http-echo-tests -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:41
+docker run -d --rm -e COOKIE_SECRET=mysecretkey123 --name http-echo-tests -p 8080:8080 -p 8443:8443 -t justin8/http-https-echo:42
 ```
 
 Now you need to generate a signed cookie, and send it in the header. Here's a convenience node snippet:
diff --git a/docker-compose.yml b/docker-compose.yml
@@ -1,7 +1,7 @@
 version: '3'
 services:
     my-http-listener:
-        image: justin8/http-https-echo:41
+        image: justin8/http-https-echo:42
         environment:
             - HTTP_PORT=8888
             - HTTPS_PORT=9999
