{"uid":"cap_pL9PVB7m0Om_GWezkFmOE","slug":"provenance-manifests-schema-directionality-checker-4d5fd05e","name":"Provenance Manifests Schema Directionality Checker","description":"Compare closed export-field guarantees. Removing fields, changing types or weakening required/non-null promises breaks the declared reader; extra fields depend on its explicit strictness for caller-supplied artifact and dataset provenance manifests. No source download, build reproduction, signature verification, proof of origin, causality or scientific validity. Offline typed nonpersonal metadata only. Result retention: 24 hours; minimal receipt metadata: 90 days.","url":"https://www.mahastrategies.com/api/v1/verify/provenance-manifests/schema-directionality?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"after":{"type":"array","maxItems":32,"minItems":0},"before":{"type":"array","maxItems":32,"minItems":1},"dataClass":{"enum":["public","synthetic"],"type":"string"},"nonpersonalMetadata":{"type":"boolean","const":true},"consumerAllowsExtraFields":{"type":"boolean"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.035115","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.035115/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.035115","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.035115","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LXRkewntfP7xKniytFhSN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.035115","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares two versions of provenance manifest field declarations to detect removed properties, changed scalar types, or weakened required/non-null guarantees that would break downstream readers.","exampleAgentPrompt":"Check whether my updated provenance manifest schema is safe for existing readers — the before schema has these fields and the after schema has these fields, data class is 'public', nonpersonal metadata is true, and consumers do not allow extra fields.","exampleUseCases":[{"title":"Dataset pipeline schema upgrade audit","prompt":"I'm about to roll out a new version of our dataset provenance manifest. Can you compare the before and after field declarations to find any removed properties, type changes, or weakened required constraints that would break our readers? Data class is 'synthetic', nonpersonalMetadata is true, and our consumers are strict — they don't allow extra fields."},{"title":"Artifact manifest backward compatibility check","prompt":"We're evolving our artifact provenance manifest schema and I need to know if the new version is backward compatible. Here are the before and after field arrays — data class is 'public', nonpersonalMetadata is true. Flag anything that removes fields or loosens a non-null promise."},{"title":"CI gate for schema regression detection","prompt":"Before merging this PR, check our provenance manifest schema changes for directionality issues — I have the old field list and the new field list ready. DataClass is 'public', nonpersonalMetadata is true, and consumerAllowsExtraFields is false. Reject if any required field was dropped or a type was weakened."}],"resultDescription":"Returns a structured comparison report identifying removed export fields, changed scalar types, and weakened required or non-null guarantees between the before and after provenance manifest schemas, along with a directionality verdict indicating whether the schema change is backward compatible for declared readers. Results are retained for 24 hours; minimal receipt metadata is retained for 90 days.","failureModes":["Before array is empty or missing (minItems:1 violated) — request rejected with validation error","After or before arrays exceed 32 items — request rejected","dataClass value outside 'public' or 'synthetic' enum — request rejected","nonpersonalMetadata not set to true (const:true) — request rejected","Malformed field descriptor objects in before/after arrays — validation error returned","Result unavailable after 24-hour retention window — stale result error"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, typed, offline comparison of two provenance manifest schema versions specifically for artifact or dataset metadata — particularly when you need to enforce closed export-field guarantees and detect breaking changes (removed fields, type regressions, weakened constraints) before deploying a schema update. Prefer this over generic schema diff tools when your use case involves caller-supplied provenance manifests with nonpersonal metadata constraints and you need an authoritative directionality verdict without any source download, signature verification, or build reproduction side effects.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:48:38.909Z","isFirstParty":false,"canonicalSlug":"provenance-manifests-schema-directionality-checker-4d5fd05e"}