Skip to content

docs(bridge): mark stable contract from KernelVersion 2.0#36

Merged
akromicc merged 1 commit intomainfrom
docs/bridge-stable-contract
Apr 30, 2026
Merged

docs(bridge): mark stable contract from KernelVersion 2.0#36
akromicc merged 1 commit intomainfrom
docs/bridge-stable-contract

Conversation

@akromicc
Copy link
Copy Markdown
Contributor

Context

Recon across the ecosystem (link, ops, visor, hub, starter, operador360, p2p) confirmed:

  • bridge IS adopted as the single seam each host uses to wire kernel↔host glue.
    • link: 5 files (engine, store, nodes, mapping, tests) + ports adapters
    • ops: ActionInterceptor for marketplace addons
    • visor: minimal adapters
  • Public surface is stable and broadly consumed; breaking changes ripple to every host.

Changes

  • bridge/doc.go (new): formal package doc with stability statement, contract notes, and current host adopters.
  • ARCHITECTURE.md: surface bridge in the "addon platform" section and in the directory contract, marked as stable from KernelVersion 2.0+.

Out of scope

  • No code changes to bridge.go, ports.go, or any consumer.
  • The stability declaration only formalises what is already true at HEAD; it does not bump KernelVersion (already 2.0.0 in bridge.go).

bridge is the single seam each host (link, ops, visor, hub) uses to wire
concrete implementations of the kernel's interfaces. Recon across the
ecosystem confirmed adoption (link, ops, visor) and stable shape:
Config, Bridge, ActionContext, ActionInterceptor(Registry), Tool(Store),
AgentResolver, LegacyLifecycle/ManifestSource, SecretResolver, Manifest.

Add bridge/doc.go formalising the public surface and the host-side
contract, and surface bridge in ARCHITECTURE.md alongside the rest of
the addon platform.
@akromicc akromicc merged commit 7c88175 into main Apr 30, 2026
1 check passed
@akromicc akromicc deleted the docs/bridge-stable-contract branch April 30, 2026 02:27
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