Skip to content

fix: Portfolio Architecture V2 production audit - #19

Merged
UAJOP merged 4 commits into
mainfrom
fix/portfolio-v2-production-audit
Aug 22, 2026
Merged

fix: Portfolio Architecture V2 production audit#19
UAJOP merged 4 commits into
mainfrom
fix/portfolio-v2-production-audit

Conversation

@UAJOP

@UAJOP UAJOP commented Aug 22, 2026

Copy link
Copy Markdown
Owner

Post-merge audit of Portfolio Architecture V2 (0eec7c8). Audited the bootloader, both boot paths, Recruiter Mode V2, Ajoop, the Evidence Explorer, i18n, the dynamic archive route, request flow, responsive behaviour and performance — then fixed the defects found and added regression guards.

Headline result

The V2 architecture itself is healthy. Across 18 pages there were 0 JS errors, 0 duplicate runtime loads, 0 broken assets and correct boot order on both the migrated path and the legacy script.js-only path. The bugs found were narrower than the architecture.

Fixes

Sev Issue Root cause
P1 "Open 3D Math Lab" silently did nothing on 18/19 pages V2 moved the lab to labs.html, but the palette entry stayed type:"scroll" against a same-page id; executeCommand resolves it with getElementById()?. so it no-ops. Now navigates to the registry URL.
P1 Evidence Explorer dropped keyboard focus to <body> Scenario switch replaces root.innerHTML, destroying the focused toggle. Recruiter V2 already restored focus; the explorer didn't. Mirrored that behaviour.
P2 Explorer duplicated product truth + was half-English in TR Labels were hardcoded despite portfolio-data.js owning sinamaEvidence.*.label, and shipped identical EN/TR ternaries. Labels now come from the registry; descriptive strings and speaker names are bilingual.
P2 Bare /project-detail.html rendered an arbitrary project params.get("project") || "drivenfinity" bypassed the existing not-found state.

Performance: no V2 regression

Local Lighthouse showed ~62-70 vs the ~94 baseline, so I isolated it:

Variant Perf FCP
index as-is 62 3.0 s
third-party CDN CSS removed 92 0.6 s
entire V2 runtime removed 67 2.2 s

Render-blocking is 4 CSS files, zero JS; the whole boot chain is ~59 ms. The gap is pre-existing Google Fonts + unpkg Boxicons latency, not V2. Left unchanged — see the follow-ups in the report.

Regression guards

qa-portfolio-consistency.js gains coverage for duplicate runtime loads, portfolio-data → script → portfolio-v2 boot order, direct legacy-script.js declarations, unpaired data-pv2 copy, the hardcoded slug, same-page scroll commands to relocated sections, a missing Labs anchor, and Evidence Explorer drift. Each was verified to fail when its regression is reintroduced, then restored.

Verification

qa:portfolio pass · qa:html 0 errors (67 pre-existing warnings) · qa:spelling 0 · pa11y-ci 11/11 · JS syntax 14/14 · links 0 broken (439 refs, 17 role deep links, 10 project slugs all resolve) · 72 viewport×page overflow checks clean at 1440/1366/768/390/360/844×390.

No merge. Draft for review.

🤖 Generated with Claude Code

UAJOP and others added 4 commits August 22, 2026 14:27
The Algorithmic 3D Lab section moved to labs.html in V2, but the
Command Palette entry still used type:"scroll" against a same-page id.
executeCommand resolves scroll targets with getElementById()?., so the
command silently no-opped on every page except labs.html. Point it at
the registry URL labs.html#algorithmic-3d-lab instead.

project-detail.html also defaulted a missing ?project= parameter to a
hardcoded "drivenfinity" slug, so the bare URL rendered an arbitrary
archive project instead of the existing not-found state.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…stry

Switching the SINAMA scenario replaced root.innerHTML, destroying the
focused toggle and dropping keyboard focus to <body>. Recruiter Mode V2
already restores focus after re-render; mirror that behaviour here.

The explorer also hardcoded scenario labels that portfolio-data.js
already owns (sinamaEvidence.*.label), and shipped identical EN/TR
ternaries so TR users saw English section labels. Read labels from the
registry, translate the descriptive ones, and make conversation speaker
names bilingual in the registry.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Adds regression coverage for the failure classes found in this audit:
duplicate runtime loads, broken portfolio-data -> script -> portfolio-v2
boot order, direct legacy-script.js declarations, unpaired data-pv2
copy, the hardcoded project-detail slug, same-page scroll commands to
relocated sections, a missing Labs anchor target, and Evidence Explorer
truth drifting out of the registry.

Each guard was verified to fail when its regression is reintroduced.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Running the documented npm run qa:lighthouse writes .lighthouseci/
reports into the repo root. Keep that generated output untracked.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@UAJOP
UAJOP marked this pull request as ready for review August 22, 2026 11:56
@UAJOP
UAJOP merged commit 7ae5cb7 into main Aug 22, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant