feat: pos docker stack — containers grouped by compose stack (project)

New bin/pos-docker-stack: docker ps output grouped by Docker Compose project (stack). Each stack is a sorted section (name, status, ports); containers without a compose project land in a Standalone group at the end. Running only by default, -a|--all includes stopped/exited. Status colored on a terminal; summary line 'Stacks: N containers: N standalone: N'; exit 0 when empty. Data via docker ps --format with \x1f delimiters (project label com.docker.compose.project from compose v2); parsed with awk -F'\x1f' + IFS=$'\x1f' read — tab/pipe delimiters are IFS whitespace or appear in values (DEV.md:213). Dash padding via sed, not tr (multi-byte). Deps guard (docker) before --help; no stdin. Docs: POS.md docker row + detail, howto/docker.md table + section, bin/pos usage EXAMPLES, AGENT_Context Common Tasks row. Verified: stub suite 23/23, live daemon runs, dispatch, make gen && make check, make lint 0 FAIL / 0 WARN.
2026-08-15 13:01:03 -04:00
parent a09f9cfafa
commit 364c5c3687
7 changed files with 154 additions and 16 deletions
@@ -0,0 +1,101 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# POS: docker stack — Containers grouped by compose stack (project); standalone group; -a/--all includes stopped
+# POS_FLAGS: -a --all
+source "$(dirname "$0")/../lib/common.sh" 2>/dev/null || source "$(dirname "$0")/common.sh"
+
+usage() {
+    cat <<EOF
+Usage: pos docker stack [-a|--all]
+
+Show running containers grouped by their Docker Compose stack (project).
+Non-compose containers (no stack) are listed under a "Standalone" group
+at the end.
+
+Flags:
+  -a, --all    Include stopped/exited containers too (like docker ps -a)
+  -h, --help   Show this help
+
+Exit codes:
+  0   Success (also when no containers are found)
+
+Examples:
+  pos docker stack          Grouped view of running containers
+  pos docker stack -a       Include stopped/exited containers
+EOF
+    exit 0
+}
+
+command -v docker &>/dev/null || err "docker not found — run 'install.sh --apps' and install Docker first"
+
+ALL=0
+case "${1:-}" in
+    -h|--help) usage ;;
+    -a|--all) ALL=1 ;;
+esac
+
+ps_args=()
+[ "$ALL" -eq 1 ] && ps_args+=(-a)
+ps_args+=(--format '{{.Names}}{{"\u001f"}}{{.Label "com.docker.compose.project"}}{{"\u001f"}}{{.Status}}{{"\u001f"}}{{.Ports}}')
+
+if ! data="$(docker ps "${ps_args[@]}" 2>/dev/null)"; then
+    err "docker daemon not reachable — is it running?"
+fi
+
+if [ -z "$data" ]; then
+    echo "No containers."
+    exit 0
+fi
+
+# Compose projects (stack names), sorted; empty project label = standalone.
+projects="$(printf '%s\n' "$data" | awk -F'\x1f' 'NF>=2 && $2!="" {print $2}' | LC_ALL=C sort -u)"
+standalone_rows="$(printf '%s\n' "$data" | awk -F'\x1f' 'NF>=2 && $2==""')"
+
+# Column width for aligned output (global so all stacks line up).
+width=0
+while IFS=$'\x1f' read -r name _proj _status _ports; do
+    [ "${#name}" -gt "$width" ] && width="${#name}"
+done <<< "$data"
+
+show_rows() {
+    local rows="$1"
+    [ -z "$rows" ] && return 0
+    while IFS=$'\x1f' read -r name _proj status ports; do
+        [ -z "$name" ] && continue
+        case "$status" in
+            Up*)                 sdisp="${GREEN}${status}${RESET}" ;;
+            Exited*|Dead*|Created*) sdisp="${RED}${status}${RESET}" ;;
+            Paused*|Restarting*) sdisp="${YELLOW}${status}${RESET}" ;;
+            *)                   sdisp="$status" ;;
+        esac
+        printf "  %-*s  %b  %s\n" "$width" "$name" "$sdisp" "${ports:--}"
+    done <<< "$rows"
+}
+
+stack_header() {
+    local label="$1"
+    local pad=$((46 - ${#label}))
+    [ "$pad" -lt 1 ] && pad=1
+    printf -- "── %s%s%s %s\n" "$CYAN" "$label" "$RESET" "$(printf '%*s' "$pad" '' | sed 's/ /─/g')"
+}
+
+stacks=0
+while IFS= read -r proj; do
+    [ -z "$proj" ] && continue
+    stacks=$((stacks + 1))
+    rows="$(printf '%s\n' "$data" | awk -F'\x1f' -v p="$proj" '$2==p')"
+    stack_header "$proj"
+    show_rows "$rows"
+    echo
+done <<< "$projects"
+
+if [ -n "$standalone_rows" ]; then
+    stack_header "Standalone"
+    show_rows "$standalone_rows"
+    echo
+fi
+
+containers="$(printf '%s\n' "$data" | grep -c . || true)"
+standalone="$(printf '%s\n' "$standalone_rows" | grep -c . || true)"
+printf '%*s\n' 60 '' | sed 's/ /─/g'
+echo "Stacks: $stacks   containers: $containers   standalone: $standalone"