@loj-lang/cli temporary shell

This package is staged from packages/loj-shell-cli and published as @loj-lang/cli during the temporary Community remote-compile period.

The installed loj command forwards compile and scaffold commands to a remote Loj gateway, then downloads generated artifacts back to the local workspace. Commands that start local services or run local package managers remain local work and are intentionally not forwarded.

Remote artifact logs are replayed to stderr with a [loj remote] prefix after the artifact is downloaded. Command stdout remains reserved for the forwarded CLI output.

loj init and loj project scaffold write starter projects back to the requested local directory. When --bootstrap is passed, the shell first materializes the remote scaffold and then runs the package installation and bootstrap script locally. loj host init --install follows the same rule for the local host/ scaffold.

Project diagnostics and standalone artifact-family commands are also routed through the gateway: loj doctor, loj rules validate|build, loj flow validate|build, and loj formula validate|build. When those build commands use --out-dir, the result is written back under the synchronized local workspace.

The package is distributed under the Loj Community EULA. Run loj --help for current command support and EULA acceptance instructions.

Publish checklist

This workspace package is named @loj-lang/shell-cli only to keep the source tree separate from the historical compiler CLI. The publish staging script rewrites the npm package name to @loj-lang/cli and adds both loj and loj-shell binaries:

npm run publish:dry-run --workspace=@loj-lang/shell-cli

For a formal 0.6.4 publish, use one of these authenticated paths:

# Interactive account with npm 2FA:
npm run build --workspace=@loj-lang/shell-cli
npm run stage:npm --workspace=@loj-lang/shell-cli
npm publish packages/loj-shell-cli/dist-npm/@loj-lang-cli-shell --access public --otp <otp>

# CI or unattended release with a granular automation token that can bypass publish 2FA:
NODE_AUTH_TOKEN=<automation-token> npm publish packages/loj-shell-cli/dist-npm/@loj-lang-cli-shell --access public

Do not retry unattended publishing with an interactive npm session that requires one-time passwords; npm will reject the publish after staging succeeds. Bump LOJ_SHELL_CLI_PUBLISH_VERSION for each retry because npm versions are immutable once accepted.

If you still need to reproduce the earlier preview channel, keep using npm run publish:shell-preview --workspace=@loj-lang/shell-cli with an explicit preview version such as LOJ_SHELL_CLI_PUBLISH_VERSION=0.6.4-shell.1.