chore: update CLI documentation and Helm commands in package.json

- Modified the `docs:cli` command in `package.json` to reflect the new script location.
- Updated README to include a new section for global help and improved command usage descriptions for better clarity.

Author: roderik

README.md

@@ -4,7 +4,9 @@ Generate node identities, configure consensus, and emit a Besu genesis.
 
 ## CLI usage
 
-```
+### Global Help
+
+```text
 Usage: network-bootstrapper [options] [command]
 
 Utilities for configuring Besu-based networks.
@@ -18,8 +20,11 @@ Commands:
   compile-genesis [options]  Merge per-account allocation ConfigMaps into a Besu
                              genesis file.
   help [command]             display help for command
+```
 
+### generate
 
+```text
 Usage: network-bootstrapper generate [options]
 
 Generate node identities, configure consensus, and emit a Besu genesis.
@@ -46,5 +51,19 @@ Options:
   --contract-size-limit <number>         Contract size limit in bytes. (default: 2147483647)
   --accept-defaults                      Accept default values for all prompts when CLI flags are omitted. (default: disabled)
   -h, --help                             display help for command
+```
 
+### compile-genesis
+
+```text
+Usage: network-bootstrapper compile-genesis [options]
+
+Merge per-account allocation ConfigMaps into a Besu genesis file.
+
+Options:
+  --genesis-configmap-name <name>  Name of the ConfigMap containing the base
+                                   genesis JSON. (default: "besu-genesis")
+  --output-path <path>             Filesystem path for the compiled genesis
+                                   output. (default: "/data/atk-genesis.json")
+  -h, --help                       display help for command
 ```

package.json

@@ -27,7 +27,7 @@
     "helm": "helm upgrade --install network ./charts/network -n network --create-namespace --timeout 15m",
     "package:pack": "helm package charts/network --destination .",
     "package:push:harbor": "helm push ./network-*.tgz oci://ghcr.io/settlemint/network-bootstrapper",
-    "docs:cli": "cat README.tpl > README.md && printf '\\n```\\n' >> README.md && bun src/index.ts --help >> README.md && printf '\\n\\n' >> README.md && bun src/index.ts generate --help >> README.md && printf '\\n```\\n' >> README.md"
+    "docs:cli": "./scripts/docs-cli.sh"
   },
   "devDependencies": {
     "@biomejs/biome": "2.2.4",

scripts/docs-cli.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+README_TEMPLATE="${REPO_ROOT}/README.tpl"
+README_OUTPUT="${REPO_ROOT}/README.md"
+ENTRYPOINT="${REPO_ROOT}/src/index.ts"
+
+if [[ ! -f "${README_TEMPLATE}" ]]; then
+  echo "README template not found at ${README_TEMPLATE}" >&2
+  exit 1
+fi
+
+cp "${README_TEMPLATE}" "${README_OUTPUT}"
+
+append_section() {
+  local heading="$1"
+  shift
+  local command=("${@}")
+
+  {
+    printf '\n### %s\n\n' "${heading}"
+    printf '```text\n'
+    NO_COLOR=1 "${command[@]}"
+    printf '```\n'
+  } >> "${README_OUTPUT}"
+}
+
+# The template already ends with the CLI usage heading; start sections immediately.
+append_section "Global Help" bun "${ENTRYPOINT}" --help
+
+append_section "generate" bun "${ENTRYPOINT}" generate --help
+
+append_section "compile-genesis" bun "${ENTRYPOINT}" compile-genesis --help