Skip to content

refactor: expose transport-independent Node API - #67

Merged
BernardLowe merged 2 commits into
mainfrom
refactor/public-node-api
Oct 6, 2026
Merged

BernardLowe merged 2 commits into
mainfrom
refactor/public-node-api

Conversation

@BernardLowe

@BernardLowe BernardLowe commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

Applications and synchronization currently import their node contracts from the transport subtree, while Gateway defines a second set of service interfaces. This change exposes nodeapi above transport so in-process services and network adapters can share the same authentication, immutable CAS, and dataset-branch contract.

  • Move all runtime consumers to nodeapi, remove the superseded package paths, and retain narrow capabilities instead of a catch-all Node interface.
  • Reuse Core candidate validation and enforce exact returned Roots. Add the preserve publication policy to the common dataset request and reject merged responses for that policy.
  • Preserve nested heads/ branch identities across repeated normalization, binding, HTTP requests, response validation, and CLI branch lookup. Ordinary selectors and their namespace aliases still address the same branch.
  • Add reusable authentication and dataset conformance suites alongside the existing CAS suite. Gateway runs them against real services in process and over HTTP.
  • Document service ownership, adapter rules, and the separate persistence, publication, synchronization, and accepted-root stages. A complete offline authentication store and new RPC/replication protocols remain outside this change.

Validation: full runtime go test ./..., go vet ./..., Linux build, Windows amd64 cross-build, and git diff --check; real Gateway in-process/HTTP contract tests passed under an exact local integration workspace. Independent pre-PR review reported no actionable findings.

Source-breaking pre-release migration: replace transport/capability with nodeapi, and transport/capabilitytest with nodeapi/nodetest. The Go module remains github.com/dewebprotocol/malt-client.

Companion implementation: https://github.com/DeWebProtocol/gateway/pull/32. Browser/Core alignment: DeWebProtocol/malt-ts#15.

Integration validation also passed: independent Gateway/runtime binary Product E2E, exact four-module gate, 292 migration entries, and 15 capability parity vectors.

Promote native authentication, CAS and dataset branch capabilities above transport and migrate runtime consumers without compatibility aliases. Share candidate validation, preserve-policy publication semantics, and adapter conformance suites with Gateway while keeping Core and accepted-root policy separate.

Co-authored-by: Codex <codex@openai.com>
Copilot AI balanced review requested due to automatic review settings October 5, 2026 09:31

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@BernardLowe
BernardLowe merged commit 44bd537 into main Oct 6, 2026
5 checks passed
@BernardLowe
BernardLowe deleted the refactor/public-node-api branch October 6, 2026 02:19
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.

2 participants