sml-cli

library2026.3.0jsnpmunverified

Semantic Modeling Language (SML) CLI tool for managing semantic layer deployments via AtScale or compatible backends. Current stable version is 2026.3.0, released quarterly following the SML specification versioning. Provides model validation, transformation, and lifecycle management from the command line. Differentiators include native TypeScript types, Node.js >=18 requirement, and adherence to the open SML standard for semantic models.

devops data

npm install sml-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SML-CLI

sml-cli

devopsjavascriptv2026.3.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

cli

✓ import { cli } from 'sml-cli'

ESM-only; requires Node >=18

SMLConfig

✓ import type { SMLConfig } from 'sml-cli'

✗ import { SMLConfig } from 'sml-cli'

TypeScript type, not a runtime value

runCLI

✓ import { runCLI } from 'sml-cli'

✗ const { runCLI } = require('sml-cli')

ESM-only since v2026.0.0; CommonJS not supported

Programmatic usage of SML CLI to validate a semantic model file.

import { runCLI } from 'sml-cli'; async function main() { await runCLI(['--version']); // Or use programmatically: const result = await runCLI(['validate', 'model.yaml']); console.log(result.exitCode); } main().catch(console.error);

sml --version

Debug

Known issues

breakingESM-only: CJS require() throws Module not found error. Package is ESM-only since v2026.0.0. Use import syntax.

fix

Switch to ESM or downgrade to v2025.x (if available).

affects: >=2026.0.0

breakingNode.js >=18 required. Older Node versions cause runtime errors.

fix

Upgrade Node.js to 18 or later.

affects: >=2026.0.0

gotchaCLI arguments must be passed as array of strings. runCLI() with a single string fails silently.

fix

Always use array: runCLI(['validate', 'file.sml'])

affects: *

deprecatedv2025.x functions like validateModel() are removed in v2026; use runCLI() instead.

fix

Migrate to runCLI() API.

affects: >=2026.0.0

gotchaTypeScript types are experimental and may not cover all runtime errors. Verify with actual CLI.

fix

Cross-check with CLI help output.

affects: *

Errors

Common errors & fixes

Error [ERR_REQUIRE_ESM]: require() of ES Module /path/to/node_modules/sml-cli/index.js not supported.

Package is ESM-only and cannot be required with CommonJS require().

fix

Use import syntax or set type: module in package.json, or downgrade to v2025.x.

TypeError: runCLI is not a function

Incorrect import: default import used instead of named import, or wrong path.

fix

Use import { runCLI } from 'sml-cli'

Error: Unknown argument: --validate

Passing a single string instead of array of args to runCLI.

fix

Wrap arguments in array: runCLI(['--validate', 'model.sml'])

MODULE_NOT_FOUND: Cannot find module 'sml-cli'

Package not installed or Node.js version <18.

fix

Install package: npm install sml-cli, and ensure Node >=18.

Upgrade

Version history

2026.3.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

20 hits · last 30 days

node

Anthropic

OpenAI (training)

Resources

githubhttps://github.com/semanticdatalayer/SML ↗

packagehttps://www.npmjs.com/package/sml-cli ↗

homepagehttps://www.semanticmud.com/semantic-modeling-language/ ↗