refactor(readiness-check): port check.sh → check.ts (native Node 26, fetch+JSON, no curl/jq/python3)
Easier to maintain in this TS repo: typed gate definitions, native fetch/JSON (drops the fragile jq/python3/grep branches), runs via `node check.ts` with no build/deps. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
engineer
@@ -2,7 +2,7 @@
|
|||||||
name: readiness-check
|
name: readiness-check
|
||||||
description: Verify OpenCode Mobile is PRODUCTION READY end-to-end. Triggers like "check production readiness", "are we ready to ship", "readiness check", "is opencode-mobile live", "is the app published". Runs a script that confirms both Google Play and F-Droid (self-hosted + mainline) are PUBLISHED and the app/site are healthy.
|
description: Verify OpenCode Mobile is PRODUCTION READY end-to-end. Triggers like "check production readiness", "are we ready to ship", "readiness check", "is opencode-mobile live", "is the app published". Runs a script that confirms both Google Play and F-Droid (self-hosted + mainline) are PUBLISHED and the app/site are healthy.
|
||||||
category: release
|
category: release
|
||||||
version: 1.0.0
|
version: 1.1.0
|
||||||
---
|
---
|
||||||
|
|
||||||
# OpenCode Mobile — Readiness Check
|
# OpenCode Mobile — Readiness Check
|
||||||
@@ -21,21 +21,23 @@ If, and only if, every REQUIRED gate passes, the verdict is `PRODUCTION READY`.
|
|||||||
|
|
||||||
## How to run
|
## How to run
|
||||||
|
|
||||||
From the repo root:
|
From the repo root (the check is a TypeScript file run directly by Node — no build, no deps):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
bash .agents/skills/readiness-check/check.sh
|
node .agents/skills/readiness-check/check.ts
|
||||||
```
|
```
|
||||||
|
|
||||||
Fast mode — skip the slow npm app-health gates, only check live published-status URLs:
|
Fast mode — skip the slow npm app-health gates, only check live published-status URLs:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
bash .agents/skills/readiness-check/check.sh --quick
|
node .agents/skills/readiness-check/check.ts --quick
|
||||||
```
|
```
|
||||||
|
|
||||||
The script needs only `curl` and `git`. It opportunistically uses `python3` or `jq`
|
Requires **Node ≥ 23.6** (this repo runs Node 26), which executes `.ts` files natively via
|
||||||
to parse the F-Droid index, and `gh` for the optional repo-discoverability gate.
|
type-stripping — no transpile or extra dependencies. HTTP checks use the built-in `fetch`
|
||||||
Missing optional tools degrade gracefully (gate reports `WARN` or `UNKNOWN`, never crashes).
|
and JSON parsing is native, so there is no `curl`/`jq`/`python3` dependency. `git` is used to
|
||||||
|
locate the repo root and `gh` for the optional repo-discoverability gate; both degrade
|
||||||
|
gracefully if missing (gate reports `WARN`/`UNKNOWN`, never crashes).
|
||||||
|
|
||||||
## What it checks
|
## What it checks
|
||||||
|
|
||||||
|
|||||||
@@ -1,316 +0,0 @@
|
|||||||
#!/usr/bin/env bash
|
|
||||||
# readiness-check — verify OpenCode Mobile is PRODUCTION READY.
|
|
||||||
# Verdict is PRODUCTION READY only if every REQUIRED gate passes:
|
|
||||||
# A app-health, B fdroid-selfhosted, C fdroid-mainline, D google-play, E web.
|
|
||||||
# Usage:
|
|
||||||
# bash check.sh full check
|
|
||||||
# bash check.sh --quick skip slow npm app-health gates
|
|
||||||
set -uo pipefail
|
|
||||||
|
|
||||||
APP_ID="cc.agentlabs.opencode"
|
|
||||||
SITE="https://dzianisv.github.io/opencode-mobile"
|
|
||||||
FDROID_INDEX="$SITE/fdroid/repo/index-v1.json"
|
|
||||||
RELEASES="https://github.com/dzianisv/opencode-mobile/releases/latest"
|
|
||||||
PLAY="https://play.google.com/store/apps/details?id=$APP_ID"
|
|
||||||
FDROID_MAINLINE="https://f-droid.org/packages/$APP_ID/"
|
|
||||||
|
|
||||||
CURL_OPTS=(--silent --show-error --location --max-time 20 --connect-timeout 8 --retry 1)
|
|
||||||
|
|
||||||
# Resolve repo root (script may be invoked from anywhere).
|
|
||||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
||||||
REPO_ROOT="$(git -C "$SCRIPT_DIR" rev-parse --show-toplevel 2>/dev/null || echo "$SCRIPT_DIR")"
|
|
||||||
|
|
||||||
QUICK=0
|
|
||||||
for arg in "$@"; do
|
|
||||||
case "$arg" in
|
|
||||||
--quick) QUICK=1 ;;
|
|
||||||
-h|--help) sed -n '2,11p' "$0"; exit 0 ;;
|
|
||||||
esac
|
|
||||||
done
|
|
||||||
|
|
||||||
# ---- color (only if tty) ----
|
|
||||||
if [ -t 1 ]; then
|
|
||||||
C_RST=$'\033[0m'; C_GRN=$'\033[32m'; C_RED=$'\033[31m'; C_YEL=$'\033[33m'; C_DIM=$'\033[2m'; C_BLD=$'\033[1m'
|
|
||||||
else
|
|
||||||
C_RST=""; C_GRN=""; C_RED=""; C_YEL=""; C_DIM=""; C_BLD=""
|
|
||||||
fi
|
|
||||||
|
|
||||||
# ---- result accumulation ----
|
|
||||||
# Each gate appends "ID|STATUS|detail" ; REQUIRED gates listed in REQUIRED[].
|
|
||||||
declare -a RESULTS=()
|
|
||||||
declare -a REQUIRED=(A_typecheck A_test B_selfhosted B_release C_mainline D_play E_landing E_guide E_privacy E_sitemap E_robots E_og E_fdroidqr E_apkqr)
|
|
||||||
|
|
||||||
record() { # id status detail
|
|
||||||
RESULTS+=("$1|$2|$3")
|
|
||||||
}
|
|
||||||
|
|
||||||
print_line() { # status gate detail
|
|
||||||
local s="$1" gate="$2" detail="$3" tag color
|
|
||||||
case "$s" in
|
|
||||||
PASS) tag="[PASS]"; color="$C_GRN" ;;
|
|
||||||
FAIL) tag="[FAIL]"; color="$C_RED" ;;
|
|
||||||
WARN) tag="[WARN]"; color="$C_YEL" ;;
|
|
||||||
UNKNOWN) tag="[UNKNOWN]"; color="$C_YEL" ;;
|
|
||||||
*) tag="[????]"; color="$C_RST" ;;
|
|
||||||
esac
|
|
||||||
printf " %s%-9s%s %-22s %s—%s %s\n" "$color" "$tag" "$C_RST" "$gate" "$C_DIM" "$C_RST" "$detail"
|
|
||||||
}
|
|
||||||
|
|
||||||
have() { command -v "$1" >/dev/null 2>&1; }
|
|
||||||
|
|
||||||
# HTTP status helper. Echoes the numeric code, or "000" on network failure.
|
|
||||||
http_code() {
|
|
||||||
curl "${CURL_OPTS[@]}" -o /dev/null -w "%{http_code}" "$1" 2>/dev/null || echo "000"
|
|
||||||
}
|
|
||||||
|
|
||||||
section() { printf "\n%s%s%s\n" "$C_BLD" "$1" "$C_RST"; }
|
|
||||||
|
|
||||||
echo "${C_BLD}OpenCode Mobile — Production Readiness Check${C_RST}"
|
|
||||||
echo "${C_DIM}app id: $APP_ID mode: $([ $QUICK -eq 1 ] && echo quick || echo full) $(date -u '+%Y-%m-%dT%H:%M:%SZ')${C_RST}"
|
|
||||||
|
|
||||||
# =====================================================================
|
|
||||||
# A. App health
|
|
||||||
# =====================================================================
|
|
||||||
section "A. App health (build + tests)"
|
|
||||||
if [ $QUICK -eq 1 ]; then
|
|
||||||
record A_typecheck WARN "skipped (--quick)"
|
|
||||||
record A_test WARN "skipped (--quick)"
|
|
||||||
print_line WARN "typecheck" "skipped (--quick)"
|
|
||||||
print_line WARN "test" "skipped (--quick)"
|
|
||||||
elif ! have npm; then
|
|
||||||
record A_typecheck UNKNOWN "npm not installed"
|
|
||||||
record A_test UNKNOWN "npm not installed"
|
|
||||||
print_line UNKNOWN "typecheck" "npm not installed"
|
|
||||||
print_line UNKNOWN "test" "npm not installed"
|
|
||||||
else
|
|
||||||
# typecheck
|
|
||||||
if npm --prefix "$REPO_ROOT" run typecheck >/tmp/rc_typecheck.log 2>&1; then
|
|
||||||
record A_typecheck PASS "npm run typecheck clean"
|
|
||||||
print_line PASS "typecheck" "npm run typecheck clean"
|
|
||||||
else
|
|
||||||
record A_typecheck FAIL "tsc errors (see /tmp/rc_typecheck.log)"
|
|
||||||
print_line FAIL "typecheck" "tsc errors (see /tmp/rc_typecheck.log)"
|
|
||||||
fi
|
|
||||||
# test
|
|
||||||
if npm --prefix "$REPO_ROOT" test >/tmp/rc_test.log 2>&1; then
|
|
||||||
record A_test PASS "npm test green"
|
|
||||||
print_line PASS "test" "npm test green"
|
|
||||||
else
|
|
||||||
record A_test FAIL "test failures (see /tmp/rc_test.log)"
|
|
||||||
print_line FAIL "test" "test failures (see /tmp/rc_test.log)"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
# =====================================================================
|
|
||||||
# B. F-Droid — self-hosted repo LIVE (REQUIRED)
|
|
||||||
# =====================================================================
|
|
||||||
section "B. F-Droid — self-hosted repo (REQUIRED)"
|
|
||||||
idx_body="$(curl "${CURL_OPTS[@]}" "$FDROID_INDEX" 2>/dev/null)"
|
|
||||||
idx_rc=$?
|
|
||||||
if [ $idx_rc -ne 0 ] || [ -z "$idx_body" ]; then
|
|
||||||
record B_selfhosted UNKNOWN "could not fetch index-v1.json (network?)"
|
|
||||||
print_line UNKNOWN "fdroid-selfhosted" "could not fetch index-v1.json (network?)"
|
|
||||||
else
|
|
||||||
version=""
|
|
||||||
if have python3; then
|
|
||||||
version="$(printf '%s' "$idx_body" | python3 -c '
|
|
||||||
import json,sys
|
|
||||||
try:
|
|
||||||
d=json.load(sys.stdin)
|
|
||||||
except Exception:
|
|
||||||
sys.exit(2)
|
|
||||||
pkg="'"$APP_ID"'"
|
|
||||||
pkgs=d.get("packages",{})
|
|
||||||
if pkg not in pkgs and pkg not in d.get("apps",{}) and not any(
|
|
||||||
(a.get("packageName")==pkg) for a in (d.get("apps",[]) if isinstance(d.get("apps"),list) else [])):
|
|
||||||
sys.exit(3)
|
|
||||||
vs=pkgs.get(pkg)
|
|
||||||
ver=""
|
|
||||||
if isinstance(vs,list) and vs:
|
|
||||||
ver=vs[0].get("versionName","")
|
|
||||||
print(ver)
|
|
||||||
' 2>/dev/null)"
|
|
||||||
py_rc=$?
|
|
||||||
elif have jq; then
|
|
||||||
if printf '%s' "$idx_body" | jq -e --arg p "$APP_ID" '.packages[$p] // empty' >/dev/null 2>&1; then
|
|
||||||
version="$(printf '%s' "$idx_body" | jq -r --arg p "$APP_ID" '.packages[$p][0].versionName // ""' 2>/dev/null)"
|
|
||||||
py_rc=0
|
|
||||||
else
|
|
||||||
py_rc=3
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
# no parser: substring fallback
|
|
||||||
if printf '%s' "$idx_body" | grep -q "$APP_ID"; then py_rc=0; version="?"; else py_rc=3; fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ "${py_rc:-1}" -eq 0 ]; then
|
|
||||||
record B_selfhosted PASS "serves $APP_ID${version:+ v$version}"
|
|
||||||
print_line PASS "fdroid-selfhosted" "serves $APP_ID${version:+ v$version}"
|
|
||||||
elif [ "${py_rc:-1}" -eq 2 ]; then
|
|
||||||
record B_selfhosted FAIL "index-v1.json did not parse as JSON"
|
|
||||||
print_line FAIL "fdroid-selfhosted" "index-v1.json did not parse as JSON"
|
|
||||||
else
|
|
||||||
record B_selfhosted FAIL "$APP_ID not present in self-hosted index"
|
|
||||||
print_line FAIL "fdroid-selfhosted" "$APP_ID not present in self-hosted index"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
# direct APK / releases
|
|
||||||
rel_code="$(http_code "$RELEASES")"
|
|
||||||
if [ "$rel_code" = "000" ]; then
|
|
||||||
record B_release UNKNOWN "releases/latest unreachable"
|
|
||||||
print_line UNKNOWN "fdroid-apk-release" "releases/latest unreachable"
|
|
||||||
elif [ "$rel_code" -ge 200 ] && [ "$rel_code" -lt 400 ]; then
|
|
||||||
record B_release PASS "releases/latest HTTP $rel_code"
|
|
||||||
print_line PASS "fdroid-apk-release" "releases/latest HTTP $rel_code"
|
|
||||||
else
|
|
||||||
record B_release FAIL "releases/latest HTTP $rel_code"
|
|
||||||
print_line FAIL "fdroid-apk-release" "releases/latest HTTP $rel_code"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# =====================================================================
|
|
||||||
# C. F-Droid — MAINLINE published (REQUIRED, headline)
|
|
||||||
# =====================================================================
|
|
||||||
section "C. F-Droid — MAINLINE on f-droid.org (REQUIRED · headline)"
|
|
||||||
play_mainline_code="$(http_code "$FDROID_MAINLINE")"
|
|
||||||
if [ "$play_mainline_code" = "000" ]; then
|
|
||||||
record C_mainline UNKNOWN "f-droid.org unreachable"
|
|
||||||
print_line UNKNOWN "fdroid-mainline" "f-droid.org unreachable"
|
|
||||||
elif [ "$play_mainline_code" = "200" ]; then
|
|
||||||
record C_mainline PASS "LIVE on f-droid.org (HTTP 200)"
|
|
||||||
print_line PASS "fdroid-mainline" "LIVE on f-droid.org (HTTP 200)"
|
|
||||||
elif [ "$play_mainline_code" = "404" ]; then
|
|
||||||
record C_mainline FAIL "not yet published on f-droid.org (HTTP 404 — MR not merged)"
|
|
||||||
print_line FAIL "fdroid-mainline" "not yet published on f-droid.org (HTTP 404 — MR not merged)"
|
|
||||||
else
|
|
||||||
record C_mainline FAIL "unexpected HTTP $play_mainline_code"
|
|
||||||
print_line FAIL "fdroid-mainline" "unexpected HTTP $play_mainline_code"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# =====================================================================
|
|
||||||
# D. Google Play — PUBLISHED (REQUIRED, headline)
|
|
||||||
# =====================================================================
|
|
||||||
section "D. Google Play — PUBLISHED (REQUIRED · headline)"
|
|
||||||
play_code="$(http_code "$PLAY")"
|
|
||||||
if [ "$play_code" = "000" ]; then
|
|
||||||
record D_play UNKNOWN "play.google.com unreachable"
|
|
||||||
print_line UNKNOWN "google-play" "play.google.com unreachable"
|
|
||||||
elif [ "$play_code" = "200" ]; then
|
|
||||||
record D_play PASS "PUBLISHED on Google Play (HTTP 200)"
|
|
||||||
print_line PASS "google-play" "PUBLISHED on Google Play (HTTP 200)"
|
|
||||||
elif [ "$play_code" = "404" ]; then
|
|
||||||
record D_play FAIL "not public — in review/draft (HTTP 404)"
|
|
||||||
print_line FAIL "google-play" "not public — in review/draft (HTTP 404)"
|
|
||||||
else
|
|
||||||
record D_play FAIL "unexpected HTTP $play_code"
|
|
||||||
print_line FAIL "google-play" "unexpected HTTP $play_code"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# =====================================================================
|
|
||||||
# E. Web presence (REQUIRED)
|
|
||||||
# =====================================================================
|
|
||||||
section "E. Web presence (REQUIRED)"
|
|
||||||
check_url() { # id label url
|
|
||||||
local id="$1" label="$2" url="$3" code
|
|
||||||
code="$(http_code "$url")"
|
|
||||||
if [ "$code" = "000" ]; then
|
|
||||||
record "$id" UNKNOWN "$label unreachable"
|
|
||||||
print_line UNKNOWN "$label" "unreachable ($url)"
|
|
||||||
elif [ "$code" = "200" ]; then
|
|
||||||
record "$id" PASS "$label HTTP 200"
|
|
||||||
print_line PASS "$label" "HTTP 200"
|
|
||||||
else
|
|
||||||
record "$id" FAIL "$label HTTP $code"
|
|
||||||
print_line FAIL "$label" "HTTP $code ($url)"
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
check_url E_landing "landing" "$SITE/"
|
|
||||||
check_url E_guide "guide" "$SITE/guide/"
|
|
||||||
check_url E_privacy "privacy" "$SITE/privacy/"
|
|
||||||
check_url E_sitemap "sitemap.xml" "$SITE/sitemap.xml"
|
|
||||||
check_url E_robots "robots.txt" "$SITE/robots.txt"
|
|
||||||
check_url E_og "og.png" "$SITE/og.png"
|
|
||||||
check_url E_fdroidqr "fdroid-qr.png" "$SITE/fdroid-qr.png"
|
|
||||||
check_url E_apkqr "apk-qr.png" "$SITE/apk-qr.png"
|
|
||||||
|
|
||||||
# =====================================================================
|
|
||||||
# F. Repo discoverability (nice-to-have, WARN only)
|
|
||||||
# =====================================================================
|
|
||||||
section "F. Repo discoverability (nice-to-have)"
|
|
||||||
if ! have gh; then
|
|
||||||
print_line WARN "gh-repo-meta" "gh not installed — skipped"
|
|
||||||
elif ! gh auth status >/dev/null 2>&1; then
|
|
||||||
print_line WARN "gh-repo-meta" "gh unauthenticated — skipped"
|
|
||||||
else
|
|
||||||
meta="$(gh repo view dzianisv/opencode-mobile --json repositoryTopics,homepageUrl 2>/dev/null)"
|
|
||||||
if [ -z "$meta" ]; then
|
|
||||||
print_line WARN "gh-repo-meta" "could not read repo metadata"
|
|
||||||
else
|
|
||||||
if have jq; then
|
|
||||||
topics="$(printf '%s' "$meta" | jq -r '[.repositoryTopics[]?.name] | join(",")' 2>/dev/null)"
|
|
||||||
home="$(printf '%s' "$meta" | jq -r '.homepageUrl // ""' 2>/dev/null)"
|
|
||||||
elif have python3; then
|
|
||||||
topics="$(printf '%s' "$meta" | python3 -c 'import json,sys;d=json.load(sys.stdin);print(",".join(t.get("name","") for t in d.get("repositoryTopics") or []))' 2>/dev/null)"
|
|
||||||
home="$(printf '%s' "$meta" | python3 -c 'import json,sys;d=json.load(sys.stdin);print(d.get("homepageUrl") or "")' 2>/dev/null)"
|
|
||||||
else
|
|
||||||
topics="(install jq/python3 to parse)"; home=""
|
|
||||||
fi
|
|
||||||
if [ -n "$topics" ] || [ -n "$home" ]; then
|
|
||||||
print_line PASS "gh-repo-meta" "topics=[${topics:-none}] homepage=${home:-none}"
|
|
||||||
else
|
|
||||||
print_line WARN "gh-repo-meta" "no topics/homepage set"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
# =====================================================================
|
|
||||||
# Summary / verdict
|
|
||||||
# =====================================================================
|
|
||||||
status_of() { # id -> echoes status, "MISSING" if not recorded
|
|
||||||
local id="$1" r
|
|
||||||
for r in "${RESULTS[@]}"; do
|
|
||||||
case "$r" in "$id|"*) printf '%s' "${r#*|}" | cut -d'|' -f1; return;; esac
|
|
||||||
done
|
|
||||||
echo "MISSING"
|
|
||||||
}
|
|
||||||
|
|
||||||
declare -a FAILING=()
|
|
||||||
declare -a SKIPPED=()
|
|
||||||
for id in "${REQUIRED[@]}"; do
|
|
||||||
st="$(status_of "$id")"
|
|
||||||
if [ "$st" = "PASS" ]; then
|
|
||||||
continue
|
|
||||||
fi
|
|
||||||
# In --quick mode the app-health gates are intentionally skipped (WARN);
|
|
||||||
# don't list them as "failing", but they still block a PRODUCTION READY verdict.
|
|
||||||
if [ $QUICK -eq 1 ] && [ "$st" = "WARN" ] && { [ "$id" = "A_typecheck" ] || [ "$id" = "A_test" ]; }; then
|
|
||||||
SKIPPED+=("$id")
|
|
||||||
continue
|
|
||||||
fi
|
|
||||||
FAILING+=("$id($st)")
|
|
||||||
done
|
|
||||||
|
|
||||||
section "Headline gates"
|
|
||||||
print_line "$(status_of D_play)" "GOOGLE PLAY" "$([ "$(status_of D_play)" = PASS ] && echo PUBLISHED || echo 'NOT published')"
|
|
||||||
print_line "$(status_of C_mainline)" "F-DROID MAINLINE" "$([ "$(status_of C_mainline)" = PASS ] && echo PUBLISHED || echo 'NOT published')"
|
|
||||||
|
|
||||||
echo
|
|
||||||
echo "=============================================================="
|
|
||||||
if [ ${#FAILING[@]} -eq 0 ] && [ ${#SKIPPED[@]} -eq 0 ]; then
|
|
||||||
echo "${C_GRN}${C_BLD} PRODUCTION READY ✅${C_RST}"
|
|
||||||
echo "${C_DIM} All required gates passed — both stores live, app + site healthy.${C_RST}"
|
|
||||||
echo "=============================================================="
|
|
||||||
exit 0
|
|
||||||
elif [ ${#FAILING[@]} -eq 0 ] && [ ${#SKIPPED[@]} -gt 0 ]; then
|
|
||||||
# All checked required gates passed, but --quick skipped app-health.
|
|
||||||
echo "${C_YEL}${C_BLD} LIVE GATES PASS — run full check to confirm PRODUCTION READY ⚠${C_RST}"
|
|
||||||
echo "${C_DIM} Skipped in --quick mode: ${SKIPPED[*]} (run without --quick).${C_RST}"
|
|
||||||
echo "=============================================================="
|
|
||||||
exit 1
|
|
||||||
else
|
|
||||||
echo "${C_RED}${C_BLD} NOT READY ❌${C_RST}"
|
|
||||||
echo " Failing required gates:"
|
|
||||||
for f in "${FAILING[@]}"; do echo " - $f"; done
|
|
||||||
echo "=============================================================="
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
213
.agents/skills/readiness-check/check.ts
Executable file
213
.agents/skills/readiness-check/check.ts
Executable file
@@ -0,0 +1,213 @@
|
|||||||
|
#!/usr/bin/env node
|
||||||
|
/**
|
||||||
|
* readiness-check — verify OpenCode Mobile is PRODUCTION READY.
|
||||||
|
*
|
||||||
|
* Verdict is PRODUCTION READY only if every REQUIRED gate passes:
|
||||||
|
* A app-health, B fdroid-selfhosted, C fdroid-mainline, D google-play, E web.
|
||||||
|
*
|
||||||
|
* Runs natively on Node >= 23.6 (TypeScript type-stripping) — no build, no deps.
|
||||||
|
* Usage:
|
||||||
|
* node check.ts full check
|
||||||
|
* node check.ts --quick skip slow npm app-health gates
|
||||||
|
*/
|
||||||
|
import { execFileSync, spawnSync } from "node:child_process";
|
||||||
|
import { fileURLToPath } from "node:url";
|
||||||
|
import { dirname, resolve } from "node:path";
|
||||||
|
|
||||||
|
const APP_ID = "cc.agentlabs.opencode";
|
||||||
|
const SITE = "https://dzianisv.github.io/opencode-mobile";
|
||||||
|
const FDROID_INDEX = `${SITE}/fdroid/repo/index-v1.json`;
|
||||||
|
const RELEASES = "https://github.com/dzianisv/opencode-mobile/releases/latest";
|
||||||
|
const PLAY = `https://play.google.com/store/apps/details?id=${APP_ID}`;
|
||||||
|
const FDROID_MAINLINE = `https://f-droid.org/packages/${APP_ID}/`;
|
||||||
|
const TIMEOUT_MS = 20_000;
|
||||||
|
|
||||||
|
type Status = "PASS" | "FAIL" | "WARN" | "UNKNOWN";
|
||||||
|
interface Result { id: string; label: string; status: Status; detail: string }
|
||||||
|
|
||||||
|
// Gates that must PASS for a PRODUCTION READY verdict.
|
||||||
|
const REQUIRED = new Set([
|
||||||
|
"A_typecheck", "A_test",
|
||||||
|
"B_selfhosted", "B_release",
|
||||||
|
"C_mainline", "D_play",
|
||||||
|
"E_landing", "E_guide", "E_privacy", "E_sitemap", "E_robots", "E_og", "E_fdroidqr", "E_apkqr",
|
||||||
|
]);
|
||||||
|
|
||||||
|
const QUICK = process.argv.includes("--quick");
|
||||||
|
if (process.argv.includes("-h") || process.argv.includes("--help")) {
|
||||||
|
console.log("node check.ts [--quick] (--quick skips npm app-health gates)");
|
||||||
|
process.exit(0);
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---- repo root (script may be invoked from anywhere) ----
|
||||||
|
const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
|
||||||
|
let REPO_ROOT = SCRIPT_DIR;
|
||||||
|
try {
|
||||||
|
REPO_ROOT = execFileSync("git", ["-C", SCRIPT_DIR, "rev-parse", "--show-toplevel"], { encoding: "utf8" }).trim();
|
||||||
|
} catch { REPO_ROOT = resolve(SCRIPT_DIR, "../../.."); }
|
||||||
|
|
||||||
|
// ---- output ----
|
||||||
|
const tty = process.stdout.isTTY;
|
||||||
|
const c = (code: string, s: string) => (tty ? `\x1b[${code}m${s}\x1b[0m` : s);
|
||||||
|
const COLOR: Record<Status, string> = { PASS: "32", FAIL: "31", WARN: "33", UNKNOWN: "33" };
|
||||||
|
const results: Result[] = [];
|
||||||
|
|
||||||
|
function record(id: string, label: string, status: Status, detail: string) {
|
||||||
|
results.push({ id, label, status, detail });
|
||||||
|
const tag = `[${status}]`.padEnd(9);
|
||||||
|
console.log(` ${c(COLOR[status], tag)} ${label.padEnd(22)} ${c("2", "—")} ${detail}`);
|
||||||
|
}
|
||||||
|
const section = (t: string) => console.log(`\n${c("1", t)}`);
|
||||||
|
|
||||||
|
/** GET a URL; return numeric HTTP status, or 0 on network failure/timeout. */
|
||||||
|
async function httpCode(url: string): Promise<number> {
|
||||||
|
const ctrl = new AbortController();
|
||||||
|
const timer = setTimeout(() => ctrl.abort(), TIMEOUT_MS);
|
||||||
|
try {
|
||||||
|
const res = await fetch(url, { redirect: "follow", signal: ctrl.signal, headers: { "user-agent": "readiness-check" } });
|
||||||
|
return res.status;
|
||||||
|
} catch { return 0; }
|
||||||
|
finally { clearTimeout(timer); }
|
||||||
|
}
|
||||||
|
|
||||||
|
async function checkUrl(id: string, label: string, url: string) {
|
||||||
|
const code = await httpCode(url);
|
||||||
|
if (code === 0) record(id, label, "UNKNOWN", `unreachable (${url})`);
|
||||||
|
else if (code === 200) record(id, label, "PASS", "HTTP 200");
|
||||||
|
else record(id, label, "FAIL", `HTTP ${code} (${url})`);
|
||||||
|
}
|
||||||
|
|
||||||
|
function has(cmd: string): boolean {
|
||||||
|
return spawnSync(process.platform === "win32" ? "where" : "command", process.platform === "win32" ? [cmd] : ["-v", cmd], { shell: true }).status === 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
console.log(c("1", "OpenCode Mobile — Production Readiness Check"));
|
||||||
|
console.log(c("2", `app id: ${APP_ID} mode: ${QUICK ? "quick" : "full"} ${new Date().toISOString()}`));
|
||||||
|
|
||||||
|
// ===================== A. App health =====================
|
||||||
|
section("A. App health (build + tests)");
|
||||||
|
if (QUICK) {
|
||||||
|
record("A_typecheck", "typecheck", "WARN", "skipped (--quick)");
|
||||||
|
record("A_test", "test", "WARN", "skipped (--quick)");
|
||||||
|
} else if (!has("npm")) {
|
||||||
|
record("A_typecheck", "typecheck", "UNKNOWN", "npm not installed");
|
||||||
|
record("A_test", "test", "UNKNOWN", "npm not installed");
|
||||||
|
} else {
|
||||||
|
const tc = spawnSync("npm", ["run", "typecheck"], { cwd: REPO_ROOT, encoding: "utf8" });
|
||||||
|
record("A_typecheck", "typecheck", tc.status === 0 ? "PASS" : "FAIL",
|
||||||
|
tc.status === 0 ? "npm run typecheck clean" : "tsc errors");
|
||||||
|
const t = spawnSync("npm", ["test"], { cwd: REPO_ROOT, encoding: "utf8" });
|
||||||
|
record("A_test", "test", t.status === 0 ? "PASS" : "FAIL",
|
||||||
|
t.status === 0 ? "npm test green" : "test failures");
|
||||||
|
}
|
||||||
|
|
||||||
|
// ===================== B. F-Droid self-hosted (REQUIRED) =====================
|
||||||
|
section("B. F-Droid — self-hosted repo (REQUIRED)");
|
||||||
|
try {
|
||||||
|
const ctrl = new AbortController();
|
||||||
|
const timer = setTimeout(() => ctrl.abort(), TIMEOUT_MS);
|
||||||
|
const res = await fetch(FDROID_INDEX, { signal: ctrl.signal }).finally(() => clearTimeout(timer));
|
||||||
|
if (!res.ok) {
|
||||||
|
record("B_selfhosted", "fdroid-selfhosted", "FAIL", `index-v1.json HTTP ${res.status}`);
|
||||||
|
} else {
|
||||||
|
const idx = await res.json() as { packages?: Record<string, Array<{ versionName?: string }>> };
|
||||||
|
const versions = idx.packages?.[APP_ID];
|
||||||
|
if (versions && versions.length) {
|
||||||
|
record("B_selfhosted", "fdroid-selfhosted", "PASS", `serves ${APP_ID} v${versions[0].versionName ?? "?"}`);
|
||||||
|
} else {
|
||||||
|
record("B_selfhosted", "fdroid-selfhosted", "FAIL", `${APP_ID} not present in self-hosted index`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
record("B_selfhosted", "fdroid-selfhosted", "UNKNOWN", `could not fetch/parse index-v1.json (${(e as Error).name})`);
|
||||||
|
}
|
||||||
|
{
|
||||||
|
const code = await httpCode(RELEASES);
|
||||||
|
if (code === 0) record("B_release", "fdroid-apk-release", "UNKNOWN", "releases/latest unreachable");
|
||||||
|
else if (code >= 200 && code < 400) record("B_release", "fdroid-apk-release", "PASS", `releases/latest HTTP ${code}`);
|
||||||
|
else record("B_release", "fdroid-apk-release", "FAIL", `releases/latest HTTP ${code}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
// ===================== C. F-Droid mainline (REQUIRED, headline) =====================
|
||||||
|
section("C. F-Droid — MAINLINE on f-droid.org (REQUIRED · headline)");
|
||||||
|
{
|
||||||
|
const code = await httpCode(FDROID_MAINLINE);
|
||||||
|
if (code === 0) record("C_mainline", "fdroid-mainline", "UNKNOWN", "f-droid.org unreachable");
|
||||||
|
else if (code === 200) record("C_mainline", "fdroid-mainline", "PASS", "LIVE on f-droid.org (HTTP 200)");
|
||||||
|
else if (code === 404) record("C_mainline", "fdroid-mainline", "FAIL", "not yet published (HTTP 404 — MR not merged)");
|
||||||
|
else record("C_mainline", "fdroid-mainline", "FAIL", `unexpected HTTP ${code}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
// ===================== D. Google Play (REQUIRED, headline) =====================
|
||||||
|
section("D. Google Play — PUBLISHED (REQUIRED · headline)");
|
||||||
|
{
|
||||||
|
const code = await httpCode(PLAY);
|
||||||
|
if (code === 0) record("D_play", "google-play", "UNKNOWN", "play.google.com unreachable");
|
||||||
|
else if (code === 200) record("D_play", "google-play", "PASS", "PUBLISHED on Google Play (HTTP 200)");
|
||||||
|
else if (code === 404) record("D_play", "google-play", "FAIL", "not public — in review/draft (HTTP 404)");
|
||||||
|
else record("D_play", "google-play", "FAIL", `unexpected HTTP ${code}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
// ===================== E. Web presence (REQUIRED) =====================
|
||||||
|
section("E. Web presence (REQUIRED)");
|
||||||
|
await checkUrl("E_landing", "landing", `${SITE}/`);
|
||||||
|
await checkUrl("E_guide", "guide", `${SITE}/guide/`);
|
||||||
|
await checkUrl("E_privacy", "privacy", `${SITE}/privacy/`);
|
||||||
|
await checkUrl("E_sitemap", "sitemap.xml", `${SITE}/sitemap.xml`);
|
||||||
|
await checkUrl("E_robots", "robots.txt", `${SITE}/robots.txt`);
|
||||||
|
await checkUrl("E_og", "og.png", `${SITE}/og.png`);
|
||||||
|
await checkUrl("E_fdroidqr", "fdroid-qr.png", `${SITE}/fdroid-qr.png`);
|
||||||
|
await checkUrl("E_apkqr", "apk-qr.png", `${SITE}/apk-qr.png`);
|
||||||
|
|
||||||
|
// ===================== F. Repo discoverability (WARN only) =====================
|
||||||
|
section("F. Repo discoverability (nice-to-have)");
|
||||||
|
if (!has("gh")) {
|
||||||
|
record("F_repo", "gh-repo-meta", "WARN", "gh not installed — skipped");
|
||||||
|
} else if (spawnSync("gh", ["auth", "status"], { encoding: "utf8" }).status !== 0) {
|
||||||
|
record("F_repo", "gh-repo-meta", "WARN", "gh unauthenticated — skipped");
|
||||||
|
} else {
|
||||||
|
const r = spawnSync("gh", ["repo", "view", "dzianisv/opencode-mobile", "--json", "repositoryTopics,homepageUrl"], { encoding: "utf8" });
|
||||||
|
try {
|
||||||
|
const m = JSON.parse(r.stdout) as { repositoryTopics?: Array<{ name: string }>; homepageUrl?: string };
|
||||||
|
const topics = (m.repositoryTopics ?? []).map(t => t.name).join(",");
|
||||||
|
const home = m.homepageUrl || "";
|
||||||
|
if (topics || home) record("F_repo", "gh-repo-meta", "PASS", `topics=[${topics || "none"}] homepage=${home || "none"}`);
|
||||||
|
else record("F_repo", "gh-repo-meta", "WARN", "no topics/homepage set");
|
||||||
|
} catch { record("F_repo", "gh-repo-meta", "WARN", "could not read repo metadata"); }
|
||||||
|
}
|
||||||
|
|
||||||
|
// ===================== Verdict =====================
|
||||||
|
const statusOf = (id: string): Status | "MISSING" => results.find(r => r.id === id)?.status ?? "MISSING";
|
||||||
|
const skipped: string[] = [];
|
||||||
|
const failing: string[] = [];
|
||||||
|
for (const id of REQUIRED) {
|
||||||
|
const st = statusOf(id);
|
||||||
|
if (st === "PASS") continue;
|
||||||
|
if (QUICK && st === "WARN" && (id === "A_typecheck" || id === "A_test")) { skipped.push(id); continue; }
|
||||||
|
failing.push(`${id}(${st})`);
|
||||||
|
}
|
||||||
|
|
||||||
|
section("Headline gates");
|
||||||
|
record("_play", "GOOGLE PLAY", statusOf("D_play") === "PASS" ? "PASS" : "FAIL", statusOf("D_play") === "PASS" ? "PUBLISHED" : "NOT published");
|
||||||
|
record("_mainline", "F-DROID MAINLINE", statusOf("C_mainline") === "PASS" ? "PASS" : "FAIL", statusOf("C_mainline") === "PASS" ? "PUBLISHED" : "NOT published");
|
||||||
|
// drop synthetic headline rows from results so they don't affect anything else
|
||||||
|
results.splice(results.findIndex(r => r.id === "_play"), 2);
|
||||||
|
|
||||||
|
console.log("\n" + "=".repeat(62));
|
||||||
|
if (failing.length === 0 && skipped.length === 0) {
|
||||||
|
console.log(c("1", c("32", " PRODUCTION READY ✅")));
|
||||||
|
console.log(c("2", " All required gates passed — both stores live, app + site healthy."));
|
||||||
|
console.log("=".repeat(62));
|
||||||
|
process.exit(0);
|
||||||
|
} else if (failing.length === 0 && skipped.length > 0) {
|
||||||
|
console.log(c("1", c("33", " LIVE GATES PASS — run full check to confirm PRODUCTION READY ⚠")));
|
||||||
|
console.log(c("2", ` Skipped in --quick mode: ${skipped.join(" ")} (run without --quick).`));
|
||||||
|
console.log("=".repeat(62));
|
||||||
|
process.exit(1);
|
||||||
|
} else {
|
||||||
|
console.log(c("1", c("31", " NOT READY ❌")));
|
||||||
|
console.log(" Failing required gates:");
|
||||||
|
for (const f of failing) console.log(` - ${f}`);
|
||||||
|
console.log("=".repeat(62));
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user