hns-oss-docs-verify

# oss-docs Verify Recipe (exit gate) Runnable checks for the sprint-contract dimensions. **The scripts `docs-i18n-check.sh` and `gen_menu.py` DO NOT exist — never shell out to them; every check is inlined below.** All checks are read-only; this skill never commits or pushes. ## 1. Build clean (`build-clean`, must_pass, threshold 1.0) ```bash cd docs-site && hugo --minify --gc ``` - Must exit 0 AND complete **warning-free** (any `WARN`/`ERROR` line = FAIL). ```bash test -f docs-site/public/sitemap.xml && echo "sitemap OK" || echo "sitemap MISSING" ``` ## 2. URL blacklist (`content-fidelity`) ```bash grep -rn 'docs\.moai-ai\.dev\|adk\.moai\.com\|adk\.moai\.kr' docs-site/content README*.md ``` - Expected: **no matches**. Only `adk.mo.ai.kr` is valid. Note: the pattern `adk\.moai\.kr` does not match `adk.mo.ai.kr` (different dot positions) — no false positive on the valid domain. ## 3. Mermaid direction (`style-compliance`) ```bash grep -rn 'flowchart LR\|graph LR\|flowchart RL\|graph RL' docs-site/content ``` - Expected: **no matches** (TD-only rule; `flowchart TD` / `graph TB` pass). ## 4. 4-locale parity (`locale-parity`, must_pass, threshold 1.0) File-existence parity — every ko page has en/ja/zh counterparts: ```bash cd docs-site/content && for f in $(cd ko && find . -name '*.md'); do for loc in en ja zh; do [ -f "$loc/$f" ] || echo "MISSING: $loc/$f" done done ``` Section-count parity per locale tree (compare totals): ```bash for loc in ko en ja ...