chore(sync): backmerge main into develop after v2.9.2 + release fixes (#71)

* release:
  merge develop into main (#61)

* ci: add separate main-to-develop backmerge workflow for non-hotfix merges

* ci: handle fork develop branch names in backmerge sync guard

* docs: refresh release docs metadata, module paths, and Claude integration link

* docs(deploy): restore CLAUDE_CODE_WHITELIST.md at canonical path

* docs(reference): add API_REFERENCE.md compatibility shim

* docs(reference): mirror full api-reference content to API_REFERENCE.md

* governance: establish two-repo public promotion contract and automation

* governance: transition to single-repo public release model

* docs(reference): convert API_REFERENCE.md to compatibility stub

* docs(reference): remove API_REFERENCE.md and normalize canonical API links

* chore: sync develop into main (docs + release governance updates) (#53) (#54)

* ci: add separate main-to-develop backmerge workflow for non-hotfix merges

* ci: handle fork develop branch names in backmerge sync guard

* docs: refresh release docs metadata, module paths, and Claude integration link

* docs(deploy): restore CLAUDE_CODE_WHITELIST.md at canonical path

* docs(reference): add API_REFERENCE.md compatibility shim

* docs(reference): mirror full api-reference content to API_REFERENCE.md

* governance: establish two-repo public promotion contract and automation

* governance: transition to single-repo public release model

* docs(reference): convert API_REFERENCE.md to compatibility stub

* docs(reference): remove API_REFERENCE.md and normalize canonical API links

* docs(quickstart): prioritize project-local usage and separate contributor clone path

* docs: add agent onboarding snippets and align discovery contract

* feat(skills): ship official task-orchestrator skill package

* fix(release): include agent skill package in public subset allowlist

* chore(release): align docs/version for v2.9.1

* docs(changelog): add v2.9.2 marker required by (#65)

release docs gate

* docs(readme): align version marker for v2.9.2 docs gate (#66)

* fix(release): use portable python resolver in release scripts (#69)

* fix(release): auto-insert missing docs version markers during packaging (#70)

* fix(release): use portable python resolver in release scripts

* fix(release): auto-insert missing docs version markers during packaging

Author: T72

scripts/build-public-artifact.sh

@@ -4,5 +4,6 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/lib/python-resolver.sh"
 
-python3 "$SCRIPT_DIR/public_manifest_tool.py" build "$@"
+tm_python_run "$SCRIPT_DIR/public_manifest_tool.py" build "$@"

scripts/lib/python-resolver.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+
+# Resolve a Python 3-capable interpreter portably across Linux/macOS/WSL/Windows Git Bash.
+# Preference order: python3 -> python -> py -3
+
+tm_python_run() {
+  if command -v python3 >/dev/null 2>&1; then
+    python3 "$@"
+    return
+  fi
+  if command -v python >/dev/null 2>&1; then
+    python "$@"
+    return
+  fi
+  if command -v py >/dev/null 2>&1; then
+    py -3 "$@"
+    return
+  fi
+
+  echo "No Python interpreter found. Install Python 3 and ensure one of 'python3', 'python', or 'py' is on PATH." >&2
+  return 127
+}
+
+tm_python_label() {
+  if command -v python3 >/dev/null 2>&1; then
+    echo "python3"
+    return
+  fi
+  if command -v python >/dev/null 2>&1; then
+    echo "python"
+    return
+  fi
+  if command -v py >/dev/null 2>&1; then
+    echo "py -3"
+    return
+  fi
+  echo "<missing-python>"
+}
+