Skip to content

ANALYSIS.md

Latest commit

 

History

History
55 lines (46 loc) · 7.53 KB

ANALYSIS.md

File metadata and controls

55 lines (46 loc) · 7.53 KB

arken/packages/forge/ANALYSIS.md

Folder

arken/packages/forge

Snapshot

  • Files: 7
  • Subfolders: 1

Notable contents

  • files: .git, .gitignore, .gitmodules, LICENSE, NOTES.md, README.md, package.json
  • dirs: packages

Latest rotation update

  • Initialized nested submodule packages/web.
  • Completed deepest-first analysis chunk in packages/web/src/modules/royale and bubbled summaries through src/modules and src.
  • Continued Forge rotation with deepest-first pass in packages/web/src/views/games/infinite and added new README.md + ANALYSIS.md rollups for views, views/games, and views/games/infinite.
  • Added next Forge leaf-first pass in packages/web/src/views/games/evolution/{leaderboard,tournament} with new leaf docs and parent rollups.
  • Added packages/web/src/views/games/isles/{README.md,ANALYSIS.md} from direct isles/index.tsx analysis and bubbled summary updates to parent docs.
  • Added packages/web/src/components/{README.md,ANALYSIS.md} and traced Isles runtime ownership into components/MemeIsles.tsx (socket + Unity + wallet lifecycle coupling).
  • Added packages/web/src/views/games/oasis/{README.md,ANALYSIS.md} after reading Oasis route sources directly; captured wrapper-vs-monolith split around tutorial.tsx.
  • Added packages/web/src/components/Sanctuary/{README.md,ANALYSIS.md} from a full component-level pass; confirmed Oasis routes are mostly thin wrappers over Sanctuary components that currently mix static generated data, direct Envoy fetches, and seer tRPC queries.
  • Added packages/web/src/components/guilds/{README.md,ANALYSIS.md} from a guild-component pass; documented TeamCard profile query coupling to Seer, loose typing/dead-code debt, and profile-status rendering ambiguity.
  • Added packages/web/src/components/Menu/icons/{README.md,ANALYSIS.md} from a menu-icons pass; documented mostly static SVG icon ownership and Logo.tsx browser-coupled load-timing/styling behavior as the outlier.
  • Added packages/web/src/views/royale/{README.md,ANALYSIS.md} from a direct route-source pass; confirmed route layer is a thin active-gate wrapper over components/Royale runtime ownership.
  • Added packages/web/src/components/Menu/components/{README.md,ANALYSIS.md} from a menu runtime-component pass; documented wallet/account modal bridge ownership, nav config rendering flow, and typing/imperative-navigation testability gaps.
  • Added packages/web/src/components/Logo/{README.md,ANALYSIS.md} from direct source analysis of Logo/index.tsx; documented multi-source logo fallback behavior, module-global failed-src suppression tradeoffs, and lightweight typing gaps.
  • Added packages/web/src/components/Menu/{README.md,ANALYSIS.md} from direct source analysis of menu root primitives (Menu.tsx, config.ts, theme.ts, types.ts); documented dormant container ownership and duplicated social-config entries.
  • Added packages/web/src/hooks/{README.md,ANALYSIS.md} from direct hook-layer analysis (useWindows, useAuth, useWeb3, useNotice, useLive, index); documented monolithic route-registry/auth coupling and loose typing risks.
  • Added packages/web/src/contexts/{README.md,ANALYSIS.md} and packages/web/src/contexts/Localisation/{README.md,ANALYSIS.md} from direct localisation-context analysis (languageContext.tsx, translationsContext.ts); documented localStorage coupling, commented translation-refresh behavior, and typing drift risks.
  • Added packages/web/src/components/account/{README.md,ANALYSIS.md} and packages/web/src/components/account/AchievementRow/{README.md,ANALYSIS.md} from direct account-achievements leaf analysis (AchievementRow/index.tsx, PointsLabel.tsx); documented disabled collect-action behavior and schema-shape guard gaps.
  • Added packages/web/src/config/{README.md,ANALYSIS.md} and packages/web/src/config/localisation/{README.md,ANALYSIS.md} from direct localisation config analysis (languageCodes.ts); documented locale activation-list ownership and translation alignment drift risk.
  • Added packages/web/src/connectors/{README.md,ANALYSIS.md} from direct connector-layer analysis (NetworkConnector.ts, index.ts); documented batch JSON-RPC envelope risks and connector export-surface ambiguity.
  • Added packages/web/src/config/constants/{README.md,ANALYSIS.md} from direct constants-catalog analysis (farms.ts, pools.ts, runes.ts, teams.ts, nfts.ts, types.ts, index.ts); documented large manual config ownership and consistency-test gaps.
  • Added packages/web/src/constants/{README.md,ANALYSIS.md} and packages/web/src/constants/localisation/{README.md,ANALYSIS.md} from direct constants analysis (languageCodes.ts, index.ts, lists.ts); documented comment-toggled locale activation, hardcoded routing/token defaults, and i18n parity-check gaps.
  • Added packages/web/src/constants/abis/{README.md,ANALYSIS.md} from direct ABI artifact analysis (erc20.ts, erc20.json, erc20_bytes32.json, weth.json, ens-registrar.json, ens-public-resolver.json); documented mixed artifact-shape drift risk and missing integrity-check guardrails.
  • Added packages/web/src/constants/multicall/{README.md,ANALYSIS.md} and packages/web/src/constants/token/{README.md,ANALYSIS.md} from direct source/artifact analysis (multicall/index.ts, multicall/abi.json, token/pancakeswap.json); documented multicall address-verification ownership gaps and static token-list staleness/logo-host dependency risks.
  • Added packages/web/src/utils/{README.md,ANALYSIS.md} and packages/web/src/utils/hooks/{README.md,ANALYSIS.md} from direct utility-layer analysis (utils/trpc.ts, utils/index.ts, utils/hooks/useClickOutside.tsx); documented frontend transport callback-map risks and utility ownership clarity gaps.
  • Added packages/web/src/state/{README.md,ANALYSIS.md} and packages/web/src/state/application/{README.md,ANALYSIS.md} from direct state-layer analysis (application/actions.ts, hooks.ts, reducer.ts, updater.ts); documented block-number updater wiring, popup reducer semantics, and missing reducer/updater test coverage.
  • Added packages/web/src/state/user/{README.md,ANALYSIS.md} from direct user-state analysis (user/actions.ts, reducer.ts, hooks.tsx); documented preference-state ownership, token/pair registry behavior, and tracked-pair derivation risk/test gaps.
  • Added packages/web/src/state/wallet/{README.md,ANALYSIS.md} from direct wallet-state analysis (wallet/hooks.ts); documented multicall balance selector ownership, amount-mapping behavior, and duplicate-address/test-coverage gaps.
  • Refreshed packages/web/src/components/{README.md,ANALYSIS.md} after direct source pass of components/Royale.tsx; documented monolithic live-feed ownership (socket + polling + filter fanout + Rune Royale moderator-event transitions) and transport-testability risks.

Next actions

  • Continue chunked analysis in next Forge leafs (web/src/views/*, web/src/hooks/*, or remaining web/src/components/* leaves) while preserving bottom-up rollups.

  • Add targeted protocol/reliability notes where frontend transport handling is coupled to view components.

  • Add explicit submodule-pointer review checklist notes when rolling packages/web SHA updates from main.

  • 2026-02-17: Rolled forge-web revert removing source-code edits until unit tests are available for validation.

  • 2026-02-17: Rolled final forge-web source-revert (Royale) to enforce docs-only PR scope.

  • 2026-02-17: Rolled forge-web Royale.tsx restoration; PR now docs-only per policy.

  • 2026-02-17: Rolled forge-web revert for src/state/wallet/hooks.ts (policy: source changes require test validation).