Skip to content

Available now

Step 6 · Evaluate your vendors ​

Available now by hand. The goal is a comparison on evidence, not on

feature lists, that you can revisit when SOM or a product changes.

The evidence ​

EvidenceFromWhat it provesStatus
A results statement shared with your organisationThe vendor, from its complete test runs: consumer scenarios and skill cases, graded by the bus against a named suiteExactly which cases passed, in fixed words, until a date the vendor chose. See Results statementsAvailable now
A readiness write-upThe vendor, from the readiness checklistThe producer checks the bus can't grade by itself, ticked or explainedAvailable now
Your house's countsThe portal: accepted, refused and duplicate messages per vendor connectionHow the product behaved in your house, in numbersAvailable now
Your run sheetsYour scenario runs from step 4What each product did in your workflows, signed off by your peopleAvailable now
The coverage matrixThe portal, from statements shared with you and your house's trafficEvery app in your house against the message families, consumer scenarios and skill cases, with every gapAvailable now: Reading the coverage matrix

Also ask each vendor for its SOM roadmap: what it doesn't support yet, and when.

A vendor that shares a statement with you before it connects has it shown beside its connection request, so the evidence is there when you decide what to grant.

Scorecard ​

One per vendor product. Score each line pass, partial, fail or n/a, and link the evidence.

AreaCheckEvidence
ValidityEvery message the product sent in your runs was accepted, or refused only where the scenario meant itHouse counts; the vendor's own activity
Negative cases can't be produced through the product's screens or APIReadiness write-up
Snapshots (story owners)Whole snapshots, never deltas; sequence and updated_at right across restartsTimeline; S5
Killed stories stay killed; reopening is handledS2
Linkingcorrelation_id shared across a story's families; causation_id on every reactionRaw JSON on the timeline
ResilienceSafe retries with the same message_id; no retries on 4xxReadiness write-up; ask for a demo
Catches up in order after an outageS6; statement
ReceivingSnapshots replace, never merge; highest sequence wins; duplicates droppedStatement (consumer scenarios); S1, S2
Unknown types, fields, extensions and newer 1.x versions ignoredStatement; S7
GovernanceHonours editorial gates and standards holdsS4
Warnings valid, traceable, at the right severity (skill executors)Statement (skill cases); Skills in your scenarios
Your skillsCovers the skills your house runs, with your valuesWhich executors cover your skills
Operationssystem_id configurable; credentials in a secret store; clear errors for usersConfiguration review
HonestyResults described as "passes som-bus suite som-1.0.0+lib-0.2.2", with gaps stated; no "certified" or "compliant" claimsWrite-up, marketing

Reading the results ​

  • A refusal isn't automatically a failure. Ask for its source. schema, conformance and sequence mean the product broke SOM; policy usually means set-up: grants, credentials, ownership, size. See Verdicts.
  • Partial is normal early on. What matters is whether the gap is known, stated and on the roadmap.
  • Pending spec isn't a failure. Cases that need a message type SOM 1.0 doesn't define are shown but never counted: see Topics without a 1.0 schema. They're open questions for the SOM working group, and every vendor faces them.
  • A statement names exactly what passed. A case left out of it is a gap, even if the vendor ran it: ask for a statement that includes it.
  • Re-test on change. Record the suite, the product version and the date on every scorecard. A new release or a new SOM 1.x version means a new run of the relevant scenarios.

Sharing results ​

Scorecards are yours. A vendor's statement is shared with your organisation until the date it chose, and it can revoke it. If you share a vendor's results outside your organisation, ask the vendor first.

Next: Step 7 · Go live.

SOM is an open standard maintained by the SOM working group. This service is not endorsed by it.