dev-playbooks 1.0.0

package/skills/devbooks-delivery-workflow/scripts/change-codemod-scaffold.sh

@@ -0,0 +1,135 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'EOF' >&2
+usage: change-codemod-scaffold.sh <change-id> [--name <codemod-name>] [--project-root <dir>] [--change-root <dir>] [--force]
+
+Creates a runnable codemod script under:
+  <change-root>/<change-id>/scripts/codemod-<codemod-name>.sh
+
+Defaults (can be overridden by flags or env):
+  DEVBOOKS_PROJECT_ROOT: pwd
+  DEVBOOKS_CHANGE_ROOT:  changes
+EOF
+}
+
+if [[ $# -eq 0 ]]; then
+  usage
+  exit 2
+fi
+
+if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
+  usage
+  exit 0
+fi
+
+change_id="$1"
+shift
+
+project_root="${DEVBOOKS_PROJECT_ROOT:-$(pwd)}"
+change_root="${DEVBOOKS_CHANGE_ROOT:-changes}"
+name="lsc"
+force=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    --name)
+      name="${2:-}"
+      shift 2
+      ;;
+    --project-root)
+      project_root="${2:-}"
+      shift 2
+      ;;
+    --change-root)
+      change_root="${2:-}"
+      shift 2
+      ;;
+    --force)
+      force=true
+      shift
+      ;;
+    *)
+      usage
+      exit 2
+      ;;
+  esac
+done
+
+if [[ -z "$change_id" || "$change_id" == "-"* || "$change_id" =~ [[:space:]] ]]; then
+  echo "error: invalid change-id: '$change_id'" >&2
+  exit 2
+fi
+
+if [[ -z "$name" || "$name" =~ [[:space:]] || "$name" == *"/"* ]]; then
+  echo "error: invalid --name (no whitespace, no '/'): '$name'" >&2
+  exit 2
+fi
+
+project_root="${project_root%/}"
+change_root="${change_root%/}"
+
+if [[ "$change_root" = /* ]]; then
+  change_dir="${change_root}/${change_id}"
+else
+  change_dir="${project_root}/${change_root}/${change_id}"
+fi
+
+target_dir="${change_dir}/scripts"
+target_file="${target_dir}/codemod-${name}.sh"
+
+if [[ -f "$target_file" && "$force" != true ]]; then
+  echo "skip: ${target_file}"
+  exit 0
+fi
+
+mkdir -p "$target_dir"
+
+cat >"$target_file" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'USAGE' >&2
+usage: codemod-<name>.sh [--apply]
+
+Runs a large-scale mechanical change. Default is dry-run.
+
+Recommended flow:
+  1) Implement the mechanical transformation deterministically.
+  2) Run tests / static checks.
+  3) Capture evidence to <change-root>/<change-id>/evidence/ via change-evidence.sh.
+USAGE
+}
+
+apply=false
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -h|--help) usage; exit 0 ;;
+    --apply) apply=true; shift ;;
+    *) usage; exit 2 ;;
+  esac
+done
+
+repo_root="$(pwd)"
+
+if [[ "$apply" != true ]]; then
+  echo "dry-run: no changes applied"
+  echo "repo_root: ${repo_root}"
+  echo "next: edit this script to implement your codemod, then re-run with --apply"
+  exit 0
+fi
+
+echo "apply: TODO implement codemod steps"
+exit 2
+EOF
+
+chmod +x "$target_file"
+echo "wrote: ${target_file}"
+echo "ok: scaffolded codemod script for ${change_id} (${name})"
+

package/skills/devbooks-delivery-workflow/scripts/change-evidence.sh

@@ -0,0 +1,152 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'EOF' >&2
+usage: change-evidence.sh <change-id> [--project-root <dir>] [--change-root <dir>] [--label <name>] [--out <file>] -- <command> [args...]
+
+Runs a command and captures its combined stdout/stderr into:
+  <change-root>/<change-id>/evidence/
+
+Defaults (can be overridden by flags or env):
+  DEVBOOKS_PROJECT_ROOT: pwd
+  DEVBOOKS_CHANGE_ROOT:  changes
+EOF
+}
+
+if [[ $# -eq 0 ]]; then
+  usage
+  exit 2
+fi
+
+if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
+  usage
+  exit 0
+fi
+
+change_id="$1"
+shift
+
+project_root="${DEVBOOKS_PROJECT_ROOT:-$(pwd)}"
+change_root="${DEVBOOKS_CHANGE_ROOT:-changes}"
+label="evidence"
+out_path=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    --project-root)
+      project_root="${2:-}"
+      shift 2
+      ;;
+    --change-root)
+      change_root="${2:-}"
+      shift 2
+      ;;
+    --label)
+      label="${2:-}"
+      shift 2
+      ;;
+    --out)
+      out_path="${2:-}"
+      shift 2
+      ;;
+    --)
+      shift
+      break
+      ;;
+    *)
+      usage
+      exit 2
+      ;;
+  esac
+done
+
+if [[ -z "$change_id" || "$change_id" == "-"* || "$change_id" =~ [[:space:]] ]]; then
+  echo "error: invalid change-id: '$change_id'" >&2
+  exit 2
+fi
+
+if [[ -z "$label" || "$label" =~ [[:space:]] ]]; then
+  echo "error: invalid --label (no whitespace): '$label'" >&2
+  exit 2
+fi
+
+if [[ $# -lt 1 ]]; then
+  echo "error: missing command after '--'" >&2
+  usage
+  exit 2
+fi
+
+project_root="${project_root%/}"
+change_root="${change_root%/}"
+
+if [[ "$change_root" = /* ]]; then
+  change_dir="${change_root}/${change_id}"
+else
+  change_dir="${project_root}/${change_root}/${change_id}"
+fi
+
+evidence_dir="${change_dir}/evidence"
+mkdir -p "$evidence_dir"
+
+sanitize() {
+  printf '%s' "$1" | sed -E 's/[^A-Za-z0-9._-]+/-/g; s/^-+//; s/-+$//'
+}
+
+ts="$(date +%Y%m%d-%H%M%S)"
+safe_label="$(sanitize "$label")"
+if [[ -z "$safe_label" ]]; then
+  safe_label="evidence"
+fi
+
+if [[ -n "$out_path" ]]; then
+  if [[ "$out_path" = /* ]]; then
+    out_file="$out_path"
+  else
+    out_file="${evidence_dir}/${out_path}"
+  fi
+else
+  out_file="${evidence_dir}/${ts}-${safe_label}.log"
+fi
+
+mkdir -p "$(dirname "$out_file")"
+
+cmd_pretty="$(printf '%q ' "$@")"
+
+{
+  echo "# Evidence capture"
+  echo "# change-id: ${change_id}"
+  echo "# timestamp: $(date -Iseconds)"
+  echo "# project-root: ${project_root}"
+  echo "# cwd: ${project_root}"
+  echo "# command: ${cmd_pretty}"
+  echo
+} >"$out_file"
+
+echo "devbooks: capturing evidence -> ${out_file}"
+echo "devbooks: running: ${cmd_pretty}"
+
+set +e
+(
+  cd "$project_root"
+  "$@" 2>&1
+) | tee -a "$out_file"
+exit_code="${PIPESTATUS[0]}"
+set -e
+
+{
+  echo
+  echo "# exit_code: ${exit_code}"
+} >>"$out_file"
+
+if [[ "$exit_code" -ne 0 ]]; then
+  echo "fail: command exit_code=${exit_code} (evidence recorded)" >&2
+  exit "$exit_code"
+fi
+
+echo "ok: evidence recorded"
+