PubFi docs should make readiness explicit. This prevents public source-selection pages from overclaiming runtime execution.

Readiness Vocabulary

Safe Public Claims

  • A source is listed in Discovery.
  • A capability schema exists.
  • A route can be requested or planned.
  • A route can execute only when the current Registry operation is ready and request-time gates pass.
  • PubFi keeps provenance and freshness visible.

Unsafe Public Claims

  • Every listed source is callable.
  • A schema means live execution.
  • A local smoke test proves production readiness.
  • SEO/GEO artifacts prove rankings, traffic, or AI citations.
  • PubFi performs automatic procurement, supplier payment, or wallet custody.
  • A Discovery x402 label means every listed source or gateway route accepts PubFi x402.
  • The Production API origin means that an x402 route uses a real-value mainnet payment rail.

Evidence Rule

Every strong claim should point to one of:
  • a public docs page;
  • a public Discovery page;
  • a public OpenAPI schema;
  • an MCP manifest;
  • a checked-in public-safe source inventory;
  • a public-safe release note.
Private runtime data can inform internal decisions, but it should not be copied into public docs. Apply these terms with Provider Readiness and the Security And Public Data Boundary.