chant dev onboard

Synopsis

chant dev onboard <name> [--verbose]

Description

chant dev onboard patches the monorepo infrastructure to include a new lexicon in CI, Docker smoke tests, and the npm publish workflow. Run this after scaffolding a lexicon with chant init lexicon <name> and building out its implementation.

The command modifies 6 files:

File	Change
package.json (root)	Adds @intentius/chant-lexicon-<name>: "workspace:*" to dependencies
tsconfig.json (root)	Adds paths entries for @intentius/chant-lexicon-<name> and @intentius/chant-lexicon-<name>/*. The repo-wide typecheck uses moduleResolution: node, which ignores package exports maps, so without these the lexicon’s example fails to resolve
.github/workflows/chant.yml	Adds prepack lines to check/test jobs + a validate step
.github/workflows/publish.yml	Adds prepack line to test job (publishing needs no per-lexicon step — scripts/publish-packages.sh enumerates the workspace)
test/Dockerfile.smoke	Adds <name> to the for lex in ... lexicon list
test/Dockerfile.smoke-npm	Adds <name> to both for lex in ... lexicon lists

A lexicon the current project’s chant.config.ts declares by path has no package to wire in, so onboard refuses it and names its path. Onboard reads the config without running it, and prints a note when its lexicons cannot be read that way. See Commands that read chant.config.ts without running it.

The command is idempotent. Running it again on an already-onboarded lexicon changes nothing and reports each file as already covered.

Options

Flag	Description
--verbose	Show detailed output

Example

# Scaffold the lexicon
chant init lexicon terraform

# ... implement generate, serializer, rules, etc. ...

# Wire into CI
chant dev onboard terraform

Remaining manual steps

After running dev onboard, you still need to:

1. Create an example workspace under lexicons/<name>/examples/
2. Add smoke tests to test/integration.sh
3. Run npm install to update workspace links
4. Run just release-lexicon <name> patch for the first release

See CI & Distribution for details.

See also

• chant init lexicon — scaffold a new lexicon
• chant dev generate — run the generation pipeline
• chant dev publish — build the distributable bundle
• CI & Distribution guide