gen-cli 0.1.18

gen — operator-facing CLI. Subcommands: check (parse + print typed manifest), lock (regenerate lockfile-derived data), config-show (dump tier), config-diff (compare tiers). Wires every adapter to the operator through one binary; new adapters land in the dispatch table, not as new tools.
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

//! Cross-adapter `DispatcherCatalog` sweep — proves every
//! production Quirk enum is registered into the fleet-wide
//! catalog via `gen_platform::register_dispatcher!`. Adding a
//! new ecosystem WITHOUT a register_dispatcher! call fails this
//! test, enforcing the "common language" rule across the 9
//! adapters.

// Pull every adapter into the link-time inventory.
use gen_ansible as _;
use gen_bundler as _;
use gen_cargo as _;
use gen_gomod as _;
use gen_helm as _;
use gen_npm as _;
use gen_pip as _;
use gen_poetry as _;
use gen_swift as _;

use gen_platform::catalog;

const PRODUCTION_LABELS: &[&str] = &[
    "gen.ansible.ansible-quirk",
    "gen.bundler.bundler-quirk",
    "gen.cargo.crate-quirk",
    "gen.gomod.gomod-quirk",
    "gen.helm.helm-quirk",
    "gen.npm.npm-quirk",
    "gen.pip.pip-quirk",
    "gen.poetry.poetry-quirk",
    "gen.swift.swift-quirk",
];

#[test]
fn every_adapter_registers_into_catalog() {
    let mut missing = Vec::new();
    for label in PRODUCTION_LABELS {
        if catalog::by_label(label).is_none() {
            missing.push(*label);
        }
    }
    assert!(
        missing.is_empty(),
        "9 production dispatchers must be registered; missing: {missing:?}"
    );
}

#[test]
fn catalog_has_at_least_nine_entries() {
    // ≥ 9 not == 9: gen-cli links extra crates that may register
    // dispatchers later (e.g. gen-config, gen-nix). The strict
    // "9 production are present" assertion is the test above.
    let all = catalog::registered();
    assert!(
        all.len() >= 9,
        "catalog should hold ≥ 9 production entries; got {}",
        all.len()
    );
}

#[test]
fn each_production_variant_count_matches_expected() {
    // Tracks the variant universe per ecosystem. Failing this
    // means a Rust enum gained/lost a variant — refresh the
    // substrate's lib/build/shared/dispatcher-catalog.json + add
    // the matching helpers arm in substrate/lib/build/<eco>/quirk-apply.nix.
    let expected: &[(&str, usize)] = &[
        ("gen.cargo.crate-quirk", 3),
        ("gen.npm.npm-quirk", 5),
        ("gen.bundler.bundler-quirk", 5),
        ("gen.helm.helm-quirk", 4),
        ("gen.pip.pip-quirk", 4),
        ("gen.poetry.poetry-quirk", 4),
        ("gen.gomod.gomod-quirk", 5),
        ("gen.ansible.ansible-quirk", 4),
        ("gen.swift.swift-quirk", 4),
    ];
    for (label, count) in expected {
        let entry =
            catalog::by_label(label).unwrap_or_else(|| panic!("missing label {label}"));
        let got = (entry.variant_count)();
        assert_eq!(
            got, *count,
            "{label} variant_count drift: expected {count}, got {got}"
        );
    }
}

#[test]
fn variant_kinds_are_globally_unique_per_dispatcher() {
    // Within one dispatcher, every kind tag must be unique
    // (serde would have failed earlier, but this is the explicit
    // assertion).
    for entry in catalog::registered() {
        let kinds = (entry.variant_kinds)();
        let mut seen = Vec::with_capacity(kinds.len());
        for k in &kinds {
            assert!(
                !seen.contains(k),
                "{}: duplicate kind {k}",
                entry.label
            );
            seen.push(*k);
        }
    }
}