[dzianisv]

Audit (2026-11-14, verified live)

The landing page at dzianisv.github.io/opencode-mobile/ had the head right (title 53 chars, meta, OG, SoftwareApplication + FAQPage JSON-LD) but the facts wrong:

• FAQ said Google Play was 'not publicly yet, internal testing only'. False: the app is live on Play since June 2026, v0.4.17, 4.65 stars from 139 ratings (read live 2026-11-13).
• FAQ said iOS was 'in active development' with TestFlight coming. False: no iOS, closed by owner decision Oct 2026 (issue epic: ship iOS build to TestFlight with CI #65, closed as not planned).
• The install section had no Google Play option at all, and the download page said Play was 'Coming soon'.
• README said v0.4.7 everywhere (prod is v0.4.17).
• No llms.txt anywhere; robots.txt was generic allow-all with no AI-crawler allowlist; sitemap lastmod was June 2026.
• Search for 'OpenCode Android client': our pages do not rank top. A same-named different product (getopencode.app / opencodemobile.com — Flutter, iOS TestFlight, paid Cloud Link) owns the name.

What this PR does

• docs-site/index.html: Google Play button in the hero, Play as install Option A, corrected FAQ answers (JSON-LD + visible), footer link renamed.
• docs-site/download/index.html: Play card is live with a link, iOS card says not available, version 0.4.17 everywhere, APK button label no longer says v0.4.3, title/meta under limits.
• docs-site/ios/index.html: rewritten as an honest correction page (no iOS app, none planned, why, what to do instead). URL kept live so the indexed page stops misleading searchers.
• docs-site/opencode-on-phone/index.html: iOS line corrected.
• README.md: v0.4.7 -> v0.4.17 (3 spots).
• docs-site/robots.txt: explicit allowlist for OAI-SearchBot, ClaudeBot, Claude-SearchBot, PerplexityBot, Perplexity-User, Google-Extended, Bingbot.
• docs-site/llms.txt + llms-full.txt: new, per the llms.txt spec (blockquote summary, sections, facts, FAQ).
• docs-site/sitemap.xml: lastmod 2026-11-14 for the changed pages.
• growth/aso-play-listing.md: draft Play copy — title 'OpenCode Mobile: AI Coding' (26 chars), short description kept at exactly 80 chars, long description kept with one added line, keyword list, screenshot plan. NOT applied: applying it waits on the owner's Play Console sign-in.

Checks done locally

• All JSON-LD blocks parse, sitemap.xml parses, no stale claims remain (grep for 'internal testing', 'Coming soon', 'in active development', 'TestFlight', '0.4.7', '0.4.3' is clean).
• Titles under 60 chars, meta descriptions under 160, ASO title 26 chars, short description 80 chars.

Deploy note (important)

No workflow deploys docs-site/ to gh-pages — publish-fdroid.yml only deploys fdroid/repo with keep_files. Merging this PR updates main only. After merge, sync docs-site/ to the gh-pages branch root for the live site to update, or add a docs-site deploy workflow (needs workflow scope).

Still gated (not this PR)

• Applying the ASO copy to Play Console: waits on the owner's Play sign-in.
• Search Console / Bing Webmaster verification and sitemap submission: waits on the owner.
• website/ (agentlabs.cc, the repo homepage) is also stale (iOS Coming Soon, CUA demo video). Separate Next.js deploy, recorded as follow-up, not touched here.

Work Log rows: Growth: SEO landing page + web search traffic; Growth: AI-agent discoverability (ChatGPT and co.).

[dzianisv]

Stage 4 review — FAIL (1 validated finding)

Reviewed head e1285ed (base fb7344db, branch growth/seo-geo-aso). Two passes done in sequence by one reviewer (compliance, then bug-hunt). 10 files changed, all web content + docs; no app code, no test files, no applicationId change — the test-count rule does not apply to this content-only PR.

Per-criterion verdicts

1. Stale claims corrected — PASS. Site-wide grep for internal testing / Coming soon / TestFlight / active development / in development / v0.4.7 / v0.4.3 / not publicly across README.md, docs-site/, growth/: zero hits. README now reads v0.4.17 in all 3 places (lines 31, 67, 140); download page APK button reads Download APK (latest) instead of v0.4.3 (docs-site/download/index.html:209); iOS page rewritten as Android-only, no iOS planned (docs-site/ios/index.html).
2. Google Play install offered — PASS. Landing hero: docs-site/index.html:256; install section (new Option A): index.html:342; download page: docs-site/download/index.html:225. All link https://play.google.com/store/apps/details?id=cc.agentlabs.opencode.
3. llms.txt + llms-full.txt — PASS. Both exist at docs-site/ root. llms.txt has H1 name, blockquote summary, H2 sections (Install / Features / Compare / Help) with one-line link descriptions; all 11 linked pages exist in docs-site/. Facts cross-checked: free + MIT + v0.4.17 + Play/F-Droid/APK + Android-only/no-iOS agree with README and the landing page; live Play listing fetch confirms free (0 USD), rating 4.65 from 139 ratings, and the long-description copy; v1+v2 support confirmed in code (src/lib/api-detect.ts, ServerApi = "v1" | "v2"\, verified against live opencode v2.0.16 and v1.18.32); "live since June 2026" confirmed by AppBrain ("On Google Play since June 2026", version 0.4.17, publisher VIBE TECHNOLOGIES, LLC). v0.4.17 confirmed as latest release (2026-11-05) and app.json/package.json` version.
4. robots.txt — PASS. Explicitly allows OAI-SearchBot, ClaudeBot, Claude-SearchBot, PerplexityBot, Perplexity-User, Google-Extended, Bingbot (docs-site/robots.txt:3-23), plus User-agent: * and the sitemap line (line 26).
5. sitemap.xml — PASS. Valid XML (parsed). lastmod 2026-11-14 on all four changed pages: / (line 7), /download/ (line 13), /opencode-on-phone/ (line 52), /ios/ (line 64).
6. Titles / descriptions / JSON-LD — FAIL (see F1). Titles on all four changed pages are under 60 chars (53 / 52 / 44 / 58). Meta descriptions pass on three (146 / 143 / 145 chars) but not the fourth. All 9 JSON-LD blocks across the four changed pages parse as JSON.
7. ASO copy — PASS. growth/aso-play-listing.md: proposed title "OpenCode Mobile: AI Coding" = 26 chars (max 30); short description = exactly 80 chars (kept live copy, verified against the live Play listing); long description = 2,466 chars (max 4000), copied from the live listing plus the added "Android only. There is no iOS version." line; no invented numbers — 4.65 / 139 ratings are the verified live values (Play fetch: rating 4.6538…, 139 ratings).
8. No applicationId / app-code / test changes — PASS. Diff touches only README.md, 6 docs-site/ files, and growth/aso-play-listing.md. applicationId / package cc.agentlabs.opencode untouched (verified in app.json, android/app/build.gradle).

Validated finding (fails the PR)

F1 — Meta description over the 160-char limit on a changed page.
docs-site/opencode-on-phone/index.html:7 — 186 chars:

"The simplest way to run the opencode AI coding agent on your phone. Skip the Termux SSH rabbit hole — install OpenCode Mobile, point it at your server, and code from anywhere on Android."
Measured at both base (fb7344db) and head (e1285ed): 186 chars, and the PR's diff to this file does not touch the description line — but the PR does change this page (iOS FAQ, line 328) and bumps its sitemap lastmod to 2026-11-14, so the page is in scope of criterion 6, and the PR itself trimmed the landing-page description to fit the same limit (docs-site/index.html:7, 146 chars). Fix: trim this description to ≤160 chars (e.g. drop "and code from anywhere on Android" or shorten the Termux clause) and re-review.

Filed notes (not failures)

• N1 — "Android 7.0 and up, arm64" in llms-full.txt is unverified, not refuted. minSdkVersion comes from rootProject.ext via the Expo root-project plugin; its value is not defined anywhere in the repo tree, and no ABI filter was found. Suggest confirming against the Play Console device catalog or dropping the floor/arch detail.
• N2 — Untouched site pages still exceed the 60/160 limits (e.g. guide title 70, remote-access 83, troubleshooting 83, vs-termux 75 chars; several descriptions 162–200 chars). Out of scope for this PR; consider a follow-up sweep.
• N3 — No further defects found in the bug pass. Checked: Play/F-Droid/APK URLs, internal links, badge-rec CSS (defined, docs-site/download/index.html:127), install-section renumbering (Option A Play / B F-Droid / C APK, consistent), iOS issue epic: ship iOS build to TestFlight with CI #65 reference (closed as not planned — matches the record), and JSON-LD content consistency. Nothing else validated.

[dzianisv]

Stage 4 re-review — PASS

Re-review of head 3e8d593 (base fb7344db, branch growth/seo-geo-aso), re-checking the FAIL from the e1285ed review (previous verdict). Two passes done in sequence by one reviewer (compliance, then bug-hunt). The fix commit 3e8d593 ("review: trim opencode-on-phone meta description, drop unverified arm64 claim") touches exactly the two flagged files. 10 files changed, all web content + docs; no app code, no test files, no applicationId change — the test-count rule does not apply to this content-only PR.

Re-check of the previous verdict

• F1 (was FAIL) — FIXED, verified by measurement. docs-site/opencode-on-phone/index.html:7 meta description is now 149 chars (limit 160): "The simplest way to run the opencode AI coding agent on your phone. Skip the Termux SSH rabbit hole — install OpenCode Mobile and code from anywhere." Was 186 chars at e1285ed.
• N1 (was note) — RESOLVED. arm64 is gone from docs-site/llms-full.txt (grep: zero hits in README.md, docs-site/llms.txt, docs-site/llms-full.txt, growth/); the line now reads "Platform: Android only (7.0 and up). No iOS." (llms-full.txt:46). The kept "Android 7.0 and up" is grounded in the pre-existing download page at base fb7344db — JSON-LD "operatingSystem": "Android 7.0+" and body text "An Android 7.0+ device…" — and the PR diff does not touch either line (0 hits for "7.0" in the download-page diff).
• N2 (was note) — CONFIRMED, still out of scope. Measured at head: 9 untouched site pages still exceed the 60/160 limits (claude-code-android desc 200; comparison title 63; features desc 193; gpt-gemini-android title 63 / desc 193; guide title 70; remote-access title 83 / desc 162; troubleshooting title 83; try-demo title 66 / desc 189; vs-termux title 75 / desc 183). None of the 9 is in this PR's diff (git diff --name-only fb7344db..HEAD = the 10 files below). Follow-up sweep material, not a blocker. (Count is 9, not 8 as in the first review — re-measured at head.)

Per-criterion verdicts

1. Stale claims corrected — PASS. Scoped grep for internal testing / Coming soon / in active development / TestFlight / v0.4.7 / v0.4.3 across README.md, docs-site/, growth/: zero hits. README reads v0.4.17 in all 3 places. (Repo-wide hits for these strings exist only in pre-existing, untouched files — distribution/aso-audit.md, .agents/skills/app-store-optimization/ — outside this PR's scope.)
2. Google Play install offered — PASS. Landing hero docs-site/index.html:256 and install section Option A index.html:342; download page docs-site/download/index.html:225 ("Get it on Google Play", badge "Live"). All link https://play.google.com/store/apps/details?id=cc.agentlabs.opencode (4 occurrences on the landing page, 1 on the download page).
3. llms.txt + llms-full.txt — PASS. Both at docs-site/ root. llms.txt: H1 + blockquote summary, H2 sections (Install / Features / Compare / Help), one-line link descriptions; all 12 linked site pages exist in docs-site/. Facts agree with README and the landing page (free, MIT, v0.4.17, Play/F-Droid/APK, Android-only/no-iOS) and with the live Play listing values verified in the first review (4.65 / 139 ratings). "Android 7.0 and up" grounded per N1 above.
4. robots.txt — PASS. Explicitly allows OAI-SearchBot, ClaudeBot, Claude-SearchBot, PerplexityBot, Perplexity-User, Google-Extended, Bingbot (docs-site/robots.txt:3-23), plus User-agent: * and the sitemap line (line 26).
5. sitemap.xml — PASS. Valid XML (parsed). lastmod 2026-11-14 on all four changed pages: /, /download/, /opencode-on-phone/, /ios/; unchanged pages keep their older dates.
6. Titles / descriptions / JSON-LD — PASS. All four changed pages measured at head: landing title 53 / desc 146; download 52 / 143; iOS 44 / 145; opencode-on-phone 58 / 149 — all under 60 / 160. All 9 JSON-LD blocks across the four pages parse as JSON.
7. ASO copy — PASS. growth/aso-play-listing.md: proposed title "OpenCode Mobile: AI Coding" = 26 chars (max 30); short description = exactly 80 chars (live copy kept); long description block = 2,466 chars (max 4000), live copy plus the added "Android only. There is no iOS version." line; no invented numbers — 4.65 / 139 ratings are the verified live values.
8. No applicationId / app-code / test changes — PASS. Diff touches only README.md, 6 docs-site/ files, and growth/aso-play-listing.md. applicationId 'cc.agentlabs.opencode' (android/app/build.gradle:94) is not in the diff; no src/, android/, app/, or test files touched.

Validated findings

None. No finding that fails the PR.

Filed notes (not failures)

• N2 (carried): 9 untouched site pages still exceed the 60/160 limits — see above. Follow-up sweep.
• N3 — "in 5 minutes" in llms.txt:9 is an estimate, not a measured claim. The setup-guide link description says "Start opencode serve and connect the app in 5 minutes"; the guide page itself says only "you'll be running an AI coding agent from your pocket in minutes" (no "5 minutes" text). Not contradicted by anything, so not a failure — consider softening to "in minutes" in a follow-up. (The companion "30 seconds" claim in llms.txt:15 checks out: docs-site/demo.mp4 is 31.0 s.)

Verdict: PASS at head 3e8d593.

[dzianisv]

Triage: iOS CI check on head 3e8d593 — the 'Unsigned iOS Simulator build' job (job 132011832547, run 43462114404) never ran: status completed, conclusion cancelled, runner unassigned, queued 16:23:24Z, cancelled 16:42:06Z. No build output exists. This change cannot have caused it: the PR touches only docs-site HTML/txt/xml, README.md, and growth/aso-play-listing.md — zero iOS code, zero app code (10 files, no src/android/app). iOS CI passes on main (fb7344d, run success 16:10:08Z) and on branches feat/subagent-sessions-187 and fix/sse-startup-recovery-189-186 the same hour, so this is runner allocation (fleet), not the change. Diagnostic rerun of the failed job requested (one max).

[dzianisv]

Merging under the dev-workflow Stage 5 exception (fleet triage, see comment 6859215748).

iOS CI rerun status at merge time: job 132025750882 (run 43462114404, attempt 2) still queued after 19+ min (started 2026-11-13T16:46:57Z, no runner assigned, no conclusion) — past the age at which attempt 1 was cancelled without running (queued 16:23:24Z → cancelled 16:42:06Z). Two attempts, ~38 min total queue time, zero execution.

Why this is safe to merge without the iOS job:

• This PR touches zero iOS code and zero app code (docs-site/, README.md, growth/aso-play-listing.md only).
• iOS CI passes on main (fb7344d, success 16:10:08Z) and on branches feat/subagent-sessions-187 and fix/sse-startup-recovery-189-186 the same hour — fleet/runner allocation, not the change.
• Stage 4 review verdict PASS at the reviewed head 3e8d593 (comment 6858710989).
• All other checks green on the head: secret scan, typecheck + unit tests, build (22m12s), test.

[dzianisv]

Main moved again while CI ran on the updated head: PR #241 merged (b5e9363) at 01:15 WITA, so this branch is behind once more. Merging with --admin to bypass only the strict up-to-date rule:

• All required checks are GREEN on head d6767ef (Typecheck and unit tests 50s, test 1m0s, build 17m46s) plus secret scan pass and iOS Simulator build pass (7m18s). Nothing is being bypassed on checks.
• Stage 4 verdict PASS stands on the content head 3e8d593; d6767ef only merges in main 3d7728c (already-reviewed PR fix: SSE startup + liveness (#189, #186) #237).
• File sets are fully disjoint from feat(chat): read-only subagent sessions surface (#187) #241 (app code / i18n / maestro / tests vs. this PRs README.md + docs-site/* + growth/*) and GitHub reports mergeable: true — no conflict, no interaction.
• Re-running update-branch + a ~20 min CI cycle would only re-open the same race with the next main movement.

[dzianisv]

MERGED — db17840 (main HEAD, verified by readback, 2026-11-13T17:25:59Z).

What landed (10 files): corrected docs-site landing page (Play button in hero, Play as install Option A, corrected FAQ JSON-LD + visible answers, footer link), download page (Play live, iOS not available, v0.4.17), iOS page rewritten as an honest correction page (URL kept live), opencode-on-phone iOS line corrected, README v0.4.7 → v0.4.17, robots.txt with explicit AI-crawler allowlist, llms.txt + llms-full.txt, sitemap lastmod 2026-11-14, growth/aso-play-listing.md (draft ASO copy — NOT applied).

Stage 5.5 (Design/PRD sync): checked — the PRD does not describe the landing page; no update needed.

CI on the merged head d6767ef: Typecheck and unit tests pass, test pass, build pass (17m46s), secret scan pass, iOS Simulator build pass (7m18s). Note: the iOS job failed to get a runner twice on the earlier head 3e8d593 (queued 19 min, then cancelled; rerun queued 19+ min, no runner) — fleet allocation, not the change; it ran and passed on the updated head.

Still gated (not in this PR): live site update needs docs-site/ synced to the gh-pages branch root (no deploy workflow covers it); ASO copy application + Search Console verification wait on Play Console sign-in; website/ (opencode.agentlabs.cc) staleness is a separate follow-up; N3 "5 minutes" wording follow-up; 9 untouched site pages still exceed 60/160 limits.