META-AIML SDK Validator v3.0.0

Canonical validator SDK for META-AIML v3. The same validation core is reused in CLI, Playground, and browser adapter flows.

v3.0.0

Node + Browser Adapters

Score Zones: Red / Orange / Green

CLI Usage

Validate folders or single files with threshold control.

# Canonical SDK distribution
https://schemas.meta-aiml.org/v3.0.0/sdk/

# Example local run (after downloading sdk folder)
node ./sdk/aiml-sdk-validator-v3.js --target ./examples/restaurant_example_schema_v3.json

# JSON output
node ./sdk/aiml-sdk-validator-v3.js --target ./examples --json

# Custom threshold (default 50)
node ./sdk/aiml-sdk-validator-v3.js --target ./examples --fail-under 70

Node Runtime

Programmatic validation for automation and tooling.

const { AimlSdkValidatorV3 } = require("./sdk/aiml-sdk-validator-v3.js");

const validator = new AimlSdkValidatorV3(process.cwd(), { failUnder: 50 });
const result = validator.run("./examples/restaurant_example_schema_v3.json");

console.log(result.summary.score);
console.log(result.summary.isValid);
console.log(result.summary.pass);
console.log(result.findings);

Score Semantics

Validity is separated from quality score.

Critical findings always make schema invalid.

Default pass threshold: 50.

Zones: red (0-49), orange (50-89), green (90-100).

No critical findings: schema stays valid; missing recommended fields reduce score and create suggestions.

Canonical SDK Files

https://schemas.meta-aiml.org/v3.0.0/sdk/aiml-sdk-validator-v3.js - main validator entrypoint.

https://schemas.meta-aiml.org/v3.0.0/sdk/core/aiml-v3-validation-core.js - shared rules engine.

https://schemas.meta-aiml.org/v3.0.0/sdk/core/aiml-v3-node-document-adapter.js - Node adapter.

https://schemas.meta-aiml.org/v3.0.0/sdk/core/aiml-v3-browser-adapter.js - browser adapter.

https://schemas.meta-aiml.org/v3.0.0/sdk/SDK_VALIDATOR_V3.md - behavior contract and update protocol.

Open Playground Open Documentation