Skip to content

service-pointsav-link

service-pointsav-link is the hot-pluggable adapter that connects an os-* Subject node to a PointSav fleet. It is the sole code responsible for translating authority commands — issued by os-network-admin and delivered via the PPN Command Protocol — into Subject-executable operations. The adapter ships as the pointsav-protocol package. Its most important property is its default state: it is not installed. A Subject with no service-pointsav-link has no concept of phoning home, receiving commands, or participating in fleet management.

The four properties

Property Behaviour
Default state Not installed; the Subject has no concept of phoning home
Activated state Hot-plugged by the operator with a single command; brings the Subject under fleet management
Failure mode If the adapter crashes, the link severs cleanly; the Subject continues running standalone; the fleet management surface goes dark
Code path Diode policy lives inside the adapter, not the OS kernel — the policy can be updated without touching the rest of the system

Default state: no phone-home capability

A freshly booted os-infrastructure node does not have service-pointsav-link installed. This is not a configuration choice — it is an architectural invariant. The Subject OS contains no code that would allow it to initiate contact with any authority. There is no ssh client, no peer-to-peer routing table, and no RPC initiator. The Subject is structurally incapable of phoning home.

This property holds across the entire os-* family. Every Subject — os-totebox, os-mediakit, os-privategit, os-infrastructure, and os-network-admin when acting as a Subject — begins in a state where fleet management is absent. Bringing a node under management is always an explicit operator action, never an automatic one.

Activation: hot-plugging the adapter

An operator activates service-pointsav-link on a Subject with a single command issued from os-network-admin. The activation sequence installs the pointsav-protocol package, registers the node's fiduciary keypair with the fleet's pairing registry as a Subject entry, and opens the adapter's single inbound command channel.

After activation, the Subject becomes addressable by the fleet's command broadcast. The adapter's inbound channel listens on the PPN mesh and accepts only packets whose operation code is within the permitted set defined by the fleet's Diode Standard policy. All other traffic is discarded at the adapter boundary.

Failure mode: clean severance

If service-pointsav-link crashes or is deliberately uninstalled, the Subject does not fail. It continues running its workloads — serving content, executing computations, maintaining its local state — as if fleet management had never been present. The fleet management surface goes dark: os-network-admin loses visibility of the Subject and cannot issue commands to it. But the Subject's own services are unaffected.

This failure mode is by design. A Subject that depends on the adapter for normal operation would be permanently coupled to the control plane — any control-plane outage would cascade to the Subject's workloads. By decoupling Subject operation from adapter presence, service-pointsav-link ensures that a control-plane failure is an observability loss, not a service outage.

Policy in the adapter, not the kernel

The Diode Standard policy — which command flows are permitted, what operations are allowed from which authorities, what telemetry is emitted — lives inside service-pointsav-link, not in the Subject OS kernel. This separation has a practical consequence: updating fleet policy requires updating the adapter, not rebuilding or rebooting the operating system.

A Subject OS release and a Diode policy update are independent deployments. An operator can tighten or loosen fleet policy by pushing a new pointsav-protocol package version to active Subjects without touching any kernel code.

The Universal Standard

service-pointsav-link is not a feature of a specific operating system. The same pointsav-protocol package, with different policy bindings, is the adapter between any pair of PointSav OS instances that need to communicate. An os-totebox Subject connected to an os-console Authority uses the same adapter code path as an os-infrastructure Subject connected to os-network-admin.

This uniform standard is what makes a complex fleet auditable. Every connection looks the same at the protocol layer. An auditor examining any pair of connected nodes sees the same adapter shape — the same default-off behaviour, the same activation sequence, the same clean-severance guarantee.

See also

  • diode-standard — the authority hierarchy and traffic rules the adapter enforces
  • os-network-admin — the Authority that activates and commands Subjects via the adapter
  • infrastructure-os — an os-infrastructure Subject that uses this adapter to join a fleet
  • ppn-command-protocol — the 16-byte binary wire format the adapter receives
  • machine-based-auth — the fiduciary keypairs that authenticate the adapter's command channel
Important Information

Important Information

Corporate structure. PointSav Digital Systems ("PointSav") is a trade name of Woodfine Capital Projects Inc. ("Woodfine"). PointSav does not itself offer, sell, or solicit any security. Any securities offering associated with Woodfine's real-property direct-hold solutions is made exclusively by Woodfine, and only by means of the applicable Private Placement Memorandum.

No investment advice. This wiki's content is provided for engineering, operational, research, and development purposes. Nothing on this wiki constitutes investment advice or a solicitation to invest in any Woodfine partnership or direct-hold solution.

Intellectual property. The PointSav name, trade name, wordmark, and marks, together with all current and future PointSav- and Totebox-branded products, services, and offerings — and the software, source code, documentation, design system, and all related materials — are proprietary to Woodfine and its affiliates, except for components identified as open source. No rights are granted except as expressly set out in a written license or agreement. See TRADEMARK.md in this repository for the full trademark notice.

Open source components. Portions of the platform are made available under permissive open-source licenses identified in the accompanying repository. Use of those components is governed by their respective license terms.

No warranty; informational use. Content on this wiki is provided for general informational purposes only and does not constitute a representation, warranty, or commitment with respect to product functionality, availability, pricing, or roadmap. Some articles describe planned or intended features, capabilities, and milestones — language such as "planned," "intended," "targeted," "may," and "expected" marks this forward-looking content, which is subject to change and does not constitute a commitment regarding future performance.

Confidentiality. Where an article describes an operational or deployment detail that is not intended for public disclosure, that article is not published on this wiki. Content here is general-purpose engineering documentation, not customer-specific configuration.

Jurisdiction. Woodfine Capital Projects Inc. is organized in British Columbia, Canada. References to the Sovereign Data Foundation on this wiki describe a planned or intended initiative only, not a current equity holder or active governance body.

Changes to this notice. PointSav may update this notice from time to time; the version posted on this page governs.

Not a filing system. This wiki is not a securities filing system, an electronic disclosure repository, or a substitute for SEDAR+ or any other regulatory filing system. Formal securities filings are made through the applicable regulatory filing system, not through this wiki.

Full disclaimer. This notice supplements, and does not replace, the full Disclaimers article. In the event of any conflict, the full Disclaimers article governs.

Read the full disclaimer →