Skip to content

Terminology ​

This glossary keeps the English source precise and gives translators a stable semantic base. API identifiers, package names, route tokens, header names, commands, URLs, versions, and code remain unchanged in localized documentation.

Core terms ​

TermMeaning in go-likeDo not use it to mean
ContextExplicit operation scope carrying deadline, cancellation result, cause, and values; passed first to blocking workDependency-injection bag, ambient request state, Go ABI, or a goroutine/channel
AppOne-shot coordinator for startup, registration, hooks, Server stop calls, terminal joins, and lifecycle errorsGlobal service container or process supervisor for resources it was never given
ServerStructural start(ctx) / stop(ctx) lifecycle boundaryAutomatically a Web server, readiness signal, or reverse-order dependency scheduler
HandlerStandard Web (Request) => Response | Promise<Response> function, or the separate internal (Context, Request) => Response handler when qualifiedA universal router handler or a listener by itself
ownerComponent responsible for admitting a resource and actually requesting/observing its cleanupAny caller that merely waits for an operation
admissionPoint at which a resource has been accepted into a lifecycle and its owner is responsible for stopping itA health check or proof of production readiness
terminalProvider or resource fact that the native operation has finishedA caller timeout or an unresolved Promise that was abandoned
caller waitThe time a caller is willing to await a result, often bounded by ContextCancellation of the underlying owner operation
unaryOne JSON request body followed by one JSON response bodyOne-way delivery, streaming, or full duplex
MessageProtobuf MessageShape in the Buf packages. The transport boundary is a Fetch Request and Response, not a Message typeThe internal transport SPI, a socket frame, or a routing header
EndpointNamed typed operation with service, endpoint, request Struct, and response StructNetwork address, IDL, generated stub, or a Registry endpoint URL
operation identityCanonical service/endpoint, such as appointment-policy.v1/checkHostname, port, or transport URL
transport addressOpaque destination passed to Transport.dial, such as memory://orders or https://orders.exampleOperation name or inferred protocol contract

Control-plane and data-plane terms ​

TermMeaning in go-likeDo not collapse it into
RegistryContract for registering and reading service instance reachabilityDurable business Store or global service locator
RegistrarRegistration and deregistration interfaceDiscovery watcher or health probe
DiscoveryReads and watches complete service-instance snapshotsRegistry backend protocol or selector policy
WatcherOwns a stream of complete replacement snapshots and a stop operationAdd/remove patch event stream
authoritative empty snapshotSnapshot that says the service currently has no endpoints; selection fails closedA transient watcher outage that should retain stale endpoints forever
SelectorChooses one ServiceEndpoint and receives explicit synchronous feedbackCircuit breaker, retry policy, Registry, or load balancer with universal semantics
FilterPure ordered transformation of a discovered ServiceInstance[] snapshotA security authorization check or endpoint health probe
ServiceInstanceService identity plus version, metadata, and transport URLsA single operation or a database record
selection feedbackOutcome facts sent to a Selector after the selected attemptResource ownership transfer or an asynchronous settlement protocol
ConfigImmutable merged source snapshots, validation, reload, and accepted source watcher lifecycleAmbient environment variable lookup or a transaction across resources
last-good snapshotMost recent accepted Config publication retained across a recoverable reload failureA claim that every backend read is current
StoreContext-first byte records with revision, CAS, TTL, and pagination optionsDatabase, ORM, Cache, or Event Store
CacheDisposable values with optional TTL that can be recomputedAuthoritative state, durable record, lock, or CAS store
BrokerTopic-based byte publish/subscribe while preserving native delivery identityBullMQ queue, Event Store, or universal settlement API
EventOptional typed Codec projection over Broker bytesDurable event history, replay, or schema registry
native deliveryProvider object retained as event.native, such as Msg or JsMsgAn object go-like can safely acknowledge with one common method
livenessWhether the process is alive enough for the platform's liveness policyReadiness to receive traffic
readinessWhether the service should receive traffic nowProof that all external dependencies are permanently healthy
providerBackend implementation of a narrow contractAll lifecycle wrappers or one universal adapter bucket
lifecycle adapterServer wrapper around an application-created native resourceReplacement for the native library's API

Runtime and security terms ​

TermMeaning in go-likeRequired qualification
portableShared code uses standard Web/ECMAScript APIs or injected capabilitiesNot proof that every runtime can bind sockets, watch files, use UDP, or configure TLS
Fetch HandlerStandard one-argument Request to Response functionA Handler still needs a host/listener
/node subpathExplicit runtime-specific entrypoint with Node capabilitiesDo not infer portability from the root package
standard Web streamingRequest/Response bodies and Web Streams, including framework SSE/WebSocket behaviorNot an internal SSE server stream or bidi RPC
TLSTransport encryption and peer certificate verification at the host/provider layerNot application authentication or authorization
mTLSTLS configuration requiring a verified client certificateNot automatic mapping from certificate to user, tenant, or role
metadataImmutable transport/application key-value data with explicit propagation rulesTrusted identity, claims, or automatic downstream forwarding
replay authorizationCaller declaration that a bounded retry may repeat an operationProof of business idempotency, deduplication, or exactly-once effects
redactionPolicy that avoids emitting secrets or payloads in a log/trace/health surfaceConstraint on application-owned native logger or exporter code

Use these forms consistently:

  • “internal unary call” rather than “RPC” when discussing the current go-like Client/Transport contract;
  • “complete replacement snapshot” rather than “watch event” for the public Registry watcher result;
  • “opaque transport address” rather than “endpoint” when referring to a network URL;
  • “caller-wait boundary” rather than “force timeout” unless a provider exposes a real force operation;
  • “explicit replay authorization” rather than “automatic retry safety”;
  • “application-owned provider” when the application created the native connection, Registry, logger, or telemetry provider;
  • “declared E2E lane” when a script exists but its current result has not been run;
  • “baseline audit reported” when referring to supplied historical/local command evidence;
  • “not established by this audit” for npm, hosted CI, production, published consumer, Docker, cross-runtime, or soak claims that were not executed.

Prohibited shortcuts ​

Do not call go-like:

  • a Go-compatible framework;
  • an all-in-one microservice framework;
  • a universal RPC stack;
  • a Protobuf or IDL replacement;
  • a database, ORM, Event Store, or queue abstraction;
  • a global DI container or service locator;
  • an automatic authentication or authorization system;
  • a universal streaming framework;
  • a production guarantee based only on source, package count, or version.

Translation parity rules ​

The localized trees should preserve:

  1. every package name, public function, type, route token, header, command, URL, version, and numeric limit exactly;
  2. the distinction between Registry and Discovery, Store and Cache, Broker and Event, and provider and lifecycle adapter;
  3. the portable Protobuf/Connect Fetch boundary, the managed standard-gRPC /native boundary, and the exclusions for browser standard gRPC, Fetch request-streaming/bidi, global auth, and automatic instrumentation;
  4. the evidence label attached to claims;
  5. the difference between a source contract, a declared test, a passing command, and an unresolved evidence gap.

For right-to-left pages, isolate code, URLs, service/endpoint, Go-Like-Metadata, shell commands, and version strings in code spans or fenced code blocks. Do not translate or reorder those identifiers.