plan/react-rewrite #1

2026-04-15T12:21:03+03:00

gnezim commented

2026-04-15 12:21:03 +03:00

No description provided.

gnezim added 138 commits 2026-04-15 12:21:04 +03:00

Add .nvmrc file and update package.json with main, keywords, license, and description fields b4a41cc801

Add design spec for Angular-to-React MF remote rewrite 75dbec0737

Captures the dual-mode Modern.js architecture, strangler-fig phasing,
parity contracts, and customer-requirement mapping so implementation
plans can be derived per phase without re-litigating architectural
decisions.

Add Phase 0 (Preflight) implementation plan 013fad6236

16 tasks covering URL corpus extraction, SEO + hreflang + VRT baseline
capture from Angular prod, PrimeNG/SCSS/i18n inventories, and the
customer confirmation checklist. Phase 0 is discovery-only; no
production change. Output is the fixture + inventory set Phase 1
sub-plans consume.

Add Phase 1 Foundation MASTER plan 4ba4159723

Index of 10 sub-plans (1A-1J) with dependency graph, exported contracts
between sub-plans, shared-file ownership table, spec-coverage matrix,
and global exit gate. Each sub-plan gets its own TDD-granular plan
document written on demand via the writing-plans skill.

Allow autonomous commits in Claude Code workflow f41656ce5f

Review and planning iterations commit frequently; asking for permission
on each commit added friction without safety benefit. Destructive git
operations still require explicit approval.

Revise Phase 1 master plan with 25 review decisions 03bab8d7f8

Scope: defer 1J parity harnesses to Phase 2 (design against real
feature); split 1A, 1F, 1G into smaller sub-plans; split Phase 0 gate
into hard blockers vs stub-allowed; add A9 for Node 24 availability.

Contracts: fix three-cache model (lru-cache v10 for byte-capped server
LRU), add undici RetryAgent retry config, generic useLiveFlights, CSP
nonce stream transform workaround for React #24883, type-only Logger
extraction to break HostContract plan cycle, error-to-HTTP mapper,
RemoteLoader for consuming other customer remotes, JsonLdRenderer.

Requirements: add runbook, responsive baseline assertions, A4-trigger
log format swap task, rename-pass rework rule, analytics stub sink.

Swap server LRU cache to lru-cache v10 for byte-based cap f309f62553

@isaacs/ttlcache has no byte cap (only count). A 100MB hard limit needs
lru-cache v10's maxSize + sizeCalculation. Aligns design spec with
Phase 1 master plan contract revision.

Add Phase 1A-1 project skeleton implementation plan 59a94b50b9

TDD-granular plan with 12 tasks covering Node 24 pinning, TypeScript
strict config, baseline ESLint, Vitest setup, type-only seeds for
HostContract plan-cycle resolution, Zod-validated env reader, frozen
feature/UI barrels, and the A1 rename-pass rework stub.

Pin Node 24 and seed root package.json for Phase 1A-1 00d1c9827c

Install TypeScript, Vitest, ESLint, Zod base toolchain 064436527a

Upgrade vitest to v3 to patch transitive esbuild CVE 5cce054f36

Vitest 2 pulled Vite 5 + esbuild 0.21 (GHSA-67mh-4wv8-2f99). Bumping
vitest/@vitest/ui to v3 and adding vite ^6 as a direct dev dep forces
peer resolution onto Vite 6 + esbuild 0.25, which also clears the Vite
path-traversal advisory (GHSA-4w7w-66w2-5vf9). pnpm audit is now clean.

Tighten Node engine pin, bump pnpm, add pnpm hygiene to gitignore 7c99ab069d

Align engines.node with the .nvmrc 24.2.0 pin so npm/pnpm warn on
mismatched local toolchains, move packageManager to the current
pnpm 9.15.3 patch, and ignore pnpm's local store and debug log so
stray artefacts never get committed.

Add strict TypeScript config with @/ and @phase0/ aliases 765174b674

Add baseline ESLint config (no boundary rules yet) 4d41b46975

Configure Vitest with @/ alias and v8 coverage f7d367a315

Migrate ESLint to flat config for v9 compatibility 9c5f834334

Replaces the FlatCompat shim (which loaded .eslintrc.cjs via @eslint/eslintrc
and emitted deprecation warnings) with a native ESLint 9 flat config. Adds
typescript-eslint meta-package as the flat-config entrypoint and pins
@eslint/js to v9 to satisfy the eslint@9 peer range. Rule set is preserved
verbatim from the Phase 1A-1 plan (Task 4).

Seed type-only Logger surface for HostContract dependency 9acccffe8c

Seed type-only AnalyticsProviders for Env dependency 8a8075972d

Add HostContract interface per design spec §2.4 23db51997b

Add Zod-validated getEnv() reader with module-level cache 9c29091b58

Seed frozen public barrels for 4 features + UI adapter 0b9ea74617

Document frozen-barrel rule and A1 rename-pass rework plan 9d5898e8d5

Correct 1A-1 plan for 4 bugs found during execution 5b67aa25fa

- Task 3: dotfile placeholder (src/.typecheck-placeholder.ts) is ignored
  by TypeScript's glob; use non-dotfile name.
- Task 4: replace legacy .eslintrc.cjs with ESLint 9 flat config.
  ESLint 9 requires flat config natively; the legacy format triggers
  deprecation warnings and needs a FlatCompat shim.
- Task 9: env impl cannot unconditionally assign undefined to optional
  fields under exactOptionalPropertyTypes; build base object then
  conditionally assign the three optional URL/header fields.
- Task 12 Step 5: defer coverage check to 1B, which owns the
  @vitest/coverage-v8 dep per the master plan shared-files table.

Add Phase 1A-2 MF 2.0 + dual build targets implementation plan e200256fdc

10 tasks led by a timeboxed Modern.js + MF 2.0 spike that pins
versions and validates the dual-build approach before committing to
it. Covers module-federation.config.ts with 4 feature exposes, React
18 singleton, BUILD_TARGET branching in modern.config.ts, and a
typed loadRemoteModule wrapper around @module-federation/enhanced
runtime for consuming other customer remotes in Phase 2+.

Land Modern.js + MF 2.0 spike report with pinned versions 2eda0a675e

Install Modern.js, MF 2.0 plugin, and React 18 at pinned versions 4eede82961

Add stub root route for standalone build (replaced by 1F-layout) c41089e5c8

Seed MF expose stubs and host-entry for 4 features 2bdfde43f6

Declare MF 2.0 config with 4 feature exposes and React singleton 5881f9ed72

Add modern.config.ts with standalone/remote BUILD_TARGET branching 4fd7ae3f94

Wire build:standalone/build:remote/dev to Modern.js CLI 604ed75498

Add typed loadRemoteModule wrapper around MF runtime 826758f03d

Add Phase 1A-3 ESLint boundaries implementation plan 7bbda35041

5 tasks: install eslint-plugin-boundaries, configure layered dependency
rules matching design spec §1.2, add no-restricted-imports for OTel
SDK, react-i18next, SignalR SSR, localStorage. Each rule has a
fabricated-violation test asserting it fires.

Add eslint-plugin-boundaries with layered dependency rules f1acf7827d

Add no-restricted-imports for OTel SDK, react-i18next, SignalR SSR, localStorage e9640b17fd

Add fabricated violation tests for boundary rules 8459e1661b

Fix eslint.config.js: add import/resolver settings so boundaries plugin
can resolve .ts/.tsx imports, and merge no-restricted-imports blocks to
prevent ESLint 9 flat config from overriding earlier rule definitions.

Add fabricated violation tests for restricted import rules 050f311a60

Add Phase 1C i18n runtime implementation plan 3067f8f111

6 tasks: port 9 locale JSONs, TDD resolver with Language type, TDD
createI18nInstance factory with ICU, TDD SSR↔client hydration
serializer, I18nProvider with useTranslation re-export.

Install i18n deps and port 9 locale JSON files from Angular 33d4c94298

Add locale resolver with Language type and URL prefix parsing bf3087d45e

Add createI18nInstance factory with ICU and resource backend 1fd2788c35

Add SSR↔client i18n hydration serializer a8c648c818

Add I18nProvider with useTranslation re-export for feature code 7103b9ffb1

Add Phase 1D API client implementation plan 454fb0bdb9

7 tasks: TDD error classes, circuit breaker, three cache types
(request-scoped, client TTL, server byte-capped LRU via lru-cache),
ApiClient with retry+timeout, CachedApiClient decorator, provider.

Add typed API error classes (ApiHttpError, ApiTimeoutError, ApiNetworkError) 6ef9ce4ed7

Add circuit breaker with closed/open/half-open state machine fd62d6f123

Add three cache types (request-scoped, client TTL, server byte-capped LRU) cb5e5b0106

Add ApiClient with retry, timeout, and error mapping 65c8c8b55f

Add CachedApiClient decorator layered above ApiClient 04c5432aef

Add ApiClient React context provider with useApiClient hook 7992d2705a

Add Phase 1G-logger runtime implementation plan c095fad7ad

6 tasks: TDD LoggerImpl, ConsoleTransport, JsonLinesHttpTransport
with batching/backpressure/redaction, createRootLogger factory with
env-based transport selection, LoggerProvider React context.

Add LoggerImpl with transport dispatch and child context propagation 1a40686490

Add dev-mode ConsoleTransport for logger 98414ee4af

Add JsonLinesHttpTransport with batching, backpressure, and redaction 9a1b4bace1

Add createRootLogger factory with transport selection by env 498d049acd

Add LoggerProvider React context with useLogger hook dfa9e0283d

Add implementation plans for 1G-metrics, 1G-analytics, and 1F-seo 8e7adef5e3

Add OpenTelemetry and web-vitals dependencies for metrics pipeline ddedddd15d

Add OTel server/browser initializers with getMeter/getTracer accessors 2dc1a1f194

Add 8 custom metric instruments using OTel proxy meter 0b25a1a9e7

Add test-observable analytics event sink e95781a069

Add four stub analytics adapters (metrica, ctm, variocube, dynatrace) fe31bbfb65

Add analytics facade with adapter fan-out and consent gating 515151ed81

Add AnalyticsLoader component with idle-callback initialization 8878dcb6c8

Add useAnalytics hook with server-safe NoopAnalytics fallback 6a4be07911

Add schema-dts dependency for typed JSON-LD generation ad9b35f725

Add buildHreflangSet for 9 languages + x-default 8abe8acf70

Add JsonLdRenderer and serializeJsonLd with schema-dts typing 599f35f14a

Add SeoHead component with canonical, hreflang, OG, Twitter, and JSON-LD bb50e63866

Add 1F-layout implementation plan for root layout, error routes, smoke route 1409df458b

Add ErrorBoundary class component with retry support 2eb118cb8b

Add errorToResponse mapper with TDD tests covering all mapping rules fc57556010

Wire root layout provider stack and locale-scoped layout with i18n 858b8e1d1f

Root layout wraps children with LoggerProvider, ApiClientProvider, and
ErrorBoundary. Locale layout validates lang param against 9 supported
languages and provides a request-scoped I18nProvider.

Add error pages for 404, 500, 503 codes 6d3e3ae986

Add smoke route exercising logger, i18n, and locale display b6da51fce5

Add Phase 1E SignalR wrapper implementation plan b431010241

Add @microsoft/signalr dependency for live flight data b6a007d3b6

Add SignalRConnection ref-counted wrapper with tests 7052052742

Reference-counted connection management with grace period,
dynamic import to keep @microsoft/signalr out of SSR bundle,
and singleton sharing via getSharedConnection.

Add useLiveFlights SSR-safe hook with tests 4c52bb4032

Generic hook wrapping SignalR subscription with SSR guard
(typeof window check). Includes tests for subscribe, data
updates, cleanup, and SSR path.

Fix lint warnings in SignalR wrapper and hook tests ebe6c38713

Remove unused imports, eliminate non-null assertions,
drop invalid eslint-disable comment for missing rule.

Add Phase 1H security hardening implementation plan 726db20f89

Implement safe storage abstraction with Zod validation and namespace prefix 2742568a85

Implement CSP middleware with per-request nonce and React context 10b97339bf

Implement SSR stream nonce injection as workaround for React #24883 4f93d0a9bf

Implement security headers middleware for HSTS, COOP, CORP, and more 5d041cc4c6

Fix lint: exempt storage test from no-restricted-globals, remove non-null assertion 59d5a7314e

Add Phase 1I (Deploy pipeline + runbook) implementation plan 0f4180de14

Add Dockerfile.react and Dockerfile.remote for React build targets 9b1fb7388f

Standalone SSR image (Node 24 slim) and remote MF static image (nginx alpine),
coexisting with legacy ASP.NET Dockerfile.

Add deploy workflow template for CI/CD pipeline 8c8b8b985e

Stub workflow triggered on push to main: build, test, Docker image build.
Registry URLs and deployment targets are placeholders pending customer config.

Add health endpoint factory with TDD f0e540aa3f

healthMiddleware returns 200 if upstream was reachable within 60s, 503 otherwise.
Exports a factory function — registration in modern.config.ts is a future step.

Add graceful shutdown handler with TDD ca6ae0eea2

registerGracefulShutdown drains in-flight requests for 30s on SIGTERM,
flushes logs, then exits cleanly. Force-exits with code 1 on timeout.

Add operational runbook covering incident response and failure playbooks 56cc9e1af2

Covers incident decision tree, canary rollout, rollback procedures,
health-check interpretation, log query cookbook, and 6 known-failure
playbooks per master plan requirements.

Fix type errors and lint warnings in health and shutdown modules 7db39cbeec

Use proper type-safe interfaces instead of Node.js http types for the
health handler, and avoid vi.spyOn type issues in shutdown tests by
directly intercepting process.on.

Add Phase 2 Online Board master plan with 8 sub-plans bd9cc92766

Add Phase 2A UI adapter implementation plan fc03c08278

Covers data model types, datetime utilities, dictionary hook,
and flight display components for the online board feature.

Add data model types, datetime utils, and dictionary hook b3ab73253d

Port Angular flight types (ISimpleFlight, IFlightLeg, ITimesSet, etc.)
to minimal React-friendly interfaces. Add formatDuration/formatTime/
formatDate/isDayChange as pure functions. Stub useCityName hook as
passthrough pending customer dictionary API endpoint.

Add flight display components and barrel exports 7d8cb63600

StationDisplay, TimeGroup, FlightStatus, DurationDisplay compose into
FlightCard; FlightList renders a list of cards with skeleton loading.
All components are props-driven with no data fetching.

Add Phase 2B URL serializer implementation plan 73d724f76a

TDD plan for porting Angular OnlineBoardUrlBuilder/Parser to pure
TypeScript functions covering all 6 URL types (start, flight, departure,
arrival, route, details) with roundtrip and edge case tests.

Implement Phase 2B URL serializer with TDD (73 tests) 9e08057704

Pure TypeScript port of Angular OnlineBoardUrlBuilder/Parser covering
all 6 URL types (start, flight, departure, arrival, route, details).
Includes roundtrip parity tests and edge cases for suffixed flights,
variable-length flight numbers, time ranges, and 3-char carriers.

Add Phase 2C: Online Board API functions and React hooks 8218dffcd9

Pure API functions (searchFlights, getFlightDetails, getCalendarDays)
with dependency-injected ApiClient, plus three thin React hooks
(useOnlineBoard, useFlightDetails, useCalendarDays) for search,
details, and calendar pages. 17 TDD tests for API layer covering
URL construction, response mapping, and error handling.

Add Phase 2D SignalR wiring implementation plan 3bed4f9173

Wire useLiveFlights to TrackerHub channels for Online Board (Phase 2D) c6c0ce2bfc

Two thin composition hooks that connect the generic SignalR hook (1E)
to board-specific channels: useLiveBoardSearch for search pages
(SubscribeDate channel) and useLiveFlightDetails for the details page
(Subscribe channel). Both are SSR-safe and client-only.

Add Phase 2E routes implementation plan 98971cab26

Covers 6 route pages, 3 feature components, barrel updates, and MF expose.

Add feature components for online board pages 80b9090ef9

OnlineBoardSearchPage (shared by all 4 search routes),
OnlineBoardStartPage (search form landing), and
OnlineBoardDetailsPage (flight detail view with legs).
All wired to existing hooks from 2C/2D. 21 tests passing.

Add 6 online board route pages cd07542dc5

Start page, flight/departure/arrival/route search pages,
and flight details page. Each route is thin: parses URL
params, lazy-loads the feature component with Suspense.

Update barrel exports and MF expose for 2E route pages 6788f609e6

- Feature barrel now exports OnlineBoardStartPage, OnlineBoardSearchPage,
  OnlineBoardDetailsPage
- MF expose renders start page via React.lazy + Suspense
- Fix exactOptionalPropertyTypes issues with suffix param
- Remove unused import

Add Phase 2F SEO builders with EN locale translations c68d53dfa6

SEO builder pure functions for all 6 Online Board route types,
each returning SeoHeadProps with title, description, canonical,
hreflang, OG, and Twitter card. Populated empty EN locale SEO
keys with English translations matching the Russian pattern.

Add Phase 2F JSON-LD builders for Flight and ItemList schemas 44ae7f1642

TDD-driven schema.org JSON-LD builders using schema-dts types.
buildFlightJsonLd maps ISimpleFlight to Flight schema with
airports, times, and provider. buildFlightListJsonLd wraps
search results as an ItemList of ListItems.

Wire SEO and JSON-LD into all 6 Online Board route pages e20686b11f

Each route page now renders <SeoHead> with title, description,
canonical, hreflang, OG, and Twitter card from the SEO builders.
Search pages render <JsonLdRenderer> with ItemList of Flight
schemas. Details page renders Flight JSON-LD. Barrel exports
updated with 2F SEO and JSON-LD functions.

Add Phase 2G parity harness implementation plan 1e9523088b

Defines tasks for URL parity harness (table-driven + fast-check fuzz),
SEO parity harness, and Online Board registration against both.

Add URL and SEO parity harnesses with fast-check fuzz testing 9bd3697a17

Generic URL parity harness (table-driven + property-based roundtrip)
and SEO parity harness (shape/completeness validation) registered for
Online Board. 170 tests covering all 6 route types with 200-iteration
fast-check fuzz runs ensuring no serialization asymmetry.

Add Phase 2H integration test plan 728193e8b0

Defines scope, test inventory, mocking strategy, and exit criteria
for component-level integration tests of the Online Board feature.

Configure vitest and TypeScript for integration test files 5bcf23ee4e

Install @testing-library/jest-dom, add tests/**/*.test.tsx to vitest
include and tsconfig include patterns.

Add 60 integration tests for Online Board feature 008bc3339c

6 test files covering start page, flight search, flight details,
URL round-tripping, error handling, and SEO output verification.
All tests use mocked API and SignalR layers with jsdom environment.

Fix type error in flight-details integration test 969281c71a

Use ISimpleFlight union type for setupWithFlight parameter to accept
both IDirectFlight and IMultiLegFlight fixtures.

Add Phase 3 (Schedule) master plan and 3A sub-plan f7813b04b1

Implement schedule URL serializer/parser with TDD (Phase 3A) 1c5e85ea8e

Covers one-way search, round-trip search, multi-flight details (catch-all),
and airport-code-interleaved details format. Reuses online-board's flight
param parser for individual flight segments.

Add schedule API functions and React hooks (Phase 3B) 7ad61554cb

POST schedule/1 for search, GET schedule/details with indexed query
params, GET days/.../schedule/v1 for calendar. Three hooks wrap the
API functions with loading/error state management.

Add schedule route pages and feature components (Phase 3C) a072cd3bd2

Four Modern.js routes: start page, one-way search, round-trip search,
and catch-all multi-flight details. Components wire hooks for data
fetching and render flight results with calendar navigation.

Add schedule SEO and JSON-LD tests (Phase 3D) 93f49cddae

Tests cover start page, search, and details SEO builders plus
Flight/ItemList JSON-LD schema generation for schedule pages.

Add schedule parity harness, integration tests, barrel, and MF expose (Phase 3E) c67686463a

Registers schedule URL serializer in parity harness with 18-entry fixture
corpus and fast-check fuzz. 10 URL round-trip integration tests, 6 SEO/
JSON-LD integration tests. Updates barrel and MF expose from stub to real.

Fix lint issues in schedule feature code 6703c5a2f2

Add flights-map types, API functions, hooks, and feature flag aa61049229

Phase 4A: Define IFlightRoute, IMapMarker, IMapPolyline types; implement
searchDestinations and getFlightsMapCalendar API functions with 11 tests;
add useFlightsMapSearch, useFlightsMapCalendar hooks; add FEATURE_FLIGHTS_MAP
env var for feature flag gating.

Add Leaflet map wrapper and ClientOnly SSR-safe component dc030aceea

Phase 4B: MapCanvas.tsx is the sole Leaflet consumer in the codebase.
Renders markers (blue/orange), polylines (solid/dashed) with great-circle
arcs, popups and tooltips. Accepts all data as props (stateless).
ClientOnly.tsx provides SSR safety by deferring render until mount.

Add flights-map route page, start page container, and filter a2cf781b02

Phase 4C: FlightsMapStartPage manages filter state and drives search/calendar
hooks. FlightsMapFilter provides departure/arrival/connections/domestic/
international controls. Route page gates on flightsMap feature flag, rendering
404 when disabled.

Add flights-map SEO builder and JSON-LD WebPage schema 0f5d7915be

Phase 4D: buildFlightsMapSeo generates meta tags, canonical, hreflang, OG
and Twitter Card props. buildFlightsMapJsonLd produces a schema.org WebPage
object for structured data. 10 tests cover both builders.

Update flights-map barrel and MF expose from stub to real a60494366f

Populate the feature barrel with all 4A-4D exports. Replace the
FlightsMap MF expose stub with lazy-loaded FlightsMapStartPage,
gated by the flightsMap feature flag.

Add Phase 4 master plan and install leaflet dependency 8dde2db9d2

Write the flights-map master plan covering sub-plans 4A-4D.
Add leaflet + @types/leaflet to support the map canvas component.

Fix lint and typecheck issues in flights-map feature 5839692e52

Add explicit undefined to optional properties for exactOptionalPropertyTypes
compatibility. Remove unused import. Fix non-null assertions with proper
null guards. Remove invalid eslint-disable comment.

Add Phase 5 Popular Requests master plan 7d202b9436

Documents the Angular feature analysis and sub-plan breakdown for
porting popular-requests to React with useSearchHistory hook.

Add Phase 5A types, API function, and usePopularRequests hook 0a8ccfe36e

Ports Angular PopularRequestsApiService and IPopularRequest types
to React with pure API function + React hook pattern matching
existing features (online-board, schedule).

Add Phase 5B components, route page, and update MF expose e172df8cf9

PopularRequestsPanel renders up to 4 popular request items in a
grid. MF expose upgraded from stub to real component. Route page
at /{lang}/popular provides standalone access.

Add Phase 5D useSearchHistory hook with per-language namespacing 99af1fe00d

Persists search history to localStorage via @/shared/storage with
language-scoped keys (afl_history_{lang}). Supports dedup by URL,
max 10 items, and clear functionality.

Add Phase 5C integration tests for PopularRequestsPanel 78205c378e

Covers all 5 request modes, loading/error states, keyboard
accessibility, and the 4-item display limit.

Fix lint warnings and test environment for Phase 5 tests 031ad7c15d

Remove unused type alias, unused variable, add jsdom environment
directive, and use container.textContent for cross-element text
assertions.

Add Phase 6 cutover runbook and operational checklist 98c6eca90e

Comprehensive operational procedure for the Angular-to-React traffic
cutover: pre-cutover gates, proxy config templates (nginx/HAProxy),
72-hour traffic ramp schedule, monitoring checklist, rollback procedure,
1-week soak criteria, and Angular decommission steps. Also adds Phase 6
cross-reference sections to the Phase 1 runbook.

Wire root route redirect to /{lang}/onlineboard 8a5279745c

Replace the 1A-2 placeholder with a loader redirect matching Angular's
default routing: bare `/` sends users to `/ru/onlineboard`.

Add Module Federation build artifacts to .gitignore 9cbc28074b

Ignore @mf-types.zip, @mf-types/ directory, and .mf/ cache directory
that are generated during MF builds.

gnezim merged commit 1a01b31f91 into main

2026-04-15 12:21:16 +03:00

gnezim referenced this issue from a commit

2026-04-15 12:21:17 +03:00

Merge pull request 'plan/react-rewrite' (#1) from plan/react-rewrite into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: gnezim/flights_web#1