NEARBuilders / NEARBuilders/everything-dev

v2-platform: 04 grafting engine in the real host — mount registry + one-plugin tracer bullet

Open
#276 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

ready-for-agent
Dominant language
TypeScript
Stars
5
Forks
6
Avg merge
1m
Merged PRs (30d)
1

Description

Parent

#274 (v2 platform services spec)

What to build

Route grafting in the real host, as proven by the beta-v2 web-grafting prototype: a mount registry derived from pathless layouts, the composition function that grafts web-plugin route trees into mounts (reparenting only the subtree root, namespacing route ids per plugin), MF shared-singleton scope participation, and SSR-by-exclusion for session-gated mounts. The tracer bullet is ONE real web plugin grafted at one mount and served by the actual host — with the prototype's headless verify scripts promoted into the real test suites. The prototype code and its documented findings (including the corrections it produced) are the specification.

Acceptance criteria

  • One real web plugin's route tree is grafted into a host mount with zero host-side routing code for that plugin
  • Route ids are namespaced; duplicate leaf URL paths across plugins resolve first-wins without breaking either plugin
  • Auth/apiClient context flows to grafted routes through root-route context
  • Session-gated mounts server-render nothing; public mounts SSR fully
  • The prototype's composition/SSR/collision verify scripts run as part of the real test suites
  • The host joins the MF shared scope with React/router as eager singletons (no double-instance footgun)

Blocked by

  • Epic #248 (oRPC v2 / Effect 4 migration) — grafting lands on the migrated platform.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the beta-v2 web-grafting prototype and its documented findings, then trace the real host and the prototype's composition, SSR, and collision verify scripts. Done means one real web plugin is served through a host mount, the listed routing, context, SSR, collision, and shared-scope criteria pass, and the scripts run in the real test suites.

Written by the indexing model from the issue text.

Assessment

Tech stack
react, typescript
Domain
full-stack, web-dev
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.