Skip to content

Design review: root ports shape and interface ownership #30

Description

@aatuh

Context

The root ports package is a v3 compatibility surface, but new app design should prefer package-local or app-owned interfaces unless a shared root abstraction is clearly justified.

Review paths

  • ROADMAP.md
  • docs/stable-core.md
  • docs/ports-surface.md
  • docs/interface-ownership.md
  • VERSIONING.md

Questions

  • Which existing ports are still useful shared toolkit contracts?
  • Which ports are historical compatibility surfaces that should not guide new designs?
  • What evidence should be required before adding a new root ports export?
  • Are the current app-owned interface recommendations clear enough for adopters?

Desired outcome

A review recommendation for the root ports shape: keep current policy, tighten it, or identify specific v4 cleanup candidates.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    help wantedExtra attention is neededquestionFurther information is requested

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions