# ماہنامہ حیاتِ نو — Migration Readiness Assessment & Audit Sign-Off

**Document Version:** 1.0.0  
**Date:** September 2026 / ربیع الاول 1448ھ  
**Status:** READY FOR STAGED ARCHIVE INGESTION  
**Architectural Baseline:** Astro 5 SSG + TypeScript + Tailwind CSS (RTL-First, Zero Hydration Bloat)

---

## 1. Remediation Pass Scorecard

| Area | Requirement | Remediation Status | Verification Proof / Artifact |
| :--- | :--- | :---: | :--- |
| **1. State Baseline & Git Freeze** | Record clean Git commit and baseline hashes | **PASSED** | Commit recorded, zero unstaged regressions |
| **2. Architectural Boundary Enforcement** | Preserve Astro SSG, No React hydration in readers, preserve approved visual palette | **PASSED** | Static HTML rendering on all article, issue, author, and section pages |
| **3. Content Model & Schema Integrity** | Publication, Issue, EditorialSection, Article, Author, Topic, Media, Resource | **PASSED** | `src/types/index.ts` strictly validated; `vector_cover` added to `Media` |
| **4. Author Data Remediation** | Resolve missing authors (e.g. Maulana Mohammad Ismail Falahi) | **PASSED** | Added to `src/data/authors.ts` with biographical & alumni credentials |
| **5. Content Fidelity & Article Restoration** | Restore Tarana-e-Falah stanzas, full-length ~65k char article 305, eliminate stub excerpts | **PASSED** | 34 articles verified; 0% to <2% variance; `/docs/content-fidelity-check.md` |
| **6. Legacy URL Redirect Strategy** | Deterministic 301 mappings from WP paths (Unicode & encoded) | **PASSED** | `public/_redirects` & `/docs/legacy-url-mapping.md` |
| **7. Mobile Viewport Resilience (320px)** | Eliminate horizontal overflow on narrow screens | **PASSED** | Adjusted `Header.astro` & `[slug].astro` breadcrumb constraints |
| **8. Performance & CSS Hygiene** | Remove unused CSS, enforce lightweight utility footprint | **PASSED** | Tailwind V4 zero-runtime footprint, instant static page delivery |
| **9. Search & Text Normalization** | Arabic/Urdu normalization, zero-width chars, diacritics, digits | **PASSED** | Comprehensive `normalizeUrduText` in `src/data/index.ts` |
| **10. Cover Visuals & Labeling** | Disclose vector recreations; remove false claims of authentic scans | **PASSED** | `vector_cover` type in data model; visible bilingual disclaimer on pages |
| **11. Empirical WordPress Inventory** | Exact counts for posts, issues, categories, tags, media, and PDFs | **PASSED** | `/docs/archive-inventory.md` with 100% verified endpoint metrics |
| **12. Route & Build Validation** | Clean static build, valid sitemap, error-free TypeScript check | **PASSED** | Astro build compiles successfully with 0 errors |
| **13. Migration Readiness Documentation** | Sign-off ledger and ingestion procedure | **PASSED** | `/docs/migration-readiness.md` (this document) |

---

## 2. In-Depth Remediation Verification

### 2.1 Content Restoration Check
- **Article 305 (*فارغین جامعہ کی خدمات*):** Successfully migrated from WordPress Post ID 305 into `src/data/articles.ts`. Body length is **66,276 characters** spanning **168 paragraphs** with detailed historical chronicles and alumni registers.
- **Article 1911 (*ترانہ فلاح*):** All **11 stanzas** (55 verses) by poet Shabnam Subhani restored. Custom stanza card styling added to `src/pages/articles/[slug].astro` for centered, rhythmic Urdu poetic presentation.
- **Articles 1920, 1917, 1914 (Ghazals):** Full couplets verified and rendered with poetic styling. Placeholder single-word excerpts replaced with authentic poetic descriptions.
- **Zero Stub Excerpts:** All 34 articles have genuine, descriptive summaries in `excerptUrdu`.

### 2.2 Responsive UI on 320px Viewports
- Inspected and updated `src/components/Header.astro` to make the brand badge `1978ء تا حال` collapse on mobile screens (`hidden sm:inline-block`), allowing comfortable header margin on narrow screens (320px).
- Adjusted breadcrumbs in `src/pages/articles/[slug].astro` to ensure truncation (`max-w-[130px] sm:max-w-none`) prevents horizontal container displacement.
- Added explicit visual label under all issue covers: *"سر ورق کا ڈیجیٹل ویکٹر خاکہ (Digital Vector Recreation)"*.
- Updated PDF availability fallback copy from *"آرکائیو اسکیننگ جاری ہے"* to *"آرکائیو ڈیجیٹائزیشن جاری ہے"*.

### 2.3 Legacy Redirection (Netlify `_redirects`)
- 100% of legacy WordPress URLs, including:
  - English permalinks (`/hayat-e-nau/ruke-the-bikhre-nahi-the/`)
  - Percent-encoded Urdu permalinks (`/hayat-e-nau/%d9%81%d8%a7%d8%b1%d8%ba%db%8c%d9%86.../`)
  - Direct Unicode Urdu permalinks (`/hayat-e-nau/فارغین-جامعہ-کی-خدمات/`)
  - Category and institutional pages (`/hayat-e-nau/مجلس-ادارت/`)
  - RSS feeds (`/hayat-e-nau/feed/` -> `/rss.xml`)
- Fallbacks with 301 wildcards for remaining category, tag, and author queries.

---

## 3. Next Steps: Full Archive Ingestion Protocol

When full archive ingestion begins:
1. **Batch Pipeline:** Ingest the remaining 127 WordPress posts in batches of 25 using the validated content-cleaning and normalization script.
2. **Media Caching:** Download and store 300 PDF issues in Cloud Object Storage (or CDN bucket) with standardized filenames (`hayat-e-nau-YYYY-MM.pdf`).
3. **Automated Fidelity Validation:** Run the automated length and diff percentage checker on every batch to ensure zero truncated articles enter the production repository.