Specification CLI

한국어.

The private @polyspec/crudui-cli workspace provides describe, list-widgets, check and explain. Install dependencies and build the packages from the repository root before running commands:

make install-tools TOOLS=npm
make install-packages
make install-tools
export PATH="$PWD/var/tools/bin:$PATH"
npm ci --strict-allow-scripts
npm run build

The CLI runs through tsx and imports only package entries: @polyspec/crudui-validator, @polyspec/crudui-generator-core and their internal entries, which resolve to the built packages. Rebuild after changing package source. npm test --workspace @polyspec/crudui-cli builds the packages first when their output is not current, and CI runs the same build before the tests.

Run commands from the repository root:

node --import tsx packages/cli/bin/crudui.mjs describe --json
node --import tsx packages/cli/bin/crudui.mjs list-widgets --json
node --import tsx packages/cli/bin/crudui.mjs check packages/cli/tests/fixtures/valid-leaf-type.yml
node --import tsx packages/cli/bin/crudui.mjs explain packages/cli/tests/fixtures/valid-leaf-type.yml --lang en
npm run manifest:check

Command	Input and output
`describe`	Generates a capability catalog from source registries, the schema and the expression contract. JSON is the default; `--md` selects Markdown.
`list-widgets`	Returns widget names, layouts and aliases. `--json` selects a JSON array.
`check <path>`	Parses JSON or YAML, checks the schema and forbidden keys, composes fields and checks leaf widget types. Returns `{ ok, errors }`.
`explain <path>`	Describes a JSON or YAML specification. `--lang en` selects English; the default is Korean. It does not validate input data.
`manifest`	Prints the executable contract manifest. JSON is the default; `--md` selects Markdown.

check errors contain path, reason and an optional key. An unresolved composition is an error; checking the original uncomposed input is not a substitute. The command has no external reference file-set option. Use the validation API with an explicit loader or file set when external composition inputs are needed.

Successful commands exit with zero. A failed check or execution error exits with 1; an unknown subcommand exits with 2. validate, render and scaffold are not registered CLI commands. Rendering uses the form APIs.

The catalog contains meta, widgets, layouts, rules, slots, buckets, forbiddenKeys, grammar, classification, matrix and list. Its complete shape is defined by DescribeResult. Do not maintain a separate copied widget or rule catalog.

Run npm run manifest:check to verify package, feature, fixture, test and document links. Run npm run manifest:test to execute the commands declared by the feature manifest. Run npm test --workspace @polyspec/crudui-cli to check catalog consistency, static checking and descriptions. Implementation and deployment results belong in feature status.