Home /Modules/impl/SST.SYNCHRO.md

SST.SYNCHRO.md

impl/nordshrift/SST.SYNCHRO.md · 64 line(s) · markdown

Nordshrift SST — Synchro Measure Block (NS-SST-SYN-0001)

Status: implementation model Revision: 1.0.0 Depends on: Synchro 1.3 (SYNCHRO.md, impl/core/sleela_synchro.*)

Purpose

A .sst sheet may declare a first-class measure: block describing the Synchro honest-measurement series it uses. Like network:/finance:/reach:, the measure block carries a closed metric series; unknown members are reported with structured NSS-E-SYN-* diagnostics.

Synchro is honest by construction: it measures what actually happened and makes no delivery-time guarantee. A sheet therefore cannot set honest false.

Grammar

measure:
  metrics    [ sent, received, loss, mean, min, max, p95, report ]
  timeout-ms 1000
  honest     true

Closed series

KeyMembers
metricssent, received, loss, mean, min, max, p95, report

Scalars

KeyMeaningDefault
timeout-msdefault per-dispatch measurement budget1000
honestmeasured, never promised; must be truetrue

Diagnostics

CodeCondition
NSS-E-SYN-001unknown Synchro metric in metrics
NSS-E-SYN-002honest false (rejected; Synchro is honest by construction)

Manifest emission

When a sheet declares measure:, nordshrift build emits it into the component manifest for every target:

nordshrift check prints a one-line summary:

measure: 8 metric(s) [sent, received, loss, mean, min, max, p95, report], timeout-ms=1000, honest=true [Synchro]

Example

See examples/reach-measure.sst.