phase 1 5 docs site

Launch gate (D.6) needs a single script operators run against preview or production to confirm redirects, key pages, 404, OG, and search API — not ad-hoc curl commands. Encodes acceptance criteria from D.2.8, D.2.4, D.2.5 into repeatable smoke.

Milestone D.5.2 — verify_phase15.sh

Status: Planned
Goal: D.5
Phase: 1.5 — Docs Site
Wave: 11
Estimated effort: 2 hours
ADR required: None

Spec detail: MASTER_BRIEF.md Part D (D.5.2).


Why This Milestone Exists

Launch gate (D.6) needs a single script operators run against preview or production to confirm redirects, key pages, 404, OG, and search API — not ad-hoc curl commands.

Encodes acceptance criteria from D.2.8, D.2.4, D.2.5 into repeatable smoke.

Blocks Phase 2.1.1 until verify_phase15.sh passes against production.


Non-Goals

  • Load testing docs site
  • Verifying Go service health endpoints
  • Replacing full E2E Playwright suite

Branch

feat/d5-2-verify-script

PR Title

chore(docs): verify_phase15.sh smoke script (D.5.2)


Prerequisites


Deliverables

  • infra/scripts/verify_phase15.sh per MASTER_BRIEF §D.5.2
  • Checks: root redirect, key pages 200, 404 status, OG PNG, search API
  • IBEX_DOCS_URL env override for preview vs production

See MASTER_BRIEF Part D (D.5.2) for full acceptance detail.


Files Affected

File PathActionNotes
infra/scripts/verify_phase15.shAddPhase 1.5 smoke script

Testing Requirements

  • test_script_root_redirect: Script passes redirect check against localhost
  • test_script_key_pages_200: All listed paths return 200
  • test_script_404_status: Unknown path returns 404 not 200
  • test_script_og_image: OG route returns image/png
  • test_script_search_api: /api/search?query=auth succeeds

Acceptance Criteria

  • Script exits 0 against local dev server
  • Script exits 0 against Vercel preview URL

Risks

RiskProbabilityImpactMitigation
curl differences on Windows Git BashMediumMediumDocument WSL/macOS/Linux; CI runs on ubuntu
Search API absent until D.2.5LowHighMerge after D.2.5 or guard search check
Script drift when routes renameMediumMediumCentralize path list; update with D.3.1 changes
Edit on GitHub

Last updated on

On this page

0%