meta-lc-cli

English | 中文

Positioning

App generator and tooling CLI for App DSL validation and scaffold pipeline outputs.

Milestone Mapping

• Primary milestone: Phase 6 (+ API Generator task in Phase 2)
• Program board: GitHub Project #5

Scope & Boundaries

• In-scope: module responsibilities mapped to the Meta-Driven SaaS OS mainline.
• Dependency relation: Coordinates generated outputs consumed by kernel, bff, and runtime layers.
• Non-goal: No long-running runtime engine responsibilities.

MUST Constraints

• DSL is the single source of truth.
• All data/realtime flows must pass through BFF.
• Runtime must not embed business-rule implementation.
• Meta Kernel is the only structural source.

Collaboration Notes

• Phase 5 (Designer) and materials stay in ngx-lowcode.
• ngx-puzzle remains an independent base library.

Quick Start

after cloning this repo:

npm install
npm run build

after adding implementation packages:

# generate a minimal valid DSL template
npx meta-lc init --out ./app.dsl.json

# validate DSL (returns exit code 1 on failure)
npx meta-lc validate --file ./app.dsl.json

# machine-readable output
npx meta-lc validate --file ./app.dsl.json --json

# human-readable summary + validation result
npx meta-lc explain --file ./app.dsl.json

# generate pipeline plan (writes plan.json by default)
npx meta-lc generate --file ./app.dsl.json --out demo

# generate and write DB/API/Perm/Page artifacts
npx meta-lc generate --file ./app.dsl.json --out demo --write

# generate tenant/role template (preview by default)
npx meta-lc template --file ./app.dsl.json --out demo

# generate and write tenant/role template file
npx meta-lc template --file ./app.dsl.json --out demo --write

# run strict E2E gate (validate + generate + template + BFF checks)
npx meta-lc e2e --file ./app.dsl.json --out demo --bff-url http://localhost:6000

# machine-readable E2E report output
npx meta-lc e2e --file ./app.dsl.json --out demo --json

References

• Unified docs: lowcode-docs
• Architecture baseline: Meta-Driven Standard