lots of change - all to start my 3rd redo

worker-toolkit-potion-polyglot-git-archeology/scripts/guidance-target.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+# guidance-target.sh — print the holistic-rubric file the grader reads for a task.
+#
+# The grader reads the task's holistic rubric under the Grading Standard.
+# Detector skills call this resolver so they always assess the file the grader
+# will actually read, and so the resolution rule lives in one place.
+#
+# Resolution order (renames are forward-only, so every generation stays readable):
+#   tests/holistic-rubric.md                the current name; new tasks use it
+#   tests/grader-guidance-consolidated.md   tasks created before the rename
+#   tests/grader-guidance.md                legacy-generation tasks
+# When none exists yet, the current name is printed — that is the file a new
+# task's rubric will be written to.
+#
+# Usage:
+#   bash scripts/guidance-target.sh <slug-or-task-dir>
+#
+# Output (one line): the path to the rubric file.
+set -eu
+
+arg="${1:?usage: bash scripts/guidance-target.sh <slug-or-task-dir>}"
+dir="$arg"
+[ -d "$dir" ] || dir="harbor-tasks/$arg"
+tests="$dir/tests"
+[ -d "$tests" ] || { echo "ERROR: no tests/ directory at $dir" >&2; exit 1; }
+
+new="$tests/holistic-rubric.md"
+old="$tests/grader-guidance-consolidated.md"
+legacy="$tests/grader-guidance.md"
+
+if [ -f "$new" ] && [ -f "$old" ]; then
+    # Both names present: the grader's pick depends on the harness generation,
+    # so an assessment of either could be an assessment of the wrong file.
+    # Byte-identical copies are safe; anything else is a hard stop.
+    if ! cmp -s "$new" "$old"; then
+        echo "ERROR: $tests carries both holistic-rubric.md and grader-guidance-consolidated.md with different content — keep exactly one (tests/holistic-rubric.md is the current name)" >&2
+        exit 1
+    fi
+    echo "$new"
+elif [ -f "$new" ]; then
+    echo "$new"
+elif [ -f "$old" ]; then
+    echo "$old"
+elif [ -f "$legacy" ]; then
+    echo "$legacy"
+else
+    echo "$new"
+fi