Expand description
Compatibility facade for the effectful Boxology command core.
The installed boxology binary remains in this package. Reusable command behavior lives in
boxology-cli-core and is re-exported here so existing library consumers keep the same seam.
Structs§
- Base
Diff Inputs - Base-revision packages, changed paths, and tree object index for diff ownership.
- Base
Error - A stable failure to resolve the explicit base or read one of its schema objects.
- Captured
Output - Captured stdout and stderr from one trusted command.
- Check
Classification Error - A coded check-classification failure with schema or classifier diagnostics.
- Check
Composition - Live local classifier and check boxes assembled for the installed CLI.
- Classifier
Composition - Live local classifier box assembled for the CLI composition.
- Classify
Error - A stable classification failure with the underlying schema or classifier diagnostics.
- Command
Spec - Injectable trusted command: program name plus argv after the program.
- Compare
Difference - One package-relative difference between checked-in and regenerated derived output.
- Duplicate
Packages - Caller supplied the same package id more than once; not a repository defect.
- Execute
Error - A stable execution failure with an optional verbatim generator or writer cause.
- Execute
Plans - Lazy sequential multi-plan execution seam used by
boxology generate. - Generation
Plan - The pure inputs needed by the next generation-execution slice.
- GitTool
Error - The Git executable could not be started for a base check.
- Outcome
- The files changed by one accepted execution, in deterministic logical-path order.
- Package
Schemas - Supplied base and checked-in schema bytes for one package.
- Plan
Error - A stable planning failure with a validated logical path and no filesystem payload.
- Quality
Command - One declared quality command bound to its package and manifest path.
- Resolved
Base - One validated base commit, resolved once per check.
- Resolved
Import - One declared import resolved to the imported package’s checked-in schema.
- Spawn
Error - The trusted command executable could not be started.
- Tool
Step - Outcome of one external check step: completion plus optional captured tool text.
- Walk
Error - A payload-safe failure while materializing raw workspace filesystem inputs.
- Walked
Workspace - Raw filesystem material for
boxology-workspace.
Enums§
- Base
Inputs Error - Failure while assembling base-revision ownership inputs.
- Base
Schemas Error - Failure while assembling current and base-revision package schemas.
- Classify
Step Error - Failure from
classify_step: caller misuse or a coded package failure. - Compare
Step Error - A planning or generation failure while comparing derived output.
- Default
Base - Outcome of resolving the no-flag default base against the fixed v0 branch
main. - Difference
Kind - Why one checked-in derived artifact does not match regeneration.
Constants§
- CARGO_
METADATA_ ARGS - The exact argv passed to the one Cargo metadata invocation owned by the CLI.
Functions§
- base_
diff_ inputs - Loads base packages, the working-tree changed set, and the full tree object index.
- base_
diff_ inputs_ with_ candidate - Loads diff inputs, using candidate declarations only when the managed root has no base object.
- base_
package_ schemas - Assembles schema pairs for every current generation plan against one resolved base.
- cargo_
metadata_ command - Builds the captured Cargo metadata command for
root. - classify
- Classifies checked-in and regenerated schema bytes through the strict reader and classifier.
- classify_
step - Classifies each package’s base-revision and checked-in schema bytes.
- clippy_
spec - Builds denied-warning workspace Clippy matching the 08 baseline.
- compare_
plans - Compares already-planned contract generations with their checked-in derived files.
- compare_
step - Compares every contract-generation plan with its checked-in derived files.
- composition_
step - Reads every plan-authoritative checked-in schema and validates all compositions.
- execute
- Executes one plan against
root, reading package inputs, generating its tree, and writing it. - execute_
plans - Returns a lazy executor that runs
plansin iterator order againstroot. - fmt_
packages - Cargo package names selected for formatting: non-derived owned crate manifests only.
- fmt_
spec - Builds
cargo fmt --check -p …over the manifest-derived hand-authored selection. - lock_
spec - Builds full locked Cargo metadata matching the 08 baseline step-4 freshness check.
- plan
- Selects contract-generator candidates and assembles their pure plans in import-dependency order.
- quality_
specs - Flattens declared quality commands in package-id then declaration order.
- resolve_
base - Resolves an explicit base revision to one validated commit object id.
- resolve_
default_ base - Resolves the no-flag default base: merge base of
HEADwith the fixed v0 branchmain. - run_
clippy_ step - Runs Clippy through the injectable runner.
- run_
command - Runs
specatrootthrough the host process API. - run_
fmt_ step - Runs formatting, or returns passed when the manifest-derived selection is empty.
- run_
lock_ step - Runs full locked Cargo resolution through the injectable runner.
- run_
quality_ step - Runs every declared quality command, continuing after nonzero exits.
- run_
test_ step - Runs workspace tests through the injectable runner.
- test_
spec - Builds workspace tests matching the 08 baseline.
- walk
- Walks
rootwithout following symlink entries. Real.gitandtargetdirectories are pruned at every depth; every other entry must have a validRelativePath.
Type Aliases§
- Command
Runner - Injectable runner used by tool steps and tests.