[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M758KKHSR7PAM56BA976XP8Z":3,"skill-same:01M758KKHSR7PAM56BA976XP8Z":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":44,"repositoryHtmlUrl":45,"repositoryHomepageUrl":46,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":48,"updatedAt":49,"install":50,"resources":63},"01M758KKHSR7PAM56BA976XP8Z","webapp-deploy-verification",null,"Verify deployed web app routes render and links resolve.","lukemcqueen\u002Fsteadfaste-fleet","lukemcqueen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F405240?v=4","01M757MHPAGRXTJAT46SKZP98R","Luke McQueen","01M757MHPZ573KP8DT9GB8SBQ7",4,"MIT","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fwebapp-deploy-verification\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: webapp-deploy-verification\nversion: 1.0.0\ndescription: \"Verify deployed web app routes render and links resolve.\"\nauthor: Steadfaste Fleet\nmetadata:\n  hermes:\n    tags: [web, deploy, verification, e2e, routes, links, nextjs, docker]\n    related_skills: [deploy-load-verification, integration-audit, dogfood]\n---\n\n# Web App Deploy Verification — Prove It, Don't Assume\n\n## When to Use\n\n- After rebuilding\u002Frestarting a web container — before telling the user it's live.\n- When a user reports a page \"still broken\" after you fixed it.\n- After adding routes, links, nav\u002Ffooter changes, or i18n\u002Flocalization work.\n- Any time you need to claim \"the site works\" with evidence.\n\n## Core Principle\n\nGit commit ≠ running deployment. A committed file is not a serving page. The\n**only** proof a web app works is exercising the URL another user would hit and\nobserving the real response. Three axes are independently verifiable — check all\nthree:\n\n1. **Routes render** (each URL returns 200 and no JS errors)\n2. **Links resolve** (every href on every page actually returns 200 when followed)\n3. **Container health is real** (the healthcheck passes; it isn't lying)\n\n## Technique 1 — HTTP Route Crawl\n\nEnumerate the route tree from the app dir, then curl each one over the deployed\npath (never the dev server):\n\n```python\nimport requests\nBASE = \"http:\u002F\u002F127.0.0.1:PORT\"            # the deployed\u002Fproxied origin\nroutes = [\"\u002F\", \"\u002Fabout\", \"\u002Fabout\u002Fx\", ...] # from find apps\u002Fweb\u002Fsrc\u002Fapp -name page.tsx\nfor r in routes:\n    resp = requests.get(BASE + r, allow_redirects=False, timeout=20)\n    # treat 3xx as \"follow, then check final\"; 4xx\u002F5xx = broken\n```\n\n**Gotchas from the field:**\n- A route can 404 with a **layout wrapper but no page** (e.g. `\u002Fadmin` was\n  layout-only → 404; same for a bare `\u002Fquestions` where only `[slug]` exists).\n  Flag these separately — no link targets them, but they 404 on direct visit.\n- Capture the `\u003Ctitle>` from each 200 body to confirm you got the right page, not\n  a generic error page that still returns 200.\n- Auth-gated routes (admin\u002Fdashboard) render 200 with the login shell even\n  anonymous — that's expected; check the title tag, not just the status.\n\n## Technique 2 — E2E Link Verification (THE critical one)\n\n**Read hrefs, then FOLLOW them. Reading href text alone proves nothing.** The\nexpensive failure this session: an i18n header prepended `\u002F${locale}` (= `\u002Fen\u002F`)\nto every nav\u002Ffooter href, but the locale was a **runtime preference\n(localStorage\u002Fnavigator), NOT a URL route** — no `[locale]` dir, no middleware, no\ni18n rewrite existed. Every nav\u002Ffooter link 404'd when clicked, while:\n- the page rendered fine,\n- every link *label* was correct (Home, About, ...),\n- and checking href *text* looked perfectly healthy.\n\nOnly following each link surfaced it. **The technique:**\n\n```\nfor each route:\n    visit it in a real browser, collect every internal \u003Ca href>\ndedupe the global link set\nthen HTTP-GET every unique link and assert 200\n```\n\nAlso intersect the **collected link graph** against the **actual route tree** —\na nav pointing `\u002Fwarriors` when the page is `\u002Fwarrior` (or `\u002Frest` vs `\u002Fbreath`)\nis a dead link neither a route crawl nor a label check will catch.\n\nSynthetic DOM events (dispatchEvent\u002Fmouseover) do NOT trigger CSS `:hover` —\nto verify a hover dropdown use a real pointer move, or check the menu nodes exist\nin the DOM with correct hrefs and trust the CSS rule.\n\n## Technique 3 — Container Health Reality Check\n\nA compose healthcheck failing does NOT mean the service is down — it means the\n*probe* can't reach the service. **unhealthy ≠ down.** See the container\npitfalls below; the two classic traps are a server bound to the container IP\n(not loopback) and `localhost` fanning out to IPv6 `[::1]` first.\n\n## Container Healthcheck Pitfalls (Next.js standalone)\n\n- **Server binds container IP, not loopback.** Next standalone `server.js` binds\n  to `HOSTNAME`, which Docker resolves to e.g. `172.26.0.6:3000`. A healthcheck\n  `wget http:\u002F\u002Flocalhost:3000\u002F` inside is refused while the published `-p` port\n  works fine from the host (DNAT targets the container IP).\n- **`localhost` → IPv6 `[::1]` first.** Even after an all-interface bind, a probe\n  of the *hostname* `localhost` resolves to `[::1]` and gets refused on the\n  IPv4-only listener. Probe the literal `http:\u002F\u002F127.0.0.1:PORT\u002F`, never the\n  `localhost` hostname.\n- **Fix:** force `HOSTNAME: \"0.0.0.0\"` in the compose `environment:` (or `ENV\n  HOSTNAME=0.0.0.0` in the runner stage) AND probe the explicit IPv4 address in\n  the healthcheck. Verify inside:\n  `docker exec \u003Cc> netstat -tlnp | grep :PORT` → `0.0.0.0:PORT` LISTEN, then\n  `wget -q --spider http:\u002F\u002F127.0.0.1:PORT\u002F; echo $?` → 0.\n\n## Script\n\n- `scripts\u002Fwebapp-http-crawl.py` — ready-to-run HTTP route crawl + link check:\n  pass `--base \u003Curl>` and `--routes file-or-list`; reports OK\u002FBAD per URL.\n\n## Verification Checklist\n\n- [ ] Every route in the app dir returns 200 over the deployed origin\n- [ ] Every internal `\u003Ca href>` collected from the live pages returns 200\n- [ ] Link graph intersected with route tree — no dead\u002Fbare targets\n- [ ] `\u003Ctitle>` tag present and correct on the served HTML (empty title = missing metadata export)\n- [ ] Container healthcheck reads `healthy` (not a false `unhealthy` while serving)\n- [ ] Hard-refresh note given to user for stale browser cache on icon\u002Ffavicon changes\n","# Web App Deploy Verification — Prove It, Don't Assume\n\n## When to Use\n\n- After rebuilding\u002Frestarting a web container — before telling the user it's live.\n- When a user reports a page \"still broken\" after you fixed it.\n- After adding routes, links, nav\u002Ffooter changes, or i18n\u002Flocalization work.\n- Any time you need to claim \"the site works\" with evidence.\n\n## Core Principle\n\nGit commit ≠ running deployment. A committed file is not a serving page. The\n**only** proof a web app works is exercising the URL another user would hit and\nobserving the real response. Three axes are independently verifiable — check all\nthree:\n\n1. **Routes render** (each URL returns 200 and no JS errors)\n2. **Links resolve** (every href on every page actually returns 200 when followed)\n3. **Container health is real** (the healthcheck passes; it isn't lying)\n\n## Technique 1 — HTTP Route Crawl\n\nEnumerate the route tree from the app dir, then curl each one over the deployed\npath (never the dev server):\n\n```python\nimport requests\nBASE = \"http:\u002F\u002F127.0.0.1:PORT\"            # the deployed\u002Fproxied origin\nroutes = [\"\u002F\", \"\u002Fabout\", \"\u002Fabout\u002Fx\", ...] # from find apps\u002Fweb\u002Fsrc\u002Fapp -name page.tsx\nfor r in routes:\n    resp = requests.get(BASE + r, allow_redirects=False, timeout=20)\n    # treat 3xx as \"follow, then check final\"; 4xx\u002F5xx = broken\n```\n\n**Gotchas from the field:**\n- A route can 404 with a **layout wrapper but no page** (e.g. `\u002Fadmin` was\n  layout-only → 404; same for a bare `\u002Fquestions` where only `[slug]` exists).\n  Flag these separately — no link targets them, but they 404 on direct visit.\n- Capture the `\u003Ctitle>` from each 200 body to confirm you got the right page, not\n  a generic error page that still returns 200.\n- Auth-gated routes (admin\u002Fdashboard) render 200 with the login shell even\n  anonymous — that's expected; check the title tag, not just the status.\n\n## Technique 2 — E2E Link Verification (THE critical one)\n\n**Read hrefs, then FOLLOW them. Reading href text alone proves nothing.** The\nexpensive failure this session: an i18n header prepended `\u002F${locale}` (= `\u002Fen\u002F`)\nto every nav\u002Ffooter href, but the locale was a **runtime preference\n(localStorage\u002Fnavigator), NOT a URL route** — no `[locale]` dir, no middleware, no\ni18n rewrite existed. Every nav\u002Ffooter link 404'd when clicked, while:\n- the page rendered fine,\n- every link *label* was correct (Home, About, ...),\n- and checking href *text* looked perfectly healthy.\n\nOnly following each link surfaced it. **The technique:**\n\n```\nfor each route:\n    visit it in a real browser, collect every internal \u003Ca href>\ndedupe the global link set\nthen HTTP-GET every unique link and assert 200\n```\n\nAlso intersect the **collected link graph** against the **actual route tree** —\na nav pointing `\u002Fwarriors` when the page is `\u002Fwarrior` (or `\u002Frest` vs `\u002Fbreath`)\nis a dead link neither a route crawl nor a label check will catch.\n\nSynthetic DOM events (dispatchEvent\u002Fmouseover) do NOT trigger CSS `:hover` —\nto verify a hover dropdown use a real pointer move, or check the menu nodes exist\nin the DOM with correct hrefs and trust the CSS rule.\n\n## Technique 3 — Container Health Reality Check\n\nA compose healthcheck failing does NOT mean the service is down — it means the\n*probe* can't reach the service. **unhealthy ≠ down.** See the container\npitfalls below; the two classic traps are a server bound to the container IP\n(not loopback) and `localhost` fanning out to IPv6 `[::1]` first.\n\n## Container Healthcheck Pitfalls (Next.js standalone)\n\n- **Server binds container IP, not loopback.** Next standalone `server.js` binds\n  to `HOSTNAME`, which Docker resolves to e.g. `172.26.0.6:3000`. A healthcheck\n  `wget http:\u002F\u002Flocalhost:3000\u002F` inside is refused while the published `-p` port\n  works fine from the host (DNAT targets the container IP).\n- **`localhost` → IPv6 `[::1]` first.** Even after an all-interface bind, a probe\n  of the *hostname* `localhost` resolves to `[::1]` and gets refused on the\n  IPv4-only listener. Probe the literal `http:\u002F\u002F127.0.0.1:PORT\u002F`, never the\n  `localhost` hostname.\n- **Fix:** force `HOSTNAME: \"0.0.0.0\"` in the compose `environment:` (or `ENV\n  HOSTNAME=0.0.0.0` in the runner stage) AND probe the explicit IPv4 address in\n  the healthcheck. Verify inside:\n  `docker exec \u003Cc> netstat -tlnp | grep :PORT` → `0.0.0.0:PORT` LISTEN, then\n  `wget -q --spider http:\u002F\u002F127.0.0.1:PORT\u002F; echo $?` → 0.\n\n## Script\n\n- `scripts\u002Fwebapp-http-crawl.py` — ready-to-run HTTP route crawl + link check:\n  pass `--base \u003Curl>` and `--routes file-or-list`; reports OK\u002FBAD per URL.\n\n## Verification Checklist\n\n- [ ] Every route in the app dir returns 200 over the deployed origin\n- [ ] Every internal `\u003Ca href>` collected from the live pages returns 200\n- [ ] Link graph intersected with route tree — no dead\u002Fbare targets\n- [ ] `\u003Ctitle>` tag present and correct on the served HTML (empty title = missing metadata export)\n- [ ] Container healthcheck reads `healthy` (not a false `unhealthy` while serving)\n- [ ] Hard-refresh note given to user for stale browser cache on icon\u002Ffavicon changes\n",{"name":5,"author":24,"version":25,"metadata":26,"description":7},"Steadfaste Fleet","1.0.0",{"hermes":27},{"tags":28,"related_skills":37},[29,30,31,32,33,34,35,36],"web","deploy","verification","e2e","routes","links","nextjs","docker",[38,39,40],"deploy-load-verification","integration-audit","dogfood","main","2e6aa8d15ab0a366c90be54f61bf9c6e97015e83","skills\u002Fdevops\u002Fwebapp-deploy-verification",1,"https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet","steadfaste.com","https:\u002F\u002Fgithub.com\u002Flukemcqueen","AI Architect | Building Hermes Cortex: governed multi-agent AI for autonomous software engineering | Enterprise Tech Consultant","2026-11-14 22:33:34",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add lukemcqueen\u002Fsteadfaste-fleet --skill webapp-deploy-verification",{"tool":56,"command":57},"bunx","bunx skills add lukemcqueen\u002Fsteadfaste-fleet --skill webapp-deploy-verification",{"tool":59,"command":60},"pnpm","pnpm dlx skills add lukemcqueen\u002Fsteadfaste-fleet --skill webapp-deploy-verification","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fwebapp-deploy-verification\u002FSKILL.md",true,[64],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"scripts\u002Fwebapp-http-crawl.py","SCRIPT","脚本",3610,"https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fwebapp-deploy-verification\u002Fscripts\u002Fwebapp-http-crawl.py",[71,79,86,93,100,107],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":78},"01M7DXY4G8NSVB59K8B6S2AQNP","macbook-linux-maintenance","Legacy MacBook Linux fixes: GPU wedge, reboot hang, thermal.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fmacbook-linux-maintenance\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":78},"01M7DXXYJCXFJ3TGB84ZQ8KFE6","governance-regression-triage","Triage a host's governance issues: what changed.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fgovernance-regression-triage\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":78},"01M7DXXSAP1G8FDRJAMXQGBBMK","enforcement-immutability","Use when enforcement files lose their immutable flag.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fenforcement-immutability\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":78},"01M78SSDQVRYX64Y16X32TC0NS","steadfaste-fleet-repo-deploy","Use when committing to the steadfaste-fleet repo.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fsteadfaste-fleet-repo-deploy\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":78},"01M78SS928F3R2RJAYVW4E30CE","steadfaste-fleet-maintenance","Maintain an installed Steadfaste Fleet instance — update both the upstream Hermes Agent and the fleet repo layer, merge diverged histories, sync skills safely, and troubleshoot common issues. Covers the dual-update workflow (hermes update + fleet-update.sh), encrypted brain data backup, mycortex import, and recovery techniques.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fsteadfaste-fleet-maintenance\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":78},"01M78SP1CHW0T0BWE5ZT6JBPX8","fleet-preflight","DEPRECATED alias — merged into survey-before-action (2026-08-20). Load survey-before-action instead; its \"Repo-Specific Pre-Flight\" section covers git search, Hermes boundary, and deployment verification.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Ffleet-preflight\u002FSKILL.md",[],[]]