cochranblock 0.1.0

The Cochran Block manual. Index of every Rust crate published under the Unlicense (public domain). The Anti-Founder Manifesto in crate form.
Documentation 
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
106
107
108
109
110
111
112
113
114

// Unlicense - public domain - cochranblock.org
#![doc(html_logo_url = "https://cochranblock.org/cochranblock-hero-logo.svg")]
#![doc(html_favicon_url = "https://cochranblock.org/assets/favicon.svg")]
#![doc(html_root_url = "https://docs.rs/cochranblock")]
#![doc = include_str!("../README.md")]

/// Verify the manual is internally consistent.
///
/// Runs an `exopack` Triple-Sims gate over the catalog of receipts. If every
/// pass agrees the manual is well-formed and the public-domain doctrine
/// holds, returns `Ok(())`. The test is intentionally light - the manual is
/// a directory, not a runtime - but it lets `cargo test -p cochranblock` and
/// downstream auditors confirm the crate did not regress.
pub fn verify() -> Result<(), &'static str> {
    let receipts = catalog();
    if receipts.is_empty() {
        return Err("manual catalog is empty");
    }
    for r in receipts {
        if r.license != "Unlicense" {
            return Err("non-public-domain entry leaked into the manual");
        }
        if r.crate_name.is_empty() {
            return Err("anonymous receipt in catalog");
        }
    }
    Ok(())
}

/// One entry in the manual: a published Cochran Block crate.
#[derive(Debug, Clone, Copy)]
pub struct Receipt {
    /// Crate name as published on crates.io.
    pub crate_name: &'static str,
    /// One-sentence purpose.
    pub purpose: &'static str,
    /// SPDX license identifier. Must be `"Unlicense"` for every catalog row.
    pub license: &'static str,
}

/// The canonical catalog of receipts that this manual documents.
///
/// Updated whenever a new Cochran Block crate is published.
pub const fn catalog() -> &'static [Receipt] {
    &[
        Receipt {
            crate_name: "runsible",
            purpose: "Ansible, reimagined in Rust. 14-crate workspace, ~10ms cold start.",
            license: "Unlicense",
        },
        Receipt {
            crate_name: "r8r",
            purpose: "n8n workflow engine ported to Rust. axum + Leptos/WASM canvas.",
            license: "Unlicense",
        },
        Receipt {
            crate_name: "exopack",
            purpose: "Testing framework with Triple-Sims quality gates.",
            license: "Unlicense",
        },
        Receipt {
            crate_name: "oakilydokily",
            purpose: "Client waiver/resume site with interactive WASM mural.",
            license: "Unlicense",
        },
        Receipt {
            crate_name: "illbethejudgeofthat",
            purpose: "Pro se custody case builder, email-to-PDF pipeline.",
            license: "Unlicense",
        },
        Receipt {
            crate_name: "any-gpu",
            purpose: "Run AI inference on any GPU you already own.",
            license: "Unlicense",
        },
        Receipt {
            crate_name: "deglaze",
            purpose: "Strip Glaze from AI-protected images for downstream analysis.",
            license: "Unlicense",
        },
        Receipt {
            crate_name: "ghost-fabric",
            purpose: "Distributed mesh substrate.",
            license: "Unlicense",
        },
    ]
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn manual_is_well_formed() {
        verify().expect("manual catalog should be internally consistent");
    }

    #[test]
    fn every_entry_is_public_domain() {
        for r in catalog() {
            assert_eq!(r.license, "Unlicense", "non-Unlicense entry: {}", r.crate_name);
        }
    }

    #[test]
    fn exopack_is_pinned() {
        // exopack is the public-domain testing framework Cochran Block ships
        // with every crate. If this compiles, the dep is present and
        // resolvable from crates.io. Triple-Sims doctrine starts here.
        // Reference the crate so the linker keeps the dep edge.
        #[allow(unused_imports)]
        use exopack as _;
    }
}