Versioned validation contract

ServiceGen publishes deterministic metadata for every public SG_* diagnostic while retaining one authoritative validator implementation.

When to use

Use the contract to explain diagnostics, synchronize agent behavior, and prevent Python or Help from inventing duplicate validation rules.

The contract records ServiceGen version, diagnostic schema version, capability revision, contract revision, scopes, condition, meaning, remediation, and whether the user can correct each rule.
Every rule declares evaluation: servicegen; Python consumes metadata but does not become a second validator authority.
The contract revision is deterministic and linked to the capability registry revision.
MCP enriches runtime diagnostics with cached remediation while preserving the original diagnostic path, message, and details.

Read-only endpoints require no user credential.

PropertyTypeDescription

GET /v1/validation-contractJSON

Complete versioned diagnostic catalog.

GET /v1/validation-contract/{code}JSON

One exact rule document or 404 for an unknown code.

refresh_validation_contractMCP tool

Fetch, validate, and atomically cache the public contract.

{
  "code": "SG_SEMANTIC_TYPE_MISMATCH",
  "evaluation": "servicegen",
  "condition": "...",
  "remediation": "...",
  "userCorrectable": true
}