_No description in Cargo.toml._
| Tier | tools |
| Role | unclassified (baselined) |
| Path | crates/tools/xtask |
| Edition | 2021 |
| Targets | tools-xtask, check_deps_unregistered, cross_ref_against, layer_registration_oracle, mutation_gate, verify_packet_branches, verify_packet_oracle |
| Public items | 0 across 0 modules |
| Tests | 174 |
What it is for
tools-xtask - Workspace maintenance tasks
Run with: cargo run -p tools-xtask -- <command>
Commands: check-deps Check layer dependency rules check-migrations Fail on duplicate migration versions verify-packet Check a §18 worker-handoff packet against the protocol check-mutants Mutation-adequacy gate on the diff vs. origin migrate Run all migrations in dependency order migrate-list List migration order without running
Capabilities
No public items.
How to use it
No examples/ target and no doctest in this crate's rustdoc. The tests listed under Verification are the closest executable usage.
Module structure
No public modules: the crate root is its whole surface.
Public surface
No public items.
No pub use re-exports: every item above is declared in this crate.
Boundary
Depends on no other workspace tier.
Shares tier tools with 84 other crates: tools-advisory-reach, tools-archive-guard, tools-artifact-scaffold, tools-ask-ai-core, tools-ask-ais, tools-ask-gemini, tools-book, tools-book-report, … (84 total).
_What this crate deliberately does NOT own is a judgment. No committed registry records one for it, so none is stated here._
Where it sits
| Tier (ontology) | tools |
| Architectural role (taxonomy) | unclassified (baselined) |
| Location | crates/tools/xtask |
| Vocabulary in force (lexicon) | current |
Dependencies
Runtime, from outside the workspace.
| Crate | Requirement | Features | Optional | Only on |
|---|---|---|---|---|
cargo_metadata | ^0.18 | — | no | always |
serde | ^1 | derive | no | always |
serde_json | ^1 | — | no | always |
termcolor | ^1.4 | — | no | always |
toml | ^0.8 | — | no | always |
Development. None.
Build. None.
Depended on by. Nothing in this workspace.
Feature flags
No Cargo features are defined: every capability is unconditional, so no consumer can receive a half-wired crate.
Targets
| Kind | Name | Source |
|---|---|---|
| bin | tools-xtask | `src/main.rs` |
| test | check_deps_unregistered | `tests/check_deps_unregistered.rs` |
| test | cross_ref_against | `tests/cross_ref_against.rs` |
| test | layer_registration_oracle | `tests/layer_registration_oracle.rs` |
| test | mutation_gate | `tests/mutation_gate.rs` |
| test | verify_packet_branches | `tests/verify_packet_branches.rs` |
| test | verify_packet_oracle | `tests/verify_packet_oracle.rs` |
Error model
No public error type was detected: no public item declares a type named *Error, and no public signature returns one.
Operational characteristics
| Property | Evidence |
|---|---|
| async public surface | none detected |
| async runtime | none detected |
| database access | none detected |
| network I/O | none detected |
| unsafe code | none detected |
| environment variables | yes |
No unsafe block, unsafe fn, unsafe impl or unsafe trait was found by the parser anywhere in this crate's source.
Configuration
| Variable | Read in |
|---|---|
CARGO_MANIFEST_DIR | src/mutants_runner_io.rs |
CORPUS_SOURCECODE_APP_DB | src/mutants_telemetry.rs |
DATABASE_URL | src/main.rs |
HOME | src/mutants_runner_io.rs |
Related capabilities
No workspace crate depends on this one.
Verification
| Kind | Count |
|---|---|
| Unit tests | 132 |
| Integration tests | 42 |
| Examples | 0 |
| Doctests | 0 |
What the tests establish, by name:
an_unregistered_workspace_member_fails_check_deps_and_is_named—tests/check_deps_unregistered.rsregistering_the_missing_crate_makes_check_deps_pass—tests/check_deps_unregistered.rsclean_tree_matching_the_ref_passes—tests/cross_ref_against.rsexplicit_unresolvable_ref_is_an_error_not_a_silent_pass—tests/cross_ref_against.rslineage_swap_against_ref_fails_naming_both_files—tests/cross_ref_against.rsno_against_and_no_remote_skips_cross_ref_with_notice—tests/cross_ref_against.rsevery_workspace_member_is_registered_in_layers_toml—tests/layer_registration_oracle.rscheck_mutants_exits_non_zero_on_an_unknown_argument—tests/mutation_gate.rscheck_mutants_refuses_a_non_numeric_budget—tests/mutation_gate.rsa_bad_commit_fails_check_8_rather_than_passing_it—tests/verify_packet_branches.rsa_check_row_whose_stdout_has_the_expected_text_passes—tests/verify_packet_branches.rsa_check_row_whose_stdout_lacks_the_expected_text_fails—tests/verify_packet_branches.rsa_directory_pathspec_still_catches_a_modified_oracle_test—tests/verify_packet_branches.rsa_handoff_at_the_size_cap_is_not_refused_as_oversized—tests/verify_packet_branches.rsa_handoff_over_the_size_cap_is_refused_for_size—tests/verify_packet_branches.rsa_missing_oracle_test_file_is_reported_as_missing—tests/verify_packet_branches.rsa_modified_oracle_test_fails_check_8_and_names_the_file—tests/verify_packet_branches.rsa_modified_unrelated_file_does_not_fail_check_8—tests/verify_packet_branches.rsac_coverage_cannot_run_without_a_sprint_doc—tests/verify_packet_branches.rsac_coverage_fails_when_a_declared_ac_is_unproven—tests/verify_packet_branches.rsac_coverage_passes_when_every_declared_ac_is_proven—tests/verify_packet_branches.rsan_empty_oracle_tests_list_is_not_applicable_not_a_pass—tests/verify_packet_branches.rsan_empty_stdout_contains_is_not_an_expectation—tests/verify_packet_branches.rsan_unmodified_oracle_test_passes_check_8—tests/verify_packet_branches.rstwo_modified_oracle_tests_are_both_named—tests/verify_packet_branches.rsa_check_row_outside_the_binary_allowlist_fails_loudly—tests/verify_packet_oracle.rsa_check_row_whose_child_floods_stdout_is_bounded_and_still_reports—tests/verify_packet_oracle.rsa_check_row_whose_outcome_contradicts_its_expectation_fails_and_names_the_row—tests/verify_packet_oracle.rsa_declared_ac_with_no_proving_test_fails_and_names_the_ac—tests/verify_packet_oracle.rsa_fully_valid_packet_exits_zero_and_names_every_check—tests/verify_packet_oracle.rs- _… 144 more_
Documentation coverage
| Measure | Documented | Total |
|---|---|---|
| Public items with rustdoc | 0 | 0 |
Public modules with a //! block | 0 | 0 |
Metrics
| Metric | Value |
|---|---|
| Rust source files | 5 |
| Source lines | 6758 |
| Code lines | 5338 |
| Public API items | 0 |
| Public modules | 0 |
| Tests | 174 |
| Examples | 0 |
| Cargo features | 0 |
| Direct runtime dependencies | 5 |
| Workspace reverse dependencies | 0 |
pie showData
title Rust source composition
"Code" : 5338
"Blank or comment" : 1420
Generation
Rendered by tools-corpus corpus readme from repository evidence alone, renderer schema 2, lexicon current. No model, network service or database was consulted. Regenerate with tools-corpus corpus readme --write; verify with --check.