README (2169B)
1 # xtask 2 3 This is the README for `xtask`, which provides internal workspace automation 4 tasks for the `radroots` core libraries. 5 6 ## Overview 7 8 * an internal `cargo xtask` runner for workspace-oriented development and 9 release workflows; 10 * `contract`, `coverage`, `dto-roots`, `release`, and `hygiene` command 11 families for core-library governance; 12 * configurable deterministic prototype-contract reporting through 13 `hygiene prototype-contracts`, with explicit narrow allowlists and a future 14 strict enforcement mode; 15 * deterministic `dto-roots --write|--check` generation for every 16 source-manifest package in the workspace DTO authority; 17 * strict `service-source-lock --mode write|check` generation and verification 18 for standalone hardened services, including Cargo, Nix, source-archive, 19 toolchain, cleanliness, and public-revision agreement; 20 * deterministic `service-release-artifacts --mode write|check` assembly for 21 the fixed hardened-service binary, OCI, configuration, module, license, 22 source-bundle, SBOM, notice, manifest, provenance-input, and checksum 23 inventory, with signing credentials kept external and operator runbooks 24 deliberately excluded from this standalone build input set; 25 * exact native service-build qualification validation that binds the Rust 26 target and standalone command inventories, fixture Cargo/release metadata, 27 source lock, and release-artifact evidence while keeping Nix outputs 28 explicitly deferred; 29 * descriptor-bound, resource-bounded regular-file traversal, streaming 30 hashing, descriptor-bound create-new copying, generic parse-only tar-gzip 31 admission, and exact non-short-circuit aggregation of the release-preflight 32 lane inventory; 33 * command-dispatch code used for contract, coverage, hygiene, and release 34 paths inside the workspace; 35 * a non-published binary crate used as tooling rather than as a library 36 dependency. 37 38 ## Copyright 39 40 Except as otherwise noted, all files in the `xtask` distribution are 41 42 Copyright (c) 2025 Tyson Lupul 43 44 For information on usage and redistribution, and for a DISCLAIMER OF ALL 45 WARRANTIES, see LICENSE included in the `xtask` distribution.