From 07802e9a4e261ba43dad24591ad67260ae780185 Mon Sep 17 00:00:00 2001
From: Corey Leath
Date: Fri, 21 Aug 2026 01:07:50 -0400
Subject: [PATCH 1/5] chore: stage README update
---
README_UPDATE_NOTE.tmp | 1 +
1 file changed, 1 insertion(+)
create mode 100644 README_UPDATE_NOTE.tmp
diff --git a/README_UPDATE_NOTE.tmp b/README_UPDATE_NOTE.tmp
new file mode 100644
index 0000000..b3a4252
--- /dev/null
+++ b/README_UPDATE_NOTE.tmp
@@ -0,0 +1 @@
+placeholder
\ No newline at end of file
From aa032dfb30f9562db3c4338bb97097c0c2b420f7 Mon Sep 17 00:00:00 2001
From: Corey Leath
Date: Fri, 21 Aug 2026 01:07:59 -0400
Subject: [PATCH 2/5] chore: remove temporary README staging file
---
README_UPDATE_NOTE.tmp | 1 -
1 file changed, 1 deletion(-)
delete mode 100644 README_UPDATE_NOTE.tmp
diff --git a/README_UPDATE_NOTE.tmp b/README_UPDATE_NOTE.tmp
deleted file mode 100644
index b3a4252..0000000
--- a/README_UPDATE_NOTE.tmp
+++ /dev/null
@@ -1 +0,0 @@
-placeholder
\ No newline at end of file
From 2fb6724bb35d0f7467791e048706c14f800e8ade Mon Sep 17 00:00:00 2001
From: Corey Leath
Date: Fri, 21 Aug 2026 01:08:41 -0400
Subject: [PATCH 3/5] docs: polish release and package presentation
---
README.md | 21 ++++++++++++++++-----
1 file changed, 16 insertions(+), 5 deletions(-)
diff --git a/README.md b/README.md
index 6a00790..ef6eca8 100644
--- a/README.md
+++ b/README.md
@@ -5,10 +5,11 @@
+
+
-
@@ -180,6 +181,17 @@ Run the Streamlit demo locally:
streamlit run streamlit_app.py
```
+### Run the published container
+
+Tagged releases publish the validated image to GitHub Container Registry. After the release workflow succeeds, pull the matching version and run the API:
+
+```bash
+docker pull ghcr.io/coreyleath-code/helixagent:1.1.0
+docker run --rm -p 8000:8000 ghcr.io/coreyleath-code/helixagent:1.1.0
+```
+
+Then verify it with `curl http://localhost:8000/health`.
+
For an isolated package-build check, use the release gate's packaging path:
```bash
@@ -205,15 +217,14 @@ docker run --rm -p 8000:8000 helixagent
## Releases and reproducibility
Maintainers create releases by pushing a validated semantic-version tag; the tag workflow
-validates the exact commit before it can create a GitHub Release.
+validates the exact commit before it can create a GitHub Release and then publishes the validated GHCR image.
~~~bash
git tag -a vX.Y.Z -m "vX.Y.Z"
git push origin vX.Y.Z
~~~
-See [release procedure and evidence artifacts](docs/RELEASING.md) for the required
-changelog/version update, validation, and reproducibility guidance.
+Release artifacts include the deterministic source archive, SHA-256 checksum, CycloneDX SBOM, and reproduction instructions. See [release procedure and evidence artifacts](docs/RELEASING.md) for the required changelog/version update, validation, and reproducibility guidance.
### Reproduce an evidence run
@@ -287,4 +298,4 @@ docs/ Engineering and deployment notes
HelixAgent is an engineering portfolio project and reference implementation, not a managed commercial AI platform. The repository focuses on modularity, graceful degradation, observable services, automated validation, and secure delivery.
-See [Autonomous runtime](docs/AUTONOMY.md), [Security](SECURITY.md), [Contributing](CONTRIBUTING.md), [Changelog](CHANGELOG.md), and [deployment hygiene](docs/L6_DEPLOYMENT_HYGIENE.md).
+See [Autonomous runtime](docs/AUTONOMY.md), [Security](SECURITY.md), [Contributing](CONTRIBUTING.md), [Changelog](CHANGELOG.md), and [deployment hygiene](docs/L6_DEPLOYMENT_HYGIENE.md).
\ No newline at end of file
From 6297b0b1443fef684ef4ac230a08a825fb2176b2 Mon Sep 17 00:00:00 2001
From: Corey Leath
Date: Fri, 21 Aug 2026 01:08:49 -0400
Subject: [PATCH 4/5] noop
---
noop.txt | 1 +
1 file changed, 1 insertion(+)
create mode 100644 noop.txt
diff --git a/noop.txt b/noop.txt
new file mode 100644
index 0000000..a8b6c94
--- /dev/null
+++ b/noop.txt
@@ -0,0 +1 @@
+noop
\ No newline at end of file
From eaf672536203ee92270ed9a3c5435f4c2d5c854a Mon Sep 17 00:00:00 2001
From: Corey Leath
Date: Fri, 21 Aug 2026 01:08:56 -0400
Subject: [PATCH 5/5] chore: remove temporary file
---
noop.txt | 1 -
1 file changed, 1 deletion(-)
delete mode 100644 noop.txt
diff --git a/noop.txt b/noop.txt
deleted file mode 100644
index a8b6c94..0000000
--- a/noop.txt
+++ /dev/null
@@ -1 +0,0 @@
-noop
\ No newline at end of file