187 lines
7.7 KiB
Bash
Executable File
187 lines
7.7 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
#
|
|
# scripts/next_steps.sh contract (operator-first scaffold):
|
|
# 1. Default manifest is operator_setup_steps.json; default recipe is
|
|
# operator-setup. Steps are read from the manifest; no hardcoding.
|
|
# 2. --manifest contributor_setup_steps.json --recipe contributor-setup
|
|
# swaps to the contributor dev-env bootstrap without changing the
|
|
# runner logic.
|
|
# 3. Missing manifest prints [warn] and references the orchestrator README.
|
|
# 4. Flags (--headless, --yes, --skip-optional, --only) forward verbatim
|
|
# to whichever recipe is selected.
|
|
# 5. --run mode execs `just <recipe>` in the orchestrator cwd.
|
|
|
|
set -euo pipefail
|
|
|
|
here="$(cd "$(dirname "$0")" && pwd -P)"
|
|
root="$(cd "$here/.." && pwd -P)"
|
|
|
|
pass=0
|
|
fail=0
|
|
assert() {
|
|
local msg="$1"; shift
|
|
if "$@"; then
|
|
printf '[ok] %s\n' "$msg"; pass=$((pass + 1))
|
|
else
|
|
printf '[FAIL] %s\n' "$msg"; fail=$((fail + 1))
|
|
fi
|
|
}
|
|
|
|
tmp="$(mktemp -d)"
|
|
trap 'rm -rf "$tmp"' EXIT
|
|
|
|
# --- Sandbox ---------------------------------------------------------
|
|
export FORGE_GITEA_URL="http://127.0.0.1:1"
|
|
export FORGE_GITEA_ORG="x"
|
|
export FORGE_GITEA_USERNAME="sandbox"
|
|
export FORGE_ORCHESTRATOR_REPO_URL="http://127.0.0.1:1/x/forge-stack-orchestrator.git"
|
|
export FORGE_WORKSPACE_ROOT="$tmp/workspace"
|
|
unset FORGE_ORCHESTRATOR_BRANCH FSDGG_AUTH_STORE_PATH FSDGG_RUNTIME_DIR
|
|
|
|
mkdir -p "$tmp/workspace" "$tmp/fakebin"
|
|
mkdir -p "$tmp/welcome/scripts"
|
|
cp "$root/scripts/common.sh" "$tmp/welcome/scripts/"
|
|
cp "$root/scripts/next_steps.sh" "$tmp/welcome/scripts/"
|
|
touch "$tmp/welcome/Justfile"
|
|
|
|
cat >"$tmp/welcome/.env" <<EOF
|
|
FORGE_GITEA_URL=$FORGE_GITEA_URL
|
|
FORGE_GITEA_ORG=$FORGE_GITEA_ORG
|
|
FORGE_GITEA_USERNAME=$FORGE_GITEA_USERNAME
|
|
FORGE_ORCHESTRATOR_REPO_URL=$FORGE_ORCHESTRATOR_REPO_URL
|
|
FORGE_WORKSPACE_ROOT=$FORGE_WORKSPACE_ROOT
|
|
EOF
|
|
|
|
mkdir -p "$tmp/workspace/forge-stack-orchestrator/.git"
|
|
mkdir -p "$tmp/workspace/forge-stack-orchestrator/scripts"
|
|
|
|
# --- Shared manifest fixtures ---------------------------------------
|
|
# Fixture step ids / commands are deliberately generic. The runner is
|
|
# manifest-agnostic; the real manifests live in the (private) orchestrator.
|
|
cat >"$tmp/workspace/forge-stack-orchestrator/scripts/operator_setup_steps.json" <<'JSON'
|
|
{
|
|
"schema_version": 1,
|
|
"description": "Operator manifest under test.",
|
|
"steps": [
|
|
{"id": "op-step-a", "title": "Operator step A", "cmd": ["bash", "-c", "true"], "desc": "Operator A desc."},
|
|
{"id": "op-step-b", "title": "Operator step B", "cmd": ["bash", "-c", "true"], "desc": "Operator B desc."},
|
|
{"id": "op-step-c", "title": "Operator step C", "cmd": ["bash", "-c", "true"], "desc": "Operator C desc.", "optional": true}
|
|
]
|
|
}
|
|
JSON
|
|
|
|
cat >"$tmp/workspace/forge-stack-orchestrator/scripts/contributor_setup_steps.json" <<'JSON'
|
|
{
|
|
"schema_version": 1,
|
|
"steps": [
|
|
{"id": "cstep-a", "title": "Contributor A", "cmd": ["bash", "-c", "true"], "desc": "Contributor A."},
|
|
{"id": "cstep-b", "title": "Contributor B", "cmd": ["bash", "-c", "true"], "desc": "Contributor B."}
|
|
]
|
|
}
|
|
JSON
|
|
|
|
# --- Case 1: default (no args) renders the OPERATOR plan ------------
|
|
set +e
|
|
bash -c "cd '$tmp/welcome' && bash scripts/next_steps.sh" \
|
|
>"$tmp/default.out" 2>"$tmp/default.err"
|
|
rc=$?
|
|
set -e
|
|
assert 'default: exits 0 when operator manifest present' bash -c "[ $rc -eq 0 ]"
|
|
assert 'default: operator_setup_steps.json is the source' \
|
|
grep -qF 'operator_setup_steps.json' "$tmp/default.err"
|
|
assert 'default: emits id: op-step-a from operator manifest' \
|
|
grep -qF 'id: op-step-a' "$tmp/default.err"
|
|
assert 'default: emits id: op-step-b from operator manifest' \
|
|
grep -qF 'id: op-step-b' "$tmp/default.err"
|
|
assert 'default: optional flag shown on third step' \
|
|
grep -qE '\(3/3\) Operator step C' "$tmp/default.err"
|
|
assert 'default: does NOT leak contributor ids into the operator plan' \
|
|
bash -c "! grep -qF 'id: cstep-a' '$tmp/default.err'"
|
|
assert 'default: "Execute via" pointer uses operator-setup recipe' \
|
|
grep -qE 'just run-next-steps --manifest operator_setup_steps.json --recipe operator-setup' "$tmp/default.err"
|
|
|
|
# --- Case 2: explicit contributor manifest works unchanged ----------
|
|
set +e
|
|
bash -c "cd '$tmp/welcome' && bash scripts/next_steps.sh --manifest contributor_setup_steps.json --recipe contributor-setup" \
|
|
>"$tmp/contrib.out" 2>"$tmp/contrib.err"
|
|
rc=$?
|
|
set -e
|
|
assert 'contrib override: exits 0' bash -c "[ $rc -eq 0 ]"
|
|
assert 'contrib override: manifest path mentions contributor_setup_steps.json' \
|
|
grep -qF 'contributor_setup_steps.json' "$tmp/contrib.err"
|
|
assert 'contrib override: emits contributor step ids' \
|
|
grep -qF 'id: cstep-a' "$tmp/contrib.err"
|
|
assert 'contrib override: operator ids do NOT appear' \
|
|
bash -c "! grep -qF 'id: op-step-a' '$tmp/contrib.err'"
|
|
|
|
# --- Case 3: missing operator manifest warns ------------------------
|
|
mv "$tmp/workspace/forge-stack-orchestrator/scripts/operator_setup_steps.json" \
|
|
"$tmp/workspace/forge-stack-orchestrator/scripts/operator_setup_steps.json.bak"
|
|
set +e
|
|
bash -c "cd '$tmp/welcome' && bash scripts/next_steps.sh" \
|
|
>"$tmp/missing.out" 2>"$tmp/missing.err"
|
|
rc=$?
|
|
set -e
|
|
mv "$tmp/workspace/forge-stack-orchestrator/scripts/operator_setup_steps.json.bak" \
|
|
"$tmp/workspace/forge-stack-orchestrator/scripts/operator_setup_steps.json"
|
|
assert 'missing operator manifest: exits non-zero' bash -c "[ $rc -ne 0 ]"
|
|
assert 'missing operator manifest: warns via [warn]' \
|
|
grep -qE '\[warn\]' "$tmp/missing.err"
|
|
assert 'missing operator manifest: points at the orchestrator README' \
|
|
grep -qF 'README.md' "$tmp/missing.err"
|
|
|
|
# --- Case 4: --run delegates to `just operator-setup` ---------------
|
|
cat >"$tmp/fakebin/just" <<EOF
|
|
#!/usr/bin/env bash
|
|
printf '%s\0' "\$@" > "$tmp/just.argv.nul"
|
|
pwd > "$tmp/just.cwd"
|
|
exit 0
|
|
EOF
|
|
chmod +x "$tmp/fakebin/just"
|
|
|
|
set +e
|
|
PATH="$tmp/fakebin:$PATH" bash -c "cd '$tmp/welcome' && bash scripts/next_steps.sh --run --headless --skip-optional --only op-step-a" \
|
|
>"$tmp/run.out" 2>"$tmp/run.err"
|
|
rc=$?
|
|
set -e
|
|
assert '--run: exits 0 on success' bash -c "[ $rc -eq 0 ]"
|
|
assert '--run: invokes just' test -f "$tmp/just.argv.nul"
|
|
assert '--run: cwd is the orchestrator checkout' \
|
|
bash -c "[ \"\$(cat '$tmp/just.cwd')\" = '$tmp/workspace/forge-stack-orchestrator' ]"
|
|
|
|
tr '\0' '\n' <"$tmp/just.argv.nul" >"$tmp/just.argv"
|
|
assert '--run: first arg is "operator-setup" (the default)' \
|
|
grep -qxF 'operator-setup' "$tmp/just.argv"
|
|
assert '--run: forwards --headless' \
|
|
grep -qxF -- '--headless' "$tmp/just.argv"
|
|
assert '--run: forwards --skip-optional' \
|
|
grep -qxF -- '--skip-optional' "$tmp/just.argv"
|
|
assert '--run: forwards --only op-step-a' \
|
|
bash -c "grep -qxF -- '--only' '$tmp/just.argv' && grep -qxF -- 'op-step-a' '$tmp/just.argv'"
|
|
|
|
# --- Case 5: --run --recipe contributor-setup swaps the recipe ------
|
|
set +e
|
|
PATH="$tmp/fakebin:$PATH" bash -c "cd '$tmp/welcome' && bash scripts/next_steps.sh --run --manifest contributor_setup_steps.json --recipe contributor-setup --yes" \
|
|
>"$tmp/run-contrib.out" 2>"$tmp/run-contrib.err"
|
|
rc=$?
|
|
set -e
|
|
assert '--run --recipe contributor-setup: exits 0' bash -c "[ $rc -eq 0 ]"
|
|
tr '\0' '\n' <"$tmp/just.argv.nul" >"$tmp/just.argv.contrib"
|
|
assert '--run --recipe contributor-setup: first arg is contributor-setup' \
|
|
grep -qxF 'contributor-setup' "$tmp/just.argv.contrib"
|
|
assert '--run --recipe contributor-setup: forwards --yes' \
|
|
grep -qxF -- '--yes' "$tmp/just.argv.contrib"
|
|
|
|
# --- Case 6: next_steps.sh rejects unknown args ---------------------
|
|
set +e
|
|
bash -c "cd '$tmp/welcome' && bash scripts/next_steps.sh --bogus" \
|
|
>"$tmp/bogus.out" 2>"$tmp/bogus.err"
|
|
rc=$?
|
|
set -e
|
|
assert 'unknown arg: exits non-zero' bash -c "[ $rc -ne 0 ]"
|
|
assert 'unknown arg: prints an error' \
|
|
grep -qE '\[err\] +unexpected argument' "$tmp/bogus.err"
|
|
|
|
printf '\n%d pass / %d fail\n' "$pass" "$fail"
|
|
[ "$fail" -eq 0 ]
|