From f6cc1deecf980bdbce43e5dce5ab02a660c2e7fb Mon Sep 17 00:00:00 2001 From: appdevelopsk Date: Fri, 13 Nov 2026 09:00:33 +0900 Subject: [PATCH 1/3] growth: fail production publish smoke when five-language catalog is stale --- scripts/check_app_discovery_live.sh | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/scripts/check_app_discovery_live.sh b/scripts/check_app_discovery_live.sh index 852acd89..9a7c8f27 100644 --- a/scripts/check_app_discovery_live.sh +++ b/scripts/check_app_discovery_live.sh @@ -25,6 +25,17 @@ if grep -Fq 'href="support/face-reaction-battle/"' "$tmp/index.html"; then fi fetch '/apps' 'apps.html' grep -Fq 'id="find-app"' "$tmp/apps.html" || { echo 'FAIL catalog search is stale' >&2; exit 1; } + +# The new UI is browser-side only; these assertions confirm deployed source, +# NOT that user interactions/GA4 events have been executed in a real browser. +grep -Fq 'id="catalog-language"' "$tmp/apps.html" || { echo 'FAIL five-language catalog selector not deployed' >&2; exit 1; } +grep -Fq 'CATALOG_LOCALE_START' "$tmp/apps.html" || { echo 'FAIL catalog locale controller missing' >&2; exit 1; } +grep -Fq 'catalog_language_selected' "$tmp/apps.html" || { echo 'FAIL catalog language analytics contract missing' >&2; exit 1; } +for language in en ja es pt-BR id; do + grep -Fq "option value=\"$language\"" "$tmp/apps.html" || { echo "FAIL $language catalog option not deployed" >&2; exit 1; } +done +grep -Fq 'catalogSearchAliases' "$tmp/apps.html" || { echo 'FAIL localized pilot discovery aliases missing' >&2; exit 1; } + grep -Fq 'catalog_store_click' "$tmp/apps.html" || { echo 'FAIL store-click attribution is stale' >&2; exit 1; } grep -Fq '日本語でゲームを探す' "$tmp/apps.html" || { echo 'FAIL Japanese guide missing from live app catalog' >&2; exit 1; } grep -Fq 'Dotchi: This or That Polls' "$tmp/apps.html" || { echo 'FAIL Dotchi catalog still presents an anime-only app' >&2; exit 1; } From 9a0f265c7b63e5590adeb90b485c583e82823e93 Mon Sep 17 00:00:00 2001 From: appdevelopsk Date: Fri, 13 Nov 2026 09:00:54 +0900 Subject: [PATCH 2/3] test: assert production smoke enforces five-language catalog without deployments --- scripts/test_catalog_deploy_contract.cjs | 35 ++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 scripts/test_catalog_deploy_contract.cjs diff --git a/scripts/test_catalog_deploy_contract.cjs b/scripts/test_catalog_deploy_contract.cjs new file mode 100644 index 00000000..1829ce54 --- /dev/null +++ b/scripts/test_catalog_deploy_contract.cjs @@ -0,0 +1,35 @@ +'use strict'; +const test = require('node:test'); +const assert = require('node:assert/strict'); +const fs = require('node:fs'); +const path = require('node:path'); + +const root = path.join(__dirname, '..'); +const catalog = fs.readFileSync(path.join(root, 'apps.html'), 'utf8'); +const releaseSmoke = fs.readFileSync(path.join(__dirname, 'check_app_discovery_live.sh'), 'utf8'); + +test('the live gate checks all five source locale choices', () => { + for (const lang of ['en', 'ja', 'es', 'pt-BR', 'id']) { + assert.ok(catalog.includes('option value="' + lang + '"'), lang + ' missing from source'); + } + assert.ok(releaseSmoke.includes('for language in en ja es pt-BR id')); + assert.ok(releaseSmoke.includes('catalog_language_selected')); + assert.ok(releaseSmoke.includes('id="catalog-language"')); + assert.ok(releaseSmoke.includes('CATALOG_LOCALE_START')); +}); + +test('catalog remains complete and existing analytics are preserved', () => { + assert.equal((catalog.match(/class="app-card"/g) || []).length, 92); + assert.match(catalog, /"numberOfItems": 92/); + for (const event of ['download_click', 'catalog_store_click', 'catalog_search_used']) { + assert.ok(catalog.includes(event), event); + } + assert.ok(catalog.includes('catalog_language_selected')); +}); + +test('the live gate is read-only and preserves fail-fast behavior', () => { + assert.ok(releaseSmoke.includes("fetch '/apps' 'apps.html'")); + assert.ok(releaseSmoke.includes('exit 1')); + assert.ok(!releaseSmoke.includes('rsync '), 'live smoke must not deploy'); + assert.ok(!releaseSmoke.includes('ssh '), 'live smoke must not mutate remote host'); +}); From c94ead074db8ac9a2b65877e3ad8c612a8d6caf1 Mon Sep 17 00:00:00 2001 From: appdevelopsk Date: Fri, 13 Nov 2026 09:01:15 +0900 Subject: [PATCH 3/3] docs: hand off authorized VPS dry-run/apply and five-language live smoke checks --- README.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/README.md b/README.md index 3a5a0cfd..e10777d6 100644 --- a/README.md +++ b/README.md @@ -93,3 +93,28 @@ Before claiming a live release, verify the hosting provider deployed SHA and ope cards, filters, language switching, console errors, real store destinations, and exactly one catalog_language_selected per manual choice in GA4 DebugView. Record source-vs-live evidence in GitHub issue #51. A merge is not deployment. + + +## VPS production publish gate for the five-language app catalog + +Source-only PRs are not production deployments. The repository now contains +scripts/publish_app_discovery.sh (dry-run by default) and +scripts/check_app_discovery_live.sh (read-only production smoke). The catalog +locale selector is part of apps.html and is in the publish file allowlist. + +On the **authorized deployment machine** with the correct SSH alias, +verified domain mapping and a clean checkout of the intended main commit: + + bash scripts/publish_app_discovery.sh --dry-run + +Review every destination/changed file and the current public host configuration. +Only after approving that exact deploy, invoke: + + bash scripts/publish_app_discovery.sh --apply + bash scripts/check_app_discovery_live.sh + +The live smoke now requires the five catalog languages and their browser-side +event contract, plus previously released growth pages. Check mobile browser +behavior, GA4 DebugView and Play acquisition data separately. This workflow +cannot be run against the owner's VPS from a disconnected ChatGPT container; +no source merge or local test proves that /apps is updated on the public host.