pumuki 6.3.7

package/scripts/phase5-external-handoff-verdict-evaluators-lib.ts

@@ -0,0 +1,67 @@
+import type {
+  Phase5ExternalHandoffSummary,
+  SummarizePhase5ExternalHandoffParams,
+} from './phase5-external-handoff-contract';
+
+const normalizeVerdict = (value?: string): string => (value ?? '').toUpperCase();
+
+export const collectPhase5ExternalHandoffVerdictBlockers = (
+  params: SummarizePhase5ExternalHandoffParams
+): string[] => {
+  const blockers: string[] = [];
+
+  if (normalizeVerdict(params.phase5StatusVerdict) !== 'READY') {
+    blockers.push(
+      `Phase 5 execution closure status verdict is ${params.phase5StatusVerdict ?? 'unknown'}`
+    );
+  }
+  if (normalizeVerdict(params.phase5BlockersVerdict) !== 'READY') {
+    blockers.push(
+      `Phase 5 blockers readiness verdict is ${params.phase5BlockersVerdict ?? 'unknown'}`
+    );
+  }
+  if (normalizeVerdict(params.consumerUnblockVerdict) !== 'READY_FOR_RETEST') {
+    blockers.push(
+      `Consumer startup unblock verdict is ${params.consumerUnblockVerdict ?? 'unknown'}`
+    );
+  }
+  if (params.requireMockAbReport && normalizeVerdict(params.mockAbVerdict) !== 'READY') {
+    blockers.push(`Mock consumer A/B verdict is ${params.mockAbVerdict ?? 'unknown'}`);
+  }
+
+  return blockers;
+};
+
+export const collectPhase5ExternalHandoffVerdictWarnings = (
+  params: SummarizePhase5ExternalHandoffParams
+): string[] => {
+  const warnings: string[] = [];
+
+  if (
+    !params.requireMockAbReport &&
+    params.hasMockAbReport &&
+    normalizeVerdict(params.mockAbVerdict) !== 'READY'
+  ) {
+    warnings.push(
+      `Mock consumer A/B verdict is ${params.mockAbVerdict ?? 'unknown'} (not required in current mode)`
+    );
+  }
+
+  if (params.hasRunReport && normalizeVerdict(params.runReportVerdict) !== 'READY') {
+    warnings.push(
+      `Phase 5 closure run report verdict is ${params.runReportVerdict ?? 'unknown'}`
+    );
+  }
+
+  return warnings;
+};
+
+export const resolvePhase5ExternalHandoffSummaryVerdict = (params: {
+  missingInputs: ReadonlyArray<string>;
+  blockers: ReadonlyArray<string>;
+}): Phase5ExternalHandoffSummary['verdict'] =>
+  params.missingInputs.length > 0
+    ? 'MISSING_INPUTS'
+    : params.blockers.length > 0
+      ? 'BLOCKED'
+      : 'READY';

package/scripts/prepare-adapter-external-ide-replay-closeout-auto.sh

@@ -0,0 +1,100 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+Usage:
+  bash scripts/prepare-adapter-external-ide-replay-closeout-auto.sh \
+    <out_file> \
+    <replay_executed_at_utc> \
+    <operator> \
+    <ide_client> \
+    <action_id_or_prompt> \
+    [trace_window_utc]
+
+Example:
+  bash scripts/prepare-adapter-external-ide-replay-closeout-auto.sh \
+    .audit-reports/adapter/adapter-external-ide-replay-closeout-2026-02-14.md \
+    2026-02-14T20:30:00Z \
+    SwiftEnProfundidad \
+    cursor \
+    replay-one-shot-001
+EOF
+}
+
+if [[ $# -lt 5 ]]; then
+  usage >&2
+  exit 1
+fi
+
+OUT_FILE="$1"
+REPLAY_EXECUTED_AT_UTC="$2"
+OPERATOR="$3"
+IDE_CLIENT="$4"
+ACTION_ID_OR_PROMPT="$5"
+TRACE_WINDOW_UTC="${6:-N/A}"
+
+SESSION_REPORT=".audit-reports/adapter/adapter-session-status.md"
+REAL_REPORT=".audit-reports/adapter/adapter-real-session-report.md"
+READINESS_REPORT=".audit-reports/adapter/adapter-readiness.md"
+
+TRACE_1="$(ls -1t .audit_tmp/cascade-hook-runtime-*.log 2>/dev/null | sed -n '1p' || true)"
+TRACE_2="$(ls -1t .audit_tmp/cascade-hook-runtime-*.log 2>/dev/null | sed -n '2p' || true)"
+
+[[ -z "${TRACE_1}" ]] && TRACE_1="N/A"
+[[ -z "${TRACE_2}" ]] && TRACE_2="N/A"
+
+if [[ "${TRACE_WINDOW_UTC}" == "N/A" && "${TRACE_1}" != "N/A" ]]; then
+  TRACE_WINDOW_UTC="${REPLAY_EXECUTED_AT_UTC} (around captured traces)"
+fi
+
+extract_pass_fail() {
+  local file="$1"
+  local pass_pattern="$2"
+  local fail_pattern="$3"
+  if [[ -f "${file}" ]] && rg -q "${pass_pattern}" "${file}"; then
+    echo "PASS"
+    return 0
+  fi
+  if [[ -f "${file}" ]] && rg -q "${fail_pattern}" "${file}"; then
+    echo "FAIL"
+    return 0
+  fi
+  echo "UNKNOWN"
+}
+
+ADAPTER_SESSION_STATUS="$(
+  extract_pass_fail \
+    "${SESSION_REPORT}" \
+    'verdict:[[:space:]]*PASS|session-assessment=PASS|validation_result:[[:space:]]*PASS' \
+    'verdict:[[:space:]]*FAIL|session-assessment=FAIL|validation_result:[[:space:]]*FAIL'
+)"
+
+ADAPTER_REAL_SESSION_REPORT="$(
+  extract_pass_fail \
+    "${REAL_REPORT}" \
+    'verdict:[[:space:]]*PASS|Validation result:[[:space:]]*PASS|validation_result:[[:space:]]*PASS' \
+    'verdict:[[:space:]]*FAIL|Validation result:[[:space:]]*FAIL|validation_result:[[:space:]]*FAIL'
+)"
+
+ADAPTER_READINESS="$(
+  if [[ -f "${READINESS_REPORT}" ]]; then
+    rg -o 'verdict:[[:space:]]*(READY|BLOCKED|PENDING)' "${READINESS_REPORT}" \
+      | head -n 1 \
+      | sed -E 's/^verdict:[[:space:]]*//' || true
+  fi
+)"
+[[ -z "${ADAPTER_READINESS}" ]] && ADAPTER_READINESS="UNKNOWN"
+
+bash scripts/fill-adapter-external-ide-replay-closeout.sh \
+  "${OUT_FILE}" \
+  "${REPLAY_EXECUTED_AT_UTC}" \
+  "${OPERATOR}" \
+  "${IDE_CLIENT}" \
+  "${ACTION_ID_OR_PROMPT}" \
+  "${TRACE_1}" \
+  "${TRACE_2}" \
+  "${TRACE_WINDOW_UTC}" \
+  "${ADAPTER_SESSION_STATUS}" \
+  "${ADAPTER_REAL_SESSION_REPORT}" \
+  "${ADAPTER_READINESS}"

package/scripts/prepare-phase5-escalation-submission.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+OUT_DIR="${1:-.audit-reports/phase5-latest}"
+
+echo "[phase5-escalation-prepare] out_dir=${OUT_DIR}"
+
+bash scripts/check-phase5-escalation-ready-to-submit.sh "${OUT_DIR}"
+bash scripts/build-phase5-support-portal-payload.sh "${OUT_DIR}"
+
+PAYLOAD_FILE="${OUT_DIR}/github-support-portal-payload.txt"
+
+echo
+echo "[phase5-escalation-prepare] READY PACKAGE"
+echo "[phase5-escalation-prepare] payload_file=${PAYLOAD_FILE}"
+echo "[phase5-escalation-prepare] next steps:"
+echo "1) Open GitHub Support portal"
+echo "2) Copy subject/body from ${PAYLOAD_FILE}"
+echo "3) Attach ${OUT_DIR}/consumer-startup-escalation-bundle-latest.tgz"
+echo "4) After submission run:"
+echo "   npm run validation:phase5-escalation:mark-submitted -- <ticket_id> <submitted_by> \"<follow_up_eta>\""

package/scripts/refresh-phase5-latest-escalation.sh

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+set -u
+
+REPO="${1:-SwiftEnProfundidad/pumuki-actions-healthcheck-temp}"
+LIMIT="${2:-8}"
+OUT_DIR="${3:-.audit-reports/phase5-latest}"
+MOCK_AB_REPORT="${4:-.audit-reports/phase5/mock-consumer-ab-report.md}"
+BUNDLE_PATH="${OUT_DIR}/consumer-startup-escalation-bundle-latest.tgz"
+
+echo "[phase5-latest-refresh] repo=${REPO} limit=${LIMIT} out_dir=${OUT_DIR}"
+
+if [[ -f "scripts/check-phase8-loop-guard.sh" ]]; then
+  if ! bash scripts/check-phase8-loop-guard.sh; then
+    echo "[phase5-latest-refresh] blocked by loop guard; skipping refresh"
+    echo "[phase5-latest-refresh] next_action=manual follow-up post/reply tracking in ticket 4077449"
+    echo "[phase5-latest-refresh] override_if_support_replied=PHASE8_LOOP_GUARD_OVERRIDE=1 npm run validation:phase5-latest:refresh -- ${REPO} ${LIMIT} ${OUT_DIR} ${MOCK_AB_REPORT}"
+    exit 1
+  fi
+else
+  echo "[phase5-latest-refresh] warning: loop guard checker not found (scripts/check-phase8-loop-guard.sh)"
+fi
+
+if ! gh workflow run health.yml --repo "${REPO}"; then
+  echo "[phase5-latest-refresh] ERROR: failed to trigger workflow_dispatch probe" >&2
+  exit 1
+fi
+
+echo "[phase5-latest-refresh] probe dispatched"
+
+npx --yes tsx@4.21.0 scripts/run-phase5-execution-closure.ts \
+  --repo "${REPO}" \
+  --limit "${LIMIT}" \
+  --out-dir "${OUT_DIR}" \
+  --skip-adapter \
+  --skip-workflow-lint
+CLOSURE_EXIT=$?
+
+RUN_URL_1="$(gh run list --repo "${REPO}" --limit 2 --json url --jq '.[0].url // ""')"
+RUN_URL_2="$(gh run list --repo "${REPO}" --limit 2 --json url --jq '.[1].url // ""')"
+
+HANDOFF_CMD=(
+  npx --yes tsx@4.21.0 scripts/build-phase5-external-handoff.ts
+  --repo "${REPO}"
+  --phase5-status-report "${OUT_DIR}/phase5-execution-closure-status.md"
+  --phase5-blockers-report "${OUT_DIR}/phase5-blockers-readiness.md"
+  --consumer-unblock-report "${OUT_DIR}/consumer-startup-unblock-status.md"
+  --mock-ab-report "${MOCK_AB_REPORT}"
+  --run-report "${OUT_DIR}/phase5-execution-closure-run-report.md"
+  --out "${OUT_DIR}/phase5-external-handoff.md"
+)
+
+if [[ -n "${RUN_URL_1}" ]]; then
+  HANDOFF_CMD+=(--artifact-url "${RUN_URL_1}")
+fi
+if [[ -n "${RUN_URL_2}" ]]; then
+  HANDOFF_CMD+=(--artifact-url "${RUN_URL_2}")
+fi
+
+"${HANDOFF_CMD[@]}"
+HANDOFF_EXIT=$?
+
+tar -czf "${BUNDLE_PATH}" -C "$(pwd)" \
+  "${OUT_DIR}/consumer-ci-auth-check.md" \
+  "${OUT_DIR}/consumer-ci-artifacts-report.md" \
+  "${OUT_DIR}/consumer-startup-failure-support-bundle.md" \
+  "${OUT_DIR}/consumer-startup-unblock-status.md" \
+  "${OUT_DIR}/consumer-startup-triage-report.md" \
+  "${OUT_DIR}/consumer-support-ticket-draft.md" \
+  "${OUT_DIR}/phase5-blockers-readiness.md" \
+  "${OUT_DIR}/phase5-execution-closure-status.md" \
+  "${OUT_DIR}/phase5-execution-closure-run-report.md" \
+  "${OUT_DIR}/phase5-external-handoff.md" \
+  "docs/validation/consumer-startup-escalation-handoff-latest.md" \
+  "docs/validation/github-support-ticket-template-startup-failure.md"
+
+if ! CHECKSUM_LINE="$(shasum -a 256 "${BUNDLE_PATH}")"; then
+  echo "[phase5-latest-refresh] ERROR: failed to compute bundle checksum" >&2
+  exit 1
+fi
+
+echo "[phase5-latest-refresh] closure_exit=${CLOSURE_EXIT} handoff_exit=${HANDOFF_EXIT}"
+echo "[phase5-latest-refresh] run_url_1=${RUN_URL_1:-<missing>}"
+echo "[phase5-latest-refresh] run_url_2=${RUN_URL_2:-<missing>}"
+echo "[phase5-latest-refresh] bundle_checksum=${CHECKSUM_LINE}"
+
+if ! bash scripts/sync-phase5-latest-docs.sh "${OUT_DIR}"; then
+  echo "[phase5-latest-refresh] WARN: docs sync failed" >&2
+fi
+
+if [[ "${CLOSURE_EXIT}" -eq 0 && "${HANDOFF_EXIT}" -eq 0 ]]; then
+  exit 0
+fi
+
+exit 1

package/scripts/run-phase5-execution-closure.ts

@@ -0,0 +1,58 @@
+import {
+  buildPhase5ExecutionClosureCommands,
+  buildPhase5ExecutionClosureRunReportMarkdown,
+  resolvePhase5ExecutionClosureOutputs,
+} from './phase5-execution-closure-lib';
+import {
+  buildPhase5ExecutionClosureDryRunPlan,
+  executePhase5ExecutionClosureCommands,
+  parsePhase5ExecutionClosureArgs,
+} from './phase5-execution-closure-runner-lib';
+import {
+  toPhase5ExecutionClosureCommandOptions,
+  toPhase5ExecutionClosureRunReportOptions,
+} from './phase5-execution-closure-runner-mappers-lib';
+import { writePhase5ExecutionClosureRunReport } from './phase5-execution-closure-runner-report-writer-lib';
+
+const main = (): number => {
+  const options = parsePhase5ExecutionClosureArgs(process.argv.slice(2));
+
+  const commands = buildPhase5ExecutionClosureCommands(
+    toPhase5ExecutionClosureCommandOptions(options)
+  );
+
+  if (options.dryRun) {
+    process.stdout.write(buildPhase5ExecutionClosureDryRunPlan(commands));
+    return 0;
+  }
+
+  const executions = executePhase5ExecutionClosureCommands(commands);
+
+  const outputs = resolvePhase5ExecutionClosureOutputs(options.outDir);
+  const report = buildPhase5ExecutionClosureRunReportMarkdown({
+    generatedAt: new Date().toISOString(),
+    repo: options.repo,
+    options: toPhase5ExecutionClosureRunReportOptions(options),
+    commands,
+    executions,
+  });
+
+  const reportPath = writePhase5ExecutionClosureRunReport({
+    outputPath: outputs.closureRunReport,
+    reportMarkdown: report,
+  });
+  process.stdout.write(`phase5 execution closure run report generated at ${reportPath}\n`);
+
+  const requiredFailures = executions.filter(
+    (entry) => entry.command.required && !entry.ok
+  );
+  return requiredFailures.length === 0 ? 0 : 1;
+};
+
+try {
+  process.exit(main());
+} catch (error) {
+  const message = error instanceof Error ? error.message : 'unknown error';
+  process.stderr.write(`phase5 execution closure run failed: ${message}\n`);
+  process.exit(1);
+}

package/scripts/run-phase5-post-support-refresh.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO="${1:-SwiftEnProfundidad/pumuki-actions-healthcheck-temp}"
+LIMIT="${2:-8}"
+OUT_DIR="${3:-.audit-reports/phase5-latest}"
+MOCK_AB_REPORT="${4:-.audit-reports/phase5/mock-consumer-ab-report.md}"
+
+echo "[phase5-post-support-refresh] repo=${REPO} limit=${LIMIT} out_dir=${OUT_DIR}"
+
+if [[ -f "scripts/check-phase8-loop-guard.sh" ]]; then
+  if ! bash scripts/check-phase8-loop-guard.sh; then
+    echo "[phase5-post-support-refresh] blocked by loop guard; skipping refresh"
+    echo "[phase5-post-support-refresh] next_action=post follow-up manually and/or wait support reply in ticket 4077449"
+    echo "[phase5-post-support-refresh] override_if_support_replied=PHASE8_LOOP_GUARD_OVERRIDE=1 npm run validation:phase5-post-support:refresh -- ${REPO} ${LIMIT} ${OUT_DIR} ${MOCK_AB_REPORT}"
+    exit 1
+  fi
+else
+  echo "[phase5-post-support-refresh] warning: loop guard checker not found (scripts/check-phase8-loop-guard.sh)"
+fi
+
+bash scripts/refresh-phase5-latest-escalation.sh "${REPO}" "${LIMIT}" "${OUT_DIR}" "${MOCK_AB_REPORT}"
+bash scripts/check-phase5-latest-ready-chain.sh "${OUT_DIR}"
+
+echo "[phase5-post-support-refresh] READY chain confirmed after refresh"

package/scripts/run-phase8-after-billing-reactivation.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO="${1:-SwiftEnProfundidad/pumuki-actions-healthcheck-temp}"
+LIMIT="${2:-8}"
+OUT_DIR="${3:-.audit-reports/phase5-latest}"
+MOCK_AB_REPORT="${4:-.audit-reports/phase5/mock-consumer-ab-report.md}"
+
+echo "[phase8-after-billing] repo=${REPO}"
+echo "[phase8-after-billing] limit=${LIMIT}"
+echo "[phase8-after-billing] out_dir=${OUT_DIR}"
+
+if [[ -f "scripts/check-phase8-loop-guard.sh" ]]; then
+  if ! bash scripts/check-phase8-loop-guard.sh; then
+    echo "[phase8-after-billing] blocked by loop guard; skipping refresh"
+    echo "[phase8-after-billing] next_action=post follow-up manually and/or wait support reply in ticket 4077449"
+    echo "[phase8-after-billing] override_if_support_replied=PHASE8_LOOP_GUARD_OVERRIDE=1 npm run validation:phase8:resume-after-billing -- ${REPO} ${LIMIT} ${OUT_DIR} ${MOCK_AB_REPORT}"
+    exit 1
+  fi
+else
+  echo "[phase8-after-billing] warning: loop guard checker not found (scripts/check-phase8-loop-guard.sh)"
+fi
+
+if ! npm run validation:phase5-post-support:refresh -- "${REPO}" "${LIMIT}" "${OUT_DIR}" "${MOCK_AB_REPORT}"; then
+  echo "[phase8-after-billing] chain is still not READY after refresh" >&2
+  echo "[phase8-after-billing] next step: inspect ${OUT_DIR}/consumer-startup-unblock-status.md and rerun once billing is active." >&2
+  exit 1
+fi
+
+echo "[phase8-after-billing] READY chain confirmed"
+echo "[phase8-after-billing] next step: close P8-4 and regenerate final external handoff bundle."

package/scripts/run-phase8-autopilot.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+OUT_DIR="${1:-.audit-reports/phase5-latest}"
+REPO="${2:-SwiftEnProfundidad/pumuki-actions-healthcheck-temp}"
+LIMIT="${3:-8}"
+MOCK_AB_REPORT="${4:-.audit-reports/phase5/mock-consumer-ab-report.md}"
+
+echo "[phase8-autopilot] out_dir=${OUT_DIR}"
+
+if [[ -f "scripts/check-phase8-loop-guard.sh" ]]; then
+  if ! bash scripts/check-phase8-loop-guard.sh; then
+    echo "[phase8-autopilot] blocked by loop guard; skipping autopilot cycle"
+    echo "[phase8-autopilot] next_action=manual follow-up post/reply tracking in ticket 4077449"
+    echo "[phase8-autopilot] override_if_support_replied=PHASE8_LOOP_GUARD_OVERRIDE=1 npm run validation:phase8:autopilot -- ${OUT_DIR} ${REPO} ${LIMIT} ${MOCK_AB_REPORT}"
+    exit 1
+  fi
+else
+  echo "[phase8-autopilot] warning: loop guard checker not found (scripts/check-phase8-loop-guard.sh)"
+fi
+
+if npm run validation:phase8:doctor -- "${OUT_DIR}" "${REPO}" "${LIMIT}" "${MOCK_AB_REPORT}" >/tmp/phase8-autopilot-doctor.log 2>&1; then
+  cat /tmp/phase8-autopilot-doctor.log
+  echo "[phase8-autopilot] status=READY"
+  echo "[phase8-autopilot] running close-ready packaging..."
+  npm run validation:phase8:close-ready -- "${OUT_DIR}"
+  exit 0
+fi
+
+cat /tmp/phase8-autopilot-doctor.log
+NEXT_COMMAND="$(rg -n '^\[phase8-doctor\] next_command=' /tmp/phase8-autopilot-doctor.log | head -n 1 | sed -E 's/^[0-9]+:\[phase8-doctor\] next_command=//')"
+KNOWN_CAUSE="$(rg -n 'known_external_cause:' /tmp/phase8-autopilot-doctor.log | head -n 1 | sed -E 's/^[0-9]+:\[phase8-doctor\] //')"
+
+[[ -z "${KNOWN_CAUSE}" ]] && KNOWN_CAUSE="known_external_cause: <unknown>"
+
+echo "[phase8-autopilot] status=BLOCKED"
+echo "[phase8-autopilot] ${KNOWN_CAUSE}"
+if [[ -n "${NEXT_COMMAND}" ]]; then
+  echo "[phase8-autopilot] next_command=${NEXT_COMMAND}"
+fi
+echo "[phase8-autopilot] action_required=reactivate billing (or clear external blocker), then rerun."
+exit 1

package/scripts/run-phase8-close-ready.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+OUT_DIR="${1:-.audit-reports/phase5-latest}"
+PACKAGE_PATH="${OUT_DIR}/phase8-ready-handoff-package.tgz"
+
+echo "[phase8-close-ready] out_dir=${OUT_DIR}"
+
+if ! npm run validation:phase8:ready-handoff -- "${OUT_DIR}"; then
+  echo "[phase8-close-ready] chain is not READY; close-ready package not generated" >&2
+  exit 1
+fi
+
+SUMMARY_PATH="${OUT_DIR}/phase8-ready-handoff-summary.md"
+BLOCKERS_PATH="${OUT_DIR}/phase5-blockers-readiness.md"
+STATUS_PATH="${OUT_DIR}/phase5-execution-closure-status.md"
+HANDOFF_PATH="${OUT_DIR}/phase5-external-handoff.md"
+UNBLOCK_PATH="${OUT_DIR}/consumer-startup-unblock-status.md"
+
+for required in "${SUMMARY_PATH}" "${BLOCKERS_PATH}" "${STATUS_PATH}" "${HANDOFF_PATH}" "${UNBLOCK_PATH}"; do
+  if [[ ! -f "${required}" ]]; then
+    echo "[phase8-close-ready] missing required file: ${required}" >&2
+    exit 1
+  fi
+done
+
+tar -czf "${PACKAGE_PATH}" -C "$(pwd)" \
+  "${SUMMARY_PATH}" \
+  "${BLOCKERS_PATH}" \
+  "${STATUS_PATH}" \
+  "${HANDOFF_PATH}" \
+  "${UNBLOCK_PATH}"
+
+CHECKSUM_LINE="$(shasum -a 256 "${PACKAGE_PATH}")"
+
+echo "[phase8-close-ready] package=${PACKAGE_PATH}"
+echo "[phase8-close-ready] checksum=${CHECKSUM_LINE}"
+echo "[phase8-close-ready] next step: attach package and run URLs in final external handoff update."

package/scripts/run-phase8-doctor.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+OUT_DIR="${1:-.audit-reports/phase5-latest}"
+REPO="${2:-SwiftEnProfundidad/pumuki-actions-healthcheck-temp}"
+LIMIT="${3:-8}"
+MOCK_AB_REPORT="${4:-.audit-reports/phase5/mock-consumer-ab-report.md}"
+
+BUNDLE_REPORT="${OUT_DIR}/consumer-startup-failure-support-bundle.md"
+HANDOFF_DOC="docs/validation/consumer-startup-escalation-handoff-latest.md"
+
+echo "[phase8-doctor] out_dir=${OUT_DIR}"
+
+if [[ -f "scripts/check-phase8-loop-guard.sh" ]]; then
+  if ! bash scripts/check-phase8-loop-guard.sh; then
+    echo "[phase8-doctor] status=BLOCKED"
+    echo "[phase8-doctor] blocked_by=loop_guard"
+    echo "[phase8-doctor] next_action=manual follow-up post/reply tracking in ticket 4077449"
+    exit 1
+  fi
+else
+  echo "[phase8-doctor] warning: loop guard checker not found (scripts/check-phase8-loop-guard.sh)"
+fi
+
+if [[ ! -f "${BUNDLE_REPORT}" ]]; then
+  echo "[phase8-doctor] missing report: ${BUNDLE_REPORT}" >&2
+  exit 1
+fi
+
+if [[ ! -f "${HANDOFF_DOC}" ]]; then
+  echo "[phase8-doctor] missing handoff doc: ${HANDOFF_DOC}" >&2
+  exit 1
+fi
+
+STARTUP_FAILURE_RUNS="$(rg -n "^- startup_failure_runs:" "${BUNDLE_REPORT}" | head -n 1 | sed -E 's/^[0-9]+:- startup_failure_runs:[[:space:]]*//')"
+STARTUP_STALLED_RUNS="$(rg -n "^- startup_stalled_runs:" "${BUNDLE_REPORT}" | head -n 1 | sed -E 's/^[0-9]+:- startup_stalled_runs:[[:space:]]*//')"
+OLDEST_QUEUED_AGE="$(rg -n "^- oldest_queued_run_age_minutes:" "${BUNDLE_REPORT}" | head -n 1 | sed -E 's/^[0-9]+:- oldest_queued_run_age_minutes:[[:space:]]*//')"
+LATEST_RUN_URL="$(rg -o 'https://github.com/[^[:space:]]+/actions/runs/[0-9]+' "${BUNDLE_REPORT}" | head -n 1 || true)"
+KNOWN_CAUSE="$(rg -n "known_external_cause:" "${HANDOFF_DOC}" | head -n 1 | sed -E 's/^[0-9]+:[[:space:]]*//')"
+
+[[ -z "${STARTUP_FAILURE_RUNS}" ]] && STARTUP_FAILURE_RUNS="<unknown>"
+[[ -z "${STARTUP_STALLED_RUNS}" ]] && STARTUP_STALLED_RUNS="<unknown>"
+[[ -z "${OLDEST_QUEUED_AGE}" ]] && OLDEST_QUEUED_AGE="<unknown>"
+[[ -z "${LATEST_RUN_URL}" ]] && LATEST_RUN_URL="<missing>"
+[[ -z "${KNOWN_CAUSE}" ]] && KNOWN_CAUSE="known_external_cause: <unknown>"
+
+echo "[phase8-doctor] startup_failure_runs=${STARTUP_FAILURE_RUNS}"
+echo "[phase8-doctor] startup_stalled_runs=${STARTUP_STALLED_RUNS}"
+echo "[phase8-doctor] oldest_queued_run_age_minutes=${OLDEST_QUEUED_AGE}"
+echo "[phase8-doctor] latest_run_url=${LATEST_RUN_URL}"
+echo "[phase8-doctor] ${KNOWN_CAUSE}"
+
+if npm run validation:phase5-latest:ready-check -- "${OUT_DIR}" >/tmp/phase8-doctor-ready.log 2>&1; then
+  echo "[phase8-doctor] chain_status=READY"
+  echo "[phase8-doctor] next_command=npm run validation:phase8:close-ready -- ${OUT_DIR}"
+  exit 0
+fi
+
+echo "[phase8-doctor] chain_status=BLOCKED"
+echo "[phase8-doctor] next_command=npm run validation:phase8:resume-after-billing -- ${REPO} ${LIMIT} ${OUT_DIR} ${MOCK_AB_REPORT}"
+exit 1

package/scripts/run-phase8-next-step.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+OUT_DIR="${1:-.audit-reports/phase5-latest}"
+REPO="${2:-SwiftEnProfundidad/pumuki-actions-healthcheck-temp}"
+LIMIT="${3:-8}"
+MOCK_AB_REPORT="${4:-.audit-reports/phase5/mock-consumer-ab-report.md}"
+HANDOFF_DOC="docs/validation/consumer-startup-escalation-handoff-latest.md"
+
+echo "[phase8-next-step] out_dir=${OUT_DIR}"
+
+if npm run validation:phase5-latest:ready-check -- "${OUT_DIR}" >/tmp/phase8-next-step-ready.log 2>&1; then
+  echo "[phase8-next-step] status=READY"
+  echo "[phase8-next-step] next_command=npm run validation:phase8:close-ready -- ${OUT_DIR}"
+  echo "[phase8-next-step] note=run close-ready to build final package and finish P8-4."
+  exit 0
+fi
+
+if [[ -f "scripts/check-phase8-loop-guard.sh" ]]; then
+  if ! bash scripts/check-phase8-loop-guard.sh; then
+    echo "[phase8-next-step] status=BLOCKED"
+    echo "[phase8-next-step] blocked_by=loop_guard"
+    echo "[phase8-next-step] next_action=manual follow-up post/reply tracking in ticket 4077449"
+    exit 1
+  fi
+else
+  echo "[phase8-next-step] warning: loop guard checker not found (scripts/check-phase8-loop-guard.sh)"
+fi
+
+KNOWN_CAUSE="$(rg -n "known_external_cause:" "${HANDOFF_DOC}" | head -n 1 | sed 's/^[0-9]*:[[:space:]]*//')"
+if [[ -z "${KNOWN_CAUSE}" ]]; then
+  KNOWN_CAUSE="known_external_cause: <missing>"
+fi
+
+echo "[phase8-next-step] status=BLOCKED"
+echo "[phase8-next-step] ${KNOWN_CAUSE}"
+echo "[phase8-next-step] next_command=npm run validation:phase8:resume-after-billing -- ${REPO} ${LIMIT} ${OUT_DIR} ${MOCK_AB_REPORT}"
+echo "[phase8-next-step] note=run resume-after-billing once billing is active, then rerun this status command."
+exit 1

package/scripts/run-phase8-status-pack.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+OUT_DIR="${1:-.audit-reports/phase5-latest}"
+REPO="${2:-SwiftEnProfundidad/pumuki-actions-healthcheck-temp}"
+LIMIT="${3:-8}"
+MOCK_AB_REPORT="${4:-.audit-reports/phase5/mock-consumer-ab-report.md}"
+
+echo "[phase8-status-pack] start"
+echo "[phase8-status-pack] out_dir=${OUT_DIR}"
+
+if [[ -f "scripts/check-phase8-loop-guard.sh" ]]; then
+  if ! bash scripts/check-phase8-loop-guard.sh; then
+    echo "[phase8-status-pack] blocked by loop guard; skipping status-pack cycle"
+    echo "[phase8-status-pack] next_action=manual follow-up post/reply tracking in ticket 4077449"
+    exit 1
+  fi
+else
+  echo "[phase8-status-pack] warning: loop guard checker not found (scripts/check-phase8-loop-guard.sh)"
+fi
+
+if ! npm run validation:progress-single-active; then
+  echo "[phase8-status-pack] progress guardrail failed" >&2
+  exit 1
+fi
+
+if npm run validation:phase8:doctor -- "${OUT_DIR}" "${REPO}" "${LIMIT}" "${MOCK_AB_REPORT}"; then
+  echo "[phase8-status-pack] chain_status=READY"
+  echo "[phase8-status-pack] next_command=npm run validation:phase8:close-ready -- ${OUT_DIR}"
+  exit 0
+fi
+
+echo "[phase8-status-pack] chain_status=BLOCKED"
+echo "[phase8-status-pack] next_command=npm run validation:phase8:resume-after-billing -- ${REPO} ${LIMIT} ${OUT_DIR} ${MOCK_AB_REPORT}"
+exit 1

package/scripts/run-phase8-tick.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO="${1:-SwiftEnProfundidad/pumuki-actions-healthcheck-temp}"
+LIMIT="${2:-8}"
+OUT_DIR="${3:-.audit-reports/phase5-latest}"
+MOCK_AB_REPORT="${4:-.audit-reports/phase5/mock-consumer-ab-report.md}"
+
+echo "[phase8-tick] repo=${REPO}"
+echo "[phase8-tick] limit=${LIMIT}"
+echo "[phase8-tick] out_dir=${OUT_DIR}"
+
+if [[ -f "scripts/check-phase8-loop-guard.sh" ]]; then
+  if ! bash scripts/check-phase8-loop-guard.sh; then
+    echo "[phase8-tick] blocked by loop guard; skipping refresh"
+    echo "[phase8-tick] override_if_support_replied=PHASE8_LOOP_GUARD_OVERRIDE=1 npm run validation:phase8:tick -- ${REPO} ${LIMIT} ${OUT_DIR} ${MOCK_AB_REPORT}"
+    exit 1
+  fi
+else
+  echo "[phase8-tick] warning: loop guard checker not found (scripts/check-phase8-loop-guard.sh)"
+fi
+
+if ! npm run validation:phase5-latest:refresh -- "${REPO}" "${LIMIT}" "${OUT_DIR}" "${MOCK_AB_REPORT}"; then
+  echo "[phase8-tick] refresh completed with BLOCKED chain (expected while external blocker persists)"
+fi
+
+if npm run validation:phase8:status-pack -- "${OUT_DIR}" "${REPO}" "${LIMIT}" "${MOCK_AB_REPORT}"; then
+  echo "[phase8-tick] READY chain confirmed"
+  echo "[phase8-tick] next_command=npm run validation:phase8:close-ready -- ${OUT_DIR}"
+  exit 0
+fi
+
+echo "[phase8-tick] chain still BLOCKED"
+echo "[phase8-tick] next_command=npm run validation:phase8:resume-after-billing -- ${REPO} ${LIMIT} ${OUT_DIR} ${MOCK_AB_REPORT}"
+exit 1