bijux-cli 0.3.6

Command-line runtime for automation, plugin-driven tools, and interactive workflows with structured output.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# bijux-cli

<!-- bijux-core-badges:generated:start -->
[![Crates.io](https://img.shields.io/crates/v/bijux-cli?label=crates.io&logo=rust)](https://crates.io/crates/bijux-cli)
[![Rust docs](https://img.shields.io/badge/rust--docs-bijux--cli-DEA584?logo=rust&logoColor=white)](https://docs.rs/bijux-cli)
[![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-0F766E)](https://github.com/bijux/bijux-core/blob/main/LICENSE)
[![CI Status](https://github.com/bijux/bijux-core/actions/workflows/ci.yml/badge.svg)](https://github.com/bijux/bijux-core/actions/workflows/ci.yml)
[![GitHub Repository](https://img.shields.io/badge/github-bijux%2Fbijux--core-181717?logo=github)](https://github.com/bijux/bijux-core)

[![bijux-cli](https://img.shields.io/crates/v/bijux-cli?label=bijux--cli&logo=rust)](https://crates.io/crates/bijux-cli) [![bijux-cli](https://img.shields.io/pypi/v/bijux-cli?label=bijux--cli&logo=pypi)](https://pypi.org/project/bijux-cli/) [![bijux-cli](https://img.shields.io/badge/bijux--cli-ghcr-181717?logo=github)](https://github.com/bijux/bijux-core/pkgs/container/bijux-core%2Fbijux-cli)

[![Repository docs](https://img.shields.io/badge/docs-repository-2563EB?logo=materialformkdocs&logoColor=white)](https://bijux.io/bijux-core/bijux-core/) [![bijux-cli docs](https://img.shields.io/badge/docs-bijux--cli-2563EB?logo=materialformkdocs&logoColor=white)](https://bijux.io/bijux-core/bijux-cli/packages/bijux-cli/) [![bijux-cli docs.rs](https://img.shields.io/badge/rust--docs-bijux--cli-DEA584?logo=rust&logoColor=white)](https://docs.rs/bijux-cli)
<!-- bijux-core-badges:generated:end -->

`bijux-cli` is the Rust runtime crate behind the `bijux` executable.

It is the public command runtime product in `v0.3.6` and the source of truth
for runtime command semantics shared by the native binary and Python bridge.

## Scope

- Own command parsing, normalization, registry lookup, and execution.
- Own runtime-facing state behavior for config, history, memory, install diagnostics, plugins, and the REPL.
- Expose read-only query APIs used by maintainer tooling.
- Do not assemble maintainer reports; `bijux-dev-cli` owns that surface directly.

## Source Layout

- [`src/api`](https://github.com/bijux/bijux-core/tree/main/crates/bijux-cli/src/api): stable entrypoints used by the binary, tests, and the Python bridge.
- [`src/bootstrap`](https://github.com/bijux/bijux-core/tree/main/crates/bijux-cli/src/bootstrap): process wiring and exit-code handling.
- [`src/contracts`](https://github.com/bijux/bijux-core/tree/main/crates/bijux-cli/src/contracts): durable command, envelope, config, plugin, and query types.
- [`src/features`](https://github.com/bijux/bijux-core/tree/main/crates/bijux-cli/src/features): domain implementations for config, diagnostics, history, install, memory, and plugins.
- [`src/infrastructure`](https://github.com/bijux/bijux-core/tree/main/crates/bijux-cli/src/infrastructure): filesystem, process, environment, and state-store adapters.
- [`src/interface`](https://github.com/bijux/bijux-core/tree/main/crates/bijux-cli/src/interface): CLI and REPL surfaces.
- [`src/kernel`](https://github.com/bijux/bijux-core/tree/main/crates/bijux-cli/src/kernel): execution pipeline and policy resolution.
- [`src/routing`](https://github.com/bijux/bijux-core/tree/main/crates/bijux-cli/src/routing): command catalog, parser, and registry.
- [`src/shared`](https://github.com/bijux/bijux-core/tree/main/crates/bijux-cli/src/shared): small cross-cutting helpers.

## Runtime Rules

- Commands are parsed and normalized before execution.
- Help, envelopes, and output formatting stay deterministic across repeated runs.
- Maintainer commands stay outside the runtime binary; this crate does not parse or execute `bijux-dev-cli` surfaces.
- The process entrypoint stays thin: decode argv, call the runtime, write streams, map exit codes.

## Tests

- [`tests/architecture.rs`](https://github.com/bijux/bijux-core/blob/main/crates/bijux-cli/tests/architecture.rs): boundary and ownership checks.
- [`tests/integration.rs`](https://github.com/bijux/bijux-core/blob/main/crates/bijux-cli/tests/integration.rs): command behavior, parity, resilience, and REPL coverage.
- [`tests/routing.rs`](https://github.com/bijux/bijux-core/blob/main/crates/bijux-cli/tests/routing.rs): parser, registry, schema, and routing law coverage.
- [`tests/data/fixtures`](https://github.com/bijux/bijux-core/tree/main/crates/bijux-cli/tests/data/fixtures) and [`tests/data/golden`](https://github.com/bijux/bijux-core/tree/main/crates/bijux-cli/tests/data/golden): stable fixtures and snapshots.

## Release References

- Repository handbook: [CLI handbook](https://bijux.io/bijux-core/bijux-cli/)
- Crate changelog: [`crates/bijux-cli/CHANGELOG.md`](https://github.com/bijux/bijux-core/blob/main/crates/bijux-cli/CHANGELOG.md)
- Root release log: [`CHANGELOG.md`](https://github.com/bijux/bijux-core/blob/main/CHANGELOG.md)
- Security policy: [`SECURITY.md`](https://github.com/bijux/bijux-core/blob/main/SECURITY.md)