oxide-gen 0.3.0

Spec-to-crate generator for Rust Oxide. Generates Rust clients, CLI commands, SKILL.md, and MCP server configs from OpenAPI, GraphQL, and gRPC specs.
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

//! Emit `module.json` — the manifest that the `oxide-k` kernel consumes when
//! discovering generated crates as modules.
//!
//! The shape mirrors [`oxide_k::module::ModuleMetadata`] plus extra fields that
//! help the kernel locate the generated CLI binary and its skill / MCP
//! descriptors.

use serde_json::{json, Value};

use crate::error::Result;
use crate::ir::{ApiKind, ApiSpec};

/// Build the `module.json` contents as pretty-printed JSON.
pub fn render(spec: &ApiSpec) -> Result<String> {
    let id = spec.name.replace('_', "-");
    let bin = format!("{id}-cli");

    let kind = match spec.kind {
        // Generated CLIs are native binaries from the kernel's point of view.
        ApiKind::OpenApi | ApiKind::GraphQl | ApiKind::Grpc => "native",
    };

    let mut manifest: Value = json!({
        "id": id,
        "name": spec.display_name,
        "version": spec.version,
        "kind": kind,
        "description": spec.description.clone().unwrap_or_else(|| spec.display_name.clone()),
        "spec_kind": spec.kind.slug(),
        "binary": bin,
        "skill": "SKILL.md",
        "mcp": "mcp.json",
        "operations": spec.operations.iter().map(|o| o.id.clone()).collect::<Vec<_>>(),
    });

    if let Some(base) = &spec.base_url {
        manifest["base_url"] = json!(base);
    }

    Ok(serde_json::to_string_pretty(&manifest)?)
}