Skip to main content

public-product pattern

TrustBoundary

Explain what data stays local, leaves the device, requires an account, or needs human judgment.

complyeaze/core · candidate · @sanchika/patterns

Product job

Know what crosses a named boundary, what never crosses, and who controls the next action.

Explain what data stays local, leaves the device, requires an account, or needs human judgment.

Anatomy and required fields

boundarySummary

One-line boundary statement.

boundaryFacts

Account, upload, network, permission, and review facts.

neverCrosses

Sensitive data or credentials that do not cross the named boundary.

actionOwner

Person or system that controls a boundary-crossing action.

sourceEvidence

Inspectable source for the boundary statement.

safeAction

Inspect, permission, fallback, or handoff action.

Required fields
  • boundarySummary
  • boundaryFacts
  • neverCrosses
  • actionOwner
  • sourceEvidence
  • safeAction

Default and edge states

local-only

No artifact leaves the device.

  • local
  • no upload
  • output destination
permission-required

A capability must be granted.

  • permission
  • purpose
  • fallback
upload-required

An artifact must leave the device.

  • destination
  • reason
  • processor
unavailable

The boundary cannot be completed safely.

  • unavailable
  • reason
  • manual path

Composed synthetic exemplar

State coverage

Default and consequential edges remain inspectable.

local onlyNo artifact leaves the device.local · no upload
permission requiredA capability must be granted.permission · purpose
upload requiredAn artifact must leave the device.destination · reason
unavailableThe boundary cannot be completed safely.unavailable · reason

Trust, source, and consumer obligations

Trust boundaries
  • Do not imply government affiliation, guaranteed outcomes, or unstated production readiness.
  • Name account, upload, local-processing, external-destination, and human-review boundaries before action.
Consumer owns
  • Supply current product copy, sources, destinations, prices, review ownership, and all runtime behavior.
Responsive behavior
  • Stack facts after the claim on narrow screens.
  • Keep boundary summary before the related action in DOM order.
Forced colors and reduced motion
  • Retain labelled boundaries, native link underlines, focus outlines, and status text without authored color.
  • Keep all claims, proof, boundaries, and actions visible without entrance or layout motion.

Compact API reference

Package
@sanchika/patterns
CSS
@sanchika/patterns/styles.css
Base class
sk-pattern-trust-boundary
Group
public-product