nido 0.0.0-alpha.0

Pre-release metadata crate for the Nido multi-agent operating layer. Public APIs ship at >=0.1.0.
Documentation
//! # nido -- pre-release crate
//!
//! This is the first crates.io pre-release for the **Nido** multi-agent
//! operating layer. The real public API and CLI will ship as
//! `nido >= 0.1.0`; this `0.0.0-alpha.0` release intentionally exposes
//! only project metadata.
//!
//! If you `cargo add nido` you almost certainly want the released
//! version, not this placeholder:
//!
//! ```toml
//! [dependencies]
//! nido = ">=0.1.0"
//! ```
//!
//! ## What is Nido?
//!
//! Nido is a Rust-native multi-agent operating layer being developed
//! by Florian as the successor to the `fop` runtime. It targets:
//!
//! - CLI + dual-mode K8s microservice from the same crate
//! - First-class MCP / ACP / A2A protocol support
//! - Vault-backed secret management
//! - Cosign-signed Wolfi container images
//! - Capacity-aware build admission via the `nido guard` family
//!
//! Watch the repo at <https://github.com/nash87/nido> for the v0.1.0
//! release.

#![forbid(unsafe_code)]
#![warn(missing_docs)]
#![doc(html_root_url = "https://docs.rs/nido/0.0.0-alpha.0")]

/// Metadata returned by [`pre_release`].
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct NidoPreRelease {
    /// The crate name.
    pub name: &'static str,
    /// The pre-release version. The functional Nido release will be `>=0.1.0`.
    pub version: &'static str,
    /// Human-readable status.
    pub status: &'static str,
    /// The first version range expected to expose public APIs.
    pub public_api_version: &'static str,
}

/// Returns metadata about this Nido pre-release.
///
/// Intended only as a deterministic, side-effect-free function that
/// proves the crate compiles and is reachable from downstream tests.
/// All real Nido functionality ships in `nido >= 0.1.0`.
#[inline]
pub const fn pre_release() -> NidoPreRelease {
    NidoPreRelease {
        name: "nido",
        version: env!("CARGO_PKG_VERSION"),
        status: "pre-release-development-marker",
        public_api_version: ">=0.1.0",
    }
}

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

    #[test]
    fn pre_release_metadata_is_stable() {
        let r = pre_release();
        assert_eq!(r.name, "nido");
        assert!(r.version.starts_with("0.0.0-alpha"));
        assert_eq!(r.status, "pre-release-development-marker");
    }

    #[test]
    fn pre_release_is_const() {
        const R: NidoPreRelease = pre_release();
        assert_eq!(R.name, "nido");
    }
}