227 lines
14 KiB
Markdown
227 lines
14 KiB
Markdown
# AIA Astro Migration — Living Session Handoff
|
||
|
||
**Last updated:** October 14, 2026 (UTC)
|
||
**Repository:** `AIAMarketing/azinstitute4autism.com`
|
||
**Working branch:** `faithful-astro-migration`
|
||
**Last accepted technical implementation:** Phase 7 — Multilingual Reconciliation
|
||
**Previous accepted checkpoint:** Phase 6C, signed `b5bc95bc2b8e36c58e8b4d8ab4b11391374a7883`
|
||
**Implementation checkpoint:** the commit containing this handoff update; obtain its actual SHA from Git history after the user creates the signed commit.
|
||
**Next milestone:** Phase 8 — Visual and Accessibility Acceptance; then Phase 9 Human-Decision Gates and Phase 10 Final QA/Cutover Readiness.
|
||
|
||
Phase 7 is technically accepted for checkpoint preparation. Editorial,
|
||
accessibility, stakeholder and production-release approval remain separate.
|
||
The user stages, signs and pushes from the host terminal; this handoff does not
|
||
authorize deployment or integration activation.
|
||
|
||
## Authority and checkpoint history
|
||
|
||
Read repository-root `AGENTS.md`, `MIGRATION_BRIEF.md` and `AUTONOMOUS-CODEX.md`,
|
||
then this handoff and the relevant [migration summary](migration-summary.md).
|
||
Later Phase 6A ratification controls conflicting original recommendations.
|
||
|
||
- Phase 5C Team: `34d5394b3ce765028a27b9cddd9952de3f09bfe7`.
|
||
- Phase 6A proposal: `76a035424dc5245443476b168d8c91ea62eed27b`.
|
||
- Phase 6B.1 search: `b20c253383440598c2d07bf6f852906ac00c42df`.
|
||
- Phase 6B.2 pagination: `6f5ac3c0d233cee5fbbb62be79bc6909e6bec183`.
|
||
- Phase 6B.3 author archives: `8646792d46a8a117ef617f5dd2582c2550b45d19`.
|
||
- Phase 6B.4 URL/SEO: `8192ea71c47a7163b40a7fad144ebbd2523282d1`.
|
||
- Phase 6B.5 multilingual navigation/RTL: the signed replacement checkpoint
|
||
`a699d467f19fafbfdda5fce1ce6226baa6e5fc3c`; do not use its superseded unsigned SHA.
|
||
|
||
- Phase 6C Library/multilingual parity: signed checkpoint
|
||
`b5bc95bc2b8e36c58e8b4d8ab4b11391374a7883`.
|
||
|
||
Phase 6B.5 visitor navigation remains independent of SEO hreflang. Published
|
||
locale destinations, explicit fallback notices, native language disclosure,
|
||
Arabic contact bidi isolation and the two-line shared address remain intact.
|
||
`/ar` remains unpublished with an explicit English-home fallback.
|
||
ContactObfuscation is unchanged; reversed no-JavaScript strings are intentional.
|
||
The earlier Phase 6B.5 manual acceptance does not cover subsequent Phase 6C work.
|
||
|
||
## Completed Phase 6C technical sequence
|
||
|
||
- **6C:** restored nine missing English articles and source-backed self-hosted
|
||
media; derived English Library and author page 6 from the catalog.
|
||
- **6C.1:** restored source-supported Halloween contextual links in English
|
||
self-advocacy and AAC articles.
|
||
- **6C.2:** reconciled three materially outdated English articles and current
|
||
published Spanish school readiness; replaced the obsolete Arabic
|
||
antecedent/consequence body with a complete translation; audited all 19
|
||
established translation relationships.
|
||
- **6C.3:** reconciled featured-image alternatives, source-supported headings,
|
||
truncated descriptions and supported modification dates; retained the new
|
||
Arabic guide's intentional modification-date omission; localized three diagrams.
|
||
- **6C.4:** reconciled contextual and external links, previous/next/related
|
||
relationships, image links and fragments; added localized self-advocacy
|
||
Halloween references while preserving the landing-page ownership gate.
|
||
- **6C.5:** audited all 74 articles, corrected narrow structural/accessibility
|
||
regressions, and verified metadata, links, FAQs, translation relationships,
|
||
pagination, search and publication policies. Technical readiness has
|
||
documented nontechnical release gates.
|
||
|
||
Detailed evidence and reviewer checklists are in the
|
||
[final acceptance report](phase-6c5-final-library-acceptance-2026-10-13.md).
|
||
The [checkpoint manifest](phase-6c5-checkpoint-manifest-2026-10-13.md) lists 148
|
||
implementation/evidence paths; that checkpoint included its handoff as path 149.
|
||
Historical phase records retain their original context.
|
||
|
||
## Completed Phase 7 technical sequence
|
||
|
||
- Recovered Spanish privacy policy with February 19, 2025 revision date,
|
||
localized metadata and reciprocal English/Spanish policy navigation.
|
||
- Localized actual Spanish form labels, options, instructions, disabled notices
|
||
and Contact map text using explicitly passed publication locale; no backend enabled.
|
||
- Translated the Spanish reinforcement tip without changing article identity,
|
||
dates or surrounding content; fluent/clinical approval remains pending.
|
||
- Localized Spanish/Arabic author headings and isolated Arabic BCBA/LBA text;
|
||
biographies, identities and archive SEO unchanged.
|
||
- Prepared the [nonproduction verification plan](phase-7-nonproduction-verification-plan-2026-10-14.md)
|
||
and [Phase 9 decision register](phase-9-decision-register-2026-10-14.md).
|
||
P9-01 through P9-10 all remain **Pending decision**.
|
||
|
||
See the [Phase 7 reconciliation report](phase-7-multilingual-reconciliation-2026-10-14.md)
|
||
and [checkpoint manifest](phase-7-checkpoint-manifest-2026-10-14.md).
|
||
The non-Library matrix excludes all three Library-root content records:
|
||
20 EN / 8 ES / 1 unpublished AR draft → 20 EN / 9 ES / 1 unpublished AR draft;
|
||
28 → 29 eligible pages and 8 → 9 English–Spanish pairs. The final matrix has
|
||
30 records including the draft. Whole pages-collection counts (including roots)
|
||
are 21/9/2 → 21/10/2, with 9 → 10 English–Spanish pairs. Do not mix populations.
|
||
|
||
## Verified technical baseline
|
||
|
||
| Metric | Result |
|
||
|---|---:|
|
||
| Library articles / locale search records | 55 EN / 12 ES / 7 AR = 74 |
|
||
| Generated HTML routes / unique canonical targets | 122 / 122 |
|
||
| Author archive routes | 9 |
|
||
| Indexing-enabled sitemap URLs | 108 |
|
||
| Hreflang links / participating routes | 180 / 55 |
|
||
| Validated page/article translation sets | 25 |
|
||
| Repository redirect definitions | 9, not activated on deployed hosts |
|
||
| Visible/schema-aligned FAQ answers / articles | 182 / 30 |
|
||
|
||
English Library and author pagination is `10/10/10/10/10/5`; Spanish is `10/2`,
|
||
Arabic is one seven-article root. Page 6 is derived, with no page 7 or page-one
|
||
HTML alias. Search remains locale-scoped, metadata-only and demand-loaded.
|
||
Publication ordering uses original dates, not modification dates. Existing
|
||
syndicated external-canonical/noindex exceptions remain unchanged.
|
||
|
||
Normal staging output is **122 `noindex,nofollow` HTML pages, an empty sitemap
|
||
and no hreflang**. Indexing-enabled validation is local only. No deployment,
|
||
redirect activation, form submission or production integration is authorized.
|
||
|
||
Final source-matching offline evidence is
|
||
[the Phase 7 reconciliation](route-reconciliation-2026-10-14-offline.json):
|
||
133 dispositions, 70 historical production requests, schema 2. Its source
|
||
fingerprint is `59753ffefd162f9110e05acea73e20147a7fc8286af132ea7b8e1748de180901`.
|
||
Use the explicit evidence path for read-only checks; do not select an excluded
|
||
intermediate automatically or recrawl production to refresh a timestamp.
|
||
|
||
The historical Phase 6C.5 parity classifications were 10 confirmed, 58 with accepted intentional
|
||
deviations, one minor discrepancy, five requiring human review, zero material
|
||
discrepancies and zero insufficient-verification records against the selected
|
||
evidence. Findings rely on dated, sometimes cached/prerendered public HubSpot
|
||
representations; they do not establish independent current origin freshness.
|
||
The newer Arabic antecedent/consequence translation intentionally supersedes
|
||
its outdated public Arabic body. Machine-assisted work is not professional approval.
|
||
|
||
Phase 7 checkpoint preparation revalidation on October 14 passed sequentially with
|
||
`TMPDIR=/tmp`: Astro check (92 files, zero diagnostics), Markdown 20,
|
||
publication 33, SEO 35, Library 49 and route 10 tests; both build modes;
|
||
link/image/blog audits with zero failures; explicit offline consistency check;
|
||
and `git diff --check`. The last build restores normal staging safeguards.
|
||
Git identity/signing remains the user’s host-terminal responsibility.
|
||
|
||
## Outstanding Stakeholder Review and Production Release Gates
|
||
|
||
- **Clinical/organizational — AIA:** approve eligibility and program-specific
|
||
ranges against general ABA eligibility of **18 months through eight years**;
|
||
resolve the summer-routine age discrepancy. Review Preparatory Academy ages
|
||
2–6 and 1:2 delivery ratio, ABA versus education, Arizona educational guidance,
|
||
functional assessment, behavior intervention, reinforcement, extinction,
|
||
aggression, self-injury, safety, treatment/outcome claims and author roles,
|
||
credentials and biographies, including Arabic physician-like wording versus
|
||
English “clinician.” Source publication alone is not clinical approval.
|
||
- **Fluent Spanish/Arabic and clinical review:** revised Spanish school readiness,
|
||
rewritten Arabic antecedent/consequence guidance and terminology, all three
|
||
localized Arabic diagrams, localized self-advocacy Halloween additions,
|
||
operational labels and cross-language notices remain pending.
|
||
- **Spanish tip review:** Phase 7 corrected the English tip at
|
||
`/es/library/positive-reinforcement-techniques`. Its fluent-Spanish and
|
||
clinical/editorial acceptance remains open; historical Phase 6C findings remain intact.
|
||
- **Privacy/legal and trusted-source approval — P9-07:** both policy claims need
|
||
AIA privacy/legal approval. Spanish privacy was recovered from a cache-qualified
|
||
response after standard TLS certificate validation failed; fallback disabled
|
||
certificate verification. Matching captured text does not prove authenticated
|
||
origin fidelity. Before production, compare against a certificate-validated
|
||
source or owner-supplied authoritative export with provenance; no trusted
|
||
comparison is available yet. Fluent Spanish approval remains mandatory.
|
||
Do not repeat insecure retrieval or rewrite policies to hide this limitation.
|
||
- **Browser/accessibility:** desktop and approximately 390px mobile, keyboard
|
||
focus, JavaScript-disabled browsing, RTL reading order and diagram scrolling,
|
||
Arabic visual-language acceptance and a real screen-reader session remain
|
||
required. Autonomous browser attempts failed. SVG raster inspection and
|
||
generated HTML checks do not constitute browser or assistive-technology acceptance.
|
||
- **Landing-page ownership — Phase 9 owner gate:** the public
|
||
`/lp/early-intervention` CTA from `/library/how-many-hours-aba-child-need` is
|
||
provisionally `/client-consultation` locally. These are not approved equivalents.
|
||
Do not import the separate landing-pages repository, create a redirect or
|
||
activate a form without explicit authorization.
|
||
- **Employee portal — P9-02:** staff/management access separation, authentication,
|
||
authorization and employee/clinical data security remain unresolved; current
|
||
metadata-only route is not a completed portal. See the
|
||
[portal brief](employee-portal-migration-brief-2026-10-08.md).
|
||
- **Likes/views API — P9-04:** production fallback outside localhost includes
|
||
credentialed stats requests and interaction writes. Empty configuration/noindex
|
||
do not isolate it. Hosted review requires separately authorized fail-closed
|
||
isolation and evidence of zero production API traffic.
|
||
- **Author SEO:** keep archives self-canonical, `noindex,follow` in indexing-enabled
|
||
builds, sitemap-excluded and hreflang-excluded. Changes require explicit approval.
|
||
- **Forms/privacy/analytics/advertising:** approve form destinations and submission
|
||
APIs, HIPAA/privacy safeguards, consent/analytics, Google Ads conversion tracking
|
||
and each production integration's activation. No new PHI flow is authorized.
|
||
- **Hosting/release:** separately verify Contabo/NixOS deployment assumptions,
|
||
HTTPS, canonical host, slashless URLs, query preservation, redirect targets and
|
||
loops, real 404 responses, asset delivery, sitemap/robots, reproducible deployment,
|
||
rollback and organizational release approval. The temporary Docker/nginx
|
||
trailing-slash HTTPS-to-HTTP-to-HTTPS chain remains explicitly deferred.
|
||
Static-build success does not verify these deployed behaviors.
|
||
|
||
## Next: Phase 8 — Visual and Accessibility Acceptance
|
||
|
||
Begin from the signed Phase 7 SHA the user supplies; verify branch, history and
|
||
working tree. Use the [verification plan](phase-7-nonproduction-verification-plan-2026-10-14.md)
|
||
for full-page 1440px/approximately 390px review, keyboard/focus, no-JavaScript,
|
||
Spanish forms/privacy, language fallback/navigation, Arabic RTL/diagrams and
|
||
real screen-reader sessions. Record reviewer, date, device, evidence and failures.
|
||
Use an approved local environment first with synthetic data and controlled
|
||
network requests. Do not deploy a hosted preview before API isolation and
|
||
appropriate authorization. No Phase 8 acceptance is implied by this checkpoint.
|
||
|
||
Phase 9 keeps all ten stakeholder decisions pending, including portal/landing
|
||
ownership, form/API/privacy, analytics/advertising, clinical claims, policy
|
||
provenance, author SEO, hosting and launch authorization. Phase 10 covers final
|
||
QA/cutover readiness. Neither a browser pass nor technical translation approval
|
||
clears production gates. Do not renumber the roadmap or begin production changes.
|
||
|
||
## Working protocol and protected local files
|
||
|
||
Preserve the Markdown-first manifest-driven architecture, explicit translation
|
||
relationships and ratified publication policies. Implement only authorized scope;
|
||
report evidence and structural diffs before the user stages or commits. Follow
|
||
`AUTONOMOUS-CODEX.md`; do not repair identity/signing or bypass sandbox restrictions.
|
||
|
||
Do not read, modify, move, delete, stage or checksum root `merge-plan.md`.
|
||
Preserve and exclude these four superseded reconciliation reports without
|
||
reading or modifying their contents:
|
||
|
||
- `www/reports/route-reconciliation-2026-10-11-offline.json`
|
||
- `www/reports/route-reconciliation-2026-10-12-offline.json`
|
||
- `www/reports/route-reconciliation-2026-10-13-offline.json`
|
||
- `www/reports/route-reconciliation-2026-10-13-offline-06-16-06-857Z.json`
|
||
|
||
Exclude root `merge-plan.md` and temporary `.phase7-stage-paths.nul` as well.
|
||
The staging aid is for the user's host terminal only; never stage it or use a
|
||
broad Git add. The actual future checkpoint SHA comes from Git after the user
|
||
signs; do not amend merely to insert it here.
|