From f0fca77995ac801180be0e26527a36f8f1773967 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 15:37:13 +0530
Subject: [PATCH 01/23] feat: add automatic changelog generation workflow

---
 .github/workflows/changelog.yml | 45 +++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 .github/workflows/changelog.yml

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
new file mode 100644
index 0000000..56a06cd
--- /dev/null
+++ b/.github/workflows/changelog.yml
@@ -0,0 +1,45 @@
+name: Auto Changelog
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  generate-changelog:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Build Changelog/Release Notes
+        id: github_release
+        uses: mikepenz/release-changelog-builder-action@v4
+        with:
+          configuration: |
+            {
+              "categories": [
+                { "title": "### Features", "labels": ["feature", "feat"] },
+                { "title": "### Fixes", "labels": ["fix", "bug"] },
+                { "title": "### Improvements", "labels": ["perf", "refactor"] },
+                { "title": "### Documentation", "labels": ["doc", "docs"] }
+              ]
+            }
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Update CHANGELOG.md File
+        run: |
+          echo -e "# Changelog\n\n## ${{ github.ref_name }}\n\n${{ steps.github_release.outputs.changelog }}\n\n$(cat CHANGELOG.md 2>/dev/null || true)" > CHANGELOG.md
+
+      - name: Commit and Push Changes
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git add CHANGELOG.md
+          git commit -m "chore: update CHANGELOG.md for ${{ github.ref_name }} [skip ci]"
+          git push origin HEAD:${{ github.event.repository.default_branch }}
\ No newline at end of file

From 56c7f14846fec55138555b53547b8df77990be54 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 15:39:22 +0530
Subject: [PATCH 02/23] Fix formatting in installation instructions

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d8e5586..2f3a4b7 100644
--- a/README.md
+++ b/README.md
@@ -13,11 +13,12 @@ KDM (Kubernetes Docker Monitor) is a lightweight, terminal-based monitoring CLI
 
 ## Installation
 
+Install kdm-cli via npm:
 ```bash
 npm install -g kdm-cli
 ```
 
-Or run directly with npx:
+Run directly with npx:
 
 ```bash
 npx kdm-cli

From b75d96e548c3cd194dffe84bb01450f34752d87f Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 16:01:29 +0530
Subject: [PATCH 03/23] Update changelog workflow to save versioned docs

---
 .github/workflows/changelog.yml | 23 ++++++++++++++++++-----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 56a06cd..59ae01f 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -32,14 +32,27 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Update CHANGELOG.md File
+      - name: Save Versioned Docs Management Changelog
         run: |
-          echo -e "# Changelog\n\n## ${{ github.ref_name }}\n\n${{ steps.github_release.outputs.changelog }}\n\n$(cat CHANGELOG.md 2>/dev/null || true)" > CHANGELOG.md
+          # 1. Create the target directory structure if it doesn't exist
+          mkdir -p docs/changelogs
+          
+          # 2. Define the filename dynamically using the current release tag string
+          # Example output path: docs/changelogs/v2.1.0.md
+          VERSION_FILE="docs/changelogs/${{ github.ref_name }}.md"
+          
+          # 3. Write clean header structure and populate it with generated release notes
+          echo -e "# Release Notes for ${{ github.ref_name }}\n" > "$VERSION_FILE"
+          echo -e "Published on: $(date +'%Y-%m-%d')\n" >> "$VERSION_FILE"
+          echo -e "${{ steps.github_release.outputs.changelog }}" >> "$VERSION_FILE"
 
       - name: Commit and Push Changes
         run: |
           git config --local user.email "github-actions[bot]@users.noreply.github.com"
           git config --local user.name "github-actions[bot]"
-          git add CHANGELOG.md
-          git commit -m "chore: update CHANGELOG.md for ${{ github.ref_name }} [skip ci]"
-          git push origin HEAD:${{ github.event.repository.default_branch }}
\ No newline at end of file
+          
+          # Stage the entire docs directory to track the new file addition
+          git add docs/
+          
+          git commit -m "chore: add version doc changelog for ${{ github.ref_name }} [skip ci]"
+          git push origin HEAD:${{ github.event.repository.default_branch }}

From 7b8198fe815a47f89448ff57ff7651b2509c0e43 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 16:05:02 +0530
Subject: [PATCH 04/23] Modify changelog workflow to target feature branch

Updated the changelog workflow to push changes to a feature branch instead of the default branch.
---
 .github/workflows/changelog.yml | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 59ae01f..ae4c09d 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -50,9 +50,7 @@ jobs:
         run: |
           git config --local user.email "github-actions[bot]@users.noreply.github.com"
           git config --local user.name "github-actions[bot]"
-          
-          # Stage the entire docs directory to track the new file addition
           git add docs/
-          
           git commit -m "chore: add version doc changelog for ${{ github.ref_name }} [skip ci]"
-          git push origin HEAD:${{ github.event.repository.default_branch }}
+          # TEMPORARILY CHANGE THIS TO TARGET YOUR FEATURE BRANCH:
+          git push origin HEAD:feat/changelog-auto-workflow

From dec901f8449cfe723980680e78537cd93020c500 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sun, 17 May 2026 10:36:39 +0000
Subject: [PATCH 05/23] chore: add version doc changelog for v9.9.9 [skip ci]

---
 docs/changelogs/v9.9.9.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 docs/changelogs/v9.9.9.md

diff --git a/docs/changelogs/v9.9.9.md b/docs/changelogs/v9.9.9.md
new file mode 100644
index 0000000..0f0fe5d
--- /dev/null
+++ b/docs/changelogs/v9.9.9.md
@@ -0,0 +1,5 @@
+# Release Notes for v9.9.9
+
+Published on: 2026-05-17
+
+- no changes

From d1cef88e062fb20963b71f6b1eda3c2526164963 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 16:08:29 +0530
Subject: [PATCH 06/23] Enhance changelog workflow for docs staging

Updated the changelog workflow to include staging and committing of docs.
---
 .github/workflows/changelog.yml | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index ae4c09d..af3ec71 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -50,7 +50,14 @@ jobs:
         run: |
           git config --local user.email "github-actions[bot]@users.noreply.github.com"
           git config --local user.name "github-actions[bot]"
+          
+          # Stage the docs directory
           git add docs/
+          
           git commit -m "chore: add version doc changelog for ${{ github.ref_name }} [skip ci]"
-          # TEMPORARILY CHANGE THIS TO TARGET YOUR FEATURE BRANCH:
+          
+          # 1. Pull latest changes (like the newly created tag/release info) and rebase your commit on top of it
+          git pull origin feat/changelog-auto-workflow --rebase
+          
+          # 2. Push the changes back securely
           git push origin HEAD:feat/changelog-auto-workflow

From 9c4c1b4f152437029b6f02fa52f4f6a382f25128 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sun, 17 May 2026 10:43:46 +0000
Subject: [PATCH 07/23] chore: add version doc changelog for v1.2.3 [skip ci]

---
 docs/changelogs/v1.2.3.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 docs/changelogs/v1.2.3.md

diff --git a/docs/changelogs/v1.2.3.md b/docs/changelogs/v1.2.3.md
new file mode 100644
index 0000000..8048059
--- /dev/null
+++ b/docs/changelogs/v1.2.3.md
@@ -0,0 +1,5 @@
+# Release Notes for v1.2.3
+
+Published on: 2026-05-17
+
+

From 0ce5d5d59d9083eb2a5ac1770f292bc7eb11497e Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 16:17:56 +0530
Subject: [PATCH 08/23] Update changelog workflow to use default branch
 dynamically

---
 .github/workflows/changelog.yml | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index af3ec71..53246fc 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -15,6 +15,8 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
+          # Dynamically pulls their default branch (main/master) instead of hardcoding your feature branch
+          ref: ${{ github.event.repository.default_branch }}
 
       - name: Build Changelog/Release Notes
         id: github_release
@@ -38,7 +40,6 @@ jobs:
           mkdir -p docs/changelogs
           
           # 2. Define the filename dynamically using the current release tag string
-          # Example output path: docs/changelogs/v2.1.0.md
           VERSION_FILE="docs/changelogs/${{ github.ref_name }}.md"
           
           # 3. Write clean header structure and populate it with generated release notes
@@ -51,13 +52,14 @@ jobs:
           git config --local user.email "github-actions[bot]@users.noreply.github.com"
           git config --local user.name "github-actions[bot]"
           
+          # Force tracking line to align cleanly with the upstream main branch architecture
+          git checkout ${{ github.event.repository.default_branch }}
+          git pull origin ${{ github.event.repository.default_branch }} --ff-only
+          
           # Stage the docs directory
           git add docs/
           
           git commit -m "chore: add version doc changelog for ${{ github.ref_name }} [skip ci]"
           
-          # 1. Pull latest changes (like the newly created tag/release info) and rebase your commit on top of it
-          git pull origin feat/changelog-auto-workflow --rebase
-          
-          # 2. Push the changes back securely
-          git push origin HEAD:feat/changelog-auto-workflow
+          # Push directly and safely into the project's production target branch
+          git push origin HEAD:${{ github.event.repository.default_branch }}

From b5357fdbe9321bb6df0c363bcb4a7691023396ff Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 16:19:11 +0530
Subject: [PATCH 09/23] Update comment for clarity in changelog workflow

---
 .github/workflows/changelog.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 53246fc..339caca 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -15,7 +15,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          # Dynamically pulls their default branch (main/master) instead of hardcoding your feature branch
+          # Dynamically pulls the default branch (main/master) instead of hardcoding your feature branch
           ref: ${{ github.event.repository.default_branch }}
 
       - name: Build Changelog/Release Notes

From c4c89d1372bf17cf5aa3988bce7bbda795407776 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 16:26:42 +0530
Subject: [PATCH 10/23] All logs for previous releases added

---
 docs/changelogs/v1.1.3.md | 3 +++
 docs/changelogs/v1.2.0.md | 3 +++
 docs/changelogs/v1.2.1.md | 3 +++
 docs/changelogs/v1.2.3.md | 5 -----
 docs/changelogs/v9.9.9.md | 5 -----
 5 files changed, 9 insertions(+), 10 deletions(-)
 create mode 100644 docs/changelogs/v1.1.3.md
 create mode 100644 docs/changelogs/v1.2.0.md
 create mode 100644 docs/changelogs/v1.2.1.md
 delete mode 100644 docs/changelogs/v1.2.3.md
 delete mode 100644 docs/changelogs/v9.9.9.md

diff --git a/docs/changelogs/v1.1.3.md b/docs/changelogs/v1.1.3.md
new file mode 100644
index 0000000..6fb4221
--- /dev/null
+++ b/docs/changelogs/v1.1.3.md
@@ -0,0 +1,3 @@
+# Release Notes for v1.1.3
+
+Historical release content can be viewed in the main repository deployment logs.
diff --git a/docs/changelogs/v1.2.0.md b/docs/changelogs/v1.2.0.md
new file mode 100644
index 0000000..bda2805
--- /dev/null
+++ b/docs/changelogs/v1.2.0.md
@@ -0,0 +1,3 @@
+# Release Notes for v1.2.0
+
+Historical release content can be viewed in the main repository deployment logs.
diff --git a/docs/changelogs/v1.2.1.md b/docs/changelogs/v1.2.1.md
new file mode 100644
index 0000000..4bf5c54
--- /dev/null
+++ b/docs/changelogs/v1.2.1.md
@@ -0,0 +1,3 @@
+# Release Notes for v1.2.1
+
+Historical release content can be viewed in the main repository deployment logs.
diff --git a/docs/changelogs/v1.2.3.md b/docs/changelogs/v1.2.3.md
deleted file mode 100644
index 8048059..0000000
--- a/docs/changelogs/v1.2.3.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Release Notes for v1.2.3
-
-Published on: 2026-05-17
-
-
diff --git a/docs/changelogs/v9.9.9.md b/docs/changelogs/v9.9.9.md
deleted file mode 100644
index 0f0fe5d..0000000
--- a/docs/changelogs/v9.9.9.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Release Notes for v9.9.9
-
-Published on: 2026-05-17
-
-- no changes

From 85f477260409778097fd8628ba6379473bc59569 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 16:31:42 +0530
Subject: [PATCH 11/23] Update changelog workflow for versioned documentation

---
 .github/workflows/changelog.yml | 47 ++++++++++++++++++++++-----------
 1 file changed, 31 insertions(+), 16 deletions(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 339caca..cc1372f 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -1,4 +1,4 @@
-name: Auto Changelog
+name: Auto Changelog & Versioned Docs
 
 on:
   release:
@@ -15,7 +15,6 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          # Dynamically pulls the default branch (main/master) instead of hardcoding your feature branch
           ref: ${{ github.event.repository.default_branch }}
 
       - name: Build Changelog/Release Notes
@@ -34,32 +33,48 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Save Versioned Docs Management Changelog
+      - name: Scaffold Versioned CLI Documentation System
         run: |
-          # 1. Create the target directory structure if it doesn't exist
-          mkdir -p docs/changelogs
+          VERSION="${{ github.ref_name }}"
+          TARGET_DIR="docs/${VERSION}"
+          TEMPLATE_DIR=".github/docs-template"
           
-          # 2. Define the filename dynamically using the current release tag string
-          VERSION_FILE="docs/changelogs/${{ github.ref_name }}.md"
+          # 1. Create the unique versioned directory hierarchy
+          mkdir -p "$TARGET_DIR"
           
-          # 3. Write clean header structure and populate it with generated release notes
-          echo -e "# Release Notes for ${{ github.ref_name }}\n" > "$VERSION_FILE"
-          echo -e "Published on: $(date +'%Y-%m-%d')\n" >> "$VERSION_FILE"
-          echo -e "${{ steps.github_release.outputs.changelog }}" >> "$VERSION_FILE"
+          # 2. If a core template folder exists, copy its entire structural hierarchy over
+          if [ -d "$TEMPLATE_DIR" ]; then
+            cp -r "$TEMPLATE_DIR"/* "$TARGET_DIR"/
+            
+            # 3. Recursively inject the mandatory Version string into every markdown file copied
+            find "$TARGET_DIR" -type f -name "*.md" -exec sh -c '
+              for file; do
+                echo -e "\n---\n**Version:** '"$VERSION"'" >> "$file"
+              done
+            ' _ {} +
+          else
+            # Fallback structure if the template directory isn't initialized yet
+            mkdir -p "$TARGET_DIR/config" "$TARGET_DIR/runner" "$TARGET_DIR/docker" "$TARGET_DIR/kubernetes" "$TARGET_DIR/monitoring"
+          fi
+          
+          # 4. Generate the dedicated version README.md using the Release Engine Changelog output
+          VERSION_README="$TARGET_DIR/README.md"
+          echo -e "# KDM CLI Documentation - ${VERSION}\n" > "$VERSION_README"
+          echo -e "Published on: $(date +'%Y-%m-%d')\n" >> "$VERSION_README"
+          echo -e "## Release Changelog\n" >> "$VERSION_README"
+          echo -e "${{ steps.github_release.outputs.changelog }}" >> "$VERSION_README"
+          echo -e "\n---\n**Version Information:** ${VERSION}" >> "$VERSION_README"
 
       - name: Commit and Push Changes
         run: |
           git config --local user.email "github-actions[bot]@users.noreply.github.com"
           git config --local user.name "github-actions[bot]"
           
-          # Force tracking line to align cleanly with the upstream main branch architecture
           git checkout ${{ github.event.repository.default_branch }}
           git pull origin ${{ github.event.repository.default_branch }} --ff-only
           
-          # Stage the docs directory
+          # Track and stage the entire documentation change block
           git add docs/
           
-          git commit -m "chore: add version doc changelog for ${{ github.ref_name }} [skip ci]"
-          
-          # Push directly and safely into the project's production target branch
+          git commit -m "docs: auto-scaffold documentation architecture for ${{ github.ref_name }} [skip ci]"
           git push origin HEAD:${{ github.event.repository.default_branch }}

From cd79a31faf76fd1ef708c41429d5fc194d47c2de Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 16:33:20 +0530
Subject: [PATCH 12/23] feat: implement version-based directory documentation
 scaffolding system

---
 .github/docs-template/config/setup.md | 9 +++++++++
 .github/docs-template/runner/start.md | 9 +++++++++
 2 files changed, 18 insertions(+)
 create mode 100644 .github/docs-template/config/setup.md
 create mode 100644 .github/docs-template/runner/start.md

diff --git a/.github/docs-template/config/setup.md b/.github/docs-template/config/setup.md
new file mode 100644
index 0000000..9141ea0
--- /dev/null
+++ b/.github/docs-template/config/setup.md
@@ -0,0 +1,9 @@
+# Config Setup
+
+## 1. Command Overview
+
+## 2. Syntax
+
+## 3. Parameters & Options
+
+## 4. Example Usage
diff --git a/.github/docs-template/runner/start.md b/.github/docs-template/runner/start.md
new file mode 100644
index 0000000..7b1c041
--- /dev/null
+++ b/.github/docs-template/runner/start.md
@@ -0,0 +1,9 @@
+# Runner Start
+
+## 1. Command Overview
+
+## 2. Syntax
+
+## 3. Parameters & Options
+
+## 4. Example Usage

From 39183f54f533281f0e8725baf01a93a7d64b95ae Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 16:51:47 +0530
Subject: [PATCH 13/23] feat: align master documentation templates with
 official v1.2.1 structure

---
 .github/docs-template/README.md        |   0
 .github/docs-template/config/README.md | 134 +++++++++++++++++++++
 .github/docs-template/config/setup.md  |   9 --
 .github/docs-template/health/README.md | 154 +++++++++++++++++++++++++
 .github/docs-template/logs/README.md   | 143 +++++++++++++++++++++++
 .github/docs-template/runner/start.md  |   9 --
 .github/docs-template/show/README.md   | 134 +++++++++++++++++++++
 .github/docs-template/watch/README.md  |  52 +++++++++
 8 files changed, 617 insertions(+), 18 deletions(-)
 create mode 100644 .github/docs-template/README.md
 create mode 100644 .github/docs-template/config/README.md
 delete mode 100644 .github/docs-template/config/setup.md
 create mode 100644 .github/docs-template/health/README.md
 create mode 100644 .github/docs-template/logs/README.md
 delete mode 100644 .github/docs-template/runner/start.md
 create mode 100644 .github/docs-template/show/README.md
 create mode 100644 .github/docs-template/watch/README.md

diff --git a/.github/docs-template/README.md b/.github/docs-template/README.md
new file mode 100644
index 0000000..e69de29
diff --git a/.github/docs-template/config/README.md b/.github/docs-template/config/README.md
new file mode 100644
index 0000000..18d5ab9
--- /dev/null
+++ b/.github/docs-template/config/README.md
@@ -0,0 +1,134 @@
+# `kdm config` — Configuration Management
+
+**Version:** v1.2.1
+
+## Overview
+
+The `kdm config` command group manages KDM CLI configuration, including notification service setup, custom settings, and credential management. Configuration is stored locally using the `conf` package.
+
+## Syntax
+
+```bash
+kdm config <subcommand>
+```
+
+## Sub-commands
+
+### `kdm config setup`
+
+Interactively sets up the notification service (Discord webhook or Email SMTP).
+
+**Example:**
+
+```bash
+kdm config setup
+```
+
+**Interactive Flow:**
+
+1. Select a notification service:
+   - **Discord** — Send alerts to a Discord channel via webhook.
+   - **Email (SMTP)** — Send alerts via email SMTP.
+   - **None** — Disable notifications.
+
+2. For **Discord**, you will be prompted for a webhook URL.
+3. For **Email**, you will be prompted for SMTP host, port, user, and recipient email.
+
+**Discord Webhook Setup:**
+
+1. Open your Discord server settings.
+2. Go to **Integrations > Webhooks**.
+3. Create a new webhook and choose the alert channel.
+4. Copy the webhook URL (must start with `https://discord.com/api/webhooks/`).
+
+**Email SMTP Setup:**
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| Host | `smtp.gmail.com` | SMTP server address |
+| Port | `587` | SMTP port (STARTTLS) |
+| User | — | Your email address |
+| To | — | Alert recipient email |
+
+> **Note:** SMTP passwords must be set via the `KDM_SMTP_PASSWORD` environment variable.
+
+---
+
+### `kdm config set <key> <value>`
+
+Sets a specific configuration value.
+
+**Example:**
+
+```bash
+kdm config set alert_cooldown 300
+kdm config set email_port 465
+```
+
+**Supported Keys:**
+
+| Key | Type | Description |
+|-----|------|-------------|
+| `alert_cooldown` | number | Cooldown period between alerts (seconds) |
+| `email_port` | number | SMTP port |
+| `notification_service` | string | `discord`, `email`, or `none` |
+| `discord_webhook` | string | Discord webhook URL |
+| `email_host` | string | SMTP host |
+| `email_user` | string | SMTP username |
+| `email_to` | string | Alert recipient email |
+
+---
+
+### `kdm config list`
+
+Lists all current configuration values.
+
+**Example:**
+
+```bash
+kdm config list
+```
+
+**Expected Output:**
+
+```
+Current KDM Configuration:
+──────────────────────────────────────────────────
+ notification_service   : discord
+ discord_webhook        : https://discord.com/api/webhooks/...
+──────────────────────────────────────────────────
+
+ Note: SMTP passwords must be set via KDM_SMTP_PASSWORD env var.
+```
+
+---
+
+### `kdm config clear`
+
+Clears all configuration and resets to defaults.
+
+**Example:**
+
+```bash
+kdm config clear
+```
+
+**Expected Output:**
+
+```
+✓ Configuration cleared.
+```
+
+## Configuration File Location
+
+Configuration is stored in the default `conf` package location:
+
+- **macOS:** `~/Library/Application Support/kdm-cli`
+- **Linux:** `~/.config/kdm-cli`
+- **Windows:** `%APPDATA%\kdm-cli`
+
+## Common Errors
+
+- **Invalid webhook URL** — Must match `https://discord.com/api/webhooks/<id>/<token>`.
+- **Invalid email address** — Must be a valid email format.
+- **Invalid port number** — Must be between 1 and 65535.
diff --git a/.github/docs-template/config/setup.md b/.github/docs-template/config/setup.md
deleted file mode 100644
index 9141ea0..0000000
--- a/.github/docs-template/config/setup.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# Config Setup
-
-## 1. Command Overview
-
-## 2. Syntax
-
-## 3. Parameters & Options
-
-## 4. Example Usage
diff --git a/.github/docs-template/health/README.md b/.github/docs-template/health/README.md
new file mode 100644
index 0000000..4b26df3
--- /dev/null
+++ b/.github/docs-template/health/README.md
@@ -0,0 +1,154 @@
+# `kdm health` — Health Status
+
+> **Version:** `v1.2.1`
+
+---
+
+## Overview
+
+The `kdm health` command checks and reports the health status of Kubernetes pods or Docker containers. It provides a clean, color-coded table with real-time status fetched directly from Docker and Kubernetes clients.
+
+> **Fix (Issue #1):**  
+> This command previously returned only a placeholder message. It now displays real health data from Docker containers and Kubernetes pods.
+
+---
+
+# Syntax
+
+```bash
+kdm health <target>
+```
+
+---
+
+# Parameters
+
+| Parameter | Description | Valid Values |
+| :--- | :--- | :--- |
+| `target` | The workload type to check | `pods`, `containers`, `all` |
+
+---
+
+# Usage
+
+---
+
+## `kdm health pods`
+
+Checks the health status of all Kubernetes pods.
+
+### Example
+
+```bash
+kdm health pods
+```
+
+### Expected Output
+
+```text
+╭──────┬─────────────────────────────┬─────────┬──────────────────────────────────────╮
+│ TYPE │ NAME                        │ HEALTH  │ DETAILS                              │
+├──────┼─────────────────────────────┼─────────┼──────────────────────────────────────┤
+│ pod  │ node-app-6f65c56b74-7tkvf   │ Running │ namespace: default, restarts: 0      │
+│ pod  │ nginx-deployment-abc123     │ Failed  │ namespace: production, restarts: 5   │
+╰──────┴─────────────────────────────┴─────────┴──────────────────────────────────────╯
+```
+
+### Health Indicators
+
+| Status Color | Meaning |
+| :--- | :--- |
+| 🟢 Green | `healthy`, `running`, `Running` |
+| 🔴 Red | `unhealthy`, `exited`, `Failed` |
+| 🟡 Yellow | Other states like `Pending`, `paused` |
+
+### Use Cases
+
+- Monitor pod health in real time
+- Identify failing services before outages occur
+
+---
+
+## `kdm health containers`
+
+Checks the health status of all Docker containers.
+
+### Example
+
+```bash
+kdm health containers
+```
+
+### Expected Output
+
+```text
+╭───────────┬────────────┬─────────┬───────────────╮
+│ TYPE      │ NAME       │ HEALTH  │ DETAILS       │
+├───────────┼────────────┼─────────┼───────────────┤
+│ container │ test-nginx │ running │ Up 8 minutes  │
+│ container │ my-app     │ exited  │ Exited (1)    │
+╰───────────┴────────────┴─────────┴───────────────╯
+```
+
+### Use Cases
+
+- Verify container health
+- Detect unhealthy or restarting containers
+
+---
+
+## `kdm health all`
+
+Checks health for both pods and containers in a single command. If one source (Docker or Kubernetes) is unavailable, the other still renders successfully.
+
+### Example
+
+```bash
+kdm health all
+```
+
+---
+
+### Expected Output (Kubernetes unavailable)
+
+```text
+⚠ Kubernetes unavailable: connect ECONNREFUSED 127.0.0.1:8080
+
+╭───────────┬────────────┬─────────┬──────────────╮
+│ TYPE      │ NAME       │ HEALTH  │ DETAILS      │
+├───────────┼────────────┼─────────┼──────────────┤
+│ container │ test-nginx │ running │ Up 8 minutes │
+╰───────────┴────────────┴─────────┴──────────────╯
+```
+
+---
+
+### Expected Output (Both available)
+
+```text
+╭───────────┬───────────────────────────┬─────────┬──────────────────────────────────────╮
+│ TYPE      │ NAME                      │ HEALTH  │ DETAILS                              │
+├───────────┼───────────────────────────┼─────────┼──────────────────────────────────────┤
+│ container │ test-nginx                │ running │ Up 8 minutes                         │
+│ pod       │ node-app-6f65c56b74-7tkvf │ Running │ namespace: default, restarts: 0      │
+╰───────────┴───────────────────────────┴─────────┴──────────────────────────────────────╯
+```
+
+---
+
+# Common Errors
+
+| Error | Cause | Fix |
+| :--- | :--- | :--- |
+| `Unknown target` | Invalid target passed | Use `pods`, `containers`, or `all` |
+| `No workloads found` | No containers or pods running | Start Docker containers or Kubernetes pods |
+| `Docker unavailable` | Docker daemon not running | Run `sudo systemctl start docker` |
+| `Kubernetes unavailable` | No cluster connection | Run `minikube start` or configure `kubectl` |
+
+---
+
+# Notes
+
+- Supports both Docker and Kubernetes environments
+- Displays partial results even if one backend fails
+- Provides readable CLI tables for faster debugging and monitoring
\ No newline at end of file
diff --git a/.github/docs-template/logs/README.md b/.github/docs-template/logs/README.md
new file mode 100644
index 0000000..42ace9a
--- /dev/null
+++ b/.github/docs-template/logs/README.md
@@ -0,0 +1,143 @@
+# `kdm logs` — Show Logs
+
+> **Version:** `v1.2.1`
+
+---
+
+## Overview
+
+The `kdm logs` command retrieves and displays logs from a specified Docker container or Kubernetes pod. Docker is tried first, and Kubernetes is used automatically as a fallback if no matching container is found.
+
+> **Fix (Issue #1):**  
+> This command previously returned only a placeholder message. It now fetches real logs from Docker containers with automatic fallback to Kubernetes pods.
+
+---
+
+# Syntax
+
+```bash
+kdm logs <name>
+```
+
+---
+
+# Parameters
+
+| Parameter | Description |
+| :--- | :--- |
+| `name` | Container ID prefix, Docker container name, or Kubernetes pod name |
+
+---
+
+# Usage
+
+---
+
+## `kdm logs <name>`
+
+Fetches and displays the last 100 lines of logs for the specified workload.
+
+---
+
+### Example (Docker Container)
+
+```bash
+kdm logs test-nginx
+```
+
+### Expected Output
+
+```text
+✔ Fetching logs for test-nginx... (0.0s)
+
+/docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
+/docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
+2026/05/17 06:43:38 [notice] 1#1: nginx/1.31.0
+2026/05/17 06:43:38 [notice] 1#1: start worker processes
+```
+
+---
+
+### Example (Kubernetes Pod)
+
+```bash
+kdm logs node-app-6f65c56b74-7tkvf
+```
+
+### Expected Output
+
+```text
+✔ Fetching logs for node-app-6f65c56b74-7tkvf... (0.0s)
+
+Server listening on port 3000
+Connected to database
+GET /api/health 200 12ms
+```
+
+---
+
+### Example (Container ID Prefix)
+
+```bash
+kdm logs a1b2c3d4
+```
+
+---
+
+# How It Works
+
+```text
+Docker containers ──► match found? ──► show logs
+        │
+        ▼ no match
+Kubernetes pods ──► match found? ──► show logs
+        │
+        ▼ no match
+"No container or pod named X found"
+```
+
+### Workflow
+
+1. **Docker First**
+   - Searches running and stopped containers by ID prefix or container name
+
+2. **Kubernetes Fallback**
+   - If no Docker match is found, searches all Kubernetes pods across namespaces
+
+3. **Error Handling**
+   - Displays an error if neither Docker nor Kubernetes has a matching workload
+
+---
+
+# Finding the Right Name
+
+```bash
+# List Docker containers
+docker ps
+
+# List Kubernetes pods
+kubectl get pods --all-namespaces
+
+# Or use KDM itself
+kdm show containers
+kdm show pods
+```
+
+---
+
+# Common Errors
+
+| Error | Cause | Fix |
+| :--- | :--- | :--- |
+| `No container or pod named X found` | Name does not match any workload | Use `kdm show containers` or `kdm show pods` |
+| `Docker unavailable` | Docker daemon is not running | Run `sudo systemctl start docker` |
+| `Failed to fetch logs` | Kubernetes API unreachable | Run `minikube start` or configure `kubectl` |
+
+---
+
+# Notes
+
+- Automatically falls back from Docker to Kubernetes
+- Supports container name and ID prefix matching
+- Displays real-time logs directly from workloads
+- Retrieves the last 100 log lines for faster debugging
\ No newline at end of file
diff --git a/.github/docs-template/runner/start.md b/.github/docs-template/runner/start.md
deleted file mode 100644
index 7b1c041..0000000
--- a/.github/docs-template/runner/start.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# Runner Start
-
-## 1. Command Overview
-
-## 2. Syntax
-
-## 3. Parameters & Options
-
-## 4. Example Usage
diff --git a/.github/docs-template/show/README.md b/.github/docs-template/show/README.md
new file mode 100644
index 0000000..b11e718
--- /dev/null
+++ b/.github/docs-template/show/README.md
@@ -0,0 +1,134 @@
+# `kdm show` — Show Running Workloads
+
+**Version:** v1.2.1
+
+## Overview
+
+The `kdm show` command displays information about running workloads — Docker containers, Kubernetes pods, combined runners, or Minikube status. It provides a unified view of your local development environment.
+
+## Syntax
+
+```bash
+kdm show <target>
+```
+
+## Parameters
+
+| Parameter | Description | Valid Values |
+|-----------|-------------|--------------|
+| `target` | The workload type to display | `runners`, `pods`, `containers`, `minikube` |
+
+## Sub-commands
+
+### `kdm show runners`
+
+Shows a combined view of all running Docker containers and Kubernetes pods in a single table.
+
+**Example:**
+
+```bash
+kdm show runners
+```
+
+**Expected Output:**
+
+```
+┌───────────┬──────────────┬──────────────────────┬─────────┬─────────────────┐
+│ TYPE      │ NAME / ID    │ NAMESPACE / IMAGE    │ STATUS  │ NODE / STATE    │
+├───────────┼──────────────┼──────────────────────┼─────────┼─────────────────┤
+│ Pod       │ nginx-abc12  │ default              │ Running │ minikube        │
+│ Container │ my-app       │ myregistry/app:v1    │ running │ host            │
+└───────────┴──────────────┴──────────────────────┴─────────┴─────────────────┘
+```
+
+**Use Cases:**
+
+- Get a quick overview of all services running locally.
+- Monitor both Docker and Kubernetes workloads simultaneously.
+
+**Common Errors:**
+
+- `Docker is unreachable` — Docker daemon is not running. Start Docker Desktop or `systemctl start docker`.
+- `Kubernetes is unreachable` — No kubeconfig found or cluster is down. Check `kubectl cluster-info`.
+
+---
+
+### `kdm show pods`
+
+Shows all Kubernetes pods in the current namespace.
+
+**Example:**
+
+```bash
+kdm show pods
+```
+
+**Expected Output:**
+
+```
+┌──────────────┬───────────┬─────────┬──────────┬──────────┐
+│ POD NAME     │ NAMESPACE │ STATUS  │ RESTARTS │ NODE     │
+├──────────────┼───────────┼─────────┼──────────┼──────────┤
+│ nginx-abc12  │ default   │ Running │ 0        │ minikube │
+│ redis-xyz34  │ default   │ Running │ 2        │ minikube │
+└──────────────┴───────────┴─────────┴──────────┴──────────┘
+```
+
+**Use Cases:**
+
+- Inspect pod status and restart counts.
+- Identify pods in non-Running states.
+
+---
+
+### `kdm show containers`
+
+Shows all running Docker containers.
+
+**Example:**
+
+```bash
+kdm show containers
+```
+
+**Expected Output:**
+
+```
+┌────────────┬────────────┬────────────────┬────────┬─────────┐
+│ CONTAINER  │ NAME       │ IMAGE          │ STATUS │ STATE   │
+│ ID         │            │                │        │         │
+├────────────┼────────────┼────────────────┼────────┼─────────┤
+│ a1b2c3d4e5 │ my-app     │ myregistry/app │ Up     │ running │
+└────────────┴────────────┴────────────────┴────────┴─────────┘
+```
+
+**Use Cases:**
+
+- List all active containers.
+- Verify container states at a glance.
+
+---
+
+### `kdm show minikube`
+
+Shows the status of Minikube profiles on the local machine.
+
+**Example:**
+
+```bash
+kdm show minikube
+```
+
+**Expected Output:**
+
+```
+┌─────────┬─────────┬─────────┬─────────────┬─────────┐
+│ NAME    │ HOST    │ KUBELET │ APISERVER   │ MESSAGE │
+├─────────┼─────────┼─────────┼─────────────┼─────────┤
+│ default │ Running │ Running │ Running     │         │
+└─────────┴─────────┴─────────┴─────────────┴─────────┘
+```
+
+**Common Errors:**
+
+- `Minikube is not installed on this system` — Install Minikube from https://minikube.sigs.k8s.io.
diff --git a/.github/docs-template/watch/README.md b/.github/docs-template/watch/README.md
new file mode 100644
index 0000000..66f6a99
--- /dev/null
+++ b/.github/docs-template/watch/README.md
@@ -0,0 +1,52 @@
+# `kdm watch` — Live Monitoring
+
+**Version:** v1.2.1
+
+## Overview
+
+The `kdm watch` command enters a live monitoring mode, continuously updating the terminal with real-time resource usage and status of running Docker containers and Kubernetes pods. Powered by Ink for an interactive terminal UI.
+
+## Syntax
+
+```bash
+kdm watch
+```
+
+## Parameters
+
+This command takes no arguments.
+
+## Usage
+
+### `kdm watch`
+
+Starts a real-time monitoring dashboard.
+
+**Example:**
+
+```bash
+kdm watch
+```
+
+**Expected Output:**
+
+The terminal will display an interactive, auto-refreshing table showing:
+
+- Container/pod names
+- Current resource usage (CPU, memory)
+- Health status
+- Restart counts
+
+The view updates automatically. Press `Ctrl+C` to exit.
+
+**Use Cases:**
+
+- Continuously monitor service health during development.
+- Watch for resource spikes or pod restarts in real time.
+- Debug intermittent failures by observing live status changes.
+
+## Common Errors
+
+- **No workloads found** — Ensure at least one Docker container or Kubernetes pod is running.
+- **Docker daemon not running** — Start Docker Desktop or `systemctl start docker`.
+- **Kubernetes context not configured** — Verify with `kubectl cluster-info`.

From b10ebbf8d3eda9e8b941c8e958cf2c8de4651c04 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 17:05:52 +0530
Subject: [PATCH 14/23] Update .github/workflows/changelog.yml

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 .github/workflows/changelog.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index cc1372f..48a51fd 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -9,6 +9,8 @@ on:
 
 jobs:
   generate-changelog:
+    permissions:
+      contents: write
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Code

From 7b46a83401d83a024cda697a78dc8d8d4ee01920 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 17:06:22 +0530
Subject: [PATCH 15/23] Update .github/workflows/changelog.yml

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 .github/workflows/changelog.yml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 48a51fd..c5f48a4 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -46,8 +46,11 @@ jobs:
           
           # 2. If a core template folder exists, copy its entire structural hierarchy over
           if [ -d "$TEMPLATE_DIR" ]; then
-            cp -r "$TEMPLATE_DIR"/* "$TARGET_DIR"/
-            
+            shopt -s dotglob nullglob
+            template_items=("$TEMPLATE_DIR"/*)
+            if [ ${`#template_items`[@]} -gt 0 ]; then
+              cp -r "${template_items[@]}" "$TARGET_DIR"/
+            fi
             # 3. Recursively inject the mandatory Version string into every markdown file copied
             find "$TARGET_DIR" -type f -name "*.md" -exec sh -c '
               for file; do

From c78e8e761641d3ecc3c88d09326c22ac41cb791e Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 17:06:46 +0530
Subject: [PATCH 16/23] Update .github/workflows/changelog.yml

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 .github/workflows/changelog.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index c5f48a4..6ee1ad4 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -54,9 +54,12 @@ jobs:
             # 3. Recursively inject the mandatory Version string into every markdown file copied
             find "$TARGET_DIR" -type f -name "*.md" -exec sh -c '
               for file; do
-                echo -e "\n---\n**Version:** '"$VERSION"'" >> "$file"
+                if ! grep -Fq "**Version:** '"$VERSION"'" "$file"; then
+                  printf "\n---\n**Version:** %s\n" "'"$VERSION"'" >> "$file"
+                fi
               done
             ' _ {} +
+            ' _ {} +
           else
             # Fallback structure if the template directory isn't initialized yet
             mkdir -p "$TARGET_DIR/config" "$TARGET_DIR/runner" "$TARGET_DIR/docker" "$TARGET_DIR/kubernetes" "$TARGET_DIR/monitoring"

From 4b3513b2cb3d777632736d53d5adb675653a8ed9 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 17:08:27 +0530
Subject: [PATCH 17/23] Update .github/workflows/changelog.yml

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 .github/workflows/changelog.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 6ee1ad4..0668df9 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -62,7 +62,7 @@ jobs:
             ' _ {} +
           else
             # Fallback structure if the template directory isn't initialized yet
-            mkdir -p "$TARGET_DIR/config" "$TARGET_DIR/runner" "$TARGET_DIR/docker" "$TARGET_DIR/kubernetes" "$TARGET_DIR/monitoring"
+            mkdir -p "$TARGET_DIR/config" "$TARGET_DIR/health" "$TARGET_DIR/logs" "$TARGET_DIR/show" "$TARGET_DIR/watch"
           fi
           
           # 4. Generate the dedicated version README.md using the Release Engine Changelog output

From 406d7b8c415518405862bae0c3d3d9c51db028d3 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 17:09:16 +0530
Subject: [PATCH 18/23] Update .github/workflows/changelog.yml

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 .github/workflows/changelog.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 0668df9..f5a0991 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -83,6 +83,10 @@ jobs:
           
           # Track and stage the entire documentation change block
           git add docs/
+          if git diff --cached --quiet; then
+            echo "No documentation changes to commit."
+            exit 0
+          fi
           
           git commit -m "docs: auto-scaffold documentation architecture for ${{ github.ref_name }} [skip ci]"
           git push origin HEAD:${{ github.event.repository.default_branch }}

From e32b6668bffb825a810ef083498b813706be88c8 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 17:14:38 +0530
Subject: [PATCH 19/23] Refactor changelog generation in workflow

---
 .github/workflows/changelog.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index f5a0991..3cb4568 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -69,9 +69,9 @@ jobs:
           VERSION_README="$TARGET_DIR/README.md"
           echo -e "# KDM CLI Documentation - ${VERSION}\n" > "$VERSION_README"
           echo -e "Published on: $(date +'%Y-%m-%d')\n" >> "$VERSION_README"
-          echo -e "## Release Changelog\n" >> "$VERSION_README"
+          printf '%s\n' "$CHANGELOG" >> "$VERSION_README"
           echo -e "${{ steps.github_release.outputs.changelog }}" >> "$VERSION_README"
-          echo -e "\n---\n**Version Information:** ${VERSION}" >> "$VERSION_README"
+          printf '\n---\n**Version Information:** %s\n' "$VERSION" >> "$VERSION_README"
 
       - name: Commit and Push Changes
         run: |

From f051a33e40f336a643a77d50694c1b691700677d Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 17:26:35 +0530
Subject: [PATCH 20/23] Refactor changelog workflow for clarity and alignment

---
 .github/workflows/changelog.yml | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 3cb4568..002ba21 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -7,11 +7,17 @@ on:
     tags:
       - 'v*.*.*'
 
-jobs:
+ jobs:
   generate-changelog:
+    runs-on: ubuntu-latest  # Ensure this is here and aligned
+
+    concurrency:
+      group: auto-changelog-${{ github.ref_name }}
+      cancel-in-progress: false
+
     permissions:
       contents: write
-    runs-on: ubuntu-latest
+
     steps:
       - name: Checkout Code
         uses: actions/checkout@v4
@@ -21,7 +27,7 @@ jobs:
 
       - name: Build Changelog/Release Notes
         id: github_release
-        uses: mikepenz/release-changelog-builder-action@v4
+        uses: mikepenz/release-changelog-builder-action@<full_commit_sha> # v4
         with:
           configuration: |
             {
@@ -59,7 +65,6 @@ jobs:
                 fi
               done
             ' _ {} +
-            ' _ {} +
           else
             # Fallback structure if the template directory isn't initialized yet
             mkdir -p "$TARGET_DIR/config" "$TARGET_DIR/health" "$TARGET_DIR/logs" "$TARGET_DIR/show" "$TARGET_DIR/watch"

From 658b071a4b0571580c97046ca1546d9e32e81cf2 Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 17:30:17 +0530
Subject: [PATCH 21/23] Update .github/workflows/changelog.yml

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 .github/workflows/changelog.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 002ba21..d451238 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -7,7 +7,7 @@ on:
     tags:
       - 'v*.*.*'
 
- jobs:
+jobs:
   generate-changelog:
     runs-on: ubuntu-latest  # Ensure this is here and aligned
 

From b590d7edb1b0d05cb1324460af613a9547acd4ed Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 17:37:21 +0530
Subject: [PATCH 22/23] Fix changelog action to use specific commit SHA

Updated changelog action to use specific commit SHA.
---
 .github/workflows/changelog.yml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index d451238..19f8959 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -27,7 +27,7 @@ jobs:
 
       - name: Build Changelog/Release Notes
         id: github_release
-        uses: mikepenz/release-changelog-builder-action@<full_commit_sha> # v4
+        uses: mikepenz/release-changelog-builder-action@32e3c96f29a6532607f638797455e9e98cfc703d # v4
         with:
           configuration: |
             {
@@ -42,6 +42,8 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Scaffold Versioned CLI Documentation System
+        env:
+          CHANGELOG: ${{ steps.github_release.outputs.changelog }}
         run: |
           VERSION="${{ github.ref_name }}"
           TARGET_DIR="docs/${VERSION}"
@@ -75,7 +77,6 @@ jobs:
           echo -e "# KDM CLI Documentation - ${VERSION}\n" > "$VERSION_README"
           echo -e "Published on: $(date +'%Y-%m-%d')\n" >> "$VERSION_README"
           printf '%s\n' "$CHANGELOG" >> "$VERSION_README"
-          echo -e "${{ steps.github_release.outputs.changelog }}" >> "$VERSION_README"
           printf '\n---\n**Version Information:** %s\n' "$VERSION" >> "$VERSION_README"
 
       - name: Commit and Push Changes

From 8f1260d84025df08a88d82d4061d8331bfd2fa1a Mon Sep 17 00:00:00 2001
From: Yuvraj Sarathe <yuvrajsarathe07@gmail.com>
Date: Sun, 17 May 2026 18:24:59 +0530
Subject: [PATCH 23/23] del

---
 docs/changelogs/v1.1.3.md | 3 ---
 docs/changelogs/v1.2.0.md | 3 ---
 docs/changelogs/v1.2.1.md | 3 ---
 3 files changed, 9 deletions(-)
 delete mode 100644 docs/changelogs/v1.1.3.md
 delete mode 100644 docs/changelogs/v1.2.0.md
 delete mode 100644 docs/changelogs/v1.2.1.md

diff --git a/docs/changelogs/v1.1.3.md b/docs/changelogs/v1.1.3.md
deleted file mode 100644
index 6fb4221..0000000
--- a/docs/changelogs/v1.1.3.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Release Notes for v1.1.3
-
-Historical release content can be viewed in the main repository deployment logs.
diff --git a/docs/changelogs/v1.2.0.md b/docs/changelogs/v1.2.0.md
deleted file mode 100644
index bda2805..0000000
--- a/docs/changelogs/v1.2.0.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Release Notes for v1.2.0
-
-Historical release content can be viewed in the main repository deployment logs.
diff --git a/docs/changelogs/v1.2.1.md b/docs/changelogs/v1.2.1.md
deleted file mode 100644
index 4bf5c54..0000000
--- a/docs/changelogs/v1.2.1.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Release Notes for v1.2.1
-
-Historical release content can be viewed in the main repository deployment logs.