jackin-xtask

Workspace automation for CI, lints, docs, releases, schemas, and PRs. Merge-readiness entry points are cargo xtask ci, cargo xtask ci --fast, and cargo xtask ci --e2e.

What this crate owns

CI orchestration (ci) and the lint gates (lint — file-size budget, and the lanes planned under it).
Docs checks (docs — repo-links, brand prose, spec↔test citations), schema checks (schema), profile/feature matrix (profile_matrix), and the agent-file symlink gate (agent_files, including per-crate README presence).
Architecture/structure tooling (arch), test-layout gate (test_layout), PTY fixture extraction (pty_fixture), construct helpers (construct), release verification (release_verify), and PR tooling (pr).

Architecture tier and allowed dependencies

Build/CI tooling (xtask). No workspace dependencies — it inspects the workspace from the outside (files, cargo metadata, running cargo) and must not link against runtime crates. Runs on the host toolchain only.

Structure

Module	Owns	Tests
`main.rs`	`cargo xtask` dispatcher	—
`ci.rs` · `ci/`	CI orchestration	`tests.rs`
`ci_audit.rs` · `ci_cargo_audit.rs` · `ci_target.rs`	workflow audit, advisory-cache selection, and target transport	sibling `tests.rs` files
`ci_doc_examples.rs` · `ci_doc_examples/`	nextest-only documentation-example gate	`tests.rs`
`lint.rs` · `lint/`	file-size lint gate (adapter; budgets also in `ratchet.toml`)	`tests.rs`
`ratchet.rs` · `ratchet/`	unified shrink-only ratchet engine (`lint ratchet`)	`tests.rs`
`agent_files.rs` · `agent_files/`	agent-file symlink gate (`--format human\|json\|github`)	`tests.rs`
`report.rs` · `report/`	shared gate reporter (human/json/github)	`tests.rs`
`agent_links.rs` · `agent_links/`	no-cross-ref gate (README/AGENTS)	`tests.rs`
`container_paths_gate.rs` · `container_paths_gate/`	container-path gate	`tests.rs`
`suppressions.rs` · `suppressions/`	lint-suppression gate	`tests.rs`
`headers.rs` · `headers/`	ownership-header contract gate	`tests.rs`
`arch.rs` · `arch/`	tier-graph dependency-direction gate (`TIERS` table; prod edges must descend; dev-cycle allowlist)	`tests.rs`
`readme_freshness.rs` · `readme_freshness/`	structural src change ⇒ README same-PR gate	`tests.rs`
`test_layout.rs` · `test_layout/`	test-layout gate	`tests.rs`
`schema.rs` · `schema/`	schema check	`tests.rs`
`docs.rs` · `docs/`	docs repo-links / brand / specs / roadmap / research and semantic CI cache contracts	`tests.rs`, contract/brand/specs unit tests
`telemetry_registry.rs` · `telemetry_registry/`	closed-registry Weaver validation and namespace/privacy gates	`tests.rs`
`telemetry_bench.rs` · `telemetry_bench/`	telemetry performance capture and 5% comparison gate	`tests.rs`
`pr.rs` · `pr/`	PR tooling	`tests.rs`
`profile_matrix.rs`	feature-profile matrix	—
`pty_fixture.rs` · `pty_fixture/`	PTY fixture extraction	`tests.rs`
`construct.rs` · `construct/`	construct image helpers	`tests.rs`
`release_verify.rs` · `release_verify/`	release verification	`tests.rs`
`health.rs` · `health/`	report-only code-health dashboard (Phase 0)	`tests.rs`
`fs_util.rs` · `fs_util/`	deterministic `read_dir_sorted` for gate code (plan 027)	`tests.rs`
`desktop.rs` · `desktop/`	jackin❯ desktop assembly: bindings, XCFramework, build/verify/run, sign-notarize, release-state, bootstrap-secrets	`tests.rs`

Public API

The cargo xtask <lane> CLI. Merge-readiness is cargo xtask ci (or --fast / --e2e). New checks are added as lanes here so they are discoverable from one command.

cargo xtask lint ratchet checks every configured family. CI jobs that own one artifact use repeatable --only <family> arguments so they do not measure unrelated families or launch nested build work. Artifact-backed families skip when their artifact is absent; the job that produces an artifact must run the matching scoped ratchet after generation.

How to verify

cargo nextest run -p jackin-xtask
cargo clippy -p jackin-xtask --all-targets -- -D warnings
cargo xtask docs brand
cargo xtask docs specs
cargo xtask lint agents
cargo xtask lint agents --format json
cargo xtask lint files --format json
cargo xtask ci --fast