service-taxonomy-gen.sh

#!/usr/bin/env bash
# Generates service class assignments from filesystem ground truth.
# Order matters — each check eliminates by precedence.
# Run from monorepo root: bash docs/reference/service-taxonomy-gen.sh

set -euo pipefail

if ! compgen -G "bin-*/" > /dev/null 2>&1; then
  echo "ERROR: run from monorepo root (no bin-*/ directories found)" >&2
  exit 1
fi

echo "# Service Taxonomy"
echo "# Generated by docs/reference/service-taxonomy-gen.sh"
echo "# DO NOT EDIT MANUALLY — regenerate and commit when services change"
echo ""
echo "| Service | Class | Notes |"
echo "|---------|-------|-------|"

for svc_dir in bin-*/  voip-*/; do
  name=$(basename "$svc_dir")

  # Class D: Non-Go service (no go.mod at service root — currently only bin-dbscheme-manager)
  if [ ! -f "${svc_dir}go.mod" ]; then
    echo "| $name | D | Python/Alembic migrations |"
    continue
  fi

  # Class E: OpenAPI codegen (no cmd/, has openapi/)
  if [ ! -d "${svc_dir}cmd" ] && [ -d "${svc_dir}openapi" ]; then
    echo "| $name | E | OpenAPI codegen, no runtime |"
    continue
  fi

  # Class C: shared library (no cmd/, has pkg/)
  if [ ! -d "${svc_dir}cmd" ] && [ -d "${svc_dir}pkg" ]; then
    echo "| $name | C | Shared library, no cmd/ |"
    continue
  fi

  # Class B: API gateway (has cmd/, no listenhandler, uses oapi-codegen)
  if [ -d "${svc_dir}cmd" ] && [ ! -d "${svc_dir}pkg/listenhandler" ] && \
     grep -q "oapi-codegen" "${svc_dir}go.mod" 2>/dev/null; then
    echo "| $name | B | HTTP/REST gateway |"
    continue
  fi

  # Class A2: event-driven worker (has cmd/, no listenhandler, not B)
  if [ -d "${svc_dir}cmd" ] && [ ! -d "${svc_dir}pkg/listenhandler" ]; then
    echo "| $name | A2 | Event-driven worker, no inbound RPC |"
    continue
  fi

  # Class A+sub: voip-* proxies with listenhandler
  if [ -d "${svc_dir}pkg/listenhandler" ] && [[ "$name" == voip-* ]]; then
    echo "| $name | A+sub | Go RPC + embedded native daemon |"
    continue
  fi

  # Class A: standard Go RPC manager
  if [ -d "${svc_dir}pkg/listenhandler" ]; then
    echo "| $name | A | Standard Go RPC manager |"
    continue
  fi

  echo "| $name | UNKNOWN | Manual classification needed |"
done