Merge from hot-fix

Author: mgarcia01752

.github/workflows/docs.yml

@@ -39,6 +39,7 @@ jobs:
 
   deploy:
     needs: build
+    if: ${{ github.ref == 'refs/heads/main' }}
     runs-on: ubuntu-latest
     environment:
       name: github-pages

.github/workflows/publish-ghcr.yml

@@ -10,7 +10,29 @@ permissions:
   packages: write
 
 jobs:
+  tag-check:
+    runs-on: ubuntu-latest
+    outputs:
+      is_on_main: ${{ steps.maincheck.outputs.is_on_main }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Validate tag is on main
+        id: maincheck
+        shell: bash
+        run: |
+          git fetch --no-tags origin main
+          if git merge-base --is-ancestor "${GITHUB_SHA}" "origin/main"; then
+            echo "is_on_main=true" >> "${GITHUB_OUTPUT}"
+          else
+            echo "is_on_main=false" >> "${GITHUB_OUTPUT}"
+          fi
+
   build-and-push:
+    needs: tag-check
+    if: ${{ needs.tag-check.outputs.is_on_main == 'true' }}
     runs-on: ubuntu-latest
     steps:
       - name: Checkout

.github/workflows/publish-pypi.yml

@@ -13,7 +13,12 @@ jobs:
     runs-on: ubuntu-latest
     outputs:
       is_ga: ${{ steps.check.outputs.is_ga }}
+      is_on_main: ${{ steps.maincheck.outputs.is_on_main }}
     steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - name: Validate GA tag
         id: check
         shell: bash
@@ -23,10 +28,20 @@ jobs:
           else
             echo "is_ga=false" >> "${GITHUB_OUTPUT}"
           fi
+      - name: Validate tag is on main
+        id: maincheck
+        shell: bash
+        run: |
+          git fetch --no-tags origin main
+          if git merge-base --is-ancestor "${GITHUB_SHA}" "origin/main"; then
+            echo "is_on_main=true" >> "${GITHUB_OUTPUT}"
+          else
+            echo "is_on_main=false" >> "${GITHUB_OUTPUT}"
+          fi
 
   publish:
     needs: tag-check
-    if: ${{ needs.tag-check.outputs.is_ga == 'true' }}
+    if: ${{ needs.tag-check.outputs.is_ga == 'true' && needs.tag-check.outputs.is_on_main == 'true' }}
     runs-on: ubuntu-latest
     steps:
       - name: Checkout

.gitignore

@@ -31,6 +31,7 @@ backup/*
 issues/*
 deploy/docker/compose/.env
 AGENTS.md
+release-reports/
 
 # PyPNM Dev tools
 log-level-rewriter.py

README.md

@@ -71,7 +71,7 @@ PyPNM is a DOCSIS 3.x/4.0 Proactive Network Maintenance toolkit for engineers wh
 Fast install (helper script; latest release auto-detected):
 
 ```bash
-TAG="v1.0.1.0"
+TAG="v1.0.2.10"
 PORT=8080
 
 curl -fsSLo install-pypnm-docker-container.sh \

deploy/docker/config/system.json

@@ -55,7 +55,7 @@
         "json_transaction_db": ".data/db/json_transactions.json",
         "retries": 5,
         "retrival_method": {
-            "method": "sftp",
+            "method": "local",
             "methods": {
                 "local": {
                     "src_dir": "/srv/tftp",

deploy/docker/config/system.json.template

@@ -55,7 +55,7 @@
         "json_transaction_db": ".data/db/json_transactions.json",
         "retries": 5,
         "retrival_method": {
-            "method": "sftp",
+            "method": "local",
             "methods": {
                 "local": {
                     "src_dir": "/srv/tftp"
@@ -79,7 +79,7 @@
                     "host": "localhost",
                     "port": 22,
                     "user": "dev01",
-                    "password_enc": "ENC[v1]:gAAAAABpPZXk8AyJkM9qfr32--dMZmTfuZMbosStbqHcQ7ScuDlr-mWIs0yzmU5OJueulRmiRQLRKCS0btK7cHYT0uNgSKPp4Q==",
+                    "password_enc": "",
                     "private_key_path": "~/.ssh/id_rsa_pypnm",
                     "remote_dir": "/srv/tftp"
                 },

docs/docker/install.md

@@ -15,7 +15,7 @@ PyPNM ships with Docker assets so you can run the API quickly on a workstation,
 ## Fast path: PyPNM Docker container install
 
 ```bash
-TAG="v1.0.1.0"
+TAG="v1.0.2.10"
 PORT=8080
 
 curl -fsSLo install-pypnm-docker-container.sh \
@@ -47,7 +47,7 @@ curl -X GET http://127.0.0.1:${PORT}/pypnm/system/webService/reload -H 'accept:
 ## Deploy bundle flow (tarball)
 
 ```bash
-TAG="v1.0.1.0"
+TAG="v1.0.2.10"
 WORKING_DIR="PyPNM-${TAG}"
 
 mkdir -p "${WORKING_DIR}"

docs/kubernetes/commands.md

@@ -74,7 +74,7 @@ Deploy from GHCR using a remote manifest (no repo clone required):
 curl -fsSL https://raw.githubusercontent.com/PyPNMApps/PyPNM/main/tools/k8s/pypnm_k8s_remote_deploy.sh \
   -o /tmp/pypnm_k8s_remote_deploy.sh
 
-TAG="v1.0.1.0"
+TAG="v1.0.2.10"
 NAMESPACE="pypnm-cmts-a"
 
 bash /tmp/pypnm_k8s_remote_deploy.sh --create --tag "${TAG}" --namespace "${NAMESPACE}" --replicas 1

docs/kubernetes/kind-freelens.md

@@ -23,7 +23,7 @@ bash /tmp/pypnm_kind_vm_bootstrap.sh
 Pick a release tag, then deploy into a namespace (one namespace per CMTS). This script pulls manifests from GitHub, so no repo clone is required:
 
 ```bash
-TAG="v1.0.1.0"
+TAG="v1.0.2.10"
 NAMESPACE="pypnm-cmts-a"
 
 curl -fsSL https://raw.githubusercontent.com/PyPNMApps/PyPNM/main/tools/k8s/pypnm_k8s_remote_deploy.sh \
@@ -111,7 +111,7 @@ Tip: keep one FreeLens workspace per CMTS namespace so it is easy to keep sessio
 Deploy a PyPNM instance per CMTS by assigning a unique namespace and configuration per CMTS:
 
 ```bash
-TAG="v1.0.1.0"
+TAG="v1.0.2.10"
 
 for CMTS in cmts-a cmts-b cmts-c; do
   NAMESPACE="pypnm-${CMTS}"