Merge pull request #170 from IBM/update-docs-for-0-2-0

Update docs for 0 2 0

Author: crivetimihai

.github/tools/.gitignore

@@ -0,0 +1 @@
+changelog_info.txt

.github/tools/generate-changelog-info.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+#
+# generate-changelog-info.sh
+# Author: Mihai Criveti
+#
+# Dump to one file:
+#   1. Full commit logs since a tag
+#   2. A chronologically-sorted list of issues closed since that tag
+#   3. Full JSON-formatted details for every one of those issues
+#
+# Dependencies: git, GitHub CLI (`gh`), jq
+# Usage:        ./generate-changelog-info.sh [TAG] [OUTPUT_FILE]
+#               TAG defaults to v0.1.1
+#               OUTPUT_FILE defaults to changelog_info.txt
+#
+set -euo pipefail
+
+TAG=${1:-v0.1.1}
+OUT=${2:-changelog_info.txt}
+
+###############################################################################
+# 1.  Commit log
+###############################################################################
+{
+  echo "#############################"
+  echo "## COMMITS since ${TAG}"
+  echo "#############################"
+} >"$OUT"
+
+git log "${TAG}"..HEAD --reverse --no-merges \
+  --pretty=format:'%H%nAuthor: %an <%ae>%nDate:   %ad%n%n%s%n%n%b%n----' \
+  --date=short >>"$OUT"
+
+###############################################################################
+# 2.  Closed-issue list (oldest → newest)
+###############################################################################
+CUTOFF=$(git log -1 --format=%cI "$TAG")   # ISO time of the tag
+
+echo -e "\n#############################" >>"$OUT"
+echo   "## ISSUES closed since ${TAG}"  >>"$OUT"
+echo   "#############################" >>"$OUT"
+
+ISSUES_JSON=$(gh issue list --state closed \
+  --search "closed:>=$CUTOFF" \
+  --limit 1000 \
+  --json number,title,closedAt,url)
+
+echo "$ISSUES_JSON" | jq -r '
+  sort_by(.closedAt)[]
+  | "#\(.number) – \(.title) (closed: \(.closedAt))"
+' >>"$OUT"
+
+###############################################################################
+# 3.  Full issue details
+###############################################################################
+echo -e "\n#############################" >>"$OUT"
+echo   "## ISSUE DETAILS"              >>"$OUT"
+echo   "#############################" >>"$OUT"
+
+# Extract the numbers, then loop for detailed views
+echo "$ISSUES_JSON" | jq -r '.[].number' | while read -r NUM; do
+  echo -e "\n---- ISSUE #$NUM ----" >>"$OUT"
+  gh issue view "$NUM" --json number,title,author,labels,assignees,closedAt,createdAt,url,body \
+    | jq -r '
+        "Number: \(.number)",
+        "Title:  \(.title)",
+        "URL:    \(.url)",
+        "Author: \(.author.login // "unknown")",
+        "Labels: \(.labels | map(.name) | join(", "))",
+        "Assignees: \(.assignees | map(.login) | join(", "))",
+        "Created: \(.createdAt)",
+        "Closed:  \(.closedAt)",
+        "",
+        "Body:\n" + (.body // "*No description*")
+      ' >>"$OUT"
+done
+
+echo -e "\nAll done!  Results written to: $OUT"

CHANGELOG.md

@@ -8,6 +8,71 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 
 ## [0.2.0] - 2025-06-24
 
+### Added
+
+* **Streamable HTTP transport** – full first-class support for MCP's new default transport (deprecated SSE):
+
+  * gateway accepts Streamable HTTP client connections (stateful & stateless). SSE support retained.
+  * UI & API allow registering Streamable HTTP MCP servers with health checks, auth & time-outs
+  * UI now shows a *transport* column for each gateway/tool;
+* **Authentication & stateful sessions** for Streamable HTTP clients/servers (Basic/Bearer headers, session persistence).
+* **Gateway hardening** – connection-level time-outs and smarter health-check retries to avoid UI hangs
+* **Fast Go MCP server example** – high-performance reference server for benchmarking/demos.
+* **Exportable connection strings** – one-click download & `/servers/{id}/connect` API that generates ready-made configs for LangChain, Claude Desktop, etc. (closed #154).
+* **Infrastructure as Code** – initial Terraform & Ansible scripts for cloud installs.
+* **Developer tooling & UX**
+
+  * `tox`, GH Actions *pytest + coverage* workflow
+  * pre-commit linters (ruff, flake8, yamllint) & security scans
+  * dark-mode theme and compact version-info panel in Admin UI
+  * developer onboarding checklist in docs.
+* **Deployment assets** – Helm charts now accept external secrets/Redis; Fly.io guide; Docker-compose local-image switch; Helm deployment walkthrough.
+
+### Changed
+
+* **Minimum supported Python is now 3.11**; CI upgraded to Ubuntu 24.04 / Python 3.12.
+* Added detailed **context-merging algorithm** notes to docs.
+* Refreshed Helm charts, Makefile targets, JWT helper CLI and SBOM generation; tightened typing & linting.
+* 333 unit-tests now pass; major refactors in federation, tool, resource & gateway services improve reliability.
+
+### Fixed
+
+* SBOM generation failure in `make docs` (#132) and Makefile `images` target (#131).
+* GitHub Remote MCP server addition flow (#152).
+* REST path-parameter & payload substitution issues (#100).
+* Numerous flaky tests, missing dependencies and mypy/flake8 violations across the code-base .
+
+### Security
+
+* Dependency bumps and security-policy updates; CVE scans added to pre-commit & CI (commit ed972a8).
+
+### 🙌 New contributors in 0.2.0
+
+Thanks to the new **first-time contributors** who jumped in between 0.1.1 → 0.2.0:
+
+| Contributor              | First delivered in 0.2.0                                                          |
+| ------------------------ | --------------------------------------------------------------------------------- |
+| **Abdul Samad**          | Dark-mode styling across the Admin UI and a more compact version-info panel       |
+| **Arun Babu Neelicattu** | Bumped the minimum supported Python to 3.11 in pyproject.toml                     |
+| **Manoj Jahgirdar**      | Polished the Docs home page / index                                               |
+| **Shoumi Mukherjee**     | General documentation clean-ups and quick-start clarifications                    |
+| **Thong Bui**            | REST adapter: path-parameter (`{id}`) support, `PATCH` handling and 204 responses |
+
+Welcome aboard—your PRs made 0.2.0 measurably better! 🎉
+
+---
+
+### 🙏 Returning contributors who went the extra mile in 0.2.0
+
+| Contributor          | Highlights this release                                                                                                                                                                                                                                                                                                                                   |
+| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Mihai Criveti**    | Release management & 0.2.0 version bump, Helm-chart refactor + deployment guide, full CI revamp (pytest + coverage, pre-commit linters, tox), **333 green unit tests**, security updates, build updates, fully automated deployment to Code Engine, improved helm stack, doc & GIF refresh                                                                                                                                                    |
+| **Keval Mahajan**    | Implemented **Streamable HTTP** transport (client + server) with auth & stateful sessions, transport column in UI, gateway time-outs, extensive test fixes and linting                                                                                                                                                                                    |
+| **Madhav Kandukuri** |• Wrote **ADRs for tool-federation & dropdown UX** <br>• Polished the new **dark-mode** theme<br>• Authored **Issue #154** that specified the connection-string export feature<br>• Plus multiple stability fixes (async DB, gateway add/del, UV sync, Basic-Auth headers) |
+| **Manav Gupta**      | Fixed SBOM generation & license verification, repaired Makefile image/doc targets, improved Docker quick-start and Fly.io deployment docs                                                                                                                                                                                                                 |
+
+*Huge thanks for keeping the momentum going! 🚀*
+
 
 ## [0.1.1] - 2025‑06-14
 

charts/README.md

@@ -1,6 +1,6 @@
 # MCP Gateway Stack – Helm Chart
 
-Deploy the full **MCP Gateway Stack**—MCP Context Forge gateway, PostgreSQL, Redis, and optional PgAdmin & Redis‑Commander UIs—on any Kubernetes distribution with a single Helm release. The chart lives in [`charts/mcp-stack`](https://github.com/IBM/mcp-context-forge/tree/main/charts/mcp-stack).
+Deploy the full **MCP Gateway Stack**-MCP Context Forge gateway, PostgreSQL, Redis, and optional PgAdmin & Redis‑Commander UIs-on any Kubernetes distribution with a single Helm release. The chart lives in [`charts/mcp-stack`](https://github.com/IBM/mcp-context-forge/tree/main/charts/mcp-stack).
 
 ---
 
@@ -128,7 +128,7 @@ Below is a minimal example. Copy the default file and adjust for your environmen
 mcpContextForge:
   image:
     repository: ghcr.io/ibm/mcp-context-forge
-    tag: v1.0.0
+    tag: 0.2.0
   ingress:
     enabled: true
     host: gateway.local   # replace with real DNS
@@ -201,14 +201,14 @@ kubectl delete namespace mcp
 helm lint .
 helm package . -d dist/
 
-# Push the package to GitHub Container Registry
-helm push dist/mcp-stack-*.tgz oci://ghcr.io/<your-org>/charts
+# Push the package to GitHub Container Registry (only for mcp-context-forge release managers!)
+helm push dist/mcp-stack-*.tgz oci://ghcr.io/ibm/mcp-context-forge
 ```
 
 Use the OCI URL below in Argo CD or Flux:
 
 ```
-oci://ghcr.io/<your-org>/charts/mcp-stack
+oci://ghcr.io/ibm/mcp-context-forge
 ```
 
 ---
@@ -260,4 +260,4 @@ For every setting see the [full annotated `values.yaml`](https://github.com/IBM/
 1. Fork the repo and create a feature branch.
 2. Update templates or `values.yaml`.
 3. Test with `helm lint` and `helm template`.
-4. Open a pull request—thank you!
+4. Open a pull request-thank you!